Thread (1 message) 1 message, 1 author, 2016-06-15

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.
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help