From 2b8ef8dddf235d3a94013f3ab70c9b697b6471e1 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Sun, 12 Nov 2017 15:25:06 +0200 Subject: [PATCH] * lisp/files.el (abbreviate-file-name): Doc fix. (Bug#29267) --- lisp/files.el | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) 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 -- 2.39.5