Return to dist.rf CVS log

Up to [CSRG BSD Unix] / 43BSD / contrib / mh / conf / doc

Annotation of 43BSD/contrib/mh/conf/doc/dist.rf, revision 1.1

1.1     ! root        1: .\"    @(MHWARNING)
        !             2: .TH DIST 1 "April 22, 1986" MH [mh.6]
        !             3: .UC 6
        !             4: .SH NAME
        !             5: dist \- redistribute a message to additional addresses
        !             6: .SH SYNOPSIS
        !             7: .in +.5i
        !             8: .ti -.5i
        !             9: dist
        !            10: \%[+folder] \%[msg] 
        !            11: \%[\-annotate] \%[\-noannotate] 
        !            12: \%[\-draftfolder\ +folder] \%[\-draftmessage\ msg] \%[\-nodraftfolder]
        !            13: \%[\-editor\ editor] \%[\-noedit]
        !            14: \%[\-form\ formfile] 
        !            15: \%[\-inplace] \%[\-noinplace] 
        !            16: \%[\-whatnowproc\ program] \%[\-nowhatnowproc]
        !            17: \%[\-help]
        !            18: .in -.5i
        !            19: .SH DESCRIPTION
        !            20: \fIDist\fR is similar to \fIforw\fR.
        !            21: It prepares the specified
        !            22: message for redistribution to addresses that (presumably) are
        !            23: not on the original address list.
        !            24: 
        !            25: The default message form contains the following elements:
        !            26: 
        !            27: .nf
        !            28: .in +.5i
        !            29: .ne 10
        !            30: .eo
        !            31: .so @(MHETCPATH)/distcomps
        !            32: .ec
        !            33: .in -.5i
        !            34: .fi
        !            35: 
        !            36: If the file named \*(lqdistcomps\*(rq exists in the user's MH directory,
        !            37: it will be used instead of this form.
        !            38: In either case, the file specified by `\-form\ formfile' will be
        !            39: used if given.
        !            40: The form used will be prepended to the message being resent.
        !            41: 
        !            42: If the draft already exists,
        !            43: \fIdist\fR will ask you as to the disposition of the draft.
        !            44: A reply of \fBquit\fR will abort \fIdist\fR, leaving the draft intact;
        !            45: \fBreplace\fR will replace the existing draft with a blank skeleton;
        !            46: and \fBlist\fR will display the draft.
        !            47: 
        !            48: Only those addresses in \*(lqResent\-To:\*(rq, \*(lqResent\-cc:\*(rq, and
        !            49: \*(lqResent\-Bcc:\*(rq will be sent.
        !            50: Also, a \*(lqResent\-Fcc:\ folder\*(rq will be honored (see \fIsend\fR\0(1)).
        !            51: Note that with \fIdist\fR, the draft should contain only 
        !            52: \*(lqResent\-xxx:\*(rq fields and no body.
        !            53: The headers and the body of the original message are copied to the draft when
        !            54: the message is sent.
        !            55: Use care in constructing the headers for the redistribution.
        !            56: 
        !            57: If the `\-annotate' switch is given, the  message being
        !            58: distributed will be annotated with the lines:
        !            59: 
        !            60:      Resent:\ date
        !            61:      Resent:\ addrs
        !            62: 
        !            63: where each address list contains as many lines as required.
        !            64: This annotation
        !            65: will be done only if the message is sent directly from \fIdist\fR.
        !            66: If the message is not sent immediately from \fIdist\fR,
        !            67: \*(lqcomp \-use\*(rq may be used to re\-edit and send the constructed message,
        !            68: but the annotations won't take place.
        !            69: The '\-inplace' switch causes annotation to
        !            70: be done in place in order to preserve links to the annotated message.
        !            71: 
        !            72: See \fIcomp\fR\0(1) for a description of the `\-editor' and `\-noedit'
        !            73: switches.
        !            74: Note that while in the editor,
        !            75: the message being resent is available through a link named \*(lq@\*(rq
        !            76: (assuming the default \fIwhatnowproc\fR\0).
        !            77: In addition, the actual pathname of the message is stored in the envariable
        !            78: \fB$editalt\fR,
        !            79: and the pathname of the folder containing the message is stored in the
        !            80: envariable \fB$mhfolder\fR.
        !            81: 
        !            82: The `\-draftfolder\ +folder' and `\-draftmessage\ msg' switches invoke the
        !            83: \fIMH\fR draft folder facility.
        !            84: This is an advanced (and highly useful) feature.
        !            85: Consult the \fBAdvanced Features\fR section of the \fIMH\fR manual for more
        !            86: information.
        !            87: 
        !            88: Upon exiting from the editor,
        !            89: \fIdist\fR will invoke the \fIwhatnow\fR program.
        !            90: See \fIwhatnow\fR\0(1) for a discussion of available options.
        !            91: The invocation of this program can be inhibited by using the `\-nowhatnowproc'
        !            92: switch.
        !            93: (In truth of fact,
        !            94: it is the \fIwhatnow\fR program which starts the initial edit.
        !            95: Hence, `\-nowhatnowproc' will prevent any edit from occurring.)
        !            96: .Fi
        !            97: ^@(MHETCPATH)/distcomps~^The message skeleton
        !            98: ^or <mh\-dir>/distcomps~^Rather than the standard skeleton
        !            99: ^$HOME/\&.mh\(ruprofile~^The user profile
        !           100: ^<mh\-dir>/draft~^The draft file
        !           101: .Pr
        !           102: ^Path:~^To determine the user's MH directory
        !           103: .Ps
        !           104: ^Current\-Folder:~^To find the default current folder
        !           105: .Ps
        !           106: ^Draft\-Folder:~^To find the default draft\-folder
        !           107: .Ps
        !           108: ^Editor:~^To override the default editor
        !           109: .Ps
        !           110: ^fileproc:~^Program to refile the message
        !           111: .Ps
        !           112: ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
        !           113: .Sa
        !           114: comp(1), forw(1), repl(1), send(1), whatnow(1)
        !           115: .De
        !           116: `+folder' defaults to the current folder
        !           117: .Ds
        !           118: `msg' defaults to cur
        !           119: .Ds
        !           120: `\-noannotate'
        !           121: .Ds
        !           122: `\-nodraftfolder'
        !           123: .Ds
        !           124: `\-noinplace'
        !           125: .Co
        !           126: If a folder is given, it will become the current folder.
        !           127: The message distributed will become the current message.
        !           128: .Hi
        !           129: \fIDist\fR originally used headers of the form \*(lqDistribute\-xxx:\*(rq
        !           130: instead of \*(lqResent\-xxx:\*(rq.  In order to conform with the
        !           131: ARPA Internet standard, RFC\-822,
        !           132: the \*(lqResent\-xxx:\*(rq form is now used.
        !           133: \fIDist\fR will recognize \*(lqDistribute\-xxx:\*(rq type headers and 
        !           134: automatically convert them to \*(lqResent\-xxx:\*(rq.
        !           135: .Bu
        !           136: \fIDist\fR does not \fIrigorously\fR check the message being
        !           137: distributed for adherence to the transport standard,
        !           138: but \fIpost\fR called by \fIsend\fR does.
        !           139: The \fIpost\fR program will balk (and rightly so) at poorly formatted messages,
        !           140: and \fIdist\fR won't correct things for you.
        !           141: 
        !           142: If \fIwhatnowproc\fR is \fIwhatnow\fR,
        !           143: then \fIdist\fR uses a built\-in \fIwhatnow\fR,
        !           144: it does not actually run the \fIwhatnow\fR program.
        !           145: Hence, if you define your own \fIwhatnowproc\fR,
        !           146: don't call it \fIwhatnow\fR since \fIdist\fR won't run it.
        !           147: 
        !           148: If your current working directory is not writable,
        !           149: the link named \*(lq@\*(rq is not available.
        !           150: .En

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