From 65212619232ae84c93c32cbda3828f190e688d22 Mon Sep 17 00:00:00 2001 From: Tobias Angele Date: Mon, 11 Dec 2017 16:32:12 +0100 Subject: [PATCH] man: "mutt" --> "neomutt" * man: "mutt" --> "neomutt" * man: fix debug file and bug tracking system * man: fix file reference * Makefile uses lower-case files. * man: update bugs section, update references --- doc/neomutt.man | 82 +++++++++++++++++++----------------------- doc/neomuttrc.man.head | 46 ++++++++++++------------ doc/neomuttrc.man.tail | 6 ++-- 3 files changed, 63 insertions(+), 71 deletions(-) diff --git a/doc/neomutt.man b/doc/neomutt.man index 74a1251f4..6235fef55 100644 --- a/doc/neomutt.man +++ b/doc/neomutt.man @@ -17,16 +17,16 @@ .\" along with this program; if not, write to the Free Software .\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. .\" -.TH mutt 1 "January 2009" Unix "User Manuals" +.TH neomutt 1 "January 2009" Unix "User Manuals" .SH NAME -mutt \- The Mutt Mail User Agent +neomutt \- The Neomutt Mail User Agent .SH SYNOPSIS .PP -.B mutt +.B neomutt [\-GnRyzZ] [\-e \fIcmd\fP] [\-F \fIfile\fP] [\-g \fIserver\fP] [\-m \fItype\fP] [\-f \fIfile\fP] .PP -.B mutt +.B neomutt [\-Enx] [\-e \fIcmd\fP] [\-F \fIfile\fP] @@ -38,7 +38,7 @@ mutt \- The Mutt Mail User Agent [\-a \fIfile\fP [...] \-\-] \fIaddr|mailto_url\fP [...] .PP -.B mutt +.B neomutt [\-nx] [\-e \fIcmd\fP] [\-F \fIfile\fP] @@ -49,29 +49,29 @@ mutt \- The Mutt Mail User Agent \fIaddr|mailto_url\fP [...] < message .PP -.B mutt +.B neomutt [\-n] [\-e \fIcmd\fP] [\-F \fIfile\fP] \-p .PP -.B mutt +.B neomutt [\-n] [\-e \fIcmd\fP] [\-F \fIfile\fP] \-A \fIalias\fP .PP -.B mutt +.B neomutt [\-n] [\-e \fIcmd\fP] [\-F \fIfile\fP] \-Q \fIquery\fP .PP -.B mutt +.B neomutt \-v[v] .PP -.B mutt +.B neomutt \-D [\-S] .SH DESCRIPTION .PP -Mutt is a small but very powerful text based program for reading and sending electronic +Neomutt is a small but very powerful text based program for reading and sending electronic mail under unix operating systems, including support for color terminals, MIME, OpenPGP, and a threaded sorting mode. .PP .I Note: .IR -This manual page gives a brief overview of mutt's command line +This manual page gives a brief overview of neomutt's command line options. You should find a copy of the full manual in @docdir@, in text, HTML, and/or PDF format. .SH OPTIONS @@ -81,15 +81,15 @@ An expanded version of the given alias is passed to stdout. .IP "-a \fIfile\fP [...]" Attach a file to your message using MIME. When attaching single or multiple files, separating filenames and recipient addresses with -"\-\-" is mandatory, e.g. \fBmutt \-a image.jpg \-\- addr1\fP or -\fBmutt \-a img.jpg *.png \-\- addr1 addr2\fP. +"\-\-" is mandatory, e.g. \fBneomutt \-a image.jpg \-\- addr1\fP or +\fBneomutt \-a img.jpg *.png \-\- addr1 addr2\fP. The \-a option must be placed at the end of command line options. .IP "-b \fIaddress\fP" Specify a blind-carbon-copy (BCC) recipient .IP "-c \fIaddress\fP" Specify a carbon-copy (CC) recipient .IP "-d \fIlevel\fP" -If mutt was compiled with +DEBUG log debugging output to ~/.neomuttdebug0. +log debugging output to ~/.neomuttdebug0. \fILevel\fP can range from 1-5 and effects verbosity. A value of 2 is recommended. .IP "-D" @@ -104,12 +104,12 @@ Specify a configuration command to be run after processing of initialization files. .IP "-f \fImailbox\fP" Specify which mailbox to load. -.IP "-F \fImuttrc\fP" -Specify an initialization file to read instead of ~/.muttrc +.IP "-F \fIneomuttrc\fP" +Specify an initialization file to read instead of ~/.neomuttrc .IP "-g \fIserver\fP" -Start Mutt with a listing of subscribed newsgroups at specified news server. +Start Neomutt with a listing of subscribed newsgroups at specified news server. .IP "-G" -Start Mutt with a listing of subscribed newsgroups. +Start Neomutt with a listing of subscribed newsgroups. .IP "-h" Display help. .IP "-H \fIdraft\fP" @@ -120,7 +120,7 @@ Specify a file to include into the body of a message. .IP "-m \fItype\fP " specify a default mailbox type for newly created folders. .IP "-n" -Causes Mutt to bypass the system configuration file. +Causes Neomutt to bypass the system configuration file. .IP "-p" Resume a postponed message. .IP "-Q \fIquery\fP" @@ -132,19 +132,19 @@ Open a mailbox in \fIread-only\fP mode. .IP "-s \fIsubject\fP" Specify the subject of the message. .IP "-v" -Display the Mutt version number and compile-time definitions. +Display the Neomutt version number and compile-time definitions. .IP "-vv" Display license and copyright information. .IP "-x" Emulate the mailx compose mode. .IP "-y" -Start Mutt with a listing of all mailboxes specified by the \fImailboxes\fP +Start Neomutt with a listing of all mailboxes specified by the \fImailboxes\fP command. .IP "-z" -When used with \-f, causes Mutt not to start if there are no messages in the +When used with \-f, causes Neomutt not to start if there are no messages in the mailbox. .IP "-Z" -Causes Mutt to open the first mailbox specified by the \fImailboxes\fP +Causes Neomutt to open the first mailbox specified by the \fImailboxes\fP command which contains new mail. .IP "--" Treat remaining arguments as \fIaddr\fP even if they start with a dash. @@ -170,7 +170,7 @@ Path to search for mailcap files. If this variable is set, mailcap are always used without prompting first. .IP "PGPPATH" Directory in which the user's PGP public keyring can be found. When used with -the original PGP program, mutt and +the original PGP program, neomutt and .B pgpring (1) rely on this being set. .IP "TMPDIR" @@ -181,12 +181,12 @@ Default Reply-To address. Specifies the editor to use when composing messages. .SH FILES .PP -.IP "~/.muttrc or ~/.mutt/muttrc" +.IP "~/.neomuttrc or ~/.neomutt/neomuttrc" User configuration file. -.IP "@sysconfdir@/Muttrc" +.IP "@sysconfdir@/neomuttrc" System-wide configuration file. -.IP "/tmp/muttXXXXXX" -Temporary files created by Mutt. +.IP "/tmp/neomuttXXXXXX" +Temporary files created by Neomutt. .IP "~/.mailcap" User definition for handling non-text MIME types. .IP "@sysconfdir@/mailcap" @@ -196,20 +196,10 @@ User's personal mapping between MIME types and file extensions. .IP "@sysconfdir@/mime.types" System mapping between MIME types and file extensions. .IP "@docdir@/manual.txt" -The Mutt manual. +The Neomutt manual. .SH BUGS .PP -None. Mutts have fleas, not bugs. -.SH FLEAS -.PP -Resizing the screen while using an external pager causes Mutt to go haywire -on some systems. -.PP -The help line for the index menu is not updated if you change the bindings -for one of the functions listed while Mutt is running. -.PP -For a more up-to-date list of bugs, errm, fleas, please visit the -mutt project's bug tracking system under http://bugs.mutt.org/. +See https://github.com/neomutt/neomutt/issues .SH NO WARRANTIES This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -220,16 +210,18 @@ GNU General Public License for more details. .BR curses (3), .BR mailcap (5), .BR maildir (5), +.BR notmuch (1), +.BR msmtp (1), .BR mbox (5), -.BR muttrc (5), +.BR neomuttrc (5), .BR ncurses (3), .BR sendmail (1), .BR smail (1). .PP -Mutt Home Page: http://www.mutt.org/ +Neomutt Home Page: http://www.neomutt.org/ .PP -The Mutt manual +The Neomutt manual .SH AUTHOR .PP -Michael Elkins, and others. Use to contact +Michael Elkins, and others. Use to contact the developers. diff --git a/doc/neomuttrc.man.head b/doc/neomuttrc.man.head index b4d6acf5d..39526c645 100644 --- a/doc/neomuttrc.man.head +++ b/doc/neomuttrc.man.head @@ -26,12 +26,12 @@ .ft .fi .. -.TH muttrc 5 "September 2002" Unix "User Manuals" +.TH neomuttrc 5 "September 2002" Unix "User Manuals" .SH NAME -muttrc \- Configuration file for the Mutt Mail User Agent +neomuttrc \- Configuration file for the Mutt Mail User Agent .SH DESCRIPTION .PP -A mutt configuration file consists of a series of \(lqcommands\(rq. +A neomutt configuration file consists of a series of \(lqcommands\(rq. Each line of the file may contain one or more commands. When multiple commands are used, they must be separated by a semicolon (\(lq\fB;\fP\(rq). @@ -115,9 +115,9 @@ display to messages matching a group. \fBunalternates\fP [\fB * \fP | \fIregex\fP [ \fIregex\fP [ ... ]] ] .fi .IP -\fBalternates\fP is used to inform mutt about alternate addresses +\fBalternates\fP is used to inform neomutt about alternate addresses where you receive mail; you can use regular expressions to specify -alternate addresses. This affects mutt's idea about messages +alternate addresses. This affects neomutt's idea about messages from you, and messages addressed to you. \fBunalternates\fP removes a regular expression from the list of known alternates. The \fB-group\fP flag causes all of the subsequent regular expressions to be added to the named group. @@ -128,7 +128,7 @@ causes all of the subsequent regular expressions to be added to the named group. .fi .IP \fBalternative_order\fP command permits you to define an order of preference which is -used by mutt to determine which part of a +used by neomutt to determine which part of a \fBmultipart/alternative\fP body to display. A subtype of \(lq\fB*\fP\(rq matches any subtype, as does an empty subtype. \fBunalternative_order\fP removes entries from the @@ -140,7 +140,7 @@ as an argument. \fBunauto_view\fP \fItype\fP[\fB/\fP\fIsubtype\fP] [ ... ] .fi .IP -This commands permits you to specify that mutt should automatically +This commands permits you to specify that neomutt should automatically convert the given MIME types to text/plain when displaying messages. For this to work, there must be a .BR mailcap (5) @@ -155,7 +155,7 @@ matches any subtype, as does an empty subtype. .fi .IP This command permits you to define a list of "data" MIME content -types for which mutt will try to determine the actual file type from +types for which neomutt will try to determine the actual file type from the file name, and not use a .BR mailcap (5) entry given for the original MIME type. For instance, you may add @@ -184,7 +184,7 @@ to adjust configuration settings to different IMAP or POP servers. \fBcharset-hook\fP \fIalias\fP \fIcharset\fP This command defines an alias for a character set. This is useful to properly display messages which are tagged with a character set -name not known to mutt. +name not known to neomutt. .TP \fBiconv-hook\fP \fIcharset\fP \fIlocal-charset\fP This command defines a system-specific name for a character set. @@ -200,7 +200,7 @@ In this specific case, you'd put this into your configuration file: .B "iconv-hook iso-8859-1 8859-1" .TP \fBmessage-hook\fP [\fB!\fP]\fIpattern\fP \fIcommand\fP -Before mutt displays (or formats for replying or forwarding) a +Before neomutt displays (or formats for replying or forwarding) a message which matches the given \fIpattern\fP (or, when it is preceded by an exclamation mark, does not match the \fIpattern\fP), the given \fIcommand\fP is executed. When multiple @@ -212,15 +212,15 @@ Run a command periodically when Mutt checks for new mail. This hook is called every $timeout seconds. .TP \fBstartup-hook\fP \fIcommand\fP -Before mutt opens the first mailbox when first starting, mutt will run the +Before neomutt opens the first mailbox when first starting, mutt will run the startup hook for the given \fIcommand\fP. .TP \fBshutdown-hook\fP \fIcommand\fP -Before mutt is about to exit, and before the mailbox is closed, mutt will run +Before neomutt is about to exit, and before the mailbox is closed, mutt will run the shutdown hook for the given \fIcommand\fP. .TP \fBfolder-hook\fP [\fB!\fP]\fIregex\fP \fIcommand\fP -When mutt enters a folder which matches \fIregex\fP (or, when +When neomutt enters a folder which matches \fIregex\fP (or, when \fIregex\fP is preceded by an exclamation mark, does not match \fIregex\fP), the given \fIcommand\fP is executed. .IP @@ -297,7 +297,7 @@ it from the list of subscribed mailing lists. The \fB-group\fP flag adds all of the subsequent regular expressions to the named group. .TP \fBmbox-hook\fP [\fB!\fP]\fIregex\fP \fImailbox\fP -When mutt changes to a mail folder which matches \fIregex\fP, +When neomutt changes to a mail folder which matches \fIregex\fP, \fImailbox\fP will be used as the \(lqmbox\(rq folder, i.e., read messages will be moved to that folder when the mail folder is left. .IP @@ -325,7 +325,7 @@ the messages you compose. \fBunmy_hdr\fP will remove the given user-defined headers. .TP \fBhdr_order\fP \fIheader1\fP \fIheader2\fP [ ... ] -With this command, you can specify an order in which mutt will +With this command, you can specify an order in which neomutt will attempt to present headers to you when viewing messages. .TP \fBsave-hook\fP [\fB!\fP]\fIpattern\fP \fIfilename\fP @@ -437,7 +437,7 @@ The given file will be evaluated as a configuration file. .fi .IP These commands define spam-detection patterns from external spam -filters, so that mutt can sort, limit, and search on +filters, so that neomutt can sort, limit, and search on ``spam tags'' or ``spam attributes'', or display them in the index. See the Mutt manual for details. .TP @@ -459,13 +459,13 @@ the generated message. By default the list contains mailto links from mailing lists. .SH PATTERNS .PP -In various places with mutt, including some of the above mentioned +In various places with neomutt, including some of the above mentioned \fBhook\fP commands, you can specify patterns to match messages. .SS Constructing Patterns .PP A simple pattern consists of an operator of the form \(lq\fB~\fP\fIcharacter\fP\(rq, possibly followed by a parameter -against which mutt is supposed to match the object specified by +against which neomutt is supposed to match the object specified by this operator. For some \fIcharacter\fPs, the \fB~\fP may be replaced by another character to alter the behavior of the match. These are described in the list of operators, below. @@ -478,12 +478,12 @@ hat (\(lq\fB^\fP\(rq) character to such a pattern to indicate that .PP You can construct complex patterns by combining simple patterns with logical operators. Logical AND is specified by simply concatenating -two simple patterns, for instance \(lq~C mutt-dev ~s bug\(rq. +two simple patterns, for instance \(lq~C neomutt-dev ~s bug\(rq. Logical OR is specified by inserting a vertical bar (\(lq\fB|\fP\(rq) -between two patterns, for instance \(lq~C mutt-dev | ~s bug\(rq. +between two patterns, for instance \(lq~C neomutt-dev | ~s bug\(rq. Additionally, you can negate a pattern by prepending a bang (\(lq\fB!\fP\(rq) character. For logical grouping, use braces -(\(lq()\(rq). Example: \(lq!(~t mutt|~c mutt) ~f elkins\(rq. +(\(lq()\(rq). Example: \(lq!(~t neomutt|~c mutt) ~f elkins\(rq. .SS Simple Patterns .PP Mutt understands the following simple patterns: @@ -665,12 +665,12 @@ followed by a year specifications. Omitted fields default to the current month and year. .PP Mutt understands either two or four digit year specifications. When -given a two-digit year, mutt will interpret values less than 70 as +given a two-digit year, neomutt will interpret values less than 70 as lying in the 21st century (i.e., \(lq38\(rq means 2038 and not 1938, and \(lq00\(rq is interpreted as 2000), and values greater than or equal to 70 as lying in the 20th century. .PP -Note that this behavior \fIis\fP Y2K compliant, but that mutt +Note that this behavior \fIis\fP Y2K compliant, but that neomutt \fIdoes\fP have a Y2.07K problem. .PP If a date range consists of a single date, the operator in question diff --git a/doc/neomuttrc.man.tail b/doc/neomuttrc.man.tail index 1c780dff4..d8d788d45 100644 --- a/doc/neomuttrc.man.tail +++ b/doc/neomuttrc.man.tail @@ -11,10 +11,10 @@ .BR regex (7), .BR strftime (3) .PP -The Mutt Manual +The Neomutt Manual .PP -The Mutt home page: http://www.mutt.org/ +The Neomutt home page: http://www.neomutt.org/ .SH AUTHOR .PP -Michael Elkins, and others. Use to contact +Michael Elkins, and others. Use to contact the developers. -- 2.40.0