docs: docstring & comment revisions

For `undefadvice!`, `doom-load-theme-hook`, and the `ws-butler` package.
This commit is contained in:
Henrik Lissner
2025-04-02 17:01:54 -04:00
parent 625b793218
commit 5fae69b7bf
3 changed files with 10 additions and 7 deletions

View File

@ -1004,8 +1004,8 @@ DOCSTRING and BODY are as in `defun'.
(defmacro undefadvice! (symbol _arglist &optional docstring &rest body)
"Undefine an advice called SYMBOL.
This has the same signature as `defadvice!' an exists as an easy undefiner when
testing advice (when combined with `rotate-text').
This has the same signature as `defadvice!' and exists as an easy undefiner when
interactively testing (and toggling) advice.
\(fn SYMBOL ARGLIST &optional DOCSTRING &rest [WHERE PLACES...] BODY\)"
(declare (doc-string 3) (indent defun))

View File

@ -81,8 +81,11 @@ want to change your symbol font, use `doom-symbol-font'.")
"List of hooks to run when the UI has been initialized.")
(defcustom doom-load-theme-hook nil
"Hook run after the theme is loaded with `load-theme' or reloaded with
`doom/reload-theme'.")
"Hook run after a color-scheme is loaded.
Triggered by `load-theme', `enable-theme', or reloaded with `doom/reload-theme',
but only for themes that declare themselves as a :kind color-scheme (which Doom
treats as the default).")
(defcustom doom-switch-buffer-hook nil
"A list of hooks run after changing the current buffer.")

View File

@ -32,9 +32,9 @@
(package! dtrt-indent :pin "22498ca24ac93c051d233abef630aece1ac45dd1")
(package! smartparens :pin "b0d935c11813bcd40f8d35bae8800e0741334c29")
(package! ws-butler
;; REVIEW: Nongnu elpa serves this package from a branch of the nongnu_elpa
;; repo; to stop Straight from clobbering a single repo, we must be
;; explicit.
;; REVIEW: emacsmirror/nongnu_elpa serves this package from a branch. To stop
;; Straight from clobbering a single repo for multiple packages, we must be
;; explicit to force it to clone it multiple times.
:recipe (:host github
:repo "emacsmirror/nongnu_elpa"
:branch "elpa/ws-butler"