Documentation: quoting trouble in "git rm" discussion
authorJonathan Nieder <jrnieder@gmail.com>
Fri, 20 Aug 2010 10:21:53 +0000 (05:21 -0500)
committerJunio C Hamano <gitster@pobox.com>
Fri, 20 Aug 2010 21:16:21 +0000 (14:16 -0700)
commit438ded457b6e0d1e615edd593faeeafdc8818fea
tree8fc1f8c3e183113b0eff8e26579d317d8dbca309
parente860795d8a4556114a11224da246e127cbee5807
Documentation: quoting trouble in "git rm" discussion

The current output (with Asciidoc 8.5.2) seems a bit broken:

given two directories ‘d` and d2, there is a difference
between using git rm 'd*’ and ‘git rm 'd/\*\’`, as the
former will also remove all of directory d2.

In other words, the markup parses as

given two directories << d` and _d2_, there is a difference
between using _git rm 'd* >>_ and << git rm 'd/\*\ >> `.

I suspect there is an asciidoc bug involved (why is ' a candidate
closing-quote mark when it is preceded by a backslash?) but with
all the meanings of ` and ' involved I do not want to track it
down.  Better to use unambiguous {asterisk} and {apostrophe}
entities.

Signed-off-by: Jonathan Nieder <jrnieder@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/asciidoc.conf
Documentation/git-rm.txt