; Minor checkdoc fixes in url/*.el

diff --git a/lisp/url/url-auth.el b/lisp/url/url-auth.el
index 06cfacc99d6e3009bf77549e85c3a130dd9ee5ab..2d9a7758f13b2f0bbae4ed0e82244d1401726f0e 100644 (file)
--- a/lisp/url/url-auth.el
+++ b/lisp/url/url-auth.el
@@ -19,6 +19,8 @@
 ;; You should have received a copy of the GNU General Public License
 ;; along with GNU Emacs.  If not, see <https://www.gnu.org/licenses/>.
 
+;;; Commentary:
+
 ;;; Code:
 
 (require 'url-vars)
@@ -458,8 +460,7 @@ information associated with them.")
 
 ;;;###autoload
 (defun url-get-authentication (url realm type prompt &optional args)
-  "Return an authorization string suitable for use in the WWW-Authenticate
-header in an HTTP/1.0 request.
+  "Return authorization string for the WWW-Authenticate header in HTTP/1.0 request.
 
 URL    is the url you are requesting authorization to.  This can be either a
        string representing the URL, or the parsed representation returned by

diff --git a/lisp/url/url-cache.el b/lisp/url/url-cache.el
index 830e6ba9dccdaac31378b2b7048b8fc95371d55c..f869d2e2cf1ecd262eaf1bbf1f543793560b3940 100644 (file)
--- a/lisp/url/url-cache.el
+++ b/lisp/url/url-cache.el
@@ -19,6 +19,8 @@
 ;; You should have received a copy of the GNU General Public License
 ;; along with GNU Emacs.  If not, see <https://www.gnu.org/licenses/>.
 
+;;; Commentary:
+
 ;;; Code:
 
 (require 'url-parse)
@@ -47,7 +49,7 @@ Used by the function `url-cache-expired'."
          (file-directory-p (file-name-directory file)))))
 
 (defun url-cache-prepare (file)
-  "Makes it possible to cache data in FILE.
+  "Make it possible to cache data in FILE.
 Creates any necessary parent directories, deleting any non-directory files
 that would stop this.  Returns nil if parent directories can not be
 created.  If FILE already exists as a non-directory, it changes

diff --git a/lisp/url/url-cid.el b/lisp/url/url-cid.el
index 0ca2d8a0737605052ece8200e724770c1c4493e6..3095f7bd2c17d074b6d89af4d6b7431b3e51fffd 100644 (file)
--- a/lisp/url/url-cid.el
+++ b/lisp/url/url-cid.el
@@ -19,6 +19,8 @@
 ;; You should have received a copy of the GNU General Public License
 ;; along with GNU Emacs.  If not, see <https://www.gnu.org/licenses/>.
 
+;;; Commentary:
+
 ;;; Code:
 
 (require 'url-vars)

diff --git a/lisp/url/url-dired.el b/lisp/url/url-dired.el
index 398113db139b4409ea04d56e29f88694f8f2f2a5..feb7c50ce53351663fde97d4e39bfa18133cce10 100644 (file)
--- a/lisp/url/url-dired.el
+++ b/lisp/url/url-dired.el
@@ -19,6 +19,8 @@
 ;; You should have received a copy of the GNU General Public License
 ;; along with GNU Emacs.  If not, see <https://www.gnu.org/licenses/>.
 
+;;; Commentary:
+
 ;;; Code:
 
 (autoload 'dired-get-filename "dired")

diff --git a/lisp/url/url-expand.el b/lisp/url/url-expand.el
index 05088e3cac8d02ea414ee31325e7b6f208736c61..4e737e965dd537c46d79b0eb35382a01b09efa96 100644 (file)
--- a/lisp/url/url-expand.el
+++ b/lisp/url/url-expand.el
@@ -19,6 +19,8 @@
 ;; You should have received a copy of the GNU General Public License
 ;; along with GNU Emacs.  If not, see <https://www.gnu.org/licenses/>.
 
+;;; Commentary:
+
 ;;; Code:
 
 (require 'url-methods)

diff --git a/lisp/url/url-gw.el b/lisp/url/url-gw.el
index d2bf843fc36877a9d3fedc6b03e3a3353160b910..caffa6fb7bdec8e78b419f2ce1b61b3465a46e65 100644 (file)
--- a/lisp/url/url-gw.el
+++ b/lisp/url/url-gw.el
@@ -21,6 +21,8 @@
 ;; You should have received a copy of the GNU General Public License
 ;; along with GNU Emacs.  If not, see <https://www.gnu.org/licenses/>.
 
+;;; Commentary:
+
 ;;; Code:
 
 (require 'url-vars)

diff --git a/lisp/url/url-handlers.el b/lisp/url/url-handlers.el
index ed0402a51379bba798698e134a65cd3768fc246f..650c610e04c85933e232d1d738d56f88cb3a888b 100644 (file)
--- a/lisp/url/url-handlers.el
+++ b/lisp/url/url-handlers.el
@@ -102,6 +102,7 @@
 
 ;;;###autoload
 (define-minor-mode url-handler-mode
+  ;; Can't use "\\[find-file]" below as it produces "[open]":
   "Handle URLs as if they were file names throughout Emacs.
 After switching on this minor mode, Emacs file primitives handle
 URLs.  For instance:

diff --git a/lisp/url/url-misc.el b/lisp/url/url-misc.el
index fe2393beb6427e992dc069945860330c6c0c2f3a..c741b6c85a3768c72ec68b736f76df56c6c8ae5b 100644 (file)
--- a/lisp/url/url-misc.el
+++ b/lisp/url/url-misc.el
@@ -20,6 +20,8 @@
 ;; You should have received a copy of the GNU General Public License
 ;; along with GNU Emacs.  If not, see <https://www.gnu.org/licenses/>.
 
+;;; Commentary:
+
 ;;; Code:
 
 (require 'url-vars)

diff --git a/lisp/url/url-news.el b/lisp/url/url-news.el
index 4fe909cadbc5347fcf8830f15b00af904f6658fa..c9216862b0f819f855317137c8026197d88a969f 100644 (file)
--- a/lisp/url/url-news.el
+++ b/lisp/url/url-news.el
@@ -19,6 +19,8 @@
 ;; You should have received a copy of the GNU General Public License
 ;; along with GNU Emacs.  If not, see <https://www.gnu.org/licenses/>.
 
+;;; Commentary:
+
 ;;; Code:
 
 (require 'url-vars)

diff --git a/lisp/url/url-privacy.el b/lisp/url/url-privacy.el
index d926775c48ddd8ef10899d4f2fed937a3c3181d5..58ae6efbfc1a0b791a2b2d8bf42ce4189a6ac5c1 100644 (file)
--- a/lisp/url/url-privacy.el
+++ b/lisp/url/url-privacy.el
@@ -19,6 +19,8 @@
 ;; You should have received a copy of the GNU General Public License
 ;; along with GNU Emacs.  If not, see <https://www.gnu.org/licenses/>.
 
+;;; Commentary:
+
 ;;; Code:
 
 (require 'url-vars)

diff --git a/lisp/url/url-proxy.el b/lisp/url/url-proxy.el
index c89c1b6bc3ec73e1156687b990f8e03a4d725afa..0ffe51616db4b367354d413afba76d7dc62ed82d 100644 (file)
--- a/lisp/url/url-proxy.el
+++ b/lisp/url/url-proxy.el
@@ -19,6 +19,8 @@
 ;; You should have received a copy of the GNU General Public License
 ;; along with GNU Emacs.  If not, see <https://www.gnu.org/licenses/>.
 
+;;; Commentary:
+
 ;;; Code:
 
 (require 'url-parse)

diff --git a/lisp/url/url-vars.el b/lisp/url/url-vars.el
index f0d70ff6e75bead02dd49c97d0d56d9d2ffabff9..d916a71e41b3c5f7529c14bda95cadfb8a459ab8 100644 (file)
--- a/lisp/url/url-vars.el
+++ b/lisp/url/url-vars.el
@@ -20,6 +20,8 @@
 ;; You should have received a copy of the GNU General Public License
 ;; along with GNU Emacs.  If not, see <https://www.gnu.org/licenses/>.
 
+;;; Commentary:
+
 ;;; Code:
 
 (defgroup url nil