4 .TH NMH %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
6 nmh \- new MH message system
13 is the name of a powerful message handling system. Rather than
14 being a single comprehensive program,
16 consists of a collection
17 of fairly simple single-purpose programs to send, retrieve, save,
18 and manipulate messages.
20 Unlike most mail clients in UNIX,
22 is not a closed system which
23 must be explicitly run, then exited when you wish to return to the shell.
24 You may freely intersperse
26 commands with other shell commands,
27 allowing you to read and answer your mail while you have (for example)
28 a compilation running, or search for a file or run programs as needed
29 to find the answer to someone's question before answering their mail.
31 The rest of this manual entry is a quick tutorial which will teach you
34 You should read the manual entries for the
35 individual programs for complete documentation.
43 This is best done in one of the files:
49 in your home directory. (Check the
50 manual entry for the shell you use, in case you don't know how to
53 command. If you've never used
55 before, it will create the necessary default files and directories after
56 asking you if you wish it to do so.
59 moves mail from your system maildrop into your
61 `+inbox' folder, breaking it up into separate files and converting it
64 format as it goes. It prints one line for each message it
65 processes, containing the from field, the subject field and as much of
66 the first line of the message as will fit. It leaves the first message
67 it processes as your current message. You'll need to run
70 time you wish to incorporate new mail into your
75 .B prints a list of the messages in your current folder.
83 specific messages from the current folder.
86 current message, or a specific message, which may be specified by its
87 number, which you pass as an argument to
92 display, respectively, the message numerically after or before
93 the current message. In all cases, the message displayed becomes the
94 current message. If there is no current message,
97 called with an argument, or
99 may be used to advance to the
103 (remove message) deletes the current message. It may be called
104 with message numbers passed as arguments, to delete specific messages.
107 is used to respond to the current message (by default).
108 It places you in the editor with a prototype response form. While you're
109 in the editor, you may peruse the item you're responding to by reading
112 After completing your response, type
123 allows you to compose a message by putting you in the editor
124 on a prototype message form, and then lets you send it.
128 commands may be run with the single argument:
130 which causes them to print a list of the arguments they may be invoked
135 commands may be run with the single argument:
137 which cause them to print the version number of the
139 distribution, and then exit.
141 Commands which take a message number as an argument (
145 \&...) also take one of the words: \*(lqfirst\*(rq,
146 \*(lqprev\*(rq, \*(lqcur\*(rq, \*(lqnext\*(rq, or \*(lqlast\*(rq to indicate
147 (respectively) the first, previous, current, next, or last message in
148 the current folder (assuming they are defined).
150 Commands which take a range of message numbers (
154 \&...) also take any of the abbreviations:
157 .IP \fI<num1>\fR\-\fI<num2>\fR 15
158 Indicates all messages in the range <num1> to <num2>, inclusive. The range must be nonempty.
159 .IP \fI<num>\fR:+\fIN\fR 15
160 .IP \fI<num>\fR:\-\fIN\fR 15
163 messages beginning with (or ending with) message
166 may be any of the pre-defined symbols:
177 The first, previous, next or last
178 messages, if they exist.
181 There are many other possibilities such as creating multiple folders
182 for different topics, and automatically refiling messages according to
183 subject, source, destination, or content. These are beyond the scope
184 of this manual entry.
186 Following is a list of all the
194 ^ali(1)~^\- list mail aliases
195 ^anno(1)~^\- annotate messages
196 ^burst(1)~^\- explode digests into messages
197 ^comp(1)~^\- compose a message
198 ^dist(1)~^\- redistribute a message to additional addresses
199 ^flist(1)~^\- list folders with messages in given sequence(s)
200 ^flists(1)~^\- list all folders with messages in given sequence(s)
201 ^folder(1)~^\- set/list current folder/message
202 ^folders(1)~^\- list all folders
203 ^forw(1)~^\- forward messages
204 ^inc(1)~^\- incorporate new mail
205 ^mark(1)~^\- mark messages
206 ^mhbuild(1)~^\- translate MIME composition draft
207 ^mhl(1)~^\- produce formatted listings of nmh messages
208 ^mhlist(1)~^\- list information about content of MIME messages
209 ^mhmail(1)~^\- send or read mail
210 ^mhparam(1)~^\- print nmh profile components
211 ^mhpath(1)~^\- print full pathnames of nmh messages and folders
212 ^mhshow(1)~^\- display MIME messages
213 ^mhstore(1)~^\- store contents of MIME messages into files
214 ^msgchk(1)~^\- check for messages
215 ^next(1)~^\- show the next message
216 ^packf(1)~^\- compress a folder into a single file
217 ^pick(1)~^\- select messages by content
218 ^prev(1)~^\- show the previous message
219 ^prompter(1)~^\- prompting editor front end
220 ^rcvdist(1)~^\- asynchronously redistribute new mail
221 ^rcvpack(1)~^\- append message to file
222 ^rcvstore(1)~^\- asynchronously incorporate new mail
223 ^rcvtty(1)~^\- report new mail
224 ^refile(1)~^\- file messages in other folders
225 ^repl(1)~^\- reply to a message
226 ^rmf(1)~^\- remove folder
227 ^rmm(1)~^\- remove messages
228 ^scan(1)~^\- produce a one line per message scan listing
229 ^send(1)~^\- send a message
230 ^sendfiles(1)~^\- send multiple files and directories in MIME message
231 ^show(1)~^\- show(display) messages
232 ^slocal(1)~^\- asynchronously filter and deliver new mail
233 ^sortm(1)~^\- sort messages
234 ^whatnow(1)~^\- prompting front\-end for send
236 ^mh\-alias(5)~^\- alias file for nmh message system
237 ^mh\-draft(5)~^\- draft folder facility
238 ^mh\-format(5)~^\- format file for nmh message system
239 ^mh\-mail(5)~^\- message format for nmh message system
240 ^mh\-profile(5)~^\- user customization for nmh message system
241 ^mh\-sequence(5)~^\- sequence specification for nmh message system
242 ^mh\-tailor(5)~^\- mail transport customization for nmh message system
244 ^ap(8)~^\- parse addresses 822\-style
245 ^conflict(8)~^\- search for alias/password conflicts
246 ^dp(8)~^\- parse dates 822\-style
247 ^fmtdump(8)~^\- decode \fInmh\fP format files
248 ^install\-mh(8)~^\- initialize the nmh environment
249 ^post(8)~^\- deliver a message
256 .ta \w'%etcdir%/ExtraBigFileName 'u
257 ^%bindir%~^contains \fInmh\fR commands
258 ^%etcdir%~^contains \fInmh\fR format files
259 ^%libdir%~^contains \fInmh\fR library commands
260 ^$HOME/\&.mh\(ruprofile~^The user profile
263 .SH "PROFILE COMPONENTS"
267 .ta \w'ExtraBigProfileName 'u
268 ^Path:~^To determine the user's nmh directory
272 If problems are encountered with an
274 program, the problems should
275 be reported to the local maintainers of
278 name of the program should be reported, along with the version information
281 To find out what version of an
283 program is being run, invoke
286 switch. This information includes
289 the host it was generated on, and the date the
292 Send bug reports and suggestions to
293 .IR nmh-workers@nongnu.org .