diff --git a/core/core-popup.el b/core/core-popup.el
index 9eeb80399..45231deac 100644
--- a/core/core-popup.el
+++ b/core/core-popup.el
@@ -63,8 +63,8 @@
 (after! help-mode
   ;; Following links in help buffers sometimes uses itself or other-window
   ;; (annoying!). It should only replace the buffer we opened the popup from. To
-  ;; fix this these three button types need to be redefined to stow away the
-  ;; popups then follow the link from the last buffer, using `doom/popup-save'.
+  ;; fix this these three button types need to be redefined so that the right
+  ;; window is in focus before the link is followed.
   (define-button-type 'help-function-def
     :supertype 'help-xref
     'help-function (lambda (fun file)
diff --git a/core/core.el b/core/core.el
index a0384e044..19a183ddf 100644
--- a/core/core.el
+++ b/core/core.el
@@ -8,8 +8,8 @@
 ;;   doom:...     An ex command
 ;;   doom|...     A hook
 ;;   doom*...     An advising function
-;;   doom....     Custom prefix commands
 ;;   ...!         Macro, shortcut alias or subst defun
+;;   @...         Autoloaded interactive lambda macro for keybinds
 ;;
 ;;; Autoloaded functions are in {core,modules}/defuns/defuns-*.el