From: Junio C Hamano Date: Mon, 22 Apr 2013 02:40:49 GMT Subject: Re: [PATCH 4/5] git-log.txt: rewrite note on why "--" may be required Message-ID: <7vmwsrqocu.fsf@alter.siamese.dyndns.org> In-Reply-To: <7vtxn0wf4j.fsf@alter.siamese.dyndns.org> Junio C Hamano writes: > Two other things I noticed with the current text are: > ... > * The part with the new "-L" option seems to be throwing the > overall formatting off. Its second paragraph " and > can take..." is not indented to the same level as its first > paragraph "Trace the evolution of...", and the following items, > like "--full-line-diff" and "[--] ..." are indented one > level too deeply. This is a minimalistic patch to fix the formatting. I removed the extra sentence after the enumeration and moved it to the end of the main text, but somebody may have a better idea to persuade AsciiDoc to format it in a more reasonable way while keeping the sentence there. -- >8 -- Subject: line-log: fix documentation formatting The second paragraph of the added description for the -L option " and can take one of these forms:", and the list of forms that follow the headline, were indented one level too short, due to the missing "+" to signal that the next paragraph continues the previous one. Also "You can specify this option more than once" is about the -L option, not about its various forms of starting and ending points. Move it to the end of the main text. Signed-off-by: Junio C Hamano --- Documentation/git-log.txt | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/Documentation/git-log.txt b/Documentation/git-log.txt index 4850226..0959f9d 100644 --- a/Documentation/git-log.txt +++ b/Documentation/git-log.txt @@ -76,12 +76,11 @@ produced by --stat etc. not give any pathspec limiters. This is currently limited to a walk starting from a single revision, i.e., you may only give zero or one positive revision arguments. - + You can specify this option more than once. ++ and can take one of these forms: include::line-range-format.txt[] -You can specify this option more than once. - --full-line-diff:: Always print the interesting range even if the current commit