Reworked the man page system and some man page contents (mmh-intro).

[mmh] / man / mhmail.man1

diff --git a/man/mhmail.man1 b/man/mhmail.man1
new file mode 100644 (file)
index 0000000..ba2edcb
--- /dev/null
+++ b/man/mhmail.man1
@@ -0,0 +1,116 @@
+.\"
+.\" %nmhwarning%
+.\"
+.TH MHMAIL %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.SH NAME
+mhmail \- send or read mail
+.SH SYNOPSIS
+.HP 5
+.na
+.B mhmail
+.RI [ addrs
+\&...]
+.RB [ \-body
+.IR text ]
+.RB [ \-cc
+.I addrs
+\&...]
+.RB [ \-from
+.IR addr ]
+.RB [ \-subject
+.IR subject ]
+.RB [ \-version ]
+.RB [ \-help ]
+.ad
+.SH DESCRIPTION
+.B mhmail
+is intended as a replacement for the standard Berkeley
+mail program
+.RB ( mail
+or
+.BR mailx ),
+which is compatible with
+.BR nmh .
+This program is intended for the use of programs such as
+.BR cron ,
+which expect to send mail automatically to various
+users.  It is also used by various
+.B nmh
+commands to mail various
+error notifications.  Although
+.B mhmail
+can be used interactively,
+it is recommended that
+.B comp
+and
+.B send
+be used instead to send messages.
+.PP
+When invoked without arguments, it simply invokes
+.B inc
+to incorporate new messages from the user's maildrop.  When one or more users
+is specified, a message is read from the standard input and spooled to
+a temporary file.
+.B mhmail
+then invokes
+.B post
+with the
+name of the temporary file as its argument to deliver the message to
+the specified user.
+.PP
+The
+.B \-subject
+.I subject
+switch can be used to specify the
+\*(lqSubject:\*(rq field of the message.
+.PP
+By default,
+.B mhmail
+will read the message to be sent from the
+standard input.  You can specify the text of the message at the command
+line with the
+.B \-body
+.I text
+switch.  If the standard input has zero
+length,
+.B mhmail
+will not send the message.  You can use the switch
+.B \-body
+\*(lq\*(rq to force an empty message.
+.PP
+Normally, addresses appearing as arguments are put in the \*(lqTo:\*(rq
+field.  If the
+.B \-cc
+switch is used, all addresses following it are
+placed in the \*(lqcc:\*(rq field.
+.PP
+By using
+.B \-from
+.IR addr ,
+you can specify the \*(lqFrom:\*(rq header of
+the draft.  Naturally,
+.B post
+will fill\-in the \*(lqSender:\*(rq
+header correctly.
+
+.SH FILES
+.fc ^ ~
+.nf
+.ta \w'%etcdir%/ExtraBigFileName  'u
+^%bindir%/inc~^Program to incorporate maildrop into folder
+^%libdir%/post~^Program to deliver a message
+^/tmp/mhmail*~^Temporary copy of message
+.fi
+
+.SH "SEE ALSO"
+inc(1), post(8)
+
+.SH DEFAULTS
+None
+
+.SH CONTEXT
+If
+.B inc
+is invoked, then
+.BR inc 's
+context changes occur.