bug#43517: 28.0.50; [patch] EWW: Document double function of `w' key

bug#43517: 28.0.50; [patch] EWW: Document double function of `w' key

[Gregor Zattler]

[-- Attachment #1: Type: text/plain, Size: 299 bytes --]

Dear emacs maintainers, the documentation of eww does not
tell how to access a links URL in eww.  This patch addresses
this.  I'm not a native speaker of English, so please tell
me if there are errors (English or otherwise.

Ciao; Gregor

Ciao; Gregor
--
 -... --- .-. . -.. ..--.. ...-.-

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: 0001-doc-misc-eww.texi-Document-w-keys-double-function.patch --]
[-- Type: text/x-diff, Size: 1391 bytes --]

>From b7104ecc5985952737035ab648e644a78010eab0 Mon Sep 17 00:00:00 2001
From: Gregor Zattler <telegraph@gmx.net>
Date: Sat, 19 Sep 2020 18:59:01 +0200
Subject: [PATCH] * doc/misc/eww.texi: Document `w' keys double function

---
 doc/misc/eww.texi | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/doc/misc/eww.texi b/doc/misc/eww.texi
index 4ae2c86e3f..902fa7dd82 100644
--- a/doc/misc/eww.texi
+++ b/doc/misc/eww.texi
@@ -93,14 +93,19 @@ Basics
 @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} while point
+is on the description of a link will call
+@code{shr-maybe-probe-and-copy-url}, which copies this links URL to the
+kill ring, whereas if point is not on a link pressing @kbd{w} calls
+@code{eww-copy-page-url}, which will copy the current pages URL to the
+kill ring.

 @findex eww-open-in-new-buffer
 @kindex M-RET
--
2.20.1

bug#43517: 28.0.50; [patch] EWW: Document double function of `w' key

[Lars Ingebrigtsen]

Gregor Zattler <telegraph@gmx.net> writes:

> Dear emacs maintainers, the documentation of eww does not
> tell how to access a links URL in eww.  This patch addresses
> this.  I'm not a native speaker of English, so please tell
> me if there are errors (English or otherwise.

Thanks; looks good.  I've now installed this in Emacs 28 with some minor
changes, and will be backporting it to Emacs 27.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no