[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
master 1678d35 1/3: Mention url-handler-mode in the Emacs manual
From: |
Lars Ingebrigtsen |
Subject: |
master 1678d35 1/3: Mention url-handler-mode in the Emacs manual |
Date: |
Thu, 12 Aug 2021 11:15:59 -0400 (EDT) |
branch: master
commit 1678d3599bd3b4e1abac15af54d82202b842428b
Author: Lars Ingebrigtsen <larsi@gnus.org>
Commit: Lars Ingebrigtsen <larsi@gnus.org>
Mention url-handler-mode in the Emacs manual
* doc/emacs/misc.texi (Browse-URL): Mention url-handler-mode
(bug#30389).
* lisp/url/url-handlers.el (url-handler-mode): Improve doc string.
---
doc/emacs/misc.texi | 9 +++++++++
lisp/url/url-handlers.el | 10 +++++++++-
2 files changed, 18 insertions(+), 1 deletion(-)
diff --git a/doc/emacs/misc.texi b/doc/emacs/misc.texi
index 8bf1032..528cfa9 100644
--- a/doc/emacs/misc.texi
+++ b/doc/emacs/misc.texi
@@ -2973,6 +2973,15 @@ URLs.
For more information, view the package commentary by typing @kbd{C-h P
browse-url @key{RET}}.
+@findex url-handler-mode
+ Emacs also has a minor mode that has some support for handling
+@acronym{URL}s as if they were files. @code{url-handler-mode} is a
+global minor mode that affects most of the Emacs commands and
+primitives that deal with file names. After switching on this mode,
+you can say, for instance, @kbd{C-x C-f https://www.gnu.org/ RET} to
+see the @acronym{HTML} for that web page, and you can then edit it and
+save it to a local file, for instance.
+
@node Goto Address mode
@subsection Activating URLs
@findex goto-address-mode
diff --git a/lisp/url/url-handlers.el b/lisp/url/url-handlers.el
index 68556d6..ed0402a 100644
--- a/lisp/url/url-handlers.el
+++ b/lisp/url/url-handlers.el
@@ -102,7 +102,15 @@
;;;###autoload
(define-minor-mode url-handler-mode
- "Toggle using `url' library for URL filenames (URL Handler mode)."
+ "Handle URLs as if they were file names throughout Emacs.
+After switching on this minor mode, Emacs file primitives handle
+URLs. For instance:
+
+ (file-exists-p \"https://www.gnu.org/\")
+ => t
+
+and `C-x C-f https://www.gnu.org/ RET' will give you the HTML at
+that URL in a buffer."
:global t :group 'url
;; Remove old entry, if any.
(setq file-name-handler-alist