From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Damien Cassou Newsgroups: gmane.emacs.bugs Subject: bug#55569: 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="=-=-=" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="27684"; mail-complaints-to="usenet@ciao.gmane.io" To: 55569@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun May 22 08:17:20 2022 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1nsetz-0006zh-Sf for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 22 May 2022 08:17:19 +0200 Original-Received: from localhost ([::1]:47536 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nsety-0005HT-9S for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 22 May 2022 02:17:18 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:50116) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nseti-0005HE-62 for bug-gnu-emacs@gnu.org; Sun, 22 May 2022 02:17:04 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:49630) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nseth-0001oF-Td for bug-gnu-emacs@gnu.org; Sun, 22 May 2022 02:17:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nseth-0007QQ-Q2 for bug-gnu-emacs@gnu.org; Sun, 22 May 2022 02:17:01 -0400 X-Loop: help-debbugs@gnu.org 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 X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.165320020428512 (code B ref -1); Sun, 22 May 2022 06:17:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 22 May 2022 06:16:44 +0000 Original-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 Original-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 Original-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 Original-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 Original-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) Original-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) Original-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 Original-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) Original-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) 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-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:232868 Archived-At: --=-=-= 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 --=-=-=--