emacs-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

master eb86c33: Fix documentation of last commit


From: Eli Zaretskii
Subject: master eb86c33: Fix documentation of last commit
Date: Fri, 19 Nov 2021 08:42:49 -0500 (EST)

branch: master
commit eb86c33c46d4bd1af06abcec5d9d97c705c0ce0d
Author: Eli Zaretskii <eliz@gnu.org>
Commit: Eli Zaretskii <eliz@gnu.org>

    Fix documentation of last commit
    
    * lisp/xwidget.el (xwidget-webkit-cookie-file): Don't use "path"
    for file names in the doc string.  Improve wording and markup of
    the doc string.
    
    * src/xwidget.c (Fxwidget_webkit_set_cookie_storage_file):
    * doc/lispref/display.texi (Xwidgets): Don't use "path" for file
    names.
    
    * etc/NEWS: Improve the wording of the entry about
    'xwidget-webkit-cookie-file'.
---
 doc/lispref/display.texi | 4 ++--
 etc/NEWS                 | 6 ++++--
 lisp/xwidget.el          | 6 +++---
 src/xwidget.c            | 4 ++--
 4 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index a90be50..12257fd 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -7015,8 +7015,8 @@ The value returned is a float ranging between 0.0 and 1.0.
 @defun xwidget-webkit-set-cookie-storage-file xwidget file
 Make the WebKit widget @var{xwidget} store cookies in @var{file}.
 
-@var{file} must be an absolute file path.  The new setting will also
-take effect on any xwidget that was created with @var{xwidget} as the
+@var{file} must be an absolute file name.  The new setting will also
+affect any xwidget that was created with @var{xwidget} as the
 @code{related} argument to @code{make-xwidget}, and widgets related to
 those as well.
 
diff --git a/etc/NEWS b/etc/NEWS
index 2d3f9da..c38e1aa 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -495,8 +495,10 @@ named.
 
 ---
 *** New user option 'xwidget-webkit-cookie-file'.
-Using this option you can set where and if the xwidget-webkit buffers
-save cookies set by web pages.
+Using this option you can control whether the xwidget-webkit buffers
+save cookies set by web pages, and if so, in which file to save them.
+the default is the file 'xwidget-webkit-cookies.txt' under
+'~/.emacs.d' directory.
 
 +++
 *** New minor mode 'xwidget-webkit-edit-mode'.
diff --git a/lisp/xwidget.el b/lisp/xwidget.el
index 056315a..a1f992e 100644
--- a/lisp/xwidget.el
+++ b/lisp/xwidget.el
@@ -111,9 +111,9 @@ It can use the following special constructs:
 (defcustom xwidget-webkit-cookie-file
   (file-name-concat user-emacs-directory
                     "xwidget-webkit-cookies.txt")
-  "A path to the file where xwidget-webkit-browse-url will store cookies.
-They will be stored as plain text in Mozilla `cookies.txt'
-format.  If nil, cookies will not be stored."
+  "The name of the file where `xwidget-webkit-browse-url' will store cookies.
+They will be stored as plain text in Mozilla \"cookies.txt\"
+format.  If nil, do not store cookies."
   :type 'string
   :version "29.1")
 
diff --git a/src/xwidget.c b/src/xwidget.c
index 4e84d43..8cad2fb 100644
--- a/src/xwidget.c
+++ b/src/xwidget.c
@@ -2587,8 +2587,8 @@ DEFUN ("xwidget-webkit-set-cookie-storage-file",
        2, 2, 0, doc: /* Make the WebKit widget XWIDGET load and store cookies 
in FILE.
 
 Cookies will be stored as plain text in FILE, which must be an
-absolute file path.  All xwidgets related to XWIDGET will also be
-changed to store and load cookies in FILE.  */)
+absolute file name.  All xwidgets related to XWIDGET will also
+store cookies in FILE and load them from there.  */)
   (Lisp_Object xwidget, Lisp_Object file)
 {
 #ifdef USE_GTK



reply via email to

[Prev in Thread] Current Thread [Next in Thread]