summaryrefslogtreecommitdiff
path: root/modules
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2025-08-13 12:00:44 -0500
committerCraig Jennings <c@cjennings.net>2025-08-13 12:00:44 -0500
commitef9602052894e97f8bd8abba7306169caf5c5ee8 (patch)
treead247a67585eb3136b7e2ec36fd0cef1e7670fb2 /modules
parent1946bb85d352ddf36b1c2a4fc6f19e0f06eb812d (diff)
downloaddotemacs-ef9602052894e97f8bd8abba7306169caf5c5ee8.tar.gz
dotemacs-ef9602052894e97f8bd8abba7306169caf5c5ee8.zip
splitting help into config (internal) and utils (added packages)
Diffstat (limited to 'modules')
-rw-r--r--modules/help-config.el63
-rw-r--r--modules/help-utils.el55
2 files changed, 64 insertions, 54 deletions
diff --git a/modules/help-config.el b/modules/help-config.el
new file mode 100644
index 00000000..2dde38b2
--- /dev/null
+++ b/modules/help-config.el
@@ -0,0 +1,63 @@
+;;; help-config --- Help Functionality Configuration -*- lexical-binding: t; -*-
+;; author Craig Jennings <c@cjennings.net>
+
+;;; Commentary:
+
+;;; Code:
+
+
+(setq help-window-select t) ;; Always select the help buffer in a separate window
+
+(global-set-key (kbd "C-h P") 'list-packages) ;; bring up the package menu
+
+;; ---------------------------------- Helpful ----------------------------------
+
+(use-package helpful
+ :defer .5
+ :bind
+ ("C-h f" . helpful-callable)
+ ("C-h v" . helpful-variable)
+ ("C-h k" . helpful-key)
+ ("C-h F" . helpful-function)
+ ("C-h C" . helpful-command)
+ ("C-h ." . helpful-at-point)
+ ("C-h o" . helpful-symbol) ;; overrides 'describe-symbol' keybinding
+ :config
+ (setq counsel-describe-function-function #'helpful-callable)
+ (setq counsel-describe-variable-function #'helpful-variable))
+
+
+;; ------------------------------------ Man ------------------------------------
+
+(use-package man
+ :defer 1
+ :ensure nil ;; built-in
+ :bind ("C-h M" . man))
+
+
+;; ------------------------------------ Info -----------------------------------
+
+(use-package info
+ :defer 1
+ :ensure nil ;; built-in
+ :bind
+ (:map Info-mode-map
+ ("m" . bookmark-set) ;; note:overrides menu selection
+ ("M" . Info-menu)) ;; so menu selection goes here
+ :preface
+ (defun open-with-info-mode ()
+ (interactive)
+ (let ((file-name (buffer-file-name)))
+ (kill-buffer (current-buffer))
+ (info file-name)))
+ :hook
+ (info-mode . info-persist-history-mode)
+ :init
+ ;; add personal info files in emacs config assets directory
+ ;; BUG: This causes an error on launch
+ (push (concat user-emacs-directory "assets/info") Info-directory-list)
+ (add-to-list 'auto-mode-alist '("\\.info\\'" . open-with-info-mode)))
+
+
+(provide 'help-config)
+;;; help-utils.el ends here
diff --git a/modules/help-utils.el b/modules/help-utils.el
index ab9f2855..73fc2add 100644
--- a/modules/help-utils.el
+++ b/modules/help-utils.el
@@ -1,63 +1,10 @@
-;;; help-utils --- Help Additions and Preferences -*- lexical-binding: t; -*-
+;;; help-utils --- Help Integrations and Searches -*- lexical-binding: t; -*-
;; author Craig Jennings <c@cjennings.net>
;;; Commentary:
;;; Code:
-
-(setq help-window-select t) ;; Always select the help buffer in a separate window
-
-(global-set-key (kbd "C-h P") 'list-packages) ;; bring up the package menu
-
-;; ---------------------------------- Helpful ----------------------------------
-
-(use-package helpful
- :defer .5
- :bind
- ("C-h f" . helpful-callable)
- ("C-h v" . helpful-variable)
- ("C-h k" . helpful-key)
- ("C-h F" . helpful-function)
- ("C-h C" . helpful-command)
- ("C-h ." . helpful-at-point)
- ("C-h o" . helpful-symbol) ;; overrides 'describe-symbol' keybinding
- :config
- (setq counsel-describe-function-function #'helpful-callable)
- (setq counsel-describe-variable-function #'helpful-variable))
-
-
-;; ------------------------------------ Man ------------------------------------
-
-(use-package man
- :defer 1
- :ensure nil ;; built-in
- :bind ("C-h M" . man))
-
-
-;; ------------------------------------ Info -----------------------------------
-
-(use-package info
- :defer 1
- :ensure nil ;; built-in
- :bind
- (:map Info-mode-map
- ("m" . bookmark-set) ;; note:overrides menu selection
- ("M" . Info-menu)) ;; so menu selection goes here
- :preface
- (defun open-with-info-mode ()
- (interactive)
- (let ((file-name (buffer-file-name)))
- (kill-buffer (current-buffer))
- (info file-name)))
- :hook
- (info-mode . info-persist-history-mode)
- :init
- ;; add personal info files in emacs config assets directory
- ;; BUG: This causes an error on launch
- (push (concat user-emacs-directory "assets/info") Info-directory-list)
- (add-to-list 'auto-mode-alist '("\\.info\\'" . open-with-info-mode)))
-
;; ---------------------------------- Devdocs ----------------------------------
(use-package devdocs