Documentation/git-svn: improve asciidoctor compatibility
commit9e4cbccbd73c2558cf0f5f9c2602445cdfc1f371
authorTodd Zullinger <tmz@pobox.com>
Wed, 10 Apr 2019 00:37:34 +0000 (9 20:37 -0400)
committerJunio C Hamano <gitster@pobox.com>
Wed, 10 Apr 2019 03:04:25 +0000 (10 12:04 +0900)
treee2c6dcdfa46ce412971689a23a27489908b10d66
parentaeb582a98374c094361cba1bd756dc6307432c42
Documentation/git-svn: improve asciidoctor compatibility

The second paragraph in the CONFIGURATION section intends to emphasize
the word 'must' with bold type. It does so by writing it as *must*, and
this works fine with AsciiDoc. It usually works great with Asciidoctor,
too, but in this particular instance, we have another "*" earlier in the
paragraph. We do escape it, and it is rendered literally just like we
want it to, but Asciidoctor then ends up tripping on the second (or
third) of the asterisks in this paragraph.

Since that asterisk is (part of) a literal example, we can set it in
monospace, by giving it as `*`. Adjust the whole paragraph in this way.
There's lots more monospacing to be done in this document, but since our
main motivation is addressing AsciiDoc/Asciidoctor discrepancies like
this one, let's just convert this one paragraph.

Signed-off-by: Todd Zullinger <tmz@pobox.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-svn.txt