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

1.1       root        1: .\"    This file is automatically generated.  Do not edit!
                      2: .TH SEND 1 "April 22, 1986" MH [mh.6]
                      3: .UC 6
                      4: .SH NAME
                      5: send \- send a message
                      6: .SH SYNOPSIS
                      7: .in +.5i
                      8: .ti -.5i
                      9: send
                     10: \%[\-alias\ aliasfile]
                     11: \%[\-draft]
                     12: \%[\-draftfolder\ +folder] \%[\-draftmessage\ msg] \%[\-nodraftfolder]
                     13: \%[\-filter\ filterfile] \%[\-nofilter]
                     14: \%[\-format] \%[\-noformat]
                     15: \%[\-forward] \%[\-noforward]
                     16: \%[\-msgid] \%[\-nomsgid]
                     17: \%[\-push] \%[\-nopush]
                     18: \%[\-verbose] \%[\-noverbose]
                     19: \%[\-watch] \%[\-nowatch]
                     20: \%[\-width\ columns]
                     21: \%[file\ ...] 
                     22: \%[\-help]
                     23: .in -.5i
                     24: .SH DESCRIPTION
                     25: \fISend\fR will cause each of the specified files to
                     26: be delivered (via \fIpost\fR\0(8)) to each of the destinations
                     27: in the \*(lqTo:\*(rq, \*(lqcc:\*(rq, \*(lqBcc:\*(rq, and \*(lqFcc:\*(rq
                     28: fields of the message.
                     29: If \fIsend\fR is re\-distributing a message, as invoked from \fIdist\fR,
                     30: then the corresponding \*(lqResent\-xxx\*(rq fields are examined
                     31: instead.
                     32: 
                     33: If `\-push' is specified,
                     34: \fIsend\fR will detach itself from the user's terminal and perform its
                     35: actions in the background.
                     36: If \fIpush\fR\0'd and the draft can't be sent,
                     37: then the `\-forward' switch says that draft should be forwarded with
                     38: the failure notice sent to the user.
                     39: This differs from putting \fIsend\fR in the background because the output is
                     40: trapped and analyzed by \fIMH\fR.
                     41: 
                     42: If `\-verbose' is specified, \fIsend\fR will indicate the interactions
                     43: occurring with the transport system, prior to actual delivery.
                     44: If `\-watch' is specified \fIsend\fR will monitor the delivery of local and
                     45: network mail.  Hence, by specifying both switches, a large detail of 
                     46: information can be gathered about each step of the message's entry into the
                     47: transport system.
                     48: 
                     49: The `\-draftfolder\ +folder' and `\-draftmessage\ msg' switches invoke the
                     50: \fIMH\fR draft folder facility.
                     51: This is an advanced (and highly useful) feature.
                     52: Consult the \fBAdvanced Features\fR section of the \fIMH\fR manual for more
                     53: information.
                     54: 
                     55: \fISend\fR with no \fIfile\fR
                     56: argument will query whether the draft is the intended file, whereas
                     57: `\-draft' will suppress this question.
                     58: Once the transport system has successfully accepted custody of the message,
                     59: the file will be renamed
                     60: with a leading comma, which allows it to be retrieved until the
                     61: next draft message is sent.
                     62: If there are errors in the
                     63: formatting of the message, \fIsend\fR will abort with a (hopefully)
                     64: helpful error message.
                     65: 
                     66: If a \*(lqBcc:\*(rq field is encountered,
                     67: its addresses will be used for delivery,
                     68: and the \*(lqBcc:\*(rq field will be removed from the message sent to sighted
                     69: recipients.
                     70: The blind recipients will receive an entirely new message with
                     71: a minimal set of headers.
                     72: Included in the body of the message will be a copy of the message sent to the
                     73: sighted recipients.
                     74: If `\-filter\ filterfile' is specified,
                     75: then this copy is filtered (re\-formatted)
                     76: prior to being sent to the blind recipients.
                     77: 
                     78: Prior to sending the message, the fields \*(lqFrom:\ user@local\*(rq, and
                     79: \*(lqDate:\ now\*(rq will be appended to the headers in the message.
                     80: If the envariable \fB$SIGNATURE\fR is set,
                     81: then its value is used as your personal name when
                     82: constructing the \*(lqFrom:\*(rq line of the message.
                     83: If this envariable is not set,
                     84: then \fIsend\fR will consult the profile entry \*(lqSignature\*(rq
                     85: for this information.
                     86: On hosts where \fIMH\fR was configured with the UCI option,
                     87: if \fB$SIGNATURE\fR is not set and the \*(lqSignature\*(rq profile entry
                     88: is not present,
                     89: then the file \fB$HOME\fR/.signature is consulted.
                     90: If `\-msgid' is
                     91: specified, then a \*(lqMessage\-ID:\*(rq field will also be added to the
                     92: message.
                     93: 
                     94: If \fIsend\fR is re\-distributing a message
                     95: (when invoked by \fIdist\fR\0),
                     96: then \*(lqResent\-\*(rq will be prepended to each of these fields:
                     97: \*(lqFrom:\*(rq, \*(lqDate:\*(rq, and \*(lqMessage\-ID:\*(rq.
                     98: If the message already contains a \*(lqFrom:\*(rq field, then a
                     99: \*(lqSender: user@local\*(rq field will be added as well.
                    100: (An already existing
                    101: \*(lqSender:\*(rq field is an error!)
                    102: 
                    103: By using the `\-format' switch,
                    104: each of the entries in
                    105: the \*(lqTo:\*(rq and \*(lqcc:\*(rq fields will be replaced
                    106: with \*(lqstandard\*(rq format entries.
                    107: This standard format is designed to be usable by all
                    108: of the message handlers on the various systems around the
                    109: Internet.
                    110: If `\-noformat' is given,
                    111: then headers are output exactly as they appear in the message draft.
                    112: 
                    113: If an \*(lqFcc:\ folder\*(rq is encountered, the message will be copied
                    114: to the specified folder for the sender in the format in which it will appear
                    115: to any non\-Bcc receivers of the message.
                    116: That is, it will have the appended
                    117: fields and field reformatting.
                    118: The \*(lqFcc:\*(rq fields will be removed from all outgoing copies of the
                    119: message.
                    120: 
                    121: By using the `\-width\ columns' switch, the user can direct \fIsend\fR as to
                    122: how long it should make header lines containing addresses.
                    123: 
                    124: By using the `\-alias\ aliasfile' switch, the user can direct \fIsend\fR
                    125: to consult the named files for alias definitions
                    126: (more than one file, each  preceded by `\-alias', can be named).
                    127: See \fImh\-alias\fR\0(5) for more information.
                    128: .Fi
                    129: ^$HOME/\&.mh\(ruprofile~^The user profile
                    130: .Pr
                    131: ^Path:~^To determine the user's MH directory
                    132: .Ps
                    133: ^Draft\-Folder:~^To find the default draft\-folder
                    134: .Ps
                    135: ^Signature:~^To determine the user's mail signature
                    136: .Ps
                    137: mailproc:~^Program to post failure notices
                    138: .Ps
                    139: ^postproc:~^Program to post the message
                    140: .Sa
                    141: comp(1), dist(1), forw(1), repl(1), mh\-alias(5), post(8)
                    142: .De
                    143: `file' defaults to <mh\-dir>/draft
                    144: .Ds
                    145: `\-alias /usr/new/lib/mh/MailAliases'
                    146: .Ds
                    147: `\-nodraftfolder'
                    148: .Ds
                    149: `\-nofilter'
                    150: .Ds
                    151: `\-format'
                    152: .Ds
                    153: `\-forward'
                    154: .Ds
                    155: `\-nomsgid'
                    156: .Ds
                    157: `\-nopush'
                    158: .Ds
                    159: `\-noverbose'
                    160: .Ds
                    161: `\-nowatch'
                    162: .Ds
                    163: `\-width\ 72'
                    164: .Co
                    165: None
                    166: .En

unix.superglobalmegacorp.com

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