From: Eli Zaretskii Date: Thu, 29 Oct 2015 17:48:18 +0000 (+0200) Subject: ; Improve documentation of 'unhandled-file-name-directory' X-Git-Tag: emacs-25.0.90~975 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=8e8a06803c36fdbd4b90faf8f907a90cc33e1bd0;p=emacs.git ; Improve documentation of 'unhandled-file-name-directory' * doc/lispref/files.texi (Magic File Names): Better wording for the last change in the documentation of 'unhandled-file-name-directory'. --- diff --git a/doc/lispref/files.texi b/doc/lispref/files.texi index 60834338423..9a1b2cd217f 100644 --- a/doc/lispref/files.texi +++ b/doc/lispref/files.texi @@ -3081,12 +3081,12 @@ making connections when they don't exist. @end defun @defun unhandled-file-name-directory filename -This function returns the name of a directory that is not magic. It -turns @var{filename} into a directory name if that is not magic. For a -magic file name, it invokes the file name handler, which therefore -decides what value to return. If @var{filename} is not accessible -from a local process, then the file name handler should indicate it by -returning @code{nil}. +This function returns the name of a directory that is not magic. For +a non-magic @var{filename} it returns the corresponding directory name +(@pxref{Directory Names}). For a magic @var{filename}, it invokes the +file name handler, which therefore decides what value to return. If +@var{filename} is not accessible from a local process, then the file +name handler should indicate that by returning @code{nil}. This is useful for running a subprocess; every subprocess must have a non-magic directory to serve as its current directory, and this function