Re: [PATCH 4/5] git-log.txt: rewrite note on why "--" may be required
- From
Junio C Hamano <gitster@pobox.com>
- Date
- Apr 22, 2013, 02:40 UTC
- Message-ID
- <7vmwsrqocu.fsf@alter.siamese.dyndns.org>
- In-Reply-To
- <7vtxn0wf4j.fsf@alter.siamese.dyndns.org>
Junio C Hamano <gitster@pobox.com> writes:
Show 8 quoted lines
> 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 "<start> and <end> > 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 "[--] <pathspec>..." 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 "<start> and <end> 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 <gitster@pobox.com> --- 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. ++ <start> and <end> 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