Return to mh.rf CVS log

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

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

1.1     ! root        1: .\"    @(MHWARNING)
        !             2: .if '\*(ZZ'-man' \{\
        !             3: .TH MH 1 "April 22, 1986" MH [mh.6]
        !             4: .UC 6
        !             5: .SH NAME
        !             6: mh \- Message Handler
        !             7: .SH SYNOPSIS
        !             8: .in +.5i
        !             9: .ti -.5i
        !            10: any \fIMH\fR command
        !            11: .in -.5i
        !            12: .SH DESCRIPTION
        !            13: \fIMH\fR is the name of a powerful message handling system.
        !            14: Rather then being a single comprehensive program,
        !            15: \fIMH\fR consists of a collection of fairly simple 
        !            16: single-purpose programs to send, receive, save, 
        !            17: and retrieve messages.  The user should refer
        !            18: to the \fIMH User's Manual\fR
        !            19: and the pages for the \fIMH\fR
        !            20: programs in the Unix Programmers Manual.
        !            21: 
        !            22: Unlike \fImail\fR, the standard UNIX mail user interface program,
        !            23: \fIMH\fR is not a closed system which must be explicitly run,
        !            24: then exited when you wish to return to the shell.
        !            25: You may freely intersperse \fIMH\fR commands with other shell commands,
        !            26: allowing you to read and answer your mail while you have (for example)
        !            27: a compilation running,
        !            28: or search for a file or run programs as needed to find the answer to
        !            29: someone's question before answering their mail.
        !            30: 
        !            31: The rest of this manual entry is a quick tutorial which will teach you the
        !            32: basics of \fIMH\fR.
        !            33: You should read the manual entries for the individual programs for complete
        !            34: documentation.
        !            35: 
        !            36: To get started using \fIMH\fR, put the directory
        !            37: \fB@(MHBINPATH)\fR on your \fB$PATH\fR.
        !            38: This is best done in one of the files:
        !            39: \fB\&.profile\fR, \fB\&.login\fR, or \fB\&.cshrc\fR
        !            40: in your home directory.
        !            41: (Check the manual entry for the shell you use,
        !            42: in case you don't know how to do this.)
        !            43: Run the \fIinc\fR command.
        !            44: If you've never used \fIMH\fR before,
        !            45: it will create the necessary default files and directories after
        !            46: asking you if you wish it to do so.
        !            47: 
        !            48: \fIinc\fR moves mail from your system maildrop
        !            49: into your \fIMH\fR `+inbox' folder,
        !            50: breaking it up into separate files
        !            51: and converting it to \fIMH\fR format as it goes.
        !            52: It prints one line for each message it processes,
        !            53: containing the from field, the subject field
        !            54: and as much of the first line of the message as will fit.
        !            55: It leaves the first message it processes as your current message.
        !            56: You'll need to run \fIinc\fR each time you wish to incorporate new mail
        !            57: into your \fIMH\fR file.
        !            58: 
        !            59: \fIscan\fR prints a list of the messages in your current folder.
        !            60: 
        !            61: The commands:
        !            62: \fIshow\fR, \fInext\fR, and \fIprev\fR
        !            63: are used to read specific messages from the current folder.
        !            64: \fIshow\fR displays the current message,
        !            65: or a specific message, which may be specified by its number,
        !            66: which you pass as an argument to \fIshow\fR.
        !            67: \fInext\fR and \fIprev\fR display, respectively,
        !            68: the message numerically after or before the current message.
        !            69: In all cases, the message displayed becomes the current message.
        !            70: If there is no current message,
        !            71: \fIshow\fR may be called with an argument,
        !            72: or \fInext\fR may be used to advance to the first message.
        !            73: 
        !            74: \fIrmm\fR (remove message) deletes the current message.
        !            75: It may be called with message numbers passed as arguments,
        !            76: to delete specific messages.
        !            77: 
        !            78: \fIrepl\fR is used to respond to the current message (by default).
        !            79: It places you in the editor with a prototype response form.
        !            80: While you're in the editor,
        !            81: you may peruse the item you're responding to by reading the file \fB@\fR.
        !            82: After completing your response,
        !            83: type \fBl\fR to review it,
        !            84: or \fBs\fR to send it.
        !            85: 
        !            86: \fIcomp\fR allows you to compose a message by putting you in the editor on
        !            87: a prototype message form,
        !            88: and then lets you send it.
        !            89: 
        !            90: All the \fIMH\fR commands may be run with the single argument: `\-help',
        !            91: which causes them to print a list of the arguments they may be invoked with.
        !            92: 
        !            93: Commands which take a message number as an argument
        !            94: (\fIscan\fR, \fIshow\fR, \fIrepl\fR, ...)
        !            95: also take one of the words:
        !            96: \fIfirst\fR, \fIprev\fR, \fIcur\fR, \fInext\fR, or \fIlast\fR
        !            97: to indicate (respectively) the first, previous, current, next, or last
        !            98: message in the current folder (assuming they are defined).
        !            99: 
        !           100: Commands which take a range of message numbers
        !           101: (\fIrmm\fR, \fIscan\fR, \fIshow\fR, ...)
        !           102: also take any of the abbreviations:
        !           103: .sp
        !           104: .in +5
        !           105: .ti -3
        !           106: .I <num1>-<num2>
        !           107: - Indicates all messages in the range <num1> to <num2>, inclusive. The range
        !           108: .B must
        !           109: be nonempty.
        !           110: .sp
        !           111: .ti -3
        !           112: .I <num>:+N
        !           113: .ti -3
        !           114: .I <num>:-N
        !           115: - Up to
        !           116: .I N
        !           117: messages beginning with (or ending with) message
        !           118: .I num.
        !           119: .I Num
        !           120: may be any of the pre-defined symbols:
        !           121: .I first, prev, cur, next
        !           122: or
        !           123: .I last.
        !           124: .sp
        !           125: .ti -3
        !           126: .I first:N
        !           127: .ti -3
        !           128: .I prev:N
        !           129: .ti -3
        !           130: .I next:N
        !           131: .ti -3
        !           132: .I last:N
        !           133: - The first, previous, next or last
        !           134: .I N
        !           135: messages, if they exist.
        !           136: .in -5
        !           137: 
        !           138: There are many other possibilities such as creating multiple folders for
        !           139: different topics, and automatically refiling messages according to subject,
        !           140: source, destination, or content.
        !           141: These are beyond the scope of this manual entry.
        !           142: 
        !           143: Following is a list of all the \fIMH\fR commands:
        !           144: .\}
        !           145: 
        !           146: .nf
        !           147: .in .5i
        !           148: .ta 1.5i
        !           149: ^ali (1)~^\- list mail aliases
        !           150: ^anno (1)~^\- annotate messages
        !           151: @BEGIN: BBOARDS
        !           152: ^bbc (1)~^\- check on BBoards
        !           153: ^bbl (1)~^\- manage a BBoard
        !           154: ^bbleader (1)~^\- responsiblities of a BBoard\-leader
        !           155: ^bboards (1)~^\- the UCI BBoards facility
        !           156: @END: BBOARDS
        !           157: ^burst (1)~^\- explode digests into messages
        !           158: @BEGIN: TMA
        !           159: ^cipher (1)~^\- en/de\-cipher txt
        !           160: @END: TMA
        !           161: ^comp (1)~^\- compose a message 
        !           162: @BEGIN: TMA
        !           163: ^decipher (1)~^\- decipher messages
        !           164: @END: TMA
        !           165: ^dist (1)~^\- redistribute a message to additional addresses
        !           166: ^folder (1)~^\- set/list current folder/message
        !           167: ^folders (1)~^\- list all folders
        !           168: ^forw (1)~^\- forward messages
        !           169: ^inc (1)~^\- incorporate new mail
        !           170: ^mark (1)~^\- mark messages
        !           171: ^mhl (1)~^\- produce formatted listings of MH messages
        !           172: ^mhmail (1)~^\- send or read mail
        !           173: ^mhook (1)~^\- MH receive\-mail hooks
        !           174: ^mhpath (1)~^\- print full pathnames of MH messages and folders
        !           175: ^msgchk (1)~^\- check for messages
        !           176: ^msh (1)~^\- MH shell (and BBoard reader)
        !           177: ^next (1)~^\- show the next message
        !           178: ^packf (1)~^\- compress a folder into a single file
        !           179: ^pick (1)~^\- select messages by content
        !           180: ^prev (1)~^\- show the previous message
        !           181: ^prompter (1)~^\- prompting editor front end
        !           182: ^rcvstore (1)~^\- incorporate new mail asynchronously
        !           183: ^refile (1)~^\- file messages in other folders
        !           184: ^repl (1)~^\- reply to a message
        !           185: ^rmf (1)~^\- remove folder
        !           186: ^rmm (1)~^\- remove messages
        !           187: ^scan (1)~^\- produce a one line per message scan listing
        !           188: ^send (1)~^\- send a message
        !           189: ^show (1)~^\- show (list) messages
        !           190: ^sortm (1)~^\- sort messages
        !           191: @BEGIN: TMA
        !           192: ^tma (1)~^\- manipulate the TTI Trusted Mail Agent (TMA)
        !           193: @END: TMA
        !           194: ^vmh (1)~^\- visual front\-end to MH
        !           195: ^whatnow (1)~^\- prompting front\-end for send
        !           196: ^whom (1)~^\- report to whom a message would go
        !           197: .if '\*(ZZ'-man' \{\
        !           198: .sp 1
        !           199: ^mh\-alias (5)~^\- alias file for MH message system
        !           200: ^mh\-format (5)~^\- format file for MH message system
        !           201: ^mh\-mail (5)~^\- message format for MH message system
        !           202: ^mh\-profile (5)~^\- user customization for MH message system
        !           203: .sp 1
        !           204: ^ap (8)~^\- parse addresses 822\-style
        !           205: ^conflict (8)~^\- search for alias/password conflicts
        !           206: ^dp (8)~^\- parse dates 822\-style
        !           207: ^install\-mh (8)~^\- initialize the MH environment
        !           208: ^post (8)~^\- deliver a message
        !           209: .\}
        !           210: .fi
        !           211: .re
        !           212: 
        !           213: .if '\*(ZZ'-man' \{\
        !           214: .Fi
        !           215: ^@(MHBINPATH)~^directory containing \fIMH\fR commands
        !           216: ^@(MHETCPATH)~^\fIMH\fR library
        !           217: .Sa
        !           218: \fIThe Rand \fIMH\fR Message Handling System: User's Manual\fR,
        !           219: .br
        !           220: \fIThe Rand \fIMH\fR Message Handling System: Tutorial\fR,
        !           221: .br
        !           222: \fIThe Rand \fIMH\fR Message Handling System: The UCI BBoards Facility\fR,
        !           223: .br
        !           224: \fIMH.5: How to process 200 messages a day and still get some real work
        !           225: done\fR
        !           226: .br
        !           227: .En
        !           228: .\}

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