Annotation of 43BSD/contrib/mh/doc/mh.me, revision 1.1.1.1

1.1       root        1: .\"    This file is automatically generated.  Do not edit!
                      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/usr/new/mh\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: ^burst (1)~^\- explode digests into messages
                    152: ^comp (1)~^\- compose a message 
                    153: ^dist (1)~^\- redistribute a message to additional addresses
                    154: ^folder (1)~^\- set/list current folder/message
                    155: ^folders (1)~^\- list all folders
                    156: ^forw (1)~^\- forward messages
                    157: ^inc (1)~^\- incorporate new mail
                    158: ^mark (1)~^\- mark messages
                    159: ^mhl (1)~^\- produce formatted listings of MH messages
                    160: ^mhmail (1)~^\- send or read mail
                    161: ^mhook (1)~^\- MH receive\-mail hooks
                    162: ^mhpath (1)~^\- print full pathnames of MH messages and folders
                    163: ^msgchk (1)~^\- check for messages
                    164: ^msh (1)~^\- MH shell (and BBoard reader)
                    165: ^next (1)~^\- show the next message
                    166: ^packf (1)~^\- compress a folder into a single file
                    167: ^pick (1)~^\- select messages by content
                    168: ^prev (1)~^\- show the previous message
                    169: ^prompter (1)~^\- prompting editor front end
                    170: ^rcvstore (1)~^\- incorporate new mail asynchronously
                    171: ^refile (1)~^\- file messages in other folders
                    172: ^repl (1)~^\- reply to a message
                    173: ^rmf (1)~^\- remove folder
                    174: ^rmm (1)~^\- remove messages
                    175: ^scan (1)~^\- produce a one line per message scan listing
                    176: ^send (1)~^\- send a message
                    177: ^show (1)~^\- show (list) messages
                    178: ^sortm (1)~^\- sort messages
                    179: ^vmh (1)~^\- visual front\-end to MH
                    180: ^whatnow (1)~^\- prompting front\-end for send
                    181: ^whom (1)~^\- report to whom a message would go
                    182: .if '\*(ZZ'-man' \{\
                    183: .sp 1
                    184: ^mh\-alias (5)~^\- alias file for MH message system
                    185: ^mh\-format (5)~^\- format file for MH message system
                    186: ^mh\-mail (5)~^\- message format for MH message system
                    187: ^mh\-profile (5)~^\- user customization for MH message system
                    188: .sp 1
                    189: ^ap (8)~^\- parse addresses 822\-style
                    190: ^conflict (8)~^\- search for alias/password conflicts
                    191: ^dp (8)~^\- parse dates 822\-style
                    192: ^install\-mh (8)~^\- initialize the MH environment
                    193: ^post (8)~^\- deliver a message
                    194: .\}
                    195: .fi
                    196: .re
                    197: 
                    198: .if '\*(ZZ'-man' \{\
                    199: .Fi
                    200: ^/usr/new/mh~^directory containing \fIMH\fR commands
                    201: ^/usr/new/lib/mh~^\fIMH\fR library
                    202: .Sa
                    203: \fIThe Rand \fIMH\fR Message Handling System: User's Manual\fR,
                    204: .br
                    205: \fIThe Rand \fIMH\fR Message Handling System: Tutorial\fR,
                    206: .br
                    207: \fIThe Rand \fIMH\fR Message Handling System: The UCI BBoards Facility\fR,
                    208: .br
                    209: \fIMH.5: How to process 200 messages a day and still get some real work
                    210: done\fR
                    211: .br
                    212: .En
                    213: .\}

unix.superglobalmegacorp.com

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