branch: elpa/hyperdrive
commit 708fa6096e57542622cc13189fe25ee38efef71f
Author: Joseph Turner <jos...@ushin.org>
Commit: Joseph Turner <jos...@ushin.org>
Docs: (hyperdrive-mark-as-safe) Document changes
---
doc/hyperdrive.org | 16 ++++++++++------
doc/hyperdrive.texi | 16 ++++++++++------
2 files changed, 20 insertions(+), 12 deletions(-)
diff --git a/doc/hyperdrive.org b/doc/hyperdrive.org
index 7ba5486314..e519061501 100644
--- a/doc/hyperdrive.org
+++ b/doc/hyperdrive.org
@@ -741,15 +741,19 @@ The following keybindings are available in
~hyperdrive-mirror-mode~:
** Mark a hyperdrive as safe
-For security reasons, ~hyperdrive.el~ does not enable major modes based
-on file extension unless the hyperdrive has been marked as "safe."
+For security reasons, ~hyperdrive.el~ does not enable major modes
+based on file extension unless the hyperdrive has been marked as
+"safe." When opening a file in a hyperdrive marked as "unknown" (the
+default), ~hyperdrive.el~ will prompt you to mark the drive as "safe",
+"unsafe", or "unknown". Files in hyperdrives which are marked as
+"safe" are always opened in the appropriate major mode with
+~set-auto-mode~. Files in hyperdrives which are marked as "unsafe"
+are opened in ~fundamental-mode~ (no major mode).
- Command: hyperdrive-mark-as-safe ::
- Mark a hyperdrive as "safe," which will cause major modes to be
- automatically be enabled based on file extension when opening files
- within that hyperdrive. Files in hyperdrives which are "unsafe"
- (the default) are opened in ~fundamental-mode~.
+ Mark a hyperdrive as "safe", "unsafe", or "unknown". This command
+ can also be invoked from ~hyperdrive-menu-hyperdrive~ and the menu bar.
** Purge a hyperdrive
diff --git a/doc/hyperdrive.texi b/doc/hyperdrive.texi
index 575656c44a..fe8a4298e7 100644
--- a/doc/hyperdrive.texi
+++ b/doc/hyperdrive.texi
@@ -1068,14 +1068,18 @@ Fold or unfold the section at point.
@node Mark a hyperdrive as safe
@section Mark a hyperdrive as safe
-For security reasons, @code{hyperdrive.el} does not enable major modes based
-on file extension unless the hyperdrive has been marked as ``safe.''
+For security reasons, @code{hyperdrive.el} does not enable major modes
+based on file extension unless the hyperdrive has been marked as
+``safe.'' When opening a file in a hyperdrive marked as ``unknown'' (the
+default), @code{hyperdrive.el} will prompt you to mark the drive as ``safe'',
+``unsafe'', or ``unknown''. Files in hyperdrives which are marked as
+``safe'' are always opened in the appropriate major mode with
+@code{set-auto-mode}. Files in hyperdrives which are marked as ``unsafe''
+are opened in @code{fundamental-mode} (no major mode).
@deffn Command hyperdrive-mark-as-safe
-Mark a hyperdrive as ``safe,'' which will cause major modes to be
-automatically be enabled based on file extension when opening files
-within that hyperdrive. Files in hyperdrives which are ``unsafe''
-(the default) are opened in @code{fundamental-mode}.
+Mark a hyperdrive as ``safe'', ``unsafe'', or ``unknown''. This command
+can also be invoked from @code{hyperdrive-menu-hyperdrive} and the menu bar.
@end deffn
@node Purge a hyperdrive
