procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

; Improve checkdoc.el commentary section

Browse source 
* lisp/emacs-lisp/checkdoc.el: Improve wording of Commentary.
(checkdoc): Link commentary from defgroup.
This commit is contained in:
Stefan Kangas 2022-12-10 23:45:25 +01:00
parent 30e3cb2135
commit 118465f6fe
1 changed files with 17 additions and 8 deletions
Download patch file Download diff file Expand all files Collapse all files

25
lisp/emacs-lisp/checkdoc.el
View file

@ -22,28 +22,35 @@
;; along with GNU Emacs. If not, see <https://www.gnu.org/licenses/>. ;; along with GNU Emacs. If not, see <https://www.gnu.org/licenses/>.
;;; Commentary: ;;; Commentary:
;;
;; The Emacs Lisp manual has a nice chapter on how to write ;; The Emacs Lisp manual has a nice chapter on how to write
;; documentation strings. Many stylistic suggestions are fairly ;; documentation strings. Many stylistic suggestions are fairly
;; deterministic and easy to check for syntactically, but also easy ;; deterministic and easy to check for syntactically, but also easy
;; to forget. The main checkdoc engine will perform the stylistic ;; to forget. The main checkdoc engine will perform the stylistic
;; checks needed to make sure these styles are remembered. ;; checks needed to make sure these styles are remembered.
;; ;;
;; There are three ways to use checkdoc: ;; There are four ways to use checkdoc:
;; 1) Use `flymake-mode'. ;;
;; 1) Use `flymake-mode'. Type `M-x flymake-mode' in any Emacs Lisp
;; buffer; the checkdoc back-end is enabled by default.
;;
;; 2) Periodically use `checkdoc' or `checkdoc-current-buffer'. ;; 2) Periodically use `checkdoc' or `checkdoc-current-buffer'.
;; `checkdoc' is a more interactive version of ;; The `checkdoc' command is a more interactive version of
;; `checkdoc-current-buffer' ;; `checkdoc-current-buffer'.
;;
;; 3) Use `checkdoc-minor-mode' to automatically check your ;; 3) Use `checkdoc-minor-mode' to automatically check your
;; documentation whenever you evaluate Lisp code with C-M-x ;; documentation whenever you evaluate Lisp code with C-M-x
;; or [menu-bar emacs-lisp eval-buffer]. Additional key-bindings ;; or [menu-bar emacs-lisp eval-buffer]. Additional key-bindings
;; are also provided under C-c ? KEY ;; are also provided under C-c ? KEY
;; (add-hook 'emacs-lisp-mode-hook 'checkdoc-minor-mode) ;; (add-hook 'emacs-lisp-mode-hook 'checkdoc-minor-mode)
;; ;;
;; 4) Use `checkdoc-ispell' to spellcheck docstrings interactively.
;;
;; Using `checkdoc': ;; Using `checkdoc':
;; ;;
;; The commands `checkdoc' and `checkdoc-ispell' are the top-level ;; Most users will probably use checkdoc through `flymake'. The
;; entry points to all of the different checks that are available. It ;; commands `checkdoc' and `checkdoc-ispell' are the top-level entry
;; points to all of the different checks that are available. It
;; breaks examination of your Lisp file into four sections (comments, ;; breaks examination of your Lisp file into four sections (comments,
;; documentation, messages, and spacing) and indicates its current ;; documentation, messages, and spacing) and indicates its current
;; state in a status buffer. ;; state in a status buffer.
@ -66,7 +73,7 @@
;; interface offers several options, including the ability to skip to ;; interface offers several options, including the ability to skip to
;; the next error, or back up to previous errors. Auto-fixing is ;; the next error, or back up to previous errors. Auto-fixing is
;; turned off at this stage, but you can use the `f' or `F' key to fix ;; turned off at this stage, but you can use the `f' or `F' key to fix
;; a given error (if the fix is available.) ;; a given error (if the fix is available).
;; ;;
;; Auto-fixing: ;; Auto-fixing:
;; ;;
@ -99,6 +106,7 @@
;; install into Ispell on the fly, but only if Ispell is not already ;; install into Ispell on the fly, but only if Ispell is not already
;; running. Use `ispell-kill-ispell' to make checkdoc restart it with ;; running. Use `ispell-kill-ispell' to make checkdoc restart it with
;; these words enabled. ;; these words enabled.
;; See also the `flyspell-prog-mode' minor mode.
;; ;;
;; Checking parameters: ;; Checking parameters:
;; ;;
@ -176,6 +184,7 @@
"Support for doc string checking in Emacs Lisp." "Support for doc string checking in Emacs Lisp."
:prefix "checkdoc" :prefix "checkdoc"
:group 'lisp :group 'lisp
:link '(emacs-commentary-link "checkdoc.el")
:version "20.3") :version "20.3")
(defcustom checkdoc-minor-mode-string " CDoc" (defcustom checkdoc-minor-mode-string " CDoc"