summaryrefslogtreecommitdiff
path: root/doc/misc/eww.texi
diff options
context:
space:
mode:
Diffstat (limited to 'doc/misc/eww.texi')
-rw-r--r--doc/misc/eww.texi26
1 files changed, 24 insertions, 2 deletions
diff --git a/doc/misc/eww.texi b/doc/misc/eww.texi
index 85be112402c..1bccbd7261a 100644
--- a/doc/misc/eww.texi
+++ b/doc/misc/eww.texi
@@ -93,14 +93,20 @@ default one, which is normally called @file{*eww*}.
@findex eww-quit
@findex eww-reload
@findex eww-copy-page-url
+@findex shr-maybe-probe-and-copy-url
@kindex q
@kindex w
@kindex g
If loading the URL was successful the buffer @file{*eww*} is opened
and the web page is rendered in it. You can leave EWW by pressing
@kbd{q} or exit the browser by calling @kbd{eww-quit}. To reload the
-web page hit @kbd{g} (@code{eww-reload}). Pressing @kbd{w}
-(@code{eww-copy-page-url}) will copy the current URL to the kill ring.
+web page hit @kbd{g} (@code{eww-reload}).
+
+ Pressing @kbd{w} when point is on a link will call
+@code{shr-maybe-probe-and-copy-url}, which copies this link's
+@acronym{URL} to the kill ring. If point is not on a link, pressing
+@kbd{w} calls @code{eww-copy-page-url}, which will copy the current
+page's URL to the kill ring instead.
@findex eww-open-in-new-buffer
@kindex M-RET
@@ -212,6 +218,22 @@ in an external browser by customizing
@node Advanced
@chapter Advanced
+@findex eww-retrieve-command
+ EWW normally uses @code{url-retrieve} to fetch the @acronym{HTML}
+before rendering it. It can sometimes be convenient to use an
+external program to do this, and @code{eww-retrieve-command} should
+then be a list that specifies a command and the parameters. For
+instance, to use the Chromium browser, you could say something like
+this:
+
+@lisp
+(setq eww-retrieve-command
+ '("chromium" "--headless" "--dump-dom"))
+@end lisp
+
+The command should return the @acronym{HTML} on standard output, and
+the data should use @acronym{UTF-8} as the charset.
+
@findex eww-view-source
@kindex v
@cindex Viewing Source