aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorStefan Kangas2020-12-30 12:38:20 +0100
committerStefan Kangas2020-12-30 12:44:19 +0100
commitdd662fc972a75df71cdaa25a2d763d1592df1eb8 (patch)
tree08f21b2dbe607561014d38d2219d55ad64d695c3
parentd0a254398609262dc5e6960655a7818f21a24447 (diff)
downloademacs-dd662fc972a75df71cdaa25a2d763d1592df1eb8.tar.gz
emacs-dd662fc972a75df71cdaa25a2d763d1592df1eb8.zip
Fix some over-wide docstrings
* lisp/cedet/semantic/analyze/refs.el (semantic-analyze-refs-proto) (semantic-analyze-refs-impl): * lisp/cedet/semantic/symref.el (semantic-symref-hit-to-tag-via-buffer): * lisp/emacs-lisp/chart.el (chart-axis-draw): * lisp/emacs-lisp/cl-macs.el (cl-defstruct, cl-loop): * lisp/emacs-lisp/eieio-core.el (eieio--add-new-slot): * lisp/eshell/em-unix.el (eshell/info): * lisp/gnus/deuglify.el (gnus-outlook-rearrange-article): * lisp/gnus/gnus-agent.el (gnus-agent-read-article-number): * lisp/gnus/gnus-util.el (gnus-put-overlay-excluding-newlines) (gnus-put-text-property-excluding-newlines): * lisp/gnus/message.el (message-sort-headers): * lisp/gnus/nntp.el (nntp-with-open-group) (nntp-with-open-group-function): * lisp/gnus/nnvirtual.el (nnvirtual-create-mapping): * lisp/mail/feedmail.el (feedmail-fiddle-list-of-fiddle-plexes) (feedmail-queue-reminder, feedmail-mail-send-hook-splitter): * lisp/net/dictionary.el (dictionary-do-matching): * lisp/obsolete/longlines.el (longlines-auto-wrap): * lisp/org/ob-sql.el (org-babel-sql-dbstring-vertica): * lisp/org/ol-bbdb.el (org-bbdb-date-list): * lisp/progmodes/cc-cmds.el (c-mark-function): * lisp/progmodes/cperl-mode.el (cperl-add-tags-recurse) (cperl-add-tags-recurse-noxs-fullpath) (cperl-add-tags-recurse-noxs): * lisp/progmodes/etags.el (tags-search): * lisp/progmodes/verilog-mode.el (verilog-delete-auto-buffer) (verilog-auto-re-search-do, verilog-expand-vector-internal): * lisp/textmodes/reftex-parse.el (reftex-init-section-numbers): * lisp/textmodes/reftex-toc.el (reftex-toc-load-all-files-for-promotion): * lisp/textmodes/sgml-mode.el (html-mode): * lisp/textmodes/table.el (table--transcoord-cache-to-table) (table--transcoord-table-to-cache, table--remove-eol-spaces) (table--region-in-cell-p, table-goto-bottom-right-corner) (table-split-cell-horizontally): * lisp/url/url-handlers.el (url-insert): * lisp/vc/ediff-util.el (ediff-inferior-compare-regions): Fix doc strings to not exceed 80-column limits. (Bug#44858)
-rw-r--r--lisp/cedet/semantic/analyze/refs.el6
-rw-r--r--lisp/cedet/semantic/symref.el7
-rw-r--r--lisp/emacs-lisp/chart.el3
-rw-r--r--lisp/emacs-lisp/cl-macs.el5
-rw-r--r--lisp/emacs-lisp/eieio-core.el4
-rw-r--r--lisp/eshell/em-unix.el3
-rw-r--r--lisp/gnus/deuglify.el2
-rw-r--r--lisp/gnus/gnus-agent.el3
-rw-r--r--lisp/gnus/gnus-util.el4
-rw-r--r--lisp/gnus/message.el2
-rw-r--r--lisp/gnus/nntp.el4
-rw-r--r--lisp/gnus/nnvirtual.el2
-rw-r--r--lisp/mail/feedmail.el34
-rw-r--r--lisp/net/dictionary.el2
-rw-r--r--lisp/obsolete/longlines.el3
-rw-r--r--lisp/org/ob-sql.el3
-rw-r--r--lisp/org/ol-bbdb.el2
-rw-r--r--lisp/progmodes/cc-cmds.el2
-rw-r--r--lisp/progmodes/cperl-mode.el6
-rw-r--r--lisp/progmodes/etags.el4
-rw-r--r--lisp/progmodes/verilog-mode.el7
-rw-r--r--lisp/textmodes/reftex-parse.el2
-rw-r--r--lisp/textmodes/reftex-toc.el3
-rw-r--r--lisp/textmodes/sgml-mode.el4
-rw-r--r--lisp/textmodes/table.el19
-rw-r--r--lisp/url/url-handlers.el4
-rw-r--r--lisp/vc/ediff-util.el4
27 files changed, 81 insertions, 63 deletions
diff --git a/lisp/cedet/semantic/analyze/refs.el b/lisp/cedet/semantic/analyze/refs.el
index 585f1a7c754..8f9bbade4d4 100644
--- a/lisp/cedet/semantic/analyze/refs.el
+++ b/lisp/cedet/semantic/analyze/refs.el
@@ -102,7 +102,8 @@ Use `semantic-analyze-current-tag' to debug this fcn."
102;; into the context. 102;; into the context.
103(cl-defmethod semantic-analyze-refs-impl ((refs semantic-analyze-references) &optional in-buffer) 103(cl-defmethod semantic-analyze-refs-impl ((refs semantic-analyze-references) &optional in-buffer)
104 "Return the implementations derived in the reference analyzer REFS. 104 "Return the implementations derived in the reference analyzer REFS.
105Optional argument IN-BUFFER indicates that the returned tag should be in an active buffer." 105Optional argument IN-BUFFER indicates that the returned tag
106should be in an active buffer."
106 (let ((allhits (oref refs rawsearchdata)) 107 (let ((allhits (oref refs rawsearchdata))
107 (tag (oref refs tag)) 108 (tag (oref refs tag))
108 (impl nil) 109 (impl nil)
@@ -127,7 +128,8 @@ Optional argument IN-BUFFER indicates that the returned tag should be in an acti
127 128
128(cl-defmethod semantic-analyze-refs-proto ((refs semantic-analyze-references) &optional in-buffer) 129(cl-defmethod semantic-analyze-refs-proto ((refs semantic-analyze-references) &optional in-buffer)
129 "Return the prototypes derived in the reference analyzer REFS. 130 "Return the prototypes derived in the reference analyzer REFS.
130Optional argument IN-BUFFER indicates that the returned tag should be in an active buffer." 131Optional argument IN-BUFFER indicates that the returned tag
132should be in an active buffer."
131 (let ((allhits (oref refs rawsearchdata)) 133 (let ((allhits (oref refs rawsearchdata))
132 (tag (oref refs tag)) 134 (tag (oref refs tag))
133 (proto nil)) 135 (proto nil))
diff --git a/lisp/cedet/semantic/symref.el b/lisp/cedet/semantic/symref.el
index 6bdec717457..4b095d738e4 100644
--- a/lisp/cedet/semantic/symref.el
+++ b/lisp/cedet/semantic/symref.el
@@ -511,9 +511,10 @@ Optional OPEN-BUFFERS, when nil will use a faster version of
511`find-file' when a file needs to be opened. If non-nil, then 511`find-file' when a file needs to be opened. If non-nil, then
512normal buffer initialization will be used. 512normal buffer initialization will be used.
513This function will leave buffers loaded from a file open, but 513This function will leave buffers loaded from a file open, but
514will add buffers that must be opened to `semantic-symref-recently-opened-buffers'. 514will add buffers that must be opened to
515Any caller MUST deal with that variable, either clearing it, or deleting the 515`semantic-symref-recently-opened-buffers'.
516buffers that were opened." 516Any caller MUST deal with that variable, either clearing it, or
517deleting the buffers that were opened."
517 (let* ((line (car hit)) 518 (let* ((line (car hit))
518 (file (cdr hit)) 519 (file (cdr hit))
519 (buff (find-buffer-visiting file)) 520 (buff (find-buffer-visiting file))
diff --git a/lisp/emacs-lisp/chart.el b/lisp/emacs-lisp/chart.el
index c1c6e3bf0fd..675a23f1dd5 100644
--- a/lisp/emacs-lisp/chart.el
+++ b/lisp/emacs-lisp/chart.el
@@ -333,7 +333,8 @@ Automatically compensates for direction."
333(cl-defmethod chart-axis-draw ((a chart-axis-names) &optional dir margin zone _start _end) 333(cl-defmethod chart-axis-draw ((a chart-axis-names) &optional dir margin zone _start _end)
334 "Draw axis information based upon A range to be spread along the edge. 334 "Draw axis information based upon A range to be spread along the edge.
335Optional argument DIR is the direction of the chart. 335Optional argument DIR is the direction of the chart.
336Optional arguments MARGIN, ZONE, START and END specify boundaries of the drawing." 336Optional arguments MARGIN, ZONE, START and END specify boundaries
337of the drawing."
337 (cl-call-next-method) 338 (cl-call-next-method)
338 ;; We prefer about 5 spaces between each value 339 ;; We prefer about 5 spaces between each value
339 (let* ((i 0) 340 (let* ((i 0)
diff --git a/lisp/emacs-lisp/cl-macs.el b/lisp/emacs-lisp/cl-macs.el
index 14b65ef25bf..8ac415704d9 100644
--- a/lisp/emacs-lisp/cl-macs.el
+++ b/lisp/emacs-lisp/cl-macs.el
@@ -900,7 +900,8 @@ This is compatible with Common Lisp, but note that `defun' and
900 "The Common Lisp `loop' macro. 900 "The Common Lisp `loop' macro.
901Valid clauses include: 901Valid clauses include:
902 For clauses: 902 For clauses:
903 for VAR from/upfrom/downfrom EXPR1 to/upto/downto/above/below EXPR2 [by EXPR3] 903 for VAR from/upfrom/downfrom EXPR1 to/upto/downto/above/below EXPR2
904 [by EXPR3]
904 for VAR = EXPR1 then EXPR2 905 for VAR = EXPR1 then EXPR2
905 for VAR in/on/in-ref LIST [by FUNC] 906 for VAR in/on/in-ref LIST [by FUNC]
906 for VAR across/across-ref ARRAY 907 for VAR across/across-ref ARRAY
@@ -2698,7 +2699,7 @@ Each SLOT may instead take the form (SNAME SDEFAULT SOPTIONS...), where
2698SDEFAULT is the default value of that slot and SOPTIONS are keyword-value 2699SDEFAULT is the default value of that slot and SOPTIONS are keyword-value
2699pairs for that slot. 2700pairs for that slot.
2700Supported keywords for slots are: 2701Supported keywords for slots are:
2701- `:read-only': If this has a non-nil value, that slot cannot be set via `setf'. 2702- `:read-only': If this has a non-nil value, that slot cannot be set via `setf'.
2702- `:documentation': this is a docstring describing the slot. 2703- `:documentation': this is a docstring describing the slot.
2703- `:type': the type of the field; currently only used for documentation. 2704- `:type': the type of the field; currently only used for documentation.
2704 2705
diff --git a/lisp/emacs-lisp/eieio-core.el b/lisp/emacs-lisp/eieio-core.el
index 3bc65d0d4c5..0f4b23c0bac 100644
--- a/lisp/emacs-lisp/eieio-core.el
+++ b/lisp/emacs-lisp/eieio-core.el
@@ -587,8 +587,8 @@ If SKIPNIL is non-nil, then if default value is nil return t instead."
587(defun eieio--add-new-slot (newc slot init alloc 587(defun eieio--add-new-slot (newc slot init alloc
588 &optional defaultoverride skipnil) 588 &optional defaultoverride skipnil)
589 "Add into NEWC attribute SLOT. 589 "Add into NEWC attribute SLOT.
590If a slot of that name already exists in NEWC, then do nothing. If it doesn't exist, 590If a slot of that name already exists in NEWC, then do nothing.
591INIT is the initarg, if any. 591If it doesn't exist, INIT is the initarg, if any.
592Argument ALLOC specifies if the slot is allocated per instance, or per class. 592Argument ALLOC specifies if the slot is allocated per instance, or per class.
593If optional DEFAULTOVERRIDE is non-nil, then if A exists in NEWC, 593If optional DEFAULTOVERRIDE is non-nil, then if A exists in NEWC,
594we must override its value for a default. 594we must override its value for a default.
diff --git a/lisp/eshell/em-unix.el b/lisp/eshell/em-unix.el
index 2d6bd32b5a2..2528c28691b 100644
--- a/lisp/eshell/em-unix.el
+++ b/lisp/eshell/em-unix.el
@@ -169,7 +169,8 @@ Otherwise, Emacs will attempt to use rsh to invoke du on the remote machine."
169 `info' => goes to top info window 169 `info' => goes to top info window
170 `info arg1' => IF arg1 is a file, then visits arg1 170 `info arg1' => IF arg1 is a file, then visits arg1
171 `info arg1' => OTHERWISE goes to top info window and then menu item arg1 171 `info arg1' => OTHERWISE goes to top info window and then menu item arg1
172 `info arg1 arg2' => does action for arg1 (either visit-file or menu-item) and then menu item arg2 172 `info arg1 arg2' => does action for arg1 (either visit-file or menu-item) and
173 then menu item arg2
173 etc." 174 etc."
174 (eval-and-compile (require 'info)) 175 (eval-and-compile (require 'info))
175 (let ((file (cond 176 (let ((file (cond
diff --git a/lisp/gnus/deuglify.el b/lisp/gnus/deuglify.el
index fdc5302a28f..85d71af87e4 100644
--- a/lisp/gnus/deuglify.el
+++ b/lisp/gnus/deuglify.el
@@ -342,7 +342,7 @@ NODISPLAY is non-nil, don't redisplay the article buffer."
342 (unless nodisplay (gnus-outlook-display-article-buffer))) 342 (unless nodisplay (gnus-outlook-display-article-buffer)))
343 343
344(defun gnus-outlook-rearrange-article (attr-start) 344(defun gnus-outlook-rearrange-article (attr-start)
345 "Put the text from ATTR-START to the end of buffer at the top of the article buffer." 345 "Put text from ATTR-START to the end of buffer at the top of the article buffer."
346 ;; FIXME: 1. (*) text/plain ( ) text/html 346 ;; FIXME: 1. (*) text/plain ( ) text/html
347 (let ((inhibit-read-only t) 347 (let ((inhibit-read-only t)
348 (cite-marks gnus-outlook-deuglify-cite-marks)) 348 (cite-marks gnus-outlook-deuglify-cite-marks))
diff --git a/lisp/gnus/gnus-agent.el b/lisp/gnus/gnus-agent.el
index d6802a35d0c..ea9e1257e85 100644
--- a/lisp/gnus/gnus-agent.el
+++ b/lisp/gnus/gnus-agent.el
@@ -1901,7 +1901,8 @@ article numbers will be returned."
1901 articles)) 1901 articles))
1902 1902
1903(defsubst gnus-agent-read-article-number () 1903(defsubst gnus-agent-read-article-number ()
1904 "Reads the article number at point. Returns nil when a valid article number can not be read." 1904 "Read the article number at point.
1905Return nil when a valid article number can not be read."
1905 1906
1906 (when (looking-at "[0-9]+\t") 1907 (when (looking-at "[0-9]+\t")
1907 (read (current-buffer)))) 1908 (read (current-buffer))))
diff --git a/lisp/gnus/gnus-util.el b/lisp/gnus/gnus-util.el
index ef811c65b86..76c6dd6429d 100644
--- a/lisp/gnus/gnus-util.el
+++ b/lisp/gnus/gnus-util.el
@@ -785,7 +785,7 @@ If there's no subdirectory, delete DIRECTORY as well."
785 string) 785 string)
786 786
787(defsubst gnus-put-text-property-excluding-newlines (beg end prop val) 787(defsubst gnus-put-text-property-excluding-newlines (beg end prop val)
788 "The same as `put-text-property', but don't put this prop on any newlines in the region." 788 "Like `put-text-property', but don't put this prop on any newlines in the region."
789 (save-match-data 789 (save-match-data
790 (save-excursion 790 (save-excursion
791 (save-restriction 791 (save-restriction
@@ -796,7 +796,7 @@ If there's no subdirectory, delete DIRECTORY as well."
796 (put-text-property beg (point) prop val))))) 796 (put-text-property beg (point) prop val)))))
797 797
798(defsubst gnus-put-overlay-excluding-newlines (beg end prop val) 798(defsubst gnus-put-overlay-excluding-newlines (beg end prop val)
799 "The same as `put-text-property', but don't put this prop on any newlines in the region." 799 "Like `put-text-property', but don't put this prop on any newlines in the region."
800 (save-match-data 800 (save-match-data
801 (save-excursion 801 (save-excursion
802 (save-restriction 802 (save-restriction
diff --git a/lisp/gnus/message.el b/lisp/gnus/message.el
index 86800f28cc4..84bde80b162 100644
--- a/lisp/gnus/message.el
+++ b/lisp/gnus/message.el
@@ -2669,7 +2669,7 @@ Point is left at the beginning of the narrowed-to region."
2669 10000)))) 2669 10000))))
2670 2670
2671(defun message-sort-headers () 2671(defun message-sort-headers ()
2672 "Sort the headers of the current message according to `message-header-format-alist'." 2672 "Sort headers of the current message according to `message-header-format-alist'."
2673 (interactive) 2673 (interactive)
2674 (save-excursion 2674 (save-excursion
2675 (save-restriction 2675 (save-restriction
diff --git a/lisp/gnus/nntp.el b/lisp/gnus/nntp.el
index 887dce3472f..19dbb50da8c 100644
--- a/lisp/gnus/nntp.el
+++ b/lisp/gnus/nntp.el
@@ -600,7 +600,7 @@ retried once before actually displaying the error report."
600 nil))) 600 nil)))
601 601
602(defun nntp-with-open-group-function (group server connectionless bodyfun) 602(defun nntp-with-open-group-function (group server connectionless bodyfun)
603 "Protect against servers that don't like clients that keep idle connections opens. 603 "Protect against servers that don't like clients that keep idle connections open.
604The problem being that these servers may either close a connection or 604The problem being that these servers may either close a connection or
605simply ignore any further requests on a connection. Closed 605simply ignore any further requests on a connection. Closed
606connections are not detected until `accept-process-output' has updated 606connections are not detected until `accept-process-output' has updated
@@ -651,7 +651,7 @@ command whose response triggered the error."
651 nntp-with-open-group-internal)) 651 nntp-with-open-group-internal))
652 652
653(defmacro nntp-with-open-group (group server &optional connectionless &rest forms) 653(defmacro nntp-with-open-group (group server &optional connectionless &rest forms)
654 "Protect against servers that don't like clients that keep idle connections opens. 654 "Protect against servers that don't like clients that keep idle connections open.
655The problem being that these servers may either close a connection or 655The problem being that these servers may either close a connection or
656simply ignore any further requests on a connection. Closed 656simply ignore any further requests on a connection. Closed
657connections are not detected until `accept-process-output' has updated 657connections are not detected until `accept-process-output' has updated
diff --git a/lisp/gnus/nnvirtual.el b/lisp/gnus/nnvirtual.el
index 3e9e608a099..2d314a8ec2a 100644
--- a/lisp/gnus/nnvirtual.el
+++ b/lisp/gnus/nnvirtual.el
@@ -667,7 +667,7 @@ the result."
667 667
668 668
669(defun nnvirtual-create-mapping (dont-check) 669(defun nnvirtual-create-mapping (dont-check)
670 "Build the tables necessary to map between component (group, article) to virtual article. 670 "Build tables to map between component (group, article) to virtual article.
671Generate the set of read messages and marks for the virtual group 671Generate the set of read messages and marks for the virtual group
672based on the marks on the component groups." 672based on the marks on the component groups."
673 (let ((cnt 0) 673 (let ((cnt 0)
diff --git a/lisp/mail/feedmail.el b/lisp/mail/feedmail.el
index ce5a57e2283..2bcbdf4a223 100644
--- a/lisp/mail/feedmail.el
+++ b/lisp/mail/feedmail.el
@@ -1341,19 +1341,22 @@ variable, but may depend on its value as described here.")
1341 1341
1342(defun feedmail-mail-send-hook-splitter () 1342(defun feedmail-mail-send-hook-splitter ()
1343 "Facilitate dividing `mail-send-hook' things into queued and immediate cases. 1343 "Facilitate dividing `mail-send-hook' things into queued and immediate cases.
1344If you have `mail-send-hook' functions that should only be called for sending/ 1344If you have `mail-send-hook' functions that should only be called
1345queueing messages or only be called for the sending of queued messages, this is 1345for sending/ queueing messages or only be called for the sending
1346for you. Add this function to `mail-send-hook' with something like this: 1346of queued messages, this is for you. Add this function to
1347`mail-send-hook' with something like this:
1347 1348
1348 (add-hook \\='mail-send-hook \\='feedmail-mail-send-hook-splitter) 1349 (add-hook \\='mail-send-hook \\='feedmail-mail-send-hook-splitter)
1349 1350
1350Then add the functions you want called to either `feedmail-mail-send-hook-queued' 1351Then add the functions you want called to either
1351or `feedmail-mail-send-hook', as appropriate. The distinction is that 1352`feedmail-mail-send-hook-queued' or `feedmail-mail-send-hook', as
1352`feedmail-mail-send-hook' will be called when you send mail from a composition 1353appropriate. The distinction is that `feedmail-mail-send-hook'
1353buffer (typically by typing C-c C-c), whether the message is sent immediately 1354will be called when you send mail from a composition
1354or placed in the queue or drafts directory. `feedmail-mail-send-hook-queued' is 1355buffer (typically by typing C-c C-c), whether the message is sent
1355called when messages are being sent from the queue directory, typically via a 1356immediately or placed in the queue or drafts directory.
1356call to `feedmail-run-the-queue'." 1357`feedmail-mail-send-hook-queued' is called when messages are
1358being sent from the queue directory, typically via a call to
1359`feedmail-run-the-queue'."
1357 (feedmail-say-debug ">in-> feedmail-mail-send-hook-splitter %s" feedmail-queue-runner-is-active) 1360 (feedmail-say-debug ">in-> feedmail-mail-send-hook-splitter %s" feedmail-queue-runner-is-active)
1358 (if feedmail-queue-runner-is-active 1361 (if feedmail-queue-runner-is-active
1359 (run-hooks 'feedmail-mail-send-hook-queued) 1362 (run-hooks 'feedmail-mail-send-hook-queued)
@@ -2072,10 +2075,10 @@ internally by feedmail):
2072 after-run (the queue has just been run, possibly sending messages) 2075 after-run (the queue has just been run, possibly sending messages)
2073 2076
2074WHAT-EVENT is used as a key into the table `feedmail-queue-reminder-alist'. If 2077WHAT-EVENT is used as a key into the table `feedmail-queue-reminder-alist'. If
2075the associated value is a function, it is called without arguments and is expected 2078the associated value is a function, it is called without arguments and is
2076to perform the reminder activity. You can supply your own reminder functions 2079expected to perform the reminder activity. You can supply your own reminder
2077by redefining `feedmail-queue-reminder-alist'. If you don't want any reminders, 2080functions by redefining `feedmail-queue-reminder-alist'. If you don't want any
2078you can set `feedmail-queue-reminder-alist' to nil." 2081reminders, you can set `feedmail-queue-reminder-alist' to nil."
2079 (interactive "p") 2082 (interactive "p")
2080 (feedmail-say-debug ">in-> feedmail-queue-reminder %s" what-event) 2083 (feedmail-say-debug ">in-> feedmail-queue-reminder %s" what-event)
2081 (let ((key (if (and what-event (symbolp what-event)) what-event 'on-demand)) entry reminder) 2084 (let ((key (if (and what-event (symbolp what-event)) what-event 'on-demand)) entry reminder)
@@ -2970,7 +2973,8 @@ probably not appropriate for you."
2970 2973
2971 2974
2972(defun feedmail-fiddle-list-of-fiddle-plexes (list-of-fiddle-plexes) 2975(defun feedmail-fiddle-list-of-fiddle-plexes (list-of-fiddle-plexes)
2973 "Fiddling based on a list of fiddle-plexes. Values t, nil, and string are pointless." 2976 "Fiddling based on a list of fiddle-plexes.
2977Values t, nil, and string are pointless."
2974 (feedmail-say-debug ">in-> feedmail-fiddle-list-of-fiddle-plexes") 2978 (feedmail-say-debug ">in-> feedmail-fiddle-list-of-fiddle-plexes")
2975 ;; default is to fall off the end of the list and do nothing 2979 ;; default is to fall off the end of the list and do nothing
2976 (let ((lofp list-of-fiddle-plexes) fp) 2980 (let ((lofp list-of-fiddle-plexes) fp)
diff --git a/lisp/net/dictionary.el b/lisp/net/dictionary.el
index 0df9d8b1423..07f44ba035b 100644
--- a/lisp/net/dictionary.el
+++ b/lisp/net/dictionary.el
@@ -1029,7 +1029,7 @@ If PATTERN is omitted, it defaults to \"[ \\f\\t\\n\\r\\v]+\"."
1029 'dictionary-display-match-result))) 1029 'dictionary-display-match-result)))
1030 1030
1031(defun dictionary-do-matching (word dictionary strategy function) 1031(defun dictionary-do-matching (word dictionary strategy function)
1032 "Find matches for WORD with STRATEGY in DICTIONARY and displays them with FUNCTION." 1032 "Find matches for WORD with STRATEGY in DICTIONARY and display them with FUNCTION."
1033 1033
1034 (message "Lookup matching words for %s in %s using %s" 1034 (message "Lookup matching words for %s in %s using %s"
1035 word dictionary strategy) 1035 word dictionary strategy)
diff --git a/lisp/obsolete/longlines.el b/lisp/obsolete/longlines.el
index cbe453aa6bf..46f89c2e5a2 100644
--- a/lisp/obsolete/longlines.el
+++ b/lisp/obsolete/longlines.el
@@ -407,7 +407,8 @@ Hard newlines are left intact."
407 407
408(defun longlines-auto-wrap (&optional arg) 408(defun longlines-auto-wrap (&optional arg)
409 "Toggle automatic line wrapping. 409 "Toggle automatic line wrapping.
410With optional argument ARG, turn on line wrapping if and only if ARG is positive. 410With optional argument ARG, turn on line wrapping if and only if
411ARG is positive.
411If automatic line wrapping is turned on, wrap the entire buffer." 412If automatic line wrapping is turned on, wrap the entire buffer."
412 (interactive "P") 413 (interactive "P")
413 (setq arg (if arg 414 (setq arg (if arg
diff --git a/lisp/org/ob-sql.el b/lisp/org/ob-sql.el
index 7c359b988d3..30d352cf494 100644
--- a/lisp/org/ob-sql.el
+++ b/lisp/org/ob-sql.el
@@ -164,7 +164,8 @@ SQL Server on Windows and Linux platform."
164 " ")) 164 " "))
165 165
166(defun org-babel-sql-dbstring-vertica (host port user password database) 166(defun org-babel-sql-dbstring-vertica (host port user password database)
167 "Make Vertica command line args for database connection. Pass nil to omit that arg." 167 "Make Vertica command line args for database connection.
168Pass nil to omit that arg."
168 (mapconcat #'identity 169 (mapconcat #'identity
169 (delq nil 170 (delq nil
170 (list (when host (format "-h %s" host)) 171 (list (when host (format "-h %s" host))
diff --git a/lisp/org/ol-bbdb.el b/lisp/org/ol-bbdb.el
index 73627b901fa..444bde37cd8 100644
--- a/lisp/org/ol-bbdb.el
+++ b/lisp/org/ol-bbdb.el
@@ -431,7 +431,7 @@ variable to be globally bound."
431;;; to override the 7-day default. 431;;; to override the 7-day default.
432 432
433(defun org-bbdb-date-list (d n) 433(defun org-bbdb-date-list (d n)
434 "Return a list of dates in (m d y) format from the given date D to n-1 days hence." 434 "Return list of dates in (m d y) format from the given date D to n-1 days hence."
435 (let ((abs (calendar-absolute-from-gregorian d))) 435 (let ((abs (calendar-absolute-from-gregorian d)))
436 (mapcar (lambda (i) (calendar-gregorian-from-absolute (+ abs i))) 436 (mapcar (lambda (i) (calendar-gregorian-from-absolute (+ abs i)))
437 (number-sequence 0 (1- n))))) 437 (number-sequence 0 (1- n)))))
diff --git a/lisp/progmodes/cc-cmds.el b/lisp/progmodes/cc-cmds.el
index 0ce3b3f6edd..7dcdcb11637 100644
--- a/lisp/progmodes/cc-cmds.el
+++ b/lisp/progmodes/cc-cmds.el
@@ -2357,7 +2357,7 @@ With a prefix arg, push the name onto the kill ring too."
2357(put 'c-display-defun-name 'isearch-scroll t) 2357(put 'c-display-defun-name 'isearch-scroll t)
2358 2358
2359(defun c-mark-function () 2359(defun c-mark-function ()
2360 "Put mark at end of the current top-level declaration or macro, point at beginning. 2360 "Put mark at end of current top-level declaration or macro, point at beginning.
2361If point is not inside any then the closest following one is 2361If point is not inside any then the closest following one is
2362chosen. Each successive call of this command extends the marked 2362chosen. Each successive call of this command extends the marked
2363region by one function. 2363region by one function.
diff --git a/lisp/progmodes/cperl-mode.el b/lisp/progmodes/cperl-mode.el
index 2fc2d14ee6a..68c3b1b9d15 100644
--- a/lisp/progmodes/cperl-mode.el
+++ b/lisp/progmodes/cperl-mode.el
@@ -6533,7 +6533,7 @@ Does not move point."
6533(defun cperl-add-tags-recurse-noxs () 6533(defun cperl-add-tags-recurse-noxs ()
6534 "Add to TAGS data for \"pure\" Perl files in the current directory and kids. 6534 "Add to TAGS data for \"pure\" Perl files in the current directory and kids.
6535Use as 6535Use as
6536 emacs -batch -q -no-site-file -l emacs/cperl-mode.el \ 6536 emacs -batch -q -no-site-file -l emacs/cperl-mode.el \\
6537 -f cperl-add-tags-recurse-noxs 6537 -f cperl-add-tags-recurse-noxs
6538" 6538"
6539 (cperl-write-tags nil nil t t nil t)) 6539 (cperl-write-tags nil nil t t nil t))
@@ -6542,7 +6542,7 @@ Use as
6542 "Add to TAGS data for \"pure\" Perl in the current directory and kids. 6542 "Add to TAGS data for \"pure\" Perl in the current directory and kids.
6543Writes down fullpath, so TAGS is relocatable (but if the build directory 6543Writes down fullpath, so TAGS is relocatable (but if the build directory
6544is relocated, the file TAGS inside it breaks). Use as 6544is relocated, the file TAGS inside it breaks). Use as
6545 emacs -batch -q -no-site-file -l emacs/cperl-mode.el \ 6545 emacs -batch -q -no-site-file -l emacs/cperl-mode.el \\
6546 -f cperl-add-tags-recurse-noxs-fullpath 6546 -f cperl-add-tags-recurse-noxs-fullpath
6547" 6547"
6548 (cperl-write-tags nil nil t t nil t "")) 6548 (cperl-write-tags nil nil t t nil t ""))
@@ -6550,7 +6550,7 @@ is relocated, the file TAGS inside it breaks). Use as
6550(defun cperl-add-tags-recurse () 6550(defun cperl-add-tags-recurse ()
6551 "Add to TAGS file data for Perl files in the current directory and kids. 6551 "Add to TAGS file data for Perl files in the current directory and kids.
6552Use as 6552Use as
6553 emacs -batch -q -no-site-file -l emacs/cperl-mode.el \ 6553 emacs -batch -q -no-site-file -l emacs/cperl-mode.el \\
6554 -f cperl-add-tags-recurse 6554 -f cperl-add-tags-recurse
6555" 6555"
6556 (cperl-write-tags nil nil t t)) 6556 (cperl-write-tags nil nil t t))
diff --git a/lisp/progmodes/etags.el b/lisp/progmodes/etags.el
index aadfb8150cf..6c8e6f68b0b 100644
--- a/lisp/progmodes/etags.el
+++ b/lisp/progmodes/etags.el
@@ -1814,8 +1814,8 @@ argument is passed to `next-file', which see)."
1814Stops when a match is found. 1814Stops when a match is found.
1815To continue searching for next match, use command \\[tags-loop-continue]. 1815To continue searching for next match, use command \\[tags-loop-continue].
1816 1816
1817If FILES if non-nil should be a list or an iterator returning the files to search. 1817If FILES if non-nil should be a list or an iterator returning the
1818The search will be restricted to these files. 1818files to search. The search will be restricted to these files.
1819 1819
1820Also see the documentation of the `tags-file-name' variable." 1820Also see the documentation of the `tags-file-name' variable."
1821 (interactive "sTags search (regexp): ") 1821 (interactive "sTags search (regexp): ")
diff --git a/lisp/progmodes/verilog-mode.el b/lisp/progmodes/verilog-mode.el
index f6e95b9cb6a..0c908451d32 100644
--- a/lisp/progmodes/verilog-mode.el
+++ b/lisp/progmodes/verilog-mode.el
@@ -5193,7 +5193,7 @@ Useful for creating tri's and other expanded fields."
5193 (verilog-expand-vector-internal "[" "]")) 5193 (verilog-expand-vector-internal "[" "]"))
5194 5194
5195(defun verilog-expand-vector-internal (bra ket) 5195(defun verilog-expand-vector-internal (bra ket)
5196 "Given BRA, the start brace and KET, the end brace, expand one line into many lines." 5196 "Given start brace BRA, and end brace KET, expand one line into many lines."
5197 (save-excursion 5197 (save-excursion
5198 (forward-line 0) 5198 (forward-line 0)
5199 (let ((signal-string (buffer-substring (point) 5199 (let ((signal-string (buffer-substring (point)
@@ -10450,7 +10450,7 @@ if non-nil."
10450;; 10450;;
10451 10451
10452(defun verilog-auto-re-search-do (search-for func) 10452(defun verilog-auto-re-search-do (search-for func)
10453 "Search for the given auto text regexp SEARCH-FOR, and perform FUNC where it occurs." 10453 "Search for given auto text regexp SEARCH-FOR, and perform FUNC where it occurs."
10454 (goto-char (point-min)) 10454 (goto-char (point-min))
10455 (while (verilog-re-search-forward-quick search-for nil t) 10455 (while (verilog-re-search-forward-quick search-for nil t)
10456 (funcall func))) 10456 (funcall func)))
@@ -10862,7 +10862,8 @@ removed."
10862 10862
10863(defun verilog-delete-auto-buffer () 10863(defun verilog-delete-auto-buffer ()
10864 "Perform `verilog-delete-auto' on the current buffer. 10864 "Perform `verilog-delete-auto' on the current buffer.
10865Intended for internal use inside a `verilog-save-font-no-change-functions' block." 10865Intended for internal use inside a
10866`verilog-save-font-no-change-functions' block."
10866 ;; Allow user to customize 10867 ;; Allow user to customize
10867 (verilog-run-hooks 'verilog-before-delete-auto-hook) 10868 (verilog-run-hooks 'verilog-before-delete-auto-hook)
10868 10869
diff --git a/lisp/textmodes/reftex-parse.el b/lisp/textmodes/reftex-parse.el
index 4f4afe9d2c6..c394fc31eca 100644
--- a/lisp/textmodes/reftex-parse.el
+++ b/lisp/textmodes/reftex-parse.el
@@ -1046,7 +1046,7 @@ When point is just after a { or [, limit string to matching parenthesis."
1046 1046
1047;;;###autoload 1047;;;###autoload
1048(defun reftex-init-section-numbers (&optional toc-entry appendix) 1048(defun reftex-init-section-numbers (&optional toc-entry appendix)
1049 "Initialize the section numbers with zeros or with what is found in the TOC-ENTRY." 1049 "Initialize section numbers with zeros or with what is found in the TOC-ENTRY."
1050 (let* ((level (or (nth 5 toc-entry) -1)) 1050 (let* ((level (or (nth 5 toc-entry) -1))
1051 (numbers (nreverse (split-string (or (nth 6 toc-entry) "") "\\."))) 1051 (numbers (nreverse (split-string (or (nth 6 toc-entry) "") "\\.")))
1052 (depth (1- (length reftex-section-numbers))) 1052 (depth (1- (length reftex-section-numbers)))
diff --git a/lisp/textmodes/reftex-toc.el b/lisp/textmodes/reftex-toc.el
index eb6ed2ff441..851629598eb 100644
--- a/lisp/textmodes/reftex-toc.el
+++ b/lisp/textmodes/reftex-toc.el
@@ -851,7 +851,8 @@ if these sets are sorted blocks in the alist."
851 "Make sure all files of the document are being visited by buffers, 851 "Make sure all files of the document are being visited by buffers,
852and that the scanning info is absolutely up to date. 852and that the scanning info is absolutely up to date.
853We do this by rescanning with `reftex-keep-temporary-buffers' bound to t. 853We do this by rescanning with `reftex-keep-temporary-buffers' bound to t.
854The variable `reftex--pro-or-de' is assumed to be dynamically scoped into this function. 854The variable `reftex--pro-or-de' is assumed to be dynamically
855scoped into this function.
855When finished, we exit with an error message." 856When finished, we exit with an error message."
856 (let ((reftex-keep-temporary-buffers t)) 857 (let ((reftex-keep-temporary-buffers t))
857 (reftex-toc-Rescan) 858 (reftex-toc-Rescan)
diff --git a/lisp/textmodes/sgml-mode.el b/lisp/textmodes/sgml-mode.el
index f3d8695e248..adeff9b9e59 100644
--- a/lisp/textmodes/sgml-mode.el
+++ b/lisp/textmodes/sgml-mode.el
@@ -2364,8 +2364,8 @@ have <h1>Very Major Headlines</h1> through <h6>Very Minor Headlines</h6>
2364 2364
2365<p>Paragraphs only need an opening tag. Line breaks and multiple spaces are 2365<p>Paragraphs only need an opening tag. Line breaks and multiple spaces are
2366ignored unless the text is <pre>preformatted.</pre> Text can be marked as 2366ignored unless the text is <pre>preformatted.</pre> Text can be marked as
2367<strong>bold</strong>, <em>italic</em> or <u>underlined</u> using the normal M-o or 2367<strong>bold</strong>, <em>italic</em> or <u>underlined</u> using the normal M-o
2368Edit/Text Properties/Face commands. 2368or Edit/Text Properties/Face commands.
2369 2369
2370Pages can have <a name=\"SOMENAME\">named points</a> and can link other points 2370Pages can have <a name=\"SOMENAME\">named points</a> and can link other points
2371to them with <a href=\"#SOMENAME\">see also somename</a>. In the same way <a 2371to them with <a href=\"#SOMENAME\">see also somename</a>. In the same way <a
diff --git a/lisp/textmodes/table.el b/lisp/textmodes/table.el
index 59d60272aa8..daae88e138c 100644
--- a/lisp/textmodes/table.el
+++ b/lisp/textmodes/table.el
@@ -2651,7 +2651,8 @@ Creates a cell above and a cell below the current point location."
2651;;;###autoload 2651;;;###autoload
2652(defun table-split-cell-horizontally () 2652(defun table-split-cell-horizontally ()
2653 "Split current cell horizontally. 2653 "Split current cell horizontally.
2654Creates a cell on the left and a cell on the right of the current point location." 2654Creates a cell on the left and a cell on the right of the current
2655point location."
2655 (interactive "*") 2656 (interactive "*")
2656 (table-recognize-cell 'force) 2657 (table-recognize-cell 'force)
2657 (let* ((o-coordinate (table--get-coordinate)) 2658 (let* ((o-coordinate (table--get-coordinate))
@@ -4197,21 +4198,21 @@ cache buffer into the designated cell in the table buffer."
4197 (1- (cdr (table--get-coordinate (car (table--vertical-cell-list t t)))))))) 4198 (1- (cdr (table--get-coordinate (car (table--vertical-cell-list t t))))))))
4198 4199
4199(defun table-goto-top-right-corner () 4200(defun table-goto-top-right-corner ()
4200 "Move point to top right corner of the current table and return the char position." 4201 "Move point to top right corner of the current table and return char position."
4201 (table--goto-coordinate 4202 (table--goto-coordinate
4202 (cons 4203 (cons
4203 (car (table--get-coordinate (cdr (table--horizontal-cell-list nil t)))) 4204 (car (table--get-coordinate (cdr (table--horizontal-cell-list nil t))))
4204 (1- (cdr (table--get-coordinate (car (table--vertical-cell-list t t)))))))) 4205 (1- (cdr (table--get-coordinate (car (table--vertical-cell-list t t))))))))
4205 4206
4206(defun table-goto-bottom-left-corner () 4207(defun table-goto-bottom-left-corner ()
4207 "Move point to bottom left corner of the current table and return the char position." 4208 "Move point to bottom left corner of the current table and return char position."
4208 (table--goto-coordinate 4209 (table--goto-coordinate
4209 (cons 4210 (cons
4210 (1- (car (table--get-coordinate (car (table--horizontal-cell-list t t))))) 4211 (1- (car (table--get-coordinate (car (table--horizontal-cell-list t t)))))
4211 (1+ (cdr (table--get-coordinate (cdr (table--vertical-cell-list nil t)))))))) 4212 (1+ (cdr (table--get-coordinate (cdr (table--vertical-cell-list nil t))))))))
4212 4213
4213(defun table-goto-bottom-right-corner () 4214(defun table-goto-bottom-right-corner ()
4214 "Move point to bottom right corner of the current table and return the char position." 4215 "Move point to bottom right corner of the current table and return char position."
4215 (table--goto-coordinate 4216 (table--goto-coordinate
4216 (cons 4217 (cons
4217 (car (table--get-coordinate (cdr (table--horizontal-cell-list nil t)))) 4218 (car (table--get-coordinate (cdr (table--horizontal-cell-list nil t))))
@@ -4925,7 +4926,7 @@ When optional LOCATION is provided the test is performed at that location."
4925 t)) 4926 t))
4926 4927
4927(defun table--region-in-cell-p (beg end) 4928(defun table--region-in-cell-p (beg end)
4928 "Return t when location BEG and END are in a valid table cell in the current buffer." 4929 "Return t when location BEG and END are in a valid table cell in current buffer."
4929 (and (table--at-cell-p (min beg end)) 4930 (and (table--at-cell-p (min beg end))
4930 (save-excursion 4931 (save-excursion
4931 (let ((cell-beg (progn (goto-char beg) (table--probe-cell)))) 4932 (let ((cell-beg (progn (goto-char beg) (table--probe-cell))))
@@ -5245,7 +5246,7 @@ works better than the previous versions however not fully compatible.
5245 str)) 5246 str))
5246 5247
5247(defun table--remove-eol-spaces (beg end &optional bol force) 5248(defun table--remove-eol-spaces (beg end &optional bol force)
5248 "Remove spaces at the end of each line in the BEG END region of the current buffer. 5249 "Remove spaces at the end of each line in the BEG END region of current buffer.
5249When optional BOL is non-nil spaces at the beginning of line are 5250When optional BOL is non-nil spaces at the beginning of line are
5250removed. When optional FORCE is non-nil removal operation is enforced 5251removed. When optional FORCE is non-nil removal operation is enforced
5251even when point is within the removal area." 5252even when point is within the removal area."
@@ -5386,7 +5387,8 @@ point"
5386 5387
5387(defun table--transcoord-table-to-cache (&optional coordinate) 5388(defun table--transcoord-table-to-cache (&optional coordinate)
5388 "Transpose COORDINATE from table coordinate system to cache coordinate system. 5389 "Transpose COORDINATE from table coordinate system to cache coordinate system.
5389When COORDINATE is omitted or nil the point in current buffer is assumed in place." 5390When COORDINATE is omitted or nil the point in current buffer is
5391assumed in place."
5390 (table--offset-coordinate 5392 (table--offset-coordinate
5391 (or coordinate (table--get-coordinate)) 5393 (or coordinate (table--get-coordinate))
5392 table-cell-info-lu-coordinate 5394 table-cell-info-lu-coordinate
@@ -5394,7 +5396,8 @@ When COORDINATE is omitted or nil the point in current buffer is assumed in plac
5394 5396
5395(defun table--transcoord-cache-to-table (&optional coordinate) 5397(defun table--transcoord-cache-to-table (&optional coordinate)
5396 "Transpose COORDINATE from cache coordinate system to table coordinate system. 5398 "Transpose COORDINATE from cache coordinate system to table coordinate system.
5397When COORDINATE is omitted or nil the point in current buffer is assumed in place." 5399When COORDINATE is omitted or nil the point in current buffer is
5400assumed in place."
5398 (table--offset-coordinate 5401 (table--offset-coordinate
5399 (or coordinate (table--get-coordinate)) 5402 (or coordinate (table--get-coordinate))
5400 table-cell-info-lu-coordinate)) 5403 table-cell-info-lu-coordinate))
diff --git a/lisp/url/url-handlers.el b/lisp/url/url-handlers.el
index 1c3607bb661..d5e6078fe76 100644
--- a/lisp/url/url-handlers.el
+++ b/lisp/url/url-handlers.el
@@ -299,8 +299,8 @@ BUFFER should be a complete URL buffer as returned by `url-retrieve'.
299If the headers specify a coding-system (and current buffer is multibyte), 299If the headers specify a coding-system (and current buffer is multibyte),
300it is applied to the body before it is inserted. 300it is applied to the body before it is inserted.
301Returns a list of the form (SIZE CHARSET), where SIZE is the size in bytes 301Returns a list of the form (SIZE CHARSET), where SIZE is the size in bytes
302of the inserted text and CHARSET is the charset that was specified in the header, 302of the inserted text and CHARSET is the charset that was specified in the
303or nil if none was found. 303header, or nil if none was found.
304BEG and END can be used to only insert a subpart of the body. 304BEG and END can be used to only insert a subpart of the body.
305They count bytes from the beginning of the body." 305They count bytes from the beginning of the body."
306 (let* ((handle (with-current-buffer buffer (mm-dissect-buffer t))) 306 (let* ((handle (with-current-buffer buffer (mm-dissect-buffer t)))
diff --git a/lisp/vc/ediff-util.el b/lisp/vc/ediff-util.el
index 73c39b65197..785d4e4c5dd 100644
--- a/lisp/vc/ediff-util.el
+++ b/lisp/vc/ediff-util.el
@@ -3443,8 +3443,8 @@ Without an argument, it saves customized diff argument, if available
3443 3443
3444(defun ediff-inferior-compare-regions () 3444(defun ediff-inferior-compare-regions ()
3445 "Compare regions in an active Ediff session. 3445 "Compare regions in an active Ediff session.
3446Like `ediff-regions-linewise' but is called from under an active Ediff session on 3446Like `ediff-regions-linewise' but is called from under an active Ediff session
3447the files that belong to that session. 3447on the files that belong to that session.
3448 3448
3449After quitting the session invoked via this function, type C-l to the parent 3449After quitting the session invoked via this function, type C-l to the parent
3450Ediff Control Panel to restore highlighting." 3450Ediff Control Panel to restore highlighting."