[Emacs] Update config and comments for Elfeed and pdf-tools

org/config/emacs.org

@@ -1,4 +1,4 @@
-#+title: Vanilla Emacs Configuration
+#+title: Emacs Configuration
 #+setupfile: ~/org/config/headers
 #+options: auto-id:t
 #+html_head: <meta name="description" content="Phundrak’s Emacs Configuration" />
@@ -1141,16 +1141,23 @@ docker-compose from Emacs.
 :PROPERTIES:
 :CUSTOM_ID: Packages-Configuration-Applications-Elfeedoip0fl6184j0
 :END:
+Elfeed is a nice Atom and RSS reader for Emacs. The only thing I want
+to change for now is the default search filter: I want to see not only
+unread news but read news as well, a bit like my emails; and where the
+database is to be stored.
 #+begin_src emacs-lisp
 (use-package elfeed
   :defer t
   :straight (:build t)
   :custom
-  (elfeed-search-filter "@6-months-ago")
-  :config
-  (elfeed-goodies/setup))
+  ((elfeed-search-filter "@6-months-ago")
+   (elfeed-db-directory  (expand-file-name ".elfeed-db"
+                                           user-emacs-directory))))
 #+end_src
 
+Elfeed-goodies is a package which enhances the Elfeed experience.
+Aside from running its setup command as soon as possible, I also set
+in this code block all my keybinds for Elfeed here.
 #+begin_src emacs-lisp
 (use-package elfeed-goodies
   :defer t
@@ -1189,6 +1196,7 @@ docker-compose from Emacs.
    "«"  #'elfeed-search-first-entry
    "»"  #'elfeed-search-last-entry
    "b"  #'elfeed-search-browse-url
+   "c"  #'elfeed-db-compact
    "f"  '(nil :which-key "filter")
    "fc" #'elfeed-search-clear-filter
    "fl" #'elfeed-search-live-filter
@@ -1199,11 +1207,15 @@ docker-compose from Emacs.
    "tT" #'elfeed-search-tag-all
    "tU" #'elfeed-search-untag-all
    "u"  '(nil :which-key "update")
-   "uf" #'elfeed-search-fetch
-   "uF" #'elfeed-search-update
+   "us" #'elfeed-search-fetch
+   "uS" #'elfeed-search-update
+   "uu" #'elfeed-update
+   "uU" #'elfeed-search-update--force
    "y"  #'elfeed-search-yank))
 #+end_src
 
+Last but not least, my Elfeed configuration is stored in an org file
+thanks to ~elfeed-org~.
 #+begin_src emacs-lisp
 (use-package elfeed-org
   :defer t
@@ -1899,6 +1911,11 @@ reader?
 :PROPERTIES:
 :CUSTOM_ID: Packages-Configuration-Applications-PDF-Toolsvqb1fl6184j0
 :END:
+~pdf-tools~ enables PDF support for Emacs, much better than its built-in
+support with DocView. Aside from the classical settings such as
+keybinds, I also enable the midnight colors by default; think of it as
+an equivalent of Zathura’s recolor feature which kind of enables a
+dark mode for PDFs.
 #+begin_src emacs-lisp
 (use-package pdf-tools
   :defer t
@@ -1906,24 +1923,17 @@ reader?
   :straight (:build t)
   :mode (("\\.pdf\\'" . pdf-view-mode))
   :hook (pdf-tools-enabled . pdf-view-midnight-minor-mode)
-  :config
-  (progn
-    (with-eval-after-load 'pdf-view
-      (setq pdf-view-midnight-colors '("#d8dee9" . "#2e3440")))
-    (general-define-key
-     :keymaps 'pdf-view-mode-map
+  :general
+  (:keymaps 'pdf-view-mode-map
+   :states '(normal emacs)
    "SPC" nil
    ","   nil)
-    (general-define-key
-     :states 'normal
+  (:states 'normal
    :keymaps 'pdf-view-mode-map
-     "SPC" nil
-     ","   nil
    "y"   #'pdf-view-kill-ring-save
    "t"   #'evil-collection-pdf-view-next-line-or-next-page
    "s"   #'evil-collection-pdf-view-previous-line-or-previous-page)
-    (general-define-key
-     :states 'motion
+  (:states '(normal motion)
    :keymaps 'pdf-view-mode-map
    :prefix ","
     "a"  '(nil :which-key "annotations")
@@ -1949,9 +1959,15 @@ reader?
     "ss" #'pdf-occur
 
     "o"  'pdf-outline
-      "m"  'pdf-view-midnight-minor-mode)))
+    "m"  'pdf-view-midnight-minor-mode)
+  :config
+  (with-eval-after-load 'pdf-view
+    (setq pdf-view-midnight-colors '("#d8dee9" . "#2e3440"))))
 #+end_src
 
+One thing ~pdf-tools~ doesn’t handle is restoring the PDF to the last
+point it was visited --- in other words, open the PDF where I last
+left it.
 #+begin_src emacs-lisp
 (use-package pdf-view-restore
   :after pdf-tools