From: Eli Zaretskii <eliz@gnu.org>
Date: Sun, 12 Nov 2017 13:25:06 +0000 (+0200)
Subject: * lisp/files.el (abbreviate-file-name): Doc fix.  (Bug#29267)
X-Git-Tag: emacs-26.0.91~321
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=2b8ef8dddf235d3a94013f3ab70c9b697b6471e1;p=emacs.git

* lisp/files.el (abbreviate-file-name): Doc fix.  (Bug#29267)
---

diff --git a/lisp/files.el b/lisp/files.el
index b47411f206a..96d7ae7cf16 100644
--- a/lisp/files.el
+++ b/lisp/files.el
@@ -1855,7 +1855,13 @@ The value includes abbreviation according to `directory-abbrev-alist'.")
   "Return a version of FILENAME shortened using `directory-abbrev-alist'.
 This also substitutes \"~\" for the user's home directory (unless the
 home directory is a root directory) and removes automounter prefixes
-\(see the variable `automount-dir-prefix')."
+\(see the variable `automount-dir-prefix').
+
+When this function is first called, it caches the user's home
+directory as a regexp in `abbreviated-home-dir', and reuses it
+afterwards.  Lisp programs that temporarily set the home directory
+to a different value should let-bind `abbreviated-home-dir' for
+the modified home directory to take effect."
   ;; Get rid of the prefixes added by the automounter.
   (save-match-data
     (if (and automount-dir-prefix