Re: [PATCH] Fix typesetting in Bugs section of 'git-rebase' man page (web version)

From: Jonathan Nieder <jrnieder@gmail.com>
Date: Nov 20, 2013, 00:31 UTC
Message-ID: <20131120003130.GC4212@google.com>
In-Reply-To: <1384906483-15260-1-git-send-email-jstjohn@purdue.edu>

Hi,

Jason St. John wrote:

> Documentation/git-rebase.txt: add a blank line after the two AsciiDoc
>     listing blocks

I'd leave out the above two description lines, since they're redundant next to the patch text.

> 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.

Interesting.  Alas, I can't reproduce this.

Are you sure it is AsciiDoc that misinterprets the document, and not, e.g., the predecessor of asciidoctor in gitscm-next?

Do

  Documentation/git-check-attr.txt
  Documentation/git-commit.txt
  Documentation/git-cvsserver.txt
  Documentation/git-p4.txt
  Documentation/git-svn.txt
  Documentation/gitcli.txt
  Documentation/gitweb.txt
  Documentation/mailmap.txt
  
avoid this problem?

Thanks and hope that helps, Jonathan