mu4e-folders: improve mu4e-maildir-shortcuts docstring

... and :type
This commit is contained in:
Dirk-Jan C. Binnema
2025-10-20 18:58:13 +03:00
committed by Seth Ladygo
parent e3ec84386c
commit 23e16f7c41

View File

@ -101,12 +101,12 @@ nil otherwise."
(defcustom mu4e-maildir-shortcuts nil (defcustom mu4e-maildir-shortcuts nil
"A list of maildir shortcuts. "A list of maildir shortcuts.
Creating a shortcut makes it possible to quickly go to a Adding a shortcut to this list makes it possible to quickly go to
particular maildir (folder), or quickly moving messages to a particular maildir (folder), or quickly moving messages to
them (e.g., for archiving or refiling). them (e.g., for archiving or refiling).
The format is mostly the same as for `mu4e-bookmarks', with a few The format is mostly the same as for `mu4e-bookmarks', with a few
difference, so see its doc-string for further details. differences; see its doc-string for further details.
The only field specific to `mu4e-maildir-shortcuts' is The only field specific to `mu4e-maildir-shortcuts' is
`:maildir', which is the property specifying the maildir for the `:maildir', which is the property specifying the maildir for the
@ -120,9 +120,9 @@ Example:
(:maildir \"/sent\" :key ?s :hide-unread t))) (:maildir \"/sent\" :key ?s :hide-unread t)))
You can use these shortcuts in the headers and view buffers, for You can use these shortcuts in the headers and view buffers, for
example with `mu4e-mark-for-move-quick' (or \"m\", by default) or example with
`mu4e-jump-to-maildir' (or \"j\", by default), followed by the `mu4e-search-maildir' (\\<mu4e-search-minor-mode-map>\\[mu4e-search-maildir]).
designated shortcut character for the maildir. followed by the designated shortcut character for the maildir.
Unlike in search queries, folder names with spaces in them must Unlike in search queries, folder names with spaces in them must
NOT be quoted, since mu4e does this for you." NOT be quoted, since mu4e does this for you."
@ -131,13 +131,15 @@ NOT be quoted, since mu4e does this for you."
:value-type character :value-type character
:tag "Alist (old format)") :tag "Alist (old format)")
(repeat (plist (repeat (plist
:key-type (choice (const :tag "Maildir" :maildir) :key-type (choice
(const :tag "Maildir" :maildir)
(const :tag "Shortcut" :key) (const :tag "Shortcut" :key)
(const :tag "Name of maildir" :name) (const :tag "Name of maildir" :name)
(const :tag "Hide from main view" :hide) (const :tag "Hide from main view" :hide)
(const :tag "Do not count" :hide-unread)) (const :tag "Do not show unread counts" :hide-unread)
(const :tag "Hide if no unread" :hide-if-no-unread))
:tag "Plist (new format)"))) :tag "Plist (new format)")))
:version "1.3.9" :package-version "1.3.9"
:group 'mu4e-folders) :group 'mu4e-folders)
(defcustom mu4e-maildir-initial-input "/" (defcustom mu4e-maildir-initial-input "/"