Re: Minor man page weirdness?

From: Jeff King <peff@peff.net>
Date: Oct 18, 2017, 03:21 UTC
Message-ID: <20171018032103.p6bz7wciiedokiyy@sigill.intra.peff.net>
In-Reply-To: <xmqqfuahkwug.fsf@gitster.mtv.corp.google.com>

On Wed, Oct 18, 2017 at 11:34:31AM +0900, Junio C Hamano wrote:

Show 12 quoted lines

> -- >8 --
> branch doc: sprinkle a few commas for readability
> 
> The "--force" option can also be used when the named branch does not
> yet exist, and the point of the option is the user can (re)point the
> branch to the named commit even if it does.  Add 'even' before 'if'
> to clarify.  Also, insert another comma after "Without -f" before
> "the command refuses..." to make the text easier to parse.
> 
> Incidentally, this change should help certain versions of
> docbook-xsl-stylesheets that renders the original without any
> whitespace between "-f" and "git".

Thanks, this looks good.

It does make me wonder if there are other instances of the missing-space problem lurking. Grepping for backtick followed by single-quote shows only one more case in user-manual.txt. I have no idea if that one hits the same problem on older docbook versions. Or if it's a problem for any other punctuation combinations. I'm happy to punt on it until somebody with an affected docbook produces more bug reports. :)

-Peff