emacs-27 cbe6431: Improve Package Menu hiding docstrings

[Stefan Kangas]

branch: emacs-27
commit cbe643104d10b088ff0675af15fe8126914b6d5a
Author: Stefan Kangas <address@hidden>
Commit: Stefan Kangas <address@hidden>

    Improve Package Menu hiding docstrings
    
    * lisp/emacs-lisp/package.el (package-menu-toggle-hiding): Add
    reference to 'package-menu-hidden-regexps'.
    * lisp/emacs-lisp/package.el (package-menu-hide-package): Improve
    docstring to say that hiding is saved in a user option.  Fix a
    typo.  (Bug#39436)
---
 lisp/emacs-lisp/package.el | 20 ++++++++++++++++----
 1 file changed, 16 insertions(+), 4 deletions(-)

diff --git a/lisp/emacs-lisp/package.el b/lisp/emacs-lisp/package.el
index a55d6a3..7af4024 100644
--- a/lisp/emacs-lisp/package.el
+++ b/lisp/emacs-lisp/package.el
@@ -2870,7 +2870,11 @@ Can be toggled with \\<package-menu-mode-map> 
\\[package-menu-toggle-hiding].
 Installed obsolete packages are always displayed.")
 
 (defun package-menu-toggle-hiding ()
-  "In Package Menu, toggle visibility of obsolete available packages."
+  "In Package Menu, toggle visibility of obsolete available packages.
+
+Also hide packages whose name matches a regexp in user option
+`package-hidden-regexps' (a list).  To add regexps to this list,
+use `package-menu-hide-package'."
   (interactive)
   (package--ensure-package-menu-mode)
   (setq package-menu--hide-packages
@@ -3187,8 +3191,16 @@ function.  The args ARG and NOCONFIRM, passed from
 
 (defun package-menu-hide-package ()
   "Hide in Package Menu packages that match a regexp.
-Prompts for the regexp to match against package names.
-The default regexp will hide only the package whose name is at point."
+Prompt for the regexp to match against package names.
+The default regexp will hide only the package whose name is at point.
+
+The regexp is added to the list in the user option
+`package-hidden-regexps' and saved for future sessions.
+
+To unhide a package, type
+`\\[customize-variable] RET package-hidden-regexps'.
+
+Type \\[package-menu-toggle-hiding] to toggle package hiding."
   (interactive)
   (package--ensure-package-menu-mode)
   (declare (interactive-only "change `package-hidden-regexps' instead."))
@@ -3207,7 +3219,7 @@ The default regexp will hide only the package whose name 
is at point."
                              package-archive-contents)))
       (message "Packages to hide: %d.  Type `%s' to toggle or `%s' to 
customize"
                (length hidden)
-               (substitute-command-keys "\\[package-menu-toggle-hidding]")
+               (substitute-command-keys "\\[package-menu-toggle-hiding]")
                (substitute-command-keys "\\[customize-variable] RET 
package-hidden-regexps")))))