emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

RE: GNU ELPA package discoverability


From: Drew Adams
Subject: RE: GNU ELPA package discoverability
Date: Mon, 25 May 2020 07:50:11 -0700 (PDT)

> I suggest to try enhancing the discoverability "upstream", by updating
> the default Emacs menu bar.
> 
> For now, package is present in two menus: [Options] and [Help].
> 
>   [Options] contains "Manage Emacs Packages" which M-x
>   list-packages, so it does not solve the problem you
>   are insisting on.

IMO, `Manage Emacs Packages' should never have been
added to menu `Options'.  That menu is essentially for
setting user options (especially Boolean ones).  And
it shouldn't be called "Manage" anything (weasel word).

That command (`list-packages') is akin to commands
`list-faces-display' and `list-colors-display'.  Those
are in submenu `Edit > Text Properties', as `Display
Faces' and `Display Colors'.

Do they belong there?  Not really.  IMO, such lists
belong under `Help > Describe', just like `List Key
Bindings'.  Their first-order use is for listing stuff.
(Secondarily, you can get more info about the stuff
listed by clicking parts of the display.)

Similarly, `Edit > Text Properties > Display Properties'
is akin to the various items in `Help > Describe'.

I'd suggest moving all such to `Help > Describe'.  And
all that are about listing stuff should have similar
names: `List XYZ' or `Display XYZ', but not a mix of
`List' and `Display'. 

Menu `Help' should be used for obtaining information
about stuff, which can include exploring/discovering
stuff.  It's not primarily for accessing stuff, to
use it, or for changing stuff.

`Tools' is OK for accessing/using stuff that doesn't
fit elsewhere (e.g. under `Edit').  It's not the place
for finding out about packages etc.

(FWIW, in my `menu-bar+.el' there's a top-level
`Search' menu, which has the `Search' and `Replace'
submenus from `Edit'.  And `Edit' submenus `Go To' and
`Bookmarks' are instead on `Files' - they're not about
editing.)

`Help > Search Built-in Packages' is misnamed.  It's
not about searching.  The doc string for that command
is "Find packages matching a given keyword."

It's not obvious from the name that what gets listed
by it are not packages but categories of packages (by
keyword).  (And from there you can find lists of
packages per keyword.)  It should be called something
like `Packages By Category' or `Describe Packages By
Keyword'.

`Help > Describe' already has `Describe Package...'.
That submenu is also the place for `finder-by-keyword'
(`Describe Packages By Keyword').

`Help > Finding Extra Packages' should be called
something like `Getting More Packages', and it should
be placed in the same part of menu `Help' as `Getting
New Versions' (which should be called `Getting New
Emacs Versions').



reply via email to

[Prev in Thread] Current Thread [Next in Thread]