From unknown Sun Jun 15 08:52:06 2025 X-Loop: help-debbugs@gnu.org Subject: bug#55569: Improve documentation of mail-user-agent Resent-From: Damien Cassou Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 22 May 2022 06:17:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 55569 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: 55569@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.165320020428512 (code B ref -1); Sun, 22 May 2022 06:17:01 +0000 Received: (at submit) by debbugs.gnu.org; 22 May 2022 06:16:44 +0000 Received: from localhost ([127.0.0.1]:43527 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nsetP-0007Po-RS for submit@debbugs.gnu.org; Sun, 22 May 2022 02:16:44 -0400 Received: from lists.gnu.org ([209.51.188.17]:47642) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nsetM-0007Pf-V9 for submit@debbugs.gnu.org; Sun, 22 May 2022 02:16:42 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:50112) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nsetM-0005Gd-Mb for bug-gnu-emacs@gnu.org; Sun, 22 May 2022 02:16:40 -0400 Received: from mail.choca.pics ([2001:910:1410:500::1]:52006) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nsetK-0001iZ-Np for bug-gnu-emacs@gnu.org; Sun, 22 May 2022 02:16:40 -0400 Received: from localhost (localhost.localdomain [IPv6:::1]) by mail.choca.pics (Postfix) with ESMTP id 10DBD18197CC7 for ; Sun, 22 May 2022 08:16:28 +0200 (CEST) Received: from mail.choca.pics ([IPv6:::1]) by localhost (mail.choca.pics [IPv6:::1]) (amavisd-new, port 10032) with ESMTP id wkdaB0EOA3Lf for ; Sun, 22 May 2022 08:16:27 +0200 (CEST) Received: from localhost (localhost.localdomain [IPv6:::1]) by mail.choca.pics (Postfix) with ESMTP id 13CC71817C2C1 for ; Sun, 22 May 2022 08:16:27 +0200 (CEST) X-Virus-Scanned: amavisd-new at choca.pics Received: from mail.choca.pics ([IPv6:::1]) by localhost (mail.choca.pics [IPv6:::1]) (amavisd-new, port 10026) with ESMTP id axubOIISD12y for ; Sun, 22 May 2022 08:16:26 +0200 (CEST) Received: from localhost (153.226.95.79.rev.sfr.net [79.95.226.153]) by mail.choca.pics (Postfix) with ESMTPSA id AE1AF18193F60 for ; Sun, 22 May 2022 08:16:26 +0200 (CEST) From: Damien Cassou Date: Sun, 22 May 2022 08:16:25 +0200 Message-ID: <871qwmks7a.fsf@cassou.me> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Received-SPF: pass client-ip=2001:910:1410:500::1; envelope-from=damien@cassou.me; helo=mail.choca.pics X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.4 (-) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.4 (--) --=-=-= Content-Type: text/plain Tags: patch * doc/emacs/sending.texi (Mail Methods): Add sentences. * lisp/simple.el (mail-user-agent): Add sentences to the documentation string. -- Damien Cassou "Success is the ability to go from one failure to another without losing enthusiasm." --Winston Churchill --=-=-= Content-Type: text/patch Content-Disposition: attachment; filename=0001-Improve-documentation-of-mail-user-agent.patch >From be4bcf3ade2b64b211074ba92688922f4f43978e Mon Sep 17 00:00:00 2001 From: Damien Cassou Date: Sun, 22 May 2022 08:09:38 +0200 Subject: [PATCH] Improve documentation of mail-user-agent. * doc/emacs/sending.texi (Mail Methods): Add sentences. * lisp/simple.el (mail-user-agent): Add sentences to the documentation string. --- doc/emacs/sending.texi | 4 +++- lisp/simple.el | 7 ++++--- 2 files changed, 7 insertions(+), 4 deletions(-) diff --git a/doc/emacs/sending.texi b/doc/emacs/sending.texi index ea87e0a77b..221d2aa3dd 100644 --- a/doc/emacs/sending.texi +++ b/doc/emacs/sending.texi @@ -667,7 +667,9 @@ Mail Methods customize the variable @code{mail-user-agent}. Currently, legitimate values include @code{message-user-agent} (Message mode) @code{sendmail-user-agent} (Mail mode), @code{gnus-user-agent}, and -@code{mh-e-user-agent}. +@code{mh-e-user-agent}. Additional options may be available; check +with the author of your mail user agent package for details. You may +also define another mail user agent using `define-mail-user-agent'. If you select a different mail-composition method, the information in this chapter about the mail buffer and Message mode does not apply; diff --git a/lisp/simple.el b/lisp/simple.el index 6906675f68..f901da9bc6 100644 --- a/lisp/simple.el +++ b/lisp/simple.el @@ -9210,9 +9210,10 @@ mail-user-agent paraphernalia if Gnus is running, particularly the Gcc: header for archiving. -Additional valid symbols may be available; check with the author of -your package for details. The function should return non-nil if it -succeeds. +Additional valid symbols may be available; check with the author +of your mail user agent package for details. You may also define +your own symbol to be used as value for this variable using +`define-mail-user-agent'. See also `read-mail-command' concerning reading mail." :type '(radio (function-item :tag "Message package" -- 2.36.0 --=-=-=-- From unknown Sun Jun 15 08:52:06 2025 X-Loop: help-debbugs@gnu.org Subject: bug#55569: Improve documentation of mail-user-agent Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 22 May 2022 06:28:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 55569 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: Damien Cassou Cc: 55569@debbugs.gnu.org Received: via spool by 55569-submit@debbugs.gnu.org id=B55569.165320083729530 (code B ref 55569); Sun, 22 May 2022 06:28:01 +0000 Received: (at 55569) by debbugs.gnu.org; 22 May 2022 06:27:17 +0000 Received: from localhost ([127.0.0.1]:43539 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nsf3d-0007gE-3x for submit@debbugs.gnu.org; Sun, 22 May 2022 02:27:17 -0400 Received: from eggs.gnu.org ([209.51.188.92]:57310) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nsf3a-0007g0-84 for 55569@debbugs.gnu.org; Sun, 22 May 2022 02:27:15 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:36452) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nsf3U-0003BF-Ir; Sun, 22 May 2022 02:27:08 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=j13Tx/3K4h1nVrn9vQjmDzlA2LfLXiwVk5YmIho7aAc=; b=gFwwaWqOZHiA FtFPp+wr8YFJL8cqIMxI2v/aj5BICfkvn4eSfAMPtB4H7SBerO4Fr2vzKGkkOehxDtRhM+qt1PTNU gCIAd9g6RDU/580ye6ux2IK3HgrupZOJD3yCADqls7Iq1cGdiWM93PdFgzxqcOei5n+K0gQ9p8aeX 5OkLhj9NuWCp+0VNjV4LwcX2fArV9wJu0CFOOV9B5dKtAt5LJn29Zl4R+jJtXnL2Pmz8NHRZt4BPq MoZxkE/AVlt3CMqtBOu07CpaZCSwVicT47JwTHISw2LFQvVXK+Czxs6FxhrQZvLmif0U/pMgMo7/Y ACKFwItJmShycXjpaJhsZA==; Received: from [87.69.77.57] (port=2217 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nsf3N-00023J-Aa; Sun, 22 May 2022 02:27:07 -0400 Date: Sun, 22 May 2022 09:26:43 +0300 Message-Id: <83v8ty6q1o.fsf@gnu.org> From: Eli Zaretskii In-Reply-To: <871qwmks7a.fsf@cassou.me> (message from Damien Cassou on Sun, 22 May 2022 08:16:25 +0200) References: <871qwmks7a.fsf@cassou.me> X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Damien Cassou > Date: Sun, 22 May 2022 08:16:25 +0200 > > diff --git a/doc/emacs/sending.texi b/doc/emacs/sending.texi > index ea87e0a77b..221d2aa3dd 100644 > --- a/doc/emacs/sending.texi > +++ b/doc/emacs/sending.texi > @@ -667,7 +667,9 @@ Mail Methods > customize the variable @code{mail-user-agent}. Currently, legitimate > values include @code{message-user-agent} (Message mode) > @code{sendmail-user-agent} (Mail mode), @code{gnus-user-agent}, and > -@code{mh-e-user-agent}. > +@code{mh-e-user-agent}. Additional options may be available; check > +with the author of your mail user agent package for details. You may > +also define another mail user agent using `define-mail-user-agent'. Thanks, but what do you mean by "the author of your mail user agent package"? This is an Emacs user manual, and I very much doubt that Emacs users could figure out where and how to check that. Can we provide more practical advice here how to check for those additional options? From unknown Sun Jun 15 08:52:06 2025 X-Loop: help-debbugs@gnu.org Subject: bug#55569: Improve documentation of mail-user-agent Resent-From: Damien Cassou Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 22 May 2022 07:20:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 55569 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: Eli Zaretskii Cc: 55569@debbugs.gnu.org Received: via spool by 55569-submit@debbugs.gnu.org id=B55569.16532039432794 (code B ref 55569); Sun, 22 May 2022 07:20:02 +0000 Received: (at 55569) by debbugs.gnu.org; 22 May 2022 07:19:03 +0000 Received: from localhost ([127.0.0.1]:43585 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nsfrj-0000j0-I9 for submit@debbugs.gnu.org; Sun, 22 May 2022 03:19:03 -0400 Received: from mail.choca.pics ([80.67.172.235]:35206) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nsfri-0000iW-03 for 55569@debbugs.gnu.org; Sun, 22 May 2022 03:19:02 -0400 Received: from localhost (localhost.localdomain [IPv6:::1]) by mail.choca.pics (Postfix) with ESMTP id 2271B18197CC7; Sun, 22 May 2022 09:19:00 +0200 (CEST) Received: from mail.choca.pics ([IPv6:::1]) by localhost (mail.choca.pics [IPv6:::1]) (amavisd-new, port 10032) with ESMTP id jR_ea25LQCl1; Sun, 22 May 2022 09:18:59 +0200 (CEST) Received: from localhost (localhost.localdomain [IPv6:::1]) by mail.choca.pics (Postfix) with ESMTP id 584A31817C2C5; Sun, 22 May 2022 09:18:59 +0200 (CEST) X-Virus-Scanned: amavisd-new at choca.pics Received: from mail.choca.pics ([IPv6:::1]) by localhost (mail.choca.pics [IPv6:::1]) (amavisd-new, port 10026) with ESMTP id zYANFSfsXoa5; Sun, 22 May 2022 09:18:59 +0200 (CEST) Received: from localhost (153.226.95.79.rev.sfr.net [79.95.226.153]) by mail.choca.pics (Postfix) with ESMTPSA id 1426518193F60; Sun, 22 May 2022 09:18:59 +0200 (CEST) From: Damien Cassou In-Reply-To: <83v8ty6q1o.fsf@gnu.org> References: <871qwmks7a.fsf@cassou.me> <83v8ty6q1o.fsf@gnu.org> Date: Sun, 22 May 2022 09:18:58 +0200 Message-ID: <87czg62fx9.fsf@cassou.me> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hi Eli, Eli Zaretskii writes: >> +@code{mh-e-user-agent}. Additional options may be available; check >> +with the author of your mail user agent package for details. You may >> +also define another mail user agent using `define-mail-user-agent'. > > Thanks, but what do you mean by "the author of your mail user agent > package"? I mean that the authors of notmuch and mu4e both define a symbol to be used as value for the `mail-user-agent` variable: `mu4e-user-agent` and `notmuch-user-agent`. These symbols should be documented somewhere in notmuch and mu4e manuals so their users know they should pass them to `mail-user-agent`. There might be other mail user agent packages out there that I don't know about. > This is an Emacs user manual, and I very much doubt that > Emacs users could figure out where and how to check that. > > Can we provide more practical advice here how to check for those > additional options? I could certainly mention the symbols for notmuch and mu4e if you think that is ok to mention external packages inside the Emacs manual but I'm not sure what else I could do. -- Damien Cassou "Success is the ability to go from one failure to another without losing enthusiasm." --Winston Churchill From unknown Sun Jun 15 08:52:06 2025 X-Loop: help-debbugs@gnu.org Subject: bug#55569: Improve documentation of mail-user-agent Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 22 May 2022 07:30:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 55569 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: Damien Cassou Cc: 55569@debbugs.gnu.org Received: via spool by 55569-submit@debbugs.gnu.org id=B55569.16532045444067 (code B ref 55569); Sun, 22 May 2022 07:30:02 +0000 Received: (at 55569) by debbugs.gnu.org; 22 May 2022 07:29:04 +0000 Received: from localhost ([127.0.0.1]:43602 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nsg1P-00013S-Uz for submit@debbugs.gnu.org; Sun, 22 May 2022 03:29:04 -0400 Received: from eggs.gnu.org ([209.51.188.92]:33832) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nsg1O-00012r-2I for 55569@debbugs.gnu.org; Sun, 22 May 2022 03:29:02 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:36884) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nsg1I-0002Xq-Dc; Sun, 22 May 2022 03:28:56 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=/zmmKOatsKgodebUKV/H5czpTFn73LQaDAY1a7cJHdc=; b=K/Hx8FEMCV/L aPyCIBkHbHNNvltl1r9Gv58KzkrP472KusGSDE7KHbobu9bsU1xoIvqUHGuc65R+o2JVFOzISZZee wIS8T+T4qJAfzzYP040DHdK8xkZLeBnI1IvXQBZYwnsNwvZdYlESuH3i/yyObuH9YEb0bRS5vQ/p8 oD5uStEFI/QnOepy2b5aT0J8Va7ndc23fIyJ9sCc4+gsVynsGPZ6vKLo/m7aicAQN14daHpy4s5Mw klsgHC23DzVikdXgb0pr8tRIQ+ODDQGFyRVwA6/hBB7ScOerF0HbKzDxTaF9nb0LKoaypNHley6Dg PEO1Kze2cIm6gsZbppNd6w==; Received: from [87.69.77.57] (port=2076 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nsg1H-00057Q-PN; Sun, 22 May 2022 03:28:56 -0400 Date: Sun, 22 May 2022 10:28:38 +0300 Message-Id: <83sfp26n6h.fsf@gnu.org> From: Eli Zaretskii In-Reply-To: <87czg62fx9.fsf@cassou.me> (message from Damien Cassou on Sun, 22 May 2022 09:18:58 +0200) References: <871qwmks7a.fsf@cassou.me> <83v8ty6q1o.fsf@gnu.org> <87czg62fx9.fsf@cassou.me> X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Damien Cassou > Cc: 55569@debbugs.gnu.org > Date: Sun, 22 May 2022 09:18:58 +0200 > > Hi Eli, > > Eli Zaretskii writes: > >> +@code{mh-e-user-agent}. Additional options may be available; check > >> +with the author of your mail user agent package for details. You may > >> +also define another mail user agent using `define-mail-user-agent'. > > > > Thanks, but what do you mean by "the author of your mail user agent > > package"? > > > I mean that the authors of notmuch and mu4e both define a symbol to be > used as value for the `mail-user-agent` variable: `mu4e-user-agent` and > `notmuch-user-agent`. These symbols should be documented somewhere in > notmuch and mu4e manuals so their users know they should pass them to > `mail-user-agent`. There might be other mail user agent packages out > there that I don't know about. > > > > This is an Emacs user manual, and I very much doubt that > > Emacs users could figure out where and how to check that. > > > > Can we provide more practical advice here how to check for those > > additional options? > > > I could certainly mention the symbols for notmuch and mu4e if you think > that is ok to mention external packages inside the Emacs manual but I'm > not sure what else I could do. If those additional options are supposed to be documented in the MUA manual, let's suggest that users look in those manuals. That is IMO better than to send them to some unnamed "authors". From unknown Sun Jun 15 08:52:06 2025 X-Loop: help-debbugs@gnu.org Subject: bug#55569: Improve documentation of mail-user-agent Resent-From: Damien Cassou Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 22 May 2022 07:49:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 55569 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: Eli Zaretskii Cc: 55569@debbugs.gnu.org Received: via spool by 55569-submit@debbugs.gnu.org id=B55569.16532057356077 (code B ref 55569); Sun, 22 May 2022 07:49:01 +0000 Received: (at 55569) by debbugs.gnu.org; 22 May 2022 07:48:55 +0000 Received: from localhost ([127.0.0.1]:43608 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nsgKc-0001Zw-LD for submit@debbugs.gnu.org; Sun, 22 May 2022 03:48:54 -0400 Received: from mail.choca.pics ([80.67.172.235]:35590) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nsgKX-0001Zj-KZ for 55569@debbugs.gnu.org; Sun, 22 May 2022 03:48:53 -0400 Received: from localhost (localhost.localdomain [IPv6:::1]) by mail.choca.pics (Postfix) with ESMTP id 3169918197CC7; Sun, 22 May 2022 09:48:48 +0200 (CEST) Received: from mail.choca.pics ([IPv6:::1]) by localhost (mail.choca.pics [IPv6:::1]) (amavisd-new, port 10032) with ESMTP id zli4lX5rWazZ; Sun, 22 May 2022 09:48:47 +0200 (CEST) Received: from localhost (localhost.localdomain [IPv6:::1]) by mail.choca.pics (Postfix) with ESMTP id 51A791817C2C5; Sun, 22 May 2022 09:48:47 +0200 (CEST) X-Virus-Scanned: amavisd-new at choca.pics Received: from mail.choca.pics ([IPv6:::1]) by localhost (mail.choca.pics [IPv6:::1]) (amavisd-new, port 10026) with ESMTP id YeCloFQz1W7k; Sun, 22 May 2022 09:48:47 +0200 (CEST) Received: from localhost (153.226.95.79.rev.sfr.net [79.95.226.153]) by mail.choca.pics (Postfix) with ESMTPSA id E94D418193F60; Sun, 22 May 2022 09:48:46 +0200 (CEST) From: Damien Cassou In-Reply-To: <83sfp26n6h.fsf@gnu.org> References: <871qwmks7a.fsf@cassou.me> <83v8ty6q1o.fsf@gnu.org> <87czg62fx9.fsf@cassou.me> <83sfp26n6h.fsf@gnu.org> Date: Sun, 22 May 2022 09:48:46 +0200 Message-ID: <87a6ba2ejl.fsf@cassou.me> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Spam-Score: -0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) --=-=-= Content-Type: text/plain Eli Zaretskii writes: > If those additional options are supposed to be documented in the MUA > manual, let's suggest that users look in those manuals. That is IMO > better than to send them to some unnamed "authors". Here is a new version of the patch that references the "manual" instead of the "authors". -- Damien Cassou "Success is the ability to go from one failure to another without losing enthusiasm." --Winston Churchill --=-=-= Content-Type: text/x-patch Content-Disposition: attachment; filename=0001-Improve-documentation-of-mail-user-agent.patch >From 14361675353a4f026eacffd04b88c31bdd4cc9f9 Mon Sep 17 00:00:00 2001 From: Damien Cassou Date: Sun, 22 May 2022 08:09:38 +0200 Subject: [PATCH] Improve documentation of mail-user-agent. * doc/emacs/sending.texi (Mail Methods): Add sentences. * lisp/simple.el (mail-user-agent): Add sentences to the documentation string. --- doc/emacs/sending.texi | 4 +++- lisp/simple.el | 7 ++++--- 2 files changed, 7 insertions(+), 4 deletions(-) diff --git a/doc/emacs/sending.texi b/doc/emacs/sending.texi index ea87e0a77b..acdae8a263 100644 --- a/doc/emacs/sending.texi +++ b/doc/emacs/sending.texi @@ -667,7 +667,9 @@ Mail Methods customize the variable @code{mail-user-agent}. Currently, legitimate values include @code{message-user-agent} (Message mode) @code{sendmail-user-agent} (Mail mode), @code{gnus-user-agent}, and -@code{mh-e-user-agent}. +@code{mh-e-user-agent}. Additional options may be available; check +in the manual of your mail user agent package for details. You may +also define another mail user agent using `define-mail-user-agent'. If you select a different mail-composition method, the information in this chapter about the mail buffer and Message mode does not apply; diff --git a/lisp/simple.el b/lisp/simple.el index 6906675f68..cdb7ce6832 100644 --- a/lisp/simple.el +++ b/lisp/simple.el @@ -9210,9 +9210,10 @@ mail-user-agent paraphernalia if Gnus is running, particularly the Gcc: header for archiving. -Additional valid symbols may be available; check with the author of -your package for details. The function should return non-nil if it -succeeds. +Additional valid symbols may be available; check in the manual of +your mail user agent package for details. You may also define +your own symbol to be used as value for this variable using +`define-mail-user-agent'. See also `read-mail-command' concerning reading mail." :type '(radio (function-item :tag "Message package" -- 2.36.0 --=-=-=-- From unknown Sun Jun 15 08:52:06 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Damien Cassou Subject: bug#55569: closed (Re: bug#55569: Improve documentation of mail-user-agent) Message-ID: References: <83r14m6kvb.fsf@gnu.org> <871qwmks7a.fsf@cassou.me> X-Gnu-PR-Message: they-closed 55569 X-Gnu-PR-Package: emacs X-Gnu-PR-Keywords: patch Reply-To: 55569@debbugs.gnu.org Date: Sun, 22 May 2022 08:19:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1653207542-8964-1" This is a multi-part message in MIME format... ------------=_1653207542-8964-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #55569: Improve documentation of mail-user-agent which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 55569@debbugs.gnu.org. --=20 55569: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D55569 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1653207542-8964-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 55569-done) by debbugs.gnu.org; 22 May 2022 08:19:02 +0000 Received: from localhost ([127.0.0.1]:43625 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nsgnl-0002KO-Nz for submit@debbugs.gnu.org; Sun, 22 May 2022 04:19:01 -0400 Received: from eggs.gnu.org ([209.51.188.92]:37420) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nsgnf-0002K4-P4 for 55569-done@debbugs.gnu.org; Sun, 22 May 2022 04:18:59 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:37756) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nsgnZ-0000jx-Rd; Sun, 22 May 2022 04:18:49 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=QnSs11O9qADSi5dYZ1nej/avxFkfqW93RCxdfftxU5A=; b=okU2Sdj1SOws hDt5YU/tjn5TQFrJva9du9uPaf7bgPD7V6jAbivSkHlJQNvXapHauj/lTO5bRSROQRCtqok2fcy/T ftDRPSAUO0mdPadMGdTT/wON8rlCSpIjcpO6O+8gUnv9Q91mjd1iCN/xdg5SczktBEvxQ9MyXHOn+ KjrPHKtEZauhrXlB8v2gtRB3qxMMLFTqEihQOYMId9rayNB4UgYNTTlRIPicyRnSjooykQUyY+6Ir cXQ92AZfYIGHlGX8wiCsQbqn6FGly5h4Ch7obAvm+6XhwidLxAQ//x+6fZr1YlbH1CT6ko8uB6JwR lGVRIo/l3tJtlBvqyJs/Ag==; Received: from [87.69.77.57] (port=1145 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nsgnZ-0002AP-BC; Sun, 22 May 2022 04:18:49 -0400 Date: Sun, 22 May 2022 11:18:32 +0300 Message-Id: <83r14m6kvb.fsf@gnu.org> From: Eli Zaretskii To: Damien Cassou In-Reply-To: <87a6ba2ejl.fsf@cassou.me> (message from Damien Cassou on Sun, 22 May 2022 09:48:46 +0200) Subject: Re: bug#55569: Improve documentation of mail-user-agent References: <871qwmks7a.fsf@cassou.me> <83v8ty6q1o.fsf@gnu.org> <87czg62fx9.fsf@cassou.me> <83sfp26n6h.fsf@gnu.org> <87a6ba2ejl.fsf@cassou.me> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 55569-done Cc: 55569-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: Damien Cassou > Cc: 55569@debbugs.gnu.org > Date: Sun, 22 May 2022 09:48:46 +0200 > > Eli Zaretskii writes: > > If those additional options are supposed to be documented in the MUA > > manual, let's suggest that users look in those manuals. That is IMO > > better than to send them to some unnamed "authors". > > Here is a new version of the patch that references the "manual" instead > of the "authors". Thanks, installed on the release branch (with some minor fixups). ------------=_1653207542-8964-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 22 May 2022 06:16:44 +0000 Received: from localhost ([127.0.0.1]:43527 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nsetP-0007Po-RS for submit@debbugs.gnu.org; Sun, 22 May 2022 02:16:44 -0400 Received: from lists.gnu.org ([209.51.188.17]:47642) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nsetM-0007Pf-V9 for submit@debbugs.gnu.org; Sun, 22 May 2022 02:16:42 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:50112) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nsetM-0005Gd-Mb for bug-gnu-emacs@gnu.org; Sun, 22 May 2022 02:16:40 -0400 Received: from mail.choca.pics ([2001:910:1410:500::1]:52006) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nsetK-0001iZ-Np for bug-gnu-emacs@gnu.org; Sun, 22 May 2022 02:16:40 -0400 Received: from localhost (localhost.localdomain [IPv6:::1]) by mail.choca.pics (Postfix) with ESMTP id 10DBD18197CC7 for ; Sun, 22 May 2022 08:16:28 +0200 (CEST) Received: from mail.choca.pics ([IPv6:::1]) by localhost (mail.choca.pics [IPv6:::1]) (amavisd-new, port 10032) with ESMTP id wkdaB0EOA3Lf for ; Sun, 22 May 2022 08:16:27 +0200 (CEST) Received: from localhost (localhost.localdomain [IPv6:::1]) by mail.choca.pics (Postfix) with ESMTP id 13CC71817C2C1 for ; Sun, 22 May 2022 08:16:27 +0200 (CEST) X-Virus-Scanned: amavisd-new at choca.pics Received: from mail.choca.pics ([IPv6:::1]) by localhost (mail.choca.pics [IPv6:::1]) (amavisd-new, port 10026) with ESMTP id axubOIISD12y for ; Sun, 22 May 2022 08:16:26 +0200 (CEST) Received: from localhost (153.226.95.79.rev.sfr.net [79.95.226.153]) by mail.choca.pics (Postfix) with ESMTPSA id AE1AF18193F60 for ; Sun, 22 May 2022 08:16:26 +0200 (CEST) From: Damien Cassou To: bug-gnu-emacs@gnu.org Subject: Improve documentation of mail-user-agent Date: Sun, 22 May 2022 08:16:25 +0200 Message-ID: <871qwmks7a.fsf@cassou.me> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Received-SPF: pass client-ip=2001:910:1410:500::1; envelope-from=damien@cassou.me; helo=mail.choca.pics X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.4 (-) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.4 (--) --=-=-= Content-Type: text/plain Tags: patch * doc/emacs/sending.texi (Mail Methods): Add sentences. * lisp/simple.el (mail-user-agent): Add sentences to the documentation string. -- Damien Cassou "Success is the ability to go from one failure to another without losing enthusiasm." --Winston Churchill --=-=-= Content-Type: text/patch Content-Disposition: attachment; filename=0001-Improve-documentation-of-mail-user-agent.patch >From be4bcf3ade2b64b211074ba92688922f4f43978e Mon Sep 17 00:00:00 2001 From: Damien Cassou Date: Sun, 22 May 2022 08:09:38 +0200 Subject: [PATCH] Improve documentation of mail-user-agent. * doc/emacs/sending.texi (Mail Methods): Add sentences. * lisp/simple.el (mail-user-agent): Add sentences to the documentation string. --- doc/emacs/sending.texi | 4 +++- lisp/simple.el | 7 ++++--- 2 files changed, 7 insertions(+), 4 deletions(-) diff --git a/doc/emacs/sending.texi b/doc/emacs/sending.texi index ea87e0a77b..221d2aa3dd 100644 --- a/doc/emacs/sending.texi +++ b/doc/emacs/sending.texi @@ -667,7 +667,9 @@ Mail Methods customize the variable @code{mail-user-agent}. Currently, legitimate values include @code{message-user-agent} (Message mode) @code{sendmail-user-agent} (Mail mode), @code{gnus-user-agent}, and -@code{mh-e-user-agent}. +@code{mh-e-user-agent}. Additional options may be available; check +with the author of your mail user agent package for details. You may +also define another mail user agent using `define-mail-user-agent'. If you select a different mail-composition method, the information in this chapter about the mail buffer and Message mode does not apply; diff --git a/lisp/simple.el b/lisp/simple.el index 6906675f68..f901da9bc6 100644 --- a/lisp/simple.el +++ b/lisp/simple.el @@ -9210,9 +9210,10 @@ mail-user-agent paraphernalia if Gnus is running, particularly the Gcc: header for archiving. -Additional valid symbols may be available; check with the author of -your package for details. The function should return non-nil if it -succeeds. +Additional valid symbols may be available; check with the author +of your mail user agent package for details. You may also define +your own symbol to be used as value for this variable using +`define-mail-user-agent'. See also `read-mail-command' concerning reading mail." :type '(radio (function-item :tag "Message package" -- 2.36.0 --=-=-=-- ------------=_1653207542-8964-1--