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

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

unix.superglobalmegacorp.com

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