Commit 4320be42 authored by Eli Zaretskii's avatar Eli Zaretskii

Fix bug #7777 with documentation of directory-abbrev-alist.

 lisp/files.el (directory-abbrev-alist): Doc fix.
 doc/lispref/files.texi (Directory Names): Explain why FROM in
 directory-abbrev-alist should begin with \`.
parent c1f04bcf
2011-01-07 Eli Zaretskii <eliz@gnu.org>
* files.texi (Directory Names): Explain why FROM in
directory-abbrev-alist should begin with \`. (Bug#7777)
2010-12-25 Eli Zaretskii <eliz@gnu.org> 2010-12-25 Eli Zaretskii <eliz@gnu.org>
* modes.texi (Emulating Mode Line): Fix last change. * modes.texi (Emulating Mode Line): Fix last change.
......
...@@ -1933,10 +1933,13 @@ The variable @code{directory-abbrev-alist} contains an alist of ...@@ -1933,10 +1933,13 @@ The variable @code{directory-abbrev-alist} contains an alist of
abbreviations to use for file directories. Each element has the form abbreviations to use for file directories. Each element has the form
@code{(@var{from} . @var{to})}, and says to replace @var{from} with @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 @var{to} when it appears in a directory name. The @var{from} string is
actually a regular expression; it should always start with @samp{\`}. actually a regular expression; it is matched against directory names
The @var{to} string should be an ordinary absolute directory name. Do anchored at the first character, so it should start with @samp{\`}, to
not use @samp{~} to stand for a home directory in that string. The support directory names with embedded newlines (which will defeat
function @code{abbreviate-file-name} performs these substitutions. @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.
You can set this variable in @file{site-init.el} to describe the You can set this variable in @file{site-init.el} to describe the
abbreviations appropriate for your site. abbreviations appropriate for your site.
......
2011-01-07 Eli Zaretskii <eliz@gnu.org>
* files.el (directory-abbrev-alist): Doc fix. (Bug#7777)
2011-01-06 Stefan Monnier <monnier@iro.umontreal.ca> 2011-01-06 Stefan Monnier <monnier@iro.umontreal.ca>
* vc-bzr.el (vc-bzr-annotate-command, vc-bzr-annotate-time): * vc-bzr.el (vc-bzr-annotate-command, vc-bzr-annotate-time):
......
...@@ -56,7 +56,10 @@ when it has unsaved changes." ...@@ -56,7 +56,10 @@ when it has unsaved changes."
A list of elements of the form (FROM . TO), each meaning to replace A list of elements of the form (FROM . TO), each meaning to replace
FROM with TO when it appears in a directory name. This replacement is FROM with TO when it appears in a directory name. This replacement is
done when setting up the default directory of a newly visited file. done when setting up the default directory of a newly visited file.
*Every* FROM string should start with \"\\\\`\".
FROM is matched against directory names anchored at the first
character, so it should start with a \"\\\\`\", or, if directory
names cannot have embedded newlines, with a \"^\".
FROM and TO should be equivalent names, which refer to the FROM and TO should be equivalent names, which refer to the
same directory. Do not use `~' in the TO strings; same directory. Do not use `~' in the TO strings;
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment