Re: [PATCH 2/4] Emphasize options and force ASCIIDOC escaping of "--"
- From
Junio C Hamano <gitster@pobox.com>
- Date
- Nov 11, 2013, 18:06 UTC
- Message-ID
- <xmqq8uwun78g.fsf@gitster.dls.corp.google.com>
- In-Reply-To
- <1383958133-4207-1-git-send-email-jstjohn@purdue.edu>
"Jason St. John" <jstjohn@purdue.edu> writes:
Show 14 quoted lines
> rev-list-options.txt: replace e.g. `--foo` with '\--foo'
> rev-list-options.txt: emphasize, instead of quote, some option arguments
> (e.g. "foo-option" becomes 'foo-option')
> rev-list-options.txt: force ASCIIDOC escaping of "--" (e.g. '--bar'
> becomes '\--bar')
> rev-list-options.txt: add single quote chars around options missing them
> (e.g. --grep becomes '\--grep')
> rev-list-options.txt: replaced one instance of "regexp" with "regular
> expressions"
> rev-list-options.txt: fix typo in "--no-walk" description ("show" -->
> "shown")
> rev-list-options.txt: replaced some instances of double quotes with
> their ASCIIDOC equivalent (e.g. """a "-" character""" becomes
> """a ``-'' character""",Gaah.
Did you really have to repeat "rev-list-options.txt: " on all the lines?
> Sorry for the messy quoting in the last set of examples in the commit message.
I have a feeling that many of them can and should be turned from '--opt' to `--opt`. For example, this original:
Show 6 quoted lines
> Mark which side of a symmetric diff a commit is reachable from. > Commits from the left side are prefixed with `<` and those from > - the right with `>`. If combined with `--boundary`, those > - commits are prefixed with `-`. > + the right with `>`. If combined with '\--boundary', those > + commits are prefixed with ``-''.
seems to render correctly at
https://git-htmldocs.googlecode.com/git/git-rev-list.html
without this part of the patch.