MH Mail 'submit' man page

[teklabs!tekmdp!azure!stevenm]

Ooops, I forgot to submit this with the other batch of MH stuff

##############
# submit.1   #
##############


.TH SUBMIT 1T "6/24/81 Tek Local"
.SH NAME
submit \- submit notes to Duke NetNews
.SH SYNOPSIS
.B submit
[
.B \-editor
editor] [
.B \-form
formfile]
.br
[
.B \-use
] [
.B \-nouse
] [
.B \-help
]
.sp
.B post ...
.SH DESCRIPTION
.I Submit
(or
.I post)
is used to submit an article to one or more newsgroups in the
Duke News system.
.I Submit
provides an interface to the
.I News
program which looks more like the Rand MH system.
For more information on the News System, see the manual
page entry for
.I news.
.LP
.I Submit
copies an article form to
the file <mh-dir>/ndraft and then invokes an editor on the
file.
The default editor is /etc/mh/prompter, which may be overridden with
the
.B \-editor
switch or with a profile entry 'Editor:' or with
the environment variable 'SEDIT'.
(See prompter(1) for details).
The default bulletin form contains the following elements:
.nf
.LP
     Newsgroups:
     Subject:
     ----------
.LP
.fi
If the file named 'newscomps' exists in the user's MH directory,
it will be used instead of this form.
If
.B "\-form formfile"
is specified, the specified formfile (from the MH
directory) will be used as the skeleton.
The line of dashes
or a blank line must be left between the header and the
body of the bulletin for the bulletin to be identified properly when it is
posted.
If the heading 'Newsgroups:' is found, the following names will be
added to the list of newsgroups to which the article will be sent.
The switch
.B \-use
directs
.I submit
to continue editing an already started bulletin.
That is, if \fIsubmit\fP is terminated without posting the bulletin,
the bulletin can be edited again via \&'submit \-use'.
.LP
If the draft file already exists,
.I submit
will ask if you want to delete it before continuing.
A reply of
.B No
will abort the \fIsubmit\fP,
.B yes
will replace the existing draft with a blank
skeleton,
.B list
will display the draft, and
.B use
will use it
for further composition.
.LP
Upon exiting from the editor,
.I submit
will ask 'What now?'.
The valid
responses are \fBlist\fP, to list the draft on the terminal;
\fBformat\fP, to pretty up the bulletin (see fmt(1);
\fBquit\fP, to terminate the session and preserve the draft;
\fBquit\ delete\fP, to terminate, then delete the draft;
\fBsubmit\fP, to submit the article;
from that specified on the command line; 
\fBedit\ <editor>\fP, to invoke <editor> for further editing; and
\fBedit\fP, to re-edit using the same editor that was used on the
preceding round unless a profile entry '<lasteditor>\-next: <editor>'
names an alternative editor.
If the editor used on the preceding round was 'prompter',
the system acts as if there was a profile entry of the form
\&'prompter-next:\ EDIT' where EDIT is the taken from the environment
variable EDIT.
.SH SEE ALSO
comp(1), fmt(1), prompter(1), post(1)
.SH FILES
.ta 24m
.nf
LIBDIR/newscomps	The bulletin skeleton
or <mh-dir>/newscomps	Rather than the standard skeleton
<mh-dir>/ndraft	The bulletin file
/usr/bin/inews	The actual news server
.fi
.SH PROFILE COMPONENTS
.ta 24m
.nf
Path:	To determine the user's MH directory
Editor:	To override the use of /etc/mh/prompter
	as the default editor
<lasteditor>\-next:	To name an editor to be used after exit
	from <lasteditor>
.fi
.SH DEFAULTS
.nf
\&'\-editor' defaults to /etc/mh/prompter
\&'\-nouse'
.fi
.SH CONTEXT
.I Submit
does not affect the MH mail context in any way.
.SH HISTORY
This is a hack on Steve Glaser's 'post', which was a hack on something
else. S. Mcgeady 6/24/81.