procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Mention url-handler-mode in the Emacs manual

Browse source 
* doc/emacs/misc.texi (Browse-URL): Mention url-handler-mode
(bug#30389).

* lisp/url/url-handlers.el (url-handler-mode): Improve doc string.
This commit is contained in:
Lars Ingebrigtsen 2021-08-12 16:50:54 +02:00
parent 96d83a8546
commit 1678d3599b
2 changed files with 18 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

9
doc/emacs/misc.texi
View file

@ -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

10
lisp/url/url-handlers.el
View file

@ -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