Re: [PATCH v2] Documentation: Fix indentation problem in git-commit(1)

From: Junio C Hamano <gitster@pobox.com>
Date: Feb 20, 2010, 05:28 UTC
Message-ID: <7vr5og4gs9.fsf@alter.siamese.dyndns.org>
In-Reply-To: <1266237186-8065-1-git-send-email-jacob.helwig@gmail.com>

Jacob Helwig <jacob.helwig@gmail.com> writes:

Show 5 quoted lines

> Ever since the "See linkgit:git-config[1]..." paragraph was added to the
> description for --untracked-files (d6293d1), the paragraphs for the
> following options were indented at the same level as the "See
> linkgit:git-config[1]" paragraph.  This problem showed up in the
> manpages, but not in the HTML documentation.

I've never noticed it myself, but options after -u do align incorrectly in the manpage rendered on FC11 (asciidoc 8.2.5, xmoto 0.0.22) or on FreeBSD8 (asciidoc 8.4.5, xmlto 0.0.21) without your patch, and your patch seems to fix it on both of them.

Your patch does not make any difference in my primary environment (Debian 5 with asciidoc 8.2.7, xmlto 0.0.20), by the way. The options have the same indentation level, with or without your patch. Your patch does not make things worse, so that is Ok.

The "See git-config(1)" paragraph itself is indented too deeply, to align the last bullet item (all). which does look wrong. This is true on all machines I tried, and your patch does not improve nor worsen this.

When output on Debian 5 (but not FC11 nor FBSD) is rendered to ps/pdf, the bullets alone align with '-u', which is also wrong. Your patch does not improve nor worsen this.