From 4f683b1b9cf6fd03b08b8eadf42f97f116762fce Mon Sep 17 00:00:00 2001
From: "Richard M. Stallman" <rms@gnu.org>
Date: Fri, 16 May 2003 13:32:42 +0000
Subject: [PATCH] (Magic File Names): Document the safe-magic property.
---
lispref/files.texi | 10 ++++++++++
1 file changed, 10 insertions(+)
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.
--
2.39.5