1
0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2024-11-24 07:20:37 +00:00

* lisp/vc/vc-cvs.el (vc-cvs-ignore): Copy-edit doc string

This commit is contained in:
Mattias Engdegård 2020-02-28 17:02:00 +01:00
parent 696ee02c3a
commit 4dec693f70

View File

@ -1222,23 +1222,24 @@ is non-nil."
(defun vc-cvs-ignore (file &optional directory _remove) (defun vc-cvs-ignore (file &optional directory _remove)
"Ignore FILE under CVS. "Ignore FILE under CVS.
FILE is either absolute or relative to DIRECTORY. The basename FILE is either absolute or relative to DIRECTORY. The non-directory
of FILE is written unmodified into the ignore file and is part of FILE is written unmodified into the ignore file and is
therefore evaluated by CVS as an ignore pattern which follows therefore evaluated by CVS as an ignore pattern which follows
glob(7) syntax. If the pattern should match any of the special glob(7) syntax. If the pattern should match any of the special
characters ?*[\\\ literally, they must be escaped with a characters `?*[\\' literally, they must be escaped with a
backslash. backslash.
CVS processes one ignore file for each subdirectory. Patterns CVS processes one ignore file for each subdirectory. Patterns
are separated by whitespace and only match files in the same are separated by whitespace and only match files in the same
directory. Since FILE can be a relative filename with leading directory. Since FILE can be a relative filename with leading
diretories, FILE is expanded against DIRECTORY to determine the directories, FILE is expanded against DIRECTORY to determine the
correct absolute filename. The directory name of this path is correct absolute filename. The directory part of the resulting name
then used to determine the location of the ignore file. The base is then used to determine the location of the ignore file. The
name of this path is used as pattern for the ignore file. non-directory part of the name is used as pattern for the ignore file.
Since patterns are whitespace sparated, it is usually better to Since patterns are whitespace-separated, filenames containing spaces
replace spaces in filenames with question marks ?." cannot be represented directly. A work-around is to replace such
spaces with question marks."
(setq file (directory-file-name (expand-file-name file directory))) (setq file (directory-file-name (expand-file-name file directory)))
(vc-cvs-append-to-ignore (file-name-directory file) (file-name-nondirectory file))) (vc-cvs-append-to-ignore (file-name-directory file) (file-name-nondirectory file)))