Do some xwidget NEWS markup (and adjust doc string)

* lisp/xwidget.el (xwidget-webkit-bookmark-make-record): Mention
`xwidget-webkit-bookmark-jump-new-session' in the doc string.

diff --git a/etc/NEWS b/etc/NEWS
index cfa0c33e4532732af8d9153428e8c7d7c3d21101..e99b119e4f0a2e1f906e45f49785796b30cfae5d 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -2733,22 +2733,26 @@ separated) and clearer documentation.
 
 ** xwidget-webkit mode
 
+---
 *** New xwidget commands.
 'xwidget-webkit-uri' (return the current URL), 'xwidget-webkit-title'
 (return the current title), and 'xwidget-webkit-goto-history' (goto a
 point in history).
 
+---
 *** Pixel-based scrolling.
 The 'xwidget-webkit-scroll-up', 'xwidget-webkit-scroll-down' commands
 now supports scrolling arbitrary pixel values.  It now treats the
 optional 2nd argument as the pixel values to scroll.
 
+---
 *** New commands for scrolling.
 The new commands 'xwidget-webkit-scroll-up-line',
 'xwidget-webkit-scroll-down-line', 'xwidget-webkit-scroll-forward',
 'xwidget-webkit-scroll-backward' can be used to scroll webkit by the
 height of lines or width of chars.
 
+---
 *** New user option 'xwidget-webkit-bookmark-jump-new-session'.
 When non-nil, use a new xwidget webkit session after bookmark jump.
 Otherwise, it will use 'xwidget-webkit-last-session'.
@@ -2937,6 +2941,7 @@ your code to be edited with an Emacs version older than 27.1.
 ---
 *** 'mspools-show' is now autoloaded.
 
+---
 *** Loading dunnet.el in batch mode doesn't start the game any more.
 Instead you need to do "emacs -f dun-batch" to start the game in
 batch mode.
@@ -2980,6 +2985,7 @@ direction with e.g. 'C-x o M-- o o'.  Also it can help to set a new
 step with e.g. 'C-x { C-5 { { {', which will set the window resizing
 step to 5 columns.
 
+---
 ** New themes 'modus-vivendi' and 'modus-operandi'.
 These themes are designed to conform with the highest standard for
 color-contrast accessibility (WCAG AAA).  You can load either of them

diff --git a/lisp/xwidget.el b/lisp/xwidget.el
index f8cb7a7addebec8e1209a9954dc21f218673ee89..8c593abea88931ec204f647e279ea3eb97b6fa36 100644 (file)
--- a/lisp/xwidget.el
+++ b/lisp/xwidget.el
@@ -352,7 +352,9 @@ When you set this variable to nil, consider further customization with
   :type 'boolean)
 
 (defun xwidget-webkit-bookmark-make-record ()
-  "Create bookmark record in webkit xwidget."
+  "Create bookmark record in webkit xwidget.
+See `xwidget-webkit-bookmark-jump-new-session' for whether this
+should create a new session or not."
   (nconc (bookmark-make-record-default t t)
          `((page . ,(xwidget-webkit-uri (xwidget-webkit-current-session)))
            (handler  . (lambda (bmk)