From cd3cb648930bf23592a206cd44532d6623cb3ccd Mon Sep 17 00:00:00 2001 From: "Dirk-Jan C. Binnema" Date: Fri, 7 Feb 2025 23:43:06 +0200 Subject: [PATCH] update docs --- IDEAS.org | 22 +++++++++++++--------- NEWS.org | 20 +++++++++++++++++--- mu4e/mu4e.texi | 16 ++++++++++++++++ 3 files changed, 46 insertions(+), 12 deletions(-) diff --git a/IDEAS.org b/IDEAS.org index 1b5806d81..c3ccc512f 100644 --- a/IDEAS.org +++ b/IDEAS.org @@ -32,11 +32,6 @@ future. ** mu4e -- Support automatic handling for List-Unsubscribe headers and more in general, - handle mailing-list commands https://github.com/djcb/mu/issues/2623 and - https://github.com/djcb/mu/issues/2724 This seems useful, but probably - requires a lot of testing to get right. Can we re-use the Gnus code for this? - - Allow for *muting* messages https://github.com/djcb/mu/issues/636 Useful; probably need to do this by *remembering* the thread-id of muted messages; and management (unmute etc.). Perhaps at the mu side, a list of thread-id to add @@ -61,12 +56,12 @@ future. invisible unicode to fool crm-separator? https://github.com/djcb/mu/issues/2768 -- Org-link type for any message matching some reference - See: https://github.com/djcb/mu/issues/2787. - Some first steps implemented (searching for references). +- Org-link type for any message matching some reference See: + https://github.com/djcb/mu/issues/2787. Some first steps implemented + (searching for references). - Reply/forward/... to multiple messages at once. This is sometimes useful, and - Gnus supports. Does not seem trivial to re-use the Gnus code... (see + Gnus supports it. Does not seem trivial to re-use the Gnus code... (see ~gnus-summary-work-articles~ etc.). https://github.com/djcb/mu/issues/2799 @@ -78,3 +73,12 @@ future. - Support mu4e-mark-handle-when also for when leaving emacs (kill-emacs-query-functions). https://github.com/djcb/mu/issues/2649 + +- Support automatic handling for List-Unsubscribe headers and more in general, + handle mailing-list commands https://github.com/djcb/mu/issues/2623 and + https://github.com/djcb/mu/issues/2724 This seems useful, but probably + requires a lot of testing to get right. Can we re-use the Gnus code for this? + + Yes: this is implemented now, in 1.12.9. Various Gnus' mailing list commands + are now available in the mu4e message view as well, such as + ~gnus-mailing-list-subscribe~, ~gnus-mailing-list-unsubscribe~. diff --git a/NEWS.org b/NEWS.org index a28751bbe..8b269fcac 100644 --- a/NEWS.org +++ b/NEWS.org @@ -67,9 +67,23 @@ result you expected. - When you ask for bookmarks or maildirs through ~mu4e-ask-bookmark~ or - ~mu4e-ask-maildir~, unread counts are displayed in the (default) completions UI - next to the maildir or bookmark. If you don't want to see these counts, set - ~mu4e-hide-short-counts~ to non-~nil~. + ~mu4e-ask-maildir~, unread counts are displayed in the (default) completions + UI next to the maildir or bookmark. If you don't want to see these counts, + set ~mu4e-hide-short-counts~ to non-~nil~. + + - A (experimental) "transient" menu has been added for mu4e. You can use + it e.g., with something like: + + #+begin_src elisp + (require 'mu4e-transient) + (global-set-key (kbd "C-c m") #'mu4e-transient-menu) + #+end_src + This is will change/improve, but is already quite useful. + + - Various Gnus' mailing list commands are now available in the mu4e message + view as well, such as ~gnus-mailing-list-subscribe~, + ~gnus-mailing-list-unsubscribe~. + * 1.12 (released on February 24, 2024) diff --git a/mu4e/mu4e.texi b/mu4e/mu4e.texi index 3261e4f87..087cbb314 100644 --- a/mu4e/mu4e.texi +++ b/mu4e/mu4e.texi @@ -1319,6 +1319,7 @@ from @t{gnus-article-mode}. * Custom headers: MSGV Custom headers. Your very own headers * Actions: MSGV Actions. Defining and using actions * Detaching & reattaching: MSGV Detaching and reattaching. Multiple message views. +* Mailing lists: MSGV Mailing lists. Subscribing and unsubscribing. @end menu @node MSGV Overview @@ -1639,6 +1640,21 @@ You can @emph{tear off} the window a message is in and place it in a new frame by typing @key{C-x w ^ f}. You can also detach a window and put it in its own tab with @key{C-x w ^ t}. +@node MSGV Mailing lists +@section Mailing lists + +In the message view (but not the headers vies), @t{mu4e} supports various +commands for dealing with mailing-lists, such as subscribing and unsubscribing. + +@itemize +@item @code{gnus-mailing-list-subscribe}: subscribe to mailing-list +@item @code{gnus-mailing-list-unsubscribe}: unsubscribe from mailing-list +@item @code{gnus-mailing-list-help}: request help for mailing-list +@end itemize + +These commands depend on the current message to contain the necessary +information for these commands. + @node Composer @chapter Composer