From: Richard M. Stallman Date: Fri, 16 May 2003 13:32:42 +0000 (+0000) Subject: (Magic File Names): Document the safe-magic property. X-Git-Tag: ttn-vms-21-2-B4~10142 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=4f683b1b9cf6fd03b08b8eadf42f97f116762fce;p=emacs.git (Magic File Names): Document the safe-magic property. --- diff --git a/lispref/files.texi b/lispref/files.texi index 69680e532f4..875b3066050 100644 --- a/lispref/files.texi +++ b/lispref/files.texi @@ -2405,6 +2405,16 @@ shown above; the details are crucial for proper behavior in the case of multiple handlers, and for operations that have two file names that may each have handlers. +@kindex safe-magic (@r{property}) +Handlers that don't really do anything specal for actual access to the +file---such as the ones that implement completion of host names for +remote file names---should have a non-@code{nil} @code{safe-magic} +property. For instance, Emacs normally ``protects'' directory names +it finds in @code{PATH} from becoming magic, if they look like magic +file names, by prefixing them with @samp{/:}. But if the handler that +would be used for them has a non-@code{nil} @code{safe-magic} +property, the @samp{/:} is not added. + @defvar inhibit-file-name-handlers This variable holds a list of handlers whose use is presently inhibited for a certain operation.