Factor trim format function out

[mmh] / man / mmh-intro.man7

diff --git a/man/mmh-intro.man7 b/man/mmh-intro.man7
index 7686ac1..9ae2c67 100644 (file)
--- a/man/mmh-intro.man7
+++ b/man/mmh-intro.man7
@@ -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
 .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
 .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).
 .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
 After completing your response, type

-.B l
+.B li

 to
 .B list
 (review) it, or
 to
 .B list
 (review) it, or

@@ -117,7 +114,7 @@ to
 it.
 .PP
 .B comp
 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
 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
 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 ,
 .BR show ,
 .BR repl ,

-\&...)  also take one of the words: `first',
-`prev', `cur', `next', or `last' 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).
 
 (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
 .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
 .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 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
 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
 The first, previous, next or last
 messages, if they exist.
 .RE

@@ -179,84 +177,35 @@ commands:
 .RS 5
 .fc ^ ~
 .nf
 .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
-^mhsign(1)~^\- sign or encrypt a message with gnupg
-^mhstore(1)~^\- store contents of MIME messages into files
-^mmh(1)~^\- initialize the mmh environment
-^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
-^whom(1)~^\- list recipients of a message
+.ta 1.7i
+%titles1%

 .sp
 .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
 .fi
 .RE
 .PP

-Theses are descriptions of files and concepts:
+The following man pages describe file formats and concepts:

 .PP
 .RS 5
 .fc ^ ~
 .nf
 .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
 .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
 .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
 ^%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"
 .fi
 
 .SH "PROFILE COMPONENTS"

@@ -264,7 +213,7 @@ Theses are descriptions of files and concepts:
 .nf
 .ta 2.4i
 .ta \w'LongName  'u
 .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
 .fi
 
 .SH HISTORY

@@ -272,8 +221,7 @@ Theses are descriptions of files and concepts:
 is an experimental version of
 .BR nmh ,
 the New Mail Handler.
 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
 
 .SH BUGS
 If you encounter problems with an

@@ -284,9 +232,11 @@ by invoking the program with the
 .B \-Version
 switch.
 .PP
 .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"
 .SH "SEE ALSO"

+mmh(1)

 mh-chart(1)
 mh-chart(1)