Add a command line (and MIME handler) function to start eww

* lisp/net/eww.el (eww-browse): New command (bug#42768) to be used
from the command line.

* doc/misc/eww.texi (Command Line): Document it.

diff --git a/doc/misc/eww.texi b/doc/misc/eww.texi
index f9901b6fd7846f0fa03c0aaebf2cf73d4eb8b256..85be112402ceccc8d76b32ec838c5ef6a5ab4c35 100644 (file)
--- a/doc/misc/eww.texi
+++ b/doc/misc/eww.texi
@@ -52,6 +52,7 @@ modify this GNU manual.''
 * Overview::
 * Basics::
 * Advanced::
+* Command Line::
 
 Appendices
 * History and Acknowledgments::
@@ -337,6 +338,21 @@ thus allowing for the use of the usual substitutions, such as
 @code{\[eww-reload]} for the current key binding of the
 @code{eww-reload} command.
 
+@node Command Line
+@chapter Command Line Usage
+
+It can be convenient to start eww directly from the command line.  The
+@code{eww-browse} function can be used for that:
+
+@example
+emacs -f eww-browse https://gnu.org
+@end example
+
+This also allows registering Emacs as a @acronym{MIME} handler for the
+@samp{"text/x-uri"} media type.  How to do that varies between
+systems, but typically you'd register the handler to call @samp{"emacs
+-f eww-browse %u"}.
+
 @node History and Acknowledgments
 @appendix History and Acknowledgments
 

diff --git a/etc/NEWS b/etc/NEWS
index 2f204a5b4bcd97634605c276fd8ffd35c5a2e43a..9dffd0f714cd3557625ee53fbe8d3dbc6dab8d2e 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -603,6 +603,12 @@ mode buffer.
 
 ** EWW
 
++++
+*** New Emacs command line convenience function.
+The 'eww-browse' command has been added, which allows you to register
+Emacs as a MIME handler for "text/x-uri", and will call eww on the
+supplied URL.  Usage example: emacs -f eww-browse https://gnu.org
+
 +++
 *** 'eww-download-directory' will now use the XDG location, if defined.
 However, if "~/Downloads/" already exists, that will continue to be

diff --git a/lisp/net/eww.el b/lisp/net/eww.el
index edb2f729c8ba972c17e39498752d11af90a7ea0b..e7170b3e6d1c2ce8eeeaa44378b79a074b77fb78 100644 (file)
--- a/lisp/net/eww.el
+++ b/lisp/net/eww.el
@@ -276,6 +276,24 @@ This list can be customized via `eww-suggest-uris'."
            (push   uri uris)))))
     (nreverse uris)))
 
+;;;###autoload
+(defun eww-browse ()
+  "Function to be run to parse command line URLs.
+This is meant to be used for MIME handlers or command line use.
+
+Setting the handler for \"text/x-uri;\" to
+\"emacs -f eww-browse %u\" will then start up Emacs and call eww
+to browse the url.
+
+This can also be used on the command line directly:
+
+ emacs -f eww-browse https://gnu.org
+
+will start Emacs and browse the GNU web site."
+  (interactive)
+  (eww (pop command-line-args-left)))
+
+
 ;;;###autoload
 (defun eww (url &optional arg buffer)
   "Fetch URL and render the page.