From 527079094dc09b1aadd311c0d88ee393798a330f Mon Sep 17 00:00:00 2001 From: Henrik Lissner Date: Fri, 12 Jul 2019 14:16:53 +0200 Subject: [PATCH] Expand docs for doom {install,update,autoremove} --- core/cli/packages.el | 16 +++++++++++++--- 1 file changed, 13 insertions(+), 3 deletions(-) diff --git a/core/cli/packages.el b/core/cli/packages.el index 02ca80ac8..661186a50 100644 --- a/core/cli/packages.el +++ b/core/cli/packages.el @@ -31,15 +31,25 @@ (dispatcher! (install i) (doom--ensure-autoloads-while #'doom-packages-install) - "Installs packages that aren't installed.") + "Installs wanted packages that aren't installed. + +Package management in Doom is declarative. A `package!' declaration in an +enabled module or your private packages.el marks a package as 'wanted'.") (dispatcher! (update u) (doom--ensure-autoloads-while #'doom-packages-update) - "Updates packages.") + "Updates packages. + +This excludes packages whose `package!' declaration contains a non-nil :freeze +or :ignore property.") (dispatcher! (autoremove r) (doom--ensure-autoloads-while #'doom-packages-autoremove) - "Removes packages that are no longer needed.") + "Removes packages that are no longer needed. + +This includes packages installed with 'M-x package-install' without an +accompanying `package!' declaration in an enabled module's packages.el file or +your private one.") ;;