Annotation of 43BSD/contrib/mh/doc/comp.me, revision 1.1.1.1

1.1       root        1: .\"    This file is automatically generated.  Do not edit!
                      2: .TH COMP 1 "April 22, 1986" MH [mh.6]
                      3: .UC 6
                      4: .SH NAME
                      5: comp \- compose a message
                      6: .SH SYNOPSIS
                      7: .in +.5i
                      8: .ti -.5i
                      9: comp 
                     10: \%[+folder] \%[msg]
                     11: \%[\-draftfolder\ +folder] \%[\-draftmessage\ msg] \%[\-nodraftfolder]
                     12: \%[\-editor\ editor] \%[\-noedit]
                     13: \%[\-file\ file]
                     14: \%[\-form\ formfile]
                     15: \%[\-use] \%[\-nouse]
                     16: \%[\-whatnowproc\ program] \%[\-nowhatnowproc]
                     17: \%[\-help]
                     18: .in -.5i
                     19: .SH DESCRIPTION
                     20: \fIComp\fR is used to create a new message to be mailed.
                     21: It copies a message form to
                     22: the draft being composed and then invokes an editor on the draft
                     23: (unless `\-noedit' is given, in which case the initial edit is suppressed).
                     24: 
                     25: The default message form contains the following elements:
                     26: 
                     27: .nf
                     28: .in +.5i
                     29: .ne 10
                     30: .eo
                     31: .so /usr/new/lib/mh/components
                     32: .ec
                     33: .in -.5i
                     34: .fi
                     35: 
                     36: If the file named \*(lqcomponents\*(rq exists in the user's MH directory,
                     37: it will be used instead of this form.
                     38: The file specified by `\-form\ formfile' will be used if given.
                     39: You may also start \fIcomp\fR using the contents of an existing
                     40: message as the form.
                     41: If you supply either a `+folder' or `msg' argument, that message will be used
                     42: as the form.  You may not supply both a `\-form\ formfile' and a `+folder' or
                     43: \&`msg' argument.
                     44: The line of dashes
                     45: or a blank line must be left between the header and the
                     46: body of the message for the message to be identified properly when it is
                     47: sent (see \fIsend\fR\0(1)).
                     48: The switch `\-use' directs \fIcomp\fR to
                     49: continue editing an already started message.
                     50: That is, if a
                     51: \fIcomp\fR (or \fIdist\fR, \fIrepl\fR, or \fIforw\fR\0) is terminated without
                     52: sending the draft, the draft can be edited again via
                     53: \*(lqcomp\ \-use\*(rq.
                     54: 
                     55: If the draft already exists, \fIcomp\fR will ask
                     56: you as to the disposition of the draft.
                     57: A reply of \fBquit\fR will abort \fIcomp\fR, leaving the draft intact;
                     58: \fBreplace\fR will replace the existing draft with the appropriate form;
                     59: \fBlist\fR will display the draft;
                     60: \fBuse\fR will use the draft for further composition;
                     61: and \fBrefile\ +folder\fR will
                     62: file the draft in the given folder, and give you a new draft with the
                     63: appropriate form.
                     64: (The `+folder' argument to \fBrefile\fR is required.)
                     65: 
                     66: The `\-draftfolder\ +folder' and `\-draftmessage\ msg' switches invoke the
                     67: \fIMH\fR draft folder facility.
                     68: This is an advanced (and highly useful) feature.
                     69: Consult the \fBAdvanced Features\fR section of the \fIMH\fR manual for more
                     70: information.
                     71: 
                     72: The `\-file\ file' switch says to use the named file as the message draft.
                     73: 
                     74: Upon exiting from the editor,
                     75: \fIcomp\fR will invoke the \fIwhatnow\fR program.
                     76: See \fIwhatnow\fR\0(1) for a discussion of available options.
                     77: The invocation of this program can be inhibited by using the `\-nowhatnowproc'
                     78: switch.
                     79: (In truth of fact,
                     80: it is the \fIwhatnow\fR program which starts the initial edit.
                     81: Hence, `\-nowhatnowproc' will prevent any edit from occurring.)
                     82: .Fi
                     83: ^/usr/new/lib/mh/components~^The message skeleton
                     84: ^or <mh\-dir>/components~^Rather than the standard skeleton
                     85: ^$HOME/\&.mh\(ruprofile~^The user profile
                     86: ^<mh\-dir>/draft~^The draft file
                     87: .Pr
                     88: ^Path:~^To determine the user's MH directory
                     89: .Ps
                     90: ^Draft\-Folder:~^To find the default draft\-folder
                     91: .Ps
                     92: ^Editor:~^To override the default editor
                     93: .Ps
                     94: ^Msg\-Protect:~^To set mode when creating a new message (draft)
                     95: .Ps
                     96: ^fileproc:~^Program to refile the message
                     97: .Ps
                     98: ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
                     99: .Sa
                    100: dist(1), forw(1), repl(1), send(1), whatnow(1)
                    101: .De
                    102: `+folder' defaults to the current folder
                    103: .Ds
                    104: `msg' defaults to the current message
                    105: .Ds
                    106: `\-nodraftfolder'
                    107: .Ds
                    108: `\-nouse'
                    109: .Co
                    110: None
                    111: .Bu
                    112: If \fIwhatnowproc\fR is \fIwhatnow\fR,
                    113: then \fIcomp\fR uses a built\-in \fIwhatnow\fR,
                    114: it does not actually run the \fIwhatnow\fR program.
                    115: Hence, if you define your own \fIwhatnowproc\fR,
                    116: don't call it \fIwhatnow\fR since \fIcomp\fR won't run it.
                    117: .En

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.