From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0.migadu.com ([2001:41d0:403:58f0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms13.migadu.com with LMTPS id KI2OFpj1u2YWBgAAqHPOHw:P1 (envelope-from ) for ; Wed, 14 Aug 2024 00:08:56 +0000 Received: from aspmx1.migadu.com ([2001:41d0:403:58f0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0.migadu.com with LMTPS id KI2OFpj1u2YWBgAAqHPOHw (envelope-from ) for ; Wed, 14 Aug 2024 02:08:56 +0200 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=fail ("body hash did not verify") header.d=tethera.net header.s=2024 header.b=jOQNhqef; dmarc=none; spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 135.181.149.255 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1723594106; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding:list-id:list-help: list-owner:list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=UDrKNh2v69Mhf9xrybLjlUDinNoFKrTnyRbXe/gYQs8=; b=qziJekH7dvOHN9Eisu8p8IwVBNSXefMZuW/68Say/DKEx1hmK0HFoHV8fDsfQr6AYM4E/Z xUIIkZe0Q81dNxtYKA8LkObf55s0NXpTTnS16Gx8Z1mY/ZXi4INy+KEqgYWI8/+Jdc7QrP Z11v0Eo2TRpLZxvnaoa/CdkcExjg2MbsXGqi8fvIDDEUmpDGZxFh5oVqDzXz2U5XQfWzlQ /G5Z//ztvdjdNi9RStmqp8+9hfv2pkmF/2tyzpY4EDUNxZWUXrpo1DFbcW8Y0foInI/X6f r67YMRfbKHg+MaVGI90Y8/kbv9z1Ny6hty6gcObi13edaHXnm6jWpmTjEDpoiQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1723594106; a=rsa-sha256; cv=none; b=MIyUcGcpuHHbdJf7LmEB8CtChjNl74sHpvoqG9ZTAPGrQcwhmoscA9/8ZhkCAkqzG7StHh daws1/ZWcsqB6FgnHczQEql3Saw8pqjtYQOuIxxsb2xIkvaa9WN4NAvJxabELQFoJcB9Iw rbT+lfzfTAXMsv9k7oJkZf40z+gtQFwVvQTp312d0ndKPthF2w7iPpLlbX2ZBrG3xbkWvn Cs8MC/kksm4Ja+gGUXAsxVQMi8+OIpo2q9AIXtNsP7AqVtyauR3xN6TGnT421X6CzYNIYj GZulSHLzrDd5D2+5ur+lD2Vc42pfyeKGXSGAMgfCExnRLlaF+REB36YjRK6hYw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("body hash did not verify") header.d=tethera.net header.s=2024 header.b=jOQNhqef; dmarc=none; spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 135.181.149.255 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org Received: from mail.notmuchmail.org (yantan.tethera.net [135.181.149.255]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id AC30072DFF for ; Wed, 14 Aug 2024 02:08:25 +0200 (CEST) Received: from yantan.tethera.net (localhost [127.0.0.1]) by mail.notmuchmail.org (Postfix) with ESMTP id B22915F421; Wed, 14 Aug 2024 00:08:16 +0000 (UTC) Received: from phubs.tethera.net (phubs.tethera.net [IPv6:2607:5300:60:3a9d::1]) by mail.notmuchmail.org (Postfix) with ESMTPS id 764B45F371 for ; Wed, 14 Aug 2024 00:08:13 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=tethera.net; i=@tethera.net; q=dns/txt; s=2024; t=1723594089; h=from : to : cc : subject : date : message-id : mime-version : content-transfer-encoding : from; bh=0mrDPnQ8UTR9amMtp5V7LOkdW35VqIoecjUVlK+8QJY=; b=jOQNhqef6+vp5iJvERIpPCdXkx8R3Pd09uqtIkluC4IeH3KWn47eqIEGSNgYnrraMFzOh WvdgOAujq0l+GdptP03frwrjuVRsgS1A+na834dMrucPEFBBh2ochPQ93+1uU9USv/Kvi5w +ucusHE1Cq1selzYJor/6Bg/6eUzBZChH1/E6LblN3ii4AOqZgOzEtGYLA2uUXSGYs9ucZ/ IWqQuJ2BJ0bHc+NY4s/ki+/okna9z0b+gTmr88wDVeJnN1XvsvT/kOXdt8oNd7AT08UeivV q7MsGg+xq7pY7btc8gIvBTwrfaHx4Yo1WgS+ggyfz7XwU4/JL3xdSmzEUZ3Q== Received: from tethera.net (fctnnbsc51w-159-2-211-58.dhcp-dynamic.fibreop.nb.bellaliant.net [159.2.211.58]) by phubs.tethera.net (Postfix) with ESMTPS id 6D04618006E; Tue, 13 Aug 2024 21:08:09 -0300 (ADT) Received: (nullmailer pid 1925440 invoked by uid 1000); Wed, 14 Aug 2024 00:08:08 -0000 From: David Bremner To: notmuch@notmuchmail.org Subject: [PATCH] doc/emacs: start a section on notmuch-message-mode Date: Tue, 13 Aug 2024 21:08:05 -0300 Message-ID: <20240814000805.1925418-1-david@tethera.net> X-Mailer: git-send-email 2.43.0 MIME-Version: 1.0 Message-ID-Hash: ZJAX2N62GRGTVT53EE26JM2VQSFVAYEX X-Message-ID-Hash: ZJAX2N62GRGTVT53EE26JM2VQSFVAYEX X-MailFrom: bremner@tethera.net X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-notmuch.notmuchmail.org-0; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header X-Mailman-Version: 3.3.3 Precedence: list List-Id: "Use and development of the notmuch mail system." List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Migadu-Flow: FLOW_IN X-Migadu-Country: DE X-Migadu-Spam-Score: 3.33 X-Spam-Score: 3.33 X-Migadu-Queue-Id: AC30072DFF X-Migadu-Scanner: mx11.migadu.com X-TUID: 3kvCExn4MkRT This is mostly just copying docstrings, but putting them into sections makes them more discoverable. --- doc/conf.py | 2 +- doc/notmuch-emacs.rst | 57 ++++++++++++++++++++++++++++++++++++------- 2 files changed, 49 insertions(+), 10 deletions(-) diff --git a/doc/conf.py b/doc/conf.py index ee1b336a..5270011d 100644 --- a/doc/conf.py +++ b/doc/conf.py @@ -47,7 +47,7 @@ if tags.has('WITH_EMACS'): # Hacky reimplementation of include to workaround limitations of # sphinx-doc lines = ['.. include:: /../emacs/rstdoc.rsti\n\n'] # in the source tree - for file in ('notmuch.rsti', 'notmuch-lib.rsti', 'notmuch-hello.rsti', 'notmuch-show.rsti', 'notmuch-tag.rsti', 'notmuch-tree.rsti'): + for file in ('notmuch.rsti', 'notmuch-lib.rsti', 'notmuch-hello.rsti', 'notmuch-show.rsti', 'notmuch-tag.rsti', 'notmuch-tree.rsti', 'notmuch-maildir-fcc.rsti'): lines.extend(open(rsti_dir+'/'+file)) rst_epilog = ''.join(lines) del lines diff --git a/doc/notmuch-emacs.rst b/doc/notmuch-emacs.rst index 91af6d14..48f87458 100644 --- a/doc/notmuch-emacs.rst +++ b/doc/notmuch-emacs.rst @@ -671,6 +671,54 @@ Keybindings are the same as :any:`notmuch-tree`. See also :el:defcustom:`notmuch-search-result-format` and :el:defcustom:`notmuch-tree-result-format`. +notmuch-message +=============== + +Notmuch uses a slighly customized version of the standard emacs email +composition mode info:message. + +.. _notmuch-emacs-drafts: + +Drafts +------ + +.. el:define-key:: C-x C-p + M-x notmuch-draft-postpone + + Postpone (save and bury) a draft. + +.. el:define-key:: C-x C-s + M-x notmuch-draft-save + + Save a draft and continue editing. + +.. _notmuch-emacs-replies: + +.. _notmuch-emacs-fcc: + +Fcc +--- + +.. el:defcustom:: notmuch-fcc-dirs + + |docstring::notmuch-fcc-dirs| + +.. el:defcustom:: notmuch-maildir-use-notmuch-insert + + |docstring::notmuch-maildir-use-notmuch-insert| + +Replies +------- + +.. el:defcustom:: message-dont-reply-to-names + + When composing mail replies, Emacs's message mode uses the + variable :code:`message-dont-reply-to-names` to exclude + recipients matching a given collection of regular expressions + or satisfying an arbitrary predicate. Notmuch's MUA inherits + this standard mechanism and will honour your customization of + this variable. + Global key bindings =================== @@ -770,15 +818,6 @@ Sending Mail :code:`compose-mail`. To use ``notmuch`` for this, customize this variable to the symbol :code:`notmuch-user-agent`. -.. el:defcustom:: message-dont-reply-to-names - - When composing mail replies, Emacs's message mode uses the - variable :code:`message-dont-reply-to-names` to exclude - recipients matching a given collection of regular expressions - or satisfying an arbitrary predicate. Notmuch's MUA inherits - this standard mechanism and will honour your customization of - this variable. - Init File --------- -- 2.43.0