Merge from savannah/emacs-30

f4c0459ed3 Fix Tramp parser
47c79b62dd Checkdoc fixes in progmodes
6757f8e67d Checkdoc fixes in Org Mode
9fcee3c1d1 Clarify `checkdoc-max-keyref-before-warn` docstring
b249f022f1 * lisp/files.el (insert-directory): Quote switches in wil...
8911d53ce5 Fix uses of 'dired-omit-mode' (bug#71905)
This commit is contained in:
Po Lu 2024-07-08 15:43:55 +08:00
commit df1630ad3b
49 changed files with 164 additions and 114 deletions

View file

@ -262,14 +262,15 @@ with these words enabled."
;;;###autoload(put 'checkdoc-ispell-list-words 'safe-local-variable #'list-of-strings-p)
(defcustom checkdoc-max-keyref-before-warn nil
"If non-nil, number of \\\\=[command-to-keystroke] tokens allowed in a doc string.
Any more than this and a warning is generated suggesting that the construct
\\\\={mapvar} be used instead. If the value is nil, never warn.
"Maximum number of \\\\=[command-to-keystroke] tokens allowed in a doc string.
It used to not be practical to use `\\\\=[...]' very many times,
because display of the documentation string would become slow.
This is not an issue on modern machines, unless you have
thousands of substitutions."
Any more than this and a warning is generated suggesting that the
construct \\\\={mapvar} be used instead. If the value is nil, never
warn.
It used to be impractical to use `\\\\=[...]' very many times, because
display of the documentation string would become slow. This is not an
issue on modern machines, unless you have thousands of substitutions."
:type '(choice (const nil)
integer)
:version "28.1")