Mercurial > emacs
changeset 51020:417a9e80f335
(Magic File Names): Document the safe-magic property.
| author | Richard M. Stallman <rms@gnu.org> |
|---|---|
| date | Fri, 16 May 2003 13:32:42 +0000 |
| parents | d60c03f7aa72 |
| children | 59fa0bb3f282 |
| files | lispref/files.texi |
| diffstat | 1 files changed, 10 insertions(+), 0 deletions(-) [+] |
line wrap: on
line diff
--- a/lispref/files.texi Fri May 16 09:28:39 2003 +0000 +++ b/lispref/files.texi Fri May 16 13:32:42 2003 +0000 @@ -2405,6 +2405,16 @@ 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.