From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#67638: Description of the variable message-mail-user-agent in Emacs 29.1 Date: Tue, 05 Dec 2023 16:32:05 +0200 Message-ID: <83zfyo4t5m.fsf@gnu.org> References: Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="21032"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 67638@debbugs.gnu.org To: rameiko87@posteo.net Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Tue Dec 05 15:33:12 2023 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 1rAWU3-0005Dm-Kv for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 05 Dec 2023 15:33:11 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rAWTl-0003c7-F6; Tue, 05 Dec 2023 09:32:53 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rAWTj-0003bk-An for bug-gnu-emacs@gnu.org; Tue, 05 Dec 2023 09:32:51 -0500 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1rAWTj-00062j-2A for bug-gnu-emacs@gnu.org; Tue, 05 Dec 2023 09:32:51 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1rAWTt-0007rd-Qd for bug-gnu-emacs@gnu.org; Tue, 05 Dec 2023 09:33:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 05 Dec 2023 14:33:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 67638 X-GNU-PR-Package: emacs Original-Received: via spool by 67638-submit@debbugs.gnu.org id=B67638.170178673830164 (code B ref 67638); Tue, 05 Dec 2023 14:33:01 +0000 Original-Received: (at 67638) by debbugs.gnu.org; 5 Dec 2023 14:32:18 +0000 Original-Received: from localhost ([127.0.0.1]:36797 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rAWTC-0007qR-7i for submit@debbugs.gnu.org; Tue, 05 Dec 2023 09:32:18 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:35668) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rAWT9-0007qD-TO for 67638@debbugs.gnu.org; Tue, 05 Dec 2023 09:32:17 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rAWSs-0005y9-7O; Tue, 05 Dec 2023 09:31:58 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From: Date; bh=dThooD8TVRuZpCYkF69acG1BpOb7A/0nDp194b5TPJk=; b=pr9k61mDoHYZpZnZceUv LOSPhmK1eCEBGTVYPftglGvQ3SBC5/SQkKDrm6gOk8Ug33PNcJmIOQWUx7GtcDKsMvWj0jG1XXx3r tMRhQXS+BRAKojQdkx3Bsoc+tNgAUWS35NE1rLyRMo2ZTfBt98AGq+/yyL+4yM5H+B3TY3ne55n7h TPY02O+sMzqD9i/aGxqvm8aSr+zXbBA8yFydyx69wHuPDvK47IfKSa1qB4n21ih0OuS3ErOsmFOBO vT6zNg+1WXvyIG9X26PMicC9VUI9Tawfu5KCzG60w0IPJ/+fd3UqHqfRgru3cObeuSVliL1KtXa/P FUO7a5yFMGsp3A==; In-Reply-To: (rameiko87@posteo.net) 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-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:275568 Archived-At: > Date: Mon, 04 Dec 2023 23:26:39 +0000 > From: rameiko87@posteo.net > > I would appreciate clarifying this variable. Thanks, I did that on the emacs-29 branch. > > Like ‘mail-user-agent’. > I don't know what this sentence means. It means you should click the link and read on mail-user-agent, before you continue reading this doc string. This is the style we use to avoid repeating the same information in more than one doc string. > > Except if it is nil, use Gnus native MUA; if it is t, use > > ‘mail-user-agent’. > Please remove Except from the beginning of the sentence, because > non-native English speakers like myself think that "Except if it is nil" > means "Whenever not nil". It may be correct, but it's confusing to some > people. Perhaps the confusion arises because there's a full stop rather > than a comma. > > If the except links the sentence to the one above, then why write "if it > is t, use ‘mail-user-agent’ ", which is a repetition at this point? Now > it looks from the description like there should be two options, but > instead there's five. > > I'm totally at loss! Here's the new doc string: "Your preferred mail composition package when reading email with message.el. Like `mail-user-agent' (which see), this specifies the mail-sending package you prefer. The value can be any value accepted by `mail-user-agent', and in addition it can be nil or t. If the value is nil, use the Gnus native Mail User Agent (MUA); if it is t, use the value of `mail-user-agent'."