Return to repl.rf CVS log

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

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

1.1     ! root        1: .\"    @(MHWARNING)
        !             2: .TH REPL 1 "April 22, 1986" MH [mh.6]
        !             3: .UC 6
        !             4: .SH NAME
        !             5: repl \- reply to a message
        !             6: .SH SYNOPSIS
        !             7: .in +.5i
        !             8: .ti -.5i
        !             9: repl
        !            10: \%[+folder] \%[msg]
        !            11: \%[\-annotate] \%[\-noannotate]
        !            12: \%[\-cc\ all/to/cc/me] \%[\-nocc\ all/to/cc/me]
        !            13: \%[\-draftfolder\ +folder] \%[\-draftmessage\ msg] \%[\-nodraftfolder]
        !            14: \%[\-editor\ editor] \%[\-noedit]
        !            15: \%[\-fcc\ +folder]
        !            16: \%[\-filter\ filterfile]
        !            17: \%[\-form\ formfile]
        !            18: \%[\-format] \%[\-noformat]
        !            19: \%[\-inplace] \%[\-noinplace]
        !            20: \%[\-query] \%[\-noquery]
        !            21: \%[\-width\ columns]
        !            22: \%[\-whatnowproc\ program] \%[\-nowhatnowproc]
        !            23: \%[\-help]
        !            24: .in -.5i
        !            25: .SH DESCRIPTION
        !            26: \fIRepl\fR aids a user in producing a reply to an existing
        !            27: message.
        !            28: \fIRepl\fR uses a reply template to guide its actions when constructing
        !            29: the message draft of the reply.
        !            30: In its simplest form (with no arguments), 
        !            31: it will set up
        !            32: a message\-form skeleton in reply to the current message in the
        !            33: current folder, and invoke the whatnow shell.
        !            34: The default reply template will direct \fIrepl\fR to construct
        !            35: the composed message as follows:
        !            36: 
        !            37: .nf
        !            38: .in 1i
        !            39: To: <Reply\-To> or <From>
        !            40: cc: <cc>, <To>, and yourself
        !            41: Subject: Re: <Subject>
        !            42: In\-reply\-to: Your message of <Date>.
        !            43: .ti +\w'In\-reply\-to: 'u
        !            44: <Message\-Id>
        !            45: .in .5i
        !            46: .fi
        !            47: 
        !            48: where field names enclosed in angle brackets (<\ >) indicate the
        !            49: contents of the named field from the message to which the reply
        !            50: is being made.  The `\-cc\ type' switch takes an argument which specifies
        !            51: who gets placed on the \*(lqcc:\*(rq list of the reply.
        !            52: The `\-query' switch modifies the action of `\-cc\ type' switch by
        !            53: interactively asking you if each address that normally would be placed
        !            54: in the \*(lqTo:\*(rq and \*(lqcc:\*(rq list should actually be sent a copy.
        !            55: (This is useful for special\-purpose replies.)
        !            56: Note that the position of the `\-cc' and `\-nocc' switches,
        !            57: like all other switches which take a positive and negative form,
        !            58: is important.
        !            59: 
        !            60: If the file named \*(lqreplcomps\*(rq exists in the user's MH directory,
        !            61: it will be used instead of the default form.
        !            62: In either case, the file specified by `\-form\ formfile' will be used
        !            63: if given.
        !            64: 
        !            65: If the draft already exists,
        !            66: \fIrepl\fR will ask you as to the disposition of the draft.
        !            67: A reply of \fBquit\fR will abort \fIrepl\fR, leaving the draft intact;
        !            68: \fBreplace\fR will replace the existing draft with a blank skeleton;
        !            69: and \fBlist\fR will display the draft.
        !            70: 
        !            71: See \fIcomp\fR\0(1) for a description of the `\-editor' and `\-noedit'
        !            72: switches.
        !            73: Note that while in the editor,
        !            74: the message being replied to is available through a link named \*(lq@\*(rq
        !            75: (assuming the default \fIwhatnowproc\fR\0).
        !            76: In addition, the actual pathname of the message is stored in the envariable
        !            77: \fB$editalt\fR,
        !            78: and the pathname of the folder containing the message is stored in the
        !            79: envariable \fB$mhfolder\fR.
        !            80: 
        !            81: Although \fIrepl\fR uses the `\-form\ formfile' switch to direct it how
        !            82: to construct the beginning of the draft, the `\-filter\ filterfile'
        !            83: switch directs \fIrepl\fR as to how the message being replied\-to
        !            84: should be formatted in the body of the draft.
        !            85: If `\-filter' is not specified,
        !            86: then the message being replied\-to is not included in the body of the
        !            87: draft.
        !            88: If `\-filter\ filterfile' is specified,
        !            89: then the message being replied\-to is filtered (re\-formatted) prior to
        !            90: being output to the body of the draft.
        !            91: The filter file for \fIrepl\fR should be a standard form file for
        !            92: \fImhl\fR, as \fIrepl\fR will invoke \fImhl\fR to format the message
        !            93: being replied\-to.
        !            94: There is no default message filter (`\-filter' must be followed by a
        !            95: file name).
        !            96: A filter file that is commonly used is:
        !            97: 
        !            98: .nf
        !            99: .in +.5i
        !           100: :
        !           101: body:nocomponent,compwidth=9,offset=9
        !           102: .in -.5i
        !           103: .fi
        !           104: 
        !           105: which says to output a blank line and then the body of the message
        !           106: being replied\-to, indented by one tab\-stop.
        !           107: 
        !           108: If the `\-annotate' switch is given,
        !           109: the message being replied\-to will be annotated with the lines
        !           110: 
        !           111:      Replied:\ date
        !           112:      Replied:\ addrs
        !           113: 
        !           114: where the address list contains one line for each addressee.
        !           115: The annotation
        !           116: will be done only if the message is sent directly from \fIrepl\fR.
        !           117: If the message is not sent immediately from \fIrepl\fR,
        !           118: \*(lqcomp\ \-use\*(rq may be used to re\-edit and send the constructed message,
        !           119: but the annotations won't take place.
        !           120: The `\-inplace' switch causes annotation to
        !           121: be done in place in order to preserve links to the annotated message.
        !           122: 
        !           123: With the `\-format' switch one can indicate if Internet\-style
        !           124: formatting should be used (or not be used with `\-noformat').
        !           125: If present (the default), then lines beginning with the fields
        !           126: \*(lqTo:\*(rq, \*(lqcc:\*(rq, and \*(rqBcc:\*(rq
        !           127: will be standardized and have duplicate addresses removed.
        !           128: In addition, the `\-width\ columns' switch will guide \fIrepl\fR's formatting
        !           129: of these fields.
        !           130: 
        !           131: The `\-fcc\ +folder' switch can be used to automatically specify a folder to
        !           132: receive Fcc:s.
        !           133: More than one folder, each preceeded by `\-fcc' can be named.
        !           134: 
        !           135: A reply template is simply a format file.
        !           136: See \fImh\-format\fR\0(5) for the details.
        !           137: 
        !           138: In addition to the standard escapes,
        !           139: \fIrepl\fR also recognizes the following additional escape:
        !           140: .nf
        !           141: .ta \w'escape  'u
        !           142: \fIescape\fR   \fIsubstitution\fR
        !           143: fcc    any `\-fcc\ folder' switches
        !           144: .re
        !           145: .fi
        !           146: 
        !           147: The `\-draftfolder\ +folder' and `\-draftmessage\ msg' switches invoke the
        !           148: \fIMH\fR draft folder facility.
        !           149: This is an advanced (and highly useful) feature.
        !           150: Consult the \fBAdvanced Features\fR section of the \fIMH\fR manual for more
        !           151: information.
        !           152: 
        !           153: Upon exiting from the editor,
        !           154: \fIrepl\fR will invoke the \fIwhatnow\fR program.
        !           155: See \fIwhatnow\fR\0(1) for a discussion of available options.
        !           156: The invocation of this program can be inhibited by using the `\-nowhatnowproc'
        !           157: switch.
        !           158: (In truth of fact,
        !           159: it is the \fIwhatnow\fR program which starts the initial edit.
        !           160: Hence, `\-nowhatnowproc' will prevent any edit from occurring.)
        !           161: .Fi
        !           162: ^@(MHETCPATH)/replcomps~^The reply template
        !           163: ^or <mh\-dir>/replcomps~^Rather than the standard template
        !           164: ^$HOME/\&.mh\(ruprofile~^The user profile
        !           165: ^<mh\-dir>/draft~^The draft file
        !           166: .Pr
        !           167: ^Path:~^To determine the user's MH directory
        !           168: .Ps
        !           169: ^Alternate\-Mailboxes:~^To determine the user's mailboxes
        !           170: .Ps
        !           171: ^Current\-Folder:~^To find the default current folder
        !           172: .Ps
        !           173: ^Draft\-Folder:~^To find the default draft\-folder
        !           174: .Ps
        !           175: ^Editor:~^To override the default editor
        !           176: .Ps
        !           177: ^Msg\-Protect:~^To set mode when creating a new message (draft)
        !           178: .Ps
        !           179: ^fileproc:~^Program to refile the message
        !           180: .Ps
        !           181: ^mhlproc:~^Program to filter message being replied\-to
        !           182: .Ps
        !           183: ^whatnowproc:~^Program to ask the \*(lqWhat now?\*(rq questions
        !           184: .Sa
        !           185: comp(1), dist(1), forw(1), send(1), whatnow(1), mh\-format(5)
        !           186: .De
        !           187: `+folder' defaults to the current folder
        !           188: .Ds
        !           189: `msg' defaults to cur
        !           190: .Ds
        !           191: `\-nocc\ all' at ATHENA sites, `\-cc\ all' otherwise
        !           192: .Ds
        !           193: `\-format'
        !           194: .Ds
        !           195: `\-noannotate'
        !           196: .Ds
        !           197: `\-nodraftfolder'
        !           198: .Ds
        !           199: `\-noinplace'
        !           200: .Ds
        !           201: `\-noquery'
        !           202: .Ds
        !           203: `\-width\ 72'
        !           204: .Co
        !           205: If a folder is given, it will become the current folder.
        !           206: The message replied\-to will become the current message.
        !           207: .Bu
        !           208: If any addresses occur in the reply template,
        !           209: addresses in the template that do not contain hosts are defaulted incorrectly.
        !           210: Instead of using the localhost for the default,
        !           211: \fIrepl\fR uses the sender's host.
        !           212: Moral of the story: if you're going to include addresses in a reply template,
        !           213: include the host portion of the address.
        !           214: 
        !           215: If \fIwhatnowproc\fR is \fIwhatnow\fR,
        !           216: then \fIrepl\fR uses a built\-in \fIwhatnow\fR,
        !           217: it does not actually run the \fIwhatnow\fR program.
        !           218: Hence, if you define your own \fIwhatnowproc\fR,
        !           219: don't call it \fIwhatnow\fR since \fIrepl\fR won't run it.
        !           220: 
        !           221: If your current working directory is not writable,
        !           222: the link named \*(lq@\*(rq is not available.
        !           223: .En

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