From: Jason St. John <jstjohn@purdue.edu>
Date: Sat, 11 Jan 2014 01:25:12 GMT
Subject: Re: [PATCH] Fix typesetting in Bugs section of 'git-rebase' man page (web version)
Message-ID: <CAEjxke-fPwTctUt9x_o1YwTKK2fX5TOPA7LStXUh+ejUVxZtpg@mail.gmail.com>
In-Reply-To: <xmqqwqk37kdy.fsf@gitster.dls.corp.google.com>

On Tue, Nov 19, 2013 at 11:43 PM, Junio C Hamano <gitster@pobox.com> wrote:
> "Jason St. John" <jstjohn@purdue.edu> writes:
>
>> Documentation/git-rebase.txt: add a blank line after the two AsciiDoc
>>     listing blocks
>
> That looks funnily formatted, out of place and redundant.
>
>> Without these blank lines, AsciiDoc thinks the opening "-----" is a
>> section heading and typesets the word "to" as such, which causes
>> cascading formatting/typesetting issues until the end of the document.
>
>>
>> Signed-off-by: Jason St. John <jstjohn@purdue.edu>
>> ---
>> You can see the carnage here:
>> http://git-scm.com/docs/git-rebase#_bugs
>>
>> This fixes GitHub issue github/gitscm-next#281
>
> Hmph. https://git-htmldocs.googlecode.com/git/git.html has HTML
> documentation pages I preformat, but as far as I can see, the bugs
> section of git-rebase(1) does not have such a "carnage".
>
> Perhaps git-scm.com uses some buggy formatter?

This does seem to be an issue with git-scm.com only, so this is
probably an issue with the AsciiDoc formatter they use.

What AsciiDoc formatter (and version) do you use?

Sorry for the long delay in replying!

Jason