branch: externals/setup
commit f8d3ca8adb36796b106687623be701d19fdd1f9b
Author: Philip Kaludercic <phil...@posteo.net>
Commit: Philip Kaludercic <phil...@posteo.net>
Update commentary section
---
setup.el | 26 +++++++++++++++++---------
1 file changed, 17 insertions(+), 9 deletions(-)
diff --git a/setup.el b/setup.el
index a7c309d..28370cc 100644
--- a/setup.el
+++ b/setup.el
@@ -25,7 +25,9 @@
;;; Commentary:
;; The `setup` macro simplifies repetitive configuration patterns, by
-;; providing context-sensitive local macros in `setup` bodies.
+;; providing context-sensitive local macros in `setup` bodies. These
+;; macros can be mixed with regular elisp code without any issues,
+;; allowing for flexible and terse configurations.
;;
;; For example, these macros:
@@ -38,38 +40,44 @@
;; (:also-load dired-x)
;; (:option (prepend dired-guess-shell-alist-user) '("" "xdg-open")
;; dired-dwim-target t)
-;; (:hook auto-revert-mode))
+;; (unless global-auto-revert-mode
+;; (:hook auto-revert-mode)))
;;
;; (setup (:package paredit)
;; (:hide-mode)
+;; (setq paredit-override-check-parens-function (lambda (_) t))
;; (:hook-into scheme-mode lisp-mode))
-;; will be replaced with the functional equivalent of
+;; expanded to the to the functional equivalent of
+
+;; (let ((key "C-c s"))
+;; (global-set-key (kbd key) #'shell)
+;; (with-eval-after-load 'shell
+;; (define-key shell-mode-map (kbd key) #'bury-buffer)))
-;; (global-set-key (kbd "C-c s") #'shell)
-;; (with-eval-after-load 'shell
-;; (define-key shell-mode-map (kbd "C-c s") #'bury-buffer))
-;;
;; (with-eval-after-load 'dired
;; (require 'dired-x))
;; (customize-set-variable 'dired-guess-shell-alist-user
;; (cons '("" "xdg-open")
;; dired-guess-shell-alist-user))
;; (customize-set-variable 'dired-dwim-target t)
-;; (add-hook 'dired-mode-hook #'auto-revert-mode)
+;; (unless global-auto-revert-mode
+;; (add-hook 'dired-mode-hook #'auto-revert-mode))
;;
;; (unless (package-install-p 'paredit)
;; (package-install 'paredit))
;; (setq minor-mode-alist
;; (delq (assq 'paredit-mode minor-mode-alist)
;; minor-mode-alist))
+;; (setq paredit-override-check-parens-function (lambda (_) t))
;; (add-hook 'scheme-mode-hook #'paredit-mode)
;; (add-hook 'lisp-mode-hook #'paredit-mode)
;; Additional "keywords" can be defined using `setup-define'. All
;; known keywords are documented in the docstring for `setup'.
-;; More information can be found here: https://www.emacswiki.org/emacs/SetupEl
+;; More information can be found on Emacs Wiki:
+;; https://www.emacswiki.org/emacs/SetupEl
;;; Code:
