[emacs][wip] break out Help and ElDoc

[~bandali/configs] / init.org

diff --git a/init.org b/init.org
index 4e3ee52..dc1e7dd 100644 (file)
--- a/init.org
+++ b/init.org
@@ -207,6 +207,13 @@ does that (and more).  See =straight-package-neutering-mode=.
 
 *** =straight.el=
 
 
 *** =straight.el=
 

+#+begin_quote
+Next-generation, purely functional package manager for the Emacs
+hacker.
+#+end_quote
+
+=straight.el= allows me to have a fully reproducible Emacs setup.
+

 #+begin_src emacs-lisp
 (setq straight-repository-branch "develop")
 
 #+begin_src emacs-lisp
 (setq straight-repository-branch "develop")
 


@@ -226,6 +233,19 @@ does that (and more).  See =straight-package-neutering-mode=.
 (setq straight-use-package-by-default t)
 #+end_src
 
 (setq straight-use-package-by-default t)
 #+end_src
 

+Since we enable =straight.el='s =straight-use-package-by-default=
+integration, we will define a =use-feature= for plain ole
+=use-package= without any of the =straight.el= stuff.
+
+#+begin_src emacs-lisp
+(defmacro use-feature (name &rest args)
+  "Like `use-package', but with `straight-use-package-by-default' disabled."
+  (declare (indent defun))
+  `(use-package ,name
+     :straight nil
+,@args))
+#+end_src
+

 *** COMMENT Borg
 
 #+begin_quote
 *** COMMENT Borg
 
 #+begin_quote


@@ -330,8 +350,7 @@ definitely don't want it mixing with =init.el=. So, here; let's give
 it it's own file. While at it, treat themes as safe.
 
 #+begin_src emacs-lisp
 it it's own file. While at it, treat themes as safe.
 
 #+begin_src emacs-lisp

-(use-package custom
-  :straight nil
+(use-feature custom

   :no-require t
   :config
   (setq custom-file (no-littering-expand-etc-file-name "custom.el"))
   :no-require t
   :config
   (setq custom-file (no-littering-expand-etc-file-name "custom.el"))


@@ -385,8 +404,7 @@ login; so starting the server from inside Emacs is good enough for me.
 See [[https://www.gnu.org/software/emacs/manual/html_node/emacs/Emacs-Server.html#Emacs-Server][Using Emacs as a Server]].
 
 #+begin_src emacs-lisp
 See [[https://www.gnu.org/software/emacs/manual/html_node/emacs/Emacs-Server.html#Emacs-Server][Using Emacs as a Server]].
 
 #+begin_src emacs-lisp

-(use-package server
-  :straight nil
+(use-feature server

   :defer 1
   :config (or (server-running-p) (server-mode)))
 #+end_src
   :defer 1
   :config (or (server-running-p) (server-mode)))
 #+end_src


@@ -804,8 +822,7 @@ We will use the =org-plus-contrib= package to get the whole deal:
 And here's where my actual Org configurations begin:
 
 #+begin_src emacs-lisp
 And here's where my actual Org configurations begin:
 
 #+begin_src emacs-lisp

-(use-package org
-  :straight nil
+(use-feature org

   :defer 0.5
   :config
   (setq org-src-tab-acts-natively t
   :defer 0.5
   :config
   (setq org-src-tab-acts-natively t


@@ -836,8 +853,7 @@ And here's where my actual Org configurations begin:
   '(org-block ((t (:background "#1d1f21"))))
   '(org-latex-and-related ((t (:foreground "#b294bb")))))
 
   '(org-block ((t (:background "#1d1f21"))))
   '(org-latex-and-related ((t (:foreground "#b294bb")))))
 

-(use-package ox-latex
-  :straight nil
+(use-feature ox-latex

   :after ox
   :config
   (setq org-latex-listings 'listings
   :after ox
   :config
   (setq org-latex-listings 'listings


@@ -854,13 +870,8 @@ And here's where my actual Org configurations begin:
                  ("\\subparagraph{%s}" . "\\subparagraph*{%s}"))
                t))
 
                  ("\\subparagraph{%s}" . "\\subparagraph*{%s}"))
                t))
 

-(use-package ox-beamer
-  :straight nil
+(use-feature ox-beamer

   :after ox)
   :after ox)

-
-(use-package orgalist
-  :after message
-  :hook (message-mode . orgalist-mode))

 #+end_src
 
 **** asynchronous tangle
 #+end_src
 
 **** asynchronous tangle


@@ -940,7 +951,19 @@ Not just how I do git, but /the/ way to do git.
   :custom-face (magit-diff-file-heading ((t (:weight normal)))))
 #+end_src
 
   :custom-face (magit-diff-file-heading ((t (:weight normal)))))
 #+end_src
 

-*** COMMENT [[https://github.com/abo-abo/swiper][Ivy]] (and friends)
+*** recentf
+
+Recently opened files.
+
+#+begin_src emacs-lisp
+(use-feature recentf
+  :defer 0.5
+  :config
+  (add-to-list 'recentf-exclude "^/\\(?:ssh\\|su\\|sudo\\)?:")
+  (setq recentf-max-saved-items 40))
+#+end_src
+
+*** [[https://github.com/abo-abo/swiper][Ivy]] (and friends)

 
 #+begin_quote
 Ivy - a generic completion frontend for Emacs, Swiper - isearch with
 
 #+begin_quote
 Ivy - a generic completion frontend for Emacs, Swiper - isearch with


@@ -953,7 +976,7 @@ There's no way I could top that, so I won't attempt to.
 
 #+begin_src emacs-lisp
 (use-package ivy
 
 #+begin_src emacs-lisp
 (use-package ivy

-  :defer 1
+  :defer 0.6

   :bind
   (:map ivy-minibuffer-map
    ([escape] . keyboard-escape-quit)
   :bind
   (:map ivy-minibuffer-map
    ([escape] . keyboard-escape-quit)


@@ -974,6 +997,7 @@ There's no way I could top that, so I won't attempt to.
 
 #+begin_src emacs-lisp
 (use-package swiper
 
 #+begin_src emacs-lisp
 (use-package swiper

+  :after ivy

   :bind (("C-s"   . swiper)
          ("C-r"   . swiper)
          ("C-S-s" . isearch-forward)))
   :bind (("C-s"   . swiper)
          ("C-r"   . swiper)
          ("C-S-s" . isearch-forward)))


@@ -983,7 +1007,7 @@ There's no way I could top that, so I won't attempt to.
 
 #+begin_src emacs-lisp
 (use-package counsel
 
 #+begin_src emacs-lisp
 (use-package counsel

-  :defer 1
+  :after ivy

   :bind (([remap execute-extended-command] . counsel-M-x)
          ([remap find-file]                . counsel-find-file)
          ("s-r"                            . counsel-recentf)
   :bind (([remap execute-extended-command] . counsel-M-x)
          ([remap find-file]                . counsel-find-file)
          ("s-r"                            . counsel-recentf)


@@ -996,10 +1020,10 @@ There's no way I could top that, so I won't attempt to.
   (defalias 'locate #'counsel-locate))
 #+end_src
 
   (defalias 'locate #'counsel-locate))
 #+end_src
 

-*** COMMENT eshell
+*** eshell

 
 #+begin_src emacs-lisp
 
 #+begin_src emacs-lisp

-(use-package eshell
+(use-feature eshell

   :defer 1
   :commands eshell
   :bind ("C-c a s e" . eshell)
   :defer 1
   :commands eshell
   :bind ("C-c a s e" . eshell)


@@ -1033,10 +1057,10 @@ There's no way I could top that, so I won't attempt to.
   (eshell-input-filter 'eshell-input-filter-initial-space))
 #+end_src
 
   (eshell-input-filter 'eshell-input-filter-initial-space))
 #+end_src
 

-*** COMMENT Ibuffer
+*** Ibuffer

 
 #+begin_src emacs-lisp
 
 #+begin_src emacs-lisp

-(use-package ibuffer
+(use-feature ibuffer

   :defer t
   :bind
   (("C-x C-b" . ibuffer-other-window)
   :defer t
   :bind
   (("C-x C-b" . ibuffer-other-window)


@@ -1104,10 +1128,10 @@ There's no way I could top that, so I won't attempt to.
   :hook (ibuffer . (lambda () (ibuffer-switch-to-saved-filter-groups "default"))))
 #+end_src
 
   :hook (ibuffer . (lambda () (ibuffer-switch-to-saved-filter-groups "default"))))
 #+end_src
 

-*** COMMENT Outline
+*** Outline

 
 #+begin_src emacs-lisp
 
 #+begin_src emacs-lisp

-(use-package outline
+(use-feature outline

   :defer t
   :hook (prog-mode . outline-minor-mode)
   :bind
   :defer t
   :hook (prog-mode . outline-minor-mode)
   :bind


@@ -1126,27 +1150,13 @@ There's no way I could top that, so I won't attempt to.
    ("s"   . outline-show-subtree)))
 #+end_src
 
    ("s"   . outline-show-subtree)))
 #+end_src
 

-* COMMENT Borg's =layer/essentials=
-:PROPERTIES:
-:CUSTOM_ID: borg-essentials
-:END:
-
-TODO: break this giant source block down into individual org sections.
+*** Dired

 
 #+begin_src emacs-lisp
 
 #+begin_src emacs-lisp

-(use-package dash
-  :config (dash-enable-font-lock))
-
-(use-package diff-hl
-  :config
-  (setq diff-hl-draw-borders nil)
-  (global-diff-hl-mode)
-  (add-hook 'magit-post-refresh-hook 'diff-hl-magit-post-refresh t))
-
-(use-package ls-lisp
+(use-feature ls-lisp

   :custom (ls-lisp-dirs-first t))
 
   :custom (ls-lisp-dirs-first t))
 

-(use-package dired
+(use-feature dired

   :defer t
   :config
   (setq dired-listing-switches "-alh"
   :defer t
   :config
   (setq dired-listing-switches "-alh"


@@ -1182,21 +1192,33 @@ TODO: break this giant source block down into individual org sections.
                         (interactive)
                         (a/dired-start-process "zathura"))))
   :hook (dired-mode . dired-hide-details-mode))
                         (interactive)
                         (a/dired-start-process "zathura"))))
   :hook (dired-mode . dired-hide-details-mode))

+#+end_src

 
 

-(use-package eldoc
-  :when (version< "25" emacs-version)
-  :config (global-eldoc-mode))
+*** Help

 
 

-(use-package help
+#+begin_src emacs-lisp
+(use-feature help

   :defer t
   :config
   (temp-buffer-resize-mode)
   (setq help-window-select t))
   :defer t
   :config
   (temp-buffer-resize-mode)
   (setq help-window-select t))

+#+end_src
+
+*** Borg's =layer/essentials=
+:PROPERTIES:
+:CUSTOM_ID: borg-essentials
+:END:
+
+TODO: break this giant source block down into individual org sections.
+
+#+begin_src emacs-lisp
+(use-package dash
+  :config (dash-enable-font-lock))

 
 (progn ;    `isearch'
   (setq isearch-allow-scroll t))
 
 
 (progn ;    `isearch'
   (setq isearch-allow-scroll t))
 

-(use-package lisp-mode
+(use-feature lisp-mode

   :config
   (add-hook 'emacs-lisp-mode-hook 'outline-minor-mode)
   (add-hook 'emacs-lisp-mode-hook 'reveal-mode)
   :config
   (add-hook 'emacs-lisp-mode-hook 'outline-minor-mode)
   (add-hook 'emacs-lisp-mode-hook 'reveal-mode)


@@ -1204,40 +1226,27 @@ TODO: break this giant source block down into individual org sections.
     (setq indent-tabs-mode nil))
   (add-hook 'lisp-interaction-mode-hook #'indent-spaces-mode))
 
     (setq indent-tabs-mode nil))
   (add-hook 'lisp-interaction-mode-hook #'indent-spaces-mode))
 

-(use-package man
+(use-feature man

   :defer t
   :config (setq Man-width 80))
 
   :defer t
   :config (setq Man-width 80))
 

-(use-package paren
+(use-feature paren

   :config (show-paren-mode))
 
   :config (show-paren-mode))
 

-(use-package prog-mode
+(use-feature prog-mode

   :config (global-prettify-symbols-mode)
   (defun indicate-buffer-boundaries-left ()
     (setq indicate-buffer-boundaries 'left))
   (add-hook 'prog-mode-hook #'indicate-buffer-boundaries-left))
 
   :config (global-prettify-symbols-mode)
   (defun indicate-buffer-boundaries-left ()
     (setq indicate-buffer-boundaries 'left))
   (add-hook 'prog-mode-hook #'indicate-buffer-boundaries-left))
 

-(use-package recentf
-  :defer 0.5
-  :config
-  (add-to-list 'recentf-exclude "^/\\(?:ssh\\|su\\|sudo\\)?:")
-  (setq recentf-max-saved-items 40))
-
-(use-package savehist
-  :config (savehist-mode))
-
-(use-package saveplace
-  :when (version< "25" emacs-version)
-  :config (save-place-mode))
-
-(use-package simple
+(use-feature simple

   :config (column-number-mode))
 
 (progn ;    `text-mode'
   (add-hook 'text-mode-hook #'indicate-buffer-boundaries-left)
   (add-hook 'text-mode-hook #'abbrev-mode))
 
   :config (column-number-mode))
 
 (progn ;    `text-mode'
   (add-hook 'text-mode-hook #'indicate-buffer-boundaries-left)
   (add-hook 'text-mode-hook #'abbrev-mode))
 

-(use-package tramp
+(use-feature tramp

   :defer t
   :config
   (add-to-list 'tramp-default-proxies-alist '(nil "\\`root\\'" "/ssh:%h:"))
   :defer t
   :config
   (add-to-list 'tramp-default-proxies-alist '(nil "\\`root\\'" "/ssh:%h:"))


@@ -1247,12 +1256,53 @@ TODO: break this giant source block down into individual org sections.
 
 #+end_src
 
 
 #+end_src
 

-* COMMENT Editing
+* Editing

 :PROPERTIES:
 :CUSTOM_ID: editing
 :END:
 
 :PROPERTIES:
 :CUSTOM_ID: editing
 :END:
 

-** Company
+** =diff-hl=
+
+Highlight uncommitted changes in the left fringe.
+
+#+begin_src emacs-lisp
+(use-package diff-hl
+  :config
+  (setq diff-hl-draw-borders nil)
+  (global-diff-hl-mode)
+  :hook (magit-post-refresh . diff-hl-magit-post-refresh))
+#+end_src
+
+** ElDoc
+
+Display Lisp objects at point in the echo area.
+
+#+begin_src emacs-lisp
+(use-feature eldoc
+  :when (version< "25" emacs-version)
+  :config (global-eldoc-mode))
+#+end_src
+
+** =savehist=
+
+Save minibuffer history.
+
+#+begin_src emacs-lisp
+(use-feature savehist
+  :config (savehist-mode))
+#+end_src
+
+** =saveplace=
+
+Automatically save place in each file.
+
+#+begin_src emacs-lisp
+(use-feature saveplace
+  :when (version< "25" emacs-version)
+  :config (save-place-mode))
+#+end_src
+
+** COMMENT Company

 
 #+begin_src emacs-lisp
 (use-package company
 
 #+begin_src emacs-lisp
 (use-package company


@@ -1906,6 +1956,14 @@ Make =*scratch*= and =*Messages*= unkillable.
 
 Also see [[https://www.emacswiki.org/emacs/rebox2][rebox2]].
 
 
 Also see [[https://www.emacswiki.org/emacs/rebox2][rebox2]].
 

+** orgalist
+
+#+begin_src emacs-lisp
+(use-package orgalist
+  :after message
+  :hook (message-mode . orgalist-mode))
+#+end_src
+

 ** typo.el
 
 #+begin_src emacs-lisp
 ** typo.el
 
 #+begin_src emacs-lisp