When using prefix with org-agenda-custom-commands, how can I rename the help text?

Question

Right now the name "Prefix" is standing next to all my prefix keys, in org-agenda.

Is there any way to rename this "help text"?

EDIT: if you have entries with e.g. two-letter keys where the first letter is the same, then org-agenda will call the first letter a Prefix key and group the entries into a sub-menu. So when you do M-x org-agenda the *Agenda Commands* window looks like this:

Press key for an agenda command:
--------------------------------        <   Buffer, subtree/region restriction
a   Agenda for current week or day      >   Remove restriction
t   List of all TODO entries            e   Export agenda views
m   Match a TAGS/PROP/TODO query        T   Entries with special TODO kwd
s   Search for keywords                 M   Like m, but only TODO entries
/   Multi-occur                         S   Like s, but only TODO entries
?   Find :FLAGGED: entries              C   Configure custom agenda commands
*   Toggle sticky agenda views          #   List stuck projects (!=configure)


h    Prefix key
...

Pressing h will bring up a sub-menu of the org-agenda-custom-commands that share h as a prefix key. I want to change the label Prefix key above to something else. How do I do that?

Answer 1

Maybe this will help although I have not tried it out. The doc string of org-agenda-custom-commands says, in part:

...
When using several characters as key to a command, the first characters
are prefix commands.  For the dispatcher to display useful information, you
should provide a description for the prefix, like

(setq org-agenda-custom-commands
   '(("h" . "HOME + Name tag searches") ; describe prefix "h"
     ("hl" tags "+HOME+Lisa")
     ("hp" tags "+HOME+Peter")
     ("hk" tags "+HOME+Kim")))

EDIT: unfortunately there is a bug in org-agenda-get-restriction-and-command and the description line causes it to barf, at least in my case.

There is nothing wrong with the function: PEBKAC. So if you set your org-agenda-custom-commands like this:

(setq hk-command '("hk" tags "+HOME+Kim"))
(setq hl-command '("hl" tags "+HOME+Lisa"))
(setq hp-command '("hp" tags "+HOME+Peter"))

(setq org-agenda-custom-commands (list hk-command hk-command hp-command))

you can add a description entry for the prefix h as follows:

(setq h-entry '("h" . "Here is a nice description of the prefix h"))

(add-to-list 'org-agenda-custom-commands h-entry)

and you'll get the nice description of the prefix h indeed.

Here's a screenshot with what I did in the *scratch* buffer in the top window, before doing M-x org-agenda to get the agenda menu in the bottom window:

Basically, org-agenda-custom-commands is a list of lists (not necessarily proper). An improper list like the h entry above, whose car and cdr are both strings, modifies the label of the prefix key.