From: John Wiegley <johnw@newartisans.com>
Date: Wed, 6 Dec 2017 19:53:21 +0000 (-0800)
Subject: Add documentation for `use-package-report'
X-Git-Tag: emacs-29.0.90~1306^2~15^2~113
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=71fc224961510a56baff2e4686ccca484824f58d;p=emacs.git

Add documentation for `use-package-report'
---

diff --git a/lisp/use-package/use-package-core.el b/lisp/use-package/use-package-core.el
index fd7d56b271d..517671b87f1 100644
--- a/lisp/use-package/use-package-core.el
+++ b/lisp/use-package/use-package-core.el
@@ -863,6 +863,13 @@ representing symbols (that may need to be autloaded)."
   (setq use-package-statistics (make-hash-table)))
 
 (defun use-package-report ()
+  "Show current statistics gathered about use-package declarations.
+In the table that's generated, the status field has the following
+meaning:
+  Configured        :config has been processed (the package is loaded!)
+  Initialized       :init has been processed (load status unknown)
+  Prefaced          :preface has been processed
+  Declared          the use-package declaration was seen"
   (interactive)
   (with-current-buffer (get-buffer-create "*use-package statistics*")
     (delete-region (point-min) (point-max))