bug#39436: 27.0.60; Documentaion error for package-menu-hide-package

[Eli Zaretskii <eliz@gnu.org>]

> Date: Wed, 5 Feb 2020 16:10:55 +0100
> From: Pieter van Oostrum <pieter@vanoostrum.org>
> 
> The documentation (C-h f) for package-menu-hide-package says:
> 
> """
> Hide a package under point in Package Menu.
> If optional arg BUTTON is non-nil, describe its associated package.
> """
> 
> This is incorrect. (1) There is no optional arg BUTTON.
> (2) It doesn't hide package under point. Instead it asks for a regpexp
> (defaulting to the name of the package under point), and hides packages
> that match the regexp.

Fixed.

> This is also the description in the Emacs info file:
> 
> """
> 
> ‘H’
>      Permanently hide packages that match a regexp
>      (‘package-menu-hide-package’).
> """
> (although "permanently" sounds quite strong to me.)

I've removed "Permanently" and made the description more detailed.

> and the menu entry correctly says "Hide by Regexp", and the associated
> help info also is "Permanently hide all packages matching a regexp".

Removed "Permanently" here as well.

> On a side node, in the package-menu-mode-map, this entry and another one uses #', whereas the other just use '.
> 
> """
>     (define-key map "h" 'package-menu-quick-help)
>     (define-key map "H" #'package-menu-hide-package)
>     (define-key map "?" 'package-menu-describe-package)
>     (define-key map "(" #'package-menu-toggle-hiding)
> """
> Is there a reason for this discrepancy?

This is the "brave new world" of function quoting advancing slowly
through our sources.

Thanks.