Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
NOTMUCH-REPLY(1)		    notmuch		      NOTMUCH-REPLY(1)

NAME
       notmuch-reply - constructs a reply template for a set of	messages

SYNOPSIS
       notmuch reply [option ...] <search-term>	...

DESCRIPTION
       Constructs a reply template for a set of	messages.

       To  make	 replying to email easier, notmuch reply takes an existing set
       of messages and constructs a suitable mail template. Its	To: address is
       set according to	the original email  in	this  way:  if	the  Reply-to:
       header  is  present  and	different from any To:/Cc: address it is used,
       otherwise From: header is used. Unless --reply-to=sender	is  specified,
       values  from  the To: and Cc: headers are copied, but not including any
       of the current user's email addresses (as configured in primary_mail or
       other_email in the .notmuch-config file)	in the recipient list.

       It also builds a	suitable new subject, including	Re: at the  front  (if
       not  already present), and adding the message IDs of the	messages being
       replied to to the References list and setting  the  In-Reply-To:	 field
       correctly.

       Finally,	 the  original	contents of the	emails are quoted by prefixing
       each line with '> ' and included	in the body.

       The resulting message template is output	to stdout.

       Supported options for reply include

       --duplicate=N
	      Reply to duplicate number	N. The numbering starts	 from  1,  and
	      matches  the  order  used	 by show --duplicate and search	--out-
	      put=files.

       --format=(default|json|sexp|headers-only)

	      default
		     Includes subject and quoted message body as an  RFC  2822
		     message.

	      json   Produces  JSON output containing headers for a reply mes-
		     sage and the contents of the original message. This  out-
		     put can be	used by	a client to create a reply message in-
		     telligently.

	      sexp   Produces S-Expression output containing headers for a re-
		     ply  message  and	the  contents of the original message.
		     This output can be	used by	a client  to  create  a	 reply
		     message intelligently.

	      headers-only
		     Only  produces  In-Reply-To,  References, To, Cc, and Bcc
		     headers.

       --format-version=N
	      Use the specified	structured output format version. This is  in-
	      tended  for programs that	invoke notmuch internally. If omitted,
	      the latest supported version will	be used.

       --reply-to=(all|sender)

	      all (default)
		     Replies to	all addresses.

	      sender Replies only to the sender. If  replying  to  user's  own
		     message  (Reply-to:  or From: header is one of the	user's
		     configured	email addresses), try To:, Cc:,	and Bcc: head-
		     ers in this order,	and copy values	from  the  first  that
		     contains something	other than only	the user's addresses.

       --decrypt=(false|auto|true)
	      If  true,	decrypt	any MIME encrypted parts found in the selected
	      content (i.e., "multipart/encrypted" parts). Status of  the  de-
	      cryption	will be	reported (currently only supported with	--for-
	      mat=json and --format=sexp), and on  successful  decryption  the
	      multipart/encrypted  part	will be	replaced by the	decrypted con-
	      tent.

	      If auto, and a session key is already  known  for	 the  message,
	      then  it	will  be decrypted, but	notmuch	will not try to	access
	      the user's secret	keys.

	      Use false	to avoid even automatic	decryption.

	      Non-automatic decryption expects a functioning  gpg-agent(1)  to
	      provide any needed credentials. Without one, the decryption will
	      likely fail.

	      Default: auto

       See  notmuch-search-terms  for  details	of  the	 supported  syntax for
       <search-terms>.

       Note: It	is most	common to use  notmuch	reply  with  a	search	string
       matching	 a  single  message,  (such as id:<message-id>), but it	can be
       useful to reply to several messages at once. For	example, when a	series
       of patches are sent in a	single thread, replying	to the	entire	thread
       allows  for  the	 reply to comment on issues found in multiple patches.
       The default format supports replying to multiple	messages at once,  but
       the JSON	and S-Expression formats do not.

EXIT STATUS
       This command supports the following special exit	status codes

       20     The requested format version is too old.

       21     The requested format version is too new.

SEE ALSO
       notmuch,	 notmuch-config,  notmuch-count,  notmuch-dump,	notmuch-hooks,
       notmuch-insert,	  notmuch-new,	  notmuch-restore,     notmuch-search,
       notmuch-search-terms, notmuch-show, notmuch-tag

AUTHOR
       Carl Worth and many others

COPYRIGHT
       2009-2025, Carl Worth and many others

0.39				 Apr 12, 2025		      NOTMUCH-REPLY(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=notmuch-reply&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help