General cleanup

core/core-packages.el

@@ -4,11 +4,18 @@
 ;; together `use-package', `quelpa' and package.el to create my own,
 ;; rolling-release, lazily-loaded package management system for Emacs.
 ;;
-;; The three key commands are `doom/packages-install', `doom/packages-update'
+;; The three key commands are:
-;; and `doom/packages-autoremove', which can be called via 'make' on the command
+;;
-;; line (make {install,update,autoremove}). These read packages.el files in each
+;; + `make install` or `doom/packages-install': Installs packages that are
-;; activated module in `doom-modules-dir' (and one in `doom-core-dir') which
+;;   wanted, but not installed.
-;; tell DOOM what plugins to install and where from.
+;; + `make update` or `doom/packages-update': Updates packages that are
+;;   out-of-date.
+;; + `make autoremove` or `doom/packages-autoremove': Uninstalls packages that
+;;   are no longer needed.
+;;
+;; This system reads packages.el files located in each activated module (and one
+;; in `doom-core-dir'). These contain `package!` blocks that tell DOOM what
+;; plugins to install and where from.
 ;;
 ;; Why all the trouble? Because:
 ;; 1. Scriptability: I live in the command line. I want a programmable
@@ -613,7 +620,7 @@ If ONLY-RECOMPILE-P is non-nil, only recompile out-of-date files."
   "Recompile any out-of-date compiled *.el files in your Emacs configuration."
   (interactive)
   (doom/compile nil :recompile)
-  ;; In case `load-path' has changed (e.g. after an update)
+  ;; Forcibly recompile core.el in case `load-path' has changed
   (byte-recompile-file (expand-file-name "core.el" doom-core-dir) t))
 
 (defun doom/reset ()

init.example.el

@@ -42,7 +42,7 @@
       ;debug           ; FIXME stepping through code, to help you add bugs
 
        :completion
-       company         ; code completion backend
+       company         ; the ultimate code completion backend
        ivy             ; a search engine for love and life
       ;helm            ; the *other* search engine for love and life
       ;ido             ; the other *other* search engine...
@@ -117,9 +117,10 @@
       ;org-publish     ; TODO org + blogs
 
        ;; Applications are complex and opinionated modules that transform Emacs
-       ;; toward a specific purpose. They should be loaded last.
+       ;; toward a specific purpose. They may have additional dependencies and
+       ;; should be loaded last.
        :app
-       email           ; Emacs as an email client
+       email           ; emacs as an email client
        irc             ; how neckbeards socialize
        rss             ; emacs as an RSS reader
        twitter         ; twitter client https://twitter.com/vnought

modules/private/hlissner/+bindings.el

@@ -699,7 +699,7 @@
     (evilem-default-keybindings prefix)
     (evilem-define (kbd (concat prefix " n")) #'evil-ex-search-next)
     (evilem-define (kbd (concat prefix " N")) #'evil-ex-search-previous)
-    (evilem-define (kbd (concat prefix " s")) 'evil-snipe-repeat
+    (evilem-define (kbd (concat prefix " s")) #'evil-snipe-repeat
                    :pre-hook (save-excursion (call-interactively #'evil-snipe-s))
                    :bind ((evil-snipe-scope 'buffer)
                           (evil-snipe-enable-highlight)