aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJuanma Barranquero2019-10-20 12:12:27 +0200
committerJuanma Barranquero2019-10-20 12:12:27 +0200
commit41ba8231ef072571e1a6feabc15d113e5cf57556 (patch)
treeebfb9888ed6f62295fac4a0c7858f6881ffda491
parente2acf4d29d6f03c7b8c6fbeb61ed1f4a6ef5b1fd (diff)
downloademacs-41ba8231ef072571e1a6feabc15d113e5cf57556.tar.gz
emacs-41ba8231ef072571e1a6feabc15d113e5cf57556.zip
lisp/*.el: Fix typos and improve some docstrings
* lisp/auth-source.el (auth-source-backend-parse-parameters) (auth-source-search-collection) (auth-source-secrets-listify-pattern) (auth-source--decode-octal-string, auth-source-plstore-search): * lisp/registry.el (registry-lookup) (registry-lookup-breaks-before-lexbind) (registry-lookup-secondary, registry-lookup-secondary-value) (registry-search, registry-delete, registry-size, registry-full) (registry-insert, registry-reindex, registry-prune) (registry-collect-prune-candidates): * lisp/subr.el (nbutlast, process-live-p): * lisp/tab-bar.el (tab-bar-list): * lisp/cedet/ede/linux.el (ede-linux--get-archs) (ede-linux--include-path, ede-linux-load): * lisp/erc/erc-log.el (erc-log-all-but-server-buffers): * lisp/erc/erc-pcomplete.el (pcomplete-erc-commands) (pcomplete-erc-ops, pcomplete-erc-not-ops, pcomplete-erc-nicks) (pcomplete-erc-all-nicks, pcomplete-erc-channels) (pcomplete-erc-command-name, pcomplete-erc-parse-arguments): * lisp/eshell/em-term.el (eshell-visual-command-p): * lisp/gnus/gnus-cache.el (gnus-cache-fully-p): * lisp/gnus/nnmail.el (nnmail-get-active) (nnmail-fancy-expiry-target): * lisp/mail/mail-utils.el (mail-string-delete): * lisp/mail/supercite.el (sc-hdr, sc-valid-index-p): * lisp/net/ange-ftp.el (ange-ftp-use-smart-gateway-p): * lisp/net/nsm.el (nsm-save-fingerprint-maybe) (nsm-network-same-subnet, nsm-should-check): * lisp/net/rcirc.el (rcirc-looking-at-input): * lisp/net/tramp-cache.el (tramp-get-hash-table): * lisp/net/tramp-compat.el (tramp-compat-process-running-p): * lisp/net/tramp-smb.el (tramp-smb-get-share) (tramp-smb-get-localname, tramp-smb-read-file-entry) (tramp-smb-get-cifs-capabilities, tramp-smb-get-stat-capability): * lisp/net/zeroconf.el (zeroconf-list-service-names) (zeroconf-list-service-types, zeroconf-list-services) (zeroconf-get-host, zeroconf-get-domain) (zeroconf-get-host-domain): * lisp/nxml/rng-xsd.el (rng-xsd-compile) (rng-xsd-make-date-time-regexp, rng-xsd-convert-date-time): * lisp/obsolete/erc-hecomplete.el (erc-hecomplete) (erc-command-list, erc-complete-at-prompt): * lisp/org/ob-scheme.el (org-babel-scheme-get-buffer-impl): * lisp/org/ob-shell.el (org-babel--variable-assignments:sh-generic) (org-babel--variable-assignments:bash_array) (org-babel--variable-assignments:bash_assoc) (org-babel--variable-assignments:bash): * lisp/org/org-clock.el (org-day-of-week): * lisp/progmodes/cperl-mode.el (cperl-char-ends-sub-keyword-p): * lisp/progmodes/gud.el (gud-find-c-expr, gud-innermost-expr) (gud-prev-expr, gud-next-expr): * lisp/textmodes/table.el (table--at-cell-p, table--probe-cell) (table--get-cell-justify-property) (table--get-cell-valign-property) (table--put-cell-justify-property) (table--put-cell-valign-property): Fix typos. * lisp/so-long.el (fboundp): Doc fix. (so-long-mode-line-info, so-long-mode) (so-long--check-header-modes): Fix typos. * lisp/emulation/viper-mous.el (viper-surrounding-word) (viper-mouse-click-get-word): Fix typos. (viper-mouse-click-search-word): Doc fix. * lisp/erc/erc-backend.el (erc-forward-word, erc-word-at-arg-p) (erc-bounds-of-word-at-point): Fix typos. (erc-decode-string-from-target, define-erc-response-handler): Refill docstring. * lisp/erc/erc-dcc.el (pcomplete/erc-mode/DCC): Fix typo. (erc-dcc-get-host, erc-dcc-auto-mask-p, erc-dcc-get-file): Doc fixes. * lisp/erc/erc-networks.el (erc-network-name): Fix typo. (erc-determine-network): Refill docstring. * lisp/net/dbus.el (dbus-list-hash-table) (dbus-string-to-byte-array, dbus-byte-array-to-string) (dbus-check-event): Fix typos. (dbus-introspect-get-property): Doc fix. * lisp/net/tramp-adb.el (tramp-adb-file-name-handler): Rename ARGS to ARGUMENTS. Doc fix. (tramp-adb-sh-fix-ls-output, tramp-adb-execute-adb-command) (tramp-adb-find-test-command): Fix typos. * lisp/net/tramp.el (tramp-set-completion-function) (tramp-get-completion-function) (tramp-completion-dissect-file-name) (tramp-completion-dissect-file-name1) (tramp-get-completion-methods, tramp-get-completion-user-host) (tramp-get-inode, tramp-get-device, tramp-mode-string-to-int) (tramp-call-process, tramp-call-process-region) (tramp-process-lines): Fix typos. (tramp-interrupt-process): Doc fix. * lisp/org/ob-core.el (org-babel-named-src-block-regexp-for-name) (org-babel-named-data-regexp-for-name): Doc fix. (org-babel-src-block-names, org-babel-result-names): Fix typos. * lisp/progmodes/inf-lisp.el (lisp-input-filter): Doc fix. (lisp-fn-called-at-pt): Fix typo. * lisp/progmodes/xref.el (xref-backend-identifier-at-point): Doc fix. (xref-backend-identifier-completion-table): Fix typo.
-rw-r--r--ChangeLog.24
-rw-r--r--ChangeLog.312
-rw-r--r--doc/lispref/text.texi2
-rw-r--r--etc/ORG-NEWS2
-rw-r--r--lisp/ChangeLog.172
-rw-r--r--lisp/auth-source.el14
-rw-r--r--lisp/cedet/ChangeLog.12
-rw-r--r--lisp/cedet/ede/linux.el6
-rw-r--r--lisp/emacs-lisp/rx.el2
-rw-r--r--lisp/emulation/viper-mous.el9
-rw-r--r--lisp/erc/erc-backend.el21
-rw-r--r--lisp/erc/erc-dcc.el17
-rw-r--r--lisp/erc/erc-log.el2
-rw-r--r--lisp/erc/erc-networks.el8
-rw-r--r--lisp/erc/erc-pcomplete.el16
-rw-r--r--lisp/eshell/em-term.el2
-rw-r--r--lisp/gnus/gnus-cache.el2
-rw-r--r--lisp/gnus/nnmail.el4
-rw-r--r--lisp/mail/mail-utils.el2
-rw-r--r--lisp/mail/supercite.el4
-rw-r--r--lisp/net/ange-ftp.el2
-rw-r--r--lisp/net/dbus.el10
-rw-r--r--lisp/net/nsm.el6
-rw-r--r--lisp/net/rcirc.el2
-rw-r--r--lisp/net/tramp-adb.el16
-rw-r--r--lisp/net/tramp-cache.el2
-rw-r--r--lisp/net/tramp-compat.el2
-rw-r--r--lisp/net/tramp-smb.el12
-rw-r--r--lisp/net/tramp.el28
-rw-r--r--lisp/net/zeroconf.el12
-rw-r--r--lisp/nxml/rng-xsd.el6
-rw-r--r--lisp/obsolete/erc-hecomplete.el6
-rw-r--r--lisp/org/ChangeLog.16
-rw-r--r--lisp/org/ob-core.el8
-rw-r--r--lisp/org/ob-scheme.el2
-rw-r--r--lisp/org/ob-shell.el8
-rw-r--r--lisp/org/org-clock.el2
-rw-r--r--lisp/org/ox.el2
-rw-r--r--lisp/progmodes/cperl-mode.el2
-rw-r--r--lisp/progmodes/gud.el8
-rw-r--r--lisp/progmodes/inf-lisp.el4
-rw-r--r--lisp/progmodes/xref.el6
-rw-r--r--lisp/registry.el24
-rw-r--r--lisp/so-long.el8
-rw-r--r--lisp/subr.el4
-rw-r--r--lisp/tab-bar.el2
-rw-r--r--lisp/textmodes/table.el12
-rw-r--r--src/sound.c2
-rw-r--r--src/xdisp.c2
49 files changed, 172 insertions, 167 deletions
diff --git a/ChangeLog.2 b/ChangeLog.2
index d26ea14d16d..453889de295 100644
--- a/ChangeLog.2
+++ b/ChangeLog.2
@@ -4970,7 +4970,7 @@
4970 * msdos/sed1v2.inp: Adapt to Emacs 25. 4970 * msdos/sed1v2.inp: Adapt to Emacs 25.
4971 4971
4972 * src/process.c (remove_slash_colon): Move out of "#ifdef 4972 * src/process.c (remove_slash_colon): Move out of "#ifdef
4973 subprocesses" block, as it its called unconditionally. Move 4973 subprocesses" block, as it is called unconditionally. Move
4974 ADD_SUBFEATURE calls into "#ifdef subprocesses" block, as they 4974 ADD_SUBFEATURE calls into "#ifdef subprocesses" block, as they
4975 reference variables only defined in that block. 4975 reference variables only defined in that block.
4976 * src/msdos.h: Provide prototypes for IT_set_frame_parameters, 4976 * src/msdos.h: Provide prototypes for IT_set_frame_parameters,
@@ -17774,7 +17774,7 @@
17774 17774
177752015-11-08 Dmitry Gutov <dgutov@yandex.ru> 177752015-11-08 Dmitry Gutov <dgutov@yandex.ru>
17776 17776
17777 Remove dirs in vc project roots from the the vc project library roots 17777 Remove dirs in vc project roots from the vc project library roots
17778 17778
17779 * lisp/progmodes/project.el (project-library-roots): 17779 * lisp/progmodes/project.el (project-library-roots):
17780 Remove directories inside the project roots from the result. 17780 Remove directories inside the project roots from the result.
diff --git a/ChangeLog.3 b/ChangeLog.3
index 747fd5627ca..a5eec1f5736 100644
--- a/ChangeLog.3
+++ b/ChangeLog.3
@@ -1037,7 +1037,7 @@
1037 If there are directory entries in the list then they are sorted in 1037 If there are directory entries in the list then they are sorted in
1038 order of name length. The list of modes for that dir is then 1038 order of name length. The list of modes for that dir is then
1039 recursively sorted with the same mechanism. That way variables tied 1039 recursively sorted with the same mechanism. That way variables tied
1040 to a particular subdirectory override those in in a parent directory. 1040 to a particular subdirectory override those in a parent directory.
1041 1041
1042 Previously the behaviour didn’t seem to be well defined anyway and was 1042 Previously the behaviour didn’t seem to be well defined anyway and was
1043 dependent on the order they appeared in the file. However this order 1043 dependent on the order they appeared in the file. However this order
@@ -8841,7 +8841,7 @@
8841 If grow_specpdl fails due to outgrowing max_specpdl_size, it will 8841 If grow_specpdl fails due to outgrowing max_specpdl_size, it will
8842 signal an error *before* growing the specpdl array. Therefore, when 8842 signal an error *before* growing the specpdl array. Therefore, when
8843 handling the signal, specpdl_ptr points past the end of the specpdl 8843 handling the signal, specpdl_ptr points past the end of the specpdl
8844 array and any further use of of specpdl before unwinding (e.g., if 8844 array and any further use of specpdl before unwinding (e.g., if
8845 edebug binds signal-hook-function) will cause memory corruption. 8845 edebug binds signal-hook-function) will cause memory corruption.
8846 * src/eval.c (signal_or_quit): Don't call `signal-hook-function' if 8846 * src/eval.c (signal_or_quit): Don't call `signal-hook-function' if
8847 the specpdl_ptr is already past the end of the specpdl array. 8847 the specpdl_ptr is already past the end of the specpdl array.
@@ -12008,7 +12008,7 @@
12008 Improve edit-kbd-macro prompting in case of remapped keys (Bug#29399) 12008 Improve edit-kbd-macro prompting in case of remapped keys (Bug#29399)
12009 12009
12010 * lisp/edmacro.el (edit-kbd-macro): Use substitute-command-keys to 12010 * lisp/edmacro.el (edit-kbd-macro): Use substitute-command-keys to
12011 present the current bindings in the prompt. Check the the 12011 present the current bindings in the prompt. Check the
12012 non-remapped binding of the entered key sequence as well. 12012 non-remapped binding of the entered key sequence as well.
12013 12013
120142017-12-02 Lele Gaifax <lele@metapensiero.it> 120142017-12-02 Lele Gaifax <lele@metapensiero.it>
@@ -24195,7 +24195,7 @@
24195 24195
24196 Optimize UCS normalization tests 24196 Optimize UCS normalization tests
24197 24197
24198 Brings the the time for `ucs-normalize-part1' from 200s down to 130s. 24198 Brings the time for `ucs-normalize-part1' from 200s down to 130s.
24199 * test/lisp/international/ucs-normalize-tests.el 24199 * test/lisp/international/ucs-normalize-tests.el
24200 (ucs-normalize-tests--parse-column): Use character instead of string 24200 (ucs-normalize-tests--parse-column): Use character instead of string
24201 of length 1 for terminator. Convert return value into string since 24201 of length 1 for terminator. Convert return value into string since
@@ -63687,7 +63687,7 @@
63687 63687
636882016-01-29 Lars Ingebrigtsen <larsi@gnus.org> 636882016-01-29 Lars Ingebrigtsen <larsi@gnus.org>
63689 63689
63690 Compilation for for systems with getaddrinfo_a 63690 Compilation for systems with getaddrinfo_a
63691 63691
63692 * src/process.c (Fmake_network_process): Make stuff work again on 63692 * src/process.c (Fmake_network_process): Make stuff work again on
63693 systems with getaddrinfo_a. 63693 systems with getaddrinfo_a.
@@ -63701,7 +63701,7 @@
63701 63701
637022016-01-29 Lars Ingebrigtsen <larsi@gnus.org> 637022016-01-29 Lars Ingebrigtsen <larsi@gnus.org>
63703 63703
63704 Compilation for for non-GNU systems 63704 Compilation for non-GNU systems
63705 63705
63706 * src/process.c (Fmake_network_process): Make compilation work 63706 * src/process.c (Fmake_network_process): Make compilation work
63707 again on hosts that don't have getaddrinfo_a. 63707 again on hosts that don't have getaddrinfo_a.
diff --git a/doc/lispref/text.texi b/doc/lispref/text.texi
index 4c644f1a62e..1938c4c50ba 100644
--- a/doc/lispref/text.texi
+++ b/doc/lispref/text.texi
@@ -4632,7 +4632,7 @@ decoded text.
4632The decoding functions ignore newline characters in the encoded text. 4632The decoding functions ignore newline characters in the encoded text.
4633 4633
4634 4634
4635If optional argument @var{base64url} is is non-@code{nil}, then padding 4635If optional argument @var{base64url} is non-@code{nil}, then padding
4636is optional, and the URL variant of base 64 encoding is used. 4636is optional, and the URL variant of base 64 encoding is used.
4637@end defun 4637@end defun
4638 4638
diff --git a/etc/ORG-NEWS b/etc/ORG-NEWS
index 249750171b5..7acd96bd502 100644
--- a/etc/ORG-NEWS
+++ b/etc/ORG-NEWS
@@ -3754,7 +3754,7 @@ that Calc formulas can operate on them.
3754**** org-ctags.el (Paul Sexton) 3754**** org-ctags.el (Paul Sexton)
3755 3755
3756 Targets like =<<my target>>= can now be found by Emacs' etag 3756 Targets like =<<my target>>= can now be found by Emacs' etag
3757 functionality, and Org-mode links can be used to to link to 3757 functionality, and Org-mode links can be used to link to
3758 etags, also in non-Org-mode files. For details, see the file 3758 etags, also in non-Org-mode files. For details, see the file
3759 /org-ctags.el/. 3759 /org-ctags.el/.
3760 3760
diff --git a/lisp/ChangeLog.17 b/lisp/ChangeLog.17
index ed3b4a9dd8e..4ce684b831b 100644
--- a/lisp/ChangeLog.17
+++ b/lisp/ChangeLog.17
@@ -4647,7 +4647,7 @@
4647 * vc.el: All backends: API simplification: Remove 4th 4647 * vc.el: All backends: API simplification: Remove 4th
4648 'default-state' argument from vc-dir-status files and its backend 4648 'default-state' argument from vc-dir-status files and its backend
4649 methods - no backend method ever set it. It was used only in the 4649 methods - no backend method ever set it. It was used only in the
4650 fallback method to to set a default of 'up-to-date, though a 4650 fallback method to set a default of 'up-to-date, though a
4651 convoluted call chain obscured this. 4651 convoluted call chain obscured this.
4652 4652
4653 * vc-hooks.el: Bind vc-delete-file to Ctrl-x v delete. 4653 * vc-hooks.el: Bind vc-delete-file to Ctrl-x v delete.
diff --git a/lisp/auth-source.el b/lisp/auth-source.el
index fdd869df3a6..4926f67f0a1 100644
--- a/lisp/auth-source.el
+++ b/lisp/auth-source.el
@@ -504,7 +504,7 @@ soon as a function returns non-nil.")
504(add-hook 'auth-source-backend-parser-functions #'auth-source-backends-parser-secrets) 504(add-hook 'auth-source-backend-parser-functions #'auth-source-backends-parser-secrets)
505 505
506(defun auth-source-backend-parse-parameters (entry backend) 506(defun auth-source-backend-parse-parameters (entry backend)
507 "Fills in the extra auth-source-backend parameters of ENTRY. 507 "Fill in the extra auth-source-backend parameters of ENTRY.
508Using the plist ENTRY, get the :host, :port, and :user search 508Using the plist ENTRY, get the :host, :port, and :user search
509parameters." 509parameters."
510 (let ((entry (if (stringp entry) 510 (let ((entry (if (stringp entry)
@@ -773,7 +773,7 @@ Returns the deleted entries."
773 (apply #'auth-source-search (plist-put spec :delete t))) 773 (apply #'auth-source-search (plist-put spec :delete t)))
774 774
775(defun auth-source-search-collection (collection value) 775(defun auth-source-search-collection (collection value)
776 "Returns t is VALUE is t or COLLECTION is t or COLLECTION contains VALUE." 776 "Return t if VALUE is t or COLLECTION is t or COLLECTION contains VALUE."
777 (when (and (atom collection) (not (eq t collection))) 777 (when (and (atom collection) (not (eq t collection)))
778 (setq collection (list collection))) 778 (setq collection (list collection)))
779 779
@@ -1514,15 +1514,15 @@ Respects `auth-source-save-behavior'. Uses
1514;;; Backend specific parsing: Secrets API backend 1514;;; Backend specific parsing: Secrets API backend
1515 1515
1516(defun auth-source-secrets-listify-pattern (pattern) 1516(defun auth-source-secrets-listify-pattern (pattern)
1517 "Convert a pattern with lists to a list of string patterns. 1517 "Convert a PATTERN with lists to a list of string patterns.
1518 1518
1519auth-source patterns can have values of the form :foo (\"bar\" 1519auth-source patterns can have values of the form :foo (\"bar\"
1520\"qux\"), which means to match any secret with :foo equal to 1520\"qux\"), which means to match any secret with :foo equal to
1521\"bar\" or :foo equal to \"qux\". The secrets backend supports 1521\"bar\" or :foo equal to \"qux\". The secrets backend supports
1522only string values for patterns, so this routine returns a list 1522only string values for patterns, so this routine returns a list
1523of patterns that is equivalent to the single original pattern 1523of patterns that is equivalent to the single original PATTERN
1524when interpreted such that if a secret matches any pattern in the 1524when interpreted such that if a secret matches any pattern in the
1525list, it matches the original pattern." 1525list, it matches the original PATTERN."
1526 (if (null pattern) 1526 (if (null pattern)
1527 '(nil) 1527 '(nil)
1528 (let* ((key (pop pattern)) 1528 (let* ((key (pop pattern))
@@ -1935,7 +1935,7 @@ entries for git.gnus.org:
1935 1935
1936 1936
1937(defun auth-source--decode-octal-string (string) 1937(defun auth-source--decode-octal-string (string)
1938 "Convert octal string to utf-8 string. E.g: 'a\134b' to 'a\b'" 1938 "Convert octal string to utf-8 string. E.g: 'a\134b' to 'a\b'"
1939 (let ((list (string-to-list string)) 1939 (let ((list (string-to-list string))
1940 (size (length string))) 1940 (size (length string)))
1941 (decode-coding-string 1941 (decode-coding-string
@@ -2034,7 +2034,7 @@ entries for git.gnus.org:
2034(cl-defun auth-source-plstore-search (&rest spec 2034(cl-defun auth-source-plstore-search (&rest spec
2035 &key backend create delete max 2035 &key backend create delete max
2036 &allow-other-keys) 2036 &allow-other-keys)
2037 "Search the PLSTORE; spec is like `auth-source'." 2037 "Search the PLSTORE; SPEC is like `auth-source'."
2038 (let* ((store (oref backend data)) 2038 (let* ((store (oref backend data))
2039 (max (or max 5000)) ; sanity check: default to stop at 5K 2039 (max (or max 5000)) ; sanity check: default to stop at 5K
2040 (ignored-keys '(:create :delete :max :backend :label :require :type)) 2040 (ignored-keys '(:create :delete :max :backend :label :require :type))
diff --git a/lisp/cedet/ChangeLog.1 b/lisp/cedet/ChangeLog.1
index 8333dd30f3c..1d34219daa0 100644
--- a/lisp/cedet/ChangeLog.1
+++ b/lisp/cedet/ChangeLog.1
@@ -1324,7 +1324,7 @@
1324 (semantic-analyze-tag-references-default): When doing a lookup, 1324 (semantic-analyze-tag-references-default): When doing a lookup,
1325 specify noerror. 1325 specify noerror.
1326 (semantic--analyze-refs-full-lookup): Add optional noerror input 1326 (semantic--analyze-refs-full-lookup): Add optional noerror input
1327 argument. Pass to to full-lookup-simple. 1327 argument. Pass to full-lookup-simple.
1328 (semantic-analyze-refs-impl, semantic-analyze-refs-proto): 1328 (semantic-analyze-refs-impl, semantic-analyze-refs-proto):
1329 Ignore :typemodifiers during compare. 1329 Ignore :typemodifiers during compare.
1330 1330
diff --git a/lisp/cedet/ede/linux.el b/lisp/cedet/ede/linux.el
index b5a6482bbdf..90e14ce87ce 100644
--- a/lisp/cedet/ede/linux.el
+++ b/lisp/cedet/ede/linux.el
@@ -118,7 +118,7 @@ If DIR has not been used as a build directory, fall back to
118 118
119 119
120(defun ede-linux--get-archs (dir) 120(defun ede-linux--get-archs (dir)
121 "Returns a list of architecture names found in DIR." 121 "Return a list of architecture names found in DIR."
122 (let ((archs-dir (expand-file-name "arch" dir)) 122 (let ((archs-dir (expand-file-name "arch" dir))
123 archs) 123 archs)
124 (when (file-directory-p archs-dir) 124 (when (file-directory-p archs-dir)
@@ -169,7 +169,7 @@ found in DIR."
169 169
170 170
171(defun ede-linux--include-path (dir bdir arch) 171(defun ede-linux--include-path (dir bdir arch)
172 "Returns a list with include directories. 172 "Return a list with include directories.
173Returned directories might not exist, since they are not created 173Returned directories might not exist, since they are not created
174until Linux is built for the first time." 174until Linux is built for the first time."
175 (cl-map 'list 175 (cl-map 'list
@@ -186,7 +186,7 @@ until Linux is built for the first time."
186 186
187;;;###autoload 187;;;###autoload
188(defun ede-linux-load (dir &optional _rootproj) 188(defun ede-linux-load (dir &optional _rootproj)
189 "Return an Linux Project object if there is a match. 189 "Return a Linux Project object if there is a match.
190Return nil if there isn't one. 190Return nil if there isn't one.
191Argument DIR is the directory it is created for. 191Argument DIR is the directory it is created for.
192ROOTPROJ is nil, since there is only one project." 192ROOTPROJ is nil, since there is only one project."
diff --git a/lisp/emacs-lisp/rx.el b/lisp/emacs-lisp/rx.el
index 87b3133b7f5..57d633f8f0b 100644
--- a/lisp/emacs-lisp/rx.el
+++ b/lisp/emacs-lisp/rx.el
@@ -258,7 +258,7 @@ Return (REGEXP . PRECEDENCE)."
258 ;; -> (any "@" "%" digit "A-Z" space word) 258 ;; -> (any "@" "%" digit "A-Z" space word)
259 ;; -> "[A-Z@%[:digit:][:space:][:word:]]" 259 ;; -> "[A-Z@%[:digit:][:space:][:word:]]"
260 ;; 260 ;;
261 ;; Problem: If a subpattern is carefully written to to be 261 ;; Problem: If a subpattern is carefully written to be
262 ;; optimisable by regexp-opt, how do we prevent the transforms 262 ;; optimisable by regexp-opt, how do we prevent the transforms
263 ;; above from destroying that property? 263 ;; above from destroying that property?
264 ;; Example: (or "a" (or "abc" "abd" "abe")) 264 ;; Example: (or "a" (or "abc" "abd" "abe"))
diff --git a/lisp/emulation/viper-mous.el b/lisp/emulation/viper-mous.el
index e076e988866..5451f33d477 100644
--- a/lisp/emulation/viper-mous.el
+++ b/lisp/emulation/viper-mous.el
@@ -138,7 +138,7 @@ considered related."
138(declare-function viper-forward-char-carefully "viper-cmd" (&optional arg)) 138(declare-function viper-forward-char-carefully "viper-cmd" (&optional arg))
139 139
140(defun viper-surrounding-word (count click-count) 140(defun viper-surrounding-word (count click-count)
141 "Returns word surrounding point according to a heuristic. 141 "Return word surrounding point according to a heuristic.
142COUNT indicates how many regions to return. 142COUNT indicates how many regions to return.
143If CLICK-COUNT is 1, `word' is a word in Vi sense. 143If CLICK-COUNT is 1, `word' is a word in Vi sense.
144If CLICK-COUNT is 2,then `word' is a Word in Vi sense. 144If CLICK-COUNT is 2,then `word' is a Word in Vi sense.
@@ -219,7 +219,7 @@ is ignored."
219 219
220 220
221(defun viper-mouse-click-get-word (click count click-count) 221(defun viper-mouse-click-get-word (click count click-count)
222 "Returns word surrounding the position of a mouse click. 222 "Return word surrounding the position of a mouse click.
223Click may be in another window. Current window and buffer isn't changed. 223Click may be in another window. Current window and buffer isn't changed.
224On single or double click, returns the word as determined by 224On single or double click, returns the word as determined by
225`viper-surrounding-word-function'." 225`viper-surrounding-word-function'."
@@ -334,12 +334,13 @@ See `viper-surrounding-word' for the definition of a word in this case."
334(declare-function viper-adjust-window "viper-cmd" ()) 334(declare-function viper-adjust-window "viper-cmd" ())
335 335
336(defun viper-mouse-click-search-word (click arg) 336(defun viper-mouse-click-search-word (click arg)
337 "Find the word clicked or double-clicked on. Word may be in another window. 337 "Find the word clicked or double-clicked on. Word may be in another window.
338With prefix argument, N, search for N-th occurrence. 338With prefix argument, N, search for N-th occurrence.
339This command must be bound to a mouse click. The double-click action of the 339This command must be bound to a mouse click. The double-click action of the
340same button must not be bound \(or it must be bound to the same function). 340same button must not be bound \(or it must be bound to the same function).
341See `viper-surrounding-word' for the details on what constitutes a word for 341See `viper-surrounding-word' for the details on what constitutes a word for
342this command." 342this command.
343\n(fn CLICK N)"
343 (interactive "e\nP") 344 (interactive "e\nP")
344 (if viper-frame-of-focus ;; to handle clicks in another frame 345 (if viper-frame-of-focus ;; to handle clicks in another frame
345 (select-frame viper-frame-of-focus)) 346 (select-frame viper-frame-of-focus))
diff --git a/lisp/erc/erc-backend.el b/lisp/erc/erc-backend.el
index 3250d0fdfde..72a7f86da2f 100644
--- a/lisp/erc/erc-backend.el
+++ b/lisp/erc/erc-backend.el
@@ -481,13 +481,13 @@ Currently this is called by `erc-send-input'."
481 (split-string (buffer-string) "\n")))) 481 (split-string (buffer-string) "\n"))))
482 482
483(defun erc-forward-word () 483(defun erc-forward-word ()
484 "Moves forward one word, ignoring any subword settings. If no 484 "Move forward one word, ignoring any subword settings.
485subword-mode is active, then this is (forward-word)." 485If no subword-mode is active, then this is (forward-word)."
486 (skip-syntax-forward "^w") 486 (skip-syntax-forward "^w")
487 (> (skip-syntax-forward "w") 0)) 487 (> (skip-syntax-forward "w") 0))
488 488
489(defun erc-word-at-arg-p (pos) 489(defun erc-word-at-arg-p (pos)
490 "Reports whether the char after a given POS has word syntax. 490 "Report whether the char after a given POS has word syntax.
491If POS is out of range, the value is nil." 491If POS is out of range, the value is nil."
492 (let ((c (char-after pos))) 492 (let ((c (char-after pos)))
493 (if c 493 (if c
@@ -495,9 +495,9 @@ If POS is out of range, the value is nil."
495 nil))) 495 nil)))
496 496
497(defun erc-bounds-of-word-at-point () 497(defun erc-bounds-of-word-at-point ()
498 "Returns the bounds of a word at point, or nil if we're not at 498 "Return the bounds of word at point, or nil if we're not at a word.
499a word. If no subword-mode is active, then this 499If no subword-mode is active, then this is
500is (bounds-of-thing-at-point 'word)." 500\(bounds-of-thing-at-point 'word)."
501 (if (or (erc-word-at-arg-p (point)) 501 (if (or (erc-word-at-arg-p (point))
502 (erc-word-at-arg-p (1- (point)))) 502 (erc-word-at-arg-p (1- (point))))
503 (save-excursion 503 (save-excursion
@@ -596,7 +596,7 @@ We will store server variables in the buffer given by BUFFER."
596 (erc-login)) )) 596 (erc-login)) ))
597 597
598(defun erc-server-reconnect () 598(defun erc-server-reconnect ()
599"Reestablish the current IRC connection. 599 "Reestablish the current IRC connection.
600Make sure you are in an ERC buffer when running this." 600Make sure you are in an ERC buffer when running this."
601 (let ((buffer (erc-server-buffer))) 601 (let ((buffer (erc-server-buffer)))
602 (unless (buffer-live-p buffer) 602 (unless (buffer-live-p buffer)
@@ -765,8 +765,8 @@ This is determined via `erc-encoding-coding-alist' or
765 765
766(defun erc-decode-string-from-target (str target) 766(defun erc-decode-string-from-target (str target)
767 "Decode STR as appropriate for TARGET. 767 "Decode STR as appropriate for TARGET.
768This is indicated by `erc-encoding-coding-alist', defaulting to the value of 768This is indicated by `erc-encoding-coding-alist', defaulting to the
769`erc-server-coding-system'." 769value of `erc-server-coding-system'."
770 (unless (stringp str) 770 (unless (stringp str)
771 (setq str "")) 771 (setq str ""))
772 (let ((coding (erc-coding-system-for-target target))) 772 (let ((coding (erc-coding-system-for-target target)))
@@ -1118,7 +1118,8 @@ NAME is the response name as sent by the server (see the IRC RFC for
1118meanings). 1118meanings).
1119 1119
1120This creates: 1120This creates:
1121 - a hook variable `erc-server-NAME-functions' initialized to `erc-server-NAME'. 1121 - a hook variable `erc-server-NAME-functions' initialized to
1122 `erc-server-NAME'.
1122 - a function `erc-server-NAME' with body FN-BODY. 1123 - a function `erc-server-NAME' with body FN-BODY.
1123 1124
1124If ALIASES is non-nil, each alias in ALIASES is `defalias'ed to 1125If ALIASES is non-nil, each alias in ALIASES is `defalias'ed to
diff --git a/lisp/erc/erc-dcc.el b/lisp/erc/erc-dcc.el
index f8bd5bf3083..899fa5d0fed 100644
--- a/lisp/erc/erc-dcc.el
+++ b/lisp/erc/erc-dcc.el
@@ -309,7 +309,7 @@ Should be set to a string or nil. If nil, use the value of
309 :type '(choice (const ask) (const auto) (const ignore))) 309 :type '(choice (const ask) (const auto) (const ignore)))
310 310
311(defun erc-dcc-get-host (proc) 311(defun erc-dcc-get-host (proc)
312 "Returns the local IP address used for an open PROCess." 312 "Return the local IP address used for an open process PROC."
313 (format-network-address (process-contact proc :local) t)) 313 (format-network-address (process-contact proc :local) t))
314 314
315(defun erc-dcc-host () 315(defun erc-dcc-host ()
@@ -413,7 +413,7 @@ where FOO is one of CLOSE, GET, SEND, LIST, CHAT, etc."
413 413
414;;;###autoload 414;;;###autoload
415(defun pcomplete/erc-mode/DCC () 415(defun pcomplete/erc-mode/DCC ()
416 "Provides completion for the /DCC command." 416 "Provide completion for the /DCC command."
417 (pcomplete-here (append '("chat" "close" "get" "list") 417 (pcomplete-here (append '("chat" "close" "get" "list")
418 (when (fboundp 'make-network-process) '("send")))) 418 (when (fboundp 'make-network-process) '("send"))))
419 (pcomplete-here 419 (pcomplete-here
@@ -685,9 +685,10 @@ It extracts the information about the dcc request and adds it to
685 ?n nick ?u login ?h host ?q query))))) 685 ?n nick ?u login ?h host ?q query)))))
686 686
687(defun erc-dcc-auto-mask-p (spec) 687(defun erc-dcc-auto-mask-p (spec)
688 "Takes a full SPEC of a user in the form \"nick!login@host\" and 688 "Match SPEC against `erc-dcc-auto-masks'.
689matches against all the regexp's in `erc-dcc-auto-masks'. If any 689SPEC is a full spec of a user in the form \"nick!login@host\", which
690match, returns that regexp and nil otherwise." 690is matched against all the regexps in `erc-dcc-auto-masks'. Return
691the matching regexp, or nil if none found."
691 (let ((lst erc-dcc-auto-masks)) 692 (let ((lst erc-dcc-auto-masks))
692 (while (and lst 693 (while (and lst
693 (not (string-match (car lst) spec))) 694 (not (string-match (car lst) spec)))
@@ -907,9 +908,9 @@ other client."
907(make-variable-buffer-local 'erc-dcc-file-name) 908(make-variable-buffer-local 'erc-dcc-file-name)
908 909
909(defun erc-dcc-get-file (entry file parent-proc) 910(defun erc-dcc-get-file (entry file parent-proc)
910 "This function does the work of setting up a transfer from the remote client 911 "Set up a transfer from the remote client to the local over a TCP connection.
911to the local one over a tcp connection. This involves setting up a process 912This involves setting up a process filter and a process sentinel,
912filter and a process sentinel, and making the connection." 913and making the connection."
913 (let* ((buffer (generate-new-buffer (file-name-nondirectory file))) 914 (let* ((buffer (generate-new-buffer (file-name-nondirectory file)))
914 proc) 915 proc)
915 (with-current-buffer buffer 916 (with-current-buffer buffer
diff --git a/lisp/erc/erc-log.el b/lisp/erc/erc-log.el
index d6763c01f36..b9bf40d6fab 100644
--- a/lisp/erc/erc-log.el
+++ b/lisp/erc/erc-log.el
@@ -283,7 +283,7 @@ The current buffer is given by BUFFER."
283 erc-enable-logging nil)))) 283 erc-enable-logging nil))))
284 284
285(defun erc-log-all-but-server-buffers (buffer) 285(defun erc-log-all-but-server-buffers (buffer)
286 "Returns t if logging should be enabled in BUFFER. 286 "Return t if logging should be enabled in BUFFER.
287Returns nil if `erc-server-buffer-p' returns t." 287Returns nil if `erc-server-buffer-p' returns t."
288 (save-excursion 288 (save-excursion
289 (save-window-excursion 289 (save-window-excursion
diff --git a/lisp/erc/erc-networks.el b/lisp/erc/erc-networks.el
index 352f714491f..dbd0e1da893 100644
--- a/lisp/erc/erc-networks.el
+++ b/lisp/erc/erc-networks.el
@@ -730,9 +730,9 @@ MATCHER is used to find a corresponding network to a server while
730 730
731;;;###autoload 731;;;###autoload
732(defun erc-determine-network () 732(defun erc-determine-network ()
733 "Return the name of the network or \"Unknown\" as a symbol. Use the 733 "Return the name of the network or \"Unknown\" as a symbol.
734server parameter NETWORK if provided, otherwise parse the server name and 734Use the server parameter NETWORK if provided, otherwise parse the
735search for a match in `erc-networks-alist'." 735server name and search for a match in `erc-networks-alist'."
736 ;; The server made it easy for us and told us the name of the NETWORK 736 ;; The server made it easy for us and told us the name of the NETWORK
737 (let ((network-name (cdr (assoc "NETWORK" erc-server-parameters)))) 737 (let ((network-name (cdr (assoc "NETWORK" erc-server-parameters))))
738 (if network-name 738 (if network-name
@@ -760,7 +760,7 @@ Return the name of this server's network as a symbol."
760 "Obsolete since erc-networks 1.5") 760 "Obsolete since erc-networks 1.5")
761 761
762(defun erc-network-name () 762(defun erc-network-name ()
763 "Returns the name of the current network as a string." 763 "Return the name of the current network as a string."
764 (erc-with-server-buffer (symbol-name erc-network))) 764 (erc-with-server-buffer (symbol-name erc-network)))
765 765
766(defun erc-set-network-name (proc parsed) 766(defun erc-set-network-name (proc parsed)
diff --git a/lisp/erc/erc-pcomplete.el b/lisp/erc/erc-pcomplete.el
index 55405498f1e..fe01e1d76e6 100644
--- a/lisp/erc/erc-pcomplete.el
+++ b/lisp/erc/erc-pcomplete.el
@@ -188,14 +188,14 @@ for use on `completion-at-point-function'."
188;;; Functions that provide possible completions. 188;;; Functions that provide possible completions.
189 189
190(defun pcomplete-erc-commands () 190(defun pcomplete-erc-commands ()
191 "Returns a list of strings of the defined user commands." 191 "Return a list of strings of the defined user commands."
192 (let ((case-fold-search nil)) 192 (let ((case-fold-search nil))
193 (mapcar (lambda (x) 193 (mapcar (lambda (x)
194 (concat "/" (downcase (substring (symbol-name x) 8)))) 194 (concat "/" (downcase (substring (symbol-name x) 8))))
195 (apropos-internal "erc-cmd-[A-Z]+")))) 195 (apropos-internal "erc-cmd-[A-Z]+"))))
196 196
197(defun pcomplete-erc-ops () 197(defun pcomplete-erc-ops ()
198 "Returns a list of nicks with ops." 198 "Return a list of nicks with ops."
199 (let (ops) 199 (let (ops)
200 (maphash (lambda (nick cdata) 200 (maphash (lambda (nick cdata)
201 (if (and (cdr cdata) 201 (if (and (cdr cdata)
@@ -205,7 +205,7 @@ for use on `completion-at-point-function'."
205 ops)) 205 ops))
206 206
207(defun pcomplete-erc-not-ops () 207(defun pcomplete-erc-not-ops ()
208 "Returns a list of nicks without ops." 208 "Return a list of nicks without ops."
209 (let (not-ops) 209 (let (not-ops)
210 (maphash (lambda (nick cdata) 210 (maphash (lambda (nick cdata)
211 (if (and (cdr cdata) 211 (if (and (cdr cdata)
@@ -216,7 +216,7 @@ for use on `completion-at-point-function'."
216 216
217 217
218(defun pcomplete-erc-nicks (&optional postfix ignore-self) 218(defun pcomplete-erc-nicks (&optional postfix ignore-self)
219 "Returns a list of nicks in the current channel. 219 "Return a list of nicks in the current channel.
220Optional argument POSTFIX is something to append to the nickname. 220Optional argument POSTFIX is something to append to the nickname.
221If optional argument IGNORE-SELF is non-nil, don't return the current nick." 221If optional argument IGNORE-SELF is non-nil, don't return the current nick."
222 (let ((users (if erc-pcomplete-order-nickname-completions 222 (let ((users (if erc-pcomplete-order-nickname-completions
@@ -235,7 +235,7 @@ If optional argument IGNORE-SELF is non-nil, don't return the current nick."
235 (nreverse nicks))) 235 (nreverse nicks)))
236 236
237(defun pcomplete-erc-all-nicks (&optional postfix) 237(defun pcomplete-erc-all-nicks (&optional postfix)
238 "Returns a list of all nicks on the current server." 238 "Return a list of all nicks on the current server."
239 (let (nicks) 239 (let (nicks)
240 (erc-with-server-buffer 240 (erc-with-server-buffer
241 (maphash (lambda (_nick user) 241 (maphash (lambda (_nick user)
@@ -246,20 +246,20 @@ If optional argument IGNORE-SELF is non-nil, don't return the current nick."
246 nicks)) 246 nicks))
247 247
248(defun pcomplete-erc-channels () 248(defun pcomplete-erc-channels ()
249 "Returns a list of channels associated with the current server." 249 "Return a list of channels associated with the current server."
250 (mapcar (lambda (buf) (with-current-buffer buf (erc-default-target))) 250 (mapcar (lambda (buf) (with-current-buffer buf (erc-default-target)))
251 (erc-channel-list erc-server-process))) 251 (erc-channel-list erc-server-process)))
252 252
253;;; Functions for parsing 253;;; Functions for parsing
254 254
255(defun pcomplete-erc-command-name () 255(defun pcomplete-erc-command-name ()
256 "Returns the command name of the first argument." 256 "Return the command name of the first argument."
257 (if (eq (elt (pcomplete-arg 'first) 0) ?/) 257 (if (eq (elt (pcomplete-arg 'first) 0) ?/)
258 (upcase (substring (pcomplete-arg 'first) 1)) 258 (upcase (substring (pcomplete-arg 'first) 1))
259 "SAY")) 259 "SAY"))
260 260
261(defun pcomplete-erc-parse-arguments () 261(defun pcomplete-erc-parse-arguments ()
262 "Returns a list of parsed whitespace-separated arguments. 262 "Return a list of parsed whitespace-separated arguments.
263These are the words from the beginning of the line after the prompt 263These are the words from the beginning of the line after the prompt
264up to where point is right now." 264up to where point is right now."
265 (let* ((start erc-input-marker) 265 (let* ((start erc-input-marker)
diff --git a/lisp/eshell/em-term.el b/lisp/eshell/em-term.el
index 36a26e9346b..06d59cfc5b5 100644
--- a/lisp/eshell/em-term.el
+++ b/lisp/eshell/em-term.el
@@ -150,7 +150,7 @@ behavior for short-lived processes, see bug#18108."
150 eshell-interpreter-alist))) 150 eshell-interpreter-alist)))
151 151
152(defun eshell-visual-command-p (command args) 152(defun eshell-visual-command-p (command args)
153 "Returns non-nil when given a visual command. 153 "Return non-nil when given a visual command.
154If either COMMAND or a subcommand in ARGS (e.g. git log) is a 154If either COMMAND or a subcommand in ARGS (e.g. git log) is a
155visual command, returns non-nil." 155visual command, returns non-nil."
156 (let ((command (file-name-nondirectory command))) 156 (let ((command (file-name-nondirectory command)))
diff --git a/lisp/gnus/gnus-cache.el b/lisp/gnus/gnus-cache.el
index f43c4344dc2..db73bf234a0 100644
--- a/lisp/gnus/gnus-cache.el
+++ b/lisp/gnus/gnus-cache.el
@@ -732,7 +732,7 @@ If LOW, update the lower bound instead."
732 (rename-file gnus-cache-directory dir)) 732 (rename-file gnus-cache-directory dir))
733 733
734(defun gnus-cache-fully-p (&optional group) 734(defun gnus-cache-fully-p (&optional group)
735 "Returns non-nil if the cache should be fully used. 735 "Return non-nil if the cache should be fully used.
736If GROUP is non-nil, also cater to `gnus-cacheable-groups' and 736If GROUP is non-nil, also cater to `gnus-cacheable-groups' and
737`gnus-uncacheable-groups'." 737`gnus-uncacheable-groups'."
738 (and gnus-use-cache 738 (and gnus-use-cache
diff --git a/lisp/gnus/nnmail.el b/lisp/gnus/nnmail.el
index 33912f8cfa2..fc9713e9561 100644
--- a/lisp/gnus/nnmail.el
+++ b/lisp/gnus/nnmail.el
@@ -646,7 +646,7 @@ These will be logged to the \"*nnmail split*\" buffer."
646 (or file ""))) 646 (or file "")))
647 647
648(defun nnmail-get-active () 648(defun nnmail-get-active ()
649 "Returns an assoc of group names and active ranges. 649 "Return an assoc of group names and active ranges.
650nn*-request-list should have been called before calling this function." 650nn*-request-list should have been called before calling this function."
651 ;; Go through all groups from the active list. 651 ;; Go through all groups from the active list.
652 (with-current-buffer nntp-server-buffer 652 (with-current-buffer nntp-server-buffer
@@ -1909,7 +1909,7 @@ If TIME is nil, then return the cutoff time for oldness instead."
1909 (gnus-group-mark-article-read target (cdr group-art)))))))) 1909 (gnus-group-mark-article-read target (cdr group-art))))))))
1910 1910
1911(defun nnmail-fancy-expiry-target (group) 1911(defun nnmail-fancy-expiry-target (group)
1912 "Returns a target expiry group determined by `nnmail-fancy-expiry-targets'." 1912 "Return a target expiry group determined by `nnmail-fancy-expiry-targets'."
1913 (let* (header 1913 (let* (header
1914 (case-fold-search nil) 1914 (case-fold-search nil)
1915 (from (or (message-fetch-field "from") "")) 1915 (from (or (message-fetch-field "from") ""))
diff --git a/lisp/mail/mail-utils.el b/lisp/mail/mail-utils.el
index fd00dd19bc2..24015858b02 100644
--- a/lisp/mail/mail-utils.el
+++ b/lisp/mail/mail-utils.el
@@ -56,7 +56,7 @@ also the To field, unless this would leave an empty To field."
56 (looking-at "BABYL OPTIONS:")))) 56 (looking-at "BABYL OPTIONS:"))))
57 57
58(defun mail-string-delete (string start end) 58(defun mail-string-delete (string start end)
59 "Returns a string containing all of STRING except the part 59 "Return a string containing all of STRING except the part
60from START (inclusive) to END (exclusive)." 60from START (inclusive) to END (exclusive)."
61 (if (null end) (substring string 0 start) 61 (if (null end) (substring string 0 start)
62 (concat (substring string 0 start) 62 (concat (substring string 0 start)
diff --git a/lisp/mail/supercite.el b/lisp/mail/supercite.el
index 556e4b3923f..f292920d30e 100644
--- a/lisp/mail/supercite.el
+++ b/lisp/mail/supercite.el
@@ -1461,7 +1461,7 @@ First runs `sc-pre-recite-hook'."
1461;; building headers 1461;; building headers
1462 1462
1463(defun sc-hdr (prefix field &optional sep return-nil-p) 1463(defun sc-hdr (prefix field &optional sep return-nil-p)
1464 "Returns a concatenation of PREFIX and FIELD. 1464 "Return a concatenation of PREFIX and FIELD.
1465If FIELD is not a string or is the empty string, the empty string will 1465If FIELD is not a string or is the empty string, the empty string will
1466be returned. Optional third argument SEP is concatenated on the end if 1466be returned. Optional third argument SEP is concatenated on the end if
1467it is a string. Returns empty string, unless optional RETURN-NIL-P is 1467it is a string. Returns empty string, unless optional RETURN-NIL-P is
@@ -1589,7 +1589,7 @@ Treats these fields in a similar manner to `sc-header-on-said'."
1589 "Current electric reference style.") 1589 "Current electric reference style.")
1590 1590
1591(defun sc-valid-index-p (index) 1591(defun sc-valid-index-p (index)
1592 "Returns INDEX if it is a valid index into `sc-rewrite-header-list'. 1592 "Return INDEX if it is a valid index into `sc-rewrite-header-list'.
1593Otherwise returns nil." 1593Otherwise returns nil."
1594 ;; a number, and greater than or equal to zero 1594 ;; a number, and greater than or equal to zero
1595 ;; less than or equal to the last index 1595 ;; less than or equal to the last index
diff --git a/lisp/net/ange-ftp.el b/lisp/net/ange-ftp.el
index b0a1e1799f5..a5fc9631e8a 100644
--- a/lisp/net/ange-ftp.el
+++ b/lisp/net/ange-ftp.el
@@ -1708,7 +1708,7 @@ good, skip, fatal, or unknown."
1708 (not (string-match-p ange-ftp-local-host-regexp host)))) 1708 (not (string-match-p ange-ftp-local-host-regexp host))))
1709 1709
1710(defun ange-ftp-use-smart-gateway-p (host) 1710(defun ange-ftp-use-smart-gateway-p (host)
1711 "Returns whether to access this HOST via a smart gateway." 1711 "Return whether to access this HOST via a smart gateway."
1712 (and ange-ftp-smart-gateway 1712 (and ange-ftp-smart-gateway
1713 (not (string-match-p ange-ftp-local-host-regexp host)))) 1713 (not (string-match-p ange-ftp-local-host-regexp host))))
1714 1714
diff --git a/lisp/net/dbus.el b/lisp/net/dbus.el
index c3297ac9da6..f3f6fecb956 100644
--- a/lisp/net/dbus.el
+++ b/lisp/net/dbus.el
@@ -493,7 +493,7 @@ This is an internal function, it shall not be used outside dbus.el."
493;;; Hash table of registered functions. 493;;; Hash table of registered functions.
494 494
495(defun dbus-list-hash-table () 495(defun dbus-list-hash-table ()
496 "Returns all registered member registrations to D-Bus. 496 "Return all registered member registrations to D-Bus.
497The return value is a list, with elements of kind (KEY . VALUE). 497The return value is a list, with elements of kind (KEY . VALUE).
498See `dbus-registered-objects-table' for a description of the 498See `dbus-registered-objects-table' for a description of the
499hash table." 499hash table."
@@ -888,7 +888,7 @@ association to the service from D-Bus."
888;;; D-Bus type conversion. 888;;; D-Bus type conversion.
889 889
890(defun dbus-string-to-byte-array (string) 890(defun dbus-string-to-byte-array (string)
891 "Transforms STRING to list (:array :byte c1 :byte c2 ...). 891 "Transform STRING to list (:array :byte c1 :byte c2 ...).
892STRING shall be UTF8 coded." 892STRING shall be UTF8 coded."
893 (if (zerop (length string)) 893 (if (zerop (length string))
894 '(:array :signature "y") 894 '(:array :signature "y")
@@ -897,7 +897,7 @@ STRING shall be UTF8 coded."
897 (setq result (append result (list :byte elt))))))) 897 (setq result (append result (list :byte elt)))))))
898 898
899(defun dbus-byte-array-to-string (byte-array &optional multibyte) 899(defun dbus-byte-array-to-string (byte-array &optional multibyte)
900 "Transforms BYTE-ARRAY into UTF8 coded string. 900 "Transform BYTE-ARRAY into UTF8 coded string.
901BYTE-ARRAY must be a list of structure (c1 c2 ...), or a byte 901BYTE-ARRAY must be a list of structure (c1 c2 ...), or a byte
902array as produced by `dbus-string-to-byte-array'. The resulting 902array as produced by `dbus-string-to-byte-array'. The resulting
903string is unibyte encoded, unless MULTIBYTE is non-nil." 903string is unibyte encoded, unless MULTIBYTE is non-nil."
@@ -947,7 +947,7 @@ STRING must have been encoded with `dbus-escape-as-identifier'."
947;;; D-Bus events. 947;;; D-Bus events.
948 948
949(defun dbus-check-event (event) 949(defun dbus-check-event (event)
950 "Checks whether EVENT is a well formed D-Bus event. 950 "Check whether EVENT is a well formed D-Bus event.
951EVENT is a list which starts with symbol `dbus-event': 951EVENT is a list which starts with symbol `dbus-event':
952 952
953 (dbus-event BUS TYPE SERIAL SERVICE PATH INTERFACE MEMBER HANDLER &rest ARGS) 953 (dbus-event BUS TYPE SERIAL SERVICE PATH INTERFACE MEMBER HANDLER &rest ARGS)
@@ -1319,7 +1319,7 @@ SERVICE is a service of D-Bus BUS at object path PATH."
1319 (push (dbus-introspect-get-attribute elt "name") result)))) 1319 (push (dbus-introspect-get-attribute elt "name") result))))
1320 1320
1321(defun dbus-introspect-get-property (bus service path interface property) 1321(defun dbus-introspect-get-property (bus service path interface property)
1322 "This function returns PROPERTY of INTERFACE as XML object. 1322 "Return PROPERTY of INTERFACE as XML object.
1323It must be located at SERVICE in D-Bus BUS at object path PATH. 1323It must be located at SERVICE in D-Bus BUS at object path PATH.
1324PROPERTY must be a string, element of the list returned by 1324PROPERTY must be a string, element of the list returned by
1325`dbus-introspect-get-property-names'. The resulting PROPERTY 1325`dbus-introspect-get-property-names'. The resulting PROPERTY
diff --git a/lisp/net/nsm.el b/lisp/net/nsm.el
index 4ca770fd7e1..c47ef55a6f4 100644
--- a/lisp/net/nsm.el
+++ b/lisp/net/nsm.el
@@ -179,7 +179,7 @@ See also: `nsm-check-tls-connection', `nsm-save-host-names',
179 (const :tag "High" high))))) 179 (const :tag "High" high)))))
180 180
181(defun nsm-save-fingerprint-maybe (host port status &rest _) 181(defun nsm-save-fingerprint-maybe (host port status &rest _)
182 "Saves the certificate's fingerprint. 182 "Save the certificate's fingerprint.
183 183
184In order to detect man-in-the-middle attacks, when 184In order to detect man-in-the-middle attacks, when
185`network-security-level' is `high', this function will save the 185`network-security-level' is `high', this function will save the
@@ -199,7 +199,7 @@ RESULTS is an alist where the keys are the checks run and the
199values the results of the checks.") 199values the results of the checks.")
200 200
201(defun nsm-network-same-subnet (local-ip mask ip) 201(defun nsm-network-same-subnet (local-ip mask ip)
202 "Returns t if IP is in the same subnet as LOCAL-IP/MASK. 202 "Return t if IP is in the same subnet as LOCAL-IP/MASK.
203LOCAL-IP, MASK, and IP are specified as vectors of integers, and 203LOCAL-IP, MASK, and IP are specified as vectors of integers, and
204are expected to have the same length. Works for both IPv4 and 204are expected to have the same length. Works for both IPv4 and
205IPv6 addresses." 205IPv6 addresses."
@@ -217,7 +217,7 @@ IPv6 addresses."
217 matches)) 217 matches))
218 218
219(defun nsm-should-check (host) 219(defun nsm-should-check (host)
220 "Determines whether NSM should check for TLS problems for HOST. 220 "Determine whether NSM should check for TLS problems for HOST.
221 221
222If `nsm-trust-local-network' is or returns non-nil, and if the 222If `nsm-trust-local-network' is or returns non-nil, and if the
223host address is a localhost address, or in the same subnet as one 223host address is a localhost address, or in the same subnet as one
diff --git a/lisp/net/rcirc.el b/lisp/net/rcirc.el
index 5722582ab6c..4a94afe0917 100644
--- a/lisp/net/rcirc.el
+++ b/lisp/net/rcirc.el
@@ -3063,7 +3063,7 @@ Passwords are stored in `rcirc-authinfo' (which see)."
3063;; When using M-x flyspell-mode, only check words after the prompt 3063;; When using M-x flyspell-mode, only check words after the prompt
3064(put 'rcirc-mode 'flyspell-mode-predicate 'rcirc-looking-at-input) 3064(put 'rcirc-mode 'flyspell-mode-predicate 'rcirc-looking-at-input)
3065(defun rcirc-looking-at-input () 3065(defun rcirc-looking-at-input ()
3066 "Returns true if point is past the input marker." 3066 "Return true if point is past the input marker."
3067 (>= (point) rcirc-prompt-end-marker)) 3067 (>= (point) rcirc-prompt-end-marker))
3068 3068
3069 3069
diff --git a/lisp/net/tramp-adb.el b/lisp/net/tramp-adb.el
index 982522bdaf4..e1706bebe6e 100644
--- a/lisp/net/tramp-adb.el
+++ b/lisp/net/tramp-adb.el
@@ -177,14 +177,14 @@ It is used for TCP/IP devices."
177 tramp-adb-method))) 177 tramp-adb-method)))
178 178
179;;;###tramp-autoload 179;;;###tramp-autoload
180(defun tramp-adb-file-name-handler (operation &rest args) 180(defun tramp-adb-file-name-handler (operation &rest arguments)
181 "Invoke the ADB handler for OPERATION. 181 "Invoke the ADB handler for OPERATION.
182First arg specifies the OPERATION, second arg is a list of arguments to 182First arg specifies the OPERATION, second arg is a list of
183pass to the OPERATION." 183ARGUMENTS to pass to the OPERATION."
184 (let ((fn (assoc operation tramp-adb-file-name-handler-alist))) 184 (let ((fn (assoc operation tramp-adb-file-name-handler-alist)))
185 (if fn 185 (if fn
186 (save-match-data (apply (cdr fn) args)) 186 (save-match-data (apply (cdr fn) arguments))
187 (tramp-run-real-handler operation args)))) 187 (tramp-run-real-handler operation arguments))))
188 188
189;;;###tramp-autoload 189;;;###tramp-autoload
190(tramp--with-startup 190(tramp--with-startup
@@ -462,7 +462,7 @@ Convert (\"-al\") to (\"-a\" \"-l\"). Remove arguments like \"--dired\"."
462 462
463(defun tramp-adb-sh-fix-ls-output (&optional sort-by-time) 463(defun tramp-adb-sh-fix-ls-output (&optional sort-by-time)
464 "Insert dummy 0 in empty size columns. 464 "Insert dummy 0 in empty size columns.
465Androids \"ls\" command doesn't insert size column for directories: 465Android's \"ls\" command doesn't insert size column for directories:
466Emacs dired can't find files." 466Emacs dired can't find files."
467 (save-excursion 467 (save-excursion
468 ;; Insert missing size. 468 ;; Insert missing size.
@@ -1089,7 +1089,7 @@ E.g. a host name \"192.168.1.1#5555\" returns \"192.168.1.1:5555\"
1089 vec 'file-error "Could not find device %s" host))))))) 1089 vec 'file-error "Could not find device %s" host)))))))
1090 1090
1091(defun tramp-adb-execute-adb-command (vec &rest args) 1091(defun tramp-adb-execute-adb-command (vec &rest args)
1092 "Returns nil on success error-output on failure." 1092 "Return nil on success error-output on failure."
1093 (when (and (> (length (tramp-file-name-host vec)) 0) 1093 (when (and (> (length (tramp-file-name-host vec)) 0)
1094 ;; The -s switch is only available for ADB device commands. 1094 ;; The -s switch is only available for ADB device commands.
1095 (not (member (car args) '("connect" "disconnect")))) 1095 (not (member (car args) '("connect" "disconnect"))))
@@ -1103,7 +1103,7 @@ E.g. a host name \"192.168.1.1#5555\" returns \"192.168.1.1:5555\"
1103 (tramp-message vec 6 "%s" (buffer-string))))) 1103 (tramp-message vec 6 "%s" (buffer-string)))))
1104 1104
1105(defun tramp-adb-find-test-command (vec) 1105(defun tramp-adb-find-test-command (vec)
1106 "Checks, whether the ash has a builtin \"test\" command. 1106 "Check whether the ash has a builtin \"test\" command.
1107This happens for Android >= 4.0." 1107This happens for Android >= 4.0."
1108 (with-tramp-connection-property vec "test" 1108 (with-tramp-connection-property vec "test"
1109 (tramp-adb-send-command-and-check vec "type test"))) 1109 (tramp-adb-send-command-and-check vec "type test")))
diff --git a/lisp/net/tramp-cache.el b/lisp/net/tramp-cache.el
index 1380d0368c7..0f7e14b704a 100644
--- a/lisp/net/tramp-cache.el
+++ b/lisp/net/tramp-cache.el
@@ -97,7 +97,7 @@ details see the info pages."
97 "Whether persistent cache data have been changed.") 97 "Whether persistent cache data have been changed.")
98 98
99(defun tramp-get-hash-table (key) 99(defun tramp-get-hash-table (key)
100 "Returns the hash table for KEY. 100 "Return the hash table for KEY.
101If it doesn't exist yet, it is created and initialized with 101If it doesn't exist yet, it is created and initialized with
102matching entries of `tramp-connection-properties'." 102matching entries of `tramp-connection-properties'."
103 (or (gethash key tramp-cache-data) 103 (or (gethash key tramp-cache-data)
diff --git a/lisp/net/tramp-compat.el b/lisp/net/tramp-compat.el
index e83c1a1500b..232230f8697 100644
--- a/lisp/net/tramp-compat.el
+++ b/lisp/net/tramp-compat.el
@@ -75,7 +75,7 @@ Add the extension of F, if existing."
75 #'tramp-handle-temporary-file-directory)) 75 #'tramp-handle-temporary-file-directory))
76 76
77(defun tramp-compat-process-running-p (process-name) 77(defun tramp-compat-process-running-p (process-name)
78 "Returns t if system process PROCESS-NAME is running for `user-login-name'." 78 "Return t if system process PROCESS-NAME is running for `user-login-name'."
79 (when (stringp process-name) 79 (when (stringp process-name)
80 (cond 80 (cond
81 ;; GNU Emacs 22 on w32. 81 ;; GNU Emacs 22 on w32.
diff --git a/lisp/net/tramp-smb.el b/lisp/net/tramp-smb.el
index 2a9cf6a6d75..27c321bb9cb 100644
--- a/lisp/net/tramp-smb.el
+++ b/lisp/net/tramp-smb.el
@@ -1577,14 +1577,14 @@ errors for shares like \"C$/\", which are common in Microsoft Windows."
1577;; Internal file name functions. 1577;; Internal file name functions.
1578 1578
1579(defun tramp-smb-get-share (vec) 1579(defun tramp-smb-get-share (vec)
1580 "Returns the share name of LOCALNAME." 1580 "Return the share name of LOCALNAME."
1581 (save-match-data 1581 (save-match-data
1582 (let ((localname (tramp-file-name-unquote-localname vec))) 1582 (let ((localname (tramp-file-name-unquote-localname vec)))
1583 (when (string-match "^/?\\([^/]+\\)/" localname) 1583 (when (string-match "^/?\\([^/]+\\)/" localname)
1584 (match-string 1 localname))))) 1584 (match-string 1 localname)))))
1585 1585
1586(defun tramp-smb-get-localname (vec) 1586(defun tramp-smb-get-localname (vec)
1587 "Returns the file name of LOCALNAME. 1587 "Return the file name of LOCALNAME.
1588If VEC has no cifs capabilities, exchange \"/\" by \"\\\\\"." 1588If VEC has no cifs capabilities, exchange \"/\" by \"\\\\\"."
1589 (save-match-data 1589 (save-match-data
1590 (let ((localname (tramp-file-name-unquote-localname vec))) 1590 (let ((localname (tramp-file-name-unquote-localname vec)))
@@ -1717,8 +1717,8 @@ Result is a list of (LOCALNAME MODE SIZE MONTH DAY TIME YEAR)."
1717;; So we try to analyze backwards. 1717;; So we try to analyze backwards.
1718(defun tramp-smb-read-file-entry (share) 1718(defun tramp-smb-read-file-entry (share)
1719 "Parse entry in SMB output buffer. 1719 "Parse entry in SMB output buffer.
1720If SHARE is result, entries are of type dir. Otherwise, shares are listed. 1720If SHARE is result, entries are of type dir. Otherwise, shares
1721Result is the list (LOCALNAME MODE SIZE MTIME)." 1721are listed. Result is the list (LOCALNAME MODE SIZE MTIME)."
1722;; We are called from `tramp-smb-get-file-entries', which sets the 1722;; We are called from `tramp-smb-get-file-entries', which sets the
1723;; current buffer. 1723;; current buffer.
1724 (let ((line (buffer-substring (point) (point-at-eol))) 1724 (let ((line (buffer-substring (point) (point-at-eol)))
@@ -1813,7 +1813,7 @@ Result is the list (LOCALNAME MODE SIZE MTIME)."
1813 (list localname mode size mtime)))) 1813 (list localname mode size mtime))))
1814 1814
1815(defun tramp-smb-get-cifs-capabilities (vec) 1815(defun tramp-smb-get-cifs-capabilities (vec)
1816 "Check, whether the SMB server supports POSIX commands." 1816 "Check whether the SMB server supports POSIX commands."
1817 ;; When we are not logged in yet, we return nil. The 1817 ;; When we are not logged in yet, we return nil. The
1818 ;; connection-local property "posix" is not set explicitly; it is 1818 ;; connection-local property "posix" is not set explicitly; it is
1819 ;; just checked in order to let a user configure it to nil on hosts 1819 ;; just checked in order to let a user configure it to nil on hosts
@@ -1835,7 +1835,7 @@ Result is the list (LOCALNAME MODE SIZE MTIME)."
1835 (buffer-substring (point) (point-at-eol)) nil 'omit))))))))) 1835 (buffer-substring (point) (point-at-eol)) nil 'omit)))))))))
1836 1836
1837(defun tramp-smb-get-stat-capability (vec) 1837(defun tramp-smb-get-stat-capability (vec)
1838 "Check, whether the SMB server supports the STAT command." 1838 "Check whether the SMB server supports the STAT command."
1839 ;; When we are not logged in yet, we return nil. 1839 ;; When we are not logged in yet, we return nil.
1840 (if (and (tramp-smb-get-share vec) 1840 (if (and (tramp-smb-get-share vec)
1841 (process-live-p (tramp-get-connection-process vec))) 1841 (process-live-p (tramp-get-connection-process vec)))
diff --git a/lisp/net/tramp.el b/lisp/net/tramp.el
index 95ca6e3e2aa..37f34cf002b 100644
--- a/lisp/net/tramp.el
+++ b/lisp/net/tramp.el
@@ -2008,7 +2008,7 @@ letter into the file name. This function removes it."
2008;;; Config Manipulation Functions: 2008;;; Config Manipulation Functions:
2009 2009
2010(defun tramp-set-completion-function (method function-list) 2010(defun tramp-set-completion-function (method function-list)
2011 "Sets the list of completion functions for METHOD. 2011 "Set the list of completion functions for METHOD.
2012FUNCTION-LIST is a list of entries of the form (FUNCTION FILE). 2012FUNCTION-LIST is a list of entries of the form (FUNCTION FILE).
2013The FUNCTION is intended to parse FILE according its syntax. 2013The FUNCTION is intended to parse FILE according its syntax.
2014It might be a predefined FUNCTION, or a user defined FUNCTION. 2014It might be a predefined FUNCTION, or a user defined FUNCTION.
@@ -2052,7 +2052,7 @@ Example:
2052 (cons method r))))) 2052 (cons method r)))))
2053 2053
2054(defun tramp-get-completion-function (method) 2054(defun tramp-get-completion-function (method)
2055 "Returns a list of completion functions for METHOD. 2055 "Return a list of completion functions for METHOD.
2056For definition of that list see `tramp-set-completion-function'." 2056For definition of that list see `tramp-set-completion-function'."
2057 (append 2057 (append
2058 `(;; Default settings are taken into account. 2058 `(;; Default settings are taken into account.
@@ -2629,7 +2629,7 @@ not in completion mode."
2629;; "/x:y@""/[x/y@" "/x:y@z" "/[x/y@z" "/x:y@z:" "/[x/y@z]" 2629;; "/x:y@""/[x/y@" "/x:y@z" "/[x/y@z" "/x:y@z:" "/[x/y@z]"
2630;;["x" "y" nil nil] ["x" "y" "z" nil] ["x" "y" "z" ""] 2630;;["x" "y" nil nil] ["x" "y" "z" nil] ["x" "y" "z" ""]
2631(defun tramp-completion-dissect-file-name (name) 2631(defun tramp-completion-dissect-file-name (name)
2632 "Returns a list of `tramp-file-name' structures. 2632 "Return a list of `tramp-file-name' structures.
2633They are collected by `tramp-completion-dissect-file-name1'." 2633They are collected by `tramp-completion-dissect-file-name1'."
2634 (let* ((x-nil "\\|\\(\\)") 2634 (let* ((x-nil "\\|\\(\\)")
2635 (tramp-completion-ipv6-regexp 2635 (tramp-completion-ipv6-regexp
@@ -2702,7 +2702,7 @@ They are collected by `tramp-completion-dissect-file-name1'."
2702 tramp-completion-file-name-structure6))))) 2702 tramp-completion-file-name-structure6)))))
2703 2703
2704(defun tramp-completion-dissect-file-name1 (structure name) 2704(defun tramp-completion-dissect-file-name1 (structure name)
2705 "Returns a `tramp-file-name' structure matching STRUCTURE. 2705 "Return a `tramp-file-name' structure matching STRUCTURE.
2706The structure consists of remote method, remote user, 2706The structure consists of remote method, remote user,
2707remote host and localname (filename on remote host)." 2707remote host and localname (filename on remote host)."
2708 (save-match-data 2708 (save-match-data
@@ -2718,7 +2718,7 @@ remote host and localname (filename on remote host)."
2718;; This function returns all possible method completions, adding the 2718;; This function returns all possible method completions, adding the
2719;; trailing method delimiter. 2719;; trailing method delimiter.
2720(defun tramp-get-completion-methods (partial-method) 2720(defun tramp-get-completion-methods (partial-method)
2721 "Returns all method completions for PARTIAL-METHOD." 2721 "Return all method completions for PARTIAL-METHOD."
2722 (mapcar 2722 (mapcar
2723 (lambda (method) 2723 (lambda (method)
2724 (and method 2724 (and method
@@ -2729,7 +2729,7 @@ remote host and localname (filename on remote host)."
2729;; Compares partial user and host names with possible completions. 2729;; Compares partial user and host names with possible completions.
2730(defun tramp-get-completion-user-host 2730(defun tramp-get-completion-user-host
2731 (method partial-user partial-host user host) 2731 (method partial-user partial-host user host)
2732 "Returns the most expanded string for user and host name completion. 2732 "Return the most expanded string for user and host name completion.
2733PARTIAL-USER must match USER, PARTIAL-HOST must match HOST." 2733PARTIAL-USER must match USER, PARTIAL-HOST must match HOST."
2734 (cond 2734 (cond
2735 2735
@@ -4228,13 +4228,13 @@ the remote host use line-endings as defined in the variable
4228 (delete-region (point) (point-max))))))) 4228 (delete-region (point) (point-max)))))))
4229 4229
4230(defun tramp-get-inode (vec) 4230(defun tramp-get-inode (vec)
4231 "Returns the virtual inode number. 4231 "Return the virtual inode number.
4232If it doesn't exist, generate a new one." 4232If it doesn't exist, generate a new one."
4233 (with-tramp-file-property vec (tramp-file-name-localname vec) "inode" 4233 (with-tramp-file-property vec (tramp-file-name-localname vec) "inode"
4234 (setq tramp-inodes (1+ tramp-inodes)))) 4234 (setq tramp-inodes (1+ tramp-inodes))))
4235 4235
4236(defun tramp-get-device (vec) 4236(defun tramp-get-device (vec)
4237 "Returns the virtual device number. 4237 "Return the virtual device number.
4238If it doesn't exist, generate a new one." 4238If it doesn't exist, generate a new one."
4239 (with-tramp-connection-property (tramp-get-connection-process vec) "device" 4239 (with-tramp-connection-property (tramp-get-connection-process vec) "device"
4240 (cons -1 (setq tramp-devices (1+ tramp-devices))))) 4240 (cons -1 (setq tramp-devices (1+ tramp-devices)))))
@@ -4261,7 +4261,7 @@ If both files are local, the function returns t."
4261 (string-equal (file-remote-p file1) (file-remote-p file2))))) 4261 (string-equal (file-remote-p file1) (file-remote-p file2)))))
4262 4262
4263(defun tramp-mode-string-to-int (mode-string) 4263(defun tramp-mode-string-to-int (mode-string)
4264 "Converts a ten-letter `drwxrwxrwx'-style mode string into mode bits." 4264 "Convert a ten-letter `drwxrwxrwx'-style mode string into mode bits."
4265 (let* (case-fold-search 4265 (let* (case-fold-search
4266 (mode-chars (string-to-vector mode-string)) 4266 (mode-chars (string-to-vector mode-string))
4267 (owner-read (aref mode-chars 1)) 4267 (owner-read (aref mode-chars 1))
@@ -4631,7 +4631,7 @@ ALIST is of the form ((FROM . TO) ...)."
4631 4631
4632(defun tramp-call-process 4632(defun tramp-call-process
4633 (vec program &optional infile destination display &rest args) 4633 (vec program &optional infile destination display &rest args)
4634 "Calls `call-process' on the local host. 4634 "Call `call-process' on the local host.
4635It always returns a return code. The Lisp error raised when 4635It always returns a return code. The Lisp error raised when
4636PROGRAM is nil is trapped also, returning 1. Furthermore, traces 4636PROGRAM is nil is trapped also, returning 1. Furthermore, traces
4637are written with verbosity of 6." 4637are written with verbosity of 6."
@@ -4665,7 +4665,7 @@ are written with verbosity of 6."
4665 4665
4666(defun tramp-call-process-region 4666(defun tramp-call-process-region
4667 (vec start end program &optional delete buffer display &rest args) 4667 (vec start end program &optional delete buffer display &rest args)
4668 "Calls `call-process-region' on the local host. 4668 "Call `call-process-region' on the local host.
4669It always returns a return code. The Lisp error raised when 4669It always returns a return code. The Lisp error raised when
4670PROGRAM is nil is trapped also, returning 1. Furthermore, traces 4670PROGRAM is nil is trapped also, returning 1. Furthermore, traces
4671are written with verbosity of 6." 4671are written with verbosity of 6."
@@ -4696,7 +4696,7 @@ are written with verbosity of 6."
4696 4696
4697(defun tramp-process-lines 4697(defun tramp-process-lines
4698 (vec program &rest args) 4698 (vec program &rest args)
4699 "Calls `process-lines' on the local host. 4699 "Call `process-lines' on the local host.
4700If an error occurs, it returns nil. Traces are written with 4700If an error occurs, it returns nil. Traces are written with
4701verbosity of 6." 4701verbosity of 6."
4702 (let ((default-directory (tramp-compat-temporary-file-directory)) 4702 (let ((default-directory (tramp-compat-temporary-file-directory))
@@ -4852,7 +4852,9 @@ Only works for Bourne-like shells."
4852;;; the process property `remote-pid'. 4852;;; the process property `remote-pid'.
4853 4853
4854(defun tramp-interrupt-process (&optional process _current-group) 4854(defun tramp-interrupt-process (&optional process _current-group)
4855 "Interrupt remote process PROC." 4855 "Interrupt remote PROCESS.
4856PROCESS can be a process, a buffer with an associated process, the
4857name of a process or buffer, or nil to default to the current buffer."
4856 ;; CURRENT-GROUP is not implemented yet. 4858 ;; CURRENT-GROUP is not implemented yet.
4857 (let ((proc (cond 4859 (let ((proc (cond
4858 ((processp process) process) 4860 ((processp process) process)
diff --git a/lisp/net/zeroconf.el b/lisp/net/zeroconf.el
index 36643a828eb..048f2e761b5 100644
--- a/lisp/net/zeroconf.el
+++ b/lisp/net/zeroconf.el
@@ -253,7 +253,7 @@ the service. Usually, every string is a key=value pair. The
253supported keys depend on the service type.") 253supported keys depend on the service type.")
254 254
255(defun zeroconf-list-service-names () 255(defun zeroconf-list-service-names ()
256 "Returns all discovered Avahi service names as list." 256 "Return all discovered Avahi service names as list."
257 (let (result) 257 (let (result)
258 (maphash 258 (maphash
259 (lambda (_key value) (add-to-list 'result (zeroconf-service-name value))) 259 (lambda (_key value) (add-to-list 'result (zeroconf-service-name value)))
@@ -261,7 +261,7 @@ supported keys depend on the service type.")
261 result)) 261 result))
262 262
263(defun zeroconf-list-service-types () 263(defun zeroconf-list-service-types ()
264 "Returns all discovered Avahi service types as list." 264 "Return all discovered Avahi service types as list."
265 (let (result) 265 (let (result)
266 (maphash 266 (maphash
267 (lambda (_key value) (add-to-list 'result (zeroconf-service-type value))) 267 (lambda (_key value) (add-to-list 'result (zeroconf-service-type value)))
@@ -269,7 +269,7 @@ supported keys depend on the service type.")
269 result)) 269 result))
270 270
271(defun zeroconf-list-services (type) 271(defun zeroconf-list-services (type)
272 "Returns all discovered Avahi services for a given service type TYPE. 272 "Return all discovered Avahi services for a given service type TYPE.
273The service type is one of the returned values of 273The service type is one of the returned values of
274`zeroconf-list-service-types'. The return value is a list 274`zeroconf-list-service-types'. The return value is a list
275\(SERVICE1 SERVICE2 ...). See `zeroconf-services-hash' for the 275\(SERVICE1 SERVICE2 ...). See `zeroconf-services-hash' for the
@@ -341,19 +341,19 @@ type used when registering FUNCTION."
341 (remhash type table)))) 341 (remhash type table))))
342 342
343(defun zeroconf-get-host () 343(defun zeroconf-get-host ()
344 "Returns the local host name as string." 344 "Return the local host name as string."
345 (dbus-call-method 345 (dbus-call-method
346 :system zeroconf-service-avahi zeroconf-path-avahi 346 :system zeroconf-service-avahi zeroconf-path-avahi
347 zeroconf-interface-avahi-server "GetHostName")) 347 zeroconf-interface-avahi-server "GetHostName"))
348 348
349(defun zeroconf-get-domain () 349(defun zeroconf-get-domain ()
350 "Returns the domain name as string." 350 "Return the domain name as string."
351 (dbus-call-method 351 (dbus-call-method
352 :system zeroconf-service-avahi zeroconf-path-avahi 352 :system zeroconf-service-avahi zeroconf-path-avahi
353 zeroconf-interface-avahi-server "GetDomainName")) 353 zeroconf-interface-avahi-server "GetDomainName"))
354 354
355(defun zeroconf-get-host-domain () 355(defun zeroconf-get-host-domain ()
356 "Returns the local host name FQDN as string." 356 "Return the local host name FQDN as string."
357 (dbus-call-method 357 (dbus-call-method
358 :system zeroconf-service-avahi zeroconf-path-avahi 358 :system zeroconf-service-avahi zeroconf-path-avahi
359 zeroconf-interface-avahi-server "GetHostNameFqdn")) 359 zeroconf-interface-avahi-server "GetHostNameFqdn"))
diff --git a/lisp/nxml/rng-xsd.el b/lisp/nxml/rng-xsd.el
index 5aa850f5895..c2c90cc8a18 100644
--- a/lisp/nxml/rng-xsd.el
+++ b/lisp/nxml/rng-xsd.el
@@ -46,7 +46,7 @@
46 46
47;;;###autoload 47;;;###autoload
48(defun rng-xsd-compile (name params) 48(defun rng-xsd-compile (name params)
49 "Provides W3C XML Schema as a RELAX NG datatypes library. 49 "Provide W3C XML Schema as a RELAX NG datatypes library.
50NAME is a symbol giving the local name of the datatype. PARAMS is a 50NAME is a symbol giving the local name of the datatype. PARAMS is a
51list of pairs (PARAM-NAME . PARAM-VALUE) where PARAM-NAME is a symbol 51list of pairs (PARAM-NAME . PARAM-VALUE) where PARAM-NAME is a symbol
52giving the name of the parameter and PARAM-VALUE is a string giving 52giving the name of the parameter and PARAM-VALUE is a string giving
@@ -366,7 +366,7 @@ trailing digits. For example, -0021.0430 would be represented by [-1
366 string)) 366 string))
367 367
368(defun rng-xsd-make-date-time-regexp (template) 368(defun rng-xsd-make-date-time-regexp (template)
369 "Returns a regular expression matching a ISO 8601 date/time. 369 "Return a regular expression matching a ISO 8601 date/time.
370The template is a string with Y standing for years field, M standing 370The template is a string with Y standing for years field, M standing
371for months, D standing for day of month, T standing for a literal T, t 371for months, D standing for day of month, T standing for a literal T, t
372standing for time and - standing for a literal hyphen. A time zone is 372standing for time and - standing for a literal hyphen. A time zone is
@@ -436,7 +436,7 @@ sign, time zone hours, time zone minutes."
436 v)) 436 v))
437 437
438(defun rng-xsd-convert-date-time (string regexp) 438(defun rng-xsd-convert-date-time (string regexp)
439 "Converts an XML Schema date/time to a list. 439 "Convert an XML Schema date/time to a list.
440Returns nil if invalid. REGEXP is a regexp for parsing the date time 440Returns nil if invalid. REGEXP is a regexp for parsing the date time
441as returned by `rng-xsd-make-date-time-regexp'. The list has 4 members 441as returned by `rng-xsd-make-date-time-regexp'. The list has 4 members
442\(HAS-TIME-ZONE DAY SECOND SECOND-FRACTION), where HAS-TIME-ZONE is t 442\(HAS-TIME-ZONE DAY SECOND SECOND-FRACTION), where HAS-TIME-ZONE is t
diff --git a/lisp/obsolete/erc-hecomplete.el b/lisp/obsolete/erc-hecomplete.el
index 43df67d5e04..9f4144919ee 100644
--- a/lisp/obsolete/erc-hecomplete.el
+++ b/lisp/obsolete/erc-hecomplete.el
@@ -51,7 +51,7 @@ This function is obsolete, use `erc-pcomplete' instead."
51 (hippie-expand nil))) 51 (hippie-expand nil)))
52 52
53(defgroup erc-hecomplete nil 53(defgroup erc-hecomplete nil
54 "Nick completion. It is recommended to use erc-pcomplete instead." 54 "Nick completion. It is recommended to use `erc-pcomplete' instead."
55 :group 'erc) 55 :group 'erc)
56 56
57(defcustom erc-nick-completion 'all 57(defcustom erc-nick-completion 'all
@@ -99,7 +99,7 @@ add this string when a unique expansion was found."
99 :type 'string) 99 :type 'string)
100 100
101(defun erc-command-list () 101(defun erc-command-list ()
102 "Returns a list of strings of the defined user commands." 102 "Return a list of strings of the defined user commands."
103 (let ((case-fold-search nil)) 103 (let ((case-fold-search nil))
104 (mapcar (lambda (x) 104 (mapcar (lambda (x)
105 (concat "/" (downcase (substring (symbol-name x) 8)))) 105 (concat "/" (downcase (substring (symbol-name x) 8))))
@@ -208,7 +208,7 @@ Window configurations are stored in
208 (equal point (point)))) 208 (equal point (point))))
209 209
210(defun erc-complete-at-prompt () 210(defun erc-complete-at-prompt ()
211 "Returns t if point is directly after `erc-prompt' when doing completion." 211 "Return t if point is directly after `erc-prompt' when doing completion."
212 (erc-at-beginning-of-line-p (he-dabbrev-beg))) 212 (erc-at-beginning-of-line-p (he-dabbrev-beg)))
213 213
214(provide 'erc-hecomplete) 214(provide 'erc-hecomplete)
diff --git a/lisp/org/ChangeLog.1 b/lisp/org/ChangeLog.1
index 2bb15863e7f..8f7334a330a 100644
--- a/lisp/org/ChangeLog.1
+++ b/lisp/org/ChangeLog.1
@@ -11557,7 +11557,7 @@
115572012-04-01 Jambunathan K <kjambunathan@gmail.com> 115572012-04-01 Jambunathan K <kjambunathan@gmail.com>
11558 11558
11559 * org-footnote.el (org-footnote-normalize): Force a paragraph 11559 * org-footnote.el (org-footnote-normalize): Force a paragraph
11560 break after the last footnote definition. This is an an implicit 11560 break after the last footnote definition. This is an implicit
11561 assumption made by the org-lparse.el library. With this change, 11561 assumption made by the org-lparse.el library. With this change,
11562 footnote definitions can reliably be exported with ODT backend. 11562 footnote definitions can reliably be exported with ODT backend.
11563 See https://lists.gnu.org/r/emacs-orgmode/2012-02/msg01013.html. 11563 See https://lists.gnu.org/r/emacs-orgmode/2012-02/msg01013.html.
@@ -11912,7 +11912,7 @@
11912 11912
11913 * org-footnote.el (org-footnote-normalize): Ensure footnote 11913 * org-footnote.el (org-footnote-normalize): Ensure footnote
11914 definition will be inserted at the end of the section 11914 definition will be inserted at the end of the section
11915 corresponding to to its first reference. 11915 corresponding to its first reference.
11916 11916
119172012-04-01 Nicolas Goaziou <n.goaziou@gmail.com> 119172012-04-01 Nicolas Goaziou <n.goaziou@gmail.com>
11918 11918
@@ -17453,7 +17453,7 @@
174532011-07-28 Nicolas Goaziou <n.goaziou@gmail.com> 174532011-07-28 Nicolas Goaziou <n.goaziou@gmail.com>
17454 17454
17455 * org-list.el (org-list-struct, org-in-item-p): Don't assume end of 17455 * org-list.el (org-list-struct, org-in-item-p): Don't assume end of
17456 blocks or drawers necessarily start somewhere. It it isn't the 17456 blocks or drawers necessarily start somewhere. If it isn't the
17457 case, treat them as normal text. 17457 case, treat them as normal text.
17458 17458
174592011-07-28 Eric Schulte <schulte.eric@gmail.com> 174592011-07-28 Eric Schulte <schulte.eric@gmail.com>
diff --git a/lisp/org/ob-core.el b/lisp/org/ob-core.el
index 8e9e3edb1c8..9e78876787a 100644
--- a/lisp/org/ob-core.el
+++ b/lisp/org/ob-core.el
@@ -532,7 +532,7 @@ to raise errors for all languages.")
532 "Hook for functions to be called after `org-babel-execute-src-block'") 532 "Hook for functions to be called after `org-babel-execute-src-block'")
533 533
534(defun org-babel-named-src-block-regexp-for-name (&optional name) 534(defun org-babel-named-src-block-regexp-for-name (&optional name)
535 "This generates a regexp used to match a src block named NAME. 535 "Generate a regexp used to match a src block named NAME.
536If NAME is nil, match any name. Matched name is then put in 536If NAME is nil, match any name. Matched name is then put in
537match group 9. Other match groups are defined in 537match group 9. Other match groups are defined in
538`org-babel-src-block-regexp'." 538`org-babel-src-block-regexp'."
@@ -543,7 +543,7 @@ match group 9. Other match groups are defined in
543 (substring org-babel-src-block-regexp 1))) 543 (substring org-babel-src-block-regexp 1)))
544 544
545(defun org-babel-named-data-regexp-for-name (name) 545(defun org-babel-named-data-regexp-for-name (name)
546 "This generates a regexp used to match data named NAME." 546 "Generate a regexp used to match data named NAME."
547 (concat org-babel-name-regexp (regexp-quote name) "[ \t]*$")) 547 (concat org-babel-name-regexp (regexp-quote name) "[ \t]*$"))
548 548
549(defun org-babel--normalize-body (datum) 549(defun org-babel--normalize-body (datum)
@@ -1774,7 +1774,7 @@ to `org-babel-named-src-block-regexp'."
1774 (ignore-errors (org-next-block 1 nil regexp)))))) 1774 (ignore-errors (org-next-block 1 nil regexp))))))
1775 1775
1776(defun org-babel-src-block-names (&optional file) 1776(defun org-babel-src-block-names (&optional file)
1777 "Returns the names of source blocks in FILE or the current buffer." 1777 "Return the names of source blocks in FILE or the current buffer."
1778 (with-current-buffer (if file (find-file-noselect file) (current-buffer)) 1778 (with-current-buffer (if file (find-file-noselect file) (current-buffer))
1779 (org-with-point-at 1 1779 (org-with-point-at 1
1780 (let ((regexp "^[ \t]*#\\+begin_src ") 1780 (let ((regexp "^[ \t]*#\\+begin_src ")
@@ -1819,7 +1819,7 @@ buffer or nil if no such result exists."
1819 (throw :found (line-beginning-position))))))))) 1819 (throw :found (line-beginning-position)))))))))
1820 1820
1821(defun org-babel-result-names (&optional file) 1821(defun org-babel-result-names (&optional file)
1822 "Returns the names of results in FILE or the current buffer." 1822 "Return the names of results in FILE or the current buffer."
1823 (save-excursion 1823 (save-excursion
1824 (when file (find-file file)) (goto-char (point-min)) 1824 (when file (find-file file)) (goto-char (point-min))
1825 (let ((case-fold-search t) names) 1825 (let ((case-fold-search t) names)
diff --git a/lisp/org/ob-scheme.el b/lisp/org/ob-scheme.el
index af5c7f26d6f..635b3aa6003 100644
--- a/lisp/org/ob-scheme.el
+++ b/lisp/org/ob-scheme.el
@@ -102,7 +102,7 @@
102 (puthash session-name buffer org-babel-scheme-repl-map)) 102 (puthash session-name buffer org-babel-scheme-repl-map))
103 103
104(defun org-babel-scheme-get-buffer-impl (buffer) 104(defun org-babel-scheme-get-buffer-impl (buffer)
105 "Returns the scheme implementation geiser associates with the buffer." 105 "Return the scheme implementation geiser associates with the buffer."
106 (with-current-buffer (set-buffer buffer) 106 (with-current-buffer (set-buffer buffer)
107 geiser-impl--implementation)) 107 geiser-impl--implementation))
108 108
diff --git a/lisp/org/ob-shell.el b/lisp/org/ob-shell.el
index 8e080c6977f..548edce5793 100644
--- a/lisp/org/ob-shell.el
+++ b/lisp/org/ob-shell.el
@@ -111,12 +111,12 @@ This function is called by `org-babel-execute-src-block'."
111;;; Helper functions 111;;; Helper functions
112(defun org-babel--variable-assignments:sh-generic 112(defun org-babel--variable-assignments:sh-generic
113 (varname values &optional sep hline) 113 (varname values &optional sep hline)
114 "Returns a list of statements declaring the values as a generic variable." 114 "Return a list of statements declaring the values as a generic variable."
115 (format "%s=%s" varname (org-babel-sh-var-to-sh values sep hline))) 115 (format "%s=%s" varname (org-babel-sh-var-to-sh values sep hline)))
116 116
117(defun org-babel--variable-assignments:bash_array 117(defun org-babel--variable-assignments:bash_array
118 (varname values &optional sep hline) 118 (varname values &optional sep hline)
119 "Returns a list of statements declaring the values as a bash array." 119 "Return a list of statements declaring the values as a bash array."
120 (format "unset %s\ndeclare -a %s=( %s )" 120 (format "unset %s\ndeclare -a %s=( %s )"
121 varname varname 121 varname varname
122 (mapconcat 122 (mapconcat
@@ -126,7 +126,7 @@ This function is called by `org-babel-execute-src-block'."
126 126
127(defun org-babel--variable-assignments:bash_assoc 127(defun org-babel--variable-assignments:bash_assoc
128 (varname values &optional sep hline) 128 (varname values &optional sep hline)
129 "Returns a list of statements declaring the values as bash associative array." 129 "Return a list of statements declaring the values as bash associative array."
130 (format "unset %s\ndeclare -A %s\n%s" 130 (format "unset %s\ndeclare -A %s\n%s"
131 varname varname 131 varname varname
132 (mapconcat 132 (mapconcat
@@ -139,7 +139,7 @@ This function is called by `org-babel-execute-src-block'."
139 "\n"))) 139 "\n")))
140 140
141(defun org-babel--variable-assignments:bash (varname values &optional sep hline) 141(defun org-babel--variable-assignments:bash (varname values &optional sep hline)
142 "Represents the parameters as useful Bash shell variables." 142 "Represent the parameters as useful Bash shell variables."
143 (pcase values 143 (pcase values
144 (`((,_ ,_ . ,_) . ,_) ;two-dimensional array 144 (`((,_ ,_ . ,_) . ,_) ;two-dimensional array
145 (org-babel--variable-assignments:bash_assoc varname values sep hline)) 145 (org-babel--variable-assignments:bash_assoc varname values sep hline))
diff --git a/lisp/org/org-clock.el b/lisp/org/org-clock.el
index 4667890b421..9046661b266 100644
--- a/lisp/org/org-clock.el
+++ b/lisp/org/org-clock.el
@@ -2055,7 +2055,7 @@ in the buffer and update it."
2055 (org-update-dblock)) 2055 (org-update-dblock))
2056 2056
2057(defun org-day-of-week (day month year) 2057(defun org-day-of-week (day month year)
2058 "Returns the day of the week as an integer." 2058 "Return the day of the week as an integer."
2059 (nth 6 2059 (nth 6
2060 (decode-time 2060 (decode-time
2061 (date-to-time 2061 (date-to-time
diff --git a/lisp/org/ox.el b/lisp/org/ox.el
index aa04676db8d..0ae1e45f036 100644
--- a/lisp/org/ox.el
+++ b/lisp/org/ox.el
@@ -4711,7 +4711,7 @@ code."
4711 4711
4712;;;; For Tables 4712;;;; For Tables
4713;; 4713;;
4714;; `org-export-table-has-special-column-p' and and 4714;; `org-export-table-has-special-column-p' and
4715;; `org-export-table-row-is-special-p' are predicates used to look for 4715;; `org-export-table-row-is-special-p' are predicates used to look for
4716;; meta-information about the table structure. 4716;; meta-information about the table structure.
4717;; 4717;;
diff --git a/lisp/progmodes/cperl-mode.el b/lisp/progmodes/cperl-mode.el
index 5d4cf96d4c4..e9be1990ddc 100644
--- a/lisp/progmodes/cperl-mode.el
+++ b/lisp/progmodes/cperl-mode.el
@@ -1324,7 +1324,7 @@ the last)."
1324(defvar cperl-sub-regexp (regexp-opt cperl-sub-keywords)) 1324(defvar cperl-sub-regexp (regexp-opt cperl-sub-keywords))
1325 1325
1326(defun cperl-char-ends-sub-keyword-p (char) 1326(defun cperl-char-ends-sub-keyword-p (char)
1327 "Return T if CHAR is the last character of a perl sub keyword." 1327 "Return t if CHAR is the last character of a perl sub keyword."
1328 (cl-loop for keyword in cperl-sub-keywords 1328 (cl-loop for keyword in cperl-sub-keywords
1329 when (eq char (aref keyword (1- (length keyword)))) 1329 when (eq char (aref keyword (1- (length keyword))))
1330 return t)) 1330 return t))
diff --git a/lisp/progmodes/gud.el b/lisp/progmodes/gud.el
index 396141b3884..9a5a1ad217b 100644
--- a/lisp/progmodes/gud.el
+++ b/lisp/progmodes/gud.el
@@ -3009,7 +3009,7 @@ Obeying it means displaying in another window the specified file and line."
3009;; Rich Schaefer <schaefer@asc.slb.com> Schlumberger, Austin, Tx. 3009;; Rich Schaefer <schaefer@asc.slb.com> Schlumberger, Austin, Tx.
3010 3010
3011(defun gud-find-c-expr () 3011(defun gud-find-c-expr ()
3012 "Returns the expr that surrounds point." 3012 "Return the expr that surrounds point."
3013 (interactive) 3013 (interactive)
3014 (save-excursion 3014 (save-excursion
3015 (let ((p (point)) 3015 (let ((p (point))
@@ -3034,7 +3034,7 @@ Obeying it means displaying in another window the specified file and line."
3034 (buffer-substring (car expr) (cdr expr))))) 3034 (buffer-substring (car expr) (cdr expr)))))
3035 3035
3036(defun gud-innermost-expr () 3036(defun gud-innermost-expr ()
3037 "Returns the smallest expr that point is in; move point to beginning of it. 3037 "Return the smallest expr that point is in; move point to beginning of it.
3038The expr is represented as a cons cell, where the car specifies the point in 3038The expr is represented as a cons cell, where the car specifies the point in
3039the current buffer that marks the beginning of the expr and the cdr specifies 3039the current buffer that marks the beginning of the expr and the cdr specifies
3040the character after the end of the expr." 3040the character after the end of the expr."
@@ -3066,7 +3066,7 @@ the character after the end of the expr."
3066 (error t))) 3066 (error t)))
3067 3067
3068(defun gud-prev-expr () 3068(defun gud-prev-expr ()
3069 "Returns the previous expr, point is set to beginning of that expr. 3069 "Return the previous expr, point is set to beginning of that expr.
3070The expr is represented as a cons cell, where the car specifies the point in 3070The expr is represented as a cons cell, where the car specifies the point in
3071the current buffer that marks the beginning of the expr and the cdr specifies 3071the current buffer that marks the beginning of the expr and the cdr specifies
3072the character after the end of the expr." 3072the character after the end of the expr."
@@ -3079,7 +3079,7 @@ the character after the end of the expr."
3079 (cons begin end))) 3079 (cons begin end)))
3080 3080
3081(defun gud-next-expr () 3081(defun gud-next-expr ()
3082 "Returns the following expr, point is set to beginning of that expr. 3082 "Return the following expr, point is set to beginning of that expr.
3083The expr is represented as a cons cell, where the car specifies the point in 3083The expr is represented as a cons cell, where the car specifies the point in
3084the current buffer that marks the beginning of the expr and the cdr specifies 3084the current buffer that marks the beginning of the expr and the cdr specifies
3085the character after the end of the expr." 3085the character after the end of the expr."
diff --git a/lisp/progmodes/inf-lisp.el b/lisp/progmodes/inf-lisp.el
index dafb89a5b65..7d5ec06bf51 100644
--- a/lisp/progmodes/inf-lisp.el
+++ b/lisp/progmodes/inf-lisp.el
@@ -287,7 +287,7 @@ to continue it."
287 (buffer-substring (point) end)))) 287 (buffer-substring (point) end))))
288 288
289(defun lisp-input-filter (str) 289(defun lisp-input-filter (str)
290 "t if STR does not match `inferior-lisp-filter-regexp'." 290 "Return t if STR does not match `inferior-lisp-filter-regexp'."
291 (not (string-match inferior-lisp-filter-regexp str))) 291 (not (string-match inferior-lisp-filter-regexp str)))
292 292
293;;;###autoload 293;;;###autoload
@@ -564,7 +564,7 @@ Used by these commands to determine defaults."
564 564
565;;; Adapted from function-called-at-point in help.el. 565;;; Adapted from function-called-at-point in help.el.
566(defun lisp-fn-called-at-pt () 566(defun lisp-fn-called-at-pt ()
567 "Returns the name of the function called in the current call. 567 "Return the name of the function called in the current call.
568The value is nil if it can't find one." 568The value is nil if it can't find one."
569 (condition-case nil 569 (condition-case nil
570 (save-excursion 570 (save-excursion
diff --git a/lisp/progmodes/xref.el b/lisp/progmodes/xref.el
index eef2ca643f6..702de894528 100644
--- a/lisp/progmodes/xref.el
+++ b/lisp/progmodes/xref.el
@@ -268,8 +268,8 @@ find a search tool; by default, this uses \"find | grep\" in the
268(cl-defgeneric xref-backend-identifier-at-point (_backend) 268(cl-defgeneric xref-backend-identifier-at-point (_backend)
269 "Return the relevant identifier at point. 269 "Return the relevant identifier at point.
270 270
271The return value must be a string or nil. nil means no 271The return value must be a string, or nil meaning no identifier
272identifier at point found. 272at point found.
273 273
274If it's hard to determine the identifier precisely (e.g., because 274If it's hard to determine the identifier precisely (e.g., because
275it's a method call on unknown type), the implementation can 275it's a method call on unknown type), the implementation can
@@ -280,7 +280,7 @@ recognize and then delegate the work to an external process."
280 (and thing (substring-no-properties thing)))) 280 (and thing (substring-no-properties thing))))
281 281
282(cl-defgeneric xref-backend-identifier-completion-table (backend) 282(cl-defgeneric xref-backend-identifier-completion-table (backend)
283 "Returns the completion table for identifiers.") 283 "Return the completion table for identifiers.")
284 284
285 285
286;;; misc utilities 286;;; misc utilities
diff --git a/lisp/registry.el b/lisp/registry.el
index 8e2005b0a5a..f65e60caa35 100644
--- a/lisp/registry.el
+++ b/lisp/registry.el
@@ -155,7 +155,7 @@
155 (setq tracker (make-hash-table :size 100 :rehash-size 2.0))))) 155 (setq tracker (make-hash-table :size 100 :rehash-size 2.0)))))
156 156
157(cl-defmethod registry-lookup ((db registry-db) keys) 157(cl-defmethod registry-lookup ((db registry-db) keys)
158 "Search for KEYS in the registry-db THIS. 158 "Search for KEYS in the registry-db DB.
159Returns an alist of the key followed by the entry in a list, not a cons cell." 159Returns an alist of the key followed by the entry in a list, not a cons cell."
160 (let ((data (oref db data))) 160 (let ((data (oref db data)))
161 (delq nil 161 (delq nil
@@ -166,7 +166,7 @@ Returns an alist of the key followed by the entry in a list, not a cons cell."
166 keys)))) 166 keys))))
167 167
168(cl-defmethod registry-lookup-breaks-before-lexbind ((db registry-db) keys) 168(cl-defmethod registry-lookup-breaks-before-lexbind ((db registry-db) keys)
169 "Search for KEYS in the registry-db THIS. 169 "Search for KEYS in the registry-db DB.
170Returns an alist of the key followed by the entry in a list, not a cons cell." 170Returns an alist of the key followed by the entry in a list, not a cons cell."
171 (let ((data (oref db data))) 171 (let ((data (oref db data)))
172 (delq nil 172 (delq nil
@@ -176,7 +176,7 @@ Returns an alist of the key followed by the entry in a list, not a cons cell."
176 176
177(cl-defmethod registry-lookup-secondary ((db registry-db) tracksym 177(cl-defmethod registry-lookup-secondary ((db registry-db) tracksym
178 &optional create) 178 &optional create)
179 "Search for TRACKSYM in the registry-db THIS. 179 "Search for TRACKSYM in the registry-db DB.
180When CREATE is not nil, create the secondary index hash table if needed." 180When CREATE is not nil, create the secondary index hash table if needed."
181 (let ((h (gethash tracksym (oref db tracker)))) 181 (let ((h (gethash tracksym (oref db tracker))))
182 (if h 182 (if h
@@ -189,7 +189,7 @@ When CREATE is not nil, create the secondary index hash table if needed."
189 189
190(cl-defmethod registry-lookup-secondary-value ((db registry-db) tracksym val 190(cl-defmethod registry-lookup-secondary-value ((db registry-db) tracksym val
191 &optional set) 191 &optional set)
192 "Search for TRACKSYM with value VAL in the registry-db THIS. 192 "Search for TRACKSYM with value VAL in the registry-db DB.
193When SET is not nil, set it for VAL (use t for an empty list)." 193When SET is not nil, set it for VAL (use t for an empty list)."
194 ;; either we're asked for creation or there should be an existing index 194 ;; either we're asked for creation or there should be an existing index
195 (when (or set (registry-lookup-secondary db tracksym)) 195 (when (or set (registry-lookup-secondary db tracksym))
@@ -220,7 +220,7 @@ When SET is not nil, set it for VAL (use t for an empty list)."
220 (registry--match mode entry (cdr-safe check-list)))))) 220 (registry--match mode entry (cdr-safe check-list))))))
221 221
222(cl-defmethod registry-search ((db registry-db) &rest spec) 222(cl-defmethod registry-search ((db registry-db) &rest spec)
223 "Search for SPEC across the registry-db THIS. 223 "Search for SPEC across the registry-db DB.
224For example calling with `:member \\='(a 1 2)' will match entry \((a 3 1)). 224For example calling with `:member \\='(a 1 2)' will match entry \((a 3 1)).
225Calling with `:all t' (any non-nil value) will match all. 225Calling with `:all t' (any non-nil value) will match all.
226Calling with `:regex \\='(a \"h.llo\")' will match entry \(a \"hullo\" \"bye\"). 226Calling with `:regex \\='(a \"h.llo\")' will match entry \(a \"hullo\" \"bye\").
@@ -241,7 +241,7 @@ The test order is to check :all first, then :member, then :regex."
241 collect k)))) 241 collect k))))
242 242
243(cl-defmethod registry-delete ((db registry-db) keys assert &rest spec) 243(cl-defmethod registry-delete ((db registry-db) keys assert &rest spec)
244 "Delete KEYS from the registry-db THIS. 244 "Delete KEYS from the registry-db DB.
245If KEYS is nil, use SPEC to do a search. 245If KEYS is nil, use SPEC to do a search.
246Updates the secondary ('tracked') indices as well. 246Updates the secondary ('tracked') indices as well.
247With assert non-nil, errors out if the key does not exist already." 247With assert non-nil, errors out if the key does not exist already."
@@ -273,17 +273,17 @@ With assert non-nil, errors out if the key does not exist already."
273 keys)) 273 keys))
274 274
275(cl-defmethod registry-size ((db registry-db)) 275(cl-defmethod registry-size ((db registry-db))
276 "Returns the size of the registry-db object THIS. 276 "Return the size of the registry-db object DB.
277This is the key count of the `data' slot." 277This is the key count of the `data' slot."
278 (hash-table-count (oref db data))) 278 (hash-table-count (oref db data)))
279 279
280(cl-defmethod registry-full ((db registry-db)) 280(cl-defmethod registry-full ((db registry-db))
281 "Checks if registry-db THIS is full." 281 "Check if registry-db DB is full."
282 (>= (registry-size db) 282 (>= (registry-size db)
283 (oref db max-size))) 283 (oref db max-size)))
284 284
285(cl-defmethod registry-insert ((db registry-db) key entry) 285(cl-defmethod registry-insert ((db registry-db) key entry)
286 "Insert ENTRY under KEY into the registry-db THIS. 286 "Insert ENTRY under KEY into the registry-db DB.
287Updates the secondary ('tracked') indices as well. 287Updates the secondary ('tracked') indices as well.
288Errors out if the key exists already." 288Errors out if the key exists already."
289 (cl-assert (not (gethash key (oref db data))) nil 289 (cl-assert (not (gethash key (oref db data))) nil
@@ -304,7 +304,7 @@ Errors out if the key exists already."
304 entry) 304 entry)
305 305
306(cl-defmethod registry-reindex ((db registry-db)) 306(cl-defmethod registry-reindex ((db registry-db))
307 "Rebuild the secondary indices of registry-db THIS." 307 "Rebuild the secondary indices of registry-db DB."
308 (let ((count 0) 308 (let ((count 0)
309 (expected (* (length (oref db tracked)) (registry-size db)))) 309 (expected (* (length (oref db tracked)) (registry-size db))))
310 (dolist (tr (oref db tracked)) 310 (dolist (tr (oref db tracked))
@@ -323,7 +323,7 @@ Errors out if the key exists already."
323 (oref db data)))))) 323 (oref db data))))))
324 324
325(cl-defmethod registry-prune ((db registry-db) &optional sortfunc) 325(cl-defmethod registry-prune ((db registry-db) &optional sortfunc)
326 "Prunes the registry-db object DB. 326 "Prune the registry-db object DB.
327 327
328Attempts to prune the number of entries down to \(* 328Attempts to prune the number of entries down to \(*
329:max-size :prune-factor) less than the max-size limit, so 329:max-size :prune-factor) less than the max-size limit, so
@@ -351,7 +351,7 @@ Returns the number of deleted entries."
351 351
352(cl-defmethod registry-collect-prune-candidates ((db registry-db) 352(cl-defmethod registry-collect-prune-candidates ((db registry-db)
353 limit sortfunc) 353 limit sortfunc)
354 "Collects pruning candidates from the registry-db object DB. 354 "Collect pruning candidates from the registry-db object DB.
355 355
356Proposes only entries without the :precious keys, and attempts to 356Proposes only entries without the :precious keys, and attempts to
357return LIMIT such candidates. If SORTFUNC is provided, sort 357return LIMIT such candidates. If SORTFUNC is provided, sort
diff --git a/lisp/so-long.el b/lisp/so-long.el
index 59c719a4ee5..e2467e4f0f3 100644
--- a/lisp/so-long.el
+++ b/lisp/so-long.el
@@ -654,7 +654,7 @@ an example."
654;; `provided-mode-derived-p' was added in 26.1 654;; `provided-mode-derived-p' was added in 26.1
655(unless (fboundp 'provided-mode-derived-p) 655(unless (fboundp 'provided-mode-derived-p)
656 (defun provided-mode-derived-p (mode &rest modes) 656 (defun provided-mode-derived-p (mode &rest modes)
657 "Non-nil if MODE is derived from one of MODES. 657 "Return non-nil if MODE is derived from one of MODES.
658Uses the `derived-mode-parent' property of the symbol to trace backwards. 658Uses the `derived-mode-parent' property of the symbol to trace backwards.
659If you just want to check `major-mode', use `derived-mode-p'." 659If you just want to check `major-mode', use `derived-mode-p'."
660 (while (and (not (memq mode modes)) 660 (while (and (not (memq mode modes))
@@ -982,7 +982,7 @@ serves the same purpose.")
982(put 'so-long-mode-line-info 'risky-local-variable t) 982(put 'so-long-mode-line-info 'risky-local-variable t)
983 983
984(defun so-long-mode-line-info () 984(defun so-long-mode-line-info ()
985 "Returns the mode line construct for variable `so-long-mode-line-info'." 985 "Return the mode line construct for variable `so-long-mode-line-info'."
986 (let ((map (make-sparse-keymap))) 986 (let ((map (make-sparse-keymap)))
987 (define-key map (kbd "<mode-line> <down-mouse-1>") 987 (define-key map (kbd "<mode-line> <down-mouse-1>")
988 `(menu-item "" nil 988 `(menu-item "" nil
@@ -1189,7 +1189,7 @@ values), despite potential performance issues, type \\[so-long-revert].
1189 1189
1190Use \\[so-long-commentary] for more information. 1190Use \\[so-long-commentary] for more information.
1191 1191
1192Use \\[so-long-customize] to configure the behaviour." 1192Use \\[so-long-customize] to configure the behavior."
1193 ;; Housekeeping. `so-long-mode' might be invoked directly rather than via 1193 ;; Housekeeping. `so-long-mode' might be invoked directly rather than via
1194 ;; `so-long', so replicate the necessary behaviours. We could use this same 1194 ;; `so-long', so replicate the necessary behaviours. We could use this same
1195 ;; test in `so-long-after-change-major-mode' to run `so-long-hook', but that's 1195 ;; test in `so-long-after-change-major-mode' to run `so-long-hook', but that's
@@ -1371,7 +1371,7 @@ This is a `so-long-file-local-mode-function' option."
1371 1371
1372(defun so-long--check-header-modes () 1372(defun so-long--check-header-modes ()
1373 ;; See also "Files with a file-local 'mode'" in the Commentary. 1373 ;; See also "Files with a file-local 'mode'" in the Commentary.
1374 "Handles the header-comments processing in `set-auto-mode'. 1374 "Handle the header-comments processing in `set-auto-mode'.
1375 1375
1376`set-auto-mode' has some special-case code to handle the 'mode' pseudo-variable 1376`set-auto-mode' has some special-case code to handle the 'mode' pseudo-variable
1377when set in the header comment. This runs outside of `hack-local-variables' 1377when set in the header comment. This runs outside of `hack-local-variables'
diff --git a/lisp/subr.el b/lisp/subr.el
index ada078aed9b..3ba4d2bd4e5 100644
--- a/lisp/subr.el
+++ b/lisp/subr.el
@@ -639,7 +639,7 @@ copy."
639 (nbutlast (copy-sequence list) n))) 639 (nbutlast (copy-sequence list) n)))
640 640
641(defun nbutlast (list &optional n) 641(defun nbutlast (list &optional n)
642 "Modifies LIST to remove the last N elements. 642 "Modify LIST to remove the last N elements.
643If N is omitted or nil, remove the last element." 643If N is omitted or nil, remove the last element."
644 (let ((m (length list))) 644 (let ((m (length list)))
645 (or n (setq n 1)) 645 (or n (setq n 1))
@@ -2341,7 +2341,7 @@ Signal an error if the program returns with a non-zero exit status."
2341 (nreverse lines))))) 2341 (nreverse lines)))))
2342 2342
2343(defun process-live-p (process) 2343(defun process-live-p (process)
2344 "Returns non-nil if PROCESS is alive. 2344 "Return non-nil if PROCESS is alive.
2345A process is considered alive if its status is `run', `open', 2345A process is considered alive if its status is `run', `open',
2346`listen', `connect' or `stop'. Value is nil if PROCESS is not a 2346`listen', `connect' or `stop'. Value is nil if PROCESS is not a
2347process." 2347process."
diff --git a/lisp/tab-bar.el b/lisp/tab-bar.el
index 52d06872312..800b65091a0 100644
--- a/lisp/tab-bar.el
+++ b/lisp/tab-bar.el
@@ -727,7 +727,7 @@ In this list of window configurations you can delete or select them.
727Type ? after invocation to get help on commands available. 727Type ? after invocation to get help on commands available.
728Type q to remove the list of window configurations from the display. 728Type q to remove the list of window configurations from the display.
729 729
730The first column shows `D' for for a window configuration you have 730The first column shows `D' for a window configuration you have
731marked for deletion." 731marked for deletion."
732 (interactive) 732 (interactive)
733 (let ((dir default-directory) 733 (let ((dir default-directory)
diff --git a/lisp/textmodes/table.el b/lisp/textmodes/table.el
index 94dcaea0ba6..839df035d27 100644
--- a/lisp/textmodes/table.el
+++ b/lisp/textmodes/table.el
@@ -4950,7 +4950,7 @@ When optional LOCATION is provided the test is performed at that location."
4950 (equal cell-beg (progn (goto-char end) (table--probe-cell)))))))) 4950 (equal cell-beg (progn (goto-char end) (table--probe-cell))))))))
4951 4951
4952(defun table--at-cell-p (position &optional object at-column) 4952(defun table--at-cell-p (position &optional object at-column)
4953 "Returns non-nil if POSITION has table-cell property in OBJECT. 4953 "Return non-nil if POSITION has table-cell property in OBJECT.
4954OBJECT is optional and defaults to the current buffer. 4954OBJECT is optional and defaults to the current buffer.
4955If POSITION is at the end of OBJECT, the value is nil." 4955If POSITION is at the end of OBJECT, the value is nil."
4956 (if (and at-column (stringp object)) 4956 (if (and at-column (stringp object))
@@ -5042,7 +5042,7 @@ Focus only on the corner pattern. Further cell validity check is required."
5042 (get-text-property (point) 'table-cell))) 5042 (get-text-property (point) 'table-cell)))
5043 5043
5044(defun table--probe-cell (&optional abort-on-error) 5044(defun table--probe-cell (&optional abort-on-error)
5045 "Probes a table cell around the point. 5045 "Probe a table cell around the point.
5046Searches for the left upper corner and the right bottom corner of a table 5046Searches for the left upper corner and the right bottom corner of a table
5047cell which contains the current point location. 5047cell which contains the current point location.
5048 5048
@@ -5198,11 +5198,11 @@ instead of the current buffer and returns the OBJECT."
5198 (get-text-property (1- (cdr cell)) property))) 5198 (get-text-property (1- (cdr cell)) property)))
5199 5199
5200(defun table--get-cell-justify-property (cell) 5200(defun table--get-cell-justify-property (cell)
5201 "Get cell's justify property." 5201 "Get CELL's justify property."
5202 (table--get-property cell 'table-justify)) 5202 (table--get-property cell 'table-justify))
5203 5203
5204(defun table--get-cell-valign-property (cell) 5204(defun table--get-cell-valign-property (cell)
5205 "Get cell's vertical alignment property." 5205 "Get CELL's vertical alignment property."
5206 (table--get-property cell 'table-valign)) 5206 (table--get-property cell 'table-valign))
5207 5207
5208(defun table--put-property (cell property value) 5208(defun table--put-property (cell property value)
@@ -5213,11 +5213,11 @@ instead of the current buffer and returns the OBJECT."
5213 (put-text-property (1- end) end property value))) 5213 (put-text-property (1- end) end property value)))
5214 5214
5215(defun table--put-cell-justify-property (cell justify) 5215(defun table--put-cell-justify-property (cell justify)
5216 "Put cell's justify property." 5216 "Put CELL's JUSTIFY property."
5217 (table--put-property cell 'table-justify justify)) 5217 (table--put-property cell 'table-justify justify))
5218 5218
5219(defun table--put-cell-valign-property (cell valign) 5219(defun table--put-cell-valign-property (cell valign)
5220 "Put cell's vertical alignment property." 5220 "Put CELL's vertical alignment property."
5221 (table--put-property cell 'table-valign valign)) 5221 (table--put-property cell 'table-valign valign))
5222 5222
5223(defun table--point-entered/left-cell-function (_window _oldpos dir) 5223(defun table--point-entered/left-cell-function (_window _oldpos dir)
diff --git a/src/sound.c b/src/sound.c
index 44d4cbc6d56..60bf530564f 100644
--- a/src/sound.c
+++ b/src/sound.c
@@ -1115,7 +1115,7 @@ alsa_write (struct sound_device *sd, const char *buffer, ptrdiff_t nbytes)
1115{ 1115{
1116 struct alsa_params *p = (struct alsa_params *) sd->data; 1116 struct alsa_params *p = (struct alsa_params *) sd->data;
1117 1117
1118 /* The the third parameter to snd_pcm_writei is frames, not bytes. */ 1118 /* The third parameter to snd_pcm_writei is frames, not bytes. */
1119 int fact = snd_pcm_format_size (sd->format, 1) * sd->channels; 1119 int fact = snd_pcm_format_size (sd->format, 1) * sd->channels;
1120 ptrdiff_t nwritten = 0; 1120 ptrdiff_t nwritten = 0;
1121 int err; 1121 int err;
diff --git a/src/xdisp.c b/src/xdisp.c
index 8cbda08efc5..987c760c743 100644
--- a/src/xdisp.c
+++ b/src/xdisp.c
@@ -21697,7 +21697,7 @@ extend_face_to_end_of_line (struct it *it)
21697 memset (&it->position, 0, sizeof it->position); 21697 memset (&it->position, 0, sizeof it->position);
21698 21698
21699 /* Only generate a stretch glyph if there is distance 21699 /* Only generate a stretch glyph if there is distance
21700 between current_x and and the indicator position. */ 21700 between current_x and the indicator position. */
21701 if (stretch_width > 0) 21701 if (stretch_width > 0)
21702 { 21702 {
21703 int stretch_ascent = (((it->ascent + it->descent) 21703 int stretch_ascent = (((it->ascent + it->descent)