kernel
/
git
mirror of https://git.kernel.org/pub/scm/git/git.git
1
0
Fork 0
Code Releases Activity

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>
maint
Jonathan Nieder 2010-08-20 05:21:53 -05:00 committed by Junio C Hamano
parent e860795d8a
commit 438ded457b
2 changed files with 3 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
Documentation/asciidoc.conf
View File

@ -17,6 +17,7 @@ caret=&#94;
startsb=&#91; startsb=&#91;
endsb=&#93; endsb=&#93;
tilde=&#126; tilde=&#126;
apostrophe=&#39;
backtick=&#96; backtick=&#96;


ifdef::backend-docbook[] ifdef::backend-docbook[]

3
Documentation/git-rm.txt
View File

@ -78,7 +78,8 @@ a file that you have not told git about does not remove that file.


File globbing matches across directory boundaries. Thus, given File globbing matches across directory boundaries. Thus, given
two directories `d` and `d2`, there is a difference between two directories `d` and `d2`, there is a difference between
using `git rm \'d\*\'` and `git rm \'d/\*\'`, as the former will using `git rm {apostrophe}d{asterisk}{apostrophe}` and
`git rm {apostrophe}d/{asterisk}{apostrophe}`, as the former will
also remove all of directory `d2`. also remove all of directory `d2`.


REMOVING FILES THAT HAVE DISAPPEARED FROM THE FILESYSTEM REMOVING FILES THAT HAVE DISAPPEARED FROM THE FILESYSTEM