diff options
| author | Chong Yidong <cyd@stupidchicken.com> | 2011-01-08 16:37:20 -0500 |
|---|---|---|
| committer | Chong Yidong <cyd@stupidchicken.com> | 2011-01-08 16:37:20 -0500 |
| commit | ad2d9b0e33e4eef277b67f58ec8b024d0dd1e0e7 (patch) | |
| tree | be8e49662241e6440075fb98a420cc1076ca6c34 /doc | |
| parent | 83affcb07a8d5e297e66685eb94cec3fd8ce297b (diff) | |
| download | emacs-ad2d9b0e33e4eef277b67f58ec8b024d0dd1e0e7.tar.gz | |
Explain why directory-abbrev-alist should be anchored (Bug#7777).
* files.texi (Directory Names): Explain why directory-abbrev-alist
elements should be anchored (Bug#7777).
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/lispref/ChangeLog | 5 | ||||
| -rw-r--r-- | doc/lispref/files.texi | 17 |
2 files changed, 14 insertions, 8 deletions
diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog index bdaae56cb5c..1c4e6b9074f 100644 --- a/doc/lispref/ChangeLog +++ b/doc/lispref/ChangeLog @@ -1,3 +1,8 @@ +2011-01-08 Chong Yidong <cyd@stupidchicken.com> + + * files.texi (Directory Names): Explain why directory-abbrev-alist + elements should be anchored (Bug#7777). + 2011-01-07 Eli Zaretskii <eliz@gnu.org> * files.texi (Directory Names): Explain why FROM in diff --git a/doc/lispref/files.texi b/doc/lispref/files.texi index f0060cd6622..c2a14b5025e 100644 --- a/doc/lispref/files.texi +++ b/doc/lispref/files.texi @@ -1932,14 +1932,15 @@ abbreviation instead. The variable @code{directory-abbrev-alist} contains an alist of abbreviations to use for file directories. Each element has the form @code{(@var{from} . @var{to})}, and says to replace @var{from} with -@var{to} when it appears in a directory name. The @var{from} string is -actually a regular expression; it is matched against directory names -anchored at the first character, so it should start with @samp{\`}, to -support directory names with embedded newlines (which will defeat -@samp{^}). The @var{to} string should be an ordinary absolute -directory name. Do not use @samp{~} to stand for a home directory in -that string. The function @code{abbreviate-file-name} performs these -substitutions. +@var{to} when it appears in a directory name. + +The @var{from} string is actually a regular expression. It ought to +always start with @samp{\`}, to avoid incorrectly matching to a +relative portion of the supplied directory name. + +The @var{to} string should be an ordinary absolute directory name. +Do not use @samp{~} to stand for a home directory in that string; the +function @code{abbreviate-file-name} performs these substitutions. You can set this variable in @file{site-init.el} to describe the abbreviations appropriate for your site. |