Return to dist.me CVS log

Up to [CSRG BSD Unix] / 43BSDReno / share / doc / usd / 08.mh

Annotation of 43BSDReno/share/doc/usd/08.mh/dist.me, revision 1.1

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

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