From: Eli Zaretskii Date: Sat, 24 Jun 2023 11:58:44 +0000 (+0300) Subject: ; Fix documentation of last change X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=5b7e999e24f6cd446961ac441f69af021528623b;p=emacs.git ; Fix documentation of last change * lisp/net/eww.el (eww-copy-alternate-url): Doc fix. * etc/NEWS: * doc/misc/eww.texi (Basics): Minor wording and punctuation fixes. (Bug#64126) --- diff --git a/doc/misc/eww.texi b/doc/misc/eww.texi index cff48bd601e..b67624af9f8 100644 --- a/doc/misc/eww.texi +++ b/doc/misc/eww.texi @@ -118,7 +118,7 @@ page's URL to the kill ring instead. @findex eww-copy-alternate-url @kindex A The @kbd{A} command (@code{eww-copy-alternate-url}) copies the URL -of an alternate link of the current page into the kill ring. If the +of an alternate link on the current page into the kill ring. If the page specifies multiple alternate links, this command prompts for one of them in the minibuffer, with completion. Alternate links are references that an @acronym{HTML} page may include to point to other @@ -127,7 +127,7 @@ documents that act as its alternative representations. Notably, translated versions and to @acronym{RSS} feeds. Alternate links appear in the @samp{} section of @acronym{HTML} pages as @samp{} elements with @samp{rel} attribute equal to -@samp{``alternate''}, they are part of the page's metadata and are not +@samp{``alternate''}; they are part of the page's metadata and are not visible in its rendered content. @findex eww-open-in-new-buffer diff --git a/etc/NEWS b/etc/NEWS index 0f674c6465f..3061a147b26 100644 --- a/etc/NEWS +++ b/etc/NEWS @@ -268,7 +268,7 @@ bookmark URIs. +++ *** New command 'eww-copy-alternate-url'. -It copies an alternate link to the page currently visited in EWW into +It copies an alternate link on the page currently visited in EWW into the kill ring. Alternate links are optional metadata that HTML pages use for linking to their alternative representations, such as translated versions or associated RSS feeds. diff --git a/lisp/net/eww.el b/lisp/net/eww.el index 89f7ba37cc1..2e743751427 100644 --- a/lisp/net/eww.el +++ b/lisp/net/eww.el @@ -2643,8 +2643,9 @@ with completion. If there are none, return nil." (caar alternates))))) (defun eww-copy-alternate-url () - "Copy an alternate URL of the current page into the kill ring. - + "Copy the alternate URL of the current page into the kill ring. +If there are multiple alternate links on the current page, prompt +for one in the minibuffer, with completion. Alternate links are references that an HTML page may include to point to its alternative representations, such as a translated version or an RSS feed."