Re: [PATCH 2/4] Emphasize options and force ASCIIDOC escaping of "--"
From: Junio C Hamano <hidden>
Date: 2016-06-15 22:59:13
"Jason St. John" [off-list ref] writes:
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:
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.