mirror of
git://git.sv.gnu.org/emacs.git
synced 2025-12-15 10:30:25 -08:00
; Minor stylistic fixes found by checkdoc
This commit is contained in:
parent
36474a1e49
commit
63f419f133
326 changed files with 1158 additions and 1180 deletions
|
|
@ -4891,7 +4891,7 @@ If optional argument STATE is positive, turn borders on."
|
|||
(+ window-y window-start-y))))
|
||||
|
||||
(defun artist--adjust-x (x)
|
||||
"Adjust the X position wrt. `display-line-numbers-mode'."
|
||||
"Adjust the X position with regards to `display-line-numbers-mode'."
|
||||
(let ((adjust (line-number-display-width)))
|
||||
(if (= adjust 0)
|
||||
x
|
||||
|
|
|
|||
|
|
@ -1569,8 +1569,8 @@ Set this variable before loading BibTeX mode."
|
|||
km)
|
||||
"Keymap used in BibTeX mode.")
|
||||
|
||||
(easy-menu-define
|
||||
bibtex-edit-menu bibtex-mode-map "BibTeX-Edit Menu in BibTeX mode"
|
||||
(easy-menu-define bibtex-edit-menu bibtex-mode-map
|
||||
"BibTeX-Edit Menu in BibTeX mode."
|
||||
'("BibTeX-Edit"
|
||||
("Moving inside an Entry"
|
||||
["End of Field" bibtex-find-text t]
|
||||
|
|
|
|||
|
|
@ -615,7 +615,7 @@ For details see `conf-mode'. Example:
|
|||
(conf-mode-initialize "!"))
|
||||
|
||||
(defun conf-toml-recognize-section (limit)
|
||||
"Font-lock helper function for conf-toml-mode.
|
||||
"Font-lock helper function for `conf-toml-mode'.
|
||||
Handles recognizing TOML section names, like [section],
|
||||
\[[section]], or [something.\"else\".section]."
|
||||
(save-excursion
|
||||
|
|
|
|||
|
|
@ -1064,7 +1064,7 @@ than line breaks untouched, and fifth arg TO-EOP non-nil means
|
|||
to keep filling to the end of the paragraph (or next hard newline,
|
||||
if variable `use-hard-newlines' is on).
|
||||
|
||||
Return the fill-prefix used for filling the last paragraph.
|
||||
Return the `fill-prefix' used for filling the last paragraph.
|
||||
|
||||
If `sentence-end-double-space' is non-nil, then period followed by one
|
||||
space does not end a sentence, so don't break a line there."
|
||||
|
|
|
|||
|
|
@ -621,7 +621,7 @@ this would require some extra guessing in `ispell-aspell-find-dictionary'.")
|
|||
("svenska" "sv_SE")
|
||||
("hebrew" "he_IL"))
|
||||
"Alist with known matching locales for standard dict names in
|
||||
`ispell-dictionary-base-alist'.")
|
||||
`ispell-dictionary-base-alist'.")
|
||||
|
||||
|
||||
;;; **********************************************************************
|
||||
|
|
|
|||
|
|
@ -699,10 +699,10 @@ afterwards settable by these commands:
|
|||
Move southwest (sw) after insertion: \\[picture-movement-sw]
|
||||
Move southeast (se) after insertion: \\[picture-movement-se]
|
||||
|
||||
Move westnorthwest (wnw) after insertion: C-u \\[picture-movement-nw]
|
||||
Move eastnortheast (ene) after insertion: C-u \\[picture-movement-ne]
|
||||
Move westsouthwest (wsw) after insertion: C-u \\[picture-movement-sw]
|
||||
Move eastsoutheast (ese) after insertion: C-u \\[picture-movement-se]
|
||||
Move westnorthwest (wnw) after insertion: \\[universal-argument] \\[picture-movement-nw]
|
||||
Move eastnortheast (ene) after insertion: \\[universal-argument] \\[picture-movement-ne]
|
||||
Move westsouthwest (wsw) after insertion: \\[universal-argument] \\[picture-movement-sw]
|
||||
Move eastsoutheast (ese) after insertion: \\[universal-argument] \\[picture-movement-se]
|
||||
|
||||
The current direction is displayed in the mode line. The initial
|
||||
direction is right. Whitespace is inserted and tabs are changed to
|
||||
|
|
|
|||
|
|
@ -221,7 +221,7 @@ Return list with entries."
|
|||
(if (string-match "\\`[ \t]*\\'" (or first-re ""))
|
||||
(user-error "Empty regular expression"))
|
||||
(if (string-match first-re "")
|
||||
(user-error "Regular expression matches the empty string."))
|
||||
(user-error "Regular expression matches the empty string"))
|
||||
|
||||
(save-excursion
|
||||
(save-window-excursion
|
||||
|
|
|
|||
|
|
@ -842,7 +842,7 @@ The function will go to the section where the entry at point was defined."
|
|||
(reftex-display-index nil nil 'redo))
|
||||
|
||||
(defun reftex-index-restrict-to-section (&optional force)
|
||||
"Restrict index to entries defined in same document sect. as entry at point."
|
||||
"Restrict index to entries defined in same document section as entry at point."
|
||||
;; Optional FORCE means, even if point is not on an index entry.
|
||||
(interactive)
|
||||
(let* ((data (get-text-property (point) :data))
|
||||
|
|
|
|||
|
|
@ -2140,7 +2140,7 @@ IGNORE-WORDS List of words which should be removed from the string."
|
|||
(make-variable-buffer-local 'reftex-isearch-minor-mode)
|
||||
|
||||
(easy-menu-define reftex-mode-menu reftex-mode-map
|
||||
"Menu used in RefTeX mode"
|
||||
"Menu used in RefTeX mode."
|
||||
`("Ref"
|
||||
["Table of Contents" reftex-toc t]
|
||||
["Recenter TOC" reftex-toc-recenter t]
|
||||
|
|
|
|||
|
|
@ -1190,7 +1190,7 @@ executing body forms.")
|
|||
|
||||
;; register table menu under global tools menu
|
||||
(easy-menu-define table-global-menu-map nil
|
||||
"Table global menu" table-global-menu)
|
||||
"Table global menu." table-global-menu)
|
||||
(easy-menu-add-item (current-global-map) '("menu-bar" "tools") "--")
|
||||
(easy-menu-add-item (current-global-map)
|
||||
'("menu-bar" "tools") table-global-menu-map)
|
||||
|
|
@ -2368,7 +2368,9 @@ table's rectangle structure."
|
|||
"Move point forward to the beginning of the next cell.
|
||||
With argument ARG, do it ARG times;
|
||||
a negative argument ARG = -N means move backward N cells.
|
||||
Do not specify NO-RECOGNIZE and UNRECOGNIZE. They are for internal use only.
|
||||
|
||||
Do not specify NO-RECOGNIZE and UNRECOGNIZE. They are for
|
||||
internal use only.
|
||||
|
||||
Sample Cell Traveling Order (In Irregular Table Cases)
|
||||
|
||||
|
|
@ -2399,8 +2401,7 @@ You can actually try how it works in this buffer. Press
|
|||
+--+ |4 | |4 | +--+ |5 +--+--+6 | |3 +--+--+4 | |5 | |6 |
|
||||
|5 +--+ | | +--+5 | | |7 |8 | | | |5 |6 | | | | | |
|
||||
| |6 | | | |6 | | +--+--+--+--+ +--+--+--+--+ +--+-----+--+
|
||||
+--+--+--+ +--+--+--+
|
||||
"
|
||||
+--+--+--+ +--+--+--+"
|
||||
;; After modifying this function, test against the above tables in
|
||||
;; the doc string. It is quite tricky. The tables above do not
|
||||
;; mean to cover every possible cases of cell layout, of course.
|
||||
|
|
@ -2915,8 +2916,7 @@ LaTeX:
|
|||
|
||||
CALS (DocBook DTD):
|
||||
URL `https://www.oasis-open.org/html/a502.htm'
|
||||
URL `https://www.oreilly.com/catalog/docbook/chapter/book/table.html#AEN114751'
|
||||
"
|
||||
URL `https://www.oreilly.com/catalog/docbook/chapter/book/table.html#AEN114751'"
|
||||
(interactive
|
||||
(let* ((_ (unless (table--probe-cell) (error "Table not found here")))
|
||||
(completion-ignore-case t)
|
||||
|
|
@ -3206,7 +3206,7 @@ CALS (DocBook DTD):
|
|||
(insert ?\n))))))
|
||||
|
||||
(defun table--cell-horizontal-char-p (c)
|
||||
"Test if character C is one of the horizontal characters"
|
||||
"Test if character C is one of the horizontal characters."
|
||||
(memq c (string-to-list table-cell-horizontal-chars)))
|
||||
|
||||
(defun table--generate-source-scan-lines (dest-buffer _language origin-cell tail-cell col-list row-list)
|
||||
|
|
@ -5289,7 +5289,7 @@ Current buffer must already be set to the cache buffer."
|
|||
(set-marker marker-point nil)))
|
||||
|
||||
(defun table--fill-region-strictly (beg end)
|
||||
"Fill region strictly so that no line exceeds fill-column.
|
||||
"Fill region strictly so that no line exceeds `fill-column'.
|
||||
When a word exceeds fill-column the word is chopped into pieces. The
|
||||
chopped location is indicated with table-word-continuation-char."
|
||||
(or (and (markerp beg) (markerp end))
|
||||
|
|
|
|||
|
|
@ -1618,7 +1618,7 @@ Used by @refill indenting command to avoid indenting within lists, etc.")
|
|||
(if (and (symbolp (car (cdr (car texinfo-stack))))
|
||||
(> 1 (length (symbol-name (car (cdr (car texinfo-stack)))))))
|
||||
(error
|
||||
"@enumerate: Use a number or letter, eg: 1, A, a, 3, B, or d." ))
|
||||
"@enumerate: Use a number or letter, eg: 1, A, a, 3, B, or d"))
|
||||
(texinfo-discard-line-with-args)
|
||||
(setq fill-column (- fill-column 5)))
|
||||
|
||||
|
|
@ -1705,7 +1705,7 @@ Used by @refill indenting command to avoid indenting within lists, etc.")
|
|||
(if (or (equal ?\[ (string-to-char enumerating-symbol))
|
||||
(equal ?\{ (string-to-char enumerating-symbol)))
|
||||
(error
|
||||
"Too many items in enumerated list; alphabet ends at Z."))
|
||||
"Too many items in enumerated list; alphabet ends at Z"))
|
||||
(insert ?\b (format "%3s. " enumerating-symbol) ?\n)
|
||||
(setcar (cdr (car texinfo-stack))
|
||||
(make-symbol
|
||||
|
|
@ -1714,7 +1714,7 @@ Used by @refill indenting command to avoid indenting within lists, etc.")
|
|||
(string-to-char enumerating-symbol))))))
|
||||
(t
|
||||
(error
|
||||
"@enumerate: Use a number or letter, eg: 1, A, a, 3, B or d." )))
|
||||
"@enumerate: Use a number or letter, eg: 1, A, a, 3, B or d")))
|
||||
(forward-line -1)))
|
||||
|
||||
(put 'alphaenumerate 'texinfo-item 'texinfo-alphaenumerate-item)
|
||||
|
|
@ -2032,7 +2032,7 @@ commands that are defined in texinfo.tex for printed output.
|
|||
;; Case 3: Trouble
|
||||
(t
|
||||
(error
|
||||
"You probably need to specify column widths for @multitable correctly.")))
|
||||
"You probably need to specify column widths for @multitable correctly")))
|
||||
;; Check whether columns fit on page.
|
||||
(let ((desired-columns
|
||||
(+
|
||||
|
|
@ -2044,7 +2044,7 @@ commands that are defined in texinfo.tex for printed output.
|
|||
(apply #'+ texinfo-multitable-width-list))))
|
||||
(if (> desired-columns fill-column)
|
||||
(error
|
||||
"Multi-column table width, %d chars, is greater than page width, %d chars."
|
||||
"Multi-column table width, %d chars, is greater than page width, %d chars"
|
||||
desired-columns fill-column)))
|
||||
texinfo-multitable-width-list))
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue