1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
|
<!-- $Id: pritba.html 600 2006-05-31 22:13:43Z wohler $ -->
<html>
<head>
<meta name="Author" content="Jerry Peek">
<title>Programs in This Book's Archive: MH & nmh: Email for Users & Programmers</title>
<?$book = '..'?>
<link rel="stylesheet" href="<?=$book?>/mh.css" type="text/css">
</head>
<body>
<?
include "$book/mh.php";
includeHeader('../exmh/exmh-2.html', 'e-aligre.html');
?>
<a name="index1"></a>
<h1>Programs in This Book's Archive</h1>
<p>
The Section <a href="obtpro.html">Obtaining Example Files From
This Book</a> explains how to get an archive file with example
files and programs from this book. Most of those files and
programs are mentioned in other parts of the book; some are
explained in detail. This section explains unusual features of
programs and lists important customization steps. This section
does not explain a script's operation in detail. Before using a
script, you or someone who understands shell programming should
check it for things that need customizing (like correct directory
and file pathnames) and for features you don't expect.
<p>
The Chapter
<a href="ch-itupw.html">Introduction to UNIX Programming with
MH</a> will help you understand how the Bourne shell scripts work.
<a href="../overall/ap-rl.html">The Reference List</a> has some
good reference books on UNIX programming. The scripts in the
archive have more detailed comments in them.
<p>
Even if you don't want to use the programs from this section in
your day-to-day work, each one demonstrates something new about
programming with MH -- so they're worth studying. (If you program
Perl instead of the shell, the techniques in these scripts will
help you.) Programs like these let you go further with MH
customization, to do things that
<a href="whacom.html">MH versions</a> won't let you do.
<p>
These scripts don't use features of modern Bourne shells that have
more built-in commands and options than earlier Bourne shells.
Some programs
(like <a
href="../examples/mh/bin/distprompter"><i>distprompter</i></a>)
are longer because of that. The benefit is that the scripts should
work on all Bourne shells.
<p>
Before you run any of the scripts in this archive, do what you'd
do with any unknown software: read through it and test to be sure
that it'll work well in your setup. Although I use the scripts
myself and have tried to write them portably, I can't be
responsible for problems you have. Finally, if you find a bug or
have a suggestion, please tell us about it by clicking on the link
at the bottom of any page of this book. We'll update the online
archives periodically. If you got your copy of a script awhile
ago, you might look for an updated version online.
<p>
The archive file is organized overall by package, and within each
package by the type of files. For example, the top-level
subdirectories are <i>mh</i> and
<i>xmh</i> (there weren't any <i>exmh</i> files as of this
writing). A subdirectory named <i>bin</i> has files (mostly
scripts) that you'd want to copy into your <i>bin</i>. (The
Section
<a href="makcom.html#MbDSSP">Making a bin Directory, Setting
Search Path</a> explains how.) Files like <i>replcomps</i> that
belong in your MH directory are in a subdirectory
named <i>Mail</i>. And so on.
<p>
The next pages document many of the files in the archive.
<?
includeFooter('$Date: 2006-05-31 15:13:43 -0700 (Wed, 31 May 2006) $',
'OReilly: 1991, 1992, 1995; Jerry: 1996, 1997, 1999, 2000, 2002, 2004');
?>
</body>
</html>
|
