emenel/doomemacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

core-packages: update docstrings

Browse source
This commit is contained in:
Henrik Lissner 2017-01-31 19:42:41 -05:00
parent a8010d25b3
commit b42d116e01
1 changed files with 10 additions and 8 deletions
Download patch file Download diff file Expand all files Collapse all files

18
core/core-packages.el
View file

@ -1,12 +1,12 @@
;;; core-packages.el ;;; core-packages.el
;; Emacs is opinionated about package management. Unfortunately, so am I. So I ;; Emacs package management is opinionated. Unfortunately, so am I. So I
;; combined use-package, quelpa and package.el to manage my plugins. ;; combined `use-package`, quelpa and package.el to manage my plugins.
;; ;;
;; Why all the trouble? Because: ;; Why all the trouble? Because:
;; 1. Scriptability: I want my plugins managable from the command line (as well ;; 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 ;; as an `doom/packages-update' command within emacs to update my plugins
;; automatically, rather than through package.el's clunky interface). ;; automatically, rather than through package.el's interface).
;; 2. Flexibility: I want to install packages from sources other than ELPA ;; 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 ;; repositories. Such as github or the Emacs wiki. Some plugins are out of
;; date through official channels, have changed hands unofficially, or simply ;; date through official channels, have changed hands unofficially, or simply
@ -192,7 +192,9 @@ Examples:
;; ;;
(defun doom-package-outdated-p (package) (defun doom-package-outdated-p (package)
"Determine whether PACKAGE (a symbol) is outdated or not. Be sure to run "Determine whether PACKAGE (a symbol) is outdated or not. If outdated, returns
a cons cell, whose car is the current version string of PACKAGE (a symbol), and
whose cdr is the latest version of the package. Be sure to run
`package-refresh-contents' beforehand, or the return value could be out of `package-refresh-contents' beforehand, or the return value could be out of
date." date."
(let ((pkg (assq package doom-packages))) (let ((pkg (assq package doom-packages)))
@ -227,8 +229,8 @@ or make clean outside of Emacs."
(load (concat doom-emacs-dir "init.el")))) (load (concat doom-emacs-dir "init.el"))))
(defun doom/packages-update () (defun doom/packages-update ()
"Update outdated packages. This includes quelpa itself, quelpa-installed "Update outdated packages. This includes quelpa-installed packages and ELPA
packages, and ELPA packages. This will delete old versions of packages as well." packages. This will delete old versions of packages as well."
(interactive) (interactive)
(package-refresh-contents) (package-refresh-contents)
(package-read-all-archive-contents) (package-read-all-archive-contents)
@ -284,7 +286,7 @@ packages, and ELPA packages. This will delete old versions of packages as well."
(message "There were %s errors" err))))) (message "There were %s errors" err)))))
(defun doom/packages-clean () (defun doom/packages-clean ()
"Delete packages that are no longer used or referred to." "Delete packages that are no longer used or depended on."
(interactive) (interactive)
(let* ((package-selected-packages (-intersection (package--find-non-dependencies) (let* ((package-selected-packages (-intersection (package--find-non-dependencies)
(mapcar 'car doom-packages))) (mapcar 'car doom-packages)))