 ;;; core-packages.el
 
-;; Emacs is opinionated about package management. Unfortunately, so am I. So I
-;; combined use-package, quelpa and package.el to manage my plugins.
+;; Emacs package management is opinionated. Unfortunately, so am I. So I
+;; combined `use-package`, quelpa and package.el to manage my plugins.
 ;;
 ;; Why all the trouble? Because:
 ;; 1. Scriptability: I want my plugins managable from the command line (as well
-;;    as an 'update-all-packages' command within emacs to update my plugins
-;;    automatically, rather than through package.el's clunky interface).
+;;    as an `doom/packages-update' command within emacs to update my plugins
+;;    automatically, rather than through package.el's interface).
 ;; 2. Flexibility: I want to install packages from sources other than ELPA
 ;;    repositories. Such as github or the Emacs wiki. Some plugins are out of
 ;;    date through official channels, have changed hands unofficially, or simply

;;

(defun doom-package-outdated-p (package)
  "Determine whether PACKAGE (a symbol) is outdated or not. Be sure to run
`package-refresh-contents' beforehand, or the return value could be out of
date."
  (let ((pkg (assq package doom-packages)))

        (message "There were %s errors" err)))))

(defun doom/packages-clean ()
  "Delete packages that are no longer used or depended on."
  (interactive)
  (let* ((package-selected-packages (-intersection (package--find-non-dependencies)
                                                   (mapcar 'car doom-packages)))
