Revise docstrings & minor reformatting

core/autoload/scratch.el

@@ -98,7 +98,7 @@ following:
 
 ;;;###autoload
 (defun doom/open-scratch-buffer (&optional arg project-p)
-  "Opens the (persistent) scratch buffer in a popup.
+  "Pop up a persistent scratch buffer.
 
 If passed the prefix ARG, switch to it in the current window.
 If PROJECT-P is non-nil, open a persistent scratch buffer associated with the

modules/config/default/autoload/search.el

@@ -46,7 +46,7 @@ If prefix ARG is set, prompt for a known project to search from."
 
 ;;;###autoload
 (defun +default/search-project-for-symbol-at-point (&optional arg symbol)
-  "Conduct a text search in the current project for symbol at point.
+  "Search current project for symbol at point.
 If prefix ARG is set, prompt for a known project to search from."
   (interactive
    (list current-prefix-arg

modules/editor/evil/autoload/evil.el

@@ -76,13 +76,21 @@ the only window, use evil-window-move-* (e.g. `evil-window-move-far-left')."
       (select-window that-window))))
 
 ;;;###autoload
-(defun +evil/window-move-left () "See `+evil--window-swap'"  (interactive) (+evil--window-swap 'left))
+(defun +evil/window-move-left ()
+  "Swap windows to the left."
+  (interactive) (+evil--window-swap 'left))
 ;;;###autoload
-(defun +evil/window-move-right () "See `+evil--window-swap'" (interactive) (+evil--window-swap 'right))
+(defun +evil/window-move-right ()
+  "Swap windows to the right"
+  (interactive) (+evil--window-swap 'right))
 ;;;###autoload
-(defun +evil/window-move-up () "See `+evil--window-swap'"    (interactive) (+evil--window-swap 'up))
+(defun +evil/window-move-up ()
+  "Swap windows upward."
+  (interactive) (+evil--window-swap 'up))
 ;;;###autoload
-(defun +evil/window-move-down () "See `+evil--window-swap'"  (interactive) (+evil--window-swap 'down))
+(defun +evil/window-move-down ()
+  "Swap windows downward."
+  (interactive) (+evil--window-swap 'down))
 
 ;;;###autoload
 (defun +evil/easymotion ()

modules/tools/debugger/config.el

@@ -1,20 +1,20 @@
 ;;; tools/debugger/config.el -*- lexical-binding: t; -*-
 
 (defvar +debugger--realgud-alist
-  '((realgud:zshdb     :modes (sh-mode))
+  '((realgud:bashdb    :modes (sh-mode))
-    (realgud:kshdb     :modes (sh-mode))
-    (realgud:rdebug    :modes (ruby-mode enh-ruby-mode))
-    (realgud:pdb       :modes (python-mode))
-    (realgud:trepan2   :modes (python-mode))
-    (realgud:gub       :modes (go-mode))
     (realgud:gdb)
-    (realgud:trepan    :modes (perl-mode perl6-mode))
+    (realgud:gub       :modes (go-mode))
-    (realgud:trepanpl  :modes (perl-mode perl6-mode))
+    (realgud:kshdb     :modes (sh-mode))
-    (realgud:trepanjs  :modes (javascript-mode js2-mode js3-mode))
+    (realgud:pdb       :modes (python-mode))
+    (realgud:perldb    :modes (perl-mode perl6-mode))
+    (realgud:rdebug    :modes (ruby-mode enh-ruby-mode))
     (realgud:remake)
+    (realgud:trepan    :modes (perl-mode perl6-mode))
+    (realgud:trepan2   :modes (python-mode))
     (realgud:trepan3k  :modes (python-mode))
-    (realgud:bashdb    :modes (sh-mode))
+    (realgud:trepanjs  :modes (javascript-mode js2-mode js3-mode))
-    (realgud:perldb    :modes (perl-mode perl6-mode))))
+    (realgud:trepanpl  :modes (perl-mode perl6-mode))
+    (realgud:zshdb     :modes (sh-mode))))
 
 
 ;;

modules/ui/popup/autoload/popup.el

@@ -394,8 +394,8 @@ This window parameter is ignored if FORCE-P is non-nil."
 
 ;;;###autoload
 (defun +popup/toggle ()
-  "If popups are open, close them. If they aren't, restore the last one or open
+  "Toggle any visible popups.
-the message buffer in a popup window."
+If no popups are available, display the *Messages* buffer in a popup window."
   (interactive)
   (let ((+popup--inhibit-transient t))
     (cond ((+popup-windows) (+popup/close-all t))

modules/ui/workspaces/autoload/workspaces.el

@@ -342,7 +342,8 @@ end of the workspace list."
 ;;;###autoload
 (dotimes (i 9)
   (defalias (intern (format "+workspace/switch-to-%d" i))
-    (lambda () (interactive) (+workspace/switch-to i))))
+    (lambda () (interactive) (+workspace/switch-to i))
+    (format "Switch to workspace #%d" (1+ i))))
 
 ;;;###autoload
 (defun +workspace/switch-to-final ()