gitweb.conf.txt: switch pluses to backticks to help Asciidoctor
commit4414e837fcd9cc4e68e1540af04bb6db1533f302
authorMartin Ågren <martin.agren@gmail.com>
Sat, 7 Sep 2019 14:12:53 +0000 (7 16:12 +0200)
committerJunio C Hamano <gitster@pobox.com>
Mon, 9 Sep 2019 18:05:52 +0000 (9 11:05 -0700)
tree03fb683f8ad82f18b3aa2384d6d54688db04a6f4
parentb7e1ba56497f0633d3cc98ecc25a08eed144e687
gitweb.conf.txt: switch pluses to backticks to help Asciidoctor

This paragraph uses a lot of +pluses+ to render text as monospace. That
works fine with AsciiDoc (8.6.10), and almost fine with Asciidoctor
(1.5.5), which renders the third of these literally ("+$projname+"). The
reason seems to be that Asciidoctor trips on the lone plus a bit
earlier, even though it is escaped.

Switch +$projname+ to `$projname`, and change the next, similar instance
too (+$projname/+), because otherwise, we'd trip on /that one/ instead.
If we would stop there, we would now start falling over on the escaped
plus ('\+') mentioned earlier, rendering /it/ literally. So change that
too...

In other words, unescape the lone '+' and change all the pluses that
follow it to backticks.

AsciiDoc renders this paragraph identically before and after this
commit, and Asciidoctor now renders this the same as AsciiDoc.

I did try to switch the whole paragraph to using backticks rather than
pluses. That worked great with Asciidoctor, but confused AsciiDoc...
Let's go with this rather surgical change instead.

Signed-off-by: Martin Ågren <martin.agren@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/gitweb.conf.txt