aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJuanma Barranquero2019-09-21 00:27:53 +0200
committerJuanma Barranquero2019-09-21 00:27:53 +0200
commit11432322650830fe9ae365f4113733a79226056d (patch)
tree8407cb164d05196ac5eaeaa82fc69917877a008e
parent80b53a3b8dcc28d18ac9a7adacf377ebe6d23ffe (diff)
downloademacs-11432322650830fe9ae365f4113733a79226056d.tar.gz
emacs-11432322650830fe9ae365f4113733a79226056d.zip
lisp/*.el: Fix typos and other trivial doc fixes
* lisp/allout-widgets.el (allout-widgets-auto-activation) (allout-current-decorated-p): * lisp/auth-source.el (auth-source-protocols): * lisp/autorevert.el (auto-revert-set-timer): * lisp/battery.el (battery-mode-line-limit): * lisp/calc/calcalg3.el (math-map-binop): * lisp/calendar/cal-dst.el (calendar-dst-find-startend): * lisp/calendar/cal-mayan.el (calendar-mayan-long-count-to-absolute): * lisp/calendar/calendar.el (calendar-date-echo-text) (calendar-generate-month, calendar-string-spread) (calendar-cursor-to-date, calendar-read, calendar-read-date) (calendar-mark-visible-date, calendar-dayname-on-or-before): * lisp/calendar/diary-lib.el (diary-ordinal-suffix): * lisp/cedet/ede/autoconf-edit.el (autoconf-new-program) (autoconf-find-last-macro, autoconf-parameter-strip): * lisp/cedet/ede/config.el (ede-target-with-config-build): * lisp/cedet/ede/linux.el (ede-linux--detect-architecture) (ede-linux--get-architecture): * lisp/cedet/semantic/complete.el (semantic-collector-calculate-cache) (semantic-displayer-abstract, semantic-displayer-point-position): * lisp/cedet/semantic/format.el (semantic-format-face-alist) (semantic-format-tag-short-doc): * lisp/cedet/semantic/fw.el (semantic-find-file-noselect): * lisp/cedet/semantic/idle.el (semantic-idle-scheduler-work-idle-time) (semantic-idle-breadcrumbs-display-function) (semantic-idle-breadcrumbs-format-tag-list-function): * lisp/cedet/semantic/lex.el (semantic-lex-map-types) (define-lex, define-lex-block-type-analyzer): * lisp/cedet/semantic/senator.el (senator-search-default-tag-filter): * lisp/cedet/semantic/symref.el (semantic-symref-result) (semantic-symref-hit-to-tag-via-db): * lisp/cedet/semantic/symref.el (semantic-symref-tool-baseclass): * lisp/cedet/semantic/tag.el (semantic-tag-new-variable) (semantic-tag-new-include, semantic-tag-new-package) (semantic-tag-set-faux, semantic-create-tag-proxy) (semantic-tag-function-parent) (semantic-tag-components-with-overlays): * lisp/cedet/srecode/cpp.el (srecode-cpp-namespaces) (srecode-semantic-handle-:c, srecode-semantic-apply-tag-to-dict): * lisp/cedet/srecode/dictionary.el (srecode-create-dictionary) (srecode-dictionary-add-entries, srecode-dictionary-lookup-name) (srecode-create-dictionaries-from-tags): * lisp/cmuscheme.el (scheme-compile-region): * lisp/color.el (color-lab-to-lch): * lisp/doc-view.el (doc-view-image-width) (doc-view-set-up-single-converter): * lisp/dynamic-setting.el (font-setting-change-default-font) (dynamic-setting-handle-config-changed-event): * lisp/elec-pair.el (electric-pair-text-pairs) (electric-pair-skip-whitespace-function) (electric-pair-string-bound-function): * lisp/emacs-lisp/avl-tree.el (avl-tree--del-balance) (avl-tree-member, avl-tree-mapcar, avl-tree-iter): * lisp/emacs-lisp/bytecomp.el (byte-compile-generate-call-tree): * lisp/emacs-lisp/checkdoc.el (checkdoc-autofix-flag) (checkdoc-spellcheck-documentation-flag, checkdoc-ispell) (checkdoc-ispell-current-buffer, checkdoc-ispell-interactive) (checkdoc-ispell-message-interactive) (checkdoc-ispell-message-text, checkdoc-ispell-start) (checkdoc-ispell-continue, checkdoc-ispell-comments) (checkdoc-ispell-defun): * lisp/emacs-lisp/cl-generic.el (cl--generic-search-method): * lisp/emacs-lisp/eieio-custom.el (eieio-read-customization-group): * lisp/emacs-lisp/lisp.el (forward-sexp, up-list): * lisp/emacs-lisp/package-x.el (package--archive-contents-from-file): * lisp/emacs-lisp/package.el (package-desc) (package--make-autoloads-and-stuff, package-hidden-regexps): * lisp/emacs-lisp/tcover-ses.el (ses-exercise-startup): * lisp/emacs-lisp/testcover.el (testcover-nohits) (testcover-1value): * lisp/epg.el (epg-receive-keys, epg-start-edit-key): * lisp/erc/erc-backend.el (erc-server-processing-p) (erc-split-line-length, erc-server-coding-system) (erc-server-send, erc-message): * lisp/erc/erc-button.el (erc-button-face, erc-button-alist) (erc-browse-emacswiki): * lisp/erc/erc-ezbounce.el (erc-ezbounce, erc-ezb-get-login): * lisp/erc/erc-fill.el (erc-fill-variable-maximum-indentation): * lisp/erc/erc-log.el (erc-current-logfile): * lisp/erc/erc-match.el (erc-log-match-format) (erc-text-matched-hook): * lisp/erc/erc-netsplit.el (erc-netsplit, erc-netsplit-debug): * lisp/erc/erc-networks.el (erc-server-alist) (erc-networks-alist, erc-current-network): * lisp/erc/erc-ring.el (erc-input-ring-index): * lisp/erc/erc-speedbar.el (erc-speedbar) (erc-speedbar-update-channel): * lisp/erc/erc-stamp.el (erc-timestamp-only-if-changed-flag): * lisp/erc/erc-track.el (erc-track-position-in-mode-line) (erc-track-remove-from-mode-line, erc-modified-channels-update) (erc-track-last-non-erc-buffer, erc-track-sort-by-importance) (erc-track-get-active-buffer): * lisp/erc/erc.el (erc-get-channel-user-list) (erc-echo-notice-hook, erc-echo-notice-always-hook) (erc-wash-quit-reason, erc-format-@nick): * lisp/ffap.el (ffap-latex-mode): * lisp/files.el (abort-if-file-too-large) (dir-locals--get-sort-score, buffer-stale--default-function): * lisp/filesets.el (filesets-tree-max-level, filesets-data) (filesets-update-pre010505): * lisp/gnus/gnus-agent.el (gnus-agent-flush-cache): * lisp/gnus/gnus-art.el (gnus-article-encrypt-protocol) (gnus-button-prefer-mid-or-mail): * lisp/gnus/gnus-cus.el (gnus-group-parameters): * lisp/gnus/gnus-demon.el (gnus-demon-handlers) (gnus-demon-run-callback): * lisp/gnus/gnus-dired.el (gnus-dired-print): * lisp/gnus/gnus-icalendar.el (gnus-icalendar-event-from-buffer): * lisp/gnus/gnus-range.el (gnus-range-normalize): * lisp/gnus/gnus-spec.el (gnus-pad-form): * lisp/gnus/gnus-srvr.el (gnus-server-agent, gnus-server-cloud) (gnus-server-opened, gnus-server-closed, gnus-server-denied) (gnus-server-offline): * lisp/gnus/gnus-sum.el (gnus-refer-thread-use-nnir) (gnus-refer-thread-limit-to-thread) (gnus-summary-limit-include-thread, gnus-summary-refer-thread) (gnus-summary-find-matching): * lisp/gnus/gnus-util.el (gnus-rescale-image): * lisp/gnus/gnus.el (gnus-summary-line-format, gnus-no-server): * lisp/gnus/mail-source.el (mail-source-incoming-file-prefix): * lisp/gnus/message.el (message-cite-reply-position) (message-cite-style-outlook, message-cite-style-thunderbird) (message-cite-style-gmail, message--send-mail-maybe-partially): * lisp/gnus/mm-extern.el (mm-inline-external-body): * lisp/gnus/mm-partial.el (mm-inline-partial): * lisp/gnus/mml-sec.el (mml-secure-message-sign) (mml-secure-message-sign-encrypt, mml-secure-message-encrypt): * lisp/gnus/mml2015.el (mml2015-epg-key-image) (mml2015-epg-key-image-to-string): * lisp/gnus/nndiary.el (nndiary-reminders, nndiary-get-new-mail): * lisp/gnus/nnheader.el (nnheader-directory-files-is-safe): * lisp/gnus/nnir.el (nnir-search-history) (nnir-imap-search-other, nnir-artlist-length) (nnir-artlist-article, nnir-artitem-group, nnir-artitem-number) (nnir-artitem-rsv, nnir-article-group, nnir-article-number) (nnir-article-rsv, nnir-article-ids, nnir-categorize) (nnir-retrieve-headers-override-function) (nnir-imap-default-search-key, nnir-hyrex-additional-switches) (gnus-group-make-nnir-group, nnir-run-namazu, nnir-read-parms) (nnir-read-parm, nnir-read-server-parm, nnir-search-thread): * lisp/gnus/nnmairix.el (nnmairix-default-group) (nnmairix-propagate-marks): * lisp/gnus/smime.el (smime-keys, smime-crl-check) (smime-verify-buffer, smime-noverify-buffer): * lisp/gnus/spam-report.el (spam-report-url-ping-mm-url): * lisp/gnus/spam.el (spam-spamassassin-positive-spam-flag-header) (spam-spamassassin-spam-status-header, spam-sa-learn-rebuild) (spam-classifications, spam-check-stat, spam-spamassassin-score): * lisp/help.el (describe-minor-mode-from-symbol): * lisp/hippie-exp.el (hippie-expand-ignore-buffers): * lisp/htmlfontify.el (hfy-optimizations, hfy-face-resolve-face) (hfy-begin-span): * lisp/ibuf-ext.el (ibuffer-update-saved-filters-format) (ibuffer-saved-filters, ibuffer-old-saved-filters-warning) (ibuffer-filtering-qualifiers, ibuffer-repair-saved-filters) (eval, ibuffer-unary-operand, file-extension, directory): * lisp/image-dired.el (image-dired-cmd-pngcrush-options): * lisp/image-mode.el (image-toggle-display): * lisp/international/ccl.el (ccl-compile-read-multibyte-character) (ccl-compile-write-multibyte-character): * lisp/international/kkc.el (kkc-save-init-file): * lisp/international/latin1-disp.el (latin1-display): * lisp/international/ogonek.el (ogonek-name-encoding-alist) (ogonek-information, ogonek-lookup-encoding) (ogonek-deprefixify-region): * lisp/isearch.el (isearch-filter-predicate) (isearch--momentary-message): * lisp/jsonrpc.el (jsonrpc-connection-send) (jsonrpc-process-connection, jsonrpc-shutdown) (jsonrpc--async-request-1): * lisp/language/tibet-util.el (tibetan-char-p): * lisp/mail/feedmail.el (feedmail-queue-use-send-time-for-date) (feedmail-last-chance-hook, feedmail-before-fcc-hook) (feedmail-send-it-immediately-wrapper, feedmail-find-eoh): * lisp/mail/hashcash.el (hashcash-generate-payment) (hashcash-generate-payment-async, hashcash-insert-payment) (hashcash-verify-payment): * lisp/mail/rmail.el (rmail-movemail-variant-in-use) (rmail-get-attr-value): * lisp/mail/rmailmm.el (rmail-mime-prefer-html, rmail-mime): * lisp/mail/rmailsum.el (rmail-summary-show-message): * lisp/mail/supercite.el (sc-raw-mode-toggle): * lisp/man.el (Man-start-calling): * lisp/mh-e/mh-acros.el (mh-do-at-event-location) (mh-iterate-on-messages-in-region, mh-iterate-on-range): * lisp/mh-e/mh-alias.el (mh-alias-system-aliases) (mh-alias-reload, mh-alias-ali) (mh-alias-canonicalize-suggestion, mh-alias-add-alias-to-file) (mh-alias-add-alias): * lisp/mouse.el (mouse-save-then-kill): * lisp/net/browse-url.el (browse-url-default-macosx-browser): * lisp/net/eudc.el (eudc-set, eudc-variable-protocol-value) (eudc-variable-server-value, eudc-update-variable) (eudc-expand-inline): * lisp/net/eudcb-bbdb.el (eudc-bbdb-format-record-as-result): * lisp/net/eudcb-ldap.el (eudc-ldap-get-field-list): * lisp/net/pop3.el (pop3-list): * lisp/net/soap-client.el (soap-namespace-put) (soap-xs-parse-sequence, soap-parse-envelope): * lisp/net/soap-inspect.el (soap-inspect-xs-complex-type): * lisp/nxml/rng-xsd.el (rng-xsd-date-to-days): * lisp/org/ob-C.el (org-babel-prep-session:C) (org-babel-load-session:C): * lisp/org/ob-J.el (org-babel-execute:J): * lisp/org/ob-asymptote.el (org-babel-prep-session:asymptote): * lisp/org/ob-awk.el (org-babel-execute:awk): * lisp/org/ob-core.el (org-babel-process-file-name): * lisp/org/ob-ebnf.el (org-babel-execute:ebnf): * lisp/org/ob-forth.el (org-babel-execute:forth): * lisp/org/ob-fortran.el (org-babel-execute:fortran) (org-babel-prep-session:fortran, org-babel-load-session:fortran): * lisp/org/ob-groovy.el (org-babel-execute:groovy): * lisp/org/ob-io.el (org-babel-execute:io): * lisp/org/ob-js.el (org-babel-execute:js): * lisp/org/ob-lilypond.el (org-babel-default-header-args:lilypond) (org-babel-lilypond-compile-post-tangle) (org-babel-lilypond-display-pdf-post-tangle) (org-babel-lilypond-tangle) (org-babel-lilypond-execute-tangled-ly) (org-babel-lilypond-compile-lilyfile) (org-babel-lilypond-check-for-compile-error) (org-babel-lilypond-process-compile-error) (org-babel-lilypond-mark-error-line) (org-babel-lilypond-parse-error-line) (org-babel-lilypond-attempt-to-open-pdf) (org-babel-lilypond-attempt-to-play-midi) (org-babel-lilypond-switch-extension) (org-babel-lilypond-set-header-args): * lisp/org/ob-lua.el (org-babel-prep-session:lua): * lisp/org/ob-picolisp.el (org-babel-execute:picolisp): * lisp/org/ob-processing.el (org-babel-prep-session:processing): * lisp/org/ob-python.el (org-babel-prep-session:python): * lisp/org/ob-scheme.el (org-babel-scheme-capture-current-message) (org-babel-scheme-execute-with-geiser, org-babel-execute:scheme): * lisp/org/ob-shen.el (org-babel-execute:shen): * lisp/org/org-agenda.el (org-agenda-entry-types) (org-agenda-move-date-from-past-immediately-to-today) (org-agenda-time-grid, org-agenda-sorting-strategy) (org-agenda-filter-by-category, org-agenda-forward-block): * lisp/org/org-colview.el (org-columns--overlay-text): * lisp/org/org-faces.el (org-verbatim, org-cycle-level-faces): * lisp/org/org-indent.el (org-indent-set-line-properties): * lisp/org/org-macs.el (org-get-limited-outline-regexp): * lisp/org/org-mobile.el (org-mobile-files): * lisp/org/org.el (org-use-fast-todo-selection) (org-extend-today-until, org-use-property-inheritance) (org-refresh-effort-properties, org-open-at-point-global) (org-track-ordered-property-with-tag, org-shiftright): * lisp/org/ox-html.el (org-html-checkbox-type): * lisp/org/ox-man.el (org-man-source-highlight) (org-man-verse-block): * lisp/org/ox-publish.el (org-publish-sitemap-default): * lisp/outline.el (outline-head-from-level): * lisp/progmodes/dcl-mode.el (dcl-back-to-indentation-1) (dcl-calc-command-indent, dcl-indent-to): * lisp/progmodes/flymake.el (flymake-make-diagnostic) (flymake--overlays, flymake-diagnostic-functions) (flymake-diagnostic-types-alist, flymake--backend-state) (flymake-is-running, flymake--collect, flymake-mode): * lisp/progmodes/gdb-mi.el (gdb-threads-list, gdb, gdb-non-stop) (gdb-buffers, gdb-gud-context-call, gdb-jsonify-buffer): * lisp/progmodes/grep.el (grep-error-screen-columns): * lisp/progmodes/gud.el (gud-prev-expr): * lisp/progmodes/ps-mode.el (ps-mode, ps-mode-target-column) (ps-run-goto-error): * lisp/progmodes/python.el (python-eldoc-get-doc) (python-eldoc-function-timeout-permanent, python-eldoc-function): * lisp/shadowfile.el (shadow-make-group): * lisp/speedbar.el (speedbar-obj-do-check): * lisp/textmodes/flyspell.el (flyspell-auto-correct-previous-hook): * lisp/textmodes/reftex-cite.el (reftex-bib-or-thebib): * lisp/textmodes/reftex-index.el (reftex-index-goto-entry) (reftex-index-kill, reftex-index-undo): * lisp/textmodes/reftex-parse.el (reftex-context-substring): * lisp/textmodes/reftex.el (reftex-TeX-master-file): * lisp/textmodes/rst.el (rst-next-hdr, rst-toc) (rst-uncomment-region, rst-font-lock-extend-region-internal): * lisp/thumbs.el (thumbs-mode): * lisp/vc/ediff-util.el (ediff-restore-diff): * lisp/vc/pcvs-defs.el (cvs-cvsroot, cvs-force-dir-tag): * lisp/vc/vc-hg.el (vc-hg--ignore-patterns-valid-p): * lisp/wid-edit.el (widget-field-value-set, string): * lisp/x-dnd.el (x-dnd-version-from-flags) (x-dnd-more-than-3-from-flags): Assorted docfixes.
-rw-r--r--lisp/allout-widgets.el4
-rw-r--r--lisp/auth-source.el2
-rw-r--r--lisp/autorevert.el2
-rw-r--r--lisp/battery.el2
-rw-r--r--lisp/calc/calcalg3.el2
-rw-r--r--lisp/calendar/cal-dst.el2
-rw-r--r--lisp/calendar/cal-mayan.el2
-rw-r--r--lisp/calendar/calendar.el45
-rw-r--r--lisp/calendar/diary-lib.el2
-rw-r--r--lisp/cedet/ede/autoconf-edit.el6
-rw-r--r--lisp/cedet/ede/config.el2
-rw-r--r--lisp/cedet/ede/linux.el8
-rw-r--r--lisp/cedet/semantic/complete.el6
-rw-r--r--lisp/cedet/semantic/format.el4
-rw-r--r--lisp/cedet/semantic/fw.el2
-rw-r--r--lisp/cedet/semantic/idle.el22
-rw-r--r--lisp/cedet/semantic/lex.el6
-rw-r--r--lisp/cedet/semantic/senator.el2
-rw-r--r--lisp/cedet/semantic/symref.el6
-rw-r--r--lisp/cedet/semantic/tag.el22
-rw-r--r--lisp/cedet/srecode/cpp.el6
-rw-r--r--lisp/cedet/srecode/dictionary.el18
-rw-r--r--lisp/cmuscheme.el2
-rw-r--r--lisp/color.el4
-rw-r--r--lisp/doc-view.el4
-rw-r--r--lisp/dynamic-setting.el8
-rw-r--r--lisp/elec-pair.el6
-rw-r--r--lisp/emacs-lisp/avl-tree.el22
-rw-r--r--lisp/emacs-lisp/bytecomp.el16
-rw-r--r--lisp/emacs-lisp/checkdoc.el26
-rw-r--r--lisp/emacs-lisp/cl-generic.el4
-rw-r--r--lisp/emacs-lisp/eieio-custom.el2
-rw-r--r--lisp/emacs-lisp/lisp.el6
-rw-r--r--lisp/emacs-lisp/package-x.el2
-rw-r--r--lisp/emacs-lisp/package.el8
-rw-r--r--lisp/emacs-lisp/tcover-ses.el2
-rw-r--r--lisp/emacs-lisp/testcover.el4
-rw-r--r--lisp/epg.el4
-rw-r--r--lisp/erc/erc-backend.el12
-rw-r--r--lisp/erc/erc-button.el8
-rw-r--r--lisp/erc/erc-ezbounce.el4
-rw-r--r--lisp/erc/erc-fill.el2
-rw-r--r--lisp/erc/erc-log.el2
-rw-r--r--lisp/erc/erc-match.el6
-rw-r--r--lisp/erc/erc-netsplit.el9
-rw-r--r--lisp/erc/erc-networks.el22
-rw-r--r--lisp/erc/erc-ring.el2
-rw-r--r--lisp/erc/erc-speedbar.el6
-rw-r--r--lisp/erc/erc-stamp.el2
-rw-r--r--lisp/erc/erc-track.el14
-rw-r--r--lisp/erc/erc.el10
-rw-r--r--lisp/ffap.el2
-rw-r--r--lisp/files.el12
-rw-r--r--lisp/filesets.el23
-rw-r--r--lisp/gnus/gnus-agent.el6
-rw-r--r--lisp/gnus/gnus-art.el4
-rw-r--r--lisp/gnus/gnus-cus.el2
-rw-r--r--lisp/gnus/gnus-demon.el6
-rw-r--r--lisp/gnus/gnus-dired.el10
-rw-r--r--lisp/gnus/gnus-icalendar.el5
-rw-r--r--lisp/gnus/gnus-range.el2
-rw-r--r--lisp/gnus/gnus-spec.el4
-rw-r--r--lisp/gnus/gnus-srvr.el12
-rw-r--r--lisp/gnus/gnus-sum.el24
-rw-r--r--lisp/gnus/gnus-util.el2
-rw-r--r--lisp/gnus/gnus.el18
-rw-r--r--lisp/gnus/mail-source.el2
-rw-r--r--lisp/gnus/message.el14
-rw-r--r--lisp/gnus/mm-extern.el2
-rw-r--r--lisp/gnus/mm-partial.el2
-rw-r--r--lisp/gnus/mml-sec.el6
-rw-r--r--lisp/gnus/mml2015.el4
-rw-r--r--lisp/gnus/nndiary.el4
-rw-r--r--lisp/gnus/nnheader.el2
-rw-r--r--lisp/gnus/nnir.el55
-rw-r--r--lisp/gnus/nnmairix.el4
-rw-r--r--lisp/gnus/smime.el8
-rw-r--r--lisp/gnus/spam-report.el6
-rw-r--r--lisp/gnus/spam.el12
-rw-r--r--lisp/help.el2
-rw-r--r--lisp/hippie-exp.el2
-rw-r--r--lisp/htmlfontify.el8
-rw-r--r--lisp/ibuf-ext.el40
-rw-r--r--lisp/image-dired.el2
-rw-r--r--lisp/image-mode.el2
-rw-r--r--lisp/international/ccl.el4
-rw-r--r--lisp/international/kkc.el2
-rw-r--r--lisp/international/latin1-disp.el2
-rw-r--r--lisp/international/ogonek.el26
-rw-r--r--lisp/isearch.el6
-rw-r--r--lisp/jsonrpc.el12
-rw-r--r--lisp/language/tibet-util.el2
-rw-r--r--lisp/mail/feedmail.el14
-rw-r--r--lisp/mail/hashcash.el8
-rw-r--r--lisp/mail/rmail.el4
-rw-r--r--lisp/mail/rmailmm.el6
-rw-r--r--lisp/mail/rmailsum.el2
-rw-r--r--lisp/mail/supercite.el2
-rw-r--r--lisp/man.el2
-rw-r--r--lisp/mh-e/mh-acros.el8
-rw-r--r--lisp/mh-e/mh-alias.el27
-rw-r--r--lisp/mouse.el2
-rw-r--r--lisp/net/browse-url.el2
-rw-r--r--lisp/net/eudc.el10
-rw-r--r--lisp/net/eudcb-bbdb.el2
-rw-r--r--lisp/net/eudcb-ldap.el2
-rw-r--r--lisp/net/pop3.el2
-rw-r--r--lisp/net/soap-client.el6
-rw-r--r--lisp/net/soap-inspect.el2
-rw-r--r--lisp/nxml/rng-xsd.el2
-rw-r--r--lisp/org/ob-C.el4
-rw-r--r--lisp/org/ob-J.el2
-rw-r--r--lisp/org/ob-asymptote.el2
-rw-r--r--lisp/org/ob-awk.el4
-rw-r--r--lisp/org/ob-core.el2
-rw-r--r--lisp/org/ob-ebnf.el4
-rw-r--r--lisp/org/ob-forth.el2
-rw-r--r--lisp/org/ob-fortran.el6
-rw-r--r--lisp/org/ob-groovy.el4
-rw-r--r--lisp/org/ob-io.el4
-rw-r--r--lisp/org/ob-js.el2
-rw-r--r--lisp/org/ob-lilypond.el45
-rw-r--r--lisp/org/ob-lua.el2
-rw-r--r--lisp/org/ob-picolisp.el4
-rw-r--r--lisp/org/ob-processing.el2
-rw-r--r--lisp/org/ob-python.el2
-rw-r--r--lisp/org/ob-ruby.el2
-rw-r--r--lisp/org/ob-scheme.el11
-rw-r--r--lisp/org/ob-shen.el2
-rw-r--r--lisp/org/org-agenda.el45
-rw-r--r--lisp/org/org-colview.el2
-rw-r--r--lisp/org/org-faces.el6
-rw-r--r--lisp/org/org-indent.el2
-rw-r--r--lisp/org/org-macs.el2
-rw-r--r--lisp/org/org-mobile.el2
-rw-r--r--lisp/org/org.el14
-rw-r--r--lisp/org/ox-html.el2
-rw-r--r--lisp/org/ox-latex.el2
-rw-r--r--lisp/org/ox-man.el4
-rw-r--r--lisp/org/ox-publish.el2
-rw-r--r--lisp/outline.el6
-rw-r--r--lisp/progmodes/cc-engine.el2
-rw-r--r--lisp/progmodes/dcl-mode.el7
-rw-r--r--lisp/progmodes/flymake.el24
-rw-r--r--lisp/progmodes/gdb-mi.el12
-rw-r--r--lisp/progmodes/grep.el2
-rw-r--r--lisp/progmodes/gud.el2
-rw-r--r--lisp/progmodes/perl-mode.el2
-rw-r--r--lisp/progmodes/ps-mode.el6
-rw-r--r--lisp/progmodes/python.el6
-rw-r--r--lisp/shadowfile.el2
-rw-r--r--lisp/speedbar.el2
-rw-r--r--lisp/textmodes/flyspell.el2
-rw-r--r--lisp/textmodes/reftex-cite.el2
-rw-r--r--lisp/textmodes/reftex-index.el6
-rw-r--r--lisp/textmodes/reftex-parse.el2
-rw-r--r--lisp/textmodes/reftex.el2
-rw-r--r--lisp/textmodes/rst.el8
-rw-r--r--lisp/thumbs.el2
-rw-r--r--lisp/vc/ediff-util.el2
-rw-r--r--lisp/vc/pcvs-defs.el6
-rw-r--r--lisp/vc/vc-hg.el2
-rw-r--r--lisp/wid-edit.el4
-rw-r--r--lisp/x-dnd.el4
164 files changed, 584 insertions, 578 deletions
diff --git a/lisp/allout-widgets.el b/lisp/allout-widgets.el
index e4a8db8a628..3f5621fa349 100644
--- a/lisp/allout-widgets.el
+++ b/lisp/allout-widgets.el
@@ -132,7 +132,7 @@ Also enable `allout-auto-activation' for this to take effect upon
132visiting an outline. 132visiting an outline.
133 133
134When this is set you can disable allout widgets in select files 134When this is set you can disable allout widgets in select files
135by setting `allout-widgets-mode-inhibit' 135by setting `allout-widgets-mode-inhibit'.
136 136
137Instead of setting `allout-widgets-auto-activation' you can 137Instead of setting `allout-widgets-auto-activation' you can
138explicitly invoke `allout-widgets-mode' in allout buffers where 138explicitly invoke `allout-widgets-mode' in allout buffers where
@@ -867,7 +867,7 @@ Optional RECURSING is for internal use, to limit recursion."
867 ) 867 )
868;;;_ > allout-current-decorated-p () 868;;;_ > allout-current-decorated-p ()
869(defun allout-current-decorated-p () 869(defun allout-current-decorated-p ()
870 "True if the current item is not decorated" 870 "True if the current item is not decorated."
871 (save-excursion 871 (save-excursion
872 (if (allout-back-to-current-heading) 872 (if (allout-back-to-current-heading)
873 (if (> allout-recent-depth 0) 873 (if (> allout-recent-depth 0)
diff --git a/lisp/auth-source.el b/lisp/auth-source.el
index 464facdeafa..2164a550b0a 100644
--- a/lisp/auth-source.el
+++ b/lisp/auth-source.el
@@ -136,7 +136,7 @@ let-binding."
136 (ssh "ssh" "22") 136 (ssh "ssh" "22")
137 (sftp "sftp" "115") 137 (sftp "sftp" "115")
138 (smtp "smtp" "25")) 138 (smtp "smtp" "25"))
139 "List of authentication protocols and their names" 139 "List of authentication protocols and their names."
140 140
141 :version "23.2" ;; No Gnus 141 :version "23.2" ;; No Gnus
142 :type '(repeat :tag "Authentication Protocols" 142 :type '(repeat :tag "Authentication Protocols"
diff --git a/lisp/autorevert.el b/lisp/autorevert.el
index 6cdc1d3a297..9275513c8d2 100644
--- a/lisp/autorevert.el
+++ b/lisp/autorevert.el
@@ -616,7 +616,7 @@ Called after `set-visited-file-name'."
616If such a timer is active, cancel it. Start a new timer if 616If such a timer is active, cancel it. Start a new timer if
617Global Auto-Revert Mode is active or if Auto-Revert Mode is active 617Global Auto-Revert Mode is active or if Auto-Revert Mode is active
618in some buffer. Restarting the timer ensures that Auto-Revert Mode 618in some buffer. Restarting the timer ensures that Auto-Revert Mode
619will use an up-to-date value of `auto-revert-interval'" 619will use an up-to-date value of `auto-revert-interval'."
620 (interactive) 620 (interactive)
621 (if (timerp auto-revert-timer) 621 (if (timerp auto-revert-timer)
622 (cancel-timer auto-revert-timer)) 622 (cancel-timer auto-revert-timer))
diff --git a/lisp/battery.el b/lisp/battery.el
index 0ef6d37b406..2319ce73bbb 100644
--- a/lisp/battery.el
+++ b/lisp/battery.el
@@ -113,7 +113,7 @@ string are substituted as defined by the current value of the variable
113;;;###autoload (put 'battery-mode-line-string 'risky-local-variable t) 113;;;###autoload (put 'battery-mode-line-string 'risky-local-variable t)
114 114
115(defcustom battery-mode-line-limit 100 115(defcustom battery-mode-line-limit 100
116 "Percentage of full battery load below which display battery status" 116 "Percentage of full battery load below which display battery status."
117 :version "24.1" 117 :version "24.1"
118 :type 'integer 118 :type 'integer
119 :group 'battery) 119 :group 'battery)
diff --git a/lisp/calc/calcalg3.el b/lisp/calc/calcalg3.el
index 8015b8ed7c1..229edc77c79 100644
--- a/lisp/calc/calcalg3.el
+++ b/lisp/calc/calcalg3.el
@@ -40,7 +40,7 @@
40 40
41 41
42(defun math-map-binop (binop args1 args2) 42(defun math-map-binop (binop args1 args2)
43 "Apply BINOP to the elements of the lists ARGS1 and ARGS2" 43 "Apply BINOP to the elements of the lists ARGS1 and ARGS2."
44 (if args1 44 (if args1
45 (cons 45 (cons
46 (funcall binop (car args1) (car args2)) 46 (funcall binop (car args1) (car args2))
diff --git a/lisp/calendar/cal-dst.el b/lisp/calendar/cal-dst.el
index 2d3b1f8c818..355f72cd15f 100644
--- a/lisp/calendar/cal-dst.el
+++ b/lisp/calendar/cal-dst.el
@@ -276,7 +276,7 @@ function `calendar-dst-find-startend'.")
276 "Find the dates in YEAR on which daylight saving time starts and ends. 276 "Find the dates in YEAR on which daylight saving time starts and ends.
277Returns a list (YEAR START END), where START and END are 277Returns a list (YEAR START END), where START and END are
278expressions that when evaluated return the start and end dates, 278expressions that when evaluated return the start and end dates,
279respectively. This function first attempts to use pre-calculated 279respectively. This function first attempts to use pre-calculated
280data from `calendar-dst-transition-cache', otherwise it calls 280data from `calendar-dst-transition-cache', otherwise it calls
281`calendar-dst-find-data' (and adds the results to the cache). 281`calendar-dst-find-data' (and adds the results to the cache).
282If dates in YEAR cannot be handled by `encode-time' (e.g., 282If dates in YEAR cannot be handled by `encode-time' (e.g.,
diff --git a/lisp/calendar/cal-mayan.el b/lisp/calendar/cal-mayan.el
index cda2c888f22..1ac0ac750a5 100644
--- a/lisp/calendar/cal-mayan.el
+++ b/lisp/calendar/cal-mayan.el
@@ -314,7 +314,7 @@ Echo Mayan date unless NOECHO is non-nil."
314 314
315(defun calendar-mayan-long-count-to-absolute (c) 315(defun calendar-mayan-long-count-to-absolute (c)
316 "Compute the absolute date corresponding to the Mayan Long Count C. 316 "Compute the absolute date corresponding to the Mayan Long Count C.
317Long count is a list (baktun katun tun uinal kin)" 317Long count is a list (baktun katun tun uinal kin)."
318 (+ (* (nth 0 c) 144000) ; baktun 318 (+ (* (nth 0 c) 144000) ; baktun
319 (* (nth 1 c) 7200) ; katun 319 (* (nth 1 c) 7200) ; katun
320 (* (nth 2 c) 360) ; tun 320 (* (nth 2 c) 360) ; tun
diff --git a/lisp/calendar/calendar.el b/lisp/calendar/calendar.el
index e7a7bd47d61..43a8e8e38d4 100644
--- a/lisp/calendar/calendar.el
+++ b/lisp/calendar/calendar.el
@@ -409,6 +409,7 @@ display the ISO date:
409 (setq calendar-date-echo-text \\='(format \"ISO date: %s\" 409 (setq calendar-date-echo-text \\='(format \"ISO date: %s\"
410 (calendar-iso-date-string 410 (calendar-iso-date-string
411 (list month day year)))) 411 (list month day year))))
412
412Changing this variable without using customize has no effect on 413Changing this variable without using customize has no effect on
413pre-existing calendar windows." 414pre-existing calendar windows."
414 :group 'calendar 415 :group 'calendar
@@ -1471,10 +1472,10 @@ STRING to length TRUNCATE, and ensures a trailing space."
1471 1472
1472(defun calendar-generate-month (month year indent) 1473(defun calendar-generate-month (month year indent)
1473 "Produce a calendar for MONTH, YEAR on the Gregorian calendar. 1474 "Produce a calendar for MONTH, YEAR on the Gregorian calendar.
1474The calendar is inserted at the top of the buffer in which point is currently 1475The calendar is inserted at the top of the buffer in which point is
1475located, but indented INDENT spaces. The indentation is done from the first 1476currently located, but indented INDENT spaces. The indentation is
1476character on the line and does not disturb the first INDENT characters on the 1477done from the first character on the line and does not disturb the
1477line." 1478first INDENT characters on the line."
1478 (let ((blank-days ; at start of month 1479 (let ((blank-days ; at start of month
1479 (mod 1480 (mod
1480 (- (calendar-day-of-week (list month 1 year)) 1481 (- (calendar-day-of-week (list month 1 year))
@@ -1792,10 +1793,11 @@ For a complete description, see the info node `Calendar/Diary'.
1792 1793
1793(defun calendar-string-spread (strings char length) 1794(defun calendar-string-spread (strings char length)
1794 "Concatenate list of STRINGS separated with copies of CHAR to fill LENGTH. 1795 "Concatenate list of STRINGS separated with copies of CHAR to fill LENGTH.
1795The effect is like `mapconcat' but the separating pieces are as balanced as 1796The effect is like `mapconcat' but the separating pieces are as
1796possible. Each item of STRINGS is evaluated before concatenation so it can 1797balanced as possible. Each item of STRINGS is evaluated before
1797actually be an expression that evaluates to a string. If LENGTH is too short, 1798concatenation so it can actually be an expression that evaluates
1798the STRINGS are just concatenated and the result truncated." 1799to a string. If LENGTH is too short, the STRINGS are just
1800concatenated and the result truncated."
1799 ;; The algorithm is based on equation (3.25) on page 85 of Concrete 1801 ;; The algorithm is based on equation (3.25) on page 85 of Concrete
1800 ;; Mathematics by Ronald L. Graham, Donald E. Knuth, and Oren Patashnik, 1802 ;; Mathematics by Ronald L. Graham, Donald E. Knuth, and Oren Patashnik,
1801 ;; Addison-Wesley, Reading, MA, 1989. 1803 ;; Addison-Wesley, Reading, MA, 1989.
@@ -1889,8 +1891,8 @@ The left-most month returns 0, the next right 1, and so on."
1889 1891
1890(defun calendar-cursor-to-date (&optional error event) 1892(defun calendar-cursor-to-date (&optional error event)
1891 "Return a list (month day year) of current cursor position. 1893 "Return a list (month day year) of current cursor position.
1892If cursor is not on a specific date, signals an error if optional parameter 1894If cursor is not on a specific date, signals an error if optional
1893ERROR is non-nil, otherwise just returns nil. 1895parameter ERROR is non-nil, otherwise just returns nil.
1894If EVENT is non-nil, it's an event indicating the buffer position to 1896If EVENT is non-nil, it's an event indicating the buffer position to
1895use instead of point." 1897use instead of point."
1896 (with-current-buffer 1898 (with-current-buffer
@@ -2046,9 +2048,9 @@ With argument ARG, jump to mark, pop it, and put point at end of ring."
2046 2048
2047(defun calendar-read (prompt acceptable &optional initial-contents) 2049(defun calendar-read (prompt acceptable &optional initial-contents)
2048 "Return an object read from the minibuffer. 2050 "Return an object read from the minibuffer.
2049Prompt with the string PROMPT and use the function ACCEPTABLE to decide if 2051Prompt with the string PROMPT and use the function ACCEPTABLE to decide
2050entered item is acceptable. If non-nil, optional third arg INITIAL-CONTENTS 2052if entered item is acceptable. If non-nil, optional third arg
2051is a string to insert in the minibuffer before reading." 2053INITIAL-CONTENTS is a string to insert in the minibuffer before reading."
2052 (let ((value (read-minibuffer prompt initial-contents))) 2054 (let ((value (read-minibuffer prompt initial-contents)))
2053 (while (not (funcall acceptable value)) 2055 (while (not (funcall acceptable value))
2054 (setq value (read-minibuffer prompt initial-contents))) 2056 (setq value (read-minibuffer prompt initial-contents)))
@@ -2277,8 +2279,8 @@ arguments SEQUENCES."
2277(defun calendar-read-date (&optional noday) 2279(defun calendar-read-date (&optional noday)
2278 "Prompt for Gregorian date. Return a list (month day year). 2280 "Prompt for Gregorian date. Return a list (month day year).
2279If optional NODAY is t, does not ask for day, but just returns 2281If optional NODAY is t, does not ask for day, but just returns
2280\(month 1 year); if NODAY is any other non-nil value the value returned is 2282\(month 1 year); if NODAY is any other non-nil value the value
2281\(month year)" 2283returned is (month year)."
2282 (let* ((year (calendar-read 2284 (let* ((year (calendar-read
2283 "Year (>0): " 2285 "Year (>0): "
2284 (lambda (x) (> x 0)) 2286 (lambda (x) (> x 0))
@@ -2458,8 +2460,8 @@ ATTRLIST is a list with elements of the form :face face :foreground color."
2458 2460
2459(defun calendar-mark-visible-date (date &optional mark) 2461(defun calendar-mark-visible-date (date &optional mark)
2460 "Mark DATE in the calendar window with MARK. 2462 "Mark DATE in the calendar window with MARK.
2461MARK is a single-character string, a list of face attributes/values, or a face. 2463MARK is a single-character string, a list of face attributes/values,
2462MARK defaults to `diary-entry-marker'." 2464or a face. MARK defaults to `diary-entry-marker'."
2463 (if (calendar-date-is-valid-p date) 2465 (if (calendar-date-is-valid-p date)
2464 (with-current-buffer calendar-buffer 2466 (with-current-buffer calendar-buffer
2465 (save-excursion 2467 (save-excursion
@@ -2538,10 +2540,11 @@ name of the day of the week."
2538 "Return the absolute date of the DAYNAME on or before absolute DATE. 2540 "Return the absolute date of the DAYNAME on or before absolute DATE.
2539DAYNAME=0 means Sunday, DAYNAME=1 means Monday, and so on. 2541DAYNAME=0 means Sunday, DAYNAME=1 means Monday, and so on.
2540 2542
2541Note: Applying this function to d+6 gives us the DAYNAME on or after an 2543Note: Applying this function to d+6 gives us the DAYNAME on or after
2542absolute day d. Similarly, applying it to d+3 gives the DAYNAME nearest to 2544an absolute day d. Similarly, applying it to d+3 gives the DAYNAME
2543absolute date d, applying it to d-1 gives the DAYNAME previous to absolute 2545nearest to absolute date d, applying it to d-1 gives the DAYNAME
2544date d, and applying it to d+7 gives the DAYNAME following absolute date d." 2546previous to absolute date d, and applying it to d+7 gives the DAYNAME
2547following absolute date d."
2545 (- date (% (- date dayname) 7))) 2548 (- date (% (- date dayname) 7)))
2546 2549
2547(defun calendar-nth-named-absday (n dayname month year &optional day) 2550(defun calendar-nth-named-absday (n dayname month year &optional day)
diff --git a/lisp/calendar/diary-lib.el b/lisp/calendar/diary-lib.el
index 5a2374a5957..d783f11e35d 100644
--- a/lisp/calendar/diary-lib.el
+++ b/lisp/calendar/diary-lib.el
@@ -1950,7 +1950,7 @@ highlighting the day in the calendar."
1950 (cons mark entry))))) 1950 (cons mark entry)))))
1951 1951
1952(defun diary-ordinal-suffix (n) 1952(defun diary-ordinal-suffix (n)
1953 "Ordinal suffix for N. (That is, `st', `nd', `rd', or `th', as appropriate.)" 1953 "Ordinal suffix for N. (That is, `st', `nd', `rd', or `th', as appropriate.)"
1954 (if (or (memq (% n 100) '(11 12 13)) 1954 (if (or (memq (% n 100) '(11 12 13))
1955 (< 3 (% n 10))) 1955 (< 3 (% n 10)))
1956 "th" 1956 "th"
diff --git a/lisp/cedet/ede/autoconf-edit.el b/lisp/cedet/ede/autoconf-edit.el
index c243e9bf6df..8918b4eb621 100644
--- a/lisp/cedet/ede/autoconf-edit.el
+++ b/lisp/cedet/ede/autoconf-edit.el
@@ -35,7 +35,7 @@
35ROOTDIR is the root directory of a given autoconf controlled project. 35ROOTDIR is the root directory of a given autoconf controlled project.
36PROGRAM is the program to be configured. 36PROGRAM is the program to be configured.
37TESTFILE is the file used with AC_INIT. 37TESTFILE is the file used with AC_INIT.
38configure the initial configure script using `autoconf-new-automake-string'" 38Configure the initial configure script using `autoconf-new-automake-string'."
39 (interactive "DRoot Dir: \nsProgram: \nsTest File: ") 39 (interactive "DRoot Dir: \nsProgram: \nsTest File: ")
40 (require 'ede/srecode) 40 (require 'ede/srecode)
41 (if (bufferp rootdir) 41 (if (bufferp rootdir)
@@ -147,7 +147,7 @@ From the autoconf manual:
147 (looking-at (concat "\\(A[CM]_" macro "\\|" macro "\\)")))) 147 (looking-at (concat "\\(A[CM]_" macro "\\|" macro "\\)"))))
148 148
149(defun autoconf-find-last-macro (macro &optional ignore-bol) 149(defun autoconf-find-last-macro (macro &optional ignore-bol)
150 "Move to the last occurrence of MACRO in FILE, and return that point. 150 "Move to the last occurrence of MACRO, and return that point.
151The last macro is usually the one in which we would like to insert more 151The last macro is usually the one in which we would like to insert more
152items such as CHECK_HEADERS." 152items such as CHECK_HEADERS."
153 (let ((op (point)) (atbol (if ignore-bol "" "^"))) 153 (let ((op (point)) (atbol (if ignore-bol "" "^")))
@@ -160,7 +160,7 @@ items such as CHECK_HEADERS."
160 nil))) 160 nil)))
161 161
162(defun autoconf-parameter-strip (param) 162(defun autoconf-parameter-strip (param)
163 "Strip the parameter PARAM of whitespace and miscellaneous characters." 163 "Strip the parameter PARAM of whitespace and miscellaneous characters."
164 ;; force greedy match for \n. 164 ;; force greedy match for \n.
165 (when (string-match "\\`\n*\\s-*\\[?\\s-*" param) 165 (when (string-match "\\`\n*\\s-*\\[?\\s-*" param)
166 (setq param (substring param (match-end 0)))) 166 (setq param (substring param (match-end 0))))
diff --git a/lisp/cedet/ede/config.el b/lisp/cedet/ede/config.el
index c8bf7f33bae..39d984ac356 100644
--- a/lisp/cedet/ede/config.el
+++ b/lisp/cedet/ede/config.el
@@ -300,7 +300,7 @@ This class brings in method overloads for building.")
300(defclass ede-target-with-config-build () 300(defclass ede-target-with-config-build ()
301 () 301 ()
302 "Class to mix into a project with configuration for builds. 302 "Class to mix into a project with configuration for builds.
303This class brings in method overloads for for building.") 303This class brings in method overloads for building.")
304 304
305(cl-defmethod project-compile-project ((proj ede-project-with-config-build) &optional command) 305(cl-defmethod project-compile-project ((proj ede-project-with-config-build) &optional command)
306 "Compile the entire current project PROJ. 306 "Compile the entire current project PROJ.
diff --git a/lisp/cedet/ede/linux.el b/lisp/cedet/ede/linux.el
index 424a20dec4d..b5a6482bbdf 100644
--- a/lisp/cedet/ede/linux.el
+++ b/lisp/cedet/ede/linux.el
@@ -136,7 +136,7 @@ If DIR has not been used as a build directory, fall back to
136 136
137(defun ede-linux--detect-architecture (dir) 137(defun ede-linux--detect-architecture (dir)
138 "Try to auto-detect the architecture as configured in DIR. 138 "Try to auto-detect the architecture as configured in DIR.
139DIR is Linux' build directory. If it cannot be auto-detected, 139DIR is Linux' build directory. If it cannot be auto-detected,
140returns `project-linux-architecture-default'." 140returns `project-linux-architecture-default'."
141 (let ((archs-dir (expand-file-name "arch" dir)) 141 (let ((archs-dir (expand-file-name "arch" dir))
142 (archs (ede-linux--get-archs dir)) 142 (archs (ede-linux--get-archs dir))
@@ -157,9 +157,9 @@ returns `project-linux-architecture-default'."
157 157
158(defun ede-linux--get-architecture (dir bdir) 158(defun ede-linux--get-architecture (dir bdir)
159 "Try to auto-detect the architecture as configured in BDIR. 159 "Try to auto-detect the architecture as configured in BDIR.
160Uses `ede-linux--detect-architecture' for the auto-detection. If 160Uses `ede-linux--detect-architecture' for the auto-detection.
161the result is `ask', let the user choose from architectures found 161If the result is `ask', let the user choose from architectures
162in DIR." 162found in DIR."
163 (let ((arch (ede-linux--detect-architecture bdir))) 163 (let ((arch (ede-linux--detect-architecture bdir)))
164 (cl-case arch 164 (cl-case arch
165 (ask 165 (ask
diff --git a/lisp/cedet/semantic/complete.el b/lisp/cedet/semantic/complete.el
index 8f89d1a51e2..14d2bd38ee8 100644
--- a/lisp/cedet/semantic/complete.el
+++ b/lisp/cedet/semantic/complete.el
@@ -1219,7 +1219,7 @@ Basics search only in the current buffer.")
1219(cl-defmethod semantic-collector-calculate-cache 1219(cl-defmethod semantic-collector-calculate-cache
1220 ((obj semantic-collector-buffer-deep)) 1220 ((obj semantic-collector-buffer-deep))
1221 "Calculate the completion cache for OBJ. 1221 "Calculate the completion cache for OBJ.
1222Uses `semantic-flatten-tags-table'" 1222Uses `semantic-flatten-tags-table'."
1223 (oset obj cache 1223 (oset obj cache
1224 ;; Must create it in SEMANTICDB find format. 1224 ;; Must create it in SEMANTICDB find format.
1225 ;; ( ( DBTABLE TAG TAG ... ) ... ) 1225 ;; ( ( DBTABLE TAG TAG ... ) ... )
@@ -1314,7 +1314,7 @@ Uses semanticdb for searching all tags in the current project."
1314 :documentation "List of tags this displayer is showing.") 1314 :documentation "List of tags this displayer is showing.")
1315 (last-prefix :type string 1315 (last-prefix :type string
1316 :protection :protected 1316 :protection :protected
1317 :documentation "Prefix associated with slot `table'") 1317 :documentation "Prefix associated with slot `table'.")
1318 ) 1318 )
1319 "Abstract displayer baseclass. 1319 "Abstract displayer baseclass.
1320Manages the display of some number of tags. 1320Manages the display of some number of tags.
@@ -1746,7 +1746,7 @@ Display mechanism using tooltip for a list of possible completions.")
1746 1746
1747(defun semantic-displayer-point-position () 1747(defun semantic-displayer-point-position ()
1748 "Return the location of POINT as positioned on the selected frame. 1748 "Return the location of POINT as positioned on the selected frame.
1749Return a cons cell (X . Y)" 1749Return a cons cell (X . Y)."
1750 (let* ((frame (selected-frame)) 1750 (let* ((frame (selected-frame))
1751 (toolbarleft 1751 (toolbarleft
1752 (if (eq (cdr (assoc 'tool-bar-position default-frame-alist)) 'left) 1752 (if (eq (cdr (assoc 'tool-bar-position default-frame-alist)) 'left)
diff --git a/lisp/cedet/semantic/format.el b/lisp/cedet/semantic/format.el
index b576ad5e210..00f684276b8 100644
--- a/lisp/cedet/semantic/format.el
+++ b/lisp/cedet/semantic/format.el
@@ -107,7 +107,7 @@ Override the value locally if a language supports other tag types.
107When adding new elements, try to use symbols also returned by the parser. 107When adding new elements, try to use symbols also returned by the parser.
108The form of an entry in this list is of the form: 108The form of an entry in this list is of the form:
109 ( SYMBOL . FACE ) 109 ( SYMBOL . FACE )
110where SYMBOL is a tag type symbol used with semantic. FACE 110where SYMBOL is a tag type symbol used with semantic, and FACE
111is a symbol representing a face. 111is a symbol representing a face.
112Faces used are generated in `font-lock' for consistency, and will not 112Faces used are generated in `font-lock' for consistency, and will not
113be used unless font lock is a feature.") 113be used unless font lock is a feature.")
@@ -407,7 +407,7 @@ Optional argument COLOR means highlight the prototype with font-lock colors."
407 (concat file ": " proto)))) 407 (concat file ": " proto))))
408 408
409(define-overloadable-function semantic-format-tag-short-doc (tag &optional parent color) 409(define-overloadable-function semantic-format-tag-short-doc (tag &optional parent color)
410 "Display a short form of TAG's documentation. (Comments, or docstring.) 410 "Display a short form of TAG's documentation. (Comments, or docstring.)
411Optional argument PARENT is the parent type if TAG is a detail. 411Optional argument PARENT is the parent type if TAG is a detail.
412Optional argument COLOR means highlight the prototype with font-lock colors.") 412Optional argument COLOR means highlight the prototype with font-lock colors.")
413 413
diff --git a/lisp/cedet/semantic/fw.el b/lisp/cedet/semantic/fw.el
index 0dd0a932188..216a47547dc 100644
--- a/lisp/cedet/semantic/fw.el
+++ b/lisp/cedet/semantic/fw.el
@@ -329,7 +329,7 @@ calling this one."
329(defun semantic-find-file-noselect (file &optional nowarn rawfile wildcards) 329(defun semantic-find-file-noselect (file &optional nowarn rawfile wildcards)
330 "Call `find-file-noselect' with various features turned off. 330 "Call `find-file-noselect' with various features turned off.
331Use this when referencing a file that will be soon deleted. 331Use this when referencing a file that will be soon deleted.
332FILE, NOWARN, RAWFILE, and WILDCARDS are passed into `find-file-noselect'" 332FILE, NOWARN, RAWFILE, and WILDCARDS are passed into `find-file-noselect'."
333 ;; Hack - 333 ;; Hack -
334 ;; Check if we are in set-auto-mode, and if so, warn about this. 334 ;; Check if we are in set-auto-mode, and if so, warn about this.
335 (when (boundp 'keep-mode-if-same) 335 (when (boundp 'keep-mode-if-same)
diff --git a/lisp/cedet/semantic/idle.el b/lisp/cedet/semantic/idle.el
index 09af66658fa..35ec930469f 100644
--- a/lisp/cedet/semantic/idle.el
+++ b/lisp/cedet/semantic/idle.el
@@ -91,8 +91,8 @@ run as soon as Emacs is idle."
91 91
92(defcustom semantic-idle-scheduler-work-idle-time 60 92(defcustom semantic-idle-scheduler-work-idle-time 60
93 "Time in seconds of idle before scheduling big work. 93 "Time in seconds of idle before scheduling big work.
94This time should be long enough that once any big work is started, it is 94This time should be long enough that once any big work is started,
95unlikely the user would be ready to type again right away." 95it is unlikely the user would be ready to type again right away."
96 :group 'semantic 96 :group 'semantic
97 :type 'number 97 :type 'number
98 :set (lambda (sym val) 98 :set (lambda (sym val)
@@ -1004,8 +1004,8 @@ completion.
1004 #'semantic-idle-breadcrumbs--display-in-header-line 1004 #'semantic-idle-breadcrumbs--display-in-header-line
1005 "Function to display the tag under point in idle time. 1005 "Function to display the tag under point in idle time.
1006This function should take a list of Semantic tags as its only 1006This function should take a list of Semantic tags as its only
1007argument. The tags are sorted according to their nesting order, 1007argument. The tags are sorted according to their nesting order,
1008starting with the outermost tag. The function should call 1008starting with the outermost tag. The function should call
1009`semantic-idle-breadcrumbs-format-tag-list-function' to convert 1009`semantic-idle-breadcrumbs-format-tag-list-function' to convert
1010the tag list into a string." 1010the tag list into a string."
1011 :group 'semantic 1011 :group 'semantic
@@ -1020,13 +1020,13 @@ the tag list into a string."
1020 #'semantic-idle-breadcrumbs--format-linear 1020 #'semantic-idle-breadcrumbs--format-linear
1021 "Function to format the list of tags containing point. 1021 "Function to format the list of tags containing point.
1022This function should take a list of Semantic tags and an optional 1022This function should take a list of Semantic tags and an optional
1023maximum length of the produced string as its arguments. The 1023maximum length of the produced string as its arguments. The
1024maximum length is a hint and can be ignored. When the maximum 1024maximum length is a hint and can be ignored. When the maximum
1025length is omitted, an unconstrained string should be 1025length is omitted, an unconstrained string should be produced.
1026produced. The tags are sorted according to their nesting order, 1026The tags are sorted according to their nesting order, starting
1027starting with the outermost tag. Single tags should be formatted 1027with the outermost tag. Single tags should be formatted using
1028using `semantic-idle-breadcrumbs-format-tag-function' unless 1028`semantic-idle-breadcrumbs-format-tag-function' unless special
1029special formatting is required." 1029formatting is required."
1030 :group 'semantic 1030 :group 'semantic
1031 :type '(choice 1031 :type '(choice
1032 (const :tag "Format tags as list, innermost last" 1032 (const :tag "Format tags as list, innermost last"
diff --git a/lisp/cedet/semantic/lex.el b/lisp/cedet/semantic/lex.el
index 50e09e2359c..5df92f53172 100644
--- a/lisp/cedet/semantic/lex.el
+++ b/lisp/cedet/semantic/lex.el
@@ -454,7 +454,7 @@ PROPSPECS must be a list of (TYPE PROPERTY VALUE)."
454(defsubst semantic-lex-map-types (fun &optional property) 454(defsubst semantic-lex-map-types (fun &optional property)
455 "Call function FUN on every lexical type. 455 "Call function FUN on every lexical type.
456If optional PROPERTY is non-nil, call FUN only on every type symbol 456If optional PROPERTY is non-nil, call FUN only on every type symbol
457which as a PROPERTY value. FUN receives a type symbol as argument." 457which has a PROPERTY value. FUN receives a type symbol as argument."
458 (semantic-lex-map-symbols 458 (semantic-lex-map-symbols
459 fun semantic-lex-types-obarray property)) 459 fun semantic-lex-types-obarray property))
460 460
@@ -769,7 +769,7 @@ Note: The order in which analyzers are listed is important.
769If two analyzers can match the same text, it is important to order the 769If two analyzers can match the same text, it is important to order the
770analyzers so that the one you want to match first occurs first. For 770analyzers so that the one you want to match first occurs first. For
771example, it is good to put a number analyzer in front of a symbol 771example, it is good to put a number analyzer in front of a symbol
772analyzer which might mistake a number for as a symbol." 772analyzer which might mistake a number for a symbol."
773 `(defun ,name (start end &optional depth length) 773 `(defun ,name (start end &optional depth length)
774 ,(concat doc "\nSee `semantic-lex' for more information.") 774 ,(concat doc "\nSee `semantic-lex' for more information.")
775 ;; Make sure the state of block parsing starts over. 775 ;; Make sure the state of block parsing starts over.
@@ -1581,7 +1581,7 @@ DEFAULT is the default lexical token returned when no MATCHES."
1581(defmacro define-lex-block-type-analyzer (name doc syntax matches) 1581(defmacro define-lex-block-type-analyzer (name doc syntax matches)
1582 "Define a block type analyzer NAME with DOC string. 1582 "Define a block type analyzer NAME with DOC string.
1583 1583
1584SYNTAX is the regexp that matches block delimiters, typically the 1584SYNTAX is the regexp that matches block delimiters, typically the
1585open (`\\\\s(') and close (`\\\\s)') parenthesis syntax classes. 1585open (`\\\\s(') and close (`\\\\s)') parenthesis syntax classes.
1586 1586
1587MATCHES is a pair (OPEN-SPECS . CLOSE-SPECS) that defines blocks. 1587MATCHES is a pair (OPEN-SPECS . CLOSE-SPECS) that defines blocks.
diff --git a/lisp/cedet/semantic/senator.el b/lisp/cedet/semantic/senator.el
index f76d3328888..714190133f0 100644
--- a/lisp/cedet/semantic/senator.el
+++ b/lisp/cedet/semantic/senator.el
@@ -198,7 +198,7 @@ Tags of those classes are excluded from search."
198 198
199(defun senator-search-default-tag-filter (tag) 199(defun senator-search-default-tag-filter (tag)
200 "Default function that filters searched tags. 200 "Default function that filters searched tags.
201Ignore tags of classes in `senator-search-ignore-tag-classes'" 201Ignore tags of classes in `senator-search-ignore-tag-classes'."
202 (not (memq (semantic-tag-class tag) 202 (not (memq (semantic-tag-class tag)
203 senator-search-ignore-tag-classes))) 203 senator-search-ignore-tag-classes)))
204 204
diff --git a/lisp/cedet/semantic/symref.el b/lisp/cedet/semantic/symref.el
index 00403d4d52c..85acd50712b 100644
--- a/lisp/cedet/semantic/symref.el
+++ b/lisp/cedet/semantic/symref.el
@@ -319,7 +319,7 @@ where different symbols are used.
319 319
320Subclasses should be named `semantic-symref-tool-NAME', where 320Subclasses should be named `semantic-symref-tool-NAME', where
321NAME is the name of the tool used in the configuration variable 321NAME is the name of the tool used in the configuration variable
322`semantic-symref-tool'" 322`semantic-symref-tool'."
323 :abstract t) 323 :abstract t)
324 324
325(cl-defmethod semantic-symref-get-result ((tool semantic-symref-tool-baseclass)) 325(cl-defmethod semantic-symref-get-result ((tool semantic-symref-tool-baseclass))
@@ -388,7 +388,7 @@ Each element is a cons cell of the form (LINE . FILENAME).")
388 :type list 388 :type list
389 :documentation 389 :documentation
390 "The list of tags with hits in them. 390 "The list of tags with hits in them.
391Use the `semantic-symref-hit-tags' method to get this list.") 391Use the `semantic-symref-hit-tags' method to get this list.")
392 ) 392 )
393 "The results from a symbol reference search.") 393 "The results from a symbol reference search.")
394 394
@@ -476,7 +476,7 @@ Return the Semantic tag associated with HIT.
476SEARCHTXT is the text that is being searched for. 476SEARCHTXT is the text that is being searched for.
477Used to narrow the in-buffer search. 477Used to narrow the in-buffer search.
478SEARCHTYPE is the type of search (such as 'symbol or 'tagname). 478SEARCHTYPE is the type of search (such as 'symbol or 'tagname).
479If there is no database, of if the searchtype is wrong, return nil." 479If there is no database, or if the searchtype is wrong, return nil."
480 ;; Allowed search types for this mechanism: 480 ;; Allowed search types for this mechanism:
481 ;; tagname, tagregexp, tagcompletions 481 ;; tagname, tagregexp, tagcompletions
482 (if (not (memq searchtype '(tagname tagregexp tagcompletions))) 482 (if (not (memq searchtype '(tagname tagregexp tagcompletions)))
diff --git a/lisp/cedet/semantic/tag.el b/lisp/cedet/semantic/tag.el
index ec8a800ec41..16dda48dc62 100644
--- a/lisp/cedet/semantic/tag.el
+++ b/lisp/cedet/semantic/tag.el
@@ -471,8 +471,8 @@ ATTRIBUTES is a list of additional attributes belonging to this tag."
471NAME is the name of this variable. 471NAME is the name of this variable.
472TYPE is a string or semantic tag representing the type of this variable. 472TYPE is a string or semantic tag representing the type of this variable.
473Optional DEFAULT-VALUE is a string representing the default value of this 473Optional DEFAULT-VALUE is a string representing the default value of this
474variable. ATTRIBUTES is a list of additional attributes belonging to this 474variable.
475tag." 475ATTRIBUTES is a list of additional attributes belonging to this tag."
476 (apply 'semantic-tag name 'variable 476 (apply 'semantic-tag name 'variable
477 :type type 477 :type type
478 :default-value default-value 478 :default-value default-value
@@ -518,8 +518,8 @@ ATTRIBUTES is a list of additional attributes belonging to this tag."
518(defsubst semantic-tag-new-include (name system-flag &rest attributes) 518(defsubst semantic-tag-new-include (name system-flag &rest attributes)
519 "Create a semantic tag of class `include'. 519 "Create a semantic tag of class `include'.
520NAME is the name of this include. 520NAME is the name of this include.
521SYSTEM-FLAG represents that we were able to identify this include as belonging 521SYSTEM-FLAG represents that we were able to identify this include as
522to the system, as opposed to belonging to the local project. 522belonging to the system, as opposed to belonging to the local project.
523ATTRIBUTES is a list of additional attributes belonging to this tag." 523ATTRIBUTES is a list of additional attributes belonging to this tag."
524 (apply 'semantic-tag name 'include 524 (apply 'semantic-tag name 'include
525 :system-flag system-flag 525 :system-flag system-flag
@@ -528,8 +528,8 @@ ATTRIBUTES is a list of additional attributes belonging to this tag."
528(defsubst semantic-tag-new-package (name detail &rest attributes) 528(defsubst semantic-tag-new-package (name detail &rest attributes)
529 "Create a semantic tag of class `package'. 529 "Create a semantic tag of class `package'.
530NAME is the name of this package. 530NAME is the name of this package.
531DETAIL is extra information about this package, such as a location where 531DETAIL is extra information about this package, such as a location
532it can be found. 532where it can be found.
533ATTRIBUTES is a list of additional attributes belonging to this tag." 533ATTRIBUTES is a list of additional attributes belonging to this tag."
534 (apply 'semantic-tag name 'package 534 (apply 'semantic-tag name 'package
535 :detail detail 535 :detail detail
@@ -547,7 +547,7 @@ ATTRIBUTES is a list of additional attributes belonging to this tag."
547(defsubst semantic-tag-set-faux (tag) 547(defsubst semantic-tag-set-faux (tag)
548 "Set TAG to be a new FAUX tag. 548 "Set TAG to be a new FAUX tag.
549FAUX tags represent constructs not found in the source code. 549FAUX tags represent constructs not found in the source code.
550You can identify a faux tag with `semantic-tag-faux-p'" 550You can identify a faux tag with `semantic-tag-faux-p'."
551 (semantic--tag-put-property tag :faux-flag t)) 551 (semantic--tag-put-property tag :faux-flag t))
552 552
553(defsubst semantic-tag-set-name (tag name) 553(defsubst semantic-tag-set-name (tag name)
@@ -565,9 +565,9 @@ You can identify a faux tag with `semantic-tag-faux-p'"
565;; it. This prevents saving of massive amounts of proxy data. 565;; it. This prevents saving of massive amounts of proxy data.
566(defun semantic-create-tag-proxy (function data) 566(defun semantic-create-tag-proxy (function data)
567 "Create a tag proxy symbol. 567 "Create a tag proxy symbol.
568FUNCTION will be used to resolve the proxy. It should take 3 568FUNCTION will be used to resolve the proxy. It should take
569two arguments, DATA and TAG. TAG is a proxy tag that needs 569two arguments, DATA and TAG. TAG is a proxy tag that needs
570to be resolved, and DATA is the DATA passed into this function. 570to be resolved, and DATA is the data passed into this function.
571DATA is data to help resolve the proxy. DATA can be an EIEIO object, 571DATA is data to help resolve the proxy. DATA can be an EIEIO object,
572such that FUNCTION is a method. 572such that FUNCTION is a method.
573FUNCTION should return a list of tags, preferably one tag." 573FUNCTION should return a list of tags, preferably one tag."
@@ -870,7 +870,7 @@ That is the value of the `:throws' attribute."
870 "Return the parent of the function that TAG describes. 870 "Return the parent of the function that TAG describes.
871That is the value of the `:parent' attribute. 871That is the value of the `:parent' attribute.
872A function has a parent if it is a method of a class, and if the 872A function has a parent if it is a method of a class, and if the
873function does not appear in body of its parent class." 873function does not appear in the body of its parent class."
874 (semantic-tag-named-parent tag)) 874 (semantic-tag-named-parent tag))
875 875
876(defsubst semantic-tag-function-destructor-p (tag) 876(defsubst semantic-tag-function-destructor-p (tag)
@@ -976,7 +976,7 @@ Perform the described task in `semantic-tag-components'."
976Children are any sub-tags which contain overlays. 976Children are any sub-tags which contain overlays.
977 977
978Default behavior is to get `semantic-tag-components' in addition 978Default behavior is to get `semantic-tag-components' in addition
979to the components of an anonymous types (if applicable.) 979to the components of an anonymous type (if applicable.)
980 980
981Note for language authors: 981Note for language authors:
982 If a mode defines a language tag that has tags in it with overlays 982 If a mode defines a language tag that has tags in it with overlays
diff --git a/lisp/cedet/srecode/cpp.el b/lisp/cedet/srecode/cpp.el
index 306c60f1b61..9d30b163ee4 100644
--- a/lisp/cedet/srecode/cpp.el
+++ b/lisp/cedet/srecode/cpp.el
@@ -43,7 +43,7 @@
43 "List expansion candidates for the :using-namespaces argument. 43 "List expansion candidates for the :using-namespaces argument.
44A dictionary entry of the named PREFIX_NAMESPACE with the value 44A dictionary entry of the named PREFIX_NAMESPACE with the value
45NAMESPACE:: is created for each namespace unless the current 45NAMESPACE:: is created for each namespace unless the current
46buffer contains a using NAMESPACE; statement " 46buffer contains a using NAMESPACE; statement."
47 :group 'srecode-cpp 47 :group 'srecode-cpp
48 :type '(repeat string)) 48 :type '(repeat string))
49 49
@@ -56,7 +56,7 @@ buffer contains a using NAMESPACE; statement "
56 56
57;;;###autoload 57;;;###autoload
58(defun srecode-semantic-handle-:c (dict) 58(defun srecode-semantic-handle-:c (dict)
59 "Add macros into the dictionary DICT based on the current c file. 59 "Add macros into the dictionary DICT based on the current C file.
60Adds the following: 60Adds the following:
61FILENAME_SYMBOL - filename converted into a C compat symbol. 61FILENAME_SYMBOL - filename converted into a C compat symbol.
62HEADER - Shown section if in a header file." 62HEADER - Shown section if in a header file."
@@ -110,7 +110,7 @@ PREFIX_NAMESPACE - for each NAMESPACE in `srecode-cpp-namespaces'."
110(define-mode-local-override srecode-semantic-apply-tag-to-dict 110(define-mode-local-override srecode-semantic-apply-tag-to-dict
111 c-mode (tag-wrapper dict) 111 c-mode (tag-wrapper dict)
112 "Apply C and C++ specific features from TAG-WRAPPER into DICT. 112 "Apply C and C++ specific features from TAG-WRAPPER into DICT.
113Calls `srecode-semantic-apply-tag-to-dict-default' first. Adds 113Calls `srecode-semantic-apply-tag-to-dict-default' first. Adds
114special behavior for tag of classes include, using and function. 114special behavior for tag of classes include, using and function.
115 115
116This function cannot be split into C and C++ specific variants, as 116This function cannot be split into C and C++ specific variants, as
diff --git a/lisp/cedet/srecode/dictionary.el b/lisp/cedet/srecode/dictionary.el
index 1058024d457..a0205177caa 100644
--- a/lisp/cedet/srecode/dictionary.el
+++ b/lisp/cedet/srecode/dictionary.el
@@ -147,7 +147,7 @@ Makes sure that :value is compiled."
147;; 147;;
148 148
149(defun srecode-create-dictionary (&optional buffer-or-parent) 149(defun srecode-create-dictionary (&optional buffer-or-parent)
150 "Create a dictionary for BUFFER. 150 "Create a dictionary for BUFFER-OR-PARENT.
151If BUFFER-OR-PARENT is not specified, assume a buffer, and 151If BUFFER-OR-PARENT is not specified, assume a buffer, and
152use the current buffer. 152use the current buffer.
153If BUFFER-OR-PARENT is another dictionary, then remember the 153If BUFFER-OR-PARENT is another dictionary, then remember the
@@ -326,8 +326,8 @@ inserted dictionaries."
326 entries &optional state) 326 entries &optional state)
327 "Add ENTRIES to DICT. 327 "Add ENTRIES to DICT.
328 328
329ENTRIES is a list of even length of dictionary entries to 329ENTRIES is a list of even length of dictionary entries to add.
330add. ENTRIES looks like this: 330ENTRIES looks like this:
331 331
332 (NAME_1 VALUE_1 NAME_2 VALUE_2 ...) 332 (NAME_1 VALUE_1 NAME_2 VALUE_2 ...)
333 333
@@ -340,7 +340,7 @@ and for values
340 * Otherwise, a compound variable is created for VALUE_N. 340 * Otherwise, a compound variable is created for VALUE_N.
341 341
342The optional argument STATE has to non-nil when compound values 342The optional argument STATE has to non-nil when compound values
343are inserted. An error is signaled if ENTRIES contains compound 343are inserted. An error is signaled if ENTRIES contains compound
344values but STATE is nil." 344values but STATE is nil."
345 (while entries 345 (while entries
346 (let ((name (nth 0 entries)) 346 (let ((name (nth 0 entries))
@@ -409,8 +409,8 @@ OTHERDICT."
409 name &optional non-recursive) 409 name &optional non-recursive)
410 "Return information about DICT's value for NAME. 410 "Return information about DICT's value for NAME.
411DICT is a dictionary, and NAME is a string that is treated as the 411DICT is a dictionary, and NAME is a string that is treated as the
412name of an entry in the dictionary. If such an entry exists, its 412name of an entry in the dictionary. If such an entry exists, its
413value is returned. Otherwise, nil is returned. Normally, the 413value is returned. Otherwise, nil is returned. Normally, the
414lookup is recursive in the sense that the parent of DICT is 414lookup is recursive in the sense that the parent of DICT is
415searched for NAME if it is not found in DICT. This recursive 415searched for NAME if it is not found in DICT. This recursive
416lookup can be disabled by the optional argument NON-RECURSIVE. 416lookup can be disabled by the optional argument NON-RECURSIVE.
@@ -552,7 +552,7 @@ inserted with a new editable field.")
552 "Create a dictionary with entries according to TAGS. 552 "Create a dictionary with entries according to TAGS.
553 553
554TAGS should be in the format produced by the template file 554TAGS should be in the format produced by the template file
555grammar. That is 555grammar. That is
556 556
557TAGS = (ENTRY_1 ENTRY_2 ...) 557TAGS = (ENTRY_1 ENTRY_2 ...)
558 558
@@ -560,9 +560,9 @@ where
560 560
561ENTRY_N = (NAME ENTRY_N_1 ENTRY_N_2 ...) | TAG 561ENTRY_N = (NAME ENTRY_N_1 ENTRY_N_2 ...) | TAG
562 562
563where TAG is a semantic tag of class 'variable. The (NAME ... ) 563where TAG is a semantic tag of class 'variable. The (NAME ... )
564form creates a child dictionary which is stored under the name 564form creates a child dictionary which is stored under the name
565NAME. The TAG form creates a value entry or section dictionary 565NAME. The TAG form creates a value entry or section dictionary
566entry whose name is the name of the tag. 566entry whose name is the name of the tag.
567 567
568STATE is the current compiler state." 568STATE is the current compiler state."
diff --git a/lisp/cmuscheme.el b/lisp/cmuscheme.el
index ed6f1bfb1ad..874cfa98f5b 100644
--- a/lisp/cmuscheme.el
+++ b/lisp/cmuscheme.el
@@ -287,7 +287,7 @@ in this order. Return nil if no start file found."
287 287
288(defun scheme-compile-region (start end) 288(defun scheme-compile-region (start end)
289 "Compile the current region in the inferior Scheme process. 289 "Compile the current region in the inferior Scheme process.
290\(A BEGIN is wrapped around the region: (BEGIN <region>))" 290\(A BEGIN is wrapped around the region: (BEGIN <region>).)"
291 (interactive "r") 291 (interactive "r")
292 (comint-send-string (scheme-proc) (format scheme-compile-exp-command 292 (comint-send-string (scheme-proc) (format scheme-compile-exp-command
293 (format "(begin %s)" 293 (format "(begin %s)"
diff --git a/lisp/color.el b/lisp/color.el
index e401456de76..804eb57ee53 100644
--- a/lisp/color.el
+++ b/lisp/color.el
@@ -291,11 +291,11 @@ conversion. If omitted or nil, use `color-d65-xyz'."
291 (list (/ (* Y x) y) Y (/ (* Y (- 1 x y)) y)))) 291 (list (/ (* Y x) y) Y (/ (* Y (- 1 x y)) y))))
292 292
293(defun color-lab-to-lch (L a b) 293(defun color-lab-to-lch (L a b)
294 "Convert CIE L*a*b* to L*C*h*" 294 "Convert CIE L*a*b* to L*C*h*."
295 (list L (sqrt (+ (* a a) (* b b))) (atan b a))) 295 (list L (sqrt (+ (* a a) (* b b))) (atan b a)))
296 296
297(defun color-lch-to-lab (L C h) 297(defun color-lch-to-lab (L C h)
298 "Convert CIE L*a*b* to L*C*h*" 298 "Convert CIE L*a*b* to L*C*h*."
299 (list L (* C (cos h)) (* C (sin h)))) 299 (list L (* C (cos h)) (* C (sin h))))
300 300
301(defun color-cie-de2000 (color1 color2 &optional kL kC kH) 301(defun color-cie-de2000 (color1 color2 &optional kL kC kH)
diff --git a/lisp/doc-view.el b/lisp/doc-view.el
index 78895ebd7a6..49d2b56b7d6 100644
--- a/lisp/doc-view.el
+++ b/lisp/doc-view.el
@@ -214,7 +214,7 @@ scaling."
214(defcustom doc-view-image-width 850 214(defcustom doc-view-image-width 850
215 "Default image width. 215 "Default image width.
216Has only an effect if `doc-view-scale-internally' is non-nil and support for 216Has only an effect if `doc-view-scale-internally' is non-nil and support for
217scaling is compiled into emacs." 217scaling is compiled into Emacs."
218 :version "24.1" 218 :version "24.1"
219 :type 'number) 219 :type 'number)
220 220
@@ -1778,7 +1778,7 @@ If BACKWARD is non-nil, jump to the previous match."
1778 (error "Cannot determine the document type")))))) 1778 (error "Cannot determine the document type"))))))
1779 1779
1780(defun doc-view-set-up-single-converter () 1780(defun doc-view-set-up-single-converter ()
1781 "Find the right single-page converter for the current document type" 1781 "Find the right single-page converter for the current document type."
1782 (pcase-let ((`(,conv-function ,type ,extension) 1782 (pcase-let ((`(,conv-function ,type ,extension)
1783 (pcase doc-view-doc-type 1783 (pcase doc-view-doc-type
1784 ('djvu (list #'doc-view-djvu->tiff-converter-ddjvu 'tiff "tif")) 1784 ('djvu (list #'doc-view-djvu->tiff-converter-ddjvu 'tiff "tif"))
diff --git a/lisp/dynamic-setting.el b/lisp/dynamic-setting.el
index cf1a8d3b73c..3da8d14cee0 100644
--- a/lisp/dynamic-setting.el
+++ b/lisp/dynamic-setting.el
@@ -40,8 +40,8 @@
40 "Change font and/or font settings for frames on display DISPLAY-OR-FRAME. 40 "Change font and/or font settings for frames on display DISPLAY-OR-FRAME.
41If DISPLAY-OR-FRAME is a frame, the display is the one for that frame. 41If DISPLAY-OR-FRAME is a frame, the display is the one for that frame.
42 42
43If SET-FONT is non-nil, change the font for frames. Otherwise re-apply the 43If SET-FONT is non-nil, change the font for frames. Otherwise re-apply
44current form for the frame (i.e. hinting or somesuch changed)." 44the current form for the frame (i.e. hinting or somesuch changed)."
45 (let ((new-font (and (fboundp 'font-get-system-font) 45 (let ((new-font (and (fboundp 'font-get-system-font)
46 (font-get-system-font))) 46 (font-get-system-font)))
47 (frame-list (frames-on-display-list display-or-frame))) 47 (frame-list (frames-on-display-list display-or-frame)))
@@ -68,8 +68,8 @@ current form for the frame (i.e. hinting or somesuch changed)."
68(defun dynamic-setting-handle-config-changed-event (event) 68(defun dynamic-setting-handle-config-changed-event (event)
69 "Handle config-changed-event on the display in EVENT. 69 "Handle config-changed-event on the display in EVENT.
70Changes can be 70Changes can be
71 The monospace font. If `font-use-system-font' is nil, the font 71 The monospace font. If `font-use-system-font' is nil,
72 is not changed. 72 the font is not changed.
73 The normal font. 73 The normal font.
74 Xft parameters, like DPI and hinting. 74 Xft parameters, like DPI and hinting.
75 The Gtk+ theme name. 75 The Gtk+ theme name.
diff --git a/lisp/elec-pair.el b/lisp/elec-pair.el
index 5fb9d751e25..f3cbee70486 100644
--- a/lisp/elec-pair.el
+++ b/lisp/elec-pair.el
@@ -51,7 +51,7 @@ See also the variable `electric-pair-text-pairs'."
51 51
52Pairs of delimiters in this list are a fallback in case they have 52Pairs of delimiters in this list are a fallback in case they have
53no syntax relevant to `electric-pair-mode' in the syntax table 53no syntax relevant to `electric-pair-mode' in the syntax table
54defined in `electric-pair-text-syntax-table'" 54defined in `electric-pair-text-syntax-table'."
55 :version "24.4" 55 :version "24.4"
56 :group 'electricity 56 :group 'electricity
57 :type '(repeat (cons character character))) 57 :type '(repeat (cons character character)))
@@ -159,7 +159,7 @@ return value is considered instead."
159 #'electric-pair--skip-whitespace 159 #'electric-pair--skip-whitespace
160 "Function to use to skip whitespace forward. 160 "Function to use to skip whitespace forward.
161Before attempting a skip, if `electric-pair-skip-whitespace' is 161Before attempting a skip, if `electric-pair-skip-whitespace' is
162non-nil, this function is called. It move point to a new buffer 162non-nil, this function is called. It move point to a new buffer
163position, presumably skipping only whitespace in between.") 163position, presumably skipping only whitespace in between.")
164 164
165(defun electric-pair--skip-whitespace () 165(defun electric-pair--skip-whitespace ()
@@ -380,7 +380,7 @@ If point is not enclosed by any lists, return ((t) . (t))."
380(defvar electric-pair-string-bound-function 'point-max 380(defvar electric-pair-string-bound-function 'point-max
381 "Next buffer position where strings are syntactically unexpected. 381 "Next buffer position where strings are syntactically unexpected.
382Value is a function called with no arguments and returning a 382Value is a function called with no arguments and returning a
383buffer position. Major modes should set this variable 383buffer position. Major modes should set this variable
384buffer-locally if they experience slowness with 384buffer-locally if they experience slowness with
385`electric-pair-mode' when pairing quotes.") 385`electric-pair-mode' when pairing quotes.")
386 386
diff --git a/lisp/emacs-lisp/avl-tree.el b/lisp/emacs-lisp/avl-tree.el
index d2a3a131d16..a586fa02501 100644
--- a/lisp/emacs-lisp/avl-tree.el
+++ b/lisp/emacs-lisp/avl-tree.el
@@ -130,8 +130,8 @@ NODE is the node, and BRANCH is the branch.
130 130
131(defun avl-tree--del-balance (node branch dir) 131(defun avl-tree--del-balance (node branch dir)
132 "Rebalance a tree after deleting a node. 132 "Rebalance a tree after deleting a node.
133The deletion was done from the left (DIR=0) or right (DIR=1) sub-tree of the 133The deletion was done from the left (DIR=0) or right (DIR=1) sub-tree
134left (BRANCH=0) or right (BRANCH=1) child of NODE. 134of the left (BRANCH=0) or right (BRANCH=1) child of NODE.
135Return t if the height of the tree has shrunk." 135Return t if the height of the tree has shrunk."
136 ;; (or is it vice-versa for BRANCH?) 136 ;; (or is it vice-versa for BRANCH?)
137 (let ((br (avl-tree--node-branch node branch)) 137 (let ((br (avl-tree--node-branch node branch))
@@ -477,11 +477,11 @@ value is non-nil."
477Matching uses the comparison function previously specified in 477Matching uses the comparison function previously specified in
478`avl-tree-create' when TREE was created. 478`avl-tree-create' when TREE was created.
479 479
480If there is no such element in the tree, nil is 480If there is no such element in the tree, nil is returned.
481returned. Optional argument NILFLAG specifies a value to return 481Optional argument NILFLAG specifies a value to return instead of nil
482instead of nil in this case. This allows non-existent elements to 482in this case. This allows non-existent elements to be distinguished
483be distinguished from a null element. (See also 483from a null element. (See also `avl-tree-member-p', which does this
484`avl-tree-member-p', which does this for you.)" 484for you.)"
485 (let ((node (avl-tree--root tree)) 485 (let ((node (avl-tree--root tree))
486 (compare-function (avl-tree--cmpfun tree))) 486 (compare-function (avl-tree--cmpfun tree)))
487 (catch 'found 487 (catch 'found
@@ -553,13 +553,13 @@ order, or descending order if REVERSE is non-nil."
553 553
554 554
555(defun avl-tree-mapcar (fun tree &optional reverse) 555(defun avl-tree-mapcar (fun tree &optional reverse)
556 "Apply FUNCTION to all elements in AVL tree TREE, 556 "Apply function FUN to all elements in AVL tree TREE,
557and make a list of the results. 557and make a list of the results.
558 558
559The FUNCTION is applied and the list constructed in ascending 559The function is applied and the list constructed in ascending
560order, or descending order if REVERSE is non-nil. 560order, or descending order if REVERSE is non-nil.
561 561
562Note that if you don't care about the order in which FUNCTION is 562Note that if you don't care about the order in which FUN is
563applied, just that the resulting list is in the correct order, 563applied, just that the resulting list is in the correct order,
564then 564then
565 565
@@ -674,7 +674,7 @@ a null element stored in the AVL tree.)"
674 "Return an AVL tree iterator object. 674 "Return an AVL tree iterator object.
675 675
676Calling `iter-next' on this object will retrieve the next element 676Calling `iter-next' on this object will retrieve the next element
677from TREE. If REVERSE is non-nil, elements are returned in 677from TREE. If REVERSE is non-nil, elements are returned in
678reverse order. 678reverse order.
679 679
680Note that any modification to TREE *immediately* invalidates all 680Note that any modification to TREE *immediately* invalidates all
diff --git a/lisp/emacs-lisp/bytecomp.el b/lisp/emacs-lisp/bytecomp.el
index 2fab11c79df..44a65ed4c6a 100644
--- a/lisp/emacs-lisp/bytecomp.el
+++ b/lisp/emacs-lisp/bytecomp.el
@@ -395,16 +395,16 @@ else the global value will be modified."
395 "Non-nil means collect call-graph information when compiling. 395 "Non-nil means collect call-graph information when compiling.
396This records which functions were called and from where. 396This records which functions were called and from where.
397If the value is t, compilation displays the call graph when it finishes. 397If the value is t, compilation displays the call graph when it finishes.
398If the value is neither t nor nil, compilation asks you whether to display 398If the value is neither t nor nil, compilation asks you whether to
399the graph. 399display the graph.
400 400
401The call tree only lists functions called, not macros used. Those functions 401The call tree only lists functions called, not macros used. Those
402which the byte-code interpreter knows about directly (eq, cons, etc.) are 402functions which the byte-code interpreter knows about directly (eq,
403not reported. 403cons, etc.) are not reported.
404 404
405The call tree also lists those functions which are not known to be called 405The call tree also lists those functions which are not known to be
406\(that is, to which no calls have been compiled). Functions which can be 406called (that is, to which no calls have been compiled). Functions
407invoked interactively are excluded from this list." 407which can be invoked interactively are excluded from this list."
408 :type '(choice (const :tag "Yes" t) (const :tag "No" nil) 408 :type '(choice (const :tag "Yes" t) (const :tag "No" nil)
409 (other :tag "Ask" lambda))) 409 (other :tag "Ask" lambda)))
410 410
diff --git a/lisp/emacs-lisp/checkdoc.el b/lisp/emacs-lisp/checkdoc.el
index 8a88c5756f1..51fb75da691 100644
--- a/lisp/emacs-lisp/checkdoc.el
+++ b/lisp/emacs-lisp/checkdoc.el
@@ -194,7 +194,7 @@
194 "Non-nil means attempt auto-fixing of doc strings. 194 "Non-nil means attempt auto-fixing of doc strings.
195If this value is the symbol `query', then the user is queried before 195If this value is the symbol `query', then the user is queried before
196any change is made. If the value is `automatic', then all changes are 196any change is made. If the value is `automatic', then all changes are
197made without asking unless the change is very-complex. If the value 197made without asking unless the change is very complex. If the value
198is `semiautomatic' or any other value, then simple fixes are made 198is `semiautomatic' or any other value, then simple fixes are made
199without asking, and complex changes are made by asking the user first. 199without asking, and complex changes are made by asking the user first.
200The value `never' is the same as nil, never ask or change anything." 200The value `never' is the same as nil, never ask or change anything."
@@ -238,10 +238,10 @@ This is automatically set to nil if Ispell does not exist on your
238system. Possible values are: 238system. Possible values are:
239 239
240 nil - Don't spell-check during basic style checks. 240 nil - Don't spell-check during basic style checks.
241 defun - Spell-check when style checking a single defun 241 defun - Spell-check when style checking a single defun.
242 buffer - Spell-check when style checking the whole buffer 242 buffer - Spell-check when style checking the whole buffer.
243 interactive - Spell-check during any interactive check. 243 interactive - Spell-check during any interactive check.
244 t - Always spell-check" 244 t - Always spell-check."
245 :type '(choice (const nil) 245 :type '(choice (const nil)
246 (const defun) 246 (const defun)
247 (const buffer) 247 (const buffer)
@@ -1050,7 +1050,7 @@ space at the end of each line."
1050(defun checkdoc-ispell () 1050(defun checkdoc-ispell ()
1051 "Check the style and spelling of everything interactively. 1051 "Check the style and spelling of everything interactively.
1052Calls `checkdoc' with spell-checking turned on. 1052Calls `checkdoc' with spell-checking turned on.
1053Prefix argument is the same as for `checkdoc'" 1053Prefix argument is the same as for `checkdoc'."
1054 (interactive) 1054 (interactive)
1055 (let ((checkdoc-spellcheck-documentation-flag t)) 1055 (let ((checkdoc-spellcheck-documentation-flag t))
1056 (call-interactively #'checkdoc))) 1056 (call-interactively #'checkdoc)))
@@ -1059,7 +1059,7 @@ Prefix argument is the same as for `checkdoc'"
1059(defun checkdoc-ispell-current-buffer () 1059(defun checkdoc-ispell-current-buffer ()
1060 "Check the style and spelling of the current buffer. 1060 "Check the style and spelling of the current buffer.
1061Calls `checkdoc-current-buffer' with spell-checking turned on. 1061Calls `checkdoc-current-buffer' with spell-checking turned on.
1062Prefix argument is the same as for `checkdoc-current-buffer'" 1062Prefix argument is the same as for `checkdoc-current-buffer'."
1063 (interactive) 1063 (interactive)
1064 (let ((checkdoc-spellcheck-documentation-flag t)) 1064 (let ((checkdoc-spellcheck-documentation-flag t))
1065 (call-interactively #'checkdoc-current-buffer))) 1065 (call-interactively #'checkdoc-current-buffer)))
@@ -1068,7 +1068,7 @@ Prefix argument is the same as for `checkdoc-current-buffer'"
1068(defun checkdoc-ispell-interactive () 1068(defun checkdoc-ispell-interactive ()
1069 "Check the style and spelling of the current buffer interactively. 1069 "Check the style and spelling of the current buffer interactively.
1070Calls `checkdoc-interactive' with spell-checking turned on. 1070Calls `checkdoc-interactive' with spell-checking turned on.
1071Prefix argument is the same as for `checkdoc-interactive'" 1071Prefix argument is the same as for `checkdoc-interactive'."
1072 (interactive) 1072 (interactive)
1073 (let ((checkdoc-spellcheck-documentation-flag t)) 1073 (let ((checkdoc-spellcheck-documentation-flag t))
1074 (call-interactively #'checkdoc-interactive))) 1074 (call-interactively #'checkdoc-interactive)))
@@ -1077,7 +1077,7 @@ Prefix argument is the same as for `checkdoc-interactive'"
1077(defun checkdoc-ispell-message-interactive () 1077(defun checkdoc-ispell-message-interactive ()
1078 "Check the style and spelling of message text interactively. 1078 "Check the style and spelling of message text interactively.
1079Calls `checkdoc-message-interactive' with spell-checking turned on. 1079Calls `checkdoc-message-interactive' with spell-checking turned on.
1080Prefix argument is the same as for `checkdoc-message-interactive'" 1080Prefix argument is the same as for `checkdoc-message-interactive'."
1081 (interactive) 1081 (interactive)
1082 (let ((checkdoc-spellcheck-documentation-flag t)) 1082 (let ((checkdoc-spellcheck-documentation-flag t))
1083 (call-interactively #'checkdoc-message-interactive 1083 (call-interactively #'checkdoc-message-interactive
@@ -1087,7 +1087,7 @@ Prefix argument is the same as for `checkdoc-message-interactive'"
1087(defun checkdoc-ispell-message-text () 1087(defun checkdoc-ispell-message-text ()
1088 "Check the style and spelling of message text interactively. 1088 "Check the style and spelling of message text interactively.
1089Calls `checkdoc-message-text' with spell-checking turned on. 1089Calls `checkdoc-message-text' with spell-checking turned on.
1090Prefix argument is the same as for `checkdoc-message-text'" 1090Prefix argument is the same as for `checkdoc-message-text'."
1091 (interactive) 1091 (interactive)
1092 (let ((checkdoc-spellcheck-documentation-flag t)) 1092 (let ((checkdoc-spellcheck-documentation-flag t))
1093 (call-interactively #'checkdoc-message-text))) 1093 (call-interactively #'checkdoc-message-text)))
@@ -1096,7 +1096,7 @@ Prefix argument is the same as for `checkdoc-message-text'"
1096(defun checkdoc-ispell-start () 1096(defun checkdoc-ispell-start ()
1097 "Check the style and spelling of the current buffer. 1097 "Check the style and spelling of the current buffer.
1098Calls `checkdoc-start' with spell-checking turned on. 1098Calls `checkdoc-start' with spell-checking turned on.
1099Prefix argument is the same as for `checkdoc-start'" 1099Prefix argument is the same as for `checkdoc-start'."
1100 (interactive) 1100 (interactive)
1101 (let ((checkdoc-spellcheck-documentation-flag t)) 1101 (let ((checkdoc-spellcheck-documentation-flag t))
1102 (call-interactively #'checkdoc-start))) 1102 (call-interactively #'checkdoc-start)))
@@ -1105,7 +1105,7 @@ Prefix argument is the same as for `checkdoc-start'"
1105(defun checkdoc-ispell-continue () 1105(defun checkdoc-ispell-continue ()
1106 "Check the style and spelling of the current buffer after point. 1106 "Check the style and spelling of the current buffer after point.
1107Calls `checkdoc-continue' with spell-checking turned on. 1107Calls `checkdoc-continue' with spell-checking turned on.
1108Prefix argument is the same as for `checkdoc-continue'" 1108Prefix argument is the same as for `checkdoc-continue'."
1109 (interactive) 1109 (interactive)
1110 (let ((checkdoc-spellcheck-documentation-flag t)) 1110 (let ((checkdoc-spellcheck-documentation-flag t))
1111 (call-interactively #'checkdoc-continue))) 1111 (call-interactively #'checkdoc-continue)))
@@ -1114,7 +1114,7 @@ Prefix argument is the same as for `checkdoc-continue'"
1114(defun checkdoc-ispell-comments () 1114(defun checkdoc-ispell-comments ()
1115 "Check the style and spelling of the current buffer's comments. 1115 "Check the style and spelling of the current buffer's comments.
1116Calls `checkdoc-comments' with spell-checking turned on. 1116Calls `checkdoc-comments' with spell-checking turned on.
1117Prefix argument is the same as for `checkdoc-comments'" 1117Prefix argument is the same as for `checkdoc-comments'."
1118 (interactive) 1118 (interactive)
1119 (let ((checkdoc-spellcheck-documentation-flag t)) 1119 (let ((checkdoc-spellcheck-documentation-flag t))
1120 (call-interactively #'checkdoc-comments))) 1120 (call-interactively #'checkdoc-comments)))
@@ -1123,7 +1123,7 @@ Prefix argument is the same as for `checkdoc-comments'"
1123(defun checkdoc-ispell-defun () 1123(defun checkdoc-ispell-defun ()
1124 "Check the style and spelling of the current defun with Ispell. 1124 "Check the style and spelling of the current defun with Ispell.
1125Calls `checkdoc-defun' with spell-checking turned on. 1125Calls `checkdoc-defun' with spell-checking turned on.
1126Prefix argument is the same as for `checkdoc-defun'" 1126Prefix argument is the same as for `checkdoc-defun'."
1127 (interactive) 1127 (interactive)
1128 (let ((checkdoc-spellcheck-documentation-flag t)) 1128 (let ((checkdoc-spellcheck-documentation-flag t))
1129 (call-interactively #'checkdoc-defun))) 1129 (call-interactively #'checkdoc-defun)))
diff --git a/lisp/emacs-lisp/cl-generic.el b/lisp/emacs-lisp/cl-generic.el
index 10190f49339..b0173dc991b 100644
--- a/lisp/emacs-lisp/cl-generic.el
+++ b/lisp/emacs-lisp/cl-generic.el
@@ -22,7 +22,7 @@
22 22
23;;; Commentary: 23;;; Commentary:
24 24
25;; This implements the most of CLOS's multiple-dispatch generic functions. 25;; This implements most of CLOS's multiple-dispatch generic functions.
26;; To use it you need either (require 'cl-generic) or (require 'cl-lib). 26;; To use it you need either (require 'cl-generic) or (require 'cl-lib).
27;; The main entry points are: `cl-defgeneric' and `cl-defmethod'. 27;; The main entry points are: `cl-defgeneric' and `cl-defmethod'.
28 28
@@ -911,7 +911,7 @@ Can only be used from within the lexical body of a primary or around method."
911;;; Add support for describe-function 911;;; Add support for describe-function
912 912
913(defun cl--generic-search-method (met-name) 913(defun cl--generic-search-method (met-name)
914 "For `find-function-regexp-alist'. Searches for a cl-defmethod. 914 "For `find-function-regexp-alist'. Searches for a cl-defmethod.
915MET-NAME is as returned by `cl--generic-load-hist-format'." 915MET-NAME is as returned by `cl--generic-load-hist-format'."
916 (let ((base-re (concat "(\\(?:cl-\\)?defmethod[ \t]+" 916 (let ((base-re (concat "(\\(?:cl-\\)?defmethod[ \t]+"
917 (regexp-quote (format "%s" (car met-name))) 917 (regexp-quote (format "%s" (car met-name)))
diff --git a/lisp/emacs-lisp/eieio-custom.el b/lisp/emacs-lisp/eieio-custom.el
index 350fca6d9ab..8fc74beca1e 100644
--- a/lisp/emacs-lisp/eieio-custom.el
+++ b/lisp/emacs-lisp/eieio-custom.el
@@ -454,7 +454,7 @@ Must return the created widget."
454 454
455(cl-defmethod eieio-read-customization-group ((obj eieio-default-superclass)) 455(cl-defmethod eieio-read-customization-group ((obj eieio-default-superclass))
456 "Do a completing read on the name of a customization group in OBJ. 456 "Do a completing read on the name of a customization group in OBJ.
457Return the symbol for the group, or nil" 457Return the symbol for the group, or nil."
458 (let ((g (eieio--class-option (eieio--object-class obj) 458 (let ((g (eieio--class-option (eieio--object-class obj)
459 :custom-groups))) 459 :custom-groups)))
460 (if (= (length g) 1) 460 (if (= (length g) 1)
diff --git a/lisp/emacs-lisp/lisp.el b/lisp/emacs-lisp/lisp.el
index ab0e853e9a4..93d43e319a5 100644
--- a/lisp/emacs-lisp/lisp.el
+++ b/lisp/emacs-lisp/lisp.el
@@ -60,8 +60,8 @@ Should take the same arguments and behave similarly to `forward-sexp'.")
60With ARG, do it that many times. Negative arg -N means move 60With ARG, do it that many times. Negative arg -N means move
61backward across N balanced expressions. This command assumes 61backward across N balanced expressions. This command assumes
62point is not in a string or comment. Calls 62point is not in a string or comment. Calls
63`forward-sexp-function' to do the work, if that is non-nil. If 63`forward-sexp-function' to do the work, if that is non-nil.
64unable to move over a sexp, signal `scan-error' with three 64If unable to move over a sexp, signal `scan-error' with three
65arguments: a message, the start of the obstacle (usually a 65arguments: a message, the start of the obstacle (usually a
66parenthesis or list marker of some kind), and end of the 66parenthesis or list marker of some kind), and end of the
67obstacle." 67obstacle."
@@ -164,7 +164,7 @@ This command will also work on other parentheses-like expressions
164defined by the current language mode. With ARG, do this that 164defined by the current language mode. With ARG, do this that
165many times. A negative argument means move backward but still to 165many times. A negative argument means move backward but still to
166a less deep spot. If ESCAPE-STRINGS is non-nil (as it is 166a less deep spot. If ESCAPE-STRINGS is non-nil (as it is
167interactively), move out of enclosing strings as well. If 167interactively), move out of enclosing strings as well. If
168NO-SYNTAX-CROSSING is non-nil (as it is interactively), prefer to 168NO-SYNTAX-CROSSING is non-nil (as it is interactively), prefer to
169break out of any enclosing string instead of moving to the start 169break out of any enclosing string instead of moving to the start
170of a list broken across multiple strings. On error, location of 170of a list broken across multiple strings. On error, location of
diff --git a/lisp/emacs-lisp/package-x.el b/lisp/emacs-lisp/package-x.el
index e26b6b99c17..2815be3fe65 100644
--- a/lisp/emacs-lisp/package-x.el
+++ b/lisp/emacs-lisp/package-x.el
@@ -124,7 +124,7 @@ Return the file contents, as a string, or nil if unsuccessful."
124 (buffer-substring-no-properties (point-min) (point-max))))))) 124 (buffer-substring-no-properties (point-min) (point-max)))))))
125 125
126(defun package--archive-contents-from-file () 126(defun package--archive-contents-from-file ()
127 "Parse the archive-contents at `package-archive-upload-base'" 127 "Parse the archive-contents at `package-archive-upload-base'."
128 (let ((file (expand-file-name "archive-contents" 128 (let ((file (expand-file-name "archive-contents"
129 package-archive-upload-base))) 129 package-archive-upload-base)))
130 (if (not (file-exists-p file)) 130 (if (not (file-exists-p file))
diff --git a/lisp/emacs-lisp/package.el b/lisp/emacs-lisp/package.el
index 1e136cb54f7..409dfedb74b 100644
--- a/lisp/emacs-lisp/package.el
+++ b/lisp/emacs-lisp/package.el
@@ -448,11 +448,11 @@ Slots:
448`summary' Short description of the package, typically taken from 448`summary' Short description of the package, typically taken from
449 the first line of the file. 449 the first line of the file.
450 450
451`reqs' Requirements of the package. A list of (PACKAGE 451`reqs' Requirements of the package. A list of (PACKAGE
452 VERSION-LIST) naming the dependent package and the minimum 452 VERSION-LIST) naming the dependent package and the minimum
453 required version. 453 required version.
454 454
455`kind' The distribution format of the package. Currently, it is 455`kind' The distribution format of the package. Currently, it is
456 either `single' or `tar'. 456 either `single' or `tar'.
457 457
458`archive' The name of the archive (as a string) whence this 458`archive' The name of the archive (as a string) whence this
@@ -980,7 +980,7 @@ untar into a directory named DIR; otherwise, signal an error."
980 auto-name)) 980 auto-name))
981 981
982(defun package--make-autoloads-and-stuff (pkg-desc pkg-dir) 982(defun package--make-autoloads-and-stuff (pkg-desc pkg-dir)
983 "Generate autoloads, description file, etc.. for PKG-DESC installed at PKG-DIR." 983 "Generate autoloads, description file, etc., for PKG-DESC installed at PKG-DIR."
984 (package-generate-autoloads (package-desc-name pkg-desc) pkg-dir) 984 (package-generate-autoloads (package-desc-name pkg-desc) pkg-dir)
985 (let ((desc-file (expand-file-name (package--description-file pkg-dir) 985 (let ((desc-file (expand-file-name (package--description-file pkg-dir)
986 pkg-dir))) 986 pkg-dir)))
@@ -2843,7 +2843,7 @@ If the name of a package matches any of these regexps it is
2843omitted from the package menu. To toggle this, type \\[package-menu-toggle-hiding]. 2843omitted from the package menu. To toggle this, type \\[package-menu-toggle-hiding].
2844 2844
2845Values can be interactively added to this list by typing 2845Values can be interactively added to this list by typing
2846\\[package-menu-hide-package] on a package" 2846\\[package-menu-hide-package] on a package."
2847 :version "25.1" 2847 :version "25.1"
2848 :type '(repeat (regexp :tag "Hide packages with name matching"))) 2848 :type '(repeat (regexp :tag "Hide packages with name matching")))
2849 2849
diff --git a/lisp/emacs-lisp/tcover-ses.el b/lisp/emacs-lisp/tcover-ses.el
index d34d30ff0f9..e18cc58b642 100644
--- a/lisp/emacs-lisp/tcover-ses.el
+++ b/lisp/emacs-lisp/tcover-ses.el
@@ -627,7 +627,7 @@ spreadsheet files with invalid formatting."
627 (error nil))))) 627 (error nil)))))
628 628
629(defun ses-exercise-startup () 629(defun ses-exercise-startup ()
630 "Prepare for coverage tests" 630 "Prepare for coverage tests."
631 ;;Clean up from any previous runs 631 ;;Clean up from any previous runs
632 (condition-case nil (kill-buffer "ses-example.ses") (error nil)) 632 (condition-case nil (kill-buffer "ses-example.ses") (error nil))
633 (condition-case nil (kill-buffer "ses-test.ses") (error nil)) 633 (condition-case nil (kill-buffer "ses-test.ses") (error nil))
diff --git a/lisp/emacs-lisp/testcover.el b/lisp/emacs-lisp/testcover.el
index 20851805f5c..16f19f7d503 100644
--- a/lisp/emacs-lisp/testcover.el
+++ b/lisp/emacs-lisp/testcover.el
@@ -150,12 +150,12 @@ call to one of the `testcover-1value-functions'."
150 150
151(defface testcover-nohits 151(defface testcover-nohits
152 '((t (:background "DeepPink2"))) 152 '((t (:background "DeepPink2")))
153 "Face for forms that had no hits during coverage test" 153 "Face for forms that had no hits during coverage test."
154 :group 'testcover) 154 :group 'testcover)
155 155
156(defface testcover-1value 156(defface testcover-1value
157 '((t (:background "Wheat2"))) 157 '((t (:background "Wheat2")))
158 "Face for forms that always produced the same value during coverage test" 158 "Face for forms that always produced the same value during coverage test."
159 :group 'testcover) 159 :group 'testcover)
160 160
161 161
diff --git a/lisp/epg.el b/lisp/epg.el
index 6d377d07e29..1a107600a5f 100644
--- a/lisp/epg.el
+++ b/lisp/epg.el
@@ -1902,7 +1902,7 @@ If you are unsure, use synchronous version of this function
1902 1902
1903(defun epg-receive-keys (context keys) 1903(defun epg-receive-keys (context keys)
1904 "Add keys from server. 1904 "Add keys from server.
1905KEYS is a list of key IDs" 1905KEYS is a list of key IDs."
1906 (unwind-protect 1906 (unwind-protect
1907 (progn 1907 (progn
1908 (epg-start-receive-keys context keys) 1908 (epg-start-receive-keys context keys)
@@ -2002,7 +2002,7 @@ PARAMETERS is a string which tells how to create the key."
2002(defun epg-start-edit-key (context key edit-callback handback) 2002(defun epg-start-edit-key (context key edit-callback handback)
2003 "Initiate an edit operation on KEY. 2003 "Initiate an edit operation on KEY.
2004 2004
2005EDIT-CALLBACK is called from process filter and takes 3 2005EDIT-CALLBACK is called from process filter and takes four
2006arguments: the context, a status, an argument string, and the 2006arguments: the context, a status, an argument string, and the
2007handback argument. 2007handback argument.
2008 2008
diff --git a/lisp/erc/erc-backend.el b/lisp/erc/erc-backend.el
index 210830a2b49..8b30834025f 100644
--- a/lisp/erc/erc-backend.el
+++ b/lisp/erc/erc-backend.el
@@ -261,7 +261,7 @@ but has not been processed yet.")
261 "Non-nil when we're currently processing a message. 261 "Non-nil when we're currently processing a message.
262 262
263When ERC receives a private message, it sets up a new buffer for 263When ERC receives a private message, it sets up a new buffer for
264this query. These in turn, though, do start flyspell. This 264this query. These in turn, though, do start flyspell. This
265involves starting an external process, in which case Emacs will 265involves starting an external process, in which case Emacs will
266wait - and when it waits, it does accept other stuff from, say, 266wait - and when it waits, it does accept other stuff from, say,
267network exceptions. So, if someone sends you two messages 267network exceptions. So, if someone sends you two messages
@@ -320,7 +320,7 @@ If a key is pressed while ERC is waiting, it will stop waiting."
320 "The maximum length of a single message. 320 "The maximum length of a single message.
321If a message exceeds this size, it is broken into multiple ones. 321If a message exceeds this size, it is broken into multiple ones.
322 322
323IRC allows for lines up to 512 bytes. Two of them are CR LF. 323IRC allows for lines up to 512 bytes. Two of them are CR LF.
324And a typical message looks like this: 324And a typical message looks like this:
325 325
326 :nicky!uhuser@host212223.dialin.fnordisp.net PRIVMSG #lazybastards :Hello! 326 :nicky!uhuser@host212223.dialin.fnordisp.net PRIVMSG #lazybastards :Hello!
@@ -347,8 +347,8 @@ This will only be consulted if the coding system in
347This is either a coding system, a cons, a function, or nil. 347This is either a coding system, a cons, a function, or nil.
348 348
349If a cons, the encoding system for outgoing text is in the car 349If a cons, the encoding system for outgoing text is in the car
350and the decoding system for incoming text is in the cdr. The most 350and the decoding system for incoming text is in the cdr. The most
351interesting use for this is to put `undecided' in the cdr. This 351interesting use for this is to put `undecided' in the cdr. This
352means that `erc-coding-system-precedence' will be consulted, and the 352means that `erc-coding-system-precedence' will be consulted, and the
353first match there will be used. 353first match there will be used.
354 354
@@ -795,7 +795,7 @@ Use DISPLAY-FN to show the results."
795(defun erc-server-send (string &optional forcep target) 795(defun erc-server-send (string &optional forcep target)
796 "Send STRING to the current server. 796 "Send STRING to the current server.
797If FORCEP is non-nil, no flood protection is done - the string is 797If FORCEP is non-nil, no flood protection is done - the string is
798sent directly. This might cause the messages to arrive in a wrong 798sent directly. This might cause the messages to arrive in a wrong
799order. 799order.
800 800
801If TARGET is specified, look up encoding information for that 801If TARGET is specified, look up encoding information for that
@@ -903,7 +903,7 @@ protection algorithm."
903 "Send LINE to the server as a privmsg or a notice. 903 "Send LINE to the server as a privmsg or a notice.
904MESSAGE-COMMAND should be either \"PRIVMSG\" or \"NOTICE\". 904MESSAGE-COMMAND should be either \"PRIVMSG\" or \"NOTICE\".
905If the target is \",\", the last person you've got a message from will 905If the target is \",\", the last person you've got a message from will
906be used. If the target is \".\", the last person you've sent a message 906be used. If the target is \".\", the last person you've sent a message
907to will be used." 907to will be used."
908 (cond 908 (cond
909 ((string-match "^\\s-*\\(\\S-+\\) ?\\(.*\\)" line) 909 ((string-match "^\\s-*\\(\\S-+\\) ?\\(.*\\)" line)
diff --git a/lisp/erc/erc-button.el b/lisp/erc/erc-button.el
index 726d9674d40..2dbf13cfdfd 100644
--- a/lisp/erc/erc-button.el
+++ b/lisp/erc/erc-button.el
@@ -71,7 +71,7 @@
71 "Face used for highlighting buttons in ERC buffers. 71 "Face used for highlighting buttons in ERC buffers.
72 72
73A button is a piece of text that you can activate by pressing 73A button is a piece of text that you can activate by pressing
74`RET' or `mouse-2' above it. See also `erc-button-keymap'." 74`RET' or `mouse-2' above it. See also `erc-button-keymap'."
75 :type 'face 75 :type 'face
76 :group 'erc-faces) 76 :group 'erc-faces)
77 77
@@ -169,10 +169,10 @@ REGEXP is the string matching text around the button or a symbol
169 current server. 169 current server.
170 170
171BUTTON is the number of the regexp grouping actually matching the 171BUTTON is the number of the regexp grouping actually matching the
172 button, This is ignored if REGEXP is \\='nicknames. 172 button. This is ignored if REGEXP is \\='nicknames.
173 173
174FORM is a lisp expression which must eval to true for the button to 174FORM is a lisp expression which must eval to true for the button to
175 be added, 175 be added.
176 176
177CALLBACK is the function to call when the user push this button. 177CALLBACK is the function to call when the user push this button.
178 CALLBACK can also be a symbol. Its variable value will be used 178 CALLBACK can also be a symbol. Its variable value will be used
@@ -459,7 +459,7 @@ For use on `completion-at-point-functions'."
459 t))) 459 t)))
460 460
461(defun erc-browse-emacswiki (thing) 461(defun erc-browse-emacswiki (thing)
462 "Browse to thing in the emacs-wiki." 462 "Browse to THING in the emacs-wiki."
463 (browse-url (concat erc-emacswiki-url thing))) 463 (browse-url (concat erc-emacswiki-url thing)))
464 464
465(defun erc-browse-emacswiki-lisp (thing) 465(defun erc-browse-emacswiki-lisp (thing)
diff --git a/lisp/erc/erc-ezbounce.el b/lisp/erc/erc-ezbounce.el
index a2c9336826a..899ea2f6b5f 100644
--- a/lisp/erc/erc-ezbounce.el
+++ b/lisp/erc/erc-ezbounce.el
@@ -28,7 +28,7 @@
28(require 'erc) 28(require 'erc)
29 29
30(defgroup erc-ezbounce nil 30(defgroup erc-ezbounce nil
31 "Interface to the EZBounce IRC bouncer (a virtual IRC server)" 31 "Interface to the EZBounce IRC bouncer (a virtual IRC server)."
32 :group 'erc) 32 :group 'erc)
33 33
34(defcustom erc-ezb-regexp "^ezbounce!srv$" 34(defcustom erc-ezb-regexp "^ezbounce!srv$"
@@ -77,7 +77,7 @@ The alist's format is as follows:
77;;;###autoload 77;;;###autoload
78(defun erc-ezb-get-login (server port) 78(defun erc-ezb-get-login (server port)
79 "Return an appropriate EZBounce login for SERVER and PORT. 79 "Return an appropriate EZBounce login for SERVER and PORT.
80Look up entries in `erc-ezb-login-alist'. If the username or password 80Look up entries in `erc-ezb-login-alist'. If the username or password
81in the alist is nil, prompt for the appropriate values." 81in the alist is nil, prompt for the appropriate values."
82 (let ((login (cdr (assoc (cons server port) erc-ezb-login-alist)))) 82 (let ((login (cdr (assoc (cons server port) erc-ezb-login-alist))))
83 (when login 83 (when login
diff --git a/lisp/erc/erc-fill.el b/lisp/erc/erc-fill.el
index 934b52a938c..705c7e69bb5 100644
--- a/lisp/erc/erc-fill.el
+++ b/lisp/erc/erc-fill.el
@@ -109,7 +109,7 @@ nick names right and text left."
109 109
110(defcustom erc-fill-variable-maximum-indentation 17 110(defcustom erc-fill-variable-maximum-indentation 17
111 "If we indent a line after a long nick, don't indent more then this 111 "If we indent a line after a long nick, don't indent more then this
112characters. Set to nil to disable." 112characters. Set to nil to disable."
113 :group 'erc-fill 113 :group 'erc-fill
114 :type 'integer) 114 :type 'integer)
115 115
diff --git a/lisp/erc/erc-log.el b/lisp/erc/erc-log.el
index 1c046fe20cb..2b9a0aae1da 100644
--- a/lisp/erc/erc-log.el
+++ b/lisp/erc/erc-log.el
@@ -340,7 +340,7 @@ filename is downcased."
340 "Return the logfile to use for BUFFER. 340 "Return the logfile to use for BUFFER.
341If BUFFER is nil, the value of `current-buffer' is used. 341If BUFFER is nil, the value of `current-buffer' is used.
342This is determined by `erc-generate-log-file-name-function'. 342This is determined by `erc-generate-log-file-name-function'.
343The result is converted to lowercase, as IRC is case-insensitive" 343The result is converted to lowercase, as IRC is case-insensitive."
344 (unless buffer (setq buffer (current-buffer))) 344 (unless buffer (setq buffer (current-buffer)))
345 (with-current-buffer buffer 345 (with-current-buffer buffer
346 (let ((target (or (buffer-name buffer) (erc-default-target))) 346 (let ((target (or (buffer-name buffer) (erc-default-target)))
diff --git a/lisp/erc/erc-match.el b/lisp/erc/erc-match.el
index cc4b4a88f11..092b5953c42 100644
--- a/lisp/erc/erc-match.el
+++ b/lisp/erc/erc-match.el
@@ -199,8 +199,8 @@ When `away', log messages only when away."
199 199
200(defcustom erc-log-match-format "%t<%n:%c> %m" 200(defcustom erc-log-match-format "%t<%n:%c> %m"
201 "Format for matched Messages. 201 "Format for matched Messages.
202This variable specifies how messages in the corresponding log buffers will 202This variable specifies how messages in the corresponding log buffers
203be formatted. The various format specs are: 203will be formatted. The various format specs are:
204 204
205%t Timestamp (uses `erc-timestamp-format' if non-nil or \"[%Y-%m-%d %H:%M] \") 205%t Timestamp (uses `erc-timestamp-format' if non-nil or \"[%Y-%m-%d %H:%M] \")
206%n Nickname of sender 206%n Nickname of sender
@@ -227,7 +227,7 @@ for beeping to work."
227 "Hook run when text matches a given match-type. 227 "Hook run when text matches a given match-type.
228Functions in this hook are passed as arguments: 228Functions in this hook are passed as arguments:
229\(match-type nick!user@host message) where MATCH-TYPE is a symbol of: 229\(match-type nick!user@host message) where MATCH-TYPE is a symbol of:
230current-nick, keyword, pal, dangerous-host, fool" 230current-nick, keyword, pal, dangerous-host, fool."
231 :options '(erc-log-matches erc-hide-fools erc-beep-on-match) 231 :options '(erc-log-matches erc-hide-fools erc-beep-on-match)
232 :group 'erc-match 232 :group 'erc-match
233 :type 'hook) 233 :type 'hook)
diff --git a/lisp/erc/erc-netsplit.el b/lisp/erc/erc-netsplit.el
index 87c3a61b663..305fdf9d945 100644
--- a/lisp/erc/erc-netsplit.el
+++ b/lisp/erc/erc-netsplit.el
@@ -33,9 +33,9 @@
33(require 'erc) 33(require 'erc)
34 34
35(defgroup erc-netsplit nil 35(defgroup erc-netsplit nil
36 "Netsplit detection tries to automatically figure when a 36 "Netsplit detection tries to automatically figure when a netsplit
37netsplit happens, and filters the QUIT messages. It also keeps 37happens, and filters the QUIT messages. It also keeps track of
38track of netsplits, so that it can filter the JOIN messages on a netjoin too." 38netsplits, so that it can filter the JOIN messages on a netjoin too."
39 :group 'erc) 39 :group 'erc)
40 40
41;;;###autoload(autoload 'erc-netsplit-mode "erc-netsplit") 41;;;###autoload(autoload 'erc-netsplit-mode "erc-netsplit")
@@ -57,8 +57,7 @@ track of netsplits, so that it can filter the JOIN messages on a netjoin too."
57 :type 'boolean) 57 :type 'boolean)
58 58
59(defcustom erc-netsplit-debug nil 59(defcustom erc-netsplit-debug nil
60 "If non-nil, debug messages will be shown in the 60 "If non-nil, debug messages will be shown in the sever buffer."
61sever buffer."
62 :group 'erc-netsplit 61 :group 'erc-netsplit
63 :type 'boolean) 62 :type 'boolean)
64 63
diff --git a/lisp/erc/erc-networks.el b/lisp/erc/erc-networks.el
index eca8ad6a899..3ba5ce4e5e7 100644
--- a/lisp/erc/erc-networks.el
+++ b/lisp/erc/erc-networks.el
@@ -436,10 +436,11 @@
436 ("ZiRC: Random server" ZiRC "irc.zirc.org" ((6660 6669))) 436 ("ZiRC: Random server" ZiRC "irc.zirc.org" ((6660 6669)))
437 ("ZUHnet: Random server" ZUHnet "irc.zuh.net" 6667) 437 ("ZUHnet: Random server" ZUHnet "irc.zuh.net" 6667)
438 ("Zurna: Random server" Zurna "irc.zurna.net" 6667)) 438 ("Zurna: Random server" Zurna "irc.zurna.net" 6667))
439 "Alist of irc servers. (NAME NET HOST PORTS) where 439 "Alist of irc servers.
440Each server is a list (NAME NET HOST PORTS) where
440NAME is a name for that server, 441NAME is a name for that server,
441NET is a symbol indicating to which network from `erc-networks-alist' this 442NET is a symbol indicating to which network from `erc-networks-alist'
442 server corresponds, 443 this server corresponds,
443HOST is the servers hostname and 444HOST is the servers hostname and
444PORTS is either a number, a list of numbers, or a list of port ranges." 445PORTS is either a number, a list of numbers, or a list of port ranges."
445 :group 'erc-networks 446 :group 'erc-networks
@@ -706,12 +707,13 @@ PORTS is either a number, a list of numbers, or a list of port ranges."
706 (ZiRC "zirc.org") 707 (ZiRC "zirc.org")
707 (ZUHnet "zuh.net") 708 (ZUHnet "zuh.net")
708 (Zurna "zurna.net")) 709 (Zurna "zurna.net"))
709 "Alist of IRC networks. (NET MATCHER) where 710 "Alist of IRC networks.
711Each network is a list (NET MATCHER) where
710NET is a symbol naming that IRC network and 712NET is a symbol naming that IRC network and
711MATCHER is used to find a corresponding network to a server while connected to 713MATCHER is used to find a corresponding network to a server while
712 it. If it is regexp, it's used to match against `erc-server-announced-name'. 714 connected to it. If it is regexp, it's used to match against
713 It can also be a function (predicate). Then it is executed with the 715 `erc-server-announced-name'. It can also be a function (predicate).
714 server buffer as current-buffer." 716 Then it is executed with the server buffer as current-buffer."
715 :group 'erc-networks 717 :group 'erc-networks
716 :type '(repeat 718 :type '(repeat
717 (list :tag "Network" 719 (list :tag "Network"
@@ -749,8 +751,8 @@ search for a match in `erc-networks-alist'."
749 (erc-with-server-buffer erc-network)) 751 (erc-with-server-buffer erc-network))
750 752
751(defun erc-current-network () 753(defun erc-current-network ()
752 "Deprecated. Use `erc-network' instead. Return the name of this server's 754 "Deprecated. Use `erc-network' instead.
753network as a symbol." 755Return the name of this server's network as a symbol."
754 (erc-with-server-buffer 756 (erc-with-server-buffer
755 (intern (downcase (symbol-name erc-network))))) 757 (intern (downcase (symbol-name erc-network)))))
756 758
diff --git a/lisp/erc/erc-ring.el b/lisp/erc/erc-ring.el
index 453e234a37a..c5d62ccfea9 100644
--- a/lisp/erc/erc-ring.el
+++ b/lisp/erc/erc-ring.el
@@ -59,7 +59,7 @@ be recalled using M-p and M-n."
59(defvar erc-input-ring-index nil 59(defvar erc-input-ring-index nil
60 "Position in the input ring for erc. 60 "Position in the input ring for erc.
61If nil, the input line is blank and the user is conceptually after 61If nil, the input line is blank and the user is conceptually after
62the most recently added item in the ring. If an integer, the input 62the most recently added item in the ring. If an integer, the input
63line is non-blank and displays the item from the ring indexed by this 63line is non-blank and displays the item from the ring indexed by this
64variable.") 64variable.")
65(make-variable-buffer-local 'erc-input-ring-index) 65(make-variable-buffer-local 'erc-input-ring-index)
diff --git a/lisp/erc/erc-speedbar.el b/lisp/erc/erc-speedbar.el
index 8d56c85bec4..a1e10ca3a24 100644
--- a/lisp/erc/erc-speedbar.el
+++ b/lisp/erc/erc-speedbar.el
@@ -42,7 +42,7 @@
42;;; Customization: 42;;; Customization:
43 43
44(defgroup erc-speedbar nil 44(defgroup erc-speedbar nil
45 "Integration of ERC in the Speedbar" 45 "Integration of ERC in the Speedbar."
46 :group 'erc) 46 :group 'erc)
47 47
48(defcustom erc-speedbar-sort-users-type 'activity 48(defcustom erc-speedbar-sort-users-type 'activity
@@ -270,8 +270,8 @@ INDENT is the current indentation level."
270 indent)))) 270 indent))))
271 271
272(defun erc-speedbar-update-channel (buffer) 272(defun erc-speedbar-update-channel (buffer)
273 "Update the speedbar information about a ERC buffer. The update 273 "Update the speedbar information about a ERC buffer.
274is only done when the channel is actually expanded already." 274The update is only done when the channel is actually expanded already."
275 ;; This is only a rude hack and doesn't care about multiserver usage 275 ;; This is only a rude hack and doesn't care about multiserver usage
276 ;; yet, consider this a brain storming, better ideas? 276 ;; yet, consider this a brain storming, better ideas?
277 (with-current-buffer speedbar-buffer 277 (with-current-buffer speedbar-buffer
diff --git a/lisp/erc/erc-stamp.el b/lisp/erc/erc-stamp.el
index a15d8bf7b31..ee177e3acb5 100644
--- a/lisp/erc/erc-stamp.el
+++ b/lisp/erc/erc-stamp.el
@@ -212,7 +212,7 @@ This is used when `erc-insert-timestamp-function' is set to
212 "Insert timestamp only if its value changed since last insertion. 212 "Insert timestamp only if its value changed since last insertion.
213If `erc-insert-timestamp-function' is `erc-insert-timestamp-left', a 213If `erc-insert-timestamp-function' is `erc-insert-timestamp-left', a
214string of spaces which is the same size as the timestamp is added to 214string of spaces which is the same size as the timestamp is added to
215the beginning of the line in its place. If you use 215the beginning of the line in its place. If you use
216`erc-insert-timestamp-right', nothing gets inserted in place of the 216`erc-insert-timestamp-right', nothing gets inserted in place of the
217timestamp." 217timestamp."
218 :group 'erc-stamp 218 :group 'erc-stamp
diff --git a/lisp/erc/erc-track.el b/lisp/erc/erc-track.el
index 53a59207839..055c2eb4850 100644
--- a/lisp/erc/erc-track.el
+++ b/lisp/erc/erc-track.el
@@ -245,7 +245,7 @@ The effect may be disabled by setting this variable to nil."
245(defcustom erc-track-position-in-mode-line 'before-modes 245(defcustom erc-track-position-in-mode-line 'before-modes
246 "Where to show modified channel information in the mode-line. 246 "Where to show modified channel information in the mode-line.
247 247
248Setting this variable only has effects in GNU Emacs versions above 21.3. 248Setting this variable only has effect in GNU Emacs versions above 21.3.
249 249
250Choices are: 250Choices are:
251`before-modes' - add to the beginning of `mode-line-modes', 251`before-modes' - add to the beginning of `mode-line-modes',
@@ -328,7 +328,7 @@ important."
328 328
329 329
330(defun erc-track-remove-from-mode-line () 330(defun erc-track-remove-from-mode-line ()
331 "Remove `erc-track-modified-channels' from the mode-line" 331 "Remove `erc-track-modified-channels' from the mode-line."
332 (when (boundp 'mode-line-modes) 332 (when (boundp 'mode-line-modes)
333 (setq mode-line-modes 333 (setq mode-line-modes
334 (remove '(t erc-modified-channels-object) mode-line-modes))) 334 (remove '(t erc-modified-channels-object) mode-line-modes)))
@@ -628,7 +628,7 @@ because the debugger also causes changes to the window-configuration.")
628(defun erc-modified-channels-update (&rest _args) 628(defun erc-modified-channels-update (&rest _args)
629 "This function updates the information in `erc-modified-channels-alist' 629 "This function updates the information in `erc-modified-channels-alist'
630according to buffer visibility. It calls 630according to buffer visibility. It calls
631`erc-modified-channels-display' at the end. This should usually be 631`erc-modified-channels-display' at the end. This should usually be
632called via `window-configuration-change-hook'. 632called via `window-configuration-change-hook'.
633ARGS are ignored." 633ARGS are ignored."
634 (interactive) 634 (interactive)
@@ -864,7 +864,7 @@ is in `erc-mode'."
864 864
865(defvar erc-track-last-non-erc-buffer nil 865(defvar erc-track-last-non-erc-buffer nil
866 "Stores the name of the last buffer you were in before activating 866 "Stores the name of the last buffer you were in before activating
867`erc-track-switch-buffers'") 867`erc-track-switch-buffers'.")
868 868
869(defun erc-track-sort-by-activest () 869(defun erc-track-sort-by-activest ()
870 "Sort erc-modified-channels-alist by activity. 870 "Sort erc-modified-channels-alist by activity.
@@ -889,7 +889,7 @@ higher number than any other face in that list."
889 count)) 889 count))
890 890
891(defun erc-track-sort-by-importance () 891(defun erc-track-sort-by-importance ()
892 "Sort erc-modified-channels-alist by importance. 892 "Sort `erc-modified-channels-alist' by importance.
893That means the position of the face in `erc-track-faces-priority-list'." 893That means the position of the face in `erc-track-faces-priority-list'."
894 (setq erc-modified-channels-alist 894 (setq erc-modified-channels-alist
895 (sort erc-modified-channels-alist 895 (sort erc-modified-channels-alist
@@ -898,8 +898,8 @@ That means the position of the face in `erc-track-faces-priority-list'."
898 898
899(defun erc-track-get-active-buffer (arg) 899(defun erc-track-get-active-buffer (arg)
900 "Return the buffer name of ARG in `erc-modified-channels-alist'. 900 "Return the buffer name of ARG in `erc-modified-channels-alist'.
901Negative arguments index in the opposite direction. This direction is 901Negative arguments index in the opposite direction. This direction
902relative to `erc-track-switch-direction'" 902is relative to `erc-track-switch-direction'."
903 (let ((dir erc-track-switch-direction) 903 (let ((dir erc-track-switch-direction)
904 offset) 904 offset)
905 (when (< arg 0) 905 (when (< arg 0)
diff --git a/lisp/erc/erc.el b/lisp/erc/erc.el
index fd1bd5545da..74376b0cb3a 100644
--- a/lisp/erc/erc.el
+++ b/lisp/erc/erc.el
@@ -558,7 +558,7 @@ of the list is of the form (USER . CHANNEL-DATA), where USER is
558an erc-server-user struct, and CHANNEL-DATA is either nil or an 558an erc-server-user struct, and CHANNEL-DATA is either nil or an
559erc-channel-user struct. 559erc-channel-user struct.
560 560
561See also: `erc-sort-channel-users-by-activity'" 561See also: `erc-sort-channel-users-by-activity'."
562 (let (users) 562 (let (users)
563 (if (hash-table-p erc-channel-users) 563 (if (hash-table-p erc-channel-users)
564 (maphash (lambda (_nick cdata) 564 (maphash (lambda (_nick cdata)
@@ -739,7 +739,7 @@ See also: `erc-echo-notice-always-hook',
739`erc-echo-notice-in-active-buffer', 739`erc-echo-notice-in-active-buffer',
740`erc-echo-notice-in-user-buffers', 740`erc-echo-notice-in-user-buffers',
741`erc-echo-notice-in-user-and-target-buffers', 741`erc-echo-notice-in-user-and-target-buffers',
742`erc-echo-notice-in-first-user-buffer'" 742`erc-echo-notice-in-first-user-buffer'."
743 :group 'erc-hooks 743 :group 'erc-hooks
744 :type 'hook 744 :type 'hook
745 :options '(erc-echo-notice-in-default-buffer 745 :options '(erc-echo-notice-in-default-buffer
@@ -770,7 +770,7 @@ See also: `erc-echo-notice-hook',
770`erc-echo-notice-in-active-buffer', 770`erc-echo-notice-in-active-buffer',
771`erc-echo-notice-in-user-buffers', 771`erc-echo-notice-in-user-buffers',
772`erc-echo-notice-in-user-and-target-buffers', 772`erc-echo-notice-in-user-and-target-buffers',
773`erc-echo-notice-in-first-user-buffer'" 773`erc-echo-notice-in-first-user-buffer'."
774 :group 'erc-hooks 774 :group 'erc-hooks
775 :type 'hook 775 :type 'hook
776 :options '(erc-echo-notice-in-default-buffer 776 :options '(erc-echo-notice-in-default-buffer
@@ -4194,7 +4194,7 @@ Only happens when the session buffer isn't visible."
4194Specifically in relation to NICK (user@host) information. Returns REASON 4194Specifically in relation to NICK (user@host) information. Returns REASON
4195unmodified if nothing can be removed. 4195unmodified if nothing can be removed.
4196E.g. \"Read error to Nick [user@some.host]: 110\" would be shortened to 4196E.g. \"Read error to Nick [user@some.host]: 110\" would be shortened to
4197\"Read error: 110\". The same applies for \"Ping Timeout\"." 4197\"Read error: 110\". The same applies for \"Ping Timeout\"."
4198 (setq nick (regexp-quote nick) 4198 (setq nick (regexp-quote nick)
4199 login (regexp-quote login) 4199 login (regexp-quote login)
4200 host (regexp-quote host)) 4200 host (regexp-quote host))
@@ -4337,7 +4337,7 @@ See also `erc-format-nick-function'."
4337 4337
4338(defun erc-format-@nick (&optional user _channel-data) 4338(defun erc-format-@nick (&optional user _channel-data)
4339 "Format the nickname of USER showing if USER has a voice, is an 4339 "Format the nickname of USER showing if USER has a voice, is an
4340operator, half-op, admin or owner. Owners have \"~\", admins have 4340operator, half-op, admin or owner. Owners have \"~\", admins have
4341\"&\", operators have \"@\" and users with voice have \"+\" as a 4341\"&\", operators have \"@\" and users with voice have \"+\" as a
4342prefix. Use CHANNEL-DATA to determine op and voice status. See 4342prefix. Use CHANNEL-DATA to determine op and voice status. See
4343also `erc-format-nick-function'." 4343also `erc-format-nick-function'."
diff --git a/lisp/ffap.el b/lisp/ffap.el
index 33854a6c0d4..5b4e8b5fca0 100644
--- a/lisp/ffap.el
+++ b/lisp/ffap.el
@@ -950,7 +950,7 @@ appending SUFFIX.")
950 950
951(defun ffap-latex-mode (name) 951(defun ffap-latex-mode (name)
952 "`ffap' function suitable for latex buffers. 952 "`ffap' function suitable for latex buffers.
953This uses the program kpsewhich if available. In this case, the 953This uses the program kpsewhich if available. In this case, the
954variable `ffap-latex-guess-rules' is used for building a filename 954variable `ffap-latex-guess-rules' is used for building a filename
955out of NAME." 955out of NAME."
956 (cond ((file-exists-p name) 956 (cond ((file-exists-p name)
diff --git a/lisp/files.el b/lisp/files.el
index 5ceaacd744e..0c3da1fe3cc 100644
--- a/lisp/files.el
+++ b/lisp/files.el
@@ -2132,9 +2132,9 @@ think it does, because \"free\" is pretty hard to define in practice."
2132 "If file SIZE larger than `large-file-warning-threshold', allow user to abort. 2132 "If file SIZE larger than `large-file-warning-threshold', allow user to abort.
2133OP-TYPE specifies the file operation being performed (for message 2133OP-TYPE specifies the file operation being performed (for message
2134to user). If OFFER-RAW is true, give user the additional option 2134to user). If OFFER-RAW is true, give user the additional option
2135to open the file literally. If the user chooses this option, 2135to open the file literally. If the user chooses this option,
2136`abort-if-file-too-large' returns the symbol `raw'. Otherwise, it 2136`abort-if-file-too-large' returns the symbol `raw'. Otherwise,
2137returns nil or exits non-locally." 2137it returns nil or exits non-locally."
2138 (let ((choice (and large-file-warning-threshold size 2138 (let ((choice (and large-file-warning-threshold size
2139 (> size large-file-warning-threshold) 2139 (> size large-file-warning-threshold)
2140 ;; No point in warning if we can't read it. 2140 ;; No point in warning if we can't read it.
@@ -4177,8 +4177,8 @@ This function returns either:
4177NODE is assumed to be a cons cell where the car is either a 4177NODE is assumed to be a cons cell where the car is either a
4178string or a symbol representing a mode name. 4178string or a symbol representing a mode name.
4179 4179
4180If it is a mode then the the depth of the mode (ie, how many 4180If it is a mode then the depth of the mode (ie, how many parents
4181parents that mode has) will be returned. 4181that mode has) will be returned.
4182 4182
4183If it is a string then the length of the string plus 1000 will be 4183If it is a string then the length of the string plus 1000 will be
4184returned. 4184returned.
@@ -5934,7 +5934,7 @@ This returns non-nil if the current buffer is visiting a readable file
5934whose modification time does not match that of the buffer. 5934whose modification time does not match that of the buffer.
5935 5935
5936This function only handles buffers that are visiting files. 5936This function only handles buffers that are visiting files.
5937Non-file buffers need a custom function" 5937Non-file buffers need a custom function."
5938 (and buffer-file-name 5938 (and buffer-file-name
5939 (file-readable-p buffer-file-name) 5939 (file-readable-p buffer-file-name)
5940 (not (buffer-modified-p (current-buffer))) 5940 (not (buffer-modified-p (current-buffer)))
diff --git a/lisp/filesets.el b/lisp/filesets.el
index b74b4a8a400..c05fff3fb74 100644
--- a/lisp/filesets.el
+++ b/lisp/filesets.el
@@ -545,8 +545,8 @@ computer environments."
545(defcustom filesets-tree-max-level 3 545(defcustom filesets-tree-max-level 3
546 "Maximum scan depth for directory trees. 546 "Maximum scan depth for directory trees.
547A :tree fileset is defined by a base directory the contents of which 547A :tree fileset is defined by a base directory the contents of which
548will be recursively added to the menu. `filesets-tree-max-level' tells up 548will be recursively added to the menu. `filesets-tree-max-level' tells
549to which level the directory structure should be scanned/listed, 549up to which level the directory structure should be scanned/listed,
550i.e. how deep the menu should be. Try something like 550i.e. how deep the menu should be. Try something like
551 551
552 (\"HOME -- only one level\" 552 (\"HOME -- only one level\"
@@ -966,11 +966,11 @@ Example definition:
966`filesets-data' is a list of (NAME-AS-STRING . DEFINITION), DEFINITION 966`filesets-data' is a list of (NAME-AS-STRING . DEFINITION), DEFINITION
967being an association list with the fields: 967being an association list with the fields:
968 968
969:files FILE-1 .. FILE-N ... a list of files belonging to a fileset 969:files FILE-1 .. FILE-N ... a list of files belonging to a fileset.
970 970
971:ingroup FILE-NAME ... an inclusion group's base file. 971:ingroup FILE-NAME ... an inclusion group's base file.
972 972
973:tree ROOT-DIR PATTERN ... a base directory and a file pattern 973:tree ROOT-DIR PATTERN ... a base directory and a file pattern.
974 974
975:pattern DIR PATTERN ... a base directory and a regexp matching 975:pattern DIR PATTERN ... a base directory and a regexp matching
976 files in that directory. Usually, 976 files in that directory. Usually,
@@ -981,17 +981,17 @@ being an association list with the fields:
981:filter-dirs-flag BOOLEAN ... is only used in conjunction with :tree. 981:filter-dirs-flag BOOLEAN ... is only used in conjunction with :tree.
982 982
983:tree-max-level INTEGER ... recurse into directories this many levels 983:tree-max-level INTEGER ... recurse into directories this many levels
984\(see `filesets-tree-max-level' for a full explanation) 984\(see `filesets-tree-max-level' for a full explanation).
985 985
986:dormant-flag BOOLEAN ... non-nil means don't show this item in the 986:dormant-flag BOOLEAN ... non-nil means don't show this item in the
987menu; dormant filesets can still be manipulated via commands available 987menu; dormant filesets can still be manipulated via commands available
988from the minibuffer -- e.g. `filesets-open', `filesets-close', or 988from the minibuffer -- e.g. `filesets-open', `filesets-close', or
989`filesets-run-cmd' 989`filesets-run-cmd'.
990 990
991:dormant-p FUNCTION ... a function returning :dormant-flag 991:dormant-p FUNCTION ... a function returning :dormant-flag.
992 992
993:open FUNCTION ... the function used to open file belonging to this 993:open FUNCTION ... the function used to open file belonging to this
994fileset. The function takes a file name as argument 994fileset. The function takes a file name as argument.
995 995
996:save FUNCTION ... the function used to save file belonging to this 996:save FUNCTION ... the function used to save file belonging to this
997fileset; it takes no arguments, but works on the current buffer. 997fileset; it takes no arguments, but works on the current buffer.
@@ -1003,7 +1003,8 @@ optional.
1003 1003
1004In conjunction with the :tree tag, :save is void. :open refers to the 1004In conjunction with the :tree tag, :save is void. :open refers to the
1005function used for opening files in a directory, not for opening the 1005function used for opening files in a directory, not for opening the
1006directory. For browsing directories, `filesets-browse-dir-function' is used. 1006directory. For browsing directories, `filesets-browse-dir-function'
1007is used.
1007 1008
1008Before using :ingroup, make sure that the file type is already 1009Before using :ingroup, make sure that the file type is already
1009defined in `filesets-ingroup-patterns'." 1010defined in `filesets-ingroup-patterns'."
@@ -2440,10 +2441,10 @@ fileset thinks this is necessary or not."
2440"Filesets: manual editing of user data required! 2441"Filesets: manual editing of user data required!
2441 2442
2442Filesets has detected that you were using an older version before, 2443Filesets has detected that you were using an older version before,
2443which requires some manual updating. Type `y' for editing the startup 2444which requires some manual updating. Type `y' for editing the startup
2444file now. 2445file now.
2445 2446
2446The layout of `filesets-data' has changed. Please delete your cache file 2447The layout of `filesets-data' has changed. Please delete your cache file
2447and edit your startup file as shown below: 2448and edit your startup file as shown below:
2448 2449
24491. `filesets-data': Edit all :pattern filesets in your startup file and 24501. `filesets-data': Edit all :pattern filesets in your startup file and
diff --git a/lisp/gnus/gnus-agent.el b/lisp/gnus/gnus-agent.el
index dd30dda2a10..1f252552784 100644
--- a/lisp/gnus/gnus-agent.el
+++ b/lisp/gnus/gnus-agent.el
@@ -1739,9 +1739,9 @@ the article files."
1739(defun gnus-agent-flush-cache () 1739(defun gnus-agent-flush-cache ()
1740 "Flush the agent's index files such that the group no longer 1740 "Flush the agent's index files such that the group no longer
1741appears to have any local content. The actual content, the 1741appears to have any local content. The actual content, the
1742article files, is then deleted using gnus-agent-expire-group. The 1742article files, is then deleted using gnus-agent-expire-group.
1743gnus-agent-regenerate-group method provides an undo mechanism by 1743The gnus-agent-regenerate-group method provides an undo mechanism
1744reconstructing the index files from the article files." 1744by reconstructing the index files from the article files."
1745 (interactive) 1745 (interactive)
1746 (save-excursion 1746 (save-excursion
1747 (let ((file-name-coding-system nnmail-pathname-coding-system)) 1747 (let ((file-name-coding-system nnmail-pathname-coding-system))
diff --git a/lisp/gnus/gnus-art.el b/lisp/gnus/gnus-art.el
index eba66c1c3aa..07ec2696469 100644
--- a/lisp/gnus/gnus-art.el
+++ b/lisp/gnus/gnus-art.el
@@ -1594,7 +1594,7 @@ predicate. See Info node `(gnus)Customizing Articles'."
1594;; gnus-article-encrypt-protocol-alist. 1594;; gnus-article-encrypt-protocol-alist.
1595(defcustom gnus-article-encrypt-protocol "PGP" 1595(defcustom gnus-article-encrypt-protocol "PGP"
1596 "The protocol used for encrypt articles. 1596 "The protocol used for encrypt articles.
1597It is a string, such as \"PGP\". If nil, ask user." 1597It is a string, such as \"PGP\". If nil, ask user."
1598 :version "22.1" 1598 :version "22.1"
1599 :type 'string 1599 :type 'string
1600 :group 'mime-security) 1600 :group 'mime-security)
@@ -7374,7 +7374,7 @@ man page."
7374Strings like this can be either a message ID or a mail address. If it is one 7374Strings like this can be either a message ID or a mail address. If it is one
7375of the symbols `mid' or `mail', Gnus will always assume that the string is a 7375of the symbols `mid' or `mail', Gnus will always assume that the string is a
7376message ID or a mail address, respectively. If this variable is set to the 7376message ID or a mail address, respectively. If this variable is set to the
7377symbol `ask', always query the user what do do. If it is a function, this 7377symbol `ask', always query the user what to do. If it is a function, this
7378function will be called with the string as its only argument. The function 7378function will be called with the string as its only argument. The function
7379must return `mid', `mail', `invalid' or `ask'." 7379must return `mid', `mail', `invalid' or `ask'."
7380 :version "22.1" 7380 :version "22.1"
diff --git a/lisp/gnus/gnus-cus.el b/lisp/gnus/gnus-cus.el
index a4daf8cf483..2e3fbfe9d46 100644
--- a/lisp/gnus/gnus-cus.el
+++ b/lisp/gnus/gnus-cus.el
@@ -190,7 +190,7 @@ Which articles to display on entering the group.
190 unread and ticked articles. 190 unread and ticked articles.
191 191
192`Other' 192`Other'
193 Display the articles that satisfy the S-expression. The S-expression 193 Display the articles that satisfy the S-expression. The S-expression
194 should be in an array form.") 194 should be in an array form.")
195 195
196 (comment (string :tag "Comment") "\ 196 (comment (string :tag "Comment") "\
diff --git a/lisp/gnus/gnus-demon.el b/lisp/gnus/gnus-demon.el
index 6007e18f558..7ec471afc71 100644
--- a/lisp/gnus/gnus-demon.el
+++ b/lisp/gnus/gnus-demon.el
@@ -44,7 +44,7 @@ Each handler is a list on the form
44 44
45FUNCTION is the function to be called. TIME is the number of 45FUNCTION is the function to be called. TIME is the number of
46`gnus-demon-timestep's between each call. 46`gnus-demon-timestep's between each call.
47If nil, never call. If t, call each `gnus-demon-timestep'. 47If nil, never call. If t, call each `gnus-demon-timestep'.
48 48
49If IDLE is t, only call each time Emacs has been idle for TIME. 49If IDLE is t, only call each time Emacs has been idle for TIME.
50If IDLE is a number, only call when Emacs has been idle more than 50If IDLE is a number, only call when Emacs has been idle more than
@@ -98,8 +98,8 @@ Emacs has been idle for IDLE `gnus-demon-timestep's."
98(defun gnus-demon-run-callback (func &optional idle time special) 98(defun gnus-demon-run-callback (func &optional idle time special)
99 "Run FUNC if Emacs has been idle for longer than IDLE seconds. 99 "Run FUNC if Emacs has been idle for longer than IDLE seconds.
100If not, and a TIME is given, restart a new idle timer, so FUNC 100If not, and a TIME is given, restart a new idle timer, so FUNC
101can be called at the next opportunity. Such a special idle run is 101can be called at the next opportunity. Such a special idle run
102marked with SPECIAL." 102is marked with SPECIAL."
103 (unless gnus-inhibit-demon 103 (unless gnus-inhibit-demon
104 (cl-block run-callback 104 (cl-block run-callback
105 (when (eq idle t) 105 (when (eq idle t)
diff --git a/lisp/gnus/gnus-dired.el b/lisp/gnus/gnus-dired.el
index acb8fd77641..818beca77b0 100644
--- a/lisp/gnus/gnus-dired.el
+++ b/lisp/gnus/gnus-dired.el
@@ -209,11 +209,11 @@ If ARG is non-nil, open it in a new buffer."
209(defun gnus-dired-print (&optional file-name print-to) 209(defun gnus-dired-print (&optional file-name print-to)
210 "In dired, print FILE-NAME according to the mailcap file. 210 "In dired, print FILE-NAME according to the mailcap file.
211 211
212If there is no print command, print in a PostScript image. If the 212If there is no print command, print in a PostScript image. If the
213optional argument PRINT-TO is nil, send the image to the printer. If 213optional argument PRINT-TO is nil, send the image to the printer.
214PRINT-TO is a string, save the PostScript image in a file with that 214If PRINT-TO is a string, save the PostScript image in a file with
215name. If PRINT-TO is a number, prompt the user for the name of the 215that name. If PRINT-TO is a number, prompt the user for the name
216file to save in." 216of the file to save in."
217 (interactive (list 217 (interactive (list
218 (file-name-sans-versions (dired-get-filename) t) 218 (file-name-sans-versions (dired-get-filename) t)
219 (ps-print-preprint current-prefix-arg))) 219 (ps-print-preprint current-prefix-arg)))
diff --git a/lisp/gnus/gnus-icalendar.el b/lisp/gnus/gnus-icalendar.el
index 7d11b5699bb..e4779f52c07 100644
--- a/lisp/gnus/gnus-icalendar.el
+++ b/lisp/gnus/gnus-icalendar.el
@@ -250,10 +250,11 @@
250 "Parse RFC5545 iCalendar in buffer BUF and return an event object. 250 "Parse RFC5545 iCalendar in buffer BUF and return an event object.
251 251
252Return a gnus-icalendar-event object representing the first event 252Return a gnus-icalendar-event object representing the first event
253contained in the invitation. Return nil for calendars without an event entry. 253contained in the invitation. Return nil for calendars without an
254event entry.
254 255
255ATTENDEE-NAME-OR-EMAIL is a list of strings that will be matched 256ATTENDEE-NAME-OR-EMAIL is a list of strings that will be matched
256against the event's attendee names and emails. Invitation rsvp 257against the event's attendee names and emails. Invitation rsvp
257status will be retrieved from the first matching attendee record." 258status will be retrieved from the first matching attendee record."
258 (let ((ical (with-current-buffer (icalendar--get-unfolded-buffer (get-buffer buf)) 259 (let ((ical (with-current-buffer (icalendar--get-unfolded-buffer (get-buffer buf))
259 (goto-char (point-min)) 260 (goto-char (point-min))
diff --git a/lisp/gnus/gnus-range.el b/lisp/gnus/gnus-range.el
index b775def9a0d..52bcf79d404 100644
--- a/lisp/gnus/gnus-range.el
+++ b/lisp/gnus/gnus-range.el
@@ -28,7 +28,7 @@
28 28
29(defsubst gnus-range-normalize (range) 29(defsubst gnus-range-normalize (range)
30 "Normalize RANGE. 30 "Normalize RANGE.
31If RANGE is a single range, return (RANGE). Otherwise, return RANGE." 31If RANGE is a single range, return (RANGE). Otherwise, return RANGE."
32 (if (listp (cdr-safe range)) range (list range))) 32 (if (listp (cdr-safe range)) range (list range)))
33 33
34(defun gnus-last-element (list) 34(defun gnus-last-element (list)
diff --git a/lisp/gnus/gnus-spec.el b/lisp/gnus/gnus-spec.el
index 47d722c9144..3f3efdcec98 100644
--- a/lisp/gnus/gnus-spec.el
+++ b/lisp/gnus/gnus-spec.el
@@ -344,8 +344,8 @@ Return a list of updated types."
344 344
345(defun gnus-pad-form (el pad-width) 345(defun gnus-pad-form (el pad-width)
346 "Return a form that pads EL to PAD-WIDTH accounting for multi-column 346 "Return a form that pads EL to PAD-WIDTH accounting for multi-column
347characters correctly. This is because `format' may pad to columns or to 347characters correctly. This is because `format' may pad to columns
348characters when given a pad value." 348or to characters when given a pad value."
349 (let ((pad (abs pad-width)) 349 (let ((pad (abs pad-width))
350 (side (< 0 pad-width))) 350 (side (< 0 pad-width)))
351 (if (symbolp el) 351 (if (symbolp el)
diff --git a/lisp/gnus/gnus-srvr.el b/lisp/gnus/gnus-srvr.el
index 71c7807518f..684af235101 100644
--- a/lisp/gnus/gnus-srvr.el
+++ b/lisp/gnus/gnus-srvr.el
@@ -190,14 +190,14 @@ If nil, a faster, but more primitive, buffer is used instead."
190 '((((class color) (background light)) (:foreground "PaleTurquoise" :bold t)) 190 '((((class color) (background light)) (:foreground "PaleTurquoise" :bold t))
191 (((class color) (background dark)) (:foreground "PaleTurquoise" :bold t)) 191 (((class color) (background dark)) (:foreground "PaleTurquoise" :bold t))
192 (t (:bold t))) 192 (t (:bold t)))
193 "Face used for displaying AGENTIZED servers" 193 "Face used for displaying AGENTIZED servers."
194 :group 'gnus-server-visual) 194 :group 'gnus-server-visual)
195 195
196(defface gnus-server-cloud 196(defface gnus-server-cloud
197 '((((class color) (background light)) (:foreground "ForestGreen" :bold t)) 197 '((((class color) (background light)) (:foreground "ForestGreen" :bold t))
198 (((class color) (background dark)) (:foreground "PaleGreen" :bold t)) 198 (((class color) (background dark)) (:foreground "PaleGreen" :bold t))
199 (t (:bold t))) 199 (t (:bold t)))
200 "Face used for displaying Cloud-synced servers" 200 "Face used for displaying Cloud-synced servers."
201 :group 'gnus-server-visual) 201 :group 'gnus-server-visual)
202 202
203(defface gnus-server-cloud-host 203(defface gnus-server-cloud-host
@@ -211,7 +211,7 @@ If nil, a faster, but more primitive, buffer is used instead."
211 '((((class color) (background light)) (:foreground "Green3" :bold t)) 211 '((((class color) (background light)) (:foreground "Green3" :bold t))
212 (((class color) (background dark)) (:foreground "Green1" :bold t)) 212 (((class color) (background dark)) (:foreground "Green1" :bold t))
213 (t (:bold t))) 213 (t (:bold t)))
214 "Face used for displaying OPENED servers" 214 "Face used for displaying OPENED servers."
215 :group 'gnus-server-visual) 215 :group 'gnus-server-visual)
216 216
217(defface gnus-server-closed 217(defface gnus-server-closed
@@ -219,21 +219,21 @@ If nil, a faster, but more primitive, buffer is used instead."
219 (((class color) (background dark)) 219 (((class color) (background dark))
220 (:foreground "LightBlue" :italic t)) 220 (:foreground "LightBlue" :italic t))
221 (t (:italic t))) 221 (t (:italic t)))
222 "Face used for displaying CLOSED servers" 222 "Face used for displaying CLOSED servers."
223 :group 'gnus-server-visual) 223 :group 'gnus-server-visual)
224 224
225(defface gnus-server-denied 225(defface gnus-server-denied
226 '((((class color) (background light)) (:foreground "Red" :bold t)) 226 '((((class color) (background light)) (:foreground "Red" :bold t))
227 (((class color) (background dark)) (:foreground "Pink" :bold t)) 227 (((class color) (background dark)) (:foreground "Pink" :bold t))
228 (t (:inverse-video t :bold t))) 228 (t (:inverse-video t :bold t)))
229 "Face used for displaying DENIED servers" 229 "Face used for displaying DENIED servers."
230 :group 'gnus-server-visual) 230 :group 'gnus-server-visual)
231 231
232(defface gnus-server-offline 232(defface gnus-server-offline
233 '((((class color) (background light)) (:foreground "Orange" :bold t)) 233 '((((class color) (background light)) (:foreground "Orange" :bold t))
234 (((class color) (background dark)) (:foreground "Yellow" :bold t)) 234 (((class color) (background dark)) (:foreground "Yellow" :bold t))
235 (t (:inverse-video t :bold t))) 235 (t (:inverse-video t :bold t)))
236 "Face used for displaying OFFLINE servers" 236 "Face used for displaying OFFLINE servers."
237 :group 'gnus-server-visual) 237 :group 'gnus-server-visual)
238 238
239(defvar gnus-server-font-lock-keywords 239(defvar gnus-server-font-lock-keywords
diff --git a/lisp/gnus/gnus-sum.el b/lisp/gnus/gnus-sum.el
index b8f96158e6c..d1751065505 100644
--- a/lisp/gnus/gnus-sum.el
+++ b/lisp/gnus/gnus-sum.el
@@ -145,8 +145,8 @@ If t, fetch all the available old headers."
145 (sexp :menu-tag "other" t))) 145 (sexp :menu-tag "other" t)))
146 146
147(defcustom gnus-refer-thread-use-nnir nil 147(defcustom gnus-refer-thread-use-nnir nil
148 "Use nnir to search an entire server when referring threads. A 148 "Use nnir to search an entire server when referring threads.
149nil value will only search for thread-related articles in the 149A nil value will only search for thread-related articles in the
150current group." 150current group."
151 :version "24.1" 151 :version "24.1"
152 :group 'gnus-thread 152 :group 'gnus-thread
@@ -154,7 +154,7 @@ current group."
154 154
155(defcustom gnus-refer-thread-limit-to-thread nil 155(defcustom gnus-refer-thread-limit-to-thread nil
156 "If non-nil referring a thread will limit the summary buffer to 156 "If non-nil referring a thread will limit the summary buffer to
157articles in the thread. A nil value will add the thread articles 157articles in the thread. A nil value will add the thread articles
158to the summary buffer." 158to the summary buffer."
159 :version "25.1" 159 :version "25.1"
160 :group 'gnus-thread 160 :group 'gnus-thread
@@ -8655,7 +8655,7 @@ SCORE."
8655(defun gnus-summary-limit-include-thread (id &optional thread-only) 8655(defun gnus-summary-limit-include-thread (id &optional thread-only)
8656 "Display all hidden articles belonging to thread ID. 8656 "Display all hidden articles belonging to thread ID.
8657When called interactively, ID is the Message-ID of the current 8657When called interactively, ID is the Message-ID of the current
8658article. If thread-only is non-nil limit the summary buffer to 8658article. If thread-only is non-nil limit the summary buffer to
8659these articles." 8659these articles."
8660 (interactive (list (mail-header-id (gnus-summary-article-header)))) 8660 (interactive (list (mail-header-id (gnus-summary-article-header))))
8661 (let ((articles (gnus-articles-in-thread 8661 (let ((articles (gnus-articles-in-thread
@@ -9080,14 +9080,14 @@ Return the number of articles fetched."
9080 result)) 9080 result))
9081 9081
9082(defun gnus-summary-refer-thread (&optional limit) 9082(defun gnus-summary-refer-thread (&optional limit)
9083 "Fetch all articles in the current thread. For backends that 9083 "Fetch all articles in the current thread. For backends
9084know how to search for threads (currently only 'nnimap) a 9084that know how to search for threads (currently only 'nnimap)
9085non-numeric prefix arg will use nnir to search the entire 9085a non-numeric prefix arg will use nnir to search the entire
9086server; without a prefix arg only the current group is 9086server; without a prefix arg only the current group is
9087searched. If the variable `gnus-refer-thread-use-nnir' is 9087searched. If the variable `gnus-refer-thread-use-nnir' is
9088non-nil the prefix arg has the reverse meaning. If no 9088non-nil the prefix arg has the reverse meaning. If no
9089backend-specific 'request-thread function is available fetch 9089backend-specific 'request-thread function is available fetch
9090LIMIT (the numerical prefix) old headers. If LIMIT is 9090LIMIT (the numerical prefix) old headers. If LIMIT is
9091non-numeric or nil fetch the number specified by the 9091non-numeric or nil fetch the number specified by the
9092`gnus-refer-thread-limit' variable." 9092`gnus-refer-thread-limit' variable."
9093 (interactive "P") 9093 (interactive "P")
@@ -9647,8 +9647,8 @@ The search stars on the current article and goes forwards unless
9647BACKWARD is non-nil. If BACKWARD is `all', do all articles. 9647BACKWARD is non-nil. If BACKWARD is `all', do all articles.
9648If UNREAD is non-nil, only unread articles will 9648If UNREAD is non-nil, only unread articles will
9649be taken into consideration. If NOT-CASE-FOLD, case won't be folded 9649be taken into consideration. If NOT-CASE-FOLD, case won't be folded
9650in the comparisons. If NOT-MATCHING, return a list of all articles that 9650in the comparisons. If NOT-MATCHING, return a list of all articles
9651not match REGEXP on HEADER." 9651that not match REGEXP on HEADER."
9652 (let ((case-fold-search (not not-case-fold)) 9652 (let ((case-fold-search (not not-case-fold))
9653 articles func) 9653 articles func)
9654 (if (consp header) 9654 (if (consp header)
diff --git a/lisp/gnus/gnus-util.el b/lisp/gnus/gnus-util.el
index f73af8e261c..6847d372cc5 100644
--- a/lisp/gnus/gnus-util.el
+++ b/lisp/gnus/gnus-util.el
@@ -1610,7 +1610,7 @@ empty directories from OLD-PATH."
1610 1610
1611(defun gnus-rescale-image (image size) 1611(defun gnus-rescale-image (image size)
1612 "Rescale IMAGE to SIZE if possible. 1612 "Rescale IMAGE to SIZE if possible.
1613SIZE is in format (WIDTH . HEIGHT). Return a new image. 1613SIZE is in format (WIDTH . HEIGHT). Return a new image.
1614Sizes are in pixels." 1614Sizes are in pixels."
1615 (if (not (fboundp 'imagemagick-types)) 1615 (if (not (fboundp 'imagemagick-types))
1616 image 1616 image
diff --git a/lisp/gnus/gnus.el b/lisp/gnus/gnus.el
index f990569a300..0673ac15f60 100644
--- a/lisp/gnus/gnus.el
+++ b/lisp/gnus/gnus.el
@@ -2733,15 +2733,15 @@ with some simple extensions.
2733%O Download mark (character). 2733%O Download mark (character).
2734%* If present, indicates desired cursor position 2734%* If present, indicates desired cursor position
2735 (instead of after first colon). 2735 (instead of after first colon).
2736%u User defined specifier. The next character in the 2736%u User defined specifier. The next character in the
2737 format string should be a letter. Gnus will call the 2737 format string should be a letter. Gnus will call the
2738 function gnus-user-format-function-X, where X is the 2738 function gnus-user-format-function-X, where X is the
2739 letter following %u. The function will be passed the 2739 letter following %u. The function will be passed the
2740 current header as argument. The function should 2740 current header as argument. The function should
2741 return a string, which will be inserted into the 2741 return a string, which will be inserted into the
2742 summary just like information from any other summary 2742 summary just like information from any other summary
2743 specifier. 2743 specifier.
2744&user-date; Age sensitive date format. Various date format is 2744&user-date; Age sensitive date format. Various date format is
2745 defined in `gnus-user-date-format-alist'. 2745 defined in `gnus-user-date-format-alist'.
2746 2746
2747 2747
@@ -4055,10 +4055,10 @@ Allow completion over sensible values."
4055;;;###autoload 4055;;;###autoload
4056(defun gnus-no-server (&optional arg slave) 4056(defun gnus-no-server (&optional arg slave)
4057 "Read network news. 4057 "Read network news.
4058If ARG is a positive number, Gnus will use that as the startup 4058If ARG is a positive number, Gnus will use that as the startup level.
4059level. If ARG is nil, Gnus will be started at level 2. If ARG is 4059If ARG is nil, Gnus will be started at level 2. If ARG is non-nil
4060non-nil and not a positive number, Gnus will prompt the user for the 4060and not a positive number, Gnus will prompt the user for the name of
4061name of an NNTP server to use. 4061an NNTP server to use.
4062As opposed to `gnus', this command will not connect to the local 4062As opposed to `gnus', this command will not connect to the local
4063server." 4063server."
4064 (interactive "P") 4064 (interactive "P")
diff --git a/lisp/gnus/mail-source.el b/lisp/gnus/mail-source.el
index 69ecde30275..fab0f5296d0 100644
--- a/lisp/gnus/mail-source.el
+++ b/lisp/gnus/mail-source.el
@@ -286,7 +286,7 @@ number."
286 :type 'boolean) 286 :type 'boolean)
287 287
288(defcustom mail-source-incoming-file-prefix "Incoming" 288(defcustom mail-source-incoming-file-prefix "Incoming"
289 "Prefix for file name for storing incoming mail" 289 "Prefix for file name for storing incoming mail."
290 :group 'mail-source 290 :group 'mail-source
291 :type 'string) 291 :type 'string)
292 292
diff --git a/lisp/gnus/message.el b/lisp/gnus/message.el
index 9e0f2b461e3..ef6455ac5c9 100644
--- a/lisp/gnus/message.el
+++ b/lisp/gnus/message.el
@@ -1131,8 +1131,8 @@ If `traditional', reply inline.
1131If `above', reply above quoted text. 1131If `above', reply above quoted text.
1132If `below', reply below quoted text. 1132If `below', reply below quoted text.
1133 1133
1134Note: Many newsgroups frown upon nontraditional reply styles. You 1134Note: Many newsgroups frown upon nontraditional reply styles.
1135probably want to set this variable only for specific groups, 1135You probably want to set this variable only for specific groups,
1136e.g. using `gnus-posting-styles': 1136e.g. using `gnus-posting-styles':
1137 1137
1138 (eval (set (make-local-variable \\='message-cite-reply-position) \\='above))" 1138 (eval (set (make-local-variable \\='message-cite-reply-position) \\='above))"
@@ -1169,7 +1169,7 @@ use in `gnus-posting-styles', such as:
1169 (message-yank-cited-prefix "") 1169 (message-yank-cited-prefix "")
1170 (message-yank-empty-prefix "") 1170 (message-yank-empty-prefix "")
1171 (message-citation-line-format "\n\n-----------------------\nOn %a, %b %d %Y, %N wrote:\n")) 1171 (message-citation-line-format "\n\n-----------------------\nOn %a, %b %d %Y, %N wrote:\n"))
1172 "Message citation style used by MS Outlook. Use with message-cite-style.") 1172 "Message citation style used by MS Outlook. Use with `message-cite-style'.")
1173 1173
1174(defconst message-cite-style-thunderbird 1174(defconst message-cite-style-thunderbird
1175 '((message-cite-function 'message-cite-original) 1175 '((message-cite-function 'message-cite-original)
@@ -1179,7 +1179,7 @@ use in `gnus-posting-styles', such as:
1179 (message-yank-cited-prefix ">") 1179 (message-yank-cited-prefix ">")
1180 (message-yank-empty-prefix ">") 1180 (message-yank-empty-prefix ">")
1181 (message-citation-line-format "On %D %R %p, %N wrote:")) 1181 (message-citation-line-format "On %D %R %p, %N wrote:"))
1182 "Message citation style used by Mozilla Thunderbird. Use with message-cite-style.") 1182 "Message citation style used by Mozilla Thunderbird. Use with `message-cite-style'.")
1183 1183
1184(defconst message-cite-style-gmail 1184(defconst message-cite-style-gmail
1185 '((message-cite-function 'message-cite-original) 1185 '((message-cite-function 'message-cite-original)
@@ -1189,7 +1189,7 @@ use in `gnus-posting-styles', such as:
1189 (message-yank-cited-prefix " ") 1189 (message-yank-cited-prefix " ")
1190 (message-yank-empty-prefix " ") 1190 (message-yank-empty-prefix " ")
1191 (message-citation-line-format "On %e %B %Y %R, %f wrote:\n")) 1191 (message-citation-line-format "On %e %B %Y %R, %f wrote:\n"))
1192 "Message citation style used by Gmail. Use with message-cite-style.") 1192 "Message citation style used by Gmail. Use with `message-cite-style'.")
1193 1193
1194(defcustom message-distribution-function nil 1194(defcustom message-distribution-function nil
1195 "Function called to return a Distribution header." 1195 "Function called to return a Distribution header."
@@ -4511,8 +4511,8 @@ smaller pieces, the size of each is about "
4511one. 4511one.
4512 4512
4513However, some mail readers (MUA's) can't read split messages, i.e., 4513However, some mail readers (MUA's) can't read split messages, i.e.,
4514mails in message/partially format. Answer `n', and the message will be 4514mails in message/partially format. Answer `n', and the message
4515sent in one piece. 4515will be sent in one piece.
4516 4516
4517The size limit is controlled by `message-send-mail-partially-limit'. 4517The size limit is controlled by `message-send-mail-partially-limit'.
4518If you always want Gnus to send messages in one piece, set 4518If you always want Gnus to send messages in one piece, set
diff --git a/lisp/gnus/mm-extern.el b/lisp/gnus/mm-extern.el
index c3054432d51..d838cdc875f 100644
--- a/lisp/gnus/mm-extern.el
+++ b/lisp/gnus/mm-extern.el
@@ -144,7 +144,7 @@
144 "Show the external-body part of HANDLE. 144 "Show the external-body part of HANDLE.
145This function replaces the buffer of HANDLE with a buffer contains 145This function replaces the buffer of HANDLE with a buffer contains
146the entire message. 146the entire message.
147If NO-DISPLAY is nil, display it. Otherwise, do nothing after replacing." 147If NO-DISPLAY is nil, display it. Otherwise, do nothing after replacing."
148 (unless (mm-handle-cache handle) 148 (unless (mm-handle-cache handle)
149 (mm-extern-cache-contents handle)) 149 (mm-extern-cache-contents handle))
150 (unless no-display 150 (unless no-display
diff --git a/lisp/gnus/mm-partial.el b/lisp/gnus/mm-partial.el
index c68ab4a7c13..d2f279e4197 100644
--- a/lisp/gnus/mm-partial.el
+++ b/lisp/gnus/mm-partial.el
@@ -54,7 +54,7 @@
54 "Show the partial part of HANDLE. 54 "Show the partial part of HANDLE.
55This function replaces the buffer of HANDLE with a buffer contains 55This function replaces the buffer of HANDLE with a buffer contains
56the entire message. 56the entire message.
57If NO-DISPLAY is nil, display it. Otherwise, do nothing after replacing." 57If NO-DISPLAY is nil, display it. Otherwise, do nothing after replacing."
58 (let ((id (cdr (assq 'id (cdr (mm-handle-type handle))))) 58 (let ((id (cdr (assq 'id (cdr (mm-handle-type handle)))))
59 phandles 59 phandles
60 (b (point)) (n 1) total 60 (b (point)) (n 1) total
diff --git a/lisp/gnus/mml-sec.el b/lisp/gnus/mml-sec.el
index e0ec829617f..716e4b778ec 100644
--- a/lisp/gnus/mml-sec.el
+++ b/lisp/gnus/mml-sec.el
@@ -364,7 +364,7 @@ either an error is raised or not."
364 364
365(defun mml-secure-message-sign (&optional method) 365(defun mml-secure-message-sign (&optional method)
366 "Add MML tags to sign the entire message. 366 "Add MML tags to sign the entire message.
367Use METHOD if given. Else use `mml-secure-method' or 367Use METHOD if given. Else use `mml-secure-method' or
368`mml-default-sign-method'." 368`mml-default-sign-method'."
369 (interactive) 369 (interactive)
370 (mml-secure-message 370 (mml-secure-message
@@ -373,7 +373,7 @@ Use METHOD if given. Else use `mml-secure-method' or
373 373
374(defun mml-secure-message-sign-encrypt (&optional method) 374(defun mml-secure-message-sign-encrypt (&optional method)
375 "Add MML tag to sign and encrypt the entire message. 375 "Add MML tag to sign and encrypt the entire message.
376Use METHOD if given. Else use `mml-secure-method' or 376Use METHOD if given. Else use `mml-secure-method' or
377`mml-default-sign-method'." 377`mml-default-sign-method'."
378 (interactive) 378 (interactive)
379 (mml-secure-message 379 (mml-secure-message
@@ -382,7 +382,7 @@ Use METHOD if given. Else use `mml-secure-method' or
382 382
383(defun mml-secure-message-encrypt (&optional method) 383(defun mml-secure-message-encrypt (&optional method)
384 "Add MML tag to encrypt the entire message. 384 "Add MML tag to encrypt the entire message.
385Use METHOD if given. Else use `mml-secure-method' or 385Use METHOD if given. Else use `mml-secure-method' or
386`mml-default-sign-method'." 386`mml-default-sign-method'."
387 (interactive) 387 (interactive)
388 (mml-secure-message 388 (mml-secure-message
diff --git a/lisp/gnus/mml2015.el b/lisp/gnus/mml2015.el
index d7876a3aef0..45164ee8f65 100644
--- a/lisp/gnus/mml2015.el
+++ b/lisp/gnus/mml2015.el
@@ -760,7 +760,7 @@ If set, it overrides the setting of `mml2015-sign-with-sender'."
760(autoload 'epa-select-keys "epa") 760(autoload 'epa-select-keys "epa")
761 761
762(defun mml2015-epg-key-image (key-id) 762(defun mml2015-epg-key-image (key-id)
763 "Return the image of a key, if any" 763 "Return the image of a key, if any."
764 (with-temp-buffer 764 (with-temp-buffer
765 (set-buffer-multibyte nil) 765 (set-buffer-multibyte nil)
766 (let* ((coding-system-for-write 'binary) 766 (let* ((coding-system-for-write 'binary)
@@ -777,7 +777,7 @@ If set, it overrides the setting of `mml2015-sign-with-sender'."
777(autoload 'gnus-rescale-image "gnus-util") 777(autoload 'gnus-rescale-image "gnus-util")
778 778
779(defun mml2015-epg-key-image-to-string (key-id) 779(defun mml2015-epg-key-image-to-string (key-id)
780 "Return a string with the image of a key, if any" 780 "Return a string with the image of a key, if any."
781 (let ((key-image (mml2015-epg-key-image key-id))) 781 (let ((key-image (mml2015-epg-key-image key-id)))
782 (if (not key-image) 782 (if (not key-image)
783 "" 783 ""
diff --git a/lisp/gnus/nndiary.el b/lisp/gnus/nndiary.el
index 8cda5aa7031..f79d8f17072 100644
--- a/lisp/gnus/nndiary.el
+++ b/lisp/gnus/nndiary.el
@@ -121,7 +121,7 @@ Diary articles will appear again, as if they'd been just received.
121 121
122Entries look like (3 . day) which means something like \"Please 122Entries look like (3 . day) which means something like \"Please
123Hortense, would you be so kind as to remind me of my appointments 3 days 123Hortense, would you be so kind as to remind me of my appointments 3 days
124before the date, thank you very much. Anda, hmmm... by the way, are you 124before the date, thank you very much. Anda, hmmm... by the way, are you
125doing anything special tonight ?\". 125doing anything special tonight ?\".
126 126
127The units of measure are 'minute 'hour 'day 'week 'month and 'year (no, 127The units of measure are 'minute 'hour 'day 'week 'month and 'year (no,
@@ -218,7 +218,7 @@ The hook functions will be called with the article in the current buffer."
218(defvoo nndiary-get-new-mail nil 218(defvoo nndiary-get-new-mail nil
219 "Whether nndiary gets new mail and split it. 219 "Whether nndiary gets new mail and split it.
220Contrary to traditional mail back ends, this variable can be set to t 220Contrary to traditional mail back ends, this variable can be set to t
221even if your primary mail back end also retrieves mail. In such a case, 221even if your primary mail back end also retrieves mail. In such a case,
222NDiary uses its own mail-sources and split-methods.") 222NDiary uses its own mail-sources and split-methods.")
223 223
224(defvoo nndiary-nov-is-evil nil 224(defvoo nndiary-nov-is-evil nil
diff --git a/lisp/gnus/nnheader.el b/lisp/gnus/nnheader.el
index c87cfc8c7cb..28c4cebb2d1 100644
--- a/lisp/gnus/nnheader.el
+++ b/lisp/gnus/nnheader.el
@@ -661,7 +661,7 @@ the line could be found."
661(defvar nnheader-directory-files-is-safe (not (eq system-type 'windows-nt)) 661(defvar nnheader-directory-files-is-safe (not (eq system-type 'windows-nt))
662 "If non-nil, Gnus believes `directory-files' is safe. 662 "If non-nil, Gnus believes `directory-files' is safe.
663It has been reported numerous times that `directory-files' fails with 663It has been reported numerous times that `directory-files' fails with
664an alarming frequency on NFS mounted file systems. If it is nil, 664an alarming frequency on NFS mounted file systems. If it is nil,
665`nnheader-directory-files-safe' is used.") 665`nnheader-directory-files-safe' is used.")
666 666
667(defun nnheader-directory-files-safe (&rest args) 667(defun nnheader-directory-files-safe (&rest args)
diff --git a/lisp/gnus/nnir.el b/lisp/gnus/nnir.el
index d66bdf47066..b695cfa4f6d 100644
--- a/lisp/gnus/nnir.el
+++ b/lisp/gnus/nnir.el
@@ -189,7 +189,7 @@
189 "Internal: stores search result.") 189 "Internal: stores search result.")
190 190
191(defvar nnir-search-history () 191(defvar nnir-search-history ()
192 "Internal: the history for querying search options in nnir") 192 "Internal: the history for querying search options in nnir.")
193 193
194(defconst nnir-tmp-buffer " *nnir*" 194(defconst nnir-tmp-buffer " *nnir*"
195 "Internal: temporary buffer.") 195 "Internal: temporary buffer.")
@@ -208,8 +208,8 @@
208 208
209(defvar nnir-imap-search-other "HEADER %S" 209(defvar nnir-imap-search-other "HEADER %S"
210 "The IMAP search item to use for anything other than 210 "The IMAP search item to use for anything other than
211 `nnir-imap-search-arguments'. By default this is the name of an 211`nnir-imap-search-arguments'. By default this is the name of an
212 email header field") 212email header field.")
213 213
214(defvar nnir-imap-search-argument-history () 214(defvar nnir-imap-search-argument-history ()
215 "The history for querying search options in nnir") 215 "The history for querying search options in nnir")
@@ -219,48 +219,48 @@
219;; Data type article list. 219;; Data type article list.
220 220
221(defmacro nnir-artlist-length (artlist) 221(defmacro nnir-artlist-length (artlist)
222 "Returns number of articles in artlist." 222 "Return number of articles in artlist."
223 `(length ,artlist)) 223 `(length ,artlist))
224 224
225(defmacro nnir-artlist-article (artlist n) 225(defmacro nnir-artlist-article (artlist n)
226 "Returns from ARTLIST the Nth artitem (counting starting at 1)." 226 "Return from ARTLIST the Nth artitem (counting starting at 1)."
227 `(when (> ,n 0) 227 `(when (> ,n 0)
228 (elt ,artlist (1- ,n)))) 228 (elt ,artlist (1- ,n))))
229 229
230(defmacro nnir-artitem-group (artitem) 230(defmacro nnir-artitem-group (artitem)
231 "Returns the group from the ARTITEM." 231 "Return the group from the ARTITEM."
232 `(elt ,artitem 0)) 232 `(elt ,artitem 0))
233 233
234(defmacro nnir-artitem-number (artitem) 234(defmacro nnir-artitem-number (artitem)
235 "Returns the number from the ARTITEM." 235 "Return the number from the ARTITEM."
236 `(elt ,artitem 1)) 236 `(elt ,artitem 1))
237 237
238(defmacro nnir-artitem-rsv (artitem) 238(defmacro nnir-artitem-rsv (artitem)
239 "Returns the Retrieval Status Value (RSV, score) from the ARTITEM." 239 "Return the Retrieval Status Value (RSV, score) from the ARTITEM."
240 `(elt ,artitem 2)) 240 `(elt ,artitem 2))
241 241
242(defmacro nnir-article-group (article) 242(defmacro nnir-article-group (article)
243 "Returns the group for ARTICLE" 243 "Return the group for ARTICLE."
244 `(nnir-artitem-group (nnir-artlist-article nnir-artlist ,article))) 244 `(nnir-artitem-group (nnir-artlist-article nnir-artlist ,article)))
245 245
246(defmacro nnir-article-number (article) 246(defmacro nnir-article-number (article)
247 "Returns the number for ARTICLE" 247 "Return the number for ARTICLE."
248 `(nnir-artitem-number (nnir-artlist-article nnir-artlist ,article))) 248 `(nnir-artitem-number (nnir-artlist-article nnir-artlist ,article)))
249 249
250(defmacro nnir-article-rsv (article) 250(defmacro nnir-article-rsv (article)
251 "Returns the rsv for ARTICLE" 251 "Return the rsv for ARTICLE."
252 `(nnir-artitem-rsv (nnir-artlist-article nnir-artlist ,article))) 252 `(nnir-artitem-rsv (nnir-artlist-article nnir-artlist ,article)))
253 253
254(defsubst nnir-article-ids (article) 254(defsubst nnir-article-ids (article)
255 "Returns the pair `(nnir id . real id)' of ARTICLE" 255 "Return the pair `(nnir id . real id)' of ARTICLE."
256 (cons article (nnir-article-number article))) 256 (cons article (nnir-article-number article)))
257 257
258(defmacro nnir-categorize (sequence keyfunc &optional valuefunc) 258(defmacro nnir-categorize (sequence keyfunc &optional valuefunc)
259 "Sorts a sequence into categories and returns a list of the form 259 "Sort a sequence into categories and returns a list of the form
260`((key1 (element11 element12)) (key2 (element21 element22))'. 260`((key1 (element11 element12)) (key2 (element21 element22))'.
261The category key for a member of the sequence is obtained 261The category key for a member of the sequence is obtained
262as `(keyfunc member)' and the corresponding element is just 262as `(keyfunc member)' and the corresponding element is just
263`member'. If `valuefunc' is non-nil, the element of the list 263`member'. If `valuefunc' is non-nil, the element of the list
264is `(valuefunc member)'." 264is `(valuefunc member)'."
265 `(unless (null ,sequence) 265 `(unless (null ,sequence)
266 (let (value) 266 (let (value)
@@ -317,7 +317,7 @@ If nil this will use `gnus-summary-line-format'."
317(defcustom nnir-retrieve-headers-override-function nil 317(defcustom nnir-retrieve-headers-override-function nil
318 "If non-nil, a function that accepts an article list and group 318 "If non-nil, a function that accepts an article list and group
319and populates the `nntp-server-buffer' with the retrieved 319and populates the `nntp-server-buffer' with the retrieved
320headers. Must return either 'nov or 'headers indicating the 320headers. Must return either 'nov or 'headers indicating the
321retrieved header format. 321retrieved header format.
322 322
323If this variable is nil, or if the provided function returns nil for a search 323If this variable is nil, or if the provided function returns nil for a search
@@ -327,8 +327,8 @@ result, `gnus-retrieve-headers' will be called instead."
327 :group 'nnir) 327 :group 'nnir)
328 328
329(defcustom nnir-imap-default-search-key "whole message" 329(defcustom nnir-imap-default-search-key "whole message"
330 "The default IMAP search key for an nnir search. Must be one of 330 "The default IMAP search key for an nnir search. Must be one of
331 the keys in `nnir-imap-search-arguments'. To use raw imap queries 331 the keys in `nnir-imap-search-arguments'. To use raw imap queries
332 by default set this to \"imap\"." 332 by default set this to \"imap\"."
333 :version "24.1" 333 :version "24.1"
334 :type `(choice ,@(mapcar (lambda (elem) (list 'const (car elem))) 334 :type `(choice ,@(mapcar (lambda (elem) (list 'const (car elem)))
@@ -428,7 +428,7 @@ This could be a server parameter."
428 428
429(defcustom nnir-hyrex-additional-switches '() 429(defcustom nnir-hyrex-additional-switches '()
430 "A list of strings, to be given as additional arguments for nnir-search. 430 "A list of strings, to be given as additional arguments for nnir-search.
431Note that this should be a list. I.e., do NOT use the following: 431Note that this should be a list. I.e., do NOT use the following:
432 (setq nnir-hyrex-additional-switches \"-ddl ddl.xml -c nnir\") ; wrong ! 432 (setq nnir-hyrex-additional-switches \"-ddl ddl.xml -c nnir\") ; wrong !
433Instead, use this: 433Instead, use this:
434 (setq nnir-hyrex-additional-switches \\='(\"-ddl\" \"ddl.xml\" \"-c\" \"nnir\"))" 434 (setq nnir-hyrex-additional-switches \\='(\"-ddl\" \"ddl.xml\" \"-c\" \"nnir\"))"
@@ -600,8 +600,8 @@ the groups to search as follows: if called from the *Server*
600buffer search all groups belonging to the server on the current 600buffer search all groups belonging to the server on the current
601line; if called from the *Group* buffer search any marked groups, 601line; if called from the *Group* buffer search any marked groups,
602or the group on the current line, or all the groups under the 602or the group on the current line, or all the groups under the
603current topic. Calling with a prefix-arg prompts for additional 603current topic. Calling with a prefix-arg prompts for additional
604search-engine specific constraints. A non-nil `specs' arg must be 604search-engine specific constraints. A non-nil `specs' arg must be
605an alist with `nnir-query-spec' and `nnir-group-spec' keys, and 605an alist with `nnir-query-spec' and `nnir-group-spec' keys, and
606skips all prompting." 606skips all prompting."
607 (interactive "P") 607 (interactive "P")
@@ -1456,8 +1456,9 @@ Tested with swish-e-2.0.1 on Windows NT 4.0."
1456 1456
1457;; Namazu interface 1457;; Namazu interface
1458(defun nnir-run-namazu (query server &optional _group) 1458(defun nnir-run-namazu (query server &optional _group)
1459 "Run given query against Namazu. Returns a vector of (group name, file name) 1459 "Run given query against Namazu.
1460pairs (also vectors, actually). 1460Returns a vector of (group name, file name) pairs (also vectors,
1461actually).
1461 1462
1462Tested with Namazu 2.0.6 on a GNU/Linux system." 1463Tested with Namazu 2.0.6 on a GNU/Linux system."
1463 ;; (when group 1464 ;; (when group
@@ -1702,12 +1703,12 @@ construct path: search terms (see the variable
1702 (and group (string-match "^nnir" group)))) 1703 (and group (string-match "^nnir" group))))
1703 1704
1704(defun nnir-read-parms (nnir-search-engine) 1705(defun nnir-read-parms (nnir-search-engine)
1705 "Reads additional search parameters according to `nnir-engines'." 1706 "Read additional search parameters according to `nnir-engines'."
1706 (let ((parmspec (nth 2 (assoc nnir-search-engine nnir-engines)))) 1707 (let ((parmspec (nth 2 (assoc nnir-search-engine nnir-engines))))
1707 (mapcar #'nnir-read-parm parmspec))) 1708 (mapcar #'nnir-read-parm parmspec)))
1708 1709
1709(defun nnir-read-parm (parmspec) 1710(defun nnir-read-parm (parmspec)
1710 "Reads a single search parameter. 1711 "Read a single search parameter.
1711`parmspec' is a cons cell, the car is a symbol, the cdr is a prompt." 1712`parmspec' is a cons cell, the car is a symbol, the cdr is a prompt."
1712 (let ((sym (car parmspec)) 1713 (let ((sym (car parmspec))
1713 (prompt (cdr parmspec))) 1714 (prompt (cdr parmspec)))
@@ -1737,8 +1738,8 @@ construct path: search terms (see the variable
1737 nnir-method-default-engines)))) 1738 nnir-method-default-engines))))
1738 1739
1739(defun nnir-read-server-parm (key server &optional not-global) 1740(defun nnir-read-server-parm (key server &optional not-global)
1740 "Returns the parameter value corresponding to `key' for 1741 "Return the parameter value corresponding to `key' for `server'.
1741`server'. If no server-specific value is found consult the global 1742If no server-specific value is found consult the global
1742environment unless `not-global' is non-nil." 1743environment unless `not-global' is non-nil."
1743 (let ((method (gnus-server-to-method server))) 1744 (let ((method (gnus-server-to-method server)))
1744 (cond ((and method (assq key (cddr method))) 1745 (cond ((and method (assq key (cddr method)))
@@ -1763,7 +1764,7 @@ environment unless `not-global' is non-nil."
1763 1764
1764(defun nnir-search-thread (header) 1765(defun nnir-search-thread (header)
1765 "Make an nnir group based on the thread containing the article 1766 "Make an nnir group based on the thread containing the article
1766header. The current server will be searched. If the registry is 1767header. The current server will be searched. If the registry is
1767installed, the server that the registry reports the current 1768installed, the server that the registry reports the current
1768article came from is also searched." 1769article came from is also searched."
1769 (let* ((query 1770 (let* ((query
diff --git a/lisp/gnus/nnmairix.el b/lisp/gnus/nnmairix.el
index 53275e19640..6c5502ac3d9 100644
--- a/lisp/gnus/nnmairix.el
+++ b/lisp/gnus/nnmairix.el
@@ -381,7 +381,7 @@ wrong count of total articles shown by Gnus.")
381its maildir mail folders (e.g. the Dovecot IMAP server or mutt).") 381its maildir mail folders (e.g. the Dovecot IMAP server or mutt).")
382 382
383(defvoo nnmairix-default-group nil 383(defvoo nnmairix-default-group nil
384 "Default search group. This is the group which is used for all 384 "Default search group. This is the group which is used for all
385temporary searches, e.g. nnmairix-search.") 385temporary searches, e.g. nnmairix-search.")
386 386
387;;; === Internal variables 387;;; === Internal variables
@@ -1096,7 +1096,7 @@ show wrong article counts."
1096(defun nnmairix-propagate-marks (&optional server) 1096(defun nnmairix-propagate-marks (&optional server)
1097 "Propagate marks from nnmairix group to original articles. 1097 "Propagate marks from nnmairix group to original articles.
1098Unless SERVER is explicitly specified, will use the last opened 1098Unless SERVER is explicitly specified, will use the last opened
1099nnmairix server. Only marks from current session will be set." 1099nnmairix server. Only marks from current session will be set."
1100 (interactive) 1100 (interactive)
1101 (if server 1101 (if server
1102 (nnmairix-open-server server) 1102 (nnmairix-open-server server)
diff --git a/lisp/gnus/smime.el b/lisp/gnus/smime.el
index 9a38a6c6976..b7ec033603f 100644
--- a/lisp/gnus/smime.el
+++ b/lisp/gnus/smime.el
@@ -130,7 +130,7 @@
130 130
131(defcustom smime-keys nil 131(defcustom smime-keys nil
132 "Map mail addresses to a file containing Certificate (and private key). 132 "Map mail addresses to a file containing Certificate (and private key).
133The file is assumed to be in PEM format. You can also associate additional 133The file is assumed to be in PEM format. You can also associate additional
134certificates to be sent with every message to each address." 134certificates to be sent with every message to each address."
135 :type '(repeat (list (string :tag "Mail address") 135 :type '(repeat (list (string :tag "Mail address")
136 (file :tag "File name") 136 (file :tag "File name")
@@ -197,7 +197,7 @@ against a certificate revocation list (CRL).
197 197
198For this to work the CRL must be up-to-date and since they are 198For this to work the CRL must be up-to-date and since they are
199normally updated quite often (i.e., several times a day) you 199normally updated quite often (i.e., several times a day) you
200probably need some tool to keep them up-to-date. Unfortunately 200probably need some tool to keep them up-to-date. Unfortunately
201Gnus cannot do this for you. 201Gnus cannot do this for you.
202 202
203The CRL should either be appended (in PEM format) to your 203The CRL should either be appended (in PEM format) to your
@@ -435,7 +435,7 @@ in the buffer specified by `smime-details-buffer'."
435 435
436(defun smime-verify-buffer (&optional buffer) 436(defun smime-verify-buffer (&optional buffer)
437 "Verify integrity of S/MIME message in BUFFER. 437 "Verify integrity of S/MIME message in BUFFER.
438Uses current buffer if BUFFER is nil. Returns non-nil on success. 438Uses current buffer if BUFFER is nil. Returns non-nil on success.
439Any details (stdout and stderr) are left in the buffer specified by 439Any details (stdout and stderr) are left in the buffer specified by
440`smime-details-buffer'." 440`smime-details-buffer'."
441 (interactive) 441 (interactive)
@@ -445,7 +445,7 @@ Any details (stdout and stderr) are left in the buffer specified by
445(defun smime-noverify-buffer (&optional buffer) 445(defun smime-noverify-buffer (&optional buffer)
446 "Verify integrity of S/MIME message in BUFFER. 446 "Verify integrity of S/MIME message in BUFFER.
447Does NOT verify validity of certificate (only message integrity). 447Does NOT verify validity of certificate (only message integrity).
448Uses current buffer if BUFFER is nil. Returns non-nil on success. 448Uses current buffer if BUFFER is nil. Returns non-nil on success.
449Any details (stdout and stderr) are left in the buffer specified by 449Any details (stdout and stderr) are left in the buffer specified by
450`smime-details-buffer'." 450`smime-details-buffer'."
451 (interactive) 451 (interactive)
diff --git a/lisp/gnus/spam-report.el b/lisp/gnus/spam-report.el
index f611a213fdd..b93d405ec1f 100644
--- a/lisp/gnus/spam-report.el
+++ b/lisp/gnus/spam-report.el
@@ -318,9 +318,9 @@ symbol `ask', query before flushing the queue file."
318 318
319;;;###autoload 319;;;###autoload
320(defun spam-report-url-ping-mm-url (host report) 320(defun spam-report-url-ping-mm-url (host report)
321 "Ping a host through HTTP, addressing a specific GET resource. Use 321 "Ping a host through HTTP, addressing a specific GET resource.
322the external program specified in `mm-url-program' to connect to 322Use the external program specified in `mm-url-program' to connect
323server." 323to server."
324 (with-temp-buffer 324 (with-temp-buffer
325 (let ((url (format "http://%s%s" host report))) 325 (let ((url (format "http://%s%s" host report)))
326 (mm-url-insert url t)))) 326 (mm-url-insert url t))))
diff --git a/lisp/gnus/spam.el b/lisp/gnus/spam.el
index f990e0cba16..c701e314fc0 100644
--- a/lisp/gnus/spam.el
+++ b/lisp/gnus/spam.el
@@ -578,12 +578,12 @@ This must be a list. For example, `(\"-C\" \"configfile\")'."
578 578
579(defcustom spam-spamassassin-positive-spam-flag-header "YES" 579(defcustom spam-spamassassin-positive-spam-flag-header "YES"
580 "The regex on `spam-spamassassin-spam-flag-header' for positive spam 580 "The regex on `spam-spamassassin-spam-flag-header' for positive spam
581identification" 581identification."
582 :type 'string 582 :type 'string
583 :group 'spam-spamassassin) 583 :group 'spam-spamassassin)
584 584
585(defcustom spam-spamassassin-spam-status-header "X-Spam-Status" 585(defcustom spam-spamassassin-spam-status-header "X-Spam-Status"
586 "The header inserted by SpamAssassin, giving extended scoring information" 586 "The header inserted by SpamAssassin, giving extended scoring information."
587 :type 'string 587 :type 'string
588 :group 'spam-spamassassin) 588 :group 'spam-spamassassin)
589 589
@@ -594,7 +594,7 @@ identification"
594 :group 'spam-spamassassin) 594 :group 'spam-spamassassin)
595 595
596(defcustom spam-sa-learn-rebuild t 596(defcustom spam-sa-learn-rebuild t
597 "Whether sa-learn should rebuild the database every time it is called 597 "Whether sa-learn should rebuild the database every time it is called.
598Enable this if you want sa-learn to rebuild the database automatically. Doing 598Enable this if you want sa-learn to rebuild the database automatically. Doing
599this will slightly increase the running time of the spam registration process. 599this will slightly increase the running time of the spam registration process.
600If you choose not to do this, you will have to run \"sa-learn --rebuild\" in 600If you choose not to do this, you will have to run \"sa-learn --rebuild\" in
@@ -767,7 +767,7 @@ When either list is nil, the other is returned."
767 nil)) 767 nil))
768 768
769(defun spam-classifications () 769(defun spam-classifications ()
770 "Return list of valid classifications" 770 "Return list of valid classifications."
771 '(spam ham)) 771 '(spam ham))
772 772
773(defun spam-classification-valid-p (classification) 773(defun spam-classification-valid-p (classification)
@@ -2185,7 +2185,7 @@ Uses `gnus-newsgroup-name' if category is nil (for ham registration)."
2185(require 'spam-stat) 2185(require 'spam-stat)
2186 2186
2187(defun spam-check-stat () 2187(defun spam-check-stat ()
2188 "Check the spam-stat backend for the classification of this message" 2188 "Check the spam-stat backend for the classification of this message."
2189 (let ((spam-stat-split-fancy-spam-group spam-split-group) ; override 2189 (let ((spam-stat-split-fancy-spam-group spam-split-group) ; override
2190 (spam-stat-buffer (buffer-name)) ; stat the current buffer 2190 (spam-stat-buffer (buffer-name)) ; stat the current buffer
2191 category return) 2191 category return)
@@ -2609,7 +2609,7 @@ With a non-nil REMOVE, remove the ADDRESSES."
2609 2609
2610;; return something sensible if the score can't be determined 2610;; return something sensible if the score can't be determined
2611(defun spam-spamassassin-score (&optional recheck) 2611(defun spam-spamassassin-score (&optional recheck)
2612 "Get the SpamAssassin score" 2612 "Get the SpamAssassin score."
2613 (interactive "P") 2613 (interactive "P")
2614 (save-window-excursion 2614 (save-window-excursion
2615 (gnus-summary-show-article t) 2615 (gnus-summary-show-article t)
diff --git a/lisp/help.el b/lisp/help.el
index e40178de964..1ae4b2c38d9 100644
--- a/lisp/help.el
+++ b/lisp/help.el
@@ -1022,7 +1022,7 @@ appeared on the mode-line."
1022 (delq nil (mapcar 'symbol-name minor-mode-list))) 1022 (delq nil (mapcar 'symbol-name minor-mode-list)))
1023 1023
1024(defun describe-minor-mode-from-symbol (symbol) 1024(defun describe-minor-mode-from-symbol (symbol)
1025 "Display documentation of a minor mode given as a symbol, SYMBOL" 1025 "Display documentation of a minor mode given as a symbol, SYMBOL."
1026 (interactive (list (intern (completing-read 1026 (interactive (list (intern (completing-read
1027 "Minor mode symbol: " 1027 "Minor mode symbol: "
1028 (describe-minor-mode-completion-table-for-symbol))))) 1028 (describe-minor-mode-completion-table-for-symbol)))))
diff --git a/lisp/hippie-exp.el b/lisp/hippie-exp.el
index 404f448e0d2..89d1342fbec 100644
--- a/lisp/hippie-exp.el
+++ b/lisp/hippie-exp.el
@@ -248,7 +248,7 @@ If nil, all buffers are searched."
248(defcustom hippie-expand-ignore-buffers '("^ \\*.*\\*$" dired-mode) 248(defcustom hippie-expand-ignore-buffers '("^ \\*.*\\*$" dired-mode)
249 "A list specifying which buffers not to search (if not current). 249 "A list specifying which buffers not to search (if not current).
250Can contain both regexps matching buffer names (as strings) and major modes 250Can contain both regexps matching buffer names (as strings) and major modes
251\(as atoms)" 251\(as atoms)."
252 :type '(repeat (choice regexp (symbol :tag "Major Mode"))) 252 :type '(repeat (choice regexp (symbol :tag "Major Mode")))
253 :group 'hippie-expand) 253 :group 'hippie-expand)
254 254
diff --git a/lisp/htmlfontify.el b/lisp/htmlfontify.el
index c1aaab5e211..481b14738bc 100644
--- a/lisp/htmlfontify.el
+++ b/lisp/htmlfontify.el
@@ -460,7 +460,7 @@ and so on."
460 keep-overlays : More of a bell (or possibly whistle) than an 460 keep-overlays : More of a bell (or possibly whistle) than an
461 optimization - If on, preserve overlay highlighting 461 optimization - If on, preserve overlay highlighting
462 (cf ediff or goo-font-lock) as well as basic faces.\n 462 (cf ediff or goo-font-lock) as well as basic faces.\n
463 body-text-only : Emit only body-text. In concrete terms, 463 body-text-only : Emit only body-text. In concrete terms,
464 1. Suppress calls to `hfy-page-header' and 464 1. Suppress calls to `hfy-page-header' and
465 `hfy-page-footer' 465 `hfy-page-footer'
466 2. Pretend that `div-wrapper' option above is 466 2. Pretend that `div-wrapper' option above is
@@ -1066,7 +1066,7 @@ haven't encountered them yet. Returns a `hfy-style-assoc'."
1066 1066
1067(defun hfy-face-resolve-face (fn) 1067(defun hfy-face-resolve-face (fn)
1068 "For FN return a face specification. 1068 "For FN return a face specification.
1069FN may be either a face or a face specification. If the latter, 1069FN may be either a face or a face specification. If the latter,
1070then the specification is returned unchanged." 1070then the specification is returned unchanged."
1071 (cond 1071 (cond
1072 ((facep fn) 1072 ((facep fn)
@@ -1593,8 +1593,8 @@ Do not record undo information during evaluation of BODY."
1593 1593
1594(defun hfy-begin-span (style text-block text-id text-begins-block-p) 1594(defun hfy-begin-span (style text-block text-id text-begins-block-p)
1595 "Default handler to begin a span of text. 1595 "Default handler to begin a span of text.
1596Insert \"<span class=\"STYLE\" ...>\". See 1596Insert \"<span class=\"STYLE\" ...>\".
1597`hfy-begin-span-handler' for more information." 1597See `hfy-begin-span-handler' for more information."
1598 (when text-begins-block-p 1598 (when text-begins-block-p
1599 (insert 1599 (insert
1600 (format "<span onclick=\"toggle_invis('%s');\">…</span>" text-block))) 1600 (format "<span onclick=\"toggle_invis('%s');\">…</span>" text-block)))
diff --git a/lisp/ibuf-ext.el b/lisp/ibuf-ext.el
index 06a2248d405..2746e4115a0 100644
--- a/lisp/ibuf-ext.el
+++ b/lisp/ibuf-ext.el
@@ -127,12 +127,12 @@ Buffers whose major mode is in this list, are not searched."
127(defvar ibuffer-auto-buffers-changed nil) 127(defvar ibuffer-auto-buffers-changed nil)
128 128
129(defun ibuffer-update-saved-filters-format (filters) 129(defun ibuffer-update-saved-filters-format (filters)
130 "Transforms alist from old to new `ibuffer-saved-filters' format. 130 "Transform alist from old to new `ibuffer-saved-filters' format.
131 131
132Specifically, converts old-format alist with values of the 132Specifically, converts old-format alist with values of the
133form (STRING (FILTER-SPECS...)) to alist with values of the 133form (STRING (FILTER-SPECS...)) to alist with values of the
134form (STRING FILTER-SPECS...), where each filter spec should be a 134form (STRING FILTER-SPECS...), where each filter spec should be a
135cons cell with a symbol in the car. Any elements in the latter 135cons cell with a symbol in the car. Any elements in the latter
136form are kept as is. 136form are kept as is.
137 137
138Returns (OLD-FORMAT-DETECTED . UPDATED-SAVED-FILTERS-LIST)." 138Returns (OLD-FORMAT-DETECTED . UPDATED-SAVED-FILTERS-LIST)."
@@ -178,14 +178,14 @@ Returns (OLD-FORMAT-DETECTED . UPDATED-SAVED-FILTERS-LIST)."
178 178
179Each element should look like (\"NAME\" . FILTER-LIST), where 179Each element should look like (\"NAME\" . FILTER-LIST), where
180FILTER-LIST has the same structure as the variable 180FILTER-LIST has the same structure as the variable
181`ibuffer-filtering-qualifiers', which see. The filters defined 181`ibuffer-filtering-qualifiers', which see. The filters defined
182here are joined with an implicit logical `and' and associated 182here are joined with an implicit logical `and' and associated
183with NAME. The combined specification can be used by name in 183with NAME. The combined specification can be used by name in
184other filter specifications via the `saved' qualifier (again, see 184other filter specifications via the `saved' qualifier (again, see
185`ibuffer-filtering-qualifiers'). They can also be switched to by 185`ibuffer-filtering-qualifiers'). They can also be switched to by
186name (see the functions `ibuffer-switch-to-saved-filters' and 186name (see the functions `ibuffer-switch-to-saved-filters' and
187`ibuffer-save-filters'). The variable `ibuffer-save-with-custom' 187`ibuffer-save-filters'). The variable `ibuffer-save-with-custom'
188affects how this information is saved for future sessions. This 188affects how this information is saved for future sessions. This
189variable can be set directly from lisp code." 189variable can be set directly from lisp code."
190 :version "26.1" 190 :version "26.1"
191 :type '(alist :key-type (string :tag "Filter name") 191 :type '(alist :key-type (string :tag "Filter name")
@@ -213,14 +213,14 @@ either clicking or hitting return "
213 (customize-save-variable 'ibuffer-saved-filters 213 (customize-save-variable 'ibuffer-saved-filters
214 ibuffer-saved-filters) 214 ibuffer-saved-filters)
215 (message "Saved updated ibuffer-saved-filters.")))) 215 (message "Saved updated ibuffer-saved-filters."))))
216 ". See below for 216 ". See below for
217an explanation and alternative ways to save the repaired value. 217an explanation and alternative ways to save the repaired value.
218 218
219Explanation: For the list variable `ibuffer-saved-filters', 219Explanation: For the list variable `ibuffer-saved-filters',
220elements of the form (STRING (FILTER-SPECS...)) are deprecated 220elements of the form (STRING (FILTER-SPECS...)) are deprecated
221and should instead have the form (STRING FILTER-SPECS...), where 221and should instead have the form (STRING FILTER-SPECS...), where
222each filter spec is a cons cell with a symbol in the car. See 222each filter spec is a cons cell with a symbol in the car. See
223`ibuffer-saved-filters' for details. The repaired value fixes 223`ibuffer-saved-filters' for details. The repaired value fixes
224this format without changing the meaning of the saved filters. 224this format without changing the meaning of the saved filters.
225 225
226Alternative ways to save the repaired value: 226Alternative ways to save the repaired value:
@@ -238,7 +238,7 @@ Alternative ways to save the repaired value:
238 "A list specifying the filters currently acting on the buffer list. 238 "A list specifying the filters currently acting on the buffer list.
239 239
240If this list is nil, then no filters are currently in 240If this list is nil, then no filters are currently in
241effect. Otherwise, each element of this list specifies a single 241effect. Otherwise, each element of this list specifies a single
242filter, and all of the specified filters in the list are applied 242filter, and all of the specified filters in the list are applied
243successively to the buffer list. 243successively to the buffer list.
244 244
@@ -273,7 +273,7 @@ A compound filter specification can have one of four forms:
273-- (saved . \"NAME\") 273-- (saved . \"NAME\")
274 274
275 Represents the filter saved under the string NAME 275 Represents the filter saved under the string NAME
276 in the alist `ibuffer-saved-filters'. It is an 276 in the alist `ibuffer-saved-filters'. It is an
277 error to name a filter that has not been saved. 277 error to name a filter that has not been saved.
278 278
279This variable is local to each ibuffer buffer.") 279This variable is local to each ibuffer buffer.")
@@ -363,12 +363,12 @@ Currently, this only applies to `ibuffer-saved-filters' and
363 :group 'ibuffer) 363 :group 'ibuffer)
364 364
365(defun ibuffer-repair-saved-filters () 365(defun ibuffer-repair-saved-filters ()
366 "Updates `ibuffer-saved-filters' to its new-style format, if needed. 366 "Update `ibuffer-saved-filters' to its new-style format, if needed.
367 367
368If this list has any elements of the old-style format, a 368If this list has any elements of the old-style format, a
369deprecation warning is raised, with a button allowing persistent 369deprecation warning is raised, with a button allowing persistent
370update. Any updated filters retain their meaning in the new 370update. Any updated filters retain their meaning in the new
371format. See `ibuffer-update-saved-filters-format' and 371format. See `ibuffer-update-saved-filters-format' and
372`ibuffer-saved-filters' for details of the old and new formats." 372`ibuffer-saved-filters' for details of the old and new formats."
373 (interactive) 373 (interactive)
374 (when (and (boundp 'ibuffer-saved-filters) ibuffer-saved-filters) 374 (when (and (boundp 'ibuffer-saved-filters) ibuffer-saved-filters)
@@ -560,8 +560,8 @@ format. See `ibuffer-update-saved-filters-format' and
560;;;###autoload (autoload 'ibuffer-do-eval "ibuf-ext") 560;;;###autoload (autoload 'ibuffer-do-eval "ibuf-ext")
561(define-ibuffer-op eval (form) 561(define-ibuffer-op eval (form)
562 "Evaluate FORM in each of the buffers. 562 "Evaluate FORM in each of the buffers.
563Does not display the buffer during evaluation. See 563Does not display the buffer during evaluation.
564`ibuffer-do-view-and-eval' for that." 564See `ibuffer-do-view-and-eval' for that."
565 (:interactive 565 (:interactive
566 (list 566 (list
567 (read-from-minibuffer 567 (read-from-minibuffer
@@ -697,10 +697,10 @@ specifications with the same structure as
697 filters)))) 697 filters))))
698 698
699(defun ibuffer-unary-operand (filter) 699(defun ibuffer-unary-operand (filter)
700 "Extracts operand from a unary compound FILTER specification. 700 "Extract operand from a unary compound FILTER specification.
701 701
702FILTER should be a cons cell of either form (f . d) or (f d), 702FILTER should be a cons cell of either form (f . d) or (f d),
703where operand d is itself a cons cell, or nil. Returns d." 703where operand d is itself a cons cell, or nil. Returns d."
704 (let* ((tail (cdr filter)) 704 (let* ((tail (cdr filter))
705 (maybe-q (car-safe tail))) 705 (maybe-q (car-safe tail)))
706 (if (consp maybe-q) maybe-q tail))) 706 (if (consp maybe-q) maybe-q tail)))
@@ -1337,7 +1337,7 @@ matches against 'c.d'."
1337 "Limit current view to buffers with filename extension matching QUALIFIER. 1337 "Limit current view to buffers with filename extension matching QUALIFIER.
1338 1338
1339The separator character (typically `.') is not part of the 1339The separator character (typically `.') is not part of the
1340pattern. For example, for a buffer associated with file 1340pattern. For example, for a buffer associated with file
1341'/a/b/c.d', this matches against 'd'." 1341'/a/b/c.d', this matches against 'd'."
1342 (:description "filename extension" 1342 (:description "filename extension"
1343 :reader (read-from-minibuffer 1343 :reader (read-from-minibuffer
@@ -1350,7 +1350,7 @@ pattern. For example, for a buffer associated with file
1350 "Limit current view to buffers with directory matching QUALIFIER. 1350 "Limit current view to buffers with directory matching QUALIFIER.
1351 1351
1352For a buffer associated with file '/a/b/c.d', this matches 1352For a buffer associated with file '/a/b/c.d', this matches
1353against '/a/b'. For a buffer not associated with a file, this 1353against '/a/b'. For a buffer not associated with a file, this
1354matches against the value of `default-directory' in that buffer." 1354matches against the value of `default-directory' in that buffer."
1355 (:description "directory name" 1355 (:description "directory name"
1356 :reader (read-from-minibuffer "Filter by directory name (regex): ")) 1356 :reader (read-from-minibuffer "Filter by directory name (regex): "))
diff --git a/lisp/image-dired.el b/lisp/image-dired.el
index c9b31e9f1f8..c1c767ba783 100644
--- a/lisp/image-dired.el
+++ b/lisp/image-dired.el
@@ -298,7 +298,7 @@ with the information required by the Thumbnail Managing Standard."
298 "Arguments for `image-dired-cmd-pngcrush-program'. 298 "Arguments for `image-dired-cmd-pngcrush-program'.
299Available format specifiers are the same as in 299Available format specifiers are the same as in
300`image-dired-cmd-create-thumbnail-options', with %q for a 300`image-dired-cmd-create-thumbnail-options', with %q for a
301temporary file name (typically generated by pnqnq)" 301temporary file name (typically generated by pnqnq)."
302 :version "26.1" 302 :version "26.1"
303 :type '(repeat (string :tag "Argument")) 303 :type '(repeat (string :tag "Argument"))
304 :group 'image-dired) 304 :group 'image-dired)
diff --git a/lisp/image-mode.el b/lisp/image-mode.el
index 9c7c91eb58a..fae928f4e67 100644
--- a/lisp/image-mode.el
+++ b/lisp/image-mode.el
@@ -809,7 +809,7 @@ was inserted."
809 809
810If the current buffer is displaying an image file as an image, 810If the current buffer is displaying an image file as an image,
811call `image-mode-as-text' to switch to text or hex display. 811call `image-mode-as-text' to switch to text or hex display.
812Otherwise, display the image by calling `image-mode'" 812Otherwise, display the image by calling `image-mode'."
813 (interactive) 813 (interactive)
814 (if (image-get-display-property) 814 (if (image-get-display-property)
815 (image-mode-as-text) 815 (image-mode-as-text)
diff --git a/lisp/international/ccl.el b/lisp/international/ccl.el
index 51626f51618..fb866fe354c 100644
--- a/lisp/international/ccl.el
+++ b/lisp/international/ccl.el
@@ -813,7 +813,7 @@ is a list of CCL-BLOCKs."
813 t) 813 t)
814 814
815(defun ccl-compile-read-multibyte-character (cmd) 815(defun ccl-compile-read-multibyte-character (cmd)
816 "Compile read-multibyte-character" 816 "Compile read-multibyte-character."
817 (if (/= (length cmd) 3) 817 (if (/= (length cmd) 3)
818 (error "CCL: Invalid number of arguments: %s" cmd)) 818 (error "CCL: Invalid number of arguments: %s" cmd))
819 (let ((RRR (nth 1 cmd)) 819 (let ((RRR (nth 1 cmd))
@@ -824,7 +824,7 @@ is a list of CCL-BLOCKs."
824 nil) 824 nil)
825 825
826(defun ccl-compile-write-multibyte-character (cmd) 826(defun ccl-compile-write-multibyte-character (cmd)
827 "Compile write-multibyte-character" 827 "Compile write-multibyte-character."
828 (if (/= (length cmd) 3) 828 (if (/= (length cmd) 3)
829 (error "CCL: Invalid number of arguments: %s" cmd)) 829 (error "CCL: Invalid number of arguments: %s" cmd))
830 (let ((RRR (nth 1 cmd)) 830 (let ((RRR (nth 1 cmd))
diff --git a/lisp/international/kkc.el b/lisp/international/kkc.el
index 437971742dc..8e62a2d1cc2 100644
--- a/lisp/international/kkc.el
+++ b/lisp/international/kkc.el
@@ -59,7 +59,7 @@ This string is shown at mode line when users are in KKC mode.")
59(defconst kkc-lookup-cache-tag 'kkc-lookup-cache-2) 59(defconst kkc-lookup-cache-tag 'kkc-lookup-cache-2)
60 60
61(defun kkc-save-init-file () 61(defun kkc-save-init-file ()
62 "Save initial setup code for KKC to a file specified by `kkc-init-file-name'" 62 "Save initial setup code for KKC to a file specified by `kkc-init-file-name'."
63 (if (and kkc-init-file-flag 63 (if (and kkc-init-file-flag
64 (not (eq kkc-init-file-flag t))) 64 (not (eq kkc-init-file-flag t)))
65 (let ((coding-system-for-write 'iso-2022-7bit) 65 (let ((coding-system-for-write 'iso-2022-7bit)
diff --git a/lisp/international/latin1-disp.el b/lisp/international/latin1-disp.el
index 1b7bc49a6be..67347f3e0d3 100644
--- a/lisp/international/latin1-disp.el
+++ b/lisp/international/latin1-disp.el
@@ -97,7 +97,7 @@ use either \\[customize] or the function `latin1-display'."
97 "Set up Latin-1/ASCII display for the arguments character SETS. 97 "Set up Latin-1/ASCII display for the arguments character SETS.
98See option `latin1-display' for the method. The members of the list 98See option `latin1-display' for the method. The members of the list
99must be in `latin1-display-sets'. With no arguments, reset the 99must be in `latin1-display-sets'. With no arguments, reset the
100display for all of `latin1-display-sets'. See also 100display for all of `latin1-display-sets'. See also
101`latin1-display-setup'." 101`latin1-display-setup'."
102 (if sets 102 (if sets
103 (progn 103 (progn
diff --git a/lisp/international/ogonek.el b/lisp/international/ogonek.el
index 543f2e33888..594d0a07657 100644
--- a/lisp/international/ogonek.el
+++ b/lisp/international/ogonek.el
@@ -62,8 +62,8 @@
62 136 141 171 184 196 151 230 144 253)) 62 136 141 171 184 196 151 230 144 253))
63 ) 63 )
64 "The constant `ogonek-name-encoding-alist' is a list of (NAME.LIST) pairs. 64 "The constant `ogonek-name-encoding-alist' is a list of (NAME.LIST) pairs.
65Each LIST contains codes for 18 Polish diacritic characters. The codes 65Each LIST contains codes for 18 Polish diacritic characters.
66are given in the following order: 66The codes are given in the following order:
67 Aogonek Cacute Eogonek Lslash Nacute Oacute Sacute Zacute Zdotaccent 67 Aogonek Cacute Eogonek Lslash Nacute Oacute Sacute Zacute Zdotaccent
68 aogonek cacute eogonek lslash nacute oacute sacute zacute zdotaccent.") 68 aogonek cacute eogonek lslash nacute oacute sacute zacute zdotaccent.")
69 69
@@ -173,7 +173,7 @@ znak/ow diakrytycznych. Funkcje te mo/zna pogrupowa/c nast/epuj/aco.
173 " THE INTERACTIVE FUNCTIONS PROVIDED BY THE LIBRARY `ogonek'. 173 " THE INTERACTIVE FUNCTIONS PROVIDED BY THE LIBRARY `ogonek'.
174 174
175If you read this text then you are either looking at the library's 175If you read this text then you are either looking at the library's
176source text or you have called the `ogonek-how' command. In the 176source text or you have called the `ogonek-how' command. In the
177latter case you may remove this text using `\\[kill-buffer]'. 177latter case you may remove this text using `\\[kill-buffer]'.
178 178
179The library provides functions for changing the encoding of Polish 179The library provides functions for changing the encoding of Polish
@@ -182,13 +182,13 @@ The functions come in the following groups.
182 182
183 1. `ogonek-recode-region' and `ogonek-recode-buffer' to change 183 1. `ogonek-recode-region' and `ogonek-recode-buffer' to change
184 between one-character encodings, such as `iso-8859-2', `mazovia', 184 between one-character encodings, such as `iso-8859-2', `mazovia',
185 plain `ascii' or `TeX'. As the names suggest you may recode 185 plain `ascii' or `TeX'. As the names suggest you may recode
186 either the entire current buffer or just a marked region 186 either the entire current buffer or just a marked region
187 in it. You may use the functions interactively as commands. 187 in it. You may use the functions interactively as commands.
188 Once you call a command you will be asked about the code 188 Once you call a command you will be asked about the code
189 currently used in your text and the target encoding, the one 189 currently used in your text and the target encoding, the one
190 you want to get. The following example shows a non-interactive 190 you want to get. The following example shows a non-interactive
191 use of the functions in a program. This also illustrates what 191 use of the functions in a program. This also illustrates what
192 type of parameters the functions expect to be called with: 192 type of parameters the functions expect to be called with:
193 193
194 (ogonek-recode-region 194 (ogonek-recode-region
@@ -210,11 +210,11 @@ The functions come in the following groups.
210 (ogonek-prefixify-buffer prefix-char to-code-name) 210 (ogonek-prefixify-buffer prefix-char to-code-name)
211 211
212 The TAB character used in interactive mode makes `emacs' 212 The TAB character used in interactive mode makes `emacs'
213 display the list of encodings recognized by the library. The list 213 display the list of encodings recognized by the library. The list
214 is stored in the constant `ogonek-name-encoding-alist'. 214 is stored in the constant `ogonek-name-encoding-alist'.
215 215
216 The `ogonek' functions refer to five variables in which the suggested 216 The `ogonek' functions refer to five variables in which the suggested
217 answers to dialogue questions are stored. The variables and their 217 answers to dialogue questions are stored. The variables and their
218 default values are: 218 default values are:
219 219
220 ogonek-from-encoding iso8859-2 220 ogonek-from-encoding iso8859-2
@@ -239,7 +239,7 @@ The functions come in the following groups.
239 (autoload \\='ogonek-deprefixify-region \"ogonek\") 239 (autoload \\='ogonek-deprefixify-region \"ogonek\")
240 240
241 The most frequent function calls can be abbreviated and assigned to 241 The most frequent function calls can be abbreviated and assigned to
242 keyboard keys. Here are a few practical examples: 242 keyboard keys. Here are a few practical examples:
243 243
244 (defun deprefixify-iso8859-2-region (start end) 244 (defun deprefixify-iso8859-2-region (start end)
245 (interactive \"*r\") 245 (interactive \"*r\")
@@ -329,7 +329,7 @@ PROMPT is a string to be shown when the user is asked for a new prefix."
329(defun ogonek-lookup-encoding (encoding) 329(defun ogonek-lookup-encoding (encoding)
330 "Pick up an association for ENCODING in `ogonek-name-encoding-alist'. 330 "Pick up an association for ENCODING in `ogonek-name-encoding-alist'.
331Before returning a result test whether the string ENCODING is in 331Before returning a result test whether the string ENCODING is in
332the list `ogonek-name-encoding-alist'" 332the list `ogonek-name-encoding-alist'."
333 (let ((code-list (assoc encoding ogonek-name-encoding-alist))) 333 (let ((code-list (assoc encoding ogonek-name-encoding-alist)))
334 (if (null code-list) 334 (if (null code-list)
335 (error "! Name `%s' not known in `ogonek-name-encoding-alist'" 335 (error "! Name `%s' not known in `ogonek-name-encoding-alist'"
@@ -449,8 +449,8 @@ PREFIX-CHAR itself gets doubled."
449(defun ogonek-deprefixify-region (start end prefix-char to-encoding) 449(defun ogonek-deprefixify-region (start end prefix-char to-encoding)
450 "In a region, replace PREFIX pairs with their corresponding TO-encodings. 450 "In a region, replace PREFIX pairs with their corresponding TO-encodings.
451PREFIX-CHAR followed by a Polish character from the `ogonek-prefix-code' 451PREFIX-CHAR followed by a Polish character from the `ogonek-prefix-code'
452list is replaced with the corresponding TO-encoded character. A doubled 452list is replaced with the corresponding TO-encoded character. A doubled
453PREFIX-CHAR gets replaced with a single one. A combination of PREFIX-CHAR 453PREFIX-CHAR gets replaced with a single one. A combination of PREFIX-CHAR
454followed by a non-Polish character, that is one not listed in the 454followed by a non-Polish character, that is one not listed in the
455`ogonek-prefix-code' constant, is left unchanged." 455`ogonek-prefix-code' constant, is left unchanged."
456 (interactive (progn (barf-if-buffer-read-only) 456 (interactive (progn (barf-if-buffer-read-only)
diff --git a/lisp/isearch.el b/lisp/isearch.el
index ec51c2cf4cc..1e4a87ff481 100644
--- a/lisp/isearch.el
+++ b/lisp/isearch.el
@@ -207,8 +207,8 @@ to the search status stack.")
207 "Predicate to filter hits of Isearch and replace commands. 207 "Predicate to filter hits of Isearch and replace commands.
208Isearch hits that don't satisfy the predicate will be skipped. 208Isearch hits that don't satisfy the predicate will be skipped.
209The value should be a function of two arguments; it will be 209The value should be a function of two arguments; it will be
210called with the the positions of the start and the end of the 210called with the positions of the start and the end of the text
211text matched by Isearch and replace commands. If this function 211matched by Isearch and replace commands. If this function
212returns nil, Isearch and replace commands will continue searching 212returns nil, Isearch and replace commands will continue searching
213without stopping at resp. replacing this match. 213without stopping at resp. replacing this match.
214 214
@@ -2009,7 +2009,7 @@ Turning on character-folding turns off regexp mode.")
2009 "Text properties that are added to the isearch prompt.") 2009 "Text properties that are added to the isearch prompt.")
2010 2010
2011(defun isearch--momentary-message (string) 2011(defun isearch--momentary-message (string)
2012 "Print STRING at the end of the isearch prompt for 1 second" 2012 "Print STRING at the end of the isearch prompt for 1 second."
2013 (let ((message-log-max nil)) 2013 (let ((message-log-max nil))
2014 (message "%s%s%s" 2014 (message "%s%s%s"
2015 (isearch-message-prefix nil isearch-nonincremental) 2015 (isearch-message-prefix nil isearch-nonincremental)
diff --git a/lisp/jsonrpc.el b/lisp/jsonrpc.el
index 85fd40ecd26..41cd84627be 100644
--- a/lisp/jsonrpc.el
+++ b/lisp/jsonrpc.el
@@ -107,7 +107,7 @@ notifications. CONN, METHOD and PARAMS are the same as in
107;;; API mandatory 107;;; API mandatory
108(cl-defgeneric jsonrpc-connection-send (conn &key id method params result error) 108(cl-defgeneric jsonrpc-connection-send (conn &key id method params result error)
109 "Send a JSONRPC message to connection CONN. 109 "Send a JSONRPC message to connection CONN.
110ID, METHOD, PARAMS, RESULT and ERROR. ") 110ID, METHOD, PARAMS, RESULT and ERROR.")
111 111
112;;; API optional 112;;; API optional
113(cl-defgeneric jsonrpc-shutdown (conn) 113(cl-defgeneric jsonrpc-shutdown (conn)
@@ -343,7 +343,7 @@ ignored."
343 :documentation "Process object wrapped by the this connection.") 343 :documentation "Process object wrapped by the this connection.")
344 (-expected-bytes 344 (-expected-bytes
345 :accessor jsonrpc--expected-bytes 345 :accessor jsonrpc--expected-bytes
346 :documentation "How many bytes declared by server") 346 :documentation "How many bytes declared by server.")
347 (-on-shutdown 347 (-on-shutdown
348 :accessor jsonrpc--on-shutdown 348 :accessor jsonrpc--on-shutdown
349 :initform #'ignore 349 :initform #'ignore
@@ -416,13 +416,13 @@ connection object, called when the process dies .")
416(cl-defmethod jsonrpc-shutdown ((conn jsonrpc-process-connection) 416(cl-defmethod jsonrpc-shutdown ((conn jsonrpc-process-connection)
417 &optional cleanup) 417 &optional cleanup)
418 "Wait for JSONRPC connection CONN to shutdown. 418 "Wait for JSONRPC connection CONN to shutdown.
419With optional CLEANUP, kill any associated buffers. " 419With optional CLEANUP, kill any associated buffers."
420 (unwind-protect 420 (unwind-protect
421 (cl-loop 421 (cl-loop
422 with proc = (jsonrpc--process conn) for i from 0 422 with proc = (jsonrpc--process conn) for i from 0
423 while (not (process-get proc 'jsonrpc-sentinel-cleanup-started)) 423 while (not (process-get proc 'jsonrpc-sentinel-cleanup-started))
424 unless (zerop i) do 424 unless (zerop i) do
425 (jsonrpc--warn "Sentinel for %s still hasn't run, deleting it!" proc) 425 (jsonrpc--warn "Sentinel for %s still hasn't run, deleting it!" proc)
426 do 426 do
427 (delete-process proc) 427 (delete-process proc)
428 (accept-process-output nil 0.1)) 428 (accept-process-output nil 0.1))
@@ -574,8 +574,8 @@ With optional CLEANUP, kill any associated buffers. "
574 (deferred nil)) 574 (deferred nil))
575 "Does actual work for `jsonrpc-async-request'. 575 "Does actual work for `jsonrpc-async-request'.
576 576
577Return a list (ID TIMER). ID is the new request's ID, or nil if 577Return a list (ID TIMER). ID is the new request's ID, or nil if
578the request was deferred. TIMER is a timer object set (or nil, if 578the request was deferred. TIMER is a timer object set (or nil, if
579TIMEOUT is nil)." 579TIMEOUT is nil)."
580 (pcase-let* ((buf (current-buffer)) (point (point)) 580 (pcase-let* ((buf (current-buffer)) (point (point))
581 (`(,_ ,timer ,old-id) 581 (`(,_ ,timer ,old-id)
diff --git a/lisp/language/tibet-util.el b/lisp/language/tibet-util.el
index 68faf2016af..912879eb38d 100644
--- a/lisp/language/tibet-util.el
+++ b/lisp/language/tibet-util.el
@@ -54,7 +54,7 @@
54;;;###autoload 54;;;###autoload
55(defun tibetan-char-p (ch) 55(defun tibetan-char-p (ch)
56 "Check if char CH is Tibetan character. 56 "Check if char CH is Tibetan character.
57Returns non-nil if CH is Tibetan. Otherwise, returns nil." 57Returns non-nil if CH is Tibetan. Otherwise, returns nil."
58 (memq (char-charset ch) '(tibetan tibetan-1-column))) 58 (memq (char-charset ch) '(tibetan tibetan-1-column)))
59 59
60;;; Functions for Tibetan <-> Tibetan-transcription. 60;;; Functions for Tibetan <-> Tibetan-transcription.
diff --git a/lisp/mail/feedmail.el b/lisp/mail/feedmail.el
index b362614d3a0..08db4262f17 100644
--- a/lisp/mail/feedmail.el
+++ b/lisp/mail/feedmail.el
@@ -1136,9 +1136,9 @@ they were placed in the queue."
1136This variable is used by the default date generating function, 1136This variable is used by the default date generating function,
1137feedmail-default-date-generator. If nil, the default, the 1137feedmail-default-date-generator. If nil, the default, the
1138last-modified timestamp of the queue file is used to create the 1138last-modified timestamp of the queue file is used to create the
1139message Date: header; if there is no queue file, the current time is 1139message Date: header; if there is no queue file, the current time
1140used. If you are using VM, it might be supplying this header for 1140is used. If you are using VM, it might be supplying this header
1141you. To suppress VM's version 1141for you. To suppress VM's version
1142 1142
1143 (setq vm-mail-header-insert-date nil)" 1143 (setq vm-mail-header-insert-date nil)"
1144 :group 'feedmail-queue 1144 :group 'feedmail-queue
@@ -1382,7 +1382,7 @@ It shows the simple addresses and gets a confirmation. Use as:
1382When this hook runs, the current buffer is already the appropriate 1382When this hook runs, the current buffer is already the appropriate
1383buffer. It has already had all the header prepping from the standard 1383buffer. It has already had all the header prepping from the standard
1384package. The next step after running the hook will be to save the 1384package. The next step after running the hook will be to save the
1385message via Fcc: processing. The hook might be interested in these: 1385message via Fcc: processing. The hook might be interested in these:
1386\(1) `feedmail-prepped-text-buffer' contains the header and body of the 1386\(1) `feedmail-prepped-text-buffer' contains the header and body of the
1387message, ready to go; (2) `feedmail-address-list' contains a list 1387message, ready to go; (2) `feedmail-address-list' contains a list
1388of simplified recipients of addresses which are to be given to the 1388of simplified recipients of addresses which are to be given to the
@@ -1411,7 +1411,7 @@ can undo the encoding."
1411 "User's last opportunity to modify the message before Fcc action. 1411 "User's last opportunity to modify the message before Fcc action.
1412It has already had all the header prepping from the standard package. 1412It has already had all the header prepping from the standard package.
1413The next step after running the hook will be to save the message via 1413The next step after running the hook will be to save the message via
1414Fcc: processing. The hook might be interested in these: (1) 1414Fcc: processing. The hook might be interested in these: (1)
1415`feedmail-prepped-text-buffer' contains the header and body of the 1415`feedmail-prepped-text-buffer' contains the header and body of the
1416message, ready to go; (2) `feedmail-address-list' contains a list of 1416message, ready to go; (2) `feedmail-address-list' contains a list of
1417simplified recipients of addressees to whom the message was sent (3) 1417simplified recipients of addressees to whom the message was sent (3)
@@ -2361,7 +2361,7 @@ mapped to mostly alphanumerics for safety."
2361 ))) 2361 )))
2362 2362
2363(defun feedmail-send-it-immediately-wrapper () 2363(defun feedmail-send-it-immediately-wrapper ()
2364 "Wrapper to catch skip-me-i" 2364 "Wrapper to catch skip-me-i."
2365 (if (eq 'skip-me-i (catch 'skip-me-i (feedmail-send-it-immediately))) 2365 (if (eq 'skip-me-i (catch 'skip-me-i (feedmail-send-it-immediately)))
2366 (error "FQM: Sending...abandoned!"))) 2366 (error "FQM: Sending...abandoned!")))
2367 2367
@@ -3159,7 +3159,7 @@ been weeded out."
3159 (sit-for feedmail-queue-chatty-sit-for)))) 3159 (sit-for feedmail-queue-chatty-sit-for))))
3160 3160
3161(defun feedmail-find-eoh (&optional noerror) 3161(defun feedmail-find-eoh (&optional noerror)
3162 "Internal; finds the end of message header fields, returns mark just before it" 3162 "Internal; finds the end of message header fields, returns mark just before it."
3163 ;; all this funny business with line endings is to account for CRLF 3163 ;; all this funny business with line endings is to account for CRLF
3164 ;; weirdness that I don't think I'll ever figure out 3164 ;; weirdness that I don't think I'll ever figure out
3165 (feedmail-say-debug ">in-> feedmail-find-eoh %s" noerror) 3165 (feedmail-say-debug ">in-> feedmail-find-eoh %s" noerror)
diff --git a/lisp/mail/hashcash.el b/lisp/mail/hashcash.el
index 60689529974..185a7a7441a 100644
--- a/lisp/mail/hashcash.el
+++ b/lisp/mail/hashcash.el
@@ -158,7 +158,7 @@ For example, you may want to set this to (\"-Z2\") to reduce header length."
158 (or (nth 1 val) (nth 0 val) addr))) 158 (or (nth 1 val) (nth 0 val) addr)))
159 159
160(defun hashcash-generate-payment (str val) 160(defun hashcash-generate-payment (str val)
161 "Generate a hashcash payment by finding a VAL-bit collison on STR." 161 "Generate a hashcash payment by finding a VAL-bit collision on STR."
162 (if (and (> val 0) 162 (if (and (> val 0)
163 hashcash-program) 163 hashcash-program)
164 (with-current-buffer (get-buffer-create " *hashcash*") 164 (with-current-buffer (get-buffer-create " *hashcash*")
@@ -171,7 +171,7 @@ For example, you may want to set this to (\"-Z2\") to reduce header length."
171 (error "No `hashcash' binary found"))) 171 (error "No `hashcash' binary found")))
172 172
173(defun hashcash-generate-payment-async (str val callback) 173(defun hashcash-generate-payment-async (str val callback)
174 "Generate a hashcash payment by finding a VAL-bit collison on STR. 174 "Generate a hashcash payment by finding a VAL-bit collision on STR.
175Return immediately. Call CALLBACK with process and result when ready." 175Return immediately. Call CALLBACK with process and result when ready."
176 (if (and (> val 0) 176 (if (and (> val 0)
177 hashcash-program) 177 hashcash-program)
@@ -226,7 +226,7 @@ Return immediately. Call CALLBACK with process and result when ready."
226 226
227;;;###autoload 227;;;###autoload
228(defun hashcash-insert-payment (arg) 228(defun hashcash-insert-payment (arg)
229 "Insert X-Payment and X-Hashcash headers with a payment for ARG" 229 "Insert X-Payment and X-Hashcash headers with a payment for ARG."
230 (interactive "sPay to: ") 230 (interactive "sPay to: ")
231 (unless (hashcash-already-paid-p arg) 231 (unless (hashcash-already-paid-p arg)
232 (let ((pay (hashcash-generate-payment (hashcash-payment-to arg) 232 (let ((pay (hashcash-generate-payment (hashcash-payment-to arg)
@@ -294,7 +294,7 @@ BUFFER defaults to the current buffer."
294 294
295;;;###autoload 295;;;###autoload
296(defun hashcash-verify-payment (token &optional resource amount) 296(defun hashcash-verify-payment (token &optional resource amount)
297 "Verify a hashcash payment" 297 "Verify a hashcash payment."
298 (let* ((split (split-string token ":")) 298 (let* ((split (split-string token ":"))
299 (key (if (< (hashcash-version token) 1.2) 299 (key (if (< (hashcash-version token) 1.2)
300 (nth 1 split) 300 (nth 1 split)
diff --git a/lisp/mail/rmail.el b/lisp/mail/rmail.el
index 91291b8d330..93e7cb01334 100644
--- a/lisp/mail/rmail.el
+++ b/lisp/mail/rmail.el
@@ -285,7 +285,7 @@ Otherwise, look for `movemail' in the directories in
285 (throw 'scan x)))))))))) 285 (throw 'scan x))))))))))
286 286
287(defvar rmail-movemail-variant-in-use nil 287(defvar rmail-movemail-variant-in-use nil
288 "The movemail variant currently in use. Known variants are: 288 "The movemail variant currently in use. Known variants are:
289 289
290 `emacs' Means any implementation, compatible with the native Emacs one. 290 `emacs' Means any implementation, compatible with the native Emacs one.
291 This is the default; 291 This is the default;
@@ -2308,7 +2308,7 @@ If nil, that means the current message."
2308(defun rmail-get-attr-value (attr state) 2308(defun rmail-get-attr-value (attr state)
2309 "Return the character value for ATTR. 2309 "Return the character value for ATTR.
2310ATTR is a (numeric) index, an offset into the mbox attribute 2310ATTR is a (numeric) index, an offset into the mbox attribute
2311header value. STATE is one of nil, t, or a character value." 2311header value. STATE is one of nil, t, or a character value."
2312 (cond 2312 (cond
2313 ((numberp state) state) 2313 ((numberp state) state)
2314 ((not state) ?-) 2314 ((not state) ?-)
diff --git a/lisp/mail/rmailmm.el b/lisp/mail/rmailmm.el
index 95977e826d7..6106183ac04 100644
--- a/lisp/mail/rmailmm.el
+++ b/lisp/mail/rmailmm.el
@@ -147,7 +147,7 @@ display HTML source."
147 ;; Default to preferring HTML parts, but only if we have a renderer 147 ;; Default to preferring HTML parts, but only if we have a renderer
148 (if rmail-mime-render-html-function t nil) 148 (if rmail-mime-render-html-function t nil)
149 "If non-nil, default to showing HTML part rather than text part 149 "If non-nil, default to showing HTML part rather than text part
150when both are available" 150when both are available."
151 :group 'rmail 151 :group 'rmail
152 :version "25.1" 152 :version "25.1"
153 :type 'boolean) 153 :type 'boolean)
@@ -1391,8 +1391,8 @@ STATE forces a particular display state, rather than toggling.
1391`raw' forces raw mode, any other non-nil value forces decoded mode. 1391`raw' forces raw mode, any other non-nil value forces decoded mode.
1392 1392
1393If `rmail-enable-mime' is nil, this creates a temporary \"*RMAIL*\" 1393If `rmail-enable-mime' is nil, this creates a temporary \"*RMAIL*\"
1394buffer holding a decoded copy of the message. Inline content-types are 1394buffer holding a decoded copy of the message. Inline content-types
1395handled according to `rmail-mime-media-type-handlers-alist'. 1395are handled according to `rmail-mime-media-type-handlers-alist'.
1396By default, this displays text and multipart messages, and offers to 1396By default, this displays text and multipart messages, and offers to
1397download attachments as specified by `rmail-mime-attachment-dirs-alist'. 1397download attachments as specified by `rmail-mime-attachment-dirs-alist'.
1398The arguments ARG and STATE have no effect in this case." 1398The arguments ARG and STATE have no effect in this case."
diff --git a/lisp/mail/rmailsum.el b/lisp/mail/rmailsum.el
index 79a322c1d91..eacfc1f8294 100644
--- a/lisp/mail/rmailsum.el
+++ b/lisp/mail/rmailsum.el
@@ -1360,7 +1360,7 @@ move to the previous message."
1360 1360
1361(defun rmail-summary-show-message (where) 1361(defun rmail-summary-show-message (where)
1362 "Show current mail message. 1362 "Show current mail message.
1363Position it according to WHERE which can be BEG or END" 1363Position it according to WHERE which can be BEG or END."
1364 (if (and (one-window-p) (not pop-up-frames)) 1364 (if (and (one-window-p) (not pop-up-frames))
1365 ;; If there is just one window, put the summary on the top. 1365 ;; If there is just one window, put the summary on the top.
1366 (let ((buffer rmail-buffer)) 1366 (let ((buffer rmail-buffer))
diff --git a/lisp/mail/supercite.el b/lisp/mail/supercite.el
index ce00a7cf665..556e4b3923f 100644
--- a/lisp/mail/supercite.el
+++ b/lisp/mail/supercite.el
@@ -1753,7 +1753,7 @@ entered, regardless of the value of `sc-electric-references-p'. See
1753 1753
1754(defun sc-raw-mode-toggle () 1754(defun sc-raw-mode-toggle ()
1755 "Toggle, in one fell swoop, two important SC variables: 1755 "Toggle, in one fell swoop, two important SC variables:
1756`sc-fixup-whitespace-p' and `sc-auto-fill-region-p'" 1756`sc-fixup-whitespace-p' and `sc-auto-fill-region-p'."
1757 (interactive) 1757 (interactive)
1758 (setq sc-fixup-whitespace-p (not sc-fixup-whitespace-p) 1758 (setq sc-fixup-whitespace-p (not sc-fixup-whitespace-p)
1759 sc-auto-fill-region-p (not sc-auto-fill-region-p)) 1759 sc-auto-fill-region-p (not sc-auto-fill-region-p))
diff --git a/lisp/man.el b/lisp/man.el
index cef3d598eb9..9d21e953d14 100644
--- a/lisp/man.el
+++ b/lisp/man.el
@@ -1023,7 +1023,7 @@ names or descriptions. The pattern argument is usually an
1023 (man man-args))) 1023 (man man-args)))
1024 1024
1025(defmacro Man-start-calling (&rest body) 1025(defmacro Man-start-calling (&rest body)
1026 "Start the man command in `body' after setting up the environment" 1026 "Start the man command in `body' after setting up the environment."
1027 `(let ((process-environment (copy-sequence process-environment)) 1027 `(let ((process-environment (copy-sequence process-environment))
1028 ;; The following is so Awk script gets \n intact 1028 ;; The following is so Awk script gets \n intact
1029 ;; But don't prevent decoding of the outside. 1029 ;; But don't prevent decoding of the outside.
diff --git a/lisp/mh-e/mh-acros.el b/lisp/mh-e/mh-acros.el
index 0f15d3eb71b..809771d6d4e 100644
--- a/lisp/mh-e/mh-acros.el
+++ b/lisp/mh-e/mh-acros.el
@@ -160,8 +160,8 @@ Stronger than `save-excursion', weaker than `save-window-excursion'."
160;;;###mh-autoload 160;;;###mh-autoload
161(defmacro mh-do-at-event-location (event &rest body) 161(defmacro mh-do-at-event-location (event &rest body)
162 "Switch to the location of EVENT and execute BODY. 162 "Switch to the location of EVENT and execute BODY.
163After BODY has been executed return to original window. The 163After BODY has been executed return to original window.
164modification flag of the buffer in the event window is 164The modification flag of the buffer in the event window is
165preserved." 165preserved."
166 (declare (debug t)) 166 (declare (debug t))
167 (let ((event-window (make-symbol "event-window")) 167 (let ((event-window (make-symbol "event-window"))
@@ -206,7 +206,7 @@ preserved."
206 "Iterate over region. 206 "Iterate over region.
207 207
208VAR is bound to the message on the current line as we loop 208VAR is bound to the message on the current line as we loop
209starting from BEGIN till END. In each step BODY is executed. 209starting from BEGIN till END. In each step BODY is executed.
210 210
211If VAR is nil then the loop is executed without any binding." 211If VAR is nil then the loop is executed without any binding."
212 (declare (debug (symbolp body))) 212 (declare (debug (symbolp body)))
@@ -230,7 +230,7 @@ If VAR is nil then the loop is executed without any binding."
230VAR is bound to each message in turn in a loop over RANGE, which 230VAR is bound to each message in turn in a loop over RANGE, which
231can be a message number, a list of message numbers, a sequence, a 231can be a message number, a list of message numbers, a sequence, a
232region in a cons cell, or a MH range (something like last:20) in 232region in a cons cell, or a MH range (something like last:20) in
233a string. In each iteration, BODY is executed. 233a string. In each iteration, BODY is executed.
234 234
235The parameter RANGE is usually created with 235The parameter RANGE is usually created with
236`mh-interactive-range' in order to provide a uniform interface to 236`mh-interactive-range' in order to provide a uniform interface to
diff --git a/lisp/mh-e/mh-alias.el b/lisp/mh-e/mh-alias.el
index 2ff8801cd94..5573f22072e 100644
--- a/lisp/mh-e/mh-alias.el
+++ b/lisp/mh-e/mh-alias.el
@@ -51,10 +51,10 @@
51 "/usr/lib/mh/MailAliases" "/usr/share/mailutils/mh/MailAliases" 51 "/usr/lib/mh/MailAliases" "/usr/share/mailutils/mh/MailAliases"
52 "/etc/passwd") 52 "/etc/passwd")
53 "A list of system files which are a source of aliases. 53 "A list of system files which are a source of aliases.
54If these files are modified, they are automatically reread. This list 54If these files are modified, they are automatically reread. This list
55need include only system aliases and the passwd file, since personal 55need include only system aliases and the passwd file, since personal
56alias files listed in your \"Aliasfile:\" MH profile component are 56alias files listed in your \"Aliasfile:\" MH profile component are
57automatically included. You can update the alias list manually using 57automatically included. You can update the alias list manually using
58\\[mh-alias-reload]." 58\\[mh-alias-reload]."
59 :type '(repeat file) 59 :type '(repeat file)
60 :group 'mh-alias) 60 :group 'mh-alias)
@@ -170,9 +170,9 @@ Exclude all aliases already in `mh-alias-alist' from \"ali\""
170 170
171Since aliases are updated frequently, MH-E reloads aliases 171Since aliases are updated frequently, MH-E reloads aliases
172automatically whenever an alias lookup occurs if an alias source has 172automatically whenever an alias lookup occurs if an alias source has
173changed. Sources include files listed in your \"Aliasfile:\" profile 173changed. Sources include files listed in your \"Aliasfile:\" profile
174component and your password file if option `mh-alias-local-users' is 174component and your password file if option `mh-alias-local-users' is
175turned on. However, you can reload your aliases manually by calling 175turned on. However, you can reload your aliases manually by calling
176this command directly. 176this command directly.
177 177
178This function runs `mh-alias-reloaded-hook' after the aliases have 178This function runs `mh-alias-reloaded-hook' after the aliases have
@@ -224,8 +224,9 @@ been loaded."
224(defun mh-alias-ali (alias &optional user) 224(defun mh-alias-ali (alias &optional user)
225 "Return ali expansion for ALIAS. 225 "Return ali expansion for ALIAS.
226ALIAS must be a string for a single alias. 226ALIAS must be a string for a single alias.
227If USER is t, then assume ALIAS is an address and call ali -user. ali 227If USER is t, then assume ALIAS is an address and call ali -user.
228returns the string unchanged if not defined. The same is done here." 228ali returns the string unchanged if not defined. The same is
229done here."
229 (condition-case err 230 (condition-case err
230 (save-excursion 231 (save-excursion
231 (let ((user-arg (if user "-user" "-nouser"))) 232 (let ((user-arg (if user "-user" "-nouser")))
@@ -378,8 +379,8 @@ NO-COMMA-SWAP is non-nil."
378 379
379(defun mh-alias-canonicalize-suggestion (string) 380(defun mh-alias-canonicalize-suggestion (string)
380 "Process STRING to replace spaces by periods. 381 "Process STRING to replace spaces by periods.
381First all spaces and commas are replaced by periods. Then every run of 382First all spaces and commas are replaced by periods. Then every run
382consecutive periods are replaced with a single period. Finally the 383of consecutive periods are replaced with a single period. Finally the
383string is converted to lower case." 384string is converted to lower case."
384 (with-temp-buffer 385 (with-temp-buffer
385 (insert string) 386 (insert string)
@@ -492,9 +493,9 @@ Prompt for alias file if not provided and there is more than one
492candidate. 493candidate.
493 494
494If the alias exists already, you will have the choice of 495If the alias exists already, you will have the choice of
495inserting the new alias before or after the old alias. In the 496inserting the new alias before or after the old alias. In the
496former case, this alias will be used when sending mail to this 497former case, this alias will be used when sending mail to this
497alias. In the latter case, the alias serves as an additional 498alias. In the latter case, the alias serves as an additional
498folder name hint when filing messages." 499folder name hint when filing messages."
499 (if (not file) 500 (if (not file)
500 (setq file (mh-alias-insert-file alias))) 501 (setq file (mh-alias-insert-file alias)))
@@ -544,10 +545,10 @@ folder name hint when filing messages."
544(defun mh-alias-add-alias (alias address) 545(defun mh-alias-add-alias (alias address)
545 "Add ALIAS for ADDRESS in personal alias file. 546 "Add ALIAS for ADDRESS in personal alias file.
546 547
547This function prompts you for an alias and address. If the alias 548This function prompts you for an alias and address. If the alias
548exists already, you will have the choice of inserting the new 549exists already, you will have the choice of inserting the new
549alias before or after the old alias. In the former case, this 550alias before or after the old alias. In the former case, this
550alias will be used when sending mail to this alias. In the latter 551alias will be used when sending mail to this alias. In the latter
551case, the alias serves as an additional folder name hint when 552case, the alias serves as an additional folder name hint when
552filing messages." 553filing messages."
553 (interactive "P\nP") 554 (interactive "P\nP")
diff --git a/lisp/mouse.el b/lisp/mouse.el
index e947e16d47f..123ce2ca154 100644
--- a/lisp/mouse.el
+++ b/lisp/mouse.el
@@ -1592,7 +1592,7 @@ previous region was just saved to the kill ring).
1592 1592
1593If this command is called a second consecutive time with the same 1593If this command is called a second consecutive time with the same
1594CLICK position, kill the region (or delete it 1594CLICK position, kill the region (or delete it
1595if `mouse-drag-copy-region' is non-nil)" 1595if `mouse-drag-copy-region' is non-nil)."
1596 (interactive "e") 1596 (interactive "e")
1597 (mouse-minibuffer-check click) 1597 (mouse-minibuffer-check click)
1598 (let* ((posn (event-start click)) 1598 (let* ((posn (event-start click))
diff --git a/lisp/net/browse-url.el b/lisp/net/browse-url.el
index 87a8248854f..ce899bdee57 100644
--- a/lisp/net/browse-url.el
+++ b/lisp/net/browse-url.el
@@ -877,7 +877,7 @@ The optional NEW-WINDOW argument is not used."
877 877
878(defun browse-url-default-macosx-browser (url &optional _new-window) 878(defun browse-url-default-macosx-browser (url &optional _new-window)
879 "Invoke the macOS system's default Web browser. 879 "Invoke the macOS system's default Web browser.
880The optional NEW-WINDOW argument is not used" 880The optional NEW-WINDOW argument is not used."
881 (interactive (browse-url-interactive-arg "URL: ")) 881 (interactive (browse-url-interactive-arg "URL: "))
882 (start-process (concat "open " url) nil "open" url)) 882 (start-process (concat "open " url) nil "open" url))
883 883
diff --git a/lisp/net/eudc.el b/lisp/net/eudc.el
index 3c9c01d0f96..586dd210ed5 100644
--- a/lisp/net/eudc.el
+++ b/lisp/net/eudc.el
@@ -229,7 +229,7 @@ The current binding of VAR is changed only if SERVER is omitted."
229 229
230(defun eudc-set (var val) 230(defun eudc-set (var val)
231 "Set the most local (server, protocol or default) binding of VAR to VAL. 231 "Set the most local (server, protocol or default) binding of VAR to VAL.
232The current binding of VAR is also set to VAL" 232The current binding of VAR is also set to VAL."
233 (cond 233 (cond
234 ((not (eq 'unbound (eudc-variable-server-value var))) 234 ((not (eq 'unbound (eudc-variable-server-value var)))
235 (eudc-server-set var val)) 235 (eudc-server-set var val))
@@ -251,7 +251,7 @@ Return `unbound' if VAR has no EUDC default value."
251(defun eudc-variable-protocol-value (var &optional protocol) 251(defun eudc-variable-protocol-value (var &optional protocol)
252 "Return the value of VAR local to PROTOCOL. 252 "Return the value of VAR local to PROTOCOL.
253Return `unbound' if VAR has no value local to PROTOCOL. 253Return `unbound' if VAR has no value local to PROTOCOL.
254PROTOCOL defaults to `eudc-protocol'" 254PROTOCOL defaults to `eudc-protocol'."
255 (let* ((eudc-locals (get var 'eudc-locals)) 255 (let* ((eudc-locals (get var 'eudc-locals))
256 protocol-locals) 256 protocol-locals)
257 (if (not (and (boundp var) 257 (if (not (and (boundp var)
@@ -266,7 +266,7 @@ PROTOCOL defaults to `eudc-protocol'"
266(defun eudc-variable-server-value (var &optional server) 266(defun eudc-variable-server-value (var &optional server)
267 "Return the value of VAR local to SERVER. 267 "Return the value of VAR local to SERVER.
268Return `unbound' if VAR has no value local to SERVER. 268Return `unbound' if VAR has no value local to SERVER.
269SERVER defaults to `eudc-server'" 269SERVER defaults to `eudc-server'."
270 (let* ((eudc-locals (get var 'eudc-locals)) 270 (let* ((eudc-locals (get var 'eudc-locals))
271 server-locals) 271 server-locals)
272 (if (not (and (boundp var) 272 (if (not (and (boundp var)
@@ -282,7 +282,7 @@ SERVER defaults to `eudc-server'"
282 "Set the value of VAR according to its locals. 282 "Set the value of VAR according to its locals.
283If the VAR has a server- or protocol-local value corresponding 283If the VAR has a server- or protocol-local value corresponding
284to the current `eudc-server' and `eudc-protocol' then it is set 284to the current `eudc-server' and `eudc-protocol' then it is set
285accordingly. Otherwise it is set to its EUDC default binding" 285accordingly. Otherwise it is set to its EUDC default binding."
286 (let (val) 286 (let (val)
287 (cond 287 (cond
288 ((not (eq 'unbound (setq val (eudc-variable-server-value var)))) 288 ((not (eq 'unbound (setq val (eudc-variable-server-value var))))
@@ -775,7 +775,7 @@ After querying the server for the given string, the expansion specified by
775If REPLACE is non-nil, then this expansion replaces the name in the buffer. 775If REPLACE is non-nil, then this expansion replaces the name in the buffer.
776`eudc-expansion-overwrites-query' being non-nil inverts the meaning of REPLACE. 776`eudc-expansion-overwrites-query' being non-nil inverts the meaning of REPLACE.
777Multiple servers can be tried with the same query until one finds a match, 777Multiple servers can be tried with the same query until one finds a match,
778see `eudc-inline-expansion-servers'" 778see `eudc-inline-expansion-servers'."
779 (interactive) 779 (interactive)
780 (cond 780 (cond
781 ((eq eudc-inline-expansion-servers 'current-server) 781 ((eq eudc-inline-expansion-servers 'current-server)
diff --git a/lisp/net/eudcb-bbdb.el b/lisp/net/eudcb-bbdb.el
index f91d0af858d..f9b3c47a4bf 100644
--- a/lisp/net/eudcb-bbdb.el
+++ b/lisp/net/eudcb-bbdb.el
@@ -179,7 +179,7 @@ BBDB < 3 used `net'; BBDB >= 3 uses `mail'."
179 179
180(defun eudc-bbdb-format-record-as-result (record) 180(defun eudc-bbdb-format-record-as-result (record)
181 "Format the BBDB RECORD as a EUDC query result record. 181 "Format the BBDB RECORD as a EUDC query result record.
182The record is filtered according to `eudc-bbdb-current-return-attributes'" 182The record is filtered according to `eudc-bbdb-current-return-attributes'."
183 (require 'bbdb) 183 (require 'bbdb)
184 (let ((attrs (or eudc-bbdb-current-return-attributes 184 (let ((attrs (or eudc-bbdb-current-return-attributes
185 '(firstname lastname aka company phones addresses net notes))) 185 '(firstname lastname aka company phones addresses net notes)))
diff --git a/lisp/net/eudcb-ldap.el b/lisp/net/eudcb-ldap.el
index 7514d1ad299..464c62da123 100644
--- a/lisp/net/eudcb-ldap.el
+++ b/lisp/net/eudcb-ldap.el
@@ -148,7 +148,7 @@ RETURN-ATTRS is a list of attributes to return, defaulting to
148(defun eudc-ldap-get-field-list (_dummy &optional objectclass) 148(defun eudc-ldap-get-field-list (_dummy &optional objectclass)
149 "Return a list of valid attribute names for the current server. 149 "Return a list of valid attribute names for the current server.
150OBJECTCLASS is the LDAP object class for which the valid 150OBJECTCLASS is the LDAP object class for which the valid
151attribute names are returned. Default to `person'" 151attribute names are returned. Default to `person'."
152 (interactive) 152 (interactive)
153 (or eudc-server 153 (or eudc-server
154 (call-interactively 'eudc-set-server)) 154 (call-interactively 'eudc-set-server))
diff --git a/lisp/net/pop3.el b/lisp/net/pop3.el
index 5f1cd94eb60..74a632a3a20 100644
--- a/lisp/net/pop3.el
+++ b/lisp/net/pop3.el
@@ -710,7 +710,7 @@ If NOW, use that time instead."
710 710
711(defun pop3-list (process &optional msg) 711(defun pop3-list (process &optional msg)
712 "If MSG is nil, return an alist of (MESSAGE-ID . SIZE) pairs. 712 "If MSG is nil, return an alist of (MESSAGE-ID . SIZE) pairs.
713Otherwise, return the size of the message-id MSG" 713Otherwise, return the size of the message-id MSG."
714 (pop3-send-command process (if msg 714 (pop3-send-command process (if msg
715 (format "LIST %d" msg) 715 (format "LIST %d" msg)
716 "LIST")) 716 "LIST"))
diff --git a/lisp/net/soap-client.el b/lisp/net/soap-client.el
index 7ce7d79c742..3f9eb5cb894 100644
--- a/lisp/net/soap-client.el
+++ b/lisp/net/soap-client.el
@@ -334,7 +334,7 @@ element name."
334 "Store ELEMENT in NS. 334 "Store ELEMENT in NS.
335Multiple elements with the same name can be stored in a 335Multiple elements with the same name can be stored in a
336namespace. When retrieving the element you can specify a 336namespace. When retrieving the element you can specify a
337discriminant predicate to `soap-namespace-get'" 337discriminant predicate to `soap-namespace-get'."
338 (let ((name (soap-element-name element))) 338 (let ((name (soap-element-name element)))
339 (push element (gethash name (soap-namespace-elements ns))))) 339 (push element (gethash name (soap-namespace-elements ns)))))
340 340
@@ -1476,7 +1476,7 @@ This is a specialization of `soap-decode-type' for
1476 1476
1477(defun soap-xs-parse-sequence (node) 1477(defun soap-xs-parse-sequence (node)
1478 "Parse a sequence definition from XML NODE. 1478 "Parse a sequence definition from XML NODE.
1479Returns a `soap-xs-complex-type'" 1479Returns a `soap-xs-complex-type'."
1480 (cl-assert (memq (soap-l2wk (xml-node-name node)) 1480 (cl-assert (memq (soap-l2wk (xml-node-name node))
1481 '(xsd:sequence xsd:choice xsd:all)) 1481 '(xsd:sequence xsd:choice xsd:all))
1482 nil 1482 nil
@@ -2814,7 +2814,7 @@ decode function to perform the actual decoding."
2814(defun soap-parse-envelope (node operation wsdl) 2814(defun soap-parse-envelope (node operation wsdl)
2815 "Parse the SOAP envelope in NODE and return the response. 2815 "Parse the SOAP envelope in NODE and return the response.
2816OPERATION is the WSDL operation for which we expect the response, 2816OPERATION is the WSDL operation for which we expect the response,
2817WSDL is used to decode the NODE" 2817WSDL is used to decode the NODE."
2818 (soap-with-local-xmlns node 2818 (soap-with-local-xmlns node
2819 (cl-assert (eq (soap-l2wk (xml-node-name node)) 'soap:Envelope) 2819 (cl-assert (eq (soap-l2wk (xml-node-name node)) 'soap:Envelope)
2820 nil 2820 nil
diff --git a/lisp/net/soap-inspect.el b/lisp/net/soap-inspect.el
index 17b667504fd..63c5ac53c26 100644
--- a/lisp/net/soap-inspect.el
+++ b/lisp/net/soap-inspect.el
@@ -355,7 +355,7 @@ ATTRIBUTE is a soap-xs-attribute-group."
355 355
356(defun soap-inspect-xs-complex-type (type) 356(defun soap-inspect-xs-complex-type (type)
357 "Insert information about TYPE in the current buffer. 357 "Insert information about TYPE in the current buffer.
358TYPE is a `soap-xs-complex-type'" 358TYPE is a `soap-xs-complex-type'."
359 (insert "Complex type: " (soap-element-fq-name type)) 359 (insert "Complex type: " (soap-element-fq-name type))
360 (insert "\nKind: ") 360 (insert "\nKind: ")
361 (cl-case (soap-xs-complex-type-indicator type) 361 (cl-case (soap-xs-complex-type-indicator type)
diff --git a/lisp/nxml/rng-xsd.el b/lisp/nxml/rng-xsd.el
index 582d08e149f..5aa850f5895 100644
--- a/lisp/nxml/rng-xsd.el
+++ b/lisp/nxml/rng-xsd.el
@@ -550,7 +550,7 @@ fractional part of the second."
550 (< (car numbers1) (car numbers2)))) 550 (< (car numbers1) (car numbers2))))
551 551
552(defun rng-xsd-date-to-days (year month day) 552(defun rng-xsd-date-to-days (year month day)
553 "Return a unique day number where Jan 1 1 AD is day 1" 553 "Return a unique day number where Jan 1 1 AD is day 1."
554 (if (> year 0) ; AD 554 (if (> year 0) ; AD
555 (+ (rng-xsd-days-in-years (- year 1)) 555 (+ (rng-xsd-days-in-years (- year 1))
556 (rng-xsd-day-number-in-year year month day)) 556 (rng-xsd-day-number-in-year year month day))
diff --git a/lisp/org/ob-C.el b/lisp/org/ob-C.el
index 36d79986dc4..e08773bc977 100644
--- a/lisp/org/ob-C.el
+++ b/lisp/org/ob-C.el
@@ -299,12 +299,12 @@ its header arguments."
299 299
300(defun org-babel-prep-session:C (_session _params) 300(defun org-babel-prep-session:C (_session _params)
301 "This function does nothing as C is a compiled language with no 301 "This function does nothing as C is a compiled language with no
302support for sessions" 302support for sessions."
303 (error "C is a compiled language -- no support for sessions")) 303 (error "C is a compiled language -- no support for sessions"))
304 304
305(defun org-babel-load-session:C (_session _body _params) 305(defun org-babel-load-session:C (_session _body _params)
306 "This function does nothing as C is a compiled language with no 306 "This function does nothing as C is a compiled language with no
307support for sessions" 307support for sessions."
308 (error "C is a compiled language -- no support for sessions")) 308 (error "C is a compiled language -- no support for sessions"))
309 309
310;; helper functions 310;; helper functions
diff --git a/lisp/org/ob-J.el b/lisp/org/ob-J.el
index b9125df0843..2d1715ac87a 100644
--- a/lisp/org/ob-J.el
+++ b/lisp/org/ob-J.el
@@ -72,7 +72,7 @@ PROCESSED-PARAMS isn't used yet."
72(defun org-babel-execute:J (body params) 72(defun org-babel-execute:J (body params)
73 "Execute a block of J code BODY. 73 "Execute a block of J code BODY.
74PARAMS are given by org-babel. 74PARAMS are given by org-babel.
75This function is called by `org-babel-execute-src-block'" 75This function is called by `org-babel-execute-src-block'."
76 (message "executing J source code block") 76 (message "executing J source code block")
77 (let* ((processed-params (org-babel-process-params params)) 77 (let* ((processed-params (org-babel-process-params params))
78 (sessionp (cdr (assq :session params))) 78 (sessionp (cdr (assq :session params)))
diff --git a/lisp/org/ob-asymptote.el b/lisp/org/ob-asymptote.el
index 667d3e106bc..3fc0cebd600 100644
--- a/lisp/org/ob-asymptote.el
+++ b/lisp/org/ob-asymptote.el
@@ -77,7 +77,7 @@ This function is called by `org-babel-execute-src-block'."
77 77
78(defun org-babel-prep-session:asymptote (_session _params) 78(defun org-babel-prep-session:asymptote (_session _params)
79 "Return an error if the :session header argument is set. 79 "Return an error if the :session header argument is set.
80Asymptote does not support sessions" 80Asymptote does not support sessions."
81 (error "Asymptote does not support sessions")) 81 (error "Asymptote does not support sessions"))
82 82
83(defun org-babel-variable-assignments:asymptote (params) 83(defun org-babel-variable-assignments:asymptote (params)
diff --git a/lisp/org/ob-awk.el b/lisp/org/ob-awk.el
index 4c0dbbc67d8..0d5f47d56f3 100644
--- a/lisp/org/ob-awk.el
+++ b/lisp/org/ob-awk.el
@@ -48,8 +48,8 @@
48 body) 48 body)
49 49
50(defun org-babel-execute:awk (body params) 50(defun org-babel-execute:awk (body params)
51 "Execute a block of Awk code with org-babel. This function is 51 "Execute a block of Awk code with org-babel.
52called by `org-babel-execute-src-block'" 52This function is called by `org-babel-execute-src-block'."
53 (message "executing Awk source code block") 53 (message "executing Awk source code block")
54 (let* ((result-params (cdr (assq :result-params params))) 54 (let* ((result-params (cdr (assq :result-params params)))
55 (cmd-line (cdr (assq :cmd-line params))) 55 (cmd-line (cdr (assq :cmd-line params)))
diff --git a/lisp/org/ob-core.el b/lisp/org/ob-core.el
index b6c54a92ab6..8e9e3edb1c8 100644
--- a/lisp/org/ob-core.el
+++ b/lisp/org/ob-core.el
@@ -2975,7 +2975,7 @@ If NAME specifies a remote location, the remote portion of the
2975name is removed, since in that case the process will be executing 2975name is removed, since in that case the process will be executing
2976remotely. The file name is then processed by `expand-file-name'. 2976remotely. The file name is then processed by `expand-file-name'.
2977Unless second argument NO-QUOTE-P is non-nil, the file name is 2977Unless second argument NO-QUOTE-P is non-nil, the file name is
2978additionally processed by `shell-quote-argument'" 2978additionally processed by `shell-quote-argument'."
2979 (let ((f (org-babel-local-file-name (expand-file-name name)))) 2979 (let ((f (org-babel-local-file-name (expand-file-name name))))
2980 (if no-quote-p f (shell-quote-argument f)))) 2980 (if no-quote-p f (shell-quote-argument f))))
2981 2981
diff --git a/lisp/org/ob-ebnf.el b/lisp/org/ob-ebnf.el
index 5ed9319e56f..c229228520c 100644
--- a/lisp/org/ob-ebnf.el
+++ b/lisp/org/ob-ebnf.el
@@ -49,8 +49,8 @@
49;; Use ebnf-eps-buffer to produce an encapsulated postscript file. 49;; Use ebnf-eps-buffer to produce an encapsulated postscript file.
50;; 50;;
51(defun org-babel-execute:ebnf (body params) 51(defun org-babel-execute:ebnf (body params)
52 "Execute a block of Ebnf code with org-babel. This function is 52 "Execute a block of Ebnf code with org-babel.
53called by `org-babel-execute-src-block'" 53This function is called by `org-babel-execute-src-block'."
54 (save-excursion 54 (save-excursion
55 (let* ((dest-file (cdr (assq :file params))) 55 (let* ((dest-file (cdr (assq :file params)))
56 (dest-dir (file-name-directory dest-file)) 56 (dest-dir (file-name-directory dest-file))
diff --git a/lisp/org/ob-forth.el b/lisp/org/ob-forth.el
index 88ed964fd77..de42042a5b5 100644
--- a/lisp/org/ob-forth.el
+++ b/lisp/org/ob-forth.el
@@ -42,7 +42,7 @@
42 42
43(defun org-babel-execute:forth (body params) 43(defun org-babel-execute:forth (body params)
44 "Execute a block of Forth code with org-babel. 44 "Execute a block of Forth code with org-babel.
45This function is called by `org-babel-execute-src-block'" 45This function is called by `org-babel-execute-src-block'."
46 (if (string= "none" (cdr (assq :session params))) 46 (if (string= "none" (cdr (assq :session params)))
47 (error "Non-session evaluation not supported for Forth code blocks") 47 (error "Non-session evaluation not supported for Forth code blocks")
48 (let ((all-results (org-babel-forth-session-execute body params))) 48 (let ((all-results (org-babel-forth-session-execute body params)))
diff --git a/lisp/org/ob-fortran.el b/lisp/org/ob-fortran.el
index 579fb319c41..976c611bde4 100644
--- a/lisp/org/ob-fortran.el
+++ b/lisp/org/ob-fortran.el
@@ -46,7 +46,7 @@
46 executable.") 46 executable.")
47 47
48(defun org-babel-execute:fortran (body params) 48(defun org-babel-execute:fortran (body params)
49 "This function should only be called by `org-babel-execute:fortran'" 49 "This function should only be called by `org-babel-execute:fortran'."
50 (let* ((tmp-src-file (org-babel-temp-file "fortran-src-" ".F90")) 50 (let* ((tmp-src-file (org-babel-temp-file "fortran-src-" ".F90"))
51 (tmp-bin-file (org-babel-temp-file "fortran-bin-" org-babel-exeext)) 51 (tmp-bin-file (org-babel-temp-file "fortran-bin-" org-babel-exeext))
52 (cmdline (cdr (assq :cmdline params))) 52 (cmdline (cdr (assq :cmdline params)))
@@ -115,12 +115,12 @@ its header arguments."
115 115
116(defun org-babel-prep-session:fortran (_session _params) 116(defun org-babel-prep-session:fortran (_session _params)
117 "This function does nothing as fortran is a compiled language with no 117 "This function does nothing as fortran is a compiled language with no
118support for sessions" 118support for sessions."
119 (error "Fortran is a compiled languages -- no support for sessions")) 119 (error "Fortran is a compiled languages -- no support for sessions"))
120 120
121(defun org-babel-load-session:fortran (_session _body _params) 121(defun org-babel-load-session:fortran (_session _body _params)
122 "This function does nothing as fortran is a compiled language with no 122 "This function does nothing as fortran is a compiled language with no
123support for sessions" 123support for sessions."
124 (error "Fortran is a compiled languages -- no support for sessions")) 124 (error "Fortran is a compiled languages -- no support for sessions"))
125 125
126;; helper functions 126;; helper functions
diff --git a/lisp/org/ob-groovy.el b/lisp/org/ob-groovy.el
index fe3a072f171..a22e21df097 100644
--- a/lisp/org/ob-groovy.el
+++ b/lisp/org/ob-groovy.el
@@ -45,8 +45,8 @@ parameters may be used, like groovy -v"
45 :type 'string) 45 :type 'string)
46 46
47(defun org-babel-execute:groovy (body params) 47(defun org-babel-execute:groovy (body params)
48 "Execute a block of Groovy code with org-babel. This function is 48 "Execute a block of Groovy code with org-babel.
49called by `org-babel-execute-src-block'" 49This function is called by `org-babel-execute-src-block'."
50 (message "executing Groovy source code block") 50 (message "executing Groovy source code block")
51 (let* ((processed-params (org-babel-process-params params)) 51 (let* ((processed-params (org-babel-process-params params))
52 (session (org-babel-groovy-initiate-session (nth 0 processed-params))) 52 (session (org-babel-groovy-initiate-session (nth 0 processed-params)))
diff --git a/lisp/org/ob-io.el b/lisp/org/ob-io.el
index b0d5b512839..9817c64150b 100644
--- a/lisp/org/ob-io.el
+++ b/lisp/org/ob-io.el
@@ -41,8 +41,8 @@
41 "Name of the command to use for executing Io code.") 41 "Name of the command to use for executing Io code.")
42 42
43(defun org-babel-execute:io (body params) 43(defun org-babel-execute:io (body params)
44 "Execute a block of Io code with org-babel. This function is 44 "Execute a block of Io code with org-babel.
45called by `org-babel-execute-src-block'" 45This function is called by `org-babel-execute-src-block'."
46 (message "executing Io source code block") 46 (message "executing Io source code block")
47 (let* ((processed-params (org-babel-process-params params)) 47 (let* ((processed-params (org-babel-process-params params))
48 (session (org-babel-io-initiate-session (nth 0 processed-params))) 48 (session (org-babel-io-initiate-session (nth 0 processed-params)))
diff --git a/lisp/org/ob-js.el b/lisp/org/ob-js.el
index 233aa581617..dab3aa2fbda 100644
--- a/lisp/org/ob-js.el
+++ b/lisp/org/ob-js.el
@@ -60,7 +60,7 @@
60 60
61(defun org-babel-execute:js (body params) 61(defun org-babel-execute:js (body params)
62 "Execute a block of Javascript code with org-babel. 62 "Execute a block of Javascript code with org-babel.
63This function is called by `org-babel-execute-src-block'" 63This function is called by `org-babel-execute-src-block'."
64 (let* ((org-babel-js-cmd (or (cdr (assq :cmd params)) org-babel-js-cmd)) 64 (let* ((org-babel-js-cmd (or (cdr (assq :cmd params)) org-babel-js-cmd))
65 (result-type (cdr (assq :result-type params))) 65 (result-type (cdr (assq :result-type params)))
66 (full-body (org-babel-expand-body:generic 66 (full-body (org-babel-expand-body:generic
diff --git a/lisp/org/ob-lilypond.el b/lisp/org/ob-lilypond.el
index 25e5dbc7dc4..c07ae784600 100644
--- a/lisp/org/ob-lilypond.el
+++ b/lisp/org/ob-lilypond.el
@@ -41,20 +41,20 @@
41(defvar org-babel-default-header-args:lilypond '() 41(defvar org-babel-default-header-args:lilypond '()
42 "Default header arguments for lilypond code blocks. 42 "Default header arguments for lilypond code blocks.
43NOTE: The arguments are determined at lilypond compile time. 43NOTE: The arguments are determined at lilypond compile time.
44See (org-babel-lilypond-set-header-args)") 44See `org-babel-lilypond-set-header-args'.")
45 45
46(defvar org-babel-lilypond-compile-post-tangle t 46(defvar org-babel-lilypond-compile-post-tangle t
47 "Following the org-babel-tangle (C-c C-v t) command, 47 "Following the org-babel-tangle (C-c C-v t) command,
48org-babel-lilypond-compile-post-tangle determines whether ob-lilypond should 48org-babel-lilypond-compile-post-tangle determines whether ob-lilypond should
49automatically attempt to compile the resultant tangled file. 49automatically attempt to compile the resultant tangled file.
50If the value is nil, no automated compilation takes place. 50If the value is nil, no automated compilation takes place.
51Default value is t") 51Default value is t.")
52 52
53(defvar org-babel-lilypond-display-pdf-post-tangle t 53(defvar org-babel-lilypond-display-pdf-post-tangle t
54 "Following a successful LilyPond compilation 54 "Following a successful LilyPond compilation
55org-babel-lilypond-display-pdf-post-tangle determines whether to automate the 55org-babel-lilypond-display-pdf-post-tangle determines whether to automate the
56drawing / redrawing of the resultant pdf. If the value is nil, 56drawing / redrawing of the resultant pdf. If the value is nil,
57the pdf is not automatically redrawn. Default value is t") 57the pdf is not automatically redrawn. Default value is t.")
58 58
59(defvar org-babel-lilypond-play-midi-post-tangle t 59(defvar org-babel-lilypond-play-midi-post-tangle t
60 "Following a successful LilyPond compilation 60 "Following a successful LilyPond compilation
@@ -150,7 +150,7 @@ Depending on whether we are in arrange mode either:
150(defun org-babel-lilypond-tangle () 150(defun org-babel-lilypond-tangle ()
151 "ob-lilypond specific tangle, attempts to invoke 151 "ob-lilypond specific tangle, attempts to invoke
152=ly-execute-tangled-ly= if tangle is successful. Also passes 152=ly-execute-tangled-ly= if tangle is successful. Also passes
153specific arguments to =org-babel-tangle=" 153specific arguments to =org-babel-tangle=."
154 (interactive) 154 (interactive)
155 (if (org-babel-tangle nil "yes" "lilypond") 155 (if (org-babel-tangle nil "yes" "lilypond")
156 (org-babel-lilypond-execute-tangled-ly) nil)) 156 (org-babel-lilypond-execute-tangled-ly) nil))
@@ -187,7 +187,7 @@ specific arguments to =org-babel-tangle="
187 187
188(defun org-babel-lilypond-execute-tangled-ly () 188(defun org-babel-lilypond-execute-tangled-ly ()
189 "Compile result of block tangle with lilypond. 189 "Compile result of block tangle with lilypond.
190If error in compilation, attempt to mark the error in lilypond org file" 190If error in compilation, attempt to mark the error in lilypond org file."
191 (when org-babel-lilypond-compile-post-tangle 191 (when org-babel-lilypond-compile-post-tangle
192 (let ((org-babel-lilypond-tangled-file (org-babel-lilypond-switch-extension 192 (let ((org-babel-lilypond-tangled-file (org-babel-lilypond-switch-extension
193 (buffer-file-name) ".lilypond")) 193 (buffer-file-name) ".lilypond"))
@@ -210,8 +210,8 @@ If error in compilation, attempt to mark the error in lilypond org file"
210 (org-babel-lilypond-attempt-to-play-midi org-babel-lilypond-temp-file))))) 210 (org-babel-lilypond-attempt-to-play-midi org-babel-lilypond-temp-file)))))
211 211
212(defun org-babel-lilypond-compile-lilyfile (file-name &optional test) 212(defun org-babel-lilypond-compile-lilyfile (file-name &optional test)
213 "Compile lilypond file and check for compile errors 213 "Compile lilypond file and check for compile errors.
214FILE-NAME is full path to lilypond (.ly) file" 214FILE-NAME is full path to lilypond (.ly) file."
215 (message "Compiling LilyPond...") 215 (message "Compiling LilyPond...")
216 (let ((arg-1 org-babel-lilypond-ly-command) ;program 216 (let ((arg-1 org-babel-lilypond-ly-command) ;program
217 (arg-2 nil) ;infile 217 (arg-2 nil) ;infile
@@ -237,7 +237,7 @@ This is performed by parsing the *lilypond* buffer
237containing the output message from the compilation. 237containing the output message from the compilation.
238FILE-NAME is full path to lilypond file. 238FILE-NAME is full path to lilypond file.
239If TEST is t just return nil if no error found, and pass 239If TEST is t just return nil if no error found, and pass
240nil as file-name since it is unused in this context" 240nil as file-name since it is unused in this context."
241 (let ((is-error (search-forward "error:" nil t))) 241 (let ((is-error (search-forward "error:" nil t)))
242 (if test 242 (if test
243 is-error 243 is-error
@@ -246,7 +246,7 @@ nil as file-name since it is unused in this context"
246 246
247(defun org-babel-lilypond-process-compile-error (file-name) 247(defun org-babel-lilypond-process-compile-error (file-name)
248 "Process the compilation error that has occurred. 248 "Process the compilation error that has occurred.
249FILE-NAME is full path to lilypond file" 249FILE-NAME is full path to lilypond file."
250 (let ((line-num (org-babel-lilypond-parse-line-num))) 250 (let ((line-num (org-babel-lilypond-parse-line-num)))
251 (let ((error-lines (org-babel-lilypond-parse-error-line file-name line-num))) 251 (let ((error-lines (org-babel-lilypond-parse-error-line file-name line-num)))
252 (org-babel-lilypond-mark-error-line file-name error-lines) 252 (org-babel-lilypond-mark-error-line file-name error-lines)
@@ -255,7 +255,7 @@ FILE-NAME is full path to lilypond file"
255(defun org-babel-lilypond-mark-error-line (file-name line) 255(defun org-babel-lilypond-mark-error-line (file-name line)
256 "Mark the erroneous lines in the lilypond org buffer. 256 "Mark the erroneous lines in the lilypond org buffer.
257FILE-NAME is full path to lilypond file. 257FILE-NAME is full path to lilypond file.
258LINE is the erroneous line" 258LINE is the erroneous line."
259 (switch-to-buffer-other-window 259 (switch-to-buffer-other-window
260 (concat (file-name-nondirectory 260 (concat (file-name-nondirectory
261 (org-babel-lilypond-switch-extension file-name ".org")))) 261 (org-babel-lilypond-switch-extension file-name ".org"))))
@@ -286,9 +286,9 @@ LINE is the erroneous line"
286 (and (numberp num) num))))) 286 (and (numberp num) num)))))
287 287
288(defun org-babel-lilypond-parse-error-line (file-name lineNo) 288(defun org-babel-lilypond-parse-error-line (file-name lineNo)
289 "Extract the erroneous line from the tangled .ly file 289 "Extract the erroneous line from the tangled .ly file.
290FILE-NAME is full path to lilypond file. 290FILE-NAME is full path to lilypond file.
291LINENO is the number of the erroneous line" 291LINENO is the number of the erroneous line."
292 (with-temp-buffer 292 (with-temp-buffer
293 (insert-file-contents (org-babel-lilypond-switch-extension file-name ".ly") 293 (insert-file-contents (org-babel-lilypond-switch-extension file-name ".ly")
294 nil nil nil t) 294 nil nil nil t)
@@ -300,9 +300,9 @@ LINENO is the number of the erroneous line"
300 nil))) 300 nil)))
301 301
302(defun org-babel-lilypond-attempt-to-open-pdf (file-name &optional test) 302(defun org-babel-lilypond-attempt-to-open-pdf (file-name &optional test)
303 "Attempt to display the generated pdf file 303 "Attempt to display the generated pdf file.
304FILE-NAME is full path to lilypond file 304FILE-NAME is full path to lilypond file.
305If TEST is non-nil, the shell command is returned and is not run" 305If TEST is non-nil, the shell command is returned and is not run."
306 (when org-babel-lilypond-display-pdf-post-tangle 306 (when org-babel-lilypond-display-pdf-post-tangle
307 (let ((pdf-file (org-babel-lilypond-switch-extension file-name ".pdf"))) 307 (let ((pdf-file (org-babel-lilypond-switch-extension file-name ".pdf")))
308 (if (file-exists-p pdf-file) 308 (if (file-exists-p pdf-file)
@@ -318,9 +318,9 @@ If TEST is non-nil, the shell command is returned and is not run"
318 (message "No pdf file generated so can't display!"))))) 318 (message "No pdf file generated so can't display!")))))
319 319
320(defun org-babel-lilypond-attempt-to-play-midi (file-name &optional test) 320(defun org-babel-lilypond-attempt-to-play-midi (file-name &optional test)
321 "Attempt to play the generated MIDI file 321 "Attempt to play the generated MIDI file.
322FILE-NAME is full path to lilypond file 322FILE-NAME is full path to lilypond file.
323If TEST is non-nil, the shell command is returned and is not run" 323If TEST is non-nil, the shell command is returned and is not run."
324 (when org-babel-lilypond-play-midi-post-tangle 324 (when org-babel-lilypond-play-midi-post-tangle
325 (let ((midi-file (org-babel-lilypond-switch-extension file-name ".midi"))) 325 (let ((midi-file (org-babel-lilypond-switch-extension file-name ".midi")))
326 (if (file-exists-p midi-file) 326 (if (file-exists-p midi-file)
@@ -383,14 +383,13 @@ If TEST is non-nil, the shell command is returned and is not run"
383 (if org-babel-lilypond-arrange-mode "ENABLED." "DISABLED.")))) 383 (if org-babel-lilypond-arrange-mode "ENABLED." "DISABLED."))))
384 384
385(defun org-babel-lilypond-switch-extension (file-name ext) 385(defun org-babel-lilypond-switch-extension (file-name ext)
386 "Utility command to swap current FILE-NAME extension with EXT" 386 "Utility command to swap current FILE-NAME extension with EXT."
387 (concat (file-name-sans-extension 387 (concat (file-name-sans-extension
388 file-name) ext)) 388 file-name) ext))
389 389
390(defun org-babel-lilypond-get-header-args (mode) 390(defun org-babel-lilypond-get-header-args (mode)
391 "Default arguments to use when evaluating a lilypond 391 "Default arguments to use when evaluating a lilypond source block.
392source block. These depend upon whether we are in arrange 392These depend upon whether we are in Arrange mode i.e. MODE is t."
393mode i.e. ARRANGE-MODE is t"
394 (cond (mode 393 (cond (mode
395 '((:tangle . "yes") 394 '((:tangle . "yes")
396 (:noweb . "yes") 395 (:noweb . "yes")
@@ -403,7 +402,7 @@ mode i.e. ARRANGE-MODE is t"
403 402
404(defun org-babel-lilypond-set-header-args (mode) 403(defun org-babel-lilypond-set-header-args (mode)
405 "Set org-babel-default-header-args:lilypond 404 "Set org-babel-default-header-args:lilypond
406dependent on ORG-BABEL-LILYPOND-ARRANGE-MODE" 405dependent on ORG-BABEL-LILYPOND-ARRANGE-MODE."
407 (setq org-babel-default-header-args:lilypond 406 (setq org-babel-default-header-args:lilypond
408 (org-babel-lilypond-get-header-args mode))) 407 (org-babel-lilypond-get-header-args mode)))
409 408
diff --git a/lisp/org/ob-lua.el b/lisp/org/ob-lua.el
index 6f779413eb6..9b152f29f4e 100644
--- a/lisp/org/ob-lua.el
+++ b/lisp/org/ob-lua.el
@@ -101,7 +101,7 @@ This function is called by `org-babel-execute-src-block'."
101 101
102(defun org-babel-prep-session:lua (session params) 102(defun org-babel-prep-session:lua (session params)
103 "Prepare SESSION according to the header arguments in PARAMS. 103 "Prepare SESSION according to the header arguments in PARAMS.
104VARS contains resolved variable references" 104VARS contains resolved variable references."
105 (let* ((session (org-babel-lua-initiate-session session)) 105 (let* ((session (org-babel-lua-initiate-session session))
106 (var-lines 106 (var-lines
107 (org-babel-variable-assignments:lua params))) 107 (org-babel-variable-assignments:lua params)))
diff --git a/lisp/org/ob-picolisp.el b/lisp/org/ob-picolisp.el
index c0f012572ee..4f702529866 100644
--- a/lisp/org/ob-picolisp.el
+++ b/lisp/org/ob-picolisp.el
@@ -94,8 +94,8 @@
94 body))) 94 body)))
95 95
96(defun org-babel-execute:picolisp (body params) 96(defun org-babel-execute:picolisp (body params)
97 "Execute a block of Picolisp code with org-babel. This function is 97 "Execute a block of Picolisp code with org-babel.
98 called by `org-babel-execute-src-block'" 98This function is called by `org-babel-execute-src-block'."
99 (message "executing Picolisp source code block") 99 (message "executing Picolisp source code block")
100 (let* ( 100 (let* (
101 ;; Name of the session or "none". 101 ;; Name of the session or "none".
diff --git a/lisp/org/ob-processing.el b/lisp/org/ob-processing.el
index 97ab88cbef6..7bb9fa1bc94 100644
--- a/lisp/org/ob-processing.el
+++ b/lisp/org/ob-processing.el
@@ -135,7 +135,7 @@ This function is called by `org-babel-execute-src-block'."
135 135
136(defun org-babel-prep-session:processing (_session _params) 136(defun org-babel-prep-session:processing (_session _params)
137 "Return an error if the :session header argument is set. 137 "Return an error if the :session header argument is set.
138Processing does not support sessions" 138Processing does not support sessions."
139 (error "Processing does not support sessions")) 139 (error "Processing does not support sessions"))
140 140
141(defun org-babel-variable-assignments:processing (params) 141(defun org-babel-variable-assignments:processing (params)
diff --git a/lisp/org/ob-python.el b/lisp/org/ob-python.el
index 546e35a6a9b..b10320ee532 100644
--- a/lisp/org/ob-python.el
+++ b/lisp/org/ob-python.el
@@ -98,7 +98,7 @@ This function is called by `org-babel-execute-src-block'."
98 98
99(defun org-babel-prep-session:python (session params) 99(defun org-babel-prep-session:python (session params)
100 "Prepare SESSION according to the header arguments in PARAMS. 100 "Prepare SESSION according to the header arguments in PARAMS.
101VARS contains resolved variable references" 101VARS contains resolved variable references."
102 (let* ((session (org-babel-python-initiate-session session)) 102 (let* ((session (org-babel-python-initiate-session session))
103 (var-lines 103 (var-lines
104 (org-babel-variable-assignments:python params))) 104 (org-babel-variable-assignments:python params)))
diff --git a/lisp/org/ob-ruby.el b/lisp/org/ob-ruby.el
index e0e1765f881..309bd15a00a 100644
--- a/lisp/org/ob-ruby.el
+++ b/lisp/org/ob-ruby.el
@@ -215,7 +215,7 @@ return the value of the last statement in BODY, as elisp."
215 (let ((eoe-string (format "puts \"%s\"" org-babel-ruby-eoe-indicator))) 215 (let ((eoe-string (format "puts \"%s\"" org-babel-ruby-eoe-indicator)))
216 ;; Force the session to be ready before the actual session 216 ;; Force the session to be ready before the actual session
217 ;; code is run. There is some problem in comint that will 217 ;; code is run. There is some problem in comint that will
218 ;; sometimes show the prompt after the the input has already 218 ;; sometimes show the prompt after the input has already
219 ;; been inserted and that throws off the extraction of the 219 ;; been inserted and that throws off the extraction of the
220 ;; result for Babel. 220 ;; result for Babel.
221 (org-babel-comint-with-output 221 (org-babel-comint-with-output
diff --git a/lisp/org/ob-scheme.el b/lisp/org/ob-scheme.el
index 798cf4eb0c3..af5c7f26d6f 100644
--- a/lisp/org/ob-scheme.el
+++ b/lisp/org/ob-scheme.el
@@ -132,7 +132,7 @@ org-babel-scheme-execute-with-geiser will use a temporary session."
132 (name))) 132 (name)))
133 133
134(defmacro org-babel-scheme-capture-current-message (&rest body) 134(defmacro org-babel-scheme-capture-current-message (&rest body)
135 "Capture current message in both interactive and noninteractive mode" 135 "Capture current message in both interactive and noninteractive mode."
136 `(if noninteractive 136 `(if noninteractive
137 (let ((original-message (symbol-function 'message)) 137 (let ((original-message (symbol-function 'message))
138 (current-message nil)) 138 (current-message nil))
@@ -148,10 +148,11 @@ org-babel-scheme-execute-with-geiser will use a temporary session."
148 (current-message)))) 148 (current-message))))
149 149
150(defun org-babel-scheme-execute-with-geiser (code output impl repl) 150(defun org-babel-scheme-execute-with-geiser (code output impl repl)
151 "Execute code in specified REPL. If the REPL doesn't exist, create it 151 "Execute code in specified REPL.
152using the given scheme implementation. 152If the REPL doesn't exist, create it using the given scheme
153implementation.
153 154
154Returns the output of executing the code if the output parameter 155Returns the output of executing the code if the OUTPUT parameter
155is true; otherwise returns the last value." 156is true; otherwise returns the last value."
156 (let ((result nil)) 157 (let ((result nil))
157 (with-temp-buffer 158 (with-temp-buffer
@@ -199,7 +200,7 @@ Emacs-lisp table, otherwise return the results as a string."
199 200
200(defun org-babel-execute:scheme (body params) 201(defun org-babel-execute:scheme (body params)
201 "Execute a block of Scheme code with org-babel. 202 "Execute a block of Scheme code with org-babel.
202This function is called by `org-babel-execute-src-block'" 203This function is called by `org-babel-execute-src-block'."
203 (let* ((source-buffer (current-buffer)) 204 (let* ((source-buffer (current-buffer))
204 (source-buffer-name (replace-regexp-in-string ;; zap surrounding * 205 (source-buffer-name (replace-regexp-in-string ;; zap surrounding *
205 "^ ?\\*\\([^*]+\\)\\*" "\\1" 206 "^ ?\\*\\([^*]+\\)\\*" "\\1"
diff --git a/lisp/org/ob-shen.el b/lisp/org/ob-shen.el
index af3bd2ba388..f2daa67606f 100644
--- a/lisp/org/ob-shen.el
+++ b/lisp/org/ob-shen.el
@@ -61,7 +61,7 @@
61 61
62(defun org-babel-execute:shen (body params) 62(defun org-babel-execute:shen (body params)
63 "Execute a block of Shen code with org-babel. 63 "Execute a block of Shen code with org-babel.
64This function is called by `org-babel-execute-src-block'" 64This function is called by `org-babel-execute-src-block'."
65 (require 'inf-shen) 65 (require 'inf-shen)
66 (let* ((result-params (cdr (assq :result-params params))) 66 (let* ((result-params (cdr (assq :result-params params)))
67 (full-body (org-babel-expand-body:shen body params))) 67 (full-body (org-babel-expand-body:shen body params)))
diff --git a/lisp/org/org-agenda.el b/lisp/org/org-agenda.el
index e50ec3cf08f..66c3d965e09 100644
--- a/lisp/org/org-agenda.el
+++ b/lisp/org/org-agenda.el
@@ -267,7 +267,7 @@ you can \"misuse\" it to also add other text to the header."
267 "List of types searched for when creating the daily/weekly agenda. 267 "List of types searched for when creating the daily/weekly agenda.
268This variable is a list of symbols that controls the types of 268This variable is a list of symbols that controls the types of
269items that appear in the daily/weekly agenda. Allowed symbols in this 269items that appear in the daily/weekly agenda. Allowed symbols in this
270list are are 270list are
271 271
272 :timestamp List items containing a date stamp or date range matching 272 :timestamp List items containing a date stamp or date range matching
273 the selected date. This includes sexp entries in angular 273 the selected date. This includes sexp entries in angular
@@ -1225,9 +1225,9 @@ These days get the special face `org-agenda-date-weekend' in the agenda."
1225 1225
1226(defcustom org-agenda-move-date-from-past-immediately-to-today t 1226(defcustom org-agenda-move-date-from-past-immediately-to-today t
1227 "Non-nil means jump to today when moving a past date forward in time. 1227 "Non-nil means jump to today when moving a past date forward in time.
1228When using S-right in the agenda to move a a date forward, and the date 1228When using S-right in the agenda to move a date forward, and the date
1229stamp currently points to the past, the first key press will move it 1229stamp currently points to the past, the first key press will move it
1230to today. WHen nil, just move one day forward even if the date stays 1230to today. When nil, just move one day forward even if the date stays
1231in the past." 1231in the past."
1232 :group 'org-agenda-daily/weekly 1232 :group 'org-agenda-daily/weekly
1233 :version "24.1" 1233 :version "24.1"
@@ -1498,7 +1498,7 @@ The third item is a string which will be placed right after the
1498times that have a grid line. 1498times that have a grid line.
1499 1499
1500The fourth item is a string placed after the grid times. This 1500The fourth item is a string placed after the grid times. This
1501will align with agenda items" 1501will align with agenda items."
1502 :group 'org-agenda-time-grid 1502 :group 'org-agenda-time-grid
1503 :type 1503 :type
1504 '(list 1504 '(list
@@ -1542,18 +1542,18 @@ This is a list of symbols which will be used in sequence to determine
1542if an entry should be listed before another entry. The following 1542if an entry should be listed before another entry. The following
1543symbols are recognized: 1543symbols are recognized:
1544 1544
1545time-up Put entries with time-of-day indications first, early first 1545time-up Put entries with time-of-day indications first, early first.
1546time-down Put entries with time-of-day indications first, late first 1546time-down Put entries with time-of-day indications first, late first.
1547timestamp-up Sort by any timestamp, early first 1547timestamp-up Sort by any timestamp, early first.
1548timestamp-down Sort by any timestamp, late first 1548timestamp-down Sort by any timestamp, late first.
1549scheduled-up Sort by scheduled timestamp, early first 1549scheduled-up Sort by scheduled timestamp, early first.
1550scheduled-down Sort by scheduled timestamp, late first 1550scheduled-down Sort by scheduled timestamp, late first.
1551deadline-up Sort by deadline timestamp, early first 1551deadline-up Sort by deadline timestamp, early first.
1552deadline-down Sort by deadline timestamp, late first 1552deadline-down Sort by deadline timestamp, late first.
1553ts-up Sort by active timestamp, early first 1553ts-up Sort by active timestamp, early first.
1554ts-down Sort by active timestamp, late first 1554ts-down Sort by active timestamp, late first.
1555tsia-up Sort by inactive timestamp, early first 1555tsia-up Sort by inactive timestamp, early first.
1556tsia-down Sort by inactive timestamp, late first 1556tsia-down Sort by inactive timestamp, late first.
1557category-keep Keep the default order of categories, corresponding to the 1557category-keep Keep the default order of categories, corresponding to the
1558 sequence in `org-agenda-files'. 1558 sequence in `org-agenda-files'.
1559category-up Sort alphabetically by category, A-Z. 1559category-up Sort alphabetically by category, A-Z.
@@ -1568,10 +1568,10 @@ effort-up Sort numerically by estimated effort, high effort last.
1568effort-down Sort numerically by estimated effort, high effort first. 1568effort-down Sort numerically by estimated effort, high effort first.
1569user-defined-up Sort according to `org-agenda-cmp-user-defined', high last. 1569user-defined-up Sort according to `org-agenda-cmp-user-defined', high last.
1570user-defined-down Sort according to `org-agenda-cmp-user-defined', high first. 1570user-defined-down Sort according to `org-agenda-cmp-user-defined', high first.
1571habit-up Put entries that are habits first 1571habit-up Put entries that are habits first.
1572habit-down Put entries that are habits last 1572habit-down Put entries that are habits last.
1573alpha-up Sort headlines alphabetically 1573alpha-up Sort headlines alphabetically.
1574alpha-down Sort headlines alphabetically, reversed 1574alpha-down Sort headlines alphabetically, reversed.
1575 1575
1576The different possibilities will be tried in sequence, and testing stops 1576The different possibilities will be tried in sequence, and testing stops
1577if one comparison returns a \"not-equal\". For example, the default 1577if one comparison returns a \"not-equal\". For example, the default
@@ -7365,8 +7365,7 @@ With a prefix argument, do so in all agenda buffers."
7365 "Filter lines in the agenda buffer that have a specific category. 7365 "Filter lines in the agenda buffer that have a specific category.
7366The category is that of the current line. 7366The category is that of the current line.
7367Without prefix argument, keep only the lines of that category. 7367Without prefix argument, keep only the lines of that category.
7368With a prefix argument, exclude the lines of that category. 7368With a prefix argument, exclude the lines of that category."
7369"
7370 (interactive "P") 7369 (interactive "P")
7371 (if (and org-agenda-filtered-by-category 7370 (if (and org-agenda-filtered-by-category
7372 org-agenda-category-filter) 7371 org-agenda-category-filter)
@@ -7882,7 +7881,7 @@ Negative selection means regexp must not match for selection of an entry."
7882 7881
7883(defun org-agenda-forward-block (&optional backward) 7882(defun org-agenda-forward-block (&optional backward)
7884 "Move forward by one agenda block. 7883 "Move forward by one agenda block.
7885When optional argument BACKWARD is set, go backward" 7884When optional argument BACKWARD is set, go backward."
7886 (interactive) 7885 (interactive)
7887 (cond ((not (derived-mode-p 'org-agenda-mode)) 7886 (cond ((not (derived-mode-p 'org-agenda-mode))
7888 (user-error 7887 (user-error
diff --git a/lisp/org/org-colview.el b/lisp/org/org-colview.el
index 799cc608bfa..51a8eff33d7 100644
--- a/lisp/org/org-colview.el
+++ b/lisp/org/org-colview.el
@@ -307,7 +307,7 @@ integers greater than 0."
307 (error "Unknown %S operator" operator))))) 307 (error "Unknown %S operator" operator)))))
308 308
309(defun org-columns--overlay-text (value fmt width property original) 309(defun org-columns--overlay-text (value fmt width property original)
310 "Return text " 310 "Return text."
311 (format fmt 311 (format fmt
312 (let ((v (org-columns-add-ellipses value width))) 312 (let ((v (org-columns-add-ellipses value width)))
313 (pcase property 313 (pcase property
diff --git a/lisp/org/org-faces.el b/lisp/org/org-faces.el
index 7ab5736e87a..ffd1c4494fc 100644
--- a/lisp/org/org-faces.el
+++ b/lisp/org/org-faces.el
@@ -409,7 +409,7 @@ See also `org-fontify-quote-and-verse-blocks'."
409 :group 'org-faces) 409 :group 'org-faces)
410 410
411(defface org-verbatim '((t (:inherit shadow))) 411(defface org-verbatim '((t (:inherit shadow)))
412 "Face for fixed-with text like code snippets" 412 "Face for fixed-with text like code snippets."
413 :group 'org-faces 413 :group 'org-faces
414 :version "22.1") 414 :version "22.1")
415 415
@@ -602,8 +602,8 @@ If it is less than 8, the level-1 face gets re-used for level N+1 etc."
602(defcustom org-cycle-level-faces t 602(defcustom org-cycle-level-faces t
603 "Non-nil means level styles cycle after level `org-n-level-faces'. 603 "Non-nil means level styles cycle after level `org-n-level-faces'.
604Then so level org-n-level-faces+1 is styled like level 1. 604Then so level org-n-level-faces+1 is styled like level 1.
605If nil, then all levels >=org-n-level-faces are styled like 605If nil, then all levels >= org-n-level-faces are styled like
606level org-n-level-faces" 606level org-n-level-faces."
607 :group 'org-appearance 607 :group 'org-appearance
608 :group 'org-faces 608 :group 'org-faces
609 :version "24.1" 609 :version "24.1"
diff --git a/lisp/org/org-indent.el b/lisp/org/org-indent.el
index 97cf8786566..4904d8177e1 100644
--- a/lisp/org/org-indent.el
+++ b/lisp/org/org-indent.el
@@ -298,7 +298,7 @@ LEVEL is the current level of heading. INDENTATION is the
298expected indentation when wrapping line. 298expected indentation when wrapping line.
299 299
300When optional argument HEADING is non-nil, assume line is at 300When optional argument HEADING is non-nil, assume line is at
301a heading. Moreover, if is is `inlinetask', the first star will 301a heading. Moreover, if it is `inlinetask', the first star will
302have `org-warning' face." 302have `org-warning' face."
303 (let* ((line (aref (pcase heading 303 (let* ((line (aref (pcase heading
304 (`nil org-indent--text-line-prefixes) 304 (`nil org-indent--text-line-prefixes)
diff --git a/lisp/org/org-macs.el b/lisp/org/org-macs.el
index 3c768244331..bb96a06165e 100644
--- a/lisp/org/org-macs.el
+++ b/lisp/org/org-macs.el
@@ -340,7 +340,7 @@ point nowhere."
340(defvar org-inlinetask-min-level) ; defined in org-inlinetask.el 340(defvar org-inlinetask-min-level) ; defined in org-inlinetask.el
341(defun org-get-limited-outline-regexp () 341(defun org-get-limited-outline-regexp ()
342 "Return outline-regexp with limited number of levels. 342 "Return outline-regexp with limited number of levels.
343The number of levels is controlled by `org-inlinetask-min-level'" 343The number of levels is controlled by `org-inlinetask-min-level'."
344 (cond ((not (derived-mode-p 'org-mode)) 344 (cond ((not (derived-mode-p 'org-mode))
345 outline-regexp) 345 outline-regexp)
346 ((not (featurep 'org-inlinetask)) 346 ((not (featurep 'org-inlinetask))
diff --git a/lisp/org/org-mobile.el b/lisp/org/org-mobile.el
index a1552606eb5..dba6ca22f9b 100644
--- a/lisp/org/org-mobile.el
+++ b/lisp/org/org-mobile.el
@@ -55,7 +55,7 @@ org-agenda-files
55 the variable `org-agenda-files'. 55 the variable `org-agenda-files'.
56org-agenda-text-search-extra-files 56org-agenda-text-search-extra-files
57 Include the files given in the variable 57 Include the files given in the variable
58 `org-agenda-text-search-extra-files'" 58 `org-agenda-text-search-extra-files'."
59 :group 'org-mobile 59 :group 'org-mobile
60 :type '(list :greedy t 60 :type '(list :greedy t
61 (option (const :tag "org-agenda-files" org-agenda-files)) 61 (option (const :tag "org-agenda-files" org-agenda-files))
diff --git a/lisp/org/org.el b/lisp/org/org.el
index 1bb46e49c74..ca223d6ee29 100644
--- a/lisp/org/org.el
+++ b/lisp/org/org.el
@@ -2710,7 +2710,7 @@ selection scheme.
2710When nil, fast selection is never used. 2710When nil, fast selection is never used.
2711 2711
2712When the symbol `prefix', it will be used when `org-todo' is called 2712When the symbol `prefix', it will be used when `org-todo' is called
2713with a prefix argument, i.e. `\\[universal-argument] \\[org-todo]' \ 2713with a prefix argument, i.e. `\\[universal-argument] \\[org-todo]' \
2714in an Org buffer, and 2714in an Org buffer, and
2715`\\[universal-argument] t' in an agenda buffer. 2715`\\[universal-argument] t' in an agenda buffer.
2716 2716
@@ -3355,7 +3355,7 @@ When nil, only the minibuffer will be available."
3355(defcustom org-extend-today-until 0 3355(defcustom org-extend-today-until 0
3356 "The hour when your day really ends. Must be an integer. 3356 "The hour when your day really ends. Must be an integer.
3357This has influence for the following applications: 3357This has influence for the following applications:
3358- When switching the agenda to \"today\". It it is still earlier than 3358- When switching the agenda to \"today\". If it is still earlier than
3359 the time given here, the day recognized as TODAY is actually yesterday. 3359 the time given here, the day recognized as TODAY is actually yesterday.
3360- When a date is read from the user and it is still before the time given 3360- When a date is read from the user and it is still before the time given
3361 here, the current date and time will be assumed to be yesterday, 23:59. 3361 here, the current date and time will be assumed to be yesterday, 23:59.
@@ -3676,7 +3676,7 @@ and the properties ending in \"_ALL\" when they are used as descriptor
3676for valid values of a property. 3676for valid values of a property.
3677 3677
3678Note for programmers: 3678Note for programmers:
3679When querying an entry with `org-entry-get', you can control if inheritance 3679When querying an entry with `org-entry-get', you can control if inheritance
3680should be used. By default, `org-entry-get' looks only at the local 3680should be used. By default, `org-entry-get' looks only at the local
3681properties. You can request inheritance by setting the inherit argument 3681properties. You can request inheritance by setting the inherit argument
3682to t (to force inheritance) or to `selective' (to respect the setting 3682to t (to force inheritance) or to `selective' (to respect the setting
@@ -9562,7 +9562,7 @@ sub-tree if optional argument INHERIT is non-nil."
9562 'org-stats stats))))))) 9562 'org-stats stats)))))))
9563 9563
9564(defun org-refresh-effort-properties () 9564(defun org-refresh-effort-properties ()
9565 "Refresh effort properties" 9565 "Refresh effort properties."
9566 (org-refresh-properties 9566 (org-refresh-properties
9567 org-effort-property 9567 org-effort-property
9568 '((effort . identity) 9568 '((effort . identity)
@@ -10492,7 +10492,7 @@ This is saved in case the need arises to restore it.")
10492This command can be called in any mode to follow an external link 10492This command can be called in any mode to follow an external link
10493or a time-stamp that has Org mode syntax. Its behavior is 10493or a time-stamp that has Org mode syntax. Its behavior is
10494undefined when called on internal links (e.g., fuzzy links). 10494undefined when called on internal links (e.g., fuzzy links).
10495Raise an error when there is nothing to follow. " 10495Raise an error when there is nothing to follow."
10496 (interactive) 10496 (interactive)
10497 (cond ((org-in-regexp org-any-link-re) 10497 (cond ((org-in-regexp org-any-link-re)
10498 (org-open-link-from-string (match-string-no-properties 0))) 10498 (org-open-link-from-string (match-string-no-properties 0)))
@@ -12661,7 +12661,7 @@ not relevant for the behavior, but it makes things more visible.
12661Note that toggling the tag with tags commands will not change the property 12661Note that toggling the tag with tags commands will not change the property
12662and therefore not influence behavior! 12662and therefore not influence behavior!
12663 12663
12664This can be t, meaning the tag ORDERED should be used, It can also be a 12664This can be t, meaning the tag ORDERED should be used. It can also be a
12665string to select a different tag for this task." 12665string to select a different tag for this task."
12666 :group 'org-todo 12666 :group 'org-todo
12667 :type '(choice 12667 :type '(choice
@@ -20489,7 +20489,7 @@ depending on context. See the individual commands for more information."
20489Depending on context, this does one of the following: 20489Depending on context, this does one of the following:
20490 20490
20491- switch a timestamp at point one day into the future 20491- switch a timestamp at point one day into the future
20492- on a headline, switch to the next TODO keyword. 20492- on a headline, switch to the next TODO keyword
20493- on an item, switch entire list to the next bullet type 20493- on an item, switch entire list to the next bullet type
20494- on a property line, switch to the next allowed value 20494- on a property line, switch to the next allowed value
20495- on a clocktable definition line, move time block into the future" 20495- on a clocktable definition line, move time block into the future"
diff --git a/lisp/org/ox-html.el b/lisp/org/ox-html.el
index 1f98fcdd5cf..8445f236bae 100644
--- a/lisp/org/ox-html.el
+++ b/lisp/org/ox-html.el
@@ -1138,7 +1138,7 @@ checkboxes. The other two use the `off' checkbox for `trans'.")
1138 1138
1139(defcustom org-html-checkbox-type 'ascii 1139(defcustom org-html-checkbox-type 'ascii
1140 "The type of checkboxes to use for HTML export. 1140 "The type of checkboxes to use for HTML export.
1141See `org-html-checkbox-types' for for the values used for each 1141See `org-html-checkbox-types' for the values used for each
1142option." 1142option."
1143 :group 'org-export-html 1143 :group 'org-export-html
1144 :version "24.4" 1144 :version "24.4"
diff --git a/lisp/org/ox-latex.el b/lisp/org/ox-latex.el
index b029f828e4f..e617317a062 100644
--- a/lisp/org/ox-latex.el
+++ b/lisp/org/ox-latex.el
@@ -3319,7 +3319,7 @@ property."
3319 (let ((attr (org-export-read-attribute :attr_latex table))) 3319 (let ((attr (org-export-read-attribute :attr_latex table)))
3320 (when (plist-get attr :rmlines) 3320 (when (plist-get attr :rmlines)
3321 ;; When the "rmlines" attribute is provided, remove all hlines 3321 ;; When the "rmlines" attribute is provided, remove all hlines
3322 ;; but the the one separating heading from the table body. 3322 ;; but the one separating heading from the table body.
3323 (let ((n 0) (pos 0)) 3323 (let ((n 0) (pos 0))
3324 (while (and (< (length output) pos) 3324 (while (and (< (length output) pos)
3325 (setq pos (string-match "^\\\\hline\n?" output pos))) 3325 (setq pos (string-match "^\\\\hline\n?" output pos)))
diff --git a/lisp/org/ox-man.el b/lisp/org/ox-man.el
index 816cc3662e3..c0b0f7d223b 100644
--- a/lisp/org/ox-man.el
+++ b/lisp/org/ox-man.el
@@ -159,7 +159,7 @@ When nil, no transformation is made."
159;; Src blocks 159;; Src blocks
160 160
161(defcustom org-man-source-highlight nil 161(defcustom org-man-source-highlight nil
162 "Use GNU source highlight to embellish source blocks " 162 "Use GNU source highlight to embellish source blocks."
163 :group 'org-export-man 163 :group 'org-export-man
164 :version "24.4" 164 :version "24.4"
165 :package-version '(Org . "8.0") 165 :package-version '(Org . "8.0")
@@ -1042,7 +1042,7 @@ holding contextual information."
1042 1042
1043(defun org-man-verse-block (_verse-block contents _info) 1043(defun org-man-verse-block (_verse-block contents _info)
1044 "Transcode a VERSE-BLOCK element from Org to Man. 1044 "Transcode a VERSE-BLOCK element from Org to Man.
1045CONTENTS is verse block contents. INFO is a plist holding 1045CONTENTS is verse block contents. INFO is a plist holding
1046contextual information." 1046contextual information."
1047 (format ".RS\n.ft I\n%s\n.ft\n.RE" contents)) 1047 (format ".RS\n.ft I\n%s\n.ft\n.RE" contents))
1048 1048
diff --git a/lisp/org/ox-publish.el b/lisp/org/ox-publish.el
index 237b2ff8163..39547382b27 100644
--- a/lisp/org/ox-publish.el
+++ b/lisp/org/ox-publish.el
@@ -907,7 +907,7 @@ PROJECT is the current project."
907 907
908(defun org-publish-sitemap-default (title list) 908(defun org-publish-sitemap-default (title list)
909 "Default site map, as a string. 909 "Default site map, as a string.
910TITLE is the the title of the site map. LIST is an internal 910TITLE is the title of the site map. LIST is an internal
911representation for the files to include, as returned by 911representation for the files to include, as returned by
912`org-list-to-lisp'. PROJECT is the current project." 912`org-list-to-lisp'. PROJECT is the current project."
913 (concat "#+TITLE: " title "\n\n" 913 (concat "#+TITLE: " title "\n\n"
diff --git a/lisp/outline.el b/lisp/outline.el
index 74df77b8be7..be9f3172b74 100644
--- a/lisp/outline.el
+++ b/lisp/outline.el
@@ -537,10 +537,10 @@ nil for WHICH, or do not pass any argument)."
537If there are no such entries, return nil. 537If there are no such entries, return nil.
538ALIST defaults to `outline-heading-alist'. 538ALIST defaults to `outline-heading-alist'.
539Similar to (car (rassoc LEVEL ALIST)). 539Similar to (car (rassoc LEVEL ALIST)).
540If there are several different entries with same new level, choose 540If there are several different entries with same new level, choose the
541the one with the smallest distance to the association of HEAD in the alist. 541one with the smallest distance to the association of HEAD in the alist.
542This makes it possible for promotion to work in modes with several 542This makes it possible for promotion to work in modes with several
543independent sets of headings (numbered, unnumbered, appendix...)" 543independent sets of headings (numbered, unnumbered, appendix...)."
544 (unless alist (setq alist outline-heading-alist)) 544 (unless alist (setq alist outline-heading-alist))
545 (let ((l (rassoc level alist)) 545 (let ((l (rassoc level alist))
546 ll h hl l2 l2l) 546 ll h hl l2 l2l)
diff --git a/lisp/progmodes/cc-engine.el b/lisp/progmodes/cc-engine.el
index 29ebe2eea1f..4916b1dabb8 100644
--- a/lisp/progmodes/cc-engine.el
+++ b/lisp/progmodes/cc-engine.el
@@ -7554,7 +7554,7 @@ comment at the start of cc-engine.el for more info."
7554 7554
7555(defun c-maybe-re-mark-raw-string () 7555(defun c-maybe-re-mark-raw-string ()
7556 ;; When this function is called, point is immediately after a " which opens 7556 ;; When this function is called, point is immediately after a " which opens
7557 ;; a string. If this " is the characteristic " of of a raw string 7557 ;; a string. If this " is the characteristic " of a raw string
7558 ;; opener, apply the pertinent `syntax-table' text properties to the 7558 ;; opener, apply the pertinent `syntax-table' text properties to the
7559 ;; entire raw string (when properly terminated) or just the delimiter 7559 ;; entire raw string (when properly terminated) or just the delimiter
7560 ;; (otherwise). In either of these cases, return t, otherwise return nil. 7560 ;; (otherwise). In either of these cases, return t, otherwise return nil.
diff --git a/lisp/progmodes/dcl-mode.el b/lisp/progmodes/dcl-mode.el
index 864074fe191..85923ce9fe1 100644
--- a/lisp/progmodes/dcl-mode.el
+++ b/lisp/progmodes/dcl-mode.el
@@ -784,7 +784,7 @@ by the numbers in order 1-2-3-1-... :
784 (dcl-back-to-indentation-1 (point)) 784 (dcl-back-to-indentation-1 (point))
785 (dcl-back-to-indentation-1))) 785 (dcl-back-to-indentation-1)))
786(defun dcl-back-to-indentation-1 (&optional limit) 786(defun dcl-back-to-indentation-1 (&optional limit)
787 "Helper function for dcl-back-to-indentation" 787 "Helper function for `dcl-back-to-indentation'."
788 788
789 ;; "Indentation points" that we will travel to 789 ;; "Indentation points" that we will travel to
790 ;; $ l: ! comment 790 ;; $ l: ! comment
@@ -1074,8 +1074,7 @@ dcl-calc-command-indent-function is nil or returns nil set cur-indent
1074to cur-indent+extra-indent. 1074to cur-indent+extra-indent.
1075 1075
1076See also documentation for dcl-calc-command-indent-function. 1076See also documentation for dcl-calc-command-indent-function.
1077The indent-type classification could probably be expanded upon. 1077The indent-type classification could probably be expanded upon."
1078"
1079 () 1078 ()
1080 (save-excursion 1079 (save-excursion
1081 (beginning-of-line) 1080 (beginning-of-line)
@@ -1458,7 +1457,7 @@ regexps in `dcl-electric-reindent-regexps'."
1458 1457
1459;;;------------------------------------------------------------------------- 1458;;;-------------------------------------------------------------------------
1460(defun dcl-indent-to (col &optional minimum) 1459(defun dcl-indent-to (col &optional minimum)
1461 "Like indent-to, but only indents if indentation would change" 1460 "Like `indent-to', but only indents if indentation would change."
1462 (interactive) 1461 (interactive)
1463 (let (cur-indent collapsed indent) 1462 (let (cur-indent collapsed indent)
1464 (save-excursion 1463 (save-excursion
diff --git a/lisp/progmodes/flymake.el b/lisp/progmodes/flymake.el
index 6d47c8bb170..6891e19fd1b 100644
--- a/lisp/progmodes/flymake.el
+++ b/lisp/progmodes/flymake.el
@@ -317,7 +317,7 @@ TYPE is a key to symbol and TEXT is a description of the problem
317detected in this region. DATA is any object that the caller 317detected in this region. DATA is any object that the caller
318wishes to attach to the created diagnostic for later retrieval. 318wishes to attach to the created diagnostic for later retrieval.
319 319
320OVERLAY-PROPERTIES is an an alist of properties attached to the 320OVERLAY-PROPERTIES is an alist of properties attached to the
321created diagnostic, overriding the default properties and any 321created diagnostic, overriding the default properties and any
322properties of `flymake-overlay-control' of the diagnostic's 322properties of `flymake-overlay-control' of the diagnostic's
323type." 323type."
@@ -358,7 +358,7 @@ diagnostics at BEG."
358(cl-defun flymake--overlays (&key beg end filter compare key) 358(cl-defun flymake--overlays (&key beg end filter compare key)
359 "Get flymake-related overlays. 359 "Get flymake-related overlays.
360If BEG is non-nil and END is nil, consider only `overlays-at' 360If BEG is non-nil and END is nil, consider only `overlays-at'
361BEG. Otherwise consider `overlays-in' the region comprised by BEG 361BEG. Otherwise consider `overlays-in' the region comprised by BEG
362and END, defaulting to the whole buffer. Remove all that do not 362and END, defaulting to the whole buffer. Remove all that do not
363verify FILTER, a function, and sort them by COMPARE (using KEY)." 363verify FILTER, a function, and sort them by COMPARE (using KEY)."
364 (save-restriction 364 (save-restriction
@@ -498,7 +498,7 @@ this buffer. To reset the list of disabled backends, turn
498`flymake-start' with a prefix argument. 498`flymake-start' with a prefix argument.
499 499
500If the function returns, Flymake considers the backend to be 500If the function returns, Flymake considers the backend to be
501\"running\". If it has not done so already, the backend is 501\"running\". If it has not done so already, the backend is
502expected to call the function REPORT-FN with a single argument 502expected to call the function REPORT-FN with a single argument
503REPORT-ACTION also followed by an optional list of keyword-value 503REPORT-ACTION also followed by an optional list of keyword-value
504pairs in the form (:REPORT-KEY VALUE :REPORT-KEY2 VALUE2...). 504pairs in the form (:REPORT-KEY VALUE :REPORT-KEY2 VALUE2...).
@@ -513,8 +513,8 @@ Currently accepted values for REPORT-ACTION are:
513 A backend may call REPORT-FN repeatedly in this manner, but 513 A backend may call REPORT-FN repeatedly in this manner, but
514 only until Flymake considers that the most recently requested 514 only until Flymake considers that the most recently requested
515 buffer check is now obsolete because, say, buffer contents have 515 buffer check is now obsolete because, say, buffer contents have
516 changed in the meantime. The backend is only given notice of 516 changed in the meantime. The backend is only given notice of
517 this via a renewed call to the backend function. Thus, to 517 this via a renewed call to the backend function. Thus, to
518 prevent making obsolete reports and wasting resources, backend 518 prevent making obsolete reports and wasting resources, backend
519 functions should first cancel any ongoing processing from 519 functions should first cancel any ongoing processing from
520 previous calls. 520 previous calls.
@@ -545,7 +545,7 @@ Currently accepted REPORT-KEY arguments are:
545(defvar flymake-diagnostic-types-alist '() "") 545(defvar flymake-diagnostic-types-alist '() "")
546(make-obsolete-variable 546(make-obsolete-variable
547 'flymake-diagnostic-types-alist 547 'flymake-diagnostic-types-alist
548 "Set properties on the diagnostic symbols instead. See Info 548 "Set properties on the diagnostic symbols instead. See Info
549Node `(Flymake)Flymake error types'" 549Node `(Flymake)Flymake error types'"
550 "27.1") 550 "27.1")
551 551
@@ -666,12 +666,12 @@ associated `flymake-category' return DEFAULT."
666(defvar-local flymake--backend-state nil 666(defvar-local flymake--backend-state nil
667 "Buffer-local hash table of a Flymake backend's state. 667 "Buffer-local hash table of a Flymake backend's state.
668The keys to this hash table are functions as found in 668The keys to this hash table are functions as found in
669`flymake-diagnostic-functions'. The values are structures 669`flymake-diagnostic-functions'. The values are structures
670of the type `flymake--backend-state', with these slots: 670of the type `flymake--backend-state', with these slots:
671 671
672`running', a symbol to keep track of a backend's replies via its 672`running', a symbol to keep track of a backend's replies via its
673REPORT-FN argument. A backend is running if this key is 673REPORT-FN argument. A backend is running if this key is
674present. If nil, Flymake isn't expecting any replies from the 674present. If nil, Flymake isn't expecting any replies from the
675backend. 675backend.
676 676
677`diags', a (possibly empty) list of recent diagnostic objects 677`diags', a (possibly empty) list of recent diagnostic objects
@@ -700,7 +700,7 @@ backend is operating normally.")
700 ,@body))) 700 ,@body)))
701 701
702(defun flymake-is-running () 702(defun flymake-is-running ()
703 "Tell if Flymake has running backends in this buffer" 703 "Tell if Flymake has running backends in this buffer."
704 (flymake-running-backends)) 704 (flymake-running-backends))
705 705
706;; FIXME: clone of `isearch-intesects-p'! Make this an util. 706;; FIXME: clone of `isearch-intesects-p'! Make this an util.
@@ -804,7 +804,7 @@ different runs of the same backend."
804 804
805(defun flymake--collect (fn &optional message-prefix) 805(defun flymake--collect (fn &optional message-prefix)
806 "Collect Flymake backends matching FN. 806 "Collect Flymake backends matching FN.
807If MESSAGE-PREFIX, echo a message using that prefix" 807If MESSAGE-PREFIX, echo a message using that prefix."
808 (unless flymake--backend-state 808 (unless flymake--backend-state
809 (user-error "Flymake is not initialized")) 809 (user-error "Flymake is not initialized"))
810 (let (retval) 810 (let (retval)
@@ -979,7 +979,7 @@ buffer happens via the special hook
979 979
980Some backends may take longer than others to respond or complete, 980Some backends may take longer than others to respond or complete,
981and some may decide to disable themselves if they are not 981and some may decide to disable themselves if they are not
982suitable for the current buffer. The commands 982suitable for the current buffer. The commands
983`flymake-running-backends', `flymake-disabled-backends' and 983`flymake-running-backends', `flymake-disabled-backends' and
984`flymake-reporting-backends' summarize the situation, as does the 984`flymake-reporting-backends' summarize the situation, as does the
985special *Flymake log* buffer." :group 'flymake :lighter 985special *Flymake log* buffer." :group 'flymake :lighter
diff --git a/lisp/progmodes/gdb-mi.el b/lisp/progmodes/gdb-mi.el
index 48c7dde9f51..1c8fad3069c 100644
--- a/lisp/progmodes/gdb-mi.el
+++ b/lisp/progmodes/gdb-mi.el
@@ -154,7 +154,7 @@ May be manually changed by user with `gdb-select-frame'.")
154 "Associative list of threads provided by \"-thread-info\" MI command. 154 "Associative list of threads provided by \"-thread-info\" MI command.
155 155
156Keys are thread numbers (in strings) and values are structures as 156Keys are thread numbers (in strings) and values are structures as
157returned from -thread-info by `gdb-json-partial-output'. Updated in 157returned from -thread-info by `gdb-json-partial-output'. Updated in
158`gdb-thread-list-handler-custom'.") 158`gdb-thread-list-handler-custom'.")
159 159
160(defvar gdb-running-threads-count nil 160(defvar gdb-running-threads-count nil
@@ -378,18 +378,18 @@ Must be a list of pairs with cars being buffers and cdr's being
378valid signal handlers.") 378valid signal handlers.")
379 379
380(defgroup gdb nil 380(defgroup gdb nil
381 "GDB graphical interface" 381 "GDB graphical interface."
382 :group 'tools 382 :group 'tools
383 :link '(info-link "(emacs)GDB Graphical Interface") 383 :link '(info-link "(emacs)GDB Graphical Interface")
384 :version "23.2") 384 :version "23.2")
385 385
386(defgroup gdb-non-stop nil 386(defgroup gdb-non-stop nil
387 "GDB non-stop debugging settings" 387 "GDB non-stop debugging settings."
388 :group 'gdb 388 :group 'gdb
389 :version "23.2") 389 :version "23.2")
390 390
391(defgroup gdb-buffers nil 391(defgroup gdb-buffers nil
392 "GDB buffers" 392 "GDB buffers."
393 :group 'gdb 393 :group 'gdb
394 :version "23.2") 394 :version "23.2")
395 395
@@ -657,7 +657,7 @@ When `gdb-non-stop' is nil, return COMMAND unchanged."
657 "`gud-call' wrapper which adds --thread/--all options between 657 "`gud-call' wrapper which adds --thread/--all options between
658CMD1 and CMD2. NOALL is the same as in `gdb-gud-context-command'. 658CMD1 and CMD2. NOALL is the same as in `gdb-gud-context-command'.
659 659
660NOARG must be t when this macro is used outside `gud-def'" 660NOARG must be t when this macro is used outside `gud-def'."
661 `(gud-call 661 `(gud-call
662 (concat (gdb-gud-context-command ,cmd1 ,noall) " " ,cmd2) 662 (concat (gdb-gud-context-command ,cmd1 ,noall) " " ,cmd2)
663 ,(when (not noarg) 'arg))) 663 ,(when (not noarg) 'arg)))
@@ -2681,7 +2681,7 @@ in MI messages, e.g.: [key=.., key=..]. -stack-list-frames and
2681responses. 2681responses.
2682 2682
2683If FIX-LIST is non-nil, \"FIX-LIST={..}\" is replaced with 2683If FIX-LIST is non-nil, \"FIX-LIST={..}\" is replaced with
2684\"FIX-LIST=[..]\" prior to parsing. This is used to fix broken 2684\"FIX-LIST=[..]\" prior to parsing. This is used to fix broken
2685-break-info output when it contains breakpoint script field 2685-break-info output when it contains breakpoint script field
2686incompatible with GDB/MI output syntax. 2686incompatible with GDB/MI output syntax.
2687 2687
diff --git a/lisp/progmodes/grep.el b/lisp/progmodes/grep.el
index 306ae8fd50f..fec87bbd1ca 100644
--- a/lisp/progmodes/grep.el
+++ b/lisp/progmodes/grep.el
@@ -255,7 +255,7 @@ to limit saving to files located under `my-grep-root'."
255 255
256(defcustom grep-error-screen-columns nil 256(defcustom grep-error-screen-columns nil
257 "If non-nil, column numbers in grep hits are screen columns. 257 "If non-nil, column numbers in grep hits are screen columns.
258See `compilation-error-screen-columns'" 258See `compilation-error-screen-columns'."
259 :type '(choice (const :tag "Default" nil) 259 :type '(choice (const :tag "Default" nil)
260 integer) 260 integer)
261 :version "22.1" 261 :version "22.1"
diff --git a/lisp/progmodes/gud.el b/lisp/progmodes/gud.el
index 235546ef2e4..396141b3884 100644
--- a/lisp/progmodes/gud.el
+++ b/lisp/progmodes/gud.el
@@ -3069,7 +3069,7 @@ the character after the end of the expr."
3069 "Returns the previous expr, point is set to beginning of that expr. 3069 "Returns 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."
3073 (let ((begin) (end)) 3073 (let ((begin) (end))
3074 (gud-backward-sexp) 3074 (gud-backward-sexp)
3075 (setq begin (point)) 3075 (setq begin (point))
diff --git a/lisp/progmodes/perl-mode.el b/lisp/progmodes/perl-mode.el
index 7cbd30a0d1d..55ea3417ffd 100644
--- a/lisp/progmodes/perl-mode.el
+++ b/lisp/progmodes/perl-mode.el
@@ -500,7 +500,7 @@
500 "Indentation of Perl statements with respect to containing block." 500 "Indentation of Perl statements with respect to containing block."
501 :type 'integer) 501 :type 'integer)
502 502
503;; Is is not unusual to put both things like perl-indent-level and 503;; It is not unusual to put both things like perl-indent-level and
504;; cperl-indent-level in the local variable section of a file. If only 504;; cperl-indent-level in the local variable section of a file. If only
505;; one of perl-mode and cperl-mode is in use, a warning will be issued 505;; one of perl-mode and cperl-mode is in use, a warning will be issued
506;; about the variable. Autoload these here, so that no warning is 506;; about the variable. Autoload these here, so that no warning is
diff --git a/lisp/progmodes/ps-mode.el b/lisp/progmodes/ps-mode.el
index b589cab9c25..7f9d880757e 100644
--- a/lisp/progmodes/ps-mode.el
+++ b/lisp/progmodes/ps-mode.el
@@ -496,7 +496,7 @@ The keymap for this second window is:
496 496
497 497
498When Ghostscript encounters an error it displays an error message 498When Ghostscript encounters an error it displays an error message
499with a file position. Clicking mouse-2 on this number will bring 499with a file position. Clicking mouse-2 on this number will bring
500point to the corresponding spot in the PostScript window, if input 500point to the corresponding spot in the PostScript window, if input
501to the interpreter was sent from that window. 501to the interpreter was sent from that window.
502Typing \\<ps-run-mode-map>\\[ps-run-goto-error] when the cursor is at the number has the same effect." 502Typing \\<ps-run-mode-map>\\[ps-run-goto-error] when the cursor is at the number has the same effect."
@@ -606,7 +606,7 @@ Typing \\<ps-run-mode-map>\\[ps-run-goto-error] when the cursor is at the number
606 "To what column should text on current line be indented? 606 "To what column should text on current line be indented?
607 607
608Indentation is increased if the last token on the current line 608Indentation is increased if the last token on the current line
609defines the beginning of a group. These tokens are: { [ <<" 609defines the beginning of a group. These tokens are: { [ <<"
610 (save-excursion 610 (save-excursion
611 (beginning-of-line) 611 (beginning-of-line)
612 (if (looking-at "[ \t]*\\(}\\|\\]\\|>>\\)") 612 (if (looking-at "[ \t]*\\(}\\|\\]\\|>>\\)")
@@ -1068,7 +1068,7 @@ grestore
1068 1068
1069(defun ps-run-goto-error () 1069(defun ps-run-goto-error ()
1070 "Jump to buffer position read as integer at point. 1070 "Jump to buffer position read as integer at point.
1071Use line numbers if `ps-run-error-line-numbers' is not nil" 1071Use line numbers if `ps-run-error-line-numbers' is not nil."
1072 (interactive) 1072 (interactive)
1073 (let ((p (point))) 1073 (let ((p (point)))
1074 (unless (looking-at "[0-9]") 1074 (unless (looking-at "[0-9]")
diff --git a/lisp/progmodes/python.el b/lisp/progmodes/python.el
index ec5d8c55512..ae5aff351c0 100644
--- a/lisp/progmodes/python.el
+++ b/lisp/progmodes/python.el
@@ -4415,7 +4415,7 @@ returns will be used. If not FORCE-PROCESS is passed what
4415 4415
4416(defvar-local python-eldoc-get-doc t 4416(defvar-local python-eldoc-get-doc t
4417 "Non-nil means eldoc should fetch the documentation 4417 "Non-nil means eldoc should fetch the documentation
4418 automatically. Set to nil by `python-eldoc-function' if 4418 automatically. Set to nil by `python-eldoc-function' if
4419 `python-eldoc-function-timeout-permanent' is non-nil and 4419 `python-eldoc-function-timeout-permanent' is non-nil and
4420 `python-eldoc-function' times out.") 4420 `python-eldoc-function' times out.")
4421 4421
@@ -4427,7 +4427,7 @@ returns will be used. If not FORCE-PROCESS is passed what
4427 4427
4428(defcustom python-eldoc-function-timeout-permanent t 4428(defcustom python-eldoc-function-timeout-permanent t
4429 "Non-nil means that when `python-eldoc-function' times out 4429 "Non-nil means that when `python-eldoc-function' times out
4430`python-eldoc-get-doc' will be set to nil" 4430`python-eldoc-get-doc' will be set to nil."
4431 :group 'python 4431 :group 'python
4432 :type 'boolean 4432 :type 'boolean
4433 :version "25.1") 4433 :version "25.1")
@@ -4445,7 +4445,7 @@ function returns then if
4445longer return the documentation at the point automatically. 4445longer return the documentation at the point automatically.
4446 4446
4447Set `python-eldoc-get-doc' to t to reenable eldoc documentation 4447Set `python-eldoc-get-doc' to t to reenable eldoc documentation
4448fetching" 4448fetching."
4449 (when python-eldoc-get-doc 4449 (when python-eldoc-get-doc
4450 (with-timeout (python-eldoc-function-timeout 4450 (with-timeout (python-eldoc-function-timeout
4451 (if python-eldoc-function-timeout-permanent 4451 (if python-eldoc-function-timeout-permanent
diff --git a/lisp/shadowfile.el b/lisp/shadowfile.el
index 72491b99807..6340c9f1d61 100644
--- a/lisp/shadowfile.el
+++ b/lisp/shadowfile.el
@@ -557,7 +557,7 @@ permanently, remove the group from `shadow-literal-groups' or
557(defun shadow-make-group (regexp sites) 557(defun shadow-make-group (regexp sites)
558 "Make a description of a file group--- 558 "Make a description of a file group---
559actually a list of regexp Tramp file names---from REGEXP (name of file to 559actually a list of regexp Tramp file names---from REGEXP (name of file to
560be shadowed), and list of SITES" 560be shadowed), and list of SITES."
561 (if sites 561 (if sites
562 (cons (shadow-make-fullname 562 (cons (shadow-make-fullname
563 (shadow-parse-name (shadow-site-primary (car sites))) nil regexp) 563 (shadow-parse-name (shadow-site-primary (car sites))) nil regexp)
diff --git a/lisp/speedbar.el b/lisp/speedbar.el
index 52ae5d2da5a..e4e67349949 100644
--- a/lisp/speedbar.el
+++ b/lisp/speedbar.el
@@ -555,7 +555,7 @@ current file, and the FILENAME of the file being checked."
555(defcustom speedbar-obj-do-check t 555(defcustom speedbar-obj-do-check t
556 "Non-nil check all files in speedbar to see if they have an object file. 556 "Non-nil check all files in speedbar to see if they have an object file.
557Any file checked out is marked with `speedbar-obj-indicator', and the 557Any file checked out is marked with `speedbar-obj-indicator', and the
558marking is based on `speedbar-obj-alist'" 558marking is based on `speedbar-obj-alist'."
559 :group 'speedbar-vc 559 :group 'speedbar-vc
560 :type 'boolean) 560 :type 'boolean)
561 561
diff --git a/lisp/textmodes/flyspell.el b/lisp/textmodes/flyspell.el
index bae0283497e..ce788207cf5 100644
--- a/lisp/textmodes/flyspell.el
+++ b/lisp/textmodes/flyspell.el
@@ -2103,7 +2103,7 @@ spell-check."
2103;;*---------------------------------------------------------------------*/ 2103;;*---------------------------------------------------------------------*/
2104(defun flyspell-auto-correct-previous-hook () 2104(defun flyspell-auto-correct-previous-hook ()
2105 "Hook to track successive calls to `flyspell-auto-correct-previous-word'. 2105 "Hook to track successive calls to `flyspell-auto-correct-previous-word'.
2106Sets `flyspell-auto-correct-previous-pos' to nil" 2106Sets `flyspell-auto-correct-previous-pos' to nil."
2107 (interactive) 2107 (interactive)
2108 (remove-hook 'pre-command-hook (function flyspell-auto-correct-previous-hook) t) 2108 (remove-hook 'pre-command-hook (function flyspell-auto-correct-previous-hook) t)
2109 (unless (eq this-command (function flyspell-auto-correct-previous-word)) 2109 (unless (eq this-command (function flyspell-auto-correct-previous-word))
diff --git a/lisp/textmodes/reftex-cite.el b/lisp/textmodes/reftex-cite.el
index 5b42b25f772..9d45f9aba79 100644
--- a/lisp/textmodes/reftex-cite.el
+++ b/lisp/textmodes/reftex-cite.el
@@ -74,7 +74,7 @@ The expanded value is cached."
74;;;###autoload 74;;;###autoload
75(defun reftex-bib-or-thebib () 75(defun reftex-bib-or-thebib ()
76 "Test if BibTeX or \\begin{thebibliography} should be used for the citation. 76 "Test if BibTeX or \\begin{thebibliography} should be used for the citation.
77Find the bof of the current file" 77Find the bof of the current file."
78 (let* ((docstruct (symbol-value reftex-docstruct-symbol)) 78 (let* ((docstruct (symbol-value reftex-docstruct-symbol))
79 (rest (or (member (list 'bof (buffer-file-name)) docstruct) 79 (rest (or (member (list 'bof (buffer-file-name)) docstruct)
80 docstruct)) 80 docstruct))
diff --git a/lisp/textmodes/reftex-index.el b/lisp/textmodes/reftex-index.el
index 9f5242a6f5c..cf94600193c 100644
--- a/lisp/textmodes/reftex-index.el
+++ b/lisp/textmodes/reftex-index.el
@@ -771,7 +771,7 @@ Label context is only displayed when the labels are there as well."
771 (interactive) 771 (interactive)
772 (reftex-index-visit-location 'hide)) 772 (reftex-index-visit-location 'hide))
773(defun reftex-index-goto-entry () 773(defun reftex-index-goto-entry ()
774 "Go to document location in other window. *Index* window stays." 774 "Go to document location in other window. *Index* window stays."
775 (interactive) 775 (interactive)
776 (reftex-index-visit-location t)) 776 (reftex-index-visit-location t))
777(defun reftex-index-mouse-goto-line-and-hide (ev) 777(defun reftex-index-mouse-goto-line-and-hide (ev)
@@ -1093,12 +1093,12 @@ When index is restricted, select the previous section as restriction criterion."
1093 (reftex-index-change-entry new (format "Removed prefix: %s" prefix)))) 1093 (reftex-index-change-entry new (format "Removed prefix: %s" prefix))))
1094 1094
1095(defun reftex-index-kill () 1095(defun reftex-index-kill ()
1096 "FIXME: Not yet implemented" 1096 "FIXME: Not yet implemented."
1097 (interactive) 1097 (interactive)
1098 (error "This function is currently not implemented")) 1098 (error "This function is currently not implemented"))
1099 1099
1100(defun reftex-index-undo () 1100(defun reftex-index-undo ()
1101 "FIXME: Not yet implemented" 1101 "FIXME: Not yet implemented."
1102 (interactive) 1102 (interactive)
1103 (error "This function is currently not implemented")) 1103 (error "This function is currently not implemented"))
1104 1104
diff --git a/lisp/textmodes/reftex-parse.el b/lisp/textmodes/reftex-parse.el
index 005816e9659..eb8446f4c4c 100644
--- a/lisp/textmodes/reftex-parse.el
+++ b/lisp/textmodes/reftex-parse.el
@@ -1013,7 +1013,7 @@ OPT-ARGS is a list of argument numbers which are optional."
1013 1013
1014(defun reftex-context-substring (&optional to-end) 1014(defun reftex-context-substring (&optional to-end)
1015 "Return up to 150 chars from point. 1015 "Return up to 150 chars from point.
1016When point is just after a { or [, limit string to matching parenthesis" 1016When point is just after a { or [, limit string to matching parenthesis."
1017 (cond 1017 (cond
1018 (to-end 1018 (to-end
1019 ;; Environment - find next \end 1019 ;; Environment - find next \end
diff --git a/lisp/textmodes/reftex.el b/lisp/textmodes/reftex.el
index d763769a18a..bec86840c0c 100644
--- a/lisp/textmodes/reftex.el
+++ b/lisp/textmodes/reftex.el
@@ -390,7 +390,7 @@ If the symbols for the current master file do not exist, they are created."
390 (buffer-file-name))))) 390 (buffer-file-name)))))
391 (cond 391 (cond
392 ((null master) 392 ((null master)
393 (error "Need a filename for this buffer, please save it first")) 393 (error "Need a filename for this buffer, please save it first"))
394 ((or (file-exists-p (concat master ".tex")) 394 ((or (file-exists-p (concat master ".tex"))
395 (reftex-get-buffer-visiting (concat master ".tex"))) 395 (reftex-get-buffer-visiting (concat master ".tex")))
396 ;; Ahh, an extra .tex was missing... 396 ;; Ahh, an extra .tex was missing...
diff --git a/lisp/textmodes/rst.el b/lisp/textmodes/rst.el
index ba5d7e4f46f..88c44c06da0 100644
--- a/lisp/textmodes/rst.el
+++ b/lisp/textmodes/rst.el
@@ -1904,7 +1904,7 @@ includes indentation and correct length of adornment lines."
1904 "Return the next best `rst-Hdr' upward from HDR. 1904 "Return the next best `rst-Hdr' upward from HDR.
1905Consider existing hierarchy HIER and preferred headers. PREV may 1905Consider existing hierarchy HIER and preferred headers. PREV may
1906be a previous `rst-Hdr' which may be taken into account. If DOWN 1906be a previous `rst-Hdr' which may be taken into account. If DOWN
1907return the next best `rst-Hdr' downward instead. Return nil in 1907return the next best `rst-Hdr' downward instead. Return nil if
1908HIER is nil." 1908HIER is nil."
1909 (let* ((normalized-hier (if down 1909 (let* ((normalized-hier (if down
1910 hier 1910 hier
@@ -2878,7 +2878,7 @@ file-write hook to always make it up-to-date automatically."
2878 ;; testcover: ok. 2878 ;; testcover: ok.
2879 "Display a table of contents for current buffer. 2879 "Display a table of contents for current buffer.
2880Displays all section titles found in the current buffer in a 2880Displays all section titles found in the current buffer in a
2881hierarchical list. The resulting buffer can be navigated, and 2881hierarchical list. The resulting buffer can be navigated, and
2882selecting a section title moves the cursor to that section." 2882selecting a section title moves the cursor to that section."
2883 (interactive) 2883 (interactive)
2884 (rst-reset-section-caches) 2884 (rst-reset-section-caches)
@@ -3397,7 +3397,7 @@ Region is from BEG to END. Uncomment if ARG."
3397 3397
3398(defun rst-uncomment-region (beg end &optional _arg) 3398(defun rst-uncomment-region (beg end &optional _arg)
3399 "Uncomment the current region. 3399 "Uncomment the current region.
3400Region is from BEG to END. _ARG is ignored" 3400Region is from BEG to END. _ARG is ignored."
3401 (save-excursion 3401 (save-excursion
3402 (goto-char beg) 3402 (goto-char beg)
3403 (rst-forward-line-strict 0) 3403 (rst-forward-line-strict 0)
@@ -4003,7 +4003,7 @@ to `font-lock-end'."
4003 4003
4004(defun rst-font-lock-extend-region-internal (beg end) 4004(defun rst-font-lock-extend-region-internal (beg end)
4005 "Check the region BEG / END for being in the middle of a multi-line construct. 4005 "Check the region BEG / END for being in the middle of a multi-line construct.
4006Return nil if not or a cons with new values for BEG / END" 4006Return nil if not or a cons with new values for BEG / END."
4007 (let ((nbeg (rst-font-lock-extend-region-extend beg -1)) 4007 (let ((nbeg (rst-font-lock-extend-region-extend beg -1))
4008 (nend (rst-font-lock-extend-region-extend end 1))) 4008 (nend (rst-font-lock-extend-region-extend end 1)))
4009 (if (or nbeg nend) 4009 (if (or nbeg nend)
diff --git a/lisp/thumbs.el b/lisp/thumbs.el
index 6a17a756548..2b1eb4630d0 100644
--- a/lisp/thumbs.el
+++ b/lisp/thumbs.el
@@ -758,7 +758,7 @@ ACTION and ARG should be a valid convert command."
758(put 'thumbs-mode 'mode-class 'special) 758(put 'thumbs-mode 'mode-class 'special)
759(define-derived-mode thumbs-mode 759(define-derived-mode thumbs-mode
760 fundamental-mode "thumbs" 760 fundamental-mode "thumbs"
761 "Preview images in a thumbnails buffer" 761 "Preview images in a thumbnails buffer."
762 (setq buffer-read-only t)) 762 (setq buffer-read-only t))
763 763
764(defvar thumbs-view-image-mode-map 764(defvar thumbs-view-image-mode-map
diff --git a/lisp/vc/ediff-util.el b/lisp/vc/ediff-util.el
index 796027deadb..ee6631dc3a2 100644
--- a/lisp/vc/ediff-util.el
+++ b/lisp/vc/ediff-util.el
@@ -2207,7 +2207,7 @@ ARG is a prefix argument. If nil, copy the current difference region."
2207 "Restore ARGth diff from `ediff-killed-diffs-alist'. 2207 "Restore ARGth diff from `ediff-killed-diffs-alist'.
2208ARG is a prefix argument. If ARG is nil, restore the current-difference. 2208ARG is a prefix argument. If ARG is nil, restore the current-difference.
2209If the second optional argument, a character, is given, use it to 2209If the second optional argument, a character, is given, use it to
2210determine the target buffer instead of (ediff-last-command-char)" 2210determine the target buffer instead of `ediff-last-command-char'."
2211 (interactive "P") 2211 (interactive "P")
2212 (ediff-barf-if-not-control-buffer) 2212 (ediff-barf-if-not-control-buffer)
2213 (if (numberp arg) 2213 (if (numberp arg)
diff --git a/lisp/vc/pcvs-defs.el b/lisp/vc/pcvs-defs.el
index 7065b8dfe79..8cac61a7d44 100644
--- a/lisp/vc/pcvs-defs.el
+++ b/lisp/vc/pcvs-defs.el
@@ -86,8 +86,8 @@ will select a shared-flag.")
86(defvar cvs-cvsroot nil 86(defvar cvs-cvsroot nil
87 "Specifies where the (current) cvs master repository is. 87 "Specifies where the (current) cvs master repository is.
88Overrides the environment variable $CVSROOT by sending \" -d dir\" to 88Overrides the environment variable $CVSROOT by sending \" -d dir\" to
89all CVS commands. This switch is useful if you have multiple CVS 89all CVS commands. This switch is useful if you have multiple CVS
90repositories. It can be set interactively with \\[cvs-change-cvsroot.] 90repositories. It can be set interactively with \\[cvs-change-cvsroot.]
91There is no need to set this if $CVSROOT is set to a correct value.") 91There is no need to set this if $CVSROOT is set to a correct value.")
92 92
93(defcustom cvs-auto-remove-handled nil 93(defcustom cvs-auto-remove-handled nil
@@ -120,7 +120,7 @@ If `empty', only non-empty directories will be shown."
120 "If non-nil, tagging can only be applied to directories. 120 "If non-nil, tagging can only be applied to directories.
121Tagging should generally be applied a directory at a time, but sometimes it is 121Tagging should generally be applied a directory at a time, but sometimes it is
122useful to be able to tag a single file. The normal way to do that is to use 122useful to be able to tag a single file. The normal way to do that is to use
123`cvs-mode-force-command' so as to temporarily override the restrictions," 123`cvs-mode-force-command' so as to temporarily override the restrictions."
124 :group 'pcl-cvs 124 :group 'pcl-cvs
125 :type '(boolean)) 125 :type '(boolean))
126 126
diff --git a/lisp/vc/vc-hg.el b/lisp/vc/vc-hg.el
index c2a5a6f70c6..61d5ee1d3af 100644
--- a/lisp/vc/vc-hg.el
+++ b/lisp/vc/vc-hg.el
@@ -898,7 +898,7 @@ REPO must be the directory name of an hg repository."
898 :file-sources (nreverse vc-hg--hgignore-filenames)))) 898 :file-sources (nreverse vc-hg--hgignore-filenames))))
899 899
900(defun vc-hg--ignore-patterns-valid-p (hgip) 900(defun vc-hg--ignore-patterns-valid-p (hgip)
901 "Return whether the cached ignore patterns in HGIP are still valid" 901 "Return whether the cached ignore patterns in HGIP are still valid."
902 (let ((valid t) 902 (let ((valid t)
903 (file-sources (vc-hg--ignore-patterns-file-sources hgip))) 903 (file-sources (vc-hg--ignore-patterns-file-sources hgip)))
904 (while (and file-sources valid) 904 (while (and file-sources valid)
diff --git a/lisp/wid-edit.el b/lisp/wid-edit.el
index 7ed7b81280b..2978dc80375 100644
--- a/lisp/wid-edit.el
+++ b/lisp/wid-edit.el
@@ -1939,7 +1939,7 @@ the earlier input."
1939 widget)) 1939 widget))
1940 1940
1941(defun widget-field-value-set (widget value) 1941(defun widget-field-value-set (widget value)
1942 "Set an editable text field WIDGET to VALUE" 1942 "Set an editable text field WIDGET to VALUE."
1943 (let ((from (widget-field-start widget)) 1943 (let ((from (widget-field-start widget))
1944 (to (widget-field-text-end widget)) 1944 (to (widget-field-text-end widget))
1945 (buffer (widget-field-buffer widget))) 1945 (buffer (widget-field-buffer widget)))
@@ -3051,7 +3051,7 @@ as the value."
3051 "History of input to `widget-string-prompt-value'.") 3051 "History of input to `widget-string-prompt-value'.")
3052 3052
3053(define-widget 'string 'editable-field 3053(define-widget 'string 'editable-field
3054 "A string" 3054 "A string."
3055 :tag "String" 3055 :tag "String"
3056 :format "%{%t%}: %v" 3056 :format "%{%t%}: %v"
3057 :complete-function 'ispell-complete-word 3057 :complete-function 'ispell-complete-word
diff --git a/lisp/x-dnd.el b/lisp/x-dnd.el
index e4e2dec3b82..64635946871 100644
--- a/lisp/x-dnd.el
+++ b/lisp/x-dnd.el
@@ -433,13 +433,13 @@ otherwise return the frame coordinates."
433 (selection-symbol target-type &optional time-stamp terminal)) 433 (selection-symbol target-type &optional time-stamp terminal))
434 434
435(defun x-dnd-version-from-flags (flags) 435(defun x-dnd-version-from-flags (flags)
436 "Return the version byte from the 32 bit FLAGS in an XDndEnter message" 436 "Return the version byte from the 32 bit FLAGS in an XDndEnter message."
437 (if (consp flags) ;; Long as cons 437 (if (consp flags) ;; Long as cons
438 (ash (car flags) -8) 438 (ash (car flags) -8)
439 (ash flags -24))) ;; Ordinary number 439 (ash flags -24))) ;; Ordinary number
440 440
441(defun x-dnd-more-than-3-from-flags (flags) 441(defun x-dnd-more-than-3-from-flags (flags)
442 "Return the nmore-than3 bit from the 32 bit FLAGS in an XDndEnter message" 442 "Return the nmore-than3 bit from the 32 bit FLAGS in an XDndEnter message."
443 (if (consp flags) 443 (if (consp flags)
444 (logand (cdr flags) 1) 444 (logand (cdr flags) 1)
445 (logand flags 1))) 445 (logand flags 1)))