Factor trim format function out
[mmh] / man / mmh-intro.man7
index 8e408e3..9ae2c67 100644 (file)
@@ -48,7 +48,7 @@ or
 .I \&.cshrc
 in your home directory.  (Check the
 manual entry for the shell you use, in case you don't know how to
-do this.)  Run the
+do this.) Then run the
 .B mmh
 command.  If you've never used
 .B mmh
@@ -102,12 +102,9 @@ with message numbers passed as arguments, to delete specific messages.
 .PP
 .B repl
 is used to respond to the current message (by default).
-It places you in the editor with a prototype response form.  While you're
-in the editor, you may peruse the item you're responding to by reading
-the file
-.IR @ .
+It places you in the editor with a prototype response form.
 After completing your response, type
-.B l
+.B li
 to
 .B list
 (review) it, or
@@ -117,7 +114,7 @@ to
 it.
 .PP
 .B comp
-allows you to compose a message by putting you in the editor
+allows you to compose a fresh message by putting you in the editor
 on a prototype message form, and then lets you send it.
 .PP
 All the
@@ -127,24 +124,25 @@ commands may be run with the single argument:
 which causes them to print a list of the arguments they may be invoked
 with and then exit.
 .PP
-Commands which take a message number as an argument (
-.BR scan ,
+Commands which take a message number as an argument
+.RB ( scan ,
 .BR show ,
 .BR repl ,
-\&...)  also take one of the words: \*(lqfirst\*(rq,
-\*(lqprev\*(rq, \*(lqcur\*(rq, \*(lqnext\*(rq, or \*(lqlast\*(rq to indicate
+\&...)  also take one of the letters: `f',
+`p', `c', `n', or `l' to indicate
 (respectively) the first, previous, current, next, or last message in
 the current folder (assuming they are defined).
 
-Commands which take a range of message numbers (
-.BR rmm ,
+Commands which take a range of message numbers
+.RB ( rmm ,
 .BR scan ,
 .BR show ,
 \&...)  also take any of the abbreviations:
 .PP
 .RS 5
 .IP \fI<num1>\fR\-\fI<num2>\fR 15
-Indicates all messages in the range <num1> to <num2>, inclusive. The range must be nonempty.
+Indicates all messages in the range <num1> to <num2>, inclusive.
+The range must be nonempty.
 .IP \fI<num>\fR:+\fIN\fR 15
 .IP \fI<num>\fR:\-\fIN\fR 15
 Up to
@@ -153,16 +151,16 @@ messages beginning with (or ending with) message
 .IR num .
 .I Num
 may be any of the pre-defined symbols:
-.IR first ,
-.IR prev ,
-.IR cur ,
-.I next
+.IR f ,
+.IR p ,
+.IR c ,
+.I n
 or
-.IR last .
-.IP first:\fIN\fR 15
-.IP prev:\fIN\fR 15
-.IP next:\fIN\fR 15
-.IP last:\fIN\fR 15
+.IR l .
+.IP f:\fIN\fR 15
+.IP p:\fIN\fR 15
+.IP n:\fIN\fR 15
+.IP l:\fIN\fR 15
 The first, previous, next or last
 messages, if they exist.
 .RE
@@ -179,83 +177,35 @@ commands:
 .RS 5
 .fc ^ ~
 .nf
-.ta 1.5i
-^ali(1)~^\- list mail aliases
-^anno(1)~^\- annotate messages
-^burst(1)~^\- explode digests into messages
-^comp(1)~^\- compose a message
-^dist(1)~^\- redistribute a message to additional addresses
-^flist(1)~^\- list folders with messages in given sequence(s)
-^flists(1)~^\- list all folders with messages in given sequence(s)
-^folder(1)~^\- set/list current folder/message
-^folders(1)~^\- list all folders
-^forw(1)~^\- forward messages
-^inc(1)~^\- incorporate new mail
-^mark(1)~^\- mark messages
-^mhbuild(1)~^\- translate MIME composition draft
-^mhl(1)~^\- produce formatted listings of mmh messages
-^mhlist(1)~^\- list information about content of MIME messages
-^mhmail(1)~^\- send mail (mailx replacement)
-^mhparam(1)~^\- print mmh profile components
-^mhpath(1)~^\- print full pathnames of mmh messages and folders
-^mhstore(1)~^\- store contents of MIME messages into files
-^mmh(1)~^\- initialize the mmh environment
-^msgchk(1)~^\- check for messages
-^next(1)~^\- show the next message
-^packf(1)~^\- pack a folder into mbox format
-^pick(1)~^\- select messages by content
-^prev(1)~^\- show the previous message
-^prompter(1)~^\- prompting editor front end
-^rcvdist(1)~^\- asynchronously redistribute new mail
-^rcvpack(1)~^\- asynchronously append a message to an mbox file
-^rcvstore(1)~^\- asynchronously incorporate new mail
-^refile(1)~^\- file messages in other folders
-^repl(1)~^\- reply to a message
-^rmf(1)~^\- remove folder
-^rmm(1)~^\- remove messages
-^scan(1)~^\- produce a one line per message scan listing
-^send(1)~^\- send a message
-^sendfiles(1)~^\- send multiple files and directories in MIME message
-^show(1)~^\- display MIME messages
-^slocal(1)~^\- asynchronously filter and deliver new mail
-^sortm(1)~^\- sort messages
-^whatnow(1)~^\- prompting front\-end for send
+.ta 1.7i
+%titles1%
 .sp
-^ap(8)~^\- parse addresses 822\-style
-^dp(8)~^\- parse dates 822\-style
-^fmtdump(8)~^\- decode \fImmh\fP format files
-^post(8)~^\- deliver a message
+%titles8%
 .fi
 .RE
 .PP
-Theses are descriptions of files and concepts:
+The following man pages describe file formats and concepts:
 .PP
 .RS 5
 .fc ^ ~
 .nf
-.ta 1.5i
-^mh\-alias(5)~^\- alias file for mmh message system
-^mh\-format(5)~^\- format file for mmh message system
-^mh\-mail(5)~^\- message format for mmh message system
-^mh\-profile(5)~^\- user customization for mmh message system
-^mh\-tailor(5)~^\- mail transport customization for mmh message system
+.ta 1.7i
+%titles5%
 .sp
-^mmh(7)~^\- introduction to the mmh message system
-^mh\-draft(7)~^\- draft folder facility
-^mh\-sequence(7)~^\- sequence specification for mmh message system
+%titles7%
 .RE
 
 .SH FILES
 .fc ^ ~
 .nf
-.ta \w'%etcdir%/ExtraBigFileName  'u
+.ta \w'%etcdir%/FileName  'u
 ^%bindir%~^contains \fImmh\fR commands
 ^%etcdir%~^contains \fImmh\fR format files
 ^%libdir%~^contains \fImmh\fR library commands
 ^$HOME/.mmh~^The user's mmh directory
 ^$HOME/.mmh/profile~^The user's profile
 ^$HOME/.mmh/context~^The user's context
-^$HOME/Mail~^The user's mail storage
+^$HOME/Mail~^Default location of the user's mail storage
 .fi
 
 .SH "PROFILE COMPONENTS"
@@ -263,7 +213,7 @@ Theses are descriptions of files and concepts:
 .nf
 .ta 2.4i
 .ta \w'LongName  'u
-^Path:~^To determine the user's mail storage
+^Path:~^Location of the user's mail storage
 .fi
 
 .SH HISTORY
@@ -271,8 +221,7 @@ Theses are descriptions of files and concepts:
 is an experimental version of
 .BR nmh ,
 the New Mail Handler.
-Its name ``mmh'' stands primarily for ``meillo's MH'',
-but also for modern, minimalistic, and non-compatible Mail Handler.
+Its name ``mmh'' stands for ``meillo's mail handler''.
 
 .SH BUGS
 If you encounter problems with an
@@ -280,12 +229,14 @@ If you encounter problems with an
 program, please report them.
 When doing this, include the version information, which you can obtain
 by invoking the program with the
-.B \-version
+.B \-Version
 switch.
 .PP
-Send bug reports and suggestions to
-.IR "markus schnalke <meillo@marmaro.de>" ,
-or (as a fall-back) to
-.IR nmh-workers@nongnu.org .
+Send bug reports, comments, and suggestions to
+.I <mmh@marmaro.de>
+or to
+.IR "markus schnalke <meillo@marmaro.de>" .
+
 .SH "SEE ALSO"
+mmh(1)
 mh-chart(1)