Added all of the MH sources, including RCS files, in

[mmh] / docs / historical / mh-6.8.5 / conf / RCS / mh-gen.8,v

head    2.119;
access;
symbols;
locks; strict;


2.119
date    96.02.08.19.20.25;      author jromine; state Exp;
branches;
next    2.118;

2.118
date    96.02.08.19.18.53;      author jromine; state Exp;
branches;
next    2.117;

2.117
date    95.12.05.19.36.14;      author jromine; state Exp;
branches;
next    2.116;

2.116
date    94.11.17.16.10.10;      author jromine; state Exp;
branches;
next    2.115;

2.115
date    93.12.01.00.44.23;      author jromine; state Exp;
branches;
next    2.114;

2.114
date    93.09.01.21.25.42;      author jromine; state Exp;
branches;
next    2.113;

2.113
date    93.08.27.22.22.08;      author jromine; state Exp;
branches;
next    2.112;

2.112
date    93.08.25.18.07.10;      author jromine; state Exp;
branches;
next    2.111;

2.111
date    93.08.20.19.47.56;      author jromine; state Exp;
branches;
next    2.110;

2.110
date    93.08.19.23.57.46;      author jromine; state Exp;
branches;
next    2.109;

2.109
date    93.08.19.23.34.15;      author jromine; state Exp;
branches;
next    2.108;

2.108
date    93.08.19.23.30.08;      author jromine; state Exp;
branches;
next    2.107;

2.107
date    93.06.03.17.54.12;      author jromine; state Exp;
branches;
next    2.106;

2.106
date    93.02.26.19.00.51;      author jromine; state Exp;
branches;
next    2.105;

2.105
date    92.12.14.17.19.19;      author jromine; state Exp;
branches;
next    2.104;

2.104
date    92.12.02.19.07.37;      author jromine; state Exp;
branches;
next    2.103;

2.103
date    92.11.21.20.46.59;      author jromine; state Exp;
branches;
next    2.102;

2.102
date    92.11.19.18.09.59;      author jromine; state Exp;
branches;
next    2.101;

2.101
date    92.11.19.17.45.16;      author jromine; state Exp;
branches;
next    2.100;

2.100
date    92.11.16.22.35.55;      author jromine; state Exp;
branches;
next    2.99;

2.99
date    92.11.12.23.30.09;      author jromine; state Exp;
branches;
next    2.98;

2.98
date    92.11.12.22.48.35;      author jromine; state Exp;
branches;
next    2.97;

2.97
date    92.11.12.00.07.59;      author jromine; state Exp;
branches;
next    2.96;

2.96
date    92.11.12.00.04.00;      author jromine; state Exp;
branches;
next    2.95;

2.95
date    92.11.11.22.58.26;      author jromine; state Exp;
branches;
next    2.94;

2.94
date    92.11.10.22.40.25;      author jromine; state Exp;
branches;
next    2.93;

2.93
date    92.11.09.18.45.48;      author jromine; state Exp;
branches;
next    2.92;

2.92
date    92.11.06.19.29.16;      author jromine; state Exp;
branches;
next    2.91;

2.91
date    92.11.06.01.06.04;      author jromine; state Exp;
branches;
next    2.90;

2.90
date    92.11.06.00.47.31;      author jromine; state Exp;
branches;
next    2.89;

2.89
date    92.11.05.19.25.27;      author jromine; state Exp;
branches;
next    2.88;

2.88
date    92.11.05.17.20.40;      author jromine; state Exp;
branches;
next    2.87;

2.87
date    92.11.02.19.01.33;      author jromine; state Exp;
branches;
next    2.86;

2.86
date    92.11.02.19.01.00;      author jromine; state Exp;
branches;
next    2.85;

2.85
date    92.11.02.18.39.35;      author jromine; state Exp;
branches;
next    2.84;

2.84
date    92.11.02.17.10.51;      author jromine; state Exp;
branches;
next    2.83;

2.83
date    92.10.31.06.24.13;      author jromine; state Exp;
branches;
next    2.82;

2.82
date    92.10.31.06.20.55;      author jromine; state Exp;
branches;
next    2.81;

2.81
date    92.10.29.22.20.55;      author jromine; state Exp;
branches;
next    2.80;

2.80
date    92.10.29.17.44.55;      author jromine; state Exp;
branches;
next    2.79;

2.79
date    92.10.29.17.39.14;      author jromine; state Exp;
branches;
next    2.78;

2.78
date    92.10.27.21.44.44;      author jromine; state Exp;
branches;
next    2.77;

2.77
date    92.10.27.18.11.52;      author jromine; state Exp;
branches;
next    2.76;

2.76
date    92.10.27.17.41.40;      author jromine; state Exp;
branches;
next    2.75;

2.75
date    92.10.27.17.00.27;      author jromine; state Exp;
branches;
next    2.74;

2.74
date    92.10.26.16.54.14;      author jromine; state Exp;
branches;
next    2.73;

2.73
date    92.10.26.16.29.56;      author jromine; state Exp;
branches;
next    2.72;

2.72
date    92.10.20.22.50.50;      author jromine; state Exp;
branches;
next    2.71;

2.71
date    92.10.19.21.57.08;      author jromine; state Exp;
branches;
next    2.70;

2.70
date    92.10.19.21.56.21;      author jromine; state Exp;
branches;
next    2.69;

2.69
date    92.10.19.21.48.20;      author jromine; state Exp;
branches;
next    2.68;

2.68
date    92.10.19.20.29.19;      author jromine; state Exp;
branches;
next    2.67;

2.67
date    92.05.12.21.05.04;      author jromine; state Exp;
branches;
next    2.66;

2.66
date    92.05.12.21.04.45;      author jromine; state Exp;
branches;
next    2.65;

2.65
date    92.02.12.21.36.21;      author jromine; state Exp;
branches;
next    2.64;

2.64
date    92.02.12.21.35.05;      author jromine; state Exp;
branches;
next    2.63;

2.63
date    92.02.11.05.08.34;      author jromine; state Exp;
branches;
next    2.62;

2.62
date    92.02.06.16.48.48;      author jromine; state Exp;
branches;
next    2.61;

2.61
date    92.02.06.00.25.07;      author jromine; state Exp;
branches;
next    2.60;

2.60
date    92.02.05.22.18.48;      author jromine; state Exp;
branches;
next    2.59;

2.59
date    92.02.05.21.52.46;      author jromine; state Exp;
branches;
next    2.58;

2.58
date    92.01.31.23.09.59;      author jromine; state Exp;
branches;
next    2.57;

2.57
date    92.01.31.22.55.36;      author jromine; state Exp;
branches;
next    2.56;

2.56
date    92.01.31.22.47.36;      author jromine; state Exp;
branches;
next    2.55;

2.55
date    92.01.30.16.41.35;      author jromine; state Exp;
branches;
next    2.54;

2.54
date    91.01.24.08.27.50;      author mh;      state Exp;
branches;
next    2.53;

2.53
date    91.01.23.14.54.18;      author mh;      state Exp;
branches;
next    2.52;

2.52
date    91.01.23.14.44.18;      author mh;      state Exp;
branches;
next    2.51;

2.51
date    90.12.18.13.55.54;      author mh;      state Exp;
branches;
next    2.50;

2.50
date    90.11.21.09.27.52;      author mh;      state Exp;
branches;
next    2.49;

2.49
date    90.11.16.14.55.57;      author mh;      state Exp;
branches;
next    2.48;

2.48
date    90.04.09.13.27.27;      author sources; state Exp;
branches;
next    2.47;

2.47
date    90.04.09.10.01.42;      author sources; state Exp;
branches;
next    2.46;

2.46
date    90.04.08.19.35.27;      author sources; state Exp;
branches;
next    2.45;

2.45
date    90.04.07.23.34.23;      author sources; state Exp;
branches;
next    2.44;

2.44
date    90.04.06.10.59.28;      author sources; state Exp;
branches;
next    2.43;

2.43
date    90.04.06.10.51.39;      author sources; state Exp;
branches;
next    2.42;

2.42
date    90.04.06.10.46.18;      author sources; state Exp;
branches;
next    2.41;

2.41
date    90.04.05.16.08.57;      author sources; state Exp;
branches;
next    2.40;

2.40
date    90.04.05.16.08.33;      author sources; state Exp;
branches;
next    2.39;

2.39
date    90.04.05.15.19.29;      author sources; state Exp;
branches;
next    2.38;

2.38
date    90.04.04.23.08.49;      author sources; state Exp;
branches;
next    2.37;

2.37
date    90.04.02.14.39.11;      author sources; state Exp;
branches;
next    2.36;

2.36
date    90.04.02.14.19.26;      author sources; state Exp;
branches;
next    2.35;

2.35
date    90.04.02.14.11.22;      author sources; state Exp;
branches;
next    2.34;

2.34
date    90.03.29.15.45.05;      author sources; state Exp;
branches;
next    2.33;

2.33
date    90.03.28.17.19.36;      author sources; state Exp;
branches;
next    2.32;

2.32
date    90.03.28.17.16.41;      author sources; state Exp;
branches;
next    2.31;

2.31
date    90.03.28.17.16.05;      author sources; state Exp;
branches;
next    2.30;

2.30
date    90.03.28.16.49.49;      author sources; state Exp;
branches;
next    2.29;

2.29
date    90.03.28.11.15.35;      author sources; state Exp;
branches;
next    2.28;

2.28
date    90.03.23.16.41.33;      author sources; state Exp;
branches;
next    2.27;

2.27
date    90.03.23.11.25.10;      author sources; state Exp;
branches;
next    2.26;

2.26
date    90.03.21.22.19.34;      author sources; state Exp;
branches;
next    2.25;

2.25
date    90.03.21.11.00.53;      author sources; state Exp;
branches;
next    2.24;

2.24
date    90.03.21.10.30.55;      author sources; state Exp;
branches;
next    2.23;

2.23
date    90.03.19.10.24.26;      author sources; state Exp;
branches;
next    2.22;

2.22
date    90.03.19.10.22.53;      author sources; state Exp;
branches;
next    2.21;

2.21
date    90.03.19.09.50.57;      author sources; state Exp;
branches;
next    2.20;

2.20
date    90.03.19.09.47.05;      author sources; state Exp;
branches;
next    2.19;

2.19
date    90.03.19.09.42.16;      author sources; state Exp;
branches;
next    2.18;

2.18
date    90.03.18.16.34.45;      author sources; state Exp;
branches;
next    2.17;

2.17
date    90.03.16.15.58.57;      author sources; state Exp;
branches;
next    2.16;

2.16
date    90.03.15.15.54.26;      author sources; state Exp;
branches;
next    2.15;

2.15
date    90.03.12.14.14.24;      author sources; state Exp;
branches;
next    2.14;

2.14
date    90.03.12.11.38.44;      author sources; state Exp;
branches;
next    2.13;

2.13
date    90.03.09.15.52.29;      author sources; state Exp;
branches;
next    2.12;

2.12
date    90.02.23.14.33.26;      author sources; state Exp;
branches;
next    2.11;

2.11
date    90.02.23.14.22.20;      author sources; state Exp;
branches;
next    2.10;

2.10
date    90.02.15.14.24.30;      author sources; state Exp;
branches;
next    2.9;

2.9
date    90.02.15.14.12.18;      author sources; state Exp;
branches;
next    2.8;

2.8
date    90.02.05.15.03.53;      author sources; state Exp;
branches;
next    2.7;

2.7
date    90.02.05.15.01.02;      author sources; state Exp;
branches;
next    2.6;

2.6
date    90.02.05.14.59.29;      author sources; state Exp;
branches;
next    2.5;

2.5
date    90.02.05.14.55.11;      author sources; state Exp;
branches;
next    2.4;

2.4
date    90.02.05.14.50.18;      author sources; state Exp;
branches;
next    2.3;

2.3
date    90.02.05.14.34.10;      author sources; state Exp;
branches;
next    2.2;

2.2
date    90.02.05.14.19.28;      author sources; state Exp;
branches;
next    2.1;

2.1
date    90.01.29.15.42.39;      author sources; state Exp;
branches;
next    2.0;

2.0
date    89.11.17.15.56.50;      author sources; state Exp;
branches;
next    1.1;

1.1
date    89.06.02.13.28.04;      author sources; state Exp;
branches;
next    ;


desc
@@


2.119
log
@typo
@
text
@.\" @@(#)$Id: mh-gen.8,v 2.118 1996/02/08 19:18:53 jromine Exp jromine $
.\" uneven inter-word spacing (nroff line adjusting) hampers readability
.if n .na
.TH MH-GEN 8 MH.6.8.4 [mh.6]
.SH NAME
mh-gen \- generating the MH system
.SH "READ THIS"
This documentation describes how to configure, generate, and install
the UCI version of the RAND \fIMH\fR system.  \fBBe certain\fP to 
read this document completely before you begin.  You probably will
also want to familiarize yourself with the \fIMH\fP Administrator's
Guide before you install \fIMH\fP.  A copy can be found in the
file \fBdoc/ADMIN.doc\fP is the \fIMH\fP sources.
.SH DISCLAIMER
Although the \fIMH\fR system was originally developed by the RAND Corporation,
and is now in the public domain,
the RAND Corporation assumes no responsibility for \fIMH\fR
or this particular modification of \fIMH\fR.
.PP
In addition,
the Regents of the University of California issue the following
\fBdisclaimer\fR in regard to the UCI version of \fIMH\fR:
.in +.5i
\*(lqAlthough each program has been tested by its contributor,
no warranty, express or implied,
is made by the contributor or the University of California,
as to the accuracy and functioning of the program
and related program material,
nor shall the fact of distribution constitute any such warranty,
and no responsibility is assumed by the contributor
or the University of California in connection herewith.\*(rq
.in -.5i
.PP
This version of \fIMH\fR is in the public domain,
and as such,
there are no real restrictions on its use.
The \fIMH\fR source code and documentation have no licensing restrictions
whatsoever.
As a courtesy,
the authors ask only that you provide appropriate credit to the RAND
Corporation and
the University of California for having developed the software.
.SH "GETTING HELP"
\fIMH\fR is a software package that is neither supported by the RAND
Corporation nor the University of California.
However,
since we do use the software ourselves and plan to continue using (and
improving) \fIMH\fR,
bug reports and their associated fixes should be reported back to us so that
we may include them in future releases.
The current computer mailbox for \fIMH\fR is \fBBug\-MH@@ICS.UCI.EDU\fR.
Current information about MH can be obtained from
the \fBMH Home Page\fP on the World Wide Web at
\fBhttp://www.ics.uci.edu/~mh\fP.
.PP
Presently,
there are two Internet discussion groups, \fBMH\-Users@@ICS.UCI.EDU\fR
and \fBMH\-Workers@@ICS.UCI.EDU\fR.  \fBMH\-Workers\fP is for people
discussing code changes to \fIMH\fP.  \fBMH-Users\fP is for general
discussion about how to use \fIMH\fP.
\fBMH\-Users\fR is bi-directionally 
gatewayed into USENET as \fBcomp.mail.mh\fR.
.SH "HOW TO GET MH"
Since you probably already have \fIMH\fP,
you may not need to read this unless you suspect you have an old version.
There are two ways to get the latest release:
.PP
1.  If you can FTP to the ARPA Internet, use anonymous FTP to
ftp.ics.uci.edu and retrieve the file pub/mh/mh-6.8.tar.Z.
This is a tar image after being run through the compress program
(approximately 1.8MB).  There should also be a \fBREADME\fR file in
that directory which tells what the current release of \fIMH\fP
is, and how to get updates.
.PP
You may also find MH on
various other hosts; to make sure you get the latest version and
don't waste your time re-fixing bugs, it's best to get it from
either ftp.ics.uci.edu or a site that mirrors ftp.ics.uci.edu.
.PP
2.  You can send $75 US to the address below.
This covers the cost of a 6250 BPI 9-track magtape,
handling, and shipping.  In addition, you'll get a
laser-printed hard-copy of the entire MH documentation set.  Be
sure to include your USPS address with your check.  Checks 
must be drawn on U.S\&. funds and should be made payable to:

.ti +1i
Regents of the University of California

The distribution address is:  

.nf
.RS 1i
Attn: MH distribution
Office of Academic Computing
Univeristy of California at Irvine
Irvine, CA  92717-2225  USA

+1 714 824 5153
.fi
.RE
.PP
Sadly, if you just want the hard-copies of the documentation, you
still have to pay the $75.  The tar image has the documentation
source (the manual is in roff format, but the rest are in TeX
format).  Postscript formatted versions of the TeX papers are 
available, as are crude tty-conversions of those papers.
.SH SYNOPSIS
MAKE
.SH DESCRIPTION
This is a description of how one can bring up an \fIMH\fR system.
It is assumed that you have super-user privileges in order to
(re\-)install \fIMH\fR.
Super-user privileges are not required to configure or generate \fIMH\fR.
.PP
Become the super-user and cd to /usr/src/local/
(or whatever you keep your local sources).
The distribution tape contains the hierarchy for the mh.6-8/ directory.
Bring the sources on-line:
.sp 1
.nf
# cd /usr/src/local
% tar xv
% cd mh-6.8
.fi
.SH CONFIGURATION
First, go to the conf/ directory.
.sp 1
.nf
% cd conf/
.fi
.sp 1
This directory contains files that will produce source files tailored
for your choice of \fIMH\fR configuration.
You should edit only the file \fBMH\fR.
This file contains configuration directives.
These configuration directives are read by the \fImhconfig\fR program to
produce customized files.
.sp
For examples of various configurations,
look in the directory \fBconf/examples/\fR.
The file \fBMH\fR provided in \fBconf/\fR is a reasonable default.
Lines beginning with `#' are comments, and are not otherwise interpreted.
.PP
Here are the \fIMH\fP configuration directives available.  Be sure
to read through this list completely before attempting to decide
what directives are appropriate for your system.  
.sp
More information on some of these options is available in the
the \fIAdministrator's Guide\fR.  If you do not have a printed
copy, you should configure your system with the default
configuration file, \fBMH\fP, then generate and print a copy
of the guide (as described below).
.in +.5i

.de Uh
.ti -.75i
.B "\\$1"
.ne 4
..
.Uh "Installation paths"
.ti -.5i
bin: /usr/local
.br
The directory where user\-invoked programs go (see manual section 1).

.ti -.5i
etc: /usr/local/lib/mh
.br
The directory where pgm\-invoked programs go (see manual section 8).

.ti -.5i
mail: /usr/spool/mail
.br
The directory where the maildrops are stored.
If this pathname is absolute (i.e., begins with a \fB/\fR\0),
then the user's maildrop is a file called \fB$USER\fR in this directory.
If the pathname is not absolute,
then the user's maildrop is in the user's home directory under the given name.

.ti -.5i
mandir: /usr/man
.br
The parent directory of the manual entries.

.ti -.5i
manuals: standard
.br
Where manual entries should be installed,
relative to the directory given with \*(lqmandir\*(rq.
Either \*(lqlocal\*(rq to install manual entries under \fBmanl/\fR,
or \*(lqnew\*(rq to install manual entries under \fBmann/\fR,
or \*(lqold\*(rq to install manual entries under \fBmano/\fR,
or \*(lqstandard\*(rq to install manual entries under \fBman?/\fR,
or \*(lqbsd44\*(rq to install manual entries as \fBman?/\fIpage\fP.0\fR,
or \*(lqgen\*(rq to generate but not install them,
or \*(lqnone\*(rq to neither generate nor install them.

Any of these values may have the suffix \*(lq/cat\*(rq appended 
to it.   In that case, the manual entries will be formatted
with \*(lqnroff -man\*(rq and they will be installed in the
corresponding \*(lqcat?\*(rq directories.

For example,
to install manual entries under \fB/usr/man/u_man/man?\fR,
use \*(lqstandard\*(rq and \fB/usr/man/u_man\fR for \*(lqmandir\*(rq.
To install formatted manual entires under \fB/usr/contrib/man/cat?\fR,
use \*(lqstandard/cat\*(rq and \fB/usr/contrib/man\fR for \*(lqmandir\*(rq.
To install formatted manual entries using the BSD44 convention,
use \*(lqbsd44/cat\*(rq.

.ti -.5i
chown: /etc/chown
.br
The location of the \fIchown\fR\|(8) on your system.
If \fIchown\fR is in your search path,
just use the value of \*(lqchown\*(rq.
On SYS5 systems,
this should probably be \*(lq/bin/chown\*(rq.

.ti -.5i
cp: cp
.br
The command to copy files when installing, if not \*(lqcp\*(rq.
(Some sites use \*(lqcp\0\-p\*(rq.)

.ti -.5i
ln: ln
.br
The command to link files together in the source tree, if not \*(lqln\*(rq.
If you're using something like \fBlndir\fP to keep
your compile tree separate from your source tree,
set this to \*(lqln\0\-s\*(rq or \*(lqcp\*(rq.

.ti -.5i
remove: mv \-f
.br
How \fIMH\fR should make backup copies
of existing files when installing new files.
To simply remove the old files, use \*(lqrm\0\-f\*(rq.

.Uh "Compiler/loader"
.ti -.5i
cc: cc
.br
The name of your C compiler, if not \*(lqcc\*(rq.

.ti -.5i
ccoptions: \-O
.br
Options given directly to \fIcc\fR\|(1).
The most common is \*(lq\-M\*(rq if you're running \fIMH\fR on an ALTOS.
This defaults to \*(lq\-O\*(rq.  If you define this and want to 
keep \*(lq\-O\*(rq, be sure to include it explicitly.
If you're using the \fIGNU\fP C compiler, it should
include `\-traditional'.  See \*(lqoptions:\*(rq for `\-D' options.

.ti -.5i
curses: \-lcurses\0\-ltermlib
.br
This should be the loader option required to load the \fItermcap\fR\|(3)
and \fIcurses\fR\|(3) libraries on your system.
On SYS5 systems, it probably should be just \*(lq\-lcurses\*(rq.
Some sites have reported that both \*(lq\-lcurses\*(rq and
\*(lq\-ltermlib\*(rq are necessary.

.ti -.5i
ldoptions: \-s
.br
Options given directly to \fIld\fR\|(1) (via \fIcc\fR\|) at the beginning
of the command line.
Useful for machines which require arguments to tell \fIld\fR to increase the
stack space (e.g. the Gould, which uses \*(lq\-m\08\*(rq).
Usually, \*(lq\-s\*(rq is a good choice in any event.

.ti -.5i
ldoptlibs:
.br
Options given directly to \fIld\fR\|(1) (via \fIcc\fR\|) at the end of the
command line.
The two most common are:
\*(lq\-ldbm\*(rq if you're running MMDF with the \fIdbm\fR package;
and, \*(lq\-lndir\*(rq if you are generating \fIMH\fR on a system
which does not load the new directory access mechanism by default
(e.g., 4.1BSD, SYS5).
If you don't have \fIlibndir\fR on your system,
the sources are in \fBmiscellany/libndir/\fR.

.ti -.5i
lex: lex \-nt
.br
Alternative version of \fIlex\fR.  Used in \fBzotnet/tws/\fR.

.ti -.5i
oldload: off
.br
This controls how \fIMH\fP will try to process library object files to
eliminate local symbols.
Support for the ALTOS loader if \*(lqon\*(rq.
Support for loaders not handling `\-x\0\-r' correctly if \*(lqnone\*(rq.

.ti -.5i
ranlib: on
.br
Support for systems with \fIranlib\fR\|(1).
For SYSTEM 5 systems,
this should be \*(lqoff\*(rq which tells \fIMH\fR to use \fIlorder\fR and
\fItsort\fR instead.
Some SYSTEM 5 sites reported that running this isn't always sufficient.
If this is the case,
then you should edit \fBconf/makefiles/uip\fR to include
\fB\&../sbr/libmh.a\fR and \fB../zotnet/libzot.a\fR twice in the LIBES
variable.

.Uh "Message Transport System"
.ti -.5i
mts: sendmail
.br
Which message transport system to use.
Either \*(lqmmdf\*(rq to use \fIMMDF\fR as the transport system,
\*(lqmmdf2\*(rq to use \fIMMDF\-II\fR as the transport system,
\*(lqsendmail\*(rq to have \fISendMail\fR as the transport system,
\*(lqzmailer\*(rq to have \fIZMAILER\fP as the transport system,
or, \*(lqmh\*(rq to have \fIMH\fR as the transport system.

On UNIX systems supporting TCP/IP networking via sockets
you can add the suffix \*(lq/smtp\*(rq to the mts setting.
This often yields a superior interface as \fIMH\fR will post mail with the
local \fISMTP\fR server instead of interacting directly with \fIMMDF\fR or
\fISendMail\fR.
Hence, for TCP/IP UNIX systems,
the \*(lq/smtp\*(rq suffix to either \*(lqsendmail\*(rq or \*(lqmmdf2\*(rq is
the preferred MTS configuration.
The \*(lq/smtp\*(rq suffix is described in detail in the \fIAdministrator's
Guide\fR; be sure to set \*(lqservers:\*(rq as described in
\fImh\-tailor\fR\|(8) if you use this option.

.ti -.5i
mf: off
.br
Support for mail filtering on those systems in which the message transport
system isn't integrated with \fIUUCP\fR 
This option is strictly for an \fIMH\fR system using either \fIMMDF\-I\fR
as its transport system or one using \*(lqstand\-alone delivery\*(rq.

.Uh "UCI BBoards Facility"
.ti -.5i
bboards: off
.br
If \*(lqon\*(rq, include support for the UCI BBoards facility.
BBoards may be enabled with any mts setting.
If \*(lqoff\*(rq, the BBoard reading program \fIbbc\fR will not be installed.
If \*(lqnntp\*(rq,
include support for the UCI BBoards facility to read the Network News
via the NNTP.
If \*(lqpop\*(rq (formerly \*(lqpopbboards:\0on\*(rq),
include support for the UCI BBoards facility via the POP3 service;
this setting requires \*(lqpop:\0on\*(rq.

.ti -.5i
bbdelivery: off
.br
If \*(lqoff\*(rq,
the BBoards delivery agent and library files will not be installed.
If 
\*(lqon\*(rq,
and you set \*(lqbboards:\*(rq to something besides \*(lqoff\*(rq,
then 
the BBoards delivery agent and library files will be installed
in the \fIbbhome\fR directory (see below).
To read remote BBoards,
the usual configuration would have \fIbbc\fR talk to a \fIPOP3\fR or
\fINNTP\fR server.
However, it may be useful to set this to \*(lqoff\*(rq if 
you NFS mount the \fIbbhome\fR directory from another host
and want to use \fIbbc\fR to read those files directly.

.ti -.5i
bbhome: /usr/spool/bboards
.br
The home directory for the BBoards user.

.Uh "Post Office Protocol"
.ti -.5i
pop: off
.br
Support for POP service.
This allows local delivery for non\-local users
(a major win).
See \fBsupport/pop/pop.rfc\fR for more information on the POP.
This option currently works only on UNIX systems with TCP/IP sockets.
(It doesn't hurt to enable this option regardless of whether or not
you intend to use POP.)  See also \*(lqbboards: pop\*(rq to enable
reading bboards with the POP.

.ti -.5i
popdir: /usr/etc
.br
The directory where the POP daemon (\fBpopd\fP) will be installed.

.ne 5
.ti -.5i
options:
.br
\&`\-D' options to \fIcc\fR\|(1).
.sp
.in +.25i
.ti -.5i
APOP='\*(lq/etc/pop.auth\*(rq'
.br
This option indicates that the POP daemon will
support the non-standard \fBAPOP\fP command,
and specifies the name of \fBAPOP\fP authorization database.
The \fBAPOP\fP
command provides a challenge-based authentication system using
the \fBMD5\fP message digest algorithm.
This facility is documented in 
\fIThe Internet Message\fR (ISBN 0\-13\-092941\-7), a book by Marshall T. Rose.
.sp
This option also causes the
\fBpopauth\fP program to be installed, which
allows the administrator to manipulate the \fBAPOP\fP
authorization database.
For more details, see \fBsupport/pop/pop-more.txt\fR
and the \fIAdministrator's Guide\fP.

.ti -.5i
DPOP
.br
This option indicates that POP subscribers do not have
entries in the \fIpasswd\fR\|(5) file,
and instead have their own separate database (a win).

.ti -.5i
KPOP
.br
Support for KERBEROS with POP.
This code builds
\fIpopd\fP, \fIinc\fP and \fImsgchk\fP to support only the 
\*(lqkpop\*(rq protocol.
This code is still experimental, but is available for 
those sites wishing to test it.

.ti -.5i
MPOP
.br
This option indicates that the POP daemon will
support the non-standard
\fBXTND SCAN\fP command which provides performance
enhancements when using the POP over low-speed connections.
This option also causes an interactive POP
client program, \fBpopi\fP, to be compiled and installed.
A man page for the \fBpopi\fP program is also provided.
.sp
These extensions are described in 
\fIThe Internet Message\fR, a book by Marshall T. Rose.
For more details, see \fBsupport/pop/pop-more.txt\fR.
\fBNote:\fP this option requires \*(lqbboards: pop\*(rq.

.ti -.5i
POP2
.br
Have the POP daemon understand the older
POP2 protocol as well as the \fIMH\fP POP3 protocol \- a major win.
The POP daemon auto-magically
determines which POP protocol your client is using.
If you're enabling POP service,
there's no reason not to enable this option as well.
See also \fIPOPSERVICE\fR.

.ti -.5i
POPSERVICE
.br
The port name the \fIMH\fP POP will use.  For historical reasons,
this defaults to \*(lqpop\*(rq.
.sp
In 1987, the \fIMH\fP POP protocol
(POP version 3) was published as RFC1081 and
was assigned its own port number (110),
which differs from the original POP (version 1 and 2) port number (109).
.sp
To have \fIMH\fP POP use the new assigned port number, 
set POPSERVICE='\*(lqpop3\*(rq', and be sure that this service
name is listed in your \fB/etc/services\fP file on both POP client
and server hosts as \*(lq110/tcp\*(rq.
If you enable \fIPOP2\fP, you can safely leave \fIPOPSERVICE\fP
undefined unless you are using POP3 clients besides \fIMH\fP.

.ti -.5i
RPOP
.br
This option indicates that support for the UNIX variant of POP,
RPOP, which uses privileged sockets for authentication be enabled.
This peacefully co-exists with the standard POP.

.ti -.5i
SHADOW
.br
Indicates that the \fBpopd\fP POP server
can find encrypted passwords in the
\fB/etc/shadow\fR file (and not in the \fB/etc/passwd\fR file).
It should be used only for some (newer) SYSTEM 5 systems.
.in -.25i

The \*(lqAPOP\*(rq and \*(lqMPOP\*(rq non-standard POP
facilities are documented in
\fIThe Internet Message\fR (ISBN 0\-13\-092941\-7),
a book by Marshall T. Rose.
For more details, see \fBsupport/pop/pop-more.txt\fR.
The \*(lqAPOP\*(rq option peacefully co-exists with the standard POP.
The \*(lqMPOP\*(rq option requires \*(lqbboards: pop\*(rq.

.Uh "Shared libraries"
.ti -.5i
sharedlib: off
.br
If \*(lqsun4\*(rq,
makes libmh.a into a SunOS 4.0 (and later) shared library.
If you enable this, be sure to also use \*(lqoptions SUN40\*(rq.
If \*(lqsys5\*(rq, 
makes libmh.a into a SYS5 R4 (and later) shared library.
If you enable this, be sure to also use \*(lqoptions SVR4\*(rq.

.ti -.5i
slflags: \-pic
.br
The compiler flags to produce position independent code.

.ti -.5i
slibdir: /usr/local/lib
.br
The directory where the \fIMH\fP shared library should go.

.ne 4
.ti -.25i
Under SunOS (sun4)
.br
Since some \fIMH\fP programs are setuid, they'll only look for
the library in \*(lqtrusted\*(rq locations.  Putting the library
somewhere besides \fB/usr/lib\fP or \fB/usr/local/lib\fP is not advisable.

If you \fBmust\fP do this, be sure that you add the 
path given by \fBslibdir\fP to the compiler's library search list 
(e.g., \*(lqldoptions:\0\-L/usr/mh/lib\*(rq)
and make sure the path starts with a leading `/'.

You may need to run \fIldconfig\fP\|(8) manually whenever a new
shared object is installed on the system.
See \fIld\fR\|(1) for more information about using shared libraries.

.ti -.25i
Under Solaris 2.0 (and newer)
.br
The above instructions for SunOS apply, except you should set
the run-time library search path using `\-R' instead of `\-L'
(e.g., \*(lqldoptions: \-R/usr/mh/lib\*(rq).

.Uh "General System Dependencies"
.in -.5i
You should include the following directives 
which are appropriate for your version of UNIX.
If you don't know what an
option does, it probably doesn't apply to you.
.in +.5i

.ti -.5i
mailgroup: off
.br
If set, \fIinc\fR is made set-group-id to this group name.
Some SYS5 systems want this to be set to \*(lqmail\*(rq.
Set this if your \fB/usr/spool/mail\fP is not world-writeable.

Note that \fBslocal\fP doesn't know how to deal with this,
and will not work under these systems; just making it set-group-id
will open a security hole.
If you're using \*(lqmailgroup\*(rq,
you should remove \fBslocal\fP (and its man page) from your system.

.ti -.5i
signal: int
.br
The base type (int or void) of the function
parameter/return value of \fIsignal\fR\|(2).
The default is \fBint\fR.
Set \*(lqsignal void\*(rq on systems which use this type
(e.g., SYSTEM 5 V3.0 and later or Sun OS 4.0 and later).

.ti -.5i
sprintf: char *
.br
The return value of the \fIsprintf\fR library routine.
This defaults to \*(lqchar\0*\*(rq.  Set this to \*(lqint\*(rq if
you have an older version of SYSTEM 5 which has this routine return an
\*(lqint\*(rq type.

.ne 5
.ti -.5i
options:
.br
\&`\-D' options to \fIcc\fR\|(1).
.sp
.in +.25i
.ti -.5i
ALTOS
.br
Use on XENIX/v7 systems.
Also, be sure to use \*(lqoptions V7\*(rq.

.ti -.5i
ATTVIBUG
.br
This option causes
\fIMH\fP to return to the \*(lqWhat now?\*(rq
prompt if your initial editor is \fBvi\fP
and it exits with non-zero status.
Use on Sun OS 4.1 and other systems where the
\fB/usr/ucb/vi\fP editor was changed to
exit with its status equal to the number of pseudo-\*(lqerrors\*(rq
encountered during the edit.  This causes a problem for programs that
test the exit status of their editor and abort if the status is non-zero.
(This includes \fIMH\fP and programs like \fB/usr/etc/vipw\fP).

.ti -.5i
AUX
.br
Use with AUX systems.

.ti -.5i
BIND
.br
If you are running with the BIND code on UNIX systems
with TCP/IP sockets (e.g. 4.{2,3}BSD),
be sure to define this.

.ti -.5i
BSD41A
.br
Use on 4.1a Berkeley UNIX systems.

.ti -.5i
BSD42
.br
Use on Berkeley UNIX systems on or after 4.2BSD.

.ti -.5i
BSD43
.br
Use on 4.3 Berkeley UNIX systems.
Also, be sure to use \*(lqoptions BSD42\*(rq.
If \fIopenlog\fR\|(3) (see \*(lqman 3 syslog\*(rq)
takes three arguments instead of two,
and your \fIwrite\fR\|(1) command is set\-group\-id
to group \*(lqtty\*(rq, use this option.
If only one of these conditions is true, you lose.

.ti -.5i
BSD44
.br
Use on Berkeley UNIX systems on or after 4.4BSD.
Also, be sure to use \*(lqoptions BSD43\*(rq
and \*(lqoptions BSD42\*(rq.

.ti -.5i
DBMPWD
.br
Use this option if your \fIgetpwent\fR\|(3) routines read a 
dbm database (such as with Yellow Pages) instead of doing
a sequential read of \fB/etc/passwd\fR.
Without DBMPWD the entire passwd file is read into
memory one entry at a time for alias expansion.
This is a performance improvement when reading
a standard \fB/etc/passwd\fR file,
but is \fIvery\fR slow on systems with a dbm database.
At one site that runs
YP on a large passwd file, it showed a 6:1 performance improvement.

.ti -.5in
GCOS_HACK
.br
The so-called \*(lqgcos\*(rq field of the password file is 
used as a last resort
to find the user's full name (see \fImh-profile\fP\|(5) for details).
Enable this option
if your \fIpasswd\fP\|(5) man page notes that the `&'
character in the \*(lqgcos\*(rq field stands for the login name.

.ti -.5i
FCNTL
.br
Directs \fIMH\fP to use the \fBfcntl()\fP system call for kernel-level
locking.  If you're using a SYS5 system, you may want
this option.  (See also `FLOCK' and `LOCKF').

.ti -.5i
FLOCK
.br
Directs \fIMH\fP to use the \fBflock()\fP system call for kernel-level
locking.  If you're on a BSD42 system,
and you're not using NFS to read or write maildrops,
you should enable this option.  (See also `FCNTL' and `LOCKF').

.ti -.5i
HESIOD
.br
Support for HESIOD.  
This code was contributed, and included no documentation.

.ti -.5i
LOCKF
.br
Directs \fIMH\fP to use the \fBlockf()\fP system call for kernel-level
locking.  If you're using NFS to read or
write maildrops, you should enable this option.  (See also `FLOCK'
and `FCNTL').

.ti -.5i
locname
.br
Hard-wires the local name for the host \fIMH\fR is running on.
For example, locname='\*(lqPICKLE\*(rq'.
It's probably better to either let UNIX tell \fIMH\fR this information,
or to put the information in the host specific \fBmtstailor\fR file.

.ti -.5i
MORE
.br
Defines  the location of the \fImore\fR\|(1) program.
On ALTOS and DUAL systems, set
MORE='\*(lq/usr/bin/more\*(rq'.
The default is \*(lq/usr/ucb/more\*(rq.

.ti -.5i
NDIR
.br
For non-Berkeley UNIX systems,
this \fIMH\fR will try to find the new directory access mechanism by looking
in \fB<ndir.h>\fR if this option is given.
Otherwise, \fIMH\fR will try \fB<dir.h>\fR.
If you still can't get this to work on your system,
edit \fBh/local.h\fR as appropriate.
(See also `SYS5DIR'.)

.ti -.5i
NFS
.br
Tells \fIMH\fR to hack around a problem in the NFS C library.
If you get an undefined symbol \*(lqruserpass\*(rq when compiling
\fIMH\fP, you probably need this option.  If, however, you include this
option and get an undefined symbol \*(lq\(ru\^\(ruruserpass\*(rq
when compiling, then you should omit this option.
(See also `NORUSERPASS'.)

.ti -.5i
NOIOCTLH
.br
Tells \fIMH\fR not to include the file \fB<sys/ioctl.h>\fR.
To be used on systems where this file is not present.

.ti -.5i
NORUSERPASS
.br
Tells \fIMH\fR that your system doesn't have the
\fIruserpass\fP\|(3) routine;
\fIMH\fR will include its own copy of this
routine in its library.
(See also `NFS'.)

.ti -.5i
NTOHLSWAP
.br
Tells \fIMH\fR to use the \fBntohl()\fR macro when processing
\fImsh\fR binary map files.  \fIMH\fR can use this macro on
systems with the include file \fBnetinet/in.h\fR,
to byte-swap the binary information in these map files.
If you're using the same map files on machines of different
architectures, enable this option.

.ti -.5i
RENAME
.br
Include this option if your system has a \fBrename()\fP library
call.  This is true on BSD42 and newer and some SYS5 systems.

.ti -.5i
SENDMAILBUG
.br
Causes SMTP reply code 451 (failure)
to be considered the same as code 250 (OK).
Since this might cause problems, only
enable this if you are certain that your SendMail will
return this code even when it doesn't mean to indicate a failure.

.\" .ti -.5i
.\" SMTP_ONEX
.\" .br
.\" Causes \fIMH\fP to give the \*(lqONEX\*(rq SMTP command
.\" when posting mail (a SendMail performance hack).
.\" Useful only if you're running a SendMail
.\" which will successfully reset with the \*(lqRSET\*(rq command
.\" after seeing the \*(lqONEX\*(rq command;
.\" otherwise, if you enable this 
.\" you may have problems posting messages with \*(lqBCCs\*(rq.
.\" 
.ti -.5i
SOCKETS
.br
Indicates the availability of a socket interface
for TCP/IP networking that is compatible with 4.{2,3}BSD UNIX.
It is not necessary to define this when BSD42 is already defined,
but it might be useful for SYSTEM 5 or HPUX systems with TCP/IP sockets.

.ti -.5i
SUN40
.br
Use on Sun OS 4.0 (and later?) systems.  You also will need
\*(lqoptions BSD42\*(rq, \*(lqoptions BSD43\*(rq, and
\*(lqsignal void\*(rq.

If you're using Sun's brain-damaged approach to offering Domain
Name Service through NIS, be sure to include
\*(lqoptions BIND\*(rq and
\*(lqldoptions \-lresolv\*(rq to work around some NIS/DNS bugs.

.ti -.5i
SYS5
.br
Use on AT&T SYSTEM 5 R3 (and newer?) UNIX systems.  See also \fImailgroup\fR.

.ti -.5i
SYS5DIR
.br
Define this if your system uses \*(lqstruct dirent\*(rq
instead of \*(lqstruct direct\*(rq.
This is true of System V Release 3.0 and later.
Uses include file \fB<dirent.h>\fR
and the routines \fImkdir\fR, \fIrmdir\fR and \fIgetcwd\fR.

.ti -.5i
SVR4
.br
Use on AT&T SYSTEM 5 R4 (and newer?) UNIX systems. You should 
also include \*(lqoptions SYS5\*(rq and \*(lqoptions SYS5DIR\*(rq.
See also \fImailgroup\fR.
You will also need to include \*(lqoldload none\*(rq if your \fBld\fP
doesn't handle `\-x\0\-r' correctly.

.ti -.5i
TERMINFO
.br
Define TERMINFO if you have it.
You get it automatically if you're running SYS5, and you don't get
it if you're not.  (If you're not SYS5, you probably have termcap.)

.ti -.5i
TZNAME
.br
Use time zone names from the \fItzname\fR variable, set via \fItzset\fR.
Only applicable on SYSTEM 5 systems and only effective when you have
asked for alpha\-timezones (see the ATZ option).  See also ZONEINFO.

.ti -.5i
UNISTD
.br
Include this option if your system has the file \fB<unistd.h>\fP.
If not specified, the LOCKF option will include \fB<sys/fcntl.h>\fP.

.ti -.5i
V7
.br
Use on V7 UNIX systems.
Also, be sure to use \*(lqoptions void=int\*(rq.

.ti -.5i
VSPRINTF
.br
Include this option if your system has the \fIvsprintf\fP\|(3)
library routine; otherwise, \fI\(rudoprnt\fP\|(3) will be used.

.ti -.5i
WAITINT
.br
BSD42 based systems call the \fIwait\fP\|(2)
system routine with a pointer to type \fIunion wait\fP.
Include this option if you included \*(lqoptions BSD42\*(rq, but
your system calls the \fIwait\fP\|(2)
system routine with a pointer to type \fIint\fP
(the non-BSD42 default).

.ti -.5i
ZONEINFO
.br
Specify this if you have a BSD43 based system that keeps time zone
information /etc/zoneinfo or /usr/lib/zoneinfo (SunOS),
and where 
the \fIstruct tm\fP 
returned by \fIlocaltime\fP\|(3) contains a \fItm_gmtoff\fP element
(see \fB/usr/include/time.h\fP).
With this fix the GMT offset specified in outgoing mail
will be corrected when the TZ enviornment variable is set
to a different time zone.  See also TZNAME.
.in -.25i

.Uh "Site Preferences"
.br
.in -.5i
These options change the
default behavior of \fIMH\fP or enable optional features.
Add the options which are appropriate for your configuration 
or your site preferences.
.in +.5i

.ti -.5i
editor: prompter
.br
The default editor for \fIMH\fR.

.ne 5
.ti -.5i
options:
.br
\&`\-D' options to \fIcc\fR\|(1).
.sp
.in +.25i
.ne 4
.ti -.5i
ATZ
.br
Directs \fIMH\fR to use alpha\-timezones whenever possible.
You should not use this option if you are on the Internet,
since it will make your host non-compliant with RFC-1123
(Requirements for Internet Hosts).

.ti -.5i
ATHENA
.br
Makes \fIrepl\fR `\-nocc\0all' the default instead of `\-cc\0all'.
You may want to enable this if you're using \fIxmh\fR.

.ti -.5i
BANG
.br
Directs \fIMH\fR to favor `!' over `@@' in addressing.

.ti -.5i
BERK
.br
Optional for for 4.{2,3}BSD sites running SendMail.
Disables nearly all of the RFC822 address and header-parsing routines
in favor of recognizing such formats as ASCnet, and so on.
If you don't need to disable the parser for this reason,
you probably want to use \*(lqoptions DUMB\*(rq instead.

.ti -.5i
COMPAT
.br
If you previously ran a version of \fIMH\fR earlier than mh.4 use this option.
After a short grace period,
remove it and re-{configure,generate,install} everything.

.ti -.5i
DUMB
.br
Directs \fIMH\fR not to try and rewrite addresses to their 
\*(lqofficial\*(rq form.

.ti -.5i
FOLDPROT
.br
Defines the octal value for default folder-protection.
For example, FOLDPROT='\^\*(lq0700\*(rq\^'.
The default is \*(lq0711\*(rq.

.ti -.5i
ISI
.br
When using \*(lqrepl\0\-ccme\*(rq,
only \*(lqcc:\*(rq the first address found which belongs to the user;
any other \fIAlternate-Mailboxes\fR do not receive \*(lqcc:\*(rqs.

.ti -.5i
LINK
.br
Defines the filename for alternate file name for \fIdist\fR and \fIrepl\fR.
For example, LINK='\^\*(lq\^\\\^\\\^043\*(rq\^'
to use the pound\-sign character.
The default is \*(lq@@\*(rq.

.ti -.5i
MHE
.br
Enables crude support for Brien Reid's MHE interface.
Recommended for use with the GNU Emacs mh-e package.

.ti -.5i
MHRC
.br
Enables \fIMH\fR to recognize the \fICShell\fR's `~'\-construct.
This is useful for sites that run with a ~/.mhrc for their users.

.ti -.5i
MIME
.br
Enables support for multi-media messages,
as specified in RFC 1341 \-\- a major win.
This allows you to include things like audio,
graphics, and the like, in your mail messages.
Several \fIMH\fP commands are extended to support these multi-media
messages,
and the \fImhn\fR command is provided to encode and decode
\fBMIME\fP messages.
For more details, see \fBmiscellany/multi-media/READ-ME\fP
and \fImhn\fR\|(1).

.ti -.5i
MSGID
.br
Enables \fBslocal\fP to detect and surpress duplicate messages received.
This code uses the \fB<ndbm.h>\fP library,
and requires \*(lqoptions BSD42\*(rq since
it uses the \fIflock\fP\|(2) system call for locking.
(Note that this means its database locking does not work over NFS.)
It has only been tested under SUN40.

.ti -.5i
MSGPROT
.br
Defines the octal value for default folder-protection.
For example, MSGPROT='\^\*(lq0600\*(rq\^'.
The default is \*(lq0644\*(rq.

.ti -.5i
NOMHSEQ
.br
Directs \fIMH\fR to make private sequences the default.

.ti -.5i
OVERHEAD
.br
Enable \fIMH\fR commands to read profile/context from open fd:s
without doing an open(); see \fImh-profile\fP\|(5) for the details.

.ti -.5i
RPATHS
.br
Directs \fIinc\fR to note UNIX \*(lqFrom\ \*(rq lines as Return-Path: info.

.ti -.5i
SBACKUP
.br
Defines the prefix string for backup file names.
For example, SBACKUP='\^\*(lq\^\\\^\\\^043\*(rq\^'.
The default is \*(lq,\*(rq.

.ti -.5i
TMA
.br
Support for the TTI \fItrusted mail agent\fR (TMA).
Although the TTI TMA is \fBnot\fR in the public domain,
the \fIMH\fR support for the TTI TMA \fBis\fR in the public domain.
You should enable this option only if you are licensed to run the TMA
software
(otherwise, you don't have the software in your \fIMH\fR source tree).

.ti -.5i
TTYD
.br
Support for TTYD.  This is no longer in wide use, and is not recommended.

.ti -.5i
UCI
.br
First, \*(lq_\*(rq and \*(lq#\*(rq are recognized as the prefixes for
scratch files.
Second, support for the UCI group\-leadership mechanism is enabled in
\fIconflict\fR.
Third, the first line of the file
file \fB$HOME/.signature\fR is used as the \fIFull Name\fR part
of your \*(lqFrom:\*(rq header.
This may conflict with the interpretation of this file by \fINews\fR.
If you're not at UCI, you probably don't want this option.

.ti -.5i
UK
.br
Directs the \fIscan\fR program to generate UK-style dates by default.

.ti -.5i
WHATNOW
.br
Enable certain \fIMH\fR commands to act differently when $mhdraft set.

.ti -.5i
YEARMOD
.br
This option makes the \fImh-format\fP \fB%(year)\fP function
always return a value less than 100.
Enable this option if you have local \fImh-format\fP\|(5) files
which cannot handle 4-digit years.
You should convert these files to use a 4-character field width,
or use the \fB%(modulo 100)\fP function to obtain a 2-digit year value.
After a short grace period,
remove `YEARMOD' and re-{configure,generate,install} everything.
.in -.25i

.Uh "Testing/debugging"
.ti -.5i
debug: off
.br
Support for debug mode of \fIMH\fR.
Don't use this unless you know what you're doing,
which isn't likely if you're reading this document!

.ti -.5i
regtest: off
.br
Set this to \*(lqon\*(rq
if you are doing regression testing among different
compilations of \fIMH\fP, and you do not want the hostname
and compile date included in \fIMH\fP binaries.  

.sp
.in -.5i
.PP
Now edit \fBconf/config/mtstailor\fR,
depending on your choice of the setting
for mts in the \fIMH\fR configuration file.
for an mts setting of \*(lqmh\*(rq,
look at the file \fBconf/tailor/mhmts\fR;
for an mts setting of \*(lqsendmail\*(rq, \*(lqsendmail/smtp\*(rq,
\*(lqmmdf/smtp\*(rq, or \*(lqmmdf2/smtp\*(rq,
look at the file \fBconf/tailor/sendmts\fR;
and,
for an mts setting of \*(lqmmdf\*(rq, or  \*(lqmmdf2\*(rq,
look at the file \fBconf/tailor/mmdf\fR.
.PP
Now install the configured files into the source areas.  (On SYS5
systems, or other systems where you get complaints about
\*(lq_index\*(rq and \*(lq_rindex\*(rq being undefined,
you should use \*(lqmake sys5\*(rq to compile mhconfig.)
.sp 1
.nf
% make
% ./mhconfig MH
.fi
.PP
\fBBefore proceeding\fP,
you should familiarize yourself with the \fIAdministrator's Guide\fR.
To generate an \fInroff\fR version, go to the doc/ directory
and type:
.sp 1
.nf
% (cd ../doc/; make ADMIN.doc)
.fi
.sp
.PP
If you're already running \fIMH\fR at your site,
you should also read the \fImh\fR changes document \fBCHANGES\fP.
The source is in \fBpapers/changes/\fR.
.PP
After reading the \fIAdministrator's Guide\fR, you may decide
to change your MH configuration.  If so, cd back to the \fBconf/\fP
directory, re-edit the files \fBMH\fP
and \fBconf/config/mtstailor\fR, and re-run \fImhconfig\fP.
.PP
You now proceed based on your choice of a transport system
(the setting for mts above).
The best interface is achieved with \*(lqsendmail\*(rq
followed by \*(lqmmdf\*(rq or (\*(lqmmdf2\*(rq),
and then \*(lqmh\*(rq (stand\-alone delivery, not recommended).
.SS SENDMAIL
If you have not enabled BBoards or POP
then no further MTS\-specific action is required on your part!

If you have enabled POP, but you 
want to let \fISendMail\fP deliver mail POP mail using its
standard delivery program \fB/bin/mail\fP,
then, again, no further MTS\-specific action is required on your part!

Otherwise,
go to the mts/sendmail/ directory.
.sp 1
.nf
% cd ../mts/sendmail/
.fi
.sp 1
This directory contains files whose definitions correspond to the
configuration of your \fISendMail\fR system.
If you have enabled BBoards or POP service,
then you will need to re\-configure \fISendMail\fR.
First, in the \*(lqlocal info\*(rq section of your site's
\fISendMail\fR configuration file,
choose a free macro/class (B is used in this distribution),
and add these lines:
.sp 1
.in +.5i
.nf
# BBoards support
DBbboards
CBbboards
.fi
.in -.5i
.sp 1
Second, immediately after the inclusion of the zerobase file,
in the \*(lqmachine dependent part of ruleset zero\*(rq section,
add these lines:
.sp 1
.in +.5i
.nf
# resolve names for the BBoards system
R$+<@@$=B>              $#bboards$@@$2$:$1              topic@@bboards
.fi
.in -.5i
.sp 1
Be sure to use tabs when separating these fields.
Third, add the line
.sp 1
.in +.5i
.nf
include(bboardsMH.m4)
.fi
.in -.5i
.sp 1
after the line
.sp 1
.in +.5i
.nf
include(localm.m4)
.fi
.in -.5i
.sp 1
in your site's \fISendMail\fR configuration file.
Finally, you should link the file \fBmts/sendmail/bboardsMH.m4\fR into your
\fISendMail\fR cf/ directory and re\-configure \fISendMail\fR.
.PP
If you have enabled POP service,
a similar procedure must be used on the POP service host,
to re\-configure \fISendMail\fR.
First, in the \*(lqlocal info\*(rq section of your site's
\fISendMail\fR configuration file,
choose a free macro/class (P is used in this distribution),
and add these lines:
.sp 1
.in +.5i
.nf
# POP support
DPpop
CPpop
.fi
.in -.5i
.sp 1
Second, immediately after the inclusion of the zerobase file,
in the \*(lqmachine dependent part of ruleset zero\*(rq section,
add these lines:
.sp 1
.in +.5i
.nf
# resolve names for the POP system
R$+<@@$=P>              $#pop$@@$2$:$1                  subscriber@@pop
.fi
.in -.5i
.sp 1
Be sure to use tabs when separating these fields.
Third, add the line
.sp 1
.in +.5i
.nf
include(popMH.m4)
.fi
.in -.5i
.sp 1
after the line
.sp 1
.in +.5i
.nf
include(localm.m4)
.fi
.in -.5i
.sp 1
in your site's \fISendMail\fR configuration file.
Finally, you should link the file \fBmts/sendmail/popMH.m4\fR into your
\fISendMail\fR cf/ directory and re\-configure \fISendMail\fR.
.SS MMDF
If you want \fIMMDF\fR to be your transport service,
and have \fBNOT\fR specified \*(lqmmdf/smtp\*(rq (or \*(lqmmdf2/smtp\*(rq)
as your mts setting,
then go to the mmdf/ directory.
(If you're using \*(lqmmdf/smtp\*(rq or \*(lqmmdf2/smtp\*(rq
as your mts setting, then skip to the next section.)
.sp 1
.nf
% cd ../mts/mmdf/
.fi
.sp 1
This directory contains files whose definitions correspond to the
configuration of your \fIMMDF\fR system.
.PP
If you're running \fIMMDF\-I\fR,
then copy the following files from wherever you keep the \fIMMDF\fR sources
to this directory: mmdf/h/ch.h, mmdf/h/conf.h, utildir/conf_util.h,
utildir/ll_log.h, mmdf/h/mmdf.h, utildir/util.h, mmdf/mmdf_lib.a,
and utildir/util_lib.a.
.PP
If you're running \fIMMDF\-II\fR,
then copy the following files from where you keep the \fIMMDF\fR sources
to this directory: h/ch.h, h/conf.h, h/dm.h, h/ll_log.h, h/mmdf.h, h/util.h,
and lib/libmmdf.a
.PP
If you have enabled bboards,
then the directories \fBsupport/bboards/mmdfI\fR
and \fBsupport/bboards/mmdfII\fR
contain information you'll need to
put a UCI BBoards channel in your \fIMMDF\fR configuration.
Similarly, if you have enabled option \*(lqmf\*(rq and are
running \fIMMDF\-I\fR,
then the \fBzotnet/mf/mmdfI/\fR directory contains information you'll need to
put a \fIUUCP\fR channel in your \fIMMDF\-I\fR configuration.
Finally, the directory \fBsupport/pop/mmdfII\fR contains information you'll
need to put a POP channel in your \fIMMDF\-II\fR configuration.
.PP
Note that \fIMMDF\-II\fR is distributed with the BBoards channel,
although the version in the \fIMH\fR distribution might be more current,
the version in the \fIMMDF\-II\fR distribution has been tested with that
revision of \fIMMDF\fR.
.SS MMDF/SMTP
If you are using \*(lqmmdf/smtp\*(rq as your mts setting,
then no further MTS\-specific action is required on your part!
.SS MMDF2/SMTP
If you are using \*(lqmmdf2/smtp\*(rq as your mts setting,
then no further MTS\-specific action is required on your part!
.SS "STAND\-ALONE DELIVERY"
If, instead, you want \fIMH\fR to handle its own mail delivery,
then no further MTS\-specific action is required on your part!
.SH GENERATION
Go to the \fIMH\fP top-level directory and generate the system.
.sp 1
.nf
% cd ../; make
.fi
.PP
This will cause a complete generation of the \fIMH\fR system.
If all goes well, proceed with installation.
If not, complain, as there \*(lqshould be no problems\*(rq at this step.
.SH INSTALLATION
If the directories you chose for the user\-programs,
support\-programs and manuals
(\*(lqbin\*(rq, \*(lqetc\*(rq, \*(lqpopdir\*(rq, \*(lqslibdir\*(rq,
and \*(lqmandir\*(rq in the \fBconf/MH\fR file)
don't exist,
you should create them at this point.
.PP
Next, if you enabled support for the UCI BBoards facility,
then create a login
called \*(lqbboards\*(rq with the following characteristics:
home directory is \fB/usr/spool/bboards/\fR with mode 755
(actually, use the value for \*(lqbbhome\*(rq given in the \fIMH\fR
configuration file),
login shell is \fB/bin/csh\fR (or \fB/bin/sh\fR),
and, encrypted password field is \*(lq*\*(rq.
The \*(lqbboards\*(rq login should own the \fB/usr/spool/bboards/\fR
directory.
In addition to creating \fB/usr/spool/bboards/\fR,
also create \fB/usr/spool/bboards/etc/\fR
and \fB/usr/spool/bboards/archive/\fR.
These directories should also be owned by the \*(lqbboards\*(rq login.
.PP
If you enabled support for POP,
then on the POP service host,
create a login called \*(lqpop\*(rq with the following characteristics:
home directory is \fB/usr/spool/pop/\fR with mode 755,
login shell is \fB/bin/csh\fR,
and, encrypted password field is \*(lq*\*(rq.
If you don't have \fB/bin/csh\fR on your system (V7),
then \fB/bin/sh\fR is just fine.
The \*(lqpop\*(rq login should own the \fB/usr/spool/pop/\fR directory.
You'll also need to add a line to the \fB/etc/services\fR file and the
\fB/etc/rc.local\fR file,
see the \fIAdministrator's Guide\fR  for more details.
.PP
If this is not the first time you have installed \fIMH\fR,
these files will need particular attention:

.nf
.in +.5i
.ta \w'VeryVeryBigDirectoryName  'u
\fIDirectory\fR \fIFiles\fR
\*(lqetc/\*(rq  MailAliases, BBoardAliases, mtstailor
/usr/spool/bboards/     BBoards, \&.cshrc, \&.mh\(ruprofile
/usr/spool/bboards/etc/ *
.re
.in -.5i
.fi
.PP
The \fBMailAliases\fR, \fBBBoardAliases\fR, \fBmtstailor\fR and \fBBBoards\fR
files will \fBNOT\fP be installed over existing copies;
you will need to edit these by
hand and merge in any changes from your previous \fIMH\fR release.
The other files under \fB/usr/spool/bboards/\fR will be overwritten
if they exist.
You may wish to preserve your old versions of these before installing
\fIMH\fR.
.PP
As the super-user, and from the mh.6/ directory, install the system.
.sp 1
.nf
# make inst\-all
.fi
.sp 1
This will cause the \fIMH\fR 
processes and files to be transferred to the appropriate areas
with the appropriate attributes.
.SH TAILORING
See the \fIAdministrator's Guide\fR for information on tailoring \fIMH\fR for
the MTS, BBoards, and POP.
.SH DOCUMENTATION
In addition to this document,
the \fIAdministrator's Guide\fP,
and the \fIUser's Manual\fP,
there are several documents referenced by the user's manual which may be
useful.
The sources for all of these can be found under the \fBpapers/\fR directory.
.SH "OTHER THINGS"
Consult the directory \fBmiscellany/\fR for the sources to a number of things
which aren't part of the mainstream \fIMH\fR distribution,
but which are still quite useful.
.SH FILES
Too numerous to mention.  Really.
.SH "SEE ALSO"
make(1)
.SH BUGS
The \fImhconfig\fR program should be smarter.
.PP
There's no way to print the \fIAdministrator's Guide\fP
until after you have configured the system; it is difficult
to configure the system without the \fIAdministrator's Guide\fP.
.PP
The Makefiles should know when \fImhconfig\fR has been run and force
\*(lqmake clean\*(rq behavior.
@


2.118
log
@update for 6.8.4
drop UUCP address, add HTTP address
drop louie.udel.edu distribution site
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.117 1995/12/05 19:36:14 jromine Exp jromine $
d53 1
a53 1
the \fBMH Home Pagef\fP on the World Wide Web at
@


2.117
log
@update distribution address
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.116 1994/11/17 16:10:10 jromine Exp jromine $
d4 1
a4 1
.TH MH-GEN 8 MH.6.8.3 [mh.6]
d51 4
a54 3
The current computer mailbox for \fIMH\fR is \fBBug\-MH@@ICS.UCI.EDU\fR
(in the ARPA Internet),
and \fB...!ucbvax!ucivax!bug\-mh\fR (UUCP).
d69 1
a69 1
ftp.ics.uci.edu [128.195.1.1] and retrieve the file pub/mh/mh-6.8.tar.Z.
d75 1
a75 2
This tar file is also available on louie.udel.edu 
[128.175.1.3] in portal/mh-6.8.tar.Z.  You may also find MH on
d78 1
a78 1
either ftp.ics.uci.edu or louie.udel.edu.
@


2.116
log
@change UCI phone prefix
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.115 1993/12/01 00:44:23 jromine Exp jromine $
d94 2
d97 1
a97 3
Office of Academic Computing
360 Computer Science
Irvine, CA  92717  USA
@


2.115
log
@update for 6.8.3
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.114 1993/09/01 21:25:42 jromine Exp jromine $
d99 1
a99 1
+1 714 856 5153
@


2.114
log
@warn about re-editing mtstailor
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.113 1993/08/27 22:22:08 jromine Exp jromine $
d4 1
a4 1
.TH MH-GEN 8 MH.6.8.2 [mh.6]
@


2.113
log
@recommend creating mandir, popdir and slibdir
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.112 1993/08/25 18:07:10 jromine Exp jromine $
d1162 2
a1163 2
directory, re-edit the file \fBMH\fP, and re-run
\fImhconfig\fP.
@


2.112
log
@update to MH 6.8.2
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.111 1993/08/20 19:47:56 jromine Exp jromine $
d1344 4
a1347 3
If the directories you chose for the user\-programs and
support\-programs
(\*(lqbin\*(rq and \*(lqetc\*(rq in the \fBconf/MH\fR file)
@


2.111
log
@update version
remove ONEX
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.110 1993/08/19 23:57:46 jromine Exp jromine $
d4 1
a4 1
.TH MH-GEN 8 MH.6.8.1 [mh.6]
@


2.110
log
@note bsd44 manuals convention
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.109 1993/08/19 23:34:15 jromine Exp jromine $
d4 1
a4 1
.TH MH-GEN 8 MH.6.8 [mh.6]
d793 11
a803 11
.ti -.5i
SMTP_ONEX
.br
Causes \fIMH\fP to give the \*(lqONEX\*(rq SMTP command
when posting mail (a SendMail performance hack).
Useful only if you're running a SendMail
which will successfully reset with the \*(lqRSET\*(rq command
after seeing the \*(lqONEX\*(rq command;
otherwise, if you enable this 
you may have problems posting messages with \*(lqBCCs\*(rq.

@


2.109
log
@document SMTP_ONEX
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.108 1993/08/19 23:30:08 jromine Exp jromine $
d195 1
d209 2
@


2.108
log
@document SM_ONEX, GCOS_HACK
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.107 1993/06/03 17:54:12 jromine Exp jromine $
d791 1
a791 1
SM_ONEX
d794 6
a799 3
when posting mail.  Useful only if you're running a SendMail
which can still reset with the \*(lqRSET\*(rq SMTP command
after seeing the \*(lqONEX\*(rq command.
@


2.107
log
@document new "manuals: standard/cat" syntax
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.106 1993/02/26 19:00:51 jromine Exp jromine $
d674 10
d789 8
@


2.106
log
@add NORUSERPASS for 386BSD
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.105 1992/12/14 17:19:19 jromine Exp jromine $
d197 6
d206 2
@


2.105
log
@WAITINT option
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.104 1992/12/02 19:07:37 jromine Exp jromine $
d649 2
a650 1
This code is still under development.
d727 1
a727 1
\fIMH\fP, you need this option.  If, however, you include this
d730 1
d737 9
@


2.104
log
@update for release 6.8
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.103 1992/11/21 20:46:59 jromine Exp jromine $
d836 9
@


2.103
log
@clarify restrictions on MSGID option
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.102 1992/11/19 18:09:59 jromine Exp jromine $
d4 1
a4 1
.TH MH-GEN 8 MH.6.7.5beta [mh.6]
d68 1
a68 1
ftp.ics.uci.edu [128.195.1.1] and retrieve the file pub/mh/mh-6.7.tar.Z.
d70 1
a70 1
(approximately 1.5MB).  There should also be a \fBREADME\fR file in
d75 1
a75 1
[128.175.1.3] in portal/mh-6.7.tar.Z.  You may also find MH on
d118 1
a118 1
The distribution tape contains the hierarchy for the mh.6-7/ directory.
d124 1
a124 1
% cd mh-6.7
d1105 2
a1106 2
you should also read the \fImh.6\fR changes documents.
The sources are in \fBpapers/mh6.5/\fR and \fBpapers/mh6.7/\fP.
@


2.102
log
@cleanup format
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.101 1992/11/19 17:45:16 jromine Exp jromine $
d966 5
a970 3
This code requires the \fB<ndbm.h>\fP library, and has only been tested
under SUN40.  It uses the \fIflock\fP\|(2) system call for locking,
so its database locking does not work over NFS.
@


2.101
log
@add note about Solaris sharedlibs; format fixup
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.100 1992/11/16 22:35:55 jromine Exp jromine $
d259 1
a259 1
Options given directly to \fIld\fR\|(1) (via \fIcc\fR\0) at the beginning
d268 1
a268 1
Options given directly to \fIld\fR\|(1) (via \fIcc\fR\0) at the end of the
d345 1
a345 1
If \*(lqpop\*(rq (formerly \*(lqpopbboards:\ on\*(rq),
d347 1
a347 1
this setting requires \*(lqpop:\ on\*(rq.
d533 1
a533 1
(e.g., \*(lqldoptions:\ \-L/usr/mh/lib\*(rq)
d581 1
a581 1
This defaults to \*(lqchar\ *\*(rq.  Set this to \*(lqint\*(rq if
d727 1
a727 1
option and get an undefined symbol \*(lq\(ru\(ruruserpass\*(rq
d833 2
a834 2
Include this option if your system has the \fIvsprintf()\fP 
library routine; otherwise, \fI\(rudoprnt()\fP will be used.
d844 1
a844 1
returned by \fIlocaltime()\fP contains a \fItm_gmtoff\fP element
d884 1
a884 1
Makes \fIrepl\fR `\-nocc\ all' the default instead of `\-cc\ all'.
d918 1
a918 1
For example, FOLDPROT='\*(lq0700\*(rq'.
d924 1
a924 1
When using \*(lqrepl\ \-ccme\*(rq,
d932 2
a933 1
For example, LINK='\*(lq\\\\043\*(rq' to use the pound\-sign character.
d952 1
a952 1
as specified in RFC 1341 -- a major win.
d967 1
a967 1
under SUN40.  It uses the \fIflock\fP\|() system call for locking,
d974 1
a974 1
For example, MSGPROT='\*(lq0600\*(rq'.
d986 1
a986 1
without doing an open(); see mh-profile(5) for the details.
d997 1
a997 1
For example, SBACKUP='\*(lq\\\\043\*(rq'.
d1022 2
a1023 2
Third, the file \fB$HOME/.signature\fR is considered to contain 
a single line of text which is used as the \fIFull Name\fR part
d1031 1
a1031 1
Directs the \fIscan\fR program to generate UK-style dates.
d1043 1
a1043 1
Enable this option if you have local \fImh-format\fP files
d1048 1
a1048 1
remove it and re-{configure,generate,install} everything.
d1361 2
a1362 2
the administrator's guide,
and the user's manual,
@


2.100
log
@typo
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.99 1992/11/12 23:30:09 jromine Exp jromine $
d204 1
a204 1
The location of the \fIchown\fR\0(8) on your system.
d240 1
a240 1
Options given directly to \fIcc\fR\0(1).
d250 2
a251 2
This should be the loader option required to load the \fItermcap\fR\0(3)
and \fIcurses\fR\0(3) libraries on your system.
d257 1
a257 1
ldoptions: -s
d259 1
a259 1
Options given directly to \fIld\fR\0(1) (via \fIcc\fR\0) at the beginning
d268 1
a268 1
Options given directly to \fIld\fR\0(1) (via \fIcc\fR\0) at the end of the
d279 1
a279 1
lex: lex -nt
d294 1
a294 1
Support for systems with \fIranlib\fR\0(1).
d325 1
a325 1
\fImh\-tailor\fR\0(8) if you use this option.
d394 1
a394 1
\&`\-D' options to \fIcc\fR\0(1).
d420 1
a420 1
entries in the \fIpasswd\fR\0(5) file,
d533 1
a533 1
(e.g., \*(lqldoptions: -L/usr/mh/lib\*(rq)
d536 1
a536 1
You may need to run \fIldconfig\fP\0(8) manually whenever a new
d538 1
a538 1
See \fIld\fR\0(1) for more information about using shared libraries.
d540 7
d572 1
a572 1
parameter/return value of \fIsignal\fR\0(2).
d589 1
a589 1
\&`\-D' options to \fIcc\fR\0(1).
d639 1
a639 1
If \fIopenlog\fR\0(3) (see \*(lqman 3 syslog\*(rq)
d641 1
a641 1
and your \fIwrite\fR\0(1) command is set\-group\-id
d654 1
a654 1
Use this option if your \fIgetpwent\fR\0(3) routines read a 
d705 1
a705 1
Defines  the location of the \fImore\fR\0(1) program.
d779 1
a779 1
\*(lqldoptions -lresolv\*(rq to work around some NIS/DNS bugs.
d869 1
a869 1
\&`\-D' options to \fIcc\fR\0(1).
d959 1
a959 1
and \fImhn\fR\0(1).
@


2.99
log
@add TERMINFO
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.98 1992/11/12 22:48:35 jromine Exp jromine $
d430 1
a430 1
This code is still expiremental, but is available for 
@


2.98
log
@note advantages of MIME
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.97 1992/11/12 00:07:59 jromine Exp jromine $
d796 7
@


2.97
log
@change option indentation
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.96 1992/11/12 00:04:00 jromine Exp jromine $
d938 2
@


2.96
log
@not pitfalls of MSGID
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.95 1992/11/11 22:58:26 jromine Exp jromine $
d396 1
a396 1
.in +.5i
d492 1
a492 1
.in -.5i
d584 1
a584 1
.in +.5i
d835 1
a835 1
.in -.5i
d857 1
a857 1
.in +.5i
d1032 1
a1032 1
.in -.5i
@


2.95
log
@add slflags
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.94 1992/11/10 22:40:25 jromine Exp jromine $
d523 1
d858 1
d949 3
@


2.94
log
@note MPOP requires bboards: pop
add "signal: int", drop TYPESIG
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.93 1992/11/09 18:45:48 jromine Exp jromine $
d512 5
@


2.93
log
@document YEARMOD
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.92 1992/11/06 19:29:16 jromine Exp jromine $
d447 1
a447 1
This option is incompatible with \*(lqbboards: nntp\*(rq.
d500 1
a500 1
The \*(lqMPOP\*(rq option is incompatible with \*(lqbboards: nntp\*(rq.
d556 9
d761 1
a761 1
\*(lqoptions TYPESIG=void\*(rq.
a789 10

.ti -.5i
TYPESIG
.br
Defines the base type (int or void) of the functions
being parameter/return value of \fIsignal\fR\0(2).
The default is \fBint\fR.
Set TYPESIG='void' on systems which use this type
(e.g., SYSTEM 5 V3.0 and later or Sun OS 4.0 and later);
otherwise, set TYPESIG='int'.
@


2.92
log
@add AUX
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.91 1992/11/06 01:06:04 jromine Exp jromine $
d1011 12
@


2.91
log
@typos
no MTS-specific action with sendmail unless bboards or pop
put BERK in preferences list
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.90 1992/11/06 00:47:31 jromine Exp jromine $
d589 5
@


2.90
log
@major changes to put "options" into sections
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.89 1992/11/05 19:25:27 jromine Exp jromine $
d534 1
a534 1
.Uh "System Dependencies"
a590 9
BERK
.br
Optional for for 4.{2,3}BSD sites running SendMail.
Disables nearly all of the RFC822 address and header-parsing routines
in favor of recognizing such formats as ASCnet, and so on.
If you don't need to disable the parser for this reason,
you probably want to use \*(lqoptions DUMB\*(rq instead.

.ti -.5i
d868 9
d925 2
a926 1
Enables support for multi-media messages, as specified in RFC 1341.  
d937 1
a937 3
Enables \fBslocal\fP to detect and surpress duplicate
messages received.  It doesn't hurt to enable this option whether
or not you intend to make use of the duplicate surpression capability.
d942 1
a942 1
Defines the octal value for default folder-protection
d1022 1
a1022 1
and compile date included in \fIMH\fP execuatbles.  
d1057 1
a1057 8
.sp 1
To generate a \fItroff\fR version, type
.sp 1
.nf
% (cd ../doc/; make guide)
.fi
.sp 1
instead.
d1074 10
a1083 2
If you want \fISendMail\fR to transport messages for \fIMH\fR,
then go to the mts/sendmail/ directory.
d1232 1
a1232 1
then no futher MTS\-specific action is required on your part!
d1235 1
a1235 1
then no futher MTS\-specific action is required on your part!
@


2.89
log
@add "ln".
update "mailgroup" docs to mention slocal.
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.88 1992/11/05 17:20:40 jromine Exp jromine $
d4 1
a4 1
.TH MH-GEN 8 MH [mh.6]
a201 5
popdir: /usr/etc
.br
The directory where the POP daemon (\fBpopd\fP) will be installed.

.ti -.5i
a303 56
.Uh "Shared libraries"
.ti -.5i
sharedlib: off
.br
If \*(lqsun4\*(rq,
makes libmh.a into a SunOS 4.0 (and later) shared library.
If you enable this, be sure to also use \*(lqoptions SUN40\*(rq.

.ti -.5i
slibdir: /usr/local/lib
.br
The directory where the \fIMH\fP shared library should go.

.ti -.25i
Under SunOS (sun4)
.br
Since some \fIMH\fP programs are setuid, they'll only look for
the library in \*(lqtrusted\*(rq locations.  Putting the library
somewhere besides \fB/usr/lib\fP or \fB/usr/local/lib\fP is not advisable.

If you \fBmust\fP do this, be sure that you add the 
path given by \fBslibdir\fP to the compiler's library search list 
(e.g., \*(lqldoptions: -L/usr/mh/lib\*(rq)
and make sure the path starts with a leading `/'.

You may need to run \fIldconfig\fP\0(8) manually whenever a new
shared object is installed on the system.
See \fIld\fR\0(1) for more information about using shared libraries.

.Uh "Other system dependencies"
.ti -.5i
editor: prompter
.br
The default editor for \fIMH\fR.

.ti -.5i
mailgroup: off
.br
If set, \fIinc\fR is made set-group-id to this group name.
Some SYS5 systems want this to be set to \*(lqmail\*(rq.
Set this if your \fB/usr/spool/mail\fP is not world-writeable.

Note that \fBslocal\fP doesn't know how to deal with this,
and will not work under these systems; just making it set-group-id
will open a security hole.
If you're using \*(lqmailgroup\*(rq,
you should remove \fBslocal\fP (and its man page) from your system.

.ti -.5i
sprintf: char *
.br
The return value of the \fIsprintf\fR library routine.
This defaults to \*(lqchar\ *\*(rq.  Set this to \*(lqint\*(rq if
you have an older version of SYSTEM 5 which has this routine return an
\*(lqint\*(rq type.

d382 13
a394 5
you intend to use POP.)
Here is a brief summary of the options which are of interest when
POP is enabled.
Be sure to read the complete description of each option later in
this file.
d397 2
a398 2
.ti -.5i 
RPOP
d400 16
a415 4
The \*(lqRPOP\*(rq option
indicates that support for the UNIX variant of POP,
RPOP, which uses privileged sockets for authentication be enabled.
This peacefully co-exists with the standard POP.
d417 33
d452 8
a459 4
The \*(lqPOP2\*(rq option
indicates that the \fIMH\fP POP daemon should
speak the older POP2 protocol in addition to the \fIMH\fP POP3 protocol \-
a major win.
d464 14
a477 1
this defaults to \*(lqpop\*(rq, instead of \*(lqpop3\*(rq.
d479 1
a479 1
DPOP
d481 4
a484 4
The \*(lqDPOP\*(rq option
indicates that POP subscribers do not have
entries in the \fIpasswd\fR\0(5) file,
and instead have their own separate database (another win).
d486 1
a486 1
APOP
d488 4
a491 16
The \*(lqAPOP\*(rq option indicates that the POP daemon will
support the non-standard \fBAPOP\fP command.  This command
provides a challenge-based authentication system using
the \fBMD5\fP message digest algorithm.
.ti -.5i
MPOP
.br
The \*(lqMPOP\*(rq option indicates that the POP daemon will
support some non-standard extensions for \*(lqmobile pop\*(rq,
which are useful when using the POP over low-speed connections.
.\" .ti -.5i
.\" KPOP
.\" .br
.\" The \*(lqKPOP\*(rq option indicates that the POP daemon will
.\" support the KERBEROS \fBkpop\fP protocol.  This option is 
.\" incompatible with the standard POP.
d493 1
a493 1
.sp
a500 3
.sp
All of these options can be enabled via an \*(lqoptions\*(rq directive in the
\fIMH\fR configuration file.
d502 1
a502 1
.Uh "Testing/debugging"
d504 1
a504 1
debug: off
d506 6
a511 3
Support for debug mode of \fIMH\fR.
Don't use this unless you know what you're doing,
which isn't likely if you're reading this document!
d514 1
a514 1
regtest: off
d516 1
a516 4
Set this to \*(lqon\*(rq
if you are doing regression testing among different
compilations of \fIMH\fP, and you do not want the hostname
and compile date included in \fIMH\fP execuatbles.  
d518 2
a519 3
.Uh "Compiler Options"
.ti -.5i
options:
d521 18
a538 1
\&`\-D' options to \fIcc\fR\0(1).  If you don't know what an
d540 1
a541 6
.in +.5i
.\" .ti -.5i
.\" AIX
.\" .br
.\" Use on AIX.  Also use \*(lqoptions TYPESIG=void SYS5 SYS5DIR\*(rq.
.\" 
d543 1
a543 1
ALTOS
d545 3
a547 2
Use on XENIX/v7 systems.
Also, be sure to use \*(lqoptions V7\*(rq.
d549 6
d556 1
a556 1
APOP='\*(lq/etc/pop.auth\*(rq'
d558 4
a561 11
This option indicates that the POP daemon will
support the non-standard \fBAPOP\fP command.  This
command provides a challenge-based authentication system using
the \fBMD5\fP message digest algorithm.
This facility is documented in 
\fIThe Internet Message\fR (ISBN 0\-13\-092941\-7), a book by Marshall T. Rose.
The \fBpopauth\fP program is also installed, which
allows the administrator to manipulate the \fBAPOP\fP
authorization database.
For more details, see \fBsupport/pop/pop-more.txt\fR
and the \fIAdministrator's Guide\fP.
d563 1
d565 1
a565 1
ATHENA
d567 8
a574 2
Makes \fIrepl\fR `\-nocc\ all' the default instead of `\-cc\ all'.
You may want to enable this if you're using \fIxmh\fR.
a590 13
ATZ
.br
Directs \fIMH\fR to use alpha\-timezones whenever possible.
You should not use this option if you are on the Internet,
since it will make your host non-compliant with RFC-1123
(Requirements for Internet Hosts).

.ti -.5i
BANG
.br
Directs \fIMH\fR to favor `!' over `@@' in addressing.

.ti -.5i
a626 5
.\" .ti -.5i
.\" BSD44
.\" .br
.\" Use on Berkeley UNIX systems on or after 4.4BSD.

d628 1
a628 1
COMPAT
d630 2
a631 3
If you previously ran a version of \fIMH\fR earlier than mh.4 use this option.
After a short grace period,
remove it and re-{configure,generate,install} everything.
a647 11
DPOP
.br
Enables the POP database, useful only if POP service is enabled.

.ti -.5i
DUMB
.br
Directs \fIMH\fR not to try and rewrite addresses to their 
\*(lqofficial\*(rq form.

.ti -.5i
d663 1
a663 1
FOLDPROT
d665 2
a666 3
Defines the octal value for default folder-protection.
For example, FOLDPROT='\*(lq0700\*(rq'.
The default is \*(lq0711\*(rq.
a667 6
.\" .ti -.5i
.\" HESIOD
.\" .br
.\" Support for HESIOD.  
.\" This code was contributed, and included no documentation.

a668 23
ISI
.br
When using \*(lqrepl\ \-ccme\*(rq,
only \*(lqcc:\*(rq the first address found which belongs to the user;
any other \fIAlternate-Mailboxes\fR do not receive \*(lqcc:\*(rqs.

.\" .ti -.5i
.\" KPOP
.\" .br
.\" Support for KERBEROS with POP.
.\" This code builds
.\" \fIpopd\fP, \fIinc\fP and \fImsgchk\fP to support only the 
.\" \*(lqkpop\*(rq protocol.
.\" This code was contributed, and included no documentation.

.ti -.5i
LINK
.br
Defines the filename for alternate file name for \fIdist\fR and \fIrepl\fR.
For example, LINK='\*(lq\\\\043\*(rq' to use the pound\-sign character.
The default is \*(lq@@\*(rq.

.ti -.5i
d679 1
a679 1
Hard\-wires the local name for the host \fIMH\fR is running on.
a684 23
MHE
.br
Enables crude support for Brien Reid's MHE interface.
Recommended for use with the GNU Emacs mh-e package.

.ti -.5i
MHRC
.br
Enables \fIMH\fR to recognize the \fICShell\fR's `~'\-construct.
This is useful for sites that run with a ~/.mhrc for their users.

.ti -.5i
MIME
.br
Enables support for multi-media messages, as specified in RFC 1341.  
Several \fIMH\fP commands are extended to support these multi-media
messages,
and the \fImhn\fR command is provided to encode and decode
\fBMIME\fP messages.
For more details, see \fBmiscellany/multi-media/READ-ME\fP
and \fImhn\fR\0(1).

.ti -.5i
d688 1
a688 1
For example, on ALTOS and DUAL systems,
a692 29
MPOP
.br
This option indicates that the POP daemon will
support the non-standard
\fBXTND SCAN\fP command which provides performance
enhancements when using the POP over low-speed connections.
This option also causes an interactive POP
client program, \fBpopi\fP, to be compiled and installed.
A man page for the \fBpopi\fP program is also provided.
These extensions are described in 
\fIThe Internet Message\fR, a book by Marshall T. Rose.
For more details, see \fBsupport/pop/pop-more.txt\fR.
This option is incompatible with \*(lqbboards: nntp\*(rq.

.ti -.5i
MSGID
.br
Enables \fBslocal\fP to detect and surpress duplicate
messages received.  It doesn't hurt to enable this option whether
or not you intend to make use of the duplicate surpression capability.

.ti -.5i
MSGPROT
.br
Defines the octal value for default folder-protection
For example, MSGPROT='\*(lq0600\*(rq'.
The default is \*(lq0644\*(rq.

.ti -.5i
d701 1
a718 5
NOMHSEQ
.br
Directs \fIMH\fR to make private sequences the default.

.ti -.5i
a728 33
OVERHEAD
.br
Enable \fIMH\fR commands to read profile/context from open fd:s
without doing an open(); see mh-profile(5) for the details.

.ti -.5i
POP2
.br
Have the POP daemon understand the older
POP2 protocol as well as the \fIMH\fP POP3 protocol \- a major win.
The POP daemon auto-magically
determines which POP protocol your client is using.
If you're enabling POP service,
there's no reason not to enable this option as well.
See also \fIPOPSERVICE\fR.

.ti -.5i
POPSERVICE
.br
The port name the \fIMH\fP POP will use.  For historical reasons,
this defaults to \*(lqpop\*(rq.
In 1987, the \fIMH\fP POP protocol
(POP version 3) was published as RFC1081 and
was assigned its own port number (110),
which differs from the original POP (version 1 and 2) port number (109).
To have \fIMH\fP POP use the new assigned port number, 
set POPSERVICE='\*(lqpop3\*(rq', and be sure that this service
name is listed in your \fB/etc/services\fP file on both POP client
and server hosts as \*(lq110/tcp\*(rq.
If you enable \fIPOP2\fP, you can safely leave this undefined unless
you are using POP3 clients besides \fIMH\fP.

.ti -.5i
a734 17
RPATHS
.br
Directs \fIinc\fR to note UNIX \*(lqFrom\ \*(rq lines as Return-Path: info.

.ti -.5i
RPOP
.br
Enables the RPOP variant of POP, useful only if POP service is enabled.

.ti -.5i
SBACKUP
.br
Defines the prefix string for backup file names.
For example, SBACKUP='\*(lq\\\\043\*(rq'.
The default is \*(lq,\*(rq.

.ti -.5i
a743 8
SHADOW
.br
Indicates that the encrypted passwords can be found in the
\fB/etc/shadow\fR file (and not in the \fB/etc/passwd\fR file).
This option is used only by the \fBpopd\fP POP server. 
It should be used only for some (newer) SYSTEM 5 systems.

.ti -.5i
d760 1
a786 15
TMA
.br
Support for the TTI \fItrusted mail agent\fR (TMA).
Although the TTI TMA is \fBnot\fR in the public domain,
the \fIMH\fR support for the TTI TMA \fBis\fR in the public domain.
You should enable this option only if you are licensed to run the TMA
software
(otherwise, you don't have the software in your \fIMH\fR source tree).

.ti -.5i
TTYD
.br
Support for TTYD.  This is no longer in wide use, and is not recommended.

.ti -.5i
d793 2
a794 1
(e.g., SYSTEM 5 V3.0 and later or Sun OS 4.0 and later).
a803 18
UCI
.br
First, \*(lq_\*(rq and \*(lq#\*(rq are recognized as the prefixes for
scratch files.
Second, support for the UCI group\-leadership mechanism is enabled in
\fIconflict\fR.
Third, the file \fB$HOME/.signature\fR is considered to contain 
a single line of text which is used as the \fIFull Name\fR part
of your \*(lqFrom:\*(rq header.
This may conflict with the interpretation of this file by \fINews\fR.
If you're not at UCI, you probably don't want this option.

.ti -.5i
UK
.br
Directs the \fIscan\fR program to generate UK-style dates.

.ti -.5i
a820 4
.ti -.5i
WHATNOW
.br
Enable certain \fIMH\fR commands to act differently when $mhdraft set.
d836 190
@


2.88
log
@document "popdir" and VSPRINTF
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.87 1992/11/02 19:01:33 jromine Exp jromine $
d222 8
d234 1
a234 1
To remove the old files instead, use \*(lqrm\0\-f\*(rq.
d350 1
d352 4
a355 1
and will not work under these systems.
@


2.87
log
@drop AIX in favor of _AIX
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.86 1992/11/02 19:01:00 jromine Exp jromine $
d202 5
d219 1
a219 1
(Some sites use \*(lqcp -p\*(rq.)
d224 3
a226 1
How \fIMH\fR should backup existing files when installing a new file.
d995 6
@


2.86
log
@note SHADOW only affects popd
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.85 1992/11/02 18:39:35 jromine Exp jromine $
d513 5
a517 5
.ti -.5i
AIX
.br
Use on AIX.  Also use \*(lqoptions TYPESIG=void SYS5 SYS5DIR\*(rq.

@


2.85
log
@add some notes about "oldload none"
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.84 1992/11/02 17:10:51 jromine Exp jromine $
d883 2
a884 1
This option should only be used for some (newer) SYSTEM 5 systems.
@


2.84
log
@elaborate on "mailgroup" description
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.83 1992/10/31 06:24:13 jromine Exp jromine $
d276 2
d924 2
@


2.83
log
@drop mention of SunOS 3.5 -lresolv bugs
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.82 1992/10/31 06:20:55 jromine Exp jromine $
d332 3
@


2.82
log
@note bugs in SunOS NIS/DNS lookup code (and give work-around)
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.81 1992/10/29 22:20:55 jromine Exp jromine $
a574 9

If you're running SunOS 3.5 and using their brain-damaged approach
to offering Domain Name Service through NIS,
you're going to have to enable \*(lqoptions BERK\*(rq to
prevent \fIMH \fP from trying to resolve hostnames.  
This is because the Sun NIS/DNS interface is broken when
resolving hosts which have no \*(lqA\*(rq resource records.
You could use the \fBlibresolv.a\fP libarary to work around the NIS
problems, but it's also broken under SunOS 3.5.  Sorry.
@


2.81
log
@describe how to put slibdir somewhere besides /usr/local/lib
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.80 1992/10/29 17:44:55 jromine Exp jromine $
d576 9
d900 1
a900 1
Use on Sun OS 4.0 (and later?) systems.  You probably also want
d903 4
@


2.80
log
@add subheading for options:
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.79 1992/10/29 17:39:14 jromine Exp jromine $
d298 1
a298 1
If you enable this, be sure to use \*(lqoptions SUN40\*(rq.
d305 3
d311 6
@


2.79
log
@add AIX
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.78 1992/10/27 21:44:44 jromine Exp jromine $
d491 1
@


2.78
log
@fixup
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.77 1992/10/27 18:11:52 jromine Exp jromine $
d498 5
@


2.77
log
@document NNTP/MPOP incompatibility
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.76 1992/10/27 17:41:40 jromine Exp jromine $
d954 1
@


2.76
log
@move stuff into subsections
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.75 1992/10/27 17:00:27 jromine Exp jromine $
d469 2
a470 1
These two options peacefully co-exist with the standard POP.
d737 1
@


2.75
log
@RENAME, UNISTD
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.74 1992/10/26 16:54:14 jromine Exp jromine $
d68 1
a68 1
ics.uci.edu [128.195.1.1] and retrieve the file pub/mh/mh-6.7.tar.Z.
d78 1
a78 1
either ics.uci.edu or louie.udel.edu.
d94 4
a97 5
Computing Support Group 
Attn: MH distribution
Department of Information and Computer Science
University of California, Irvine
Irvine, CA  92717
d99 1
a99 1
714/856-7554
d156 6
d163 1
a163 1
bbdelivery: off
d165 1
a165 14
If \*(lqoff\*(rq,
the BBoards delivery agent and library files will not be installed.
If 
\*(lqon\*(rq,
and you set \*(lqbboards:\*(rq to something besides \*(lqoff\*(rq,
then 
the BBoards delivery agent and library files will be installed
in the \fIbbhome\fR directory (see below).
To read remote BBoards,
the usual configuration would have \fIbbc\fR talk to a \fIPOP3\fR or
\fINNTP\fR server.
However, it may be useful to set this to \*(lqoff\*(rq if 
you NFS mount the \fIbbhome\fR directory from another host
and want to use \fIbbc\fR to read those files directly.
d168 1
a168 1
bboards: off
d170 1
a170 9
If \*(lqon\*(rq, include support for the UCI BBoards facility.
BBoards may be enabled with any mts setting.
If \*(lqoff\*(rq, the BBoard reading program \fIbbc\fR will not be installed.
If \*(lqnntp\*(rq,
include support for the UCI BBoards facility to read the Network News
via the NNTP.
If \*(lqpop\*(rq (formerly \*(lqpopbboards:\ on\*(rq),
include support for the UCI BBoards facility via the POP3 service;
this setting requires \*(lqpop:\ on\*(rq.
d173 1
a173 1
bbhome: /usr/spool/bboards
d175 5
a179 1
The home directory for the BBoards user.
d182 1
a182 1
bin: /usr/local
d184 1
a184 1
The directory where user\-invoked programs go (see manual section 1).
d187 1
a187 1
cc:
d189 11
a199 1
The name of your C compiler, if not \*(lqcc\*(rq.
a201 10
ccoptions: \-O
.br
Options given directly to \fIcc\fR\0(1).
The most common is \*(lq\-M\*(rq if you're running \fIMH\fR on an ALTOS.
This defaults to \*(lq\-O\*(rq.  If you define this and want to 
keep \*(lq\-O\*(rq, be sure to include it explicitly.
If you're using the \fIGNU\fP C compiler, it should
include `\-traditional'.  See \*(lqoptions:\*(rq for `\-D' options.

.ti -.5i
d211 1
a211 1
cp:
d217 1
a217 1
curses: \-lcurses\0\-ltermlib
d219 1
a219 5
This should be the loader option required to load the \fItermcap\fR\0(3)
and \fIcurses\fR\0(3) libraries on your system.
On SYS5 systems, it probably should be just \*(lq\-lcurses\*(rq.
Some sites have reported that both \*(lq\-lcurses\*(rq and
\*(lq\-ltermlib\*(rq are necessary.
d221 1
d223 1
a223 1
debug: off
d225 1
a225 3
Support for debug mode of \fIMH\fR.
Don't use this unless you know what you're doing,
which isn't likely if you're reading this document!
d228 1
a228 1
editor: prompter
d230 6
a235 1
The default editor for \fIMH\fR.
d238 1
a238 1
etc: /usr/local/lib/mh
d240 5
a244 1
The directory where pgm\-invoked programs go (see manual section 8).
d247 1
a247 1
ldoptions:
d274 1
a274 1
mail: /usr/spool/mail
d276 2
a277 5
The directory where the maildrops are stored.
If this pathname is absolute (i.e., begins with a \fB/\fR\0),
then the user's maildrop is a file called \fB$USER\fR in this directory.
If the pathname is not absolute,
then the user's maildrop is in the user's home directory under the given name.
d280 39
d325 1
a325 1
mandir: /usr/man
d327 4
a330 1
The parent directory of the manual entries.
d332 1
a333 15
manuals: standard
.br
Where manual entries should be installed,
relative to the directory given with \*(lqmandir\*(rq.
Either \*(lqlocal\*(rq to install manual entries under \fBmanl/\fR,
or \*(lqnew\*(rq to install manual entries under \fBmann/\fR,
or \*(lqold\*(rq to install manual entries under \fBmano/\fR,
or \*(lqstandard\*(rq to install manual entries under \fBman?/\fR,
or \*(lqgen\*(rq to generate but not install them,
or \*(lqnone\*(rq to neither generate nor install them.
For example,
to install manual entries under \fB/usr/man/u_man/man?\fR,
use \*(lqstandard\*(rq and \fB/usr/man/u_man\fR for \*(lqmandir\*(rq.

.ti -.5i
d363 1
d365 1
a365 1
oldload: off
d367 9
a375 2
Support for the ALTOS loader if \*(lqon\*(rq.
Support for loaders not handling `\-x\0\-r' correctly if \*(lqnone\*(rq.
d378 24
d474 1
d476 1
a476 1
ranlib: on
d478 3
a480 9
Support for systems with \fIranlib\fR\0(1).
For SYSTEM 5 systems,
this should be \*(lqoff\*(rq which tells \fIMH\fR to use \fIlorder\fR and
\fItsort\fR instead.
Some SYSTEM 5 sites reported that running this isn't always sufficient.
If this is the case,
then you should edit \fBconf/makefiles/uip\fR to include
\fB\&../sbr/libmh.a\fR and \fB../zotnet/libzot.a\fR twice in the LIBES
variable.
a490 32
remove: mv \-f
.br
How \fIMH\fR should backup existing files when installing a new file.

.ti -.5i
sharedlib: off
.br
Makes libmh.a into a shared library (only for SunOS 4.0 and later).  
If you enable this, be sure to use \*(lqoptions SUN40\*(rq.

.ti -.5i
slibdir: /usr/local/lib
.br
The directory where the \fIMH\fP shared library should go.

Since some \fIMH\fP programs are setuid, they'll only look for
the library in \*(lqtrusted\*(rq locations.  Putting the library
somewhere besides \fB/usr/lib\fP or \fB/usr/local/lib\fP is not advisable.

You may need to run \fIldconfig\fP\0(8) manually whenever a new
shared object is installed on the system.
See \fIld\fR\0(1) for more information about using shared libraries.

.ti -.5i
sprintf: char *
.br
The return value of the \fIsprintf\fR library routine.
This defaults to \*(lqchar\ *\*(rq.  Set this to \*(lqint\*(rq if
you have an older version of SYSTEM 5 which has this routine return an
\*(lqint\*(rq type.

.ti -.5i
d588 5
d757 1
a757 1
Otherwise, \fIMH\fR will try \fB<ndir.h>\fR.
@


2.74
log
@document MSGID
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.73 1992/10/26 16:29:56 jromine Exp jromine $
d808 6
d930 5
@


2.73
log
@give ISBN of The Internet Message
mention POPSERVICE in pop options summary
sprintf: char * (default)
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.72 1992/10/20 22:50:50 jromine Exp jromine $
d719 7
@


2.72
log
@DBM->DBMPWD (conflict with ndbm.h)
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.71 1992/10/19 21:57:08 jromine Exp jromine $
d362 4
a365 1
If POP is enabled, there are several options which are of interest:
d383 5
d417 2
a418 1
\fIThe Internet Message\fR, a book by Marshall T. Rose.
d420 1
a420 1
These options co-exist with the standard POP.
d450 1
d471 1
a471 1
sprintf: int
d499 1
a499 1
\fIThe Internet Message\fR, a book by Marshall T. Rose.
@


2.71
log
@typo
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.70 1992/10/19 21:56:21 jromine Exp jromine $
d574 1
a574 1
DBM
d579 1
a579 1
Without DBM the entire passwd file is read into
@


2.70
log
@document APOP database
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.69 1992/10/19 21:48:20 jromine Exp jromine $
a493 1
and the \fIAdministrator's Guide\fP.
@


2.69
log
@re-order directives alphabetically
include MPOP, APOP, etc. options
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.68 1992/10/19 20:29:19 jromine Exp jromine $
d482 1
a482 1
APOP
d490 6
a495 1
For more details, see \fBsupport/pop/pop-more.txt\fR.
a681 1
For more details, see support/
d686 2
a687 1
For more details, see \fBmiscellany/multi-media/READ-ME\fP.
@


2.68
log
@explain zoneinfo
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.67 1992/05/12 21:05:04 jromine Exp jromine $
d140 1
d146 9
a154 1
Here are the \fIMH\fP configuration options available:
d156 1
d158 36
d199 39
d245 5
d255 27
a316 19
chown: /etc/chown
.br
The location of the \fIchown\fR\0(8) on your system.
If \fIchown\fR is in your search path,
just use the value of \*(lqchown\*(rq.
On SYS5 systems,
this should probably be \*(lq/bin/chown\*(rq.

.ti -.5i
editor: prompter
.br
The default editor for \fIMH\fR.

.ti -.5i
remove: mv \-f
.br
How \fIMH\fR should backup existing files when installing a new file.

.ti -.5i
a338 36
bboards: off
.br
If \*(lqon\*(rq, include support for the UCI BBoards facility.
BBoards may be enabled with any mts setting.
If \*(lqoff\*(rq, the BBoard reading program \fIbbc\fR will not be installed.
If \*(lqnntp\*(rq,
include support for the UCI BBoards facility to read the Network News
via the NNTP.
If \*(lqpop\*(rq (formerly \*(lqpopbboards:\ on\*(rq),
include support for the UCI BBoards facility via the POP3 service;
this setting requires \*(lqpop:\ on\*(rq.

.ti -.5i
bbdelivery: off
.br
If \*(lqoff\*(rq,
the BBoards delivery agent and library files will not be installed.
If 
\*(lqon\*(rq,
and you set \*(lqbboards:\*(rq to something besides \*(lqoff\*(rq,
then 
the BBoards delivery agent and library files will be installed
in the \fIbbhome\fR directory (see below).
To read remote BBoards,
the usual configuration would have \fIbbc\fR talk to a \fIPOP3\fR or
\fINNTP\fR server.
However, it may be useful to set this to \*(lqoff\*(rq if 
you NFS mount the \fIbbhome\fR directory from another host
and want to use \fIbbc\fR to read those files directly.

.ti -.5i
bbhome: /usr/spool/bboards
.br
The home directory for the BBoards user.

.ti -.5i
d347 6
d362 8
a369 3
If POP is enabled, there are three additional options which are of interest:
\*(lqRPOP\*(rq, \*(lqDPOP\*(rq and \*(lqPOP2\*(rq.
The first indicates that support for the UNIX variant of POP,
d371 6
a376 5
This peacefully co\-exists with the standard POP.
The \*(lqDPOP\*(rq option indicates that POP subscribers do not have
entries in the \fIpasswd\fR\0(5) file,
and instead have their own separate database (another major win).
The \*(lqPOP2\*(rq option indicates that the \fIMH\fP POP daemon should
d379 34
d417 1
a417 1
kpop: off
d419 9
a427 5
Support for KERBEROS with POP.
This code appears to build
\fIpopd\fP, \fIinc\fP and \fImsgchk\fP to support only the 
\*(lqkpop\*(rq protocol.
This code was contributed, and included no documentation.
d430 1
a430 1
hesiod: off
d432 4
a435 2
Support for HESIOD.  
This code was contributed, and included no documentation.
d438 31
d482 11
d616 6
d629 9
d674 11
d693 14
d856 10
a927 121

.ti -.5i
cp:
.br
The command to copy files when installing, if not \*(lqcp\*(rq.
(Some sites use \*(lqcp -p\*(rq.)

.ti -.5i
cc:
.br
The name of your C compiler, if not \*(lqcc\*(rq.

.ti -.5i
ccoptions: \-O
.br
Options given directly to \fIcc\fR\0(1).
The most common is \*(lq\-M\*(rq if you're running \fIMH\fR on an ALTOS.
This defaults to \*(lq\-O\*(rq.  If you define this and want to 
keep \*(lq\-O\*(rq, be sure to include it explicitly.
If you're using the \fIGNU\fP C compiler, it should
include `\-traditional'.

.ti -.5i
curses: \-lcurses\0\-ltermlib
.br
This should be the loader option required to load the \fItermcap\fR\0(3)
and \fIcurses\fR\0(3) libraries on your system.
On SYS5 systems, it probably should be just \*(lq\-lcurses\*(rq.
Some sites have reported that both \*(lq\-lcurses\*(rq and
\*(lq\-ltermlib\*(rq are necessary.

.ti -.5i
ldoptions:
.br
Options given directly to \fIld\fR\0(1) (via \fIcc\fR\0) at the beginning
of the command line.
Useful for machines which require arguments to tell \fIld\fR to increase the
stack space (e.g. the Gould, which uses \*(lq\-m\08\*(rq).
Usually, \*(lq\-s\*(rq is a good choice in any event.

.ti -.5i
ldoptlibs:
.br
Options given directly to \fIld\fR\0(1) (via \fIcc\fR\0) at the end of the
command line.
The two most common are:
\*(lq\-ldbm\*(rq if you're running MMDF with the \fIdbm\fR package;
and, \*(lq\-lndir\*(rq if you are generating \fIMH\fR on a system
which does not load the new directory access mechanism by default
(e.g., 4.1BSD, SYS5).
If you don't have \fIlibndir\fR on your system,
the sources are in \fBmiscellany/libndir/\fR.

.ti -.5i
lex: lex -nt
.br
Alternative version of \fIlex\fR.  Used in \fBzotnet/tws/\fR.

.ti -.5i
sprintf: int
.br
The return value of the \fIsprintf\fR library routine.
This defaults to \*(lqchar\ *\*(rq.  Set this to \*(lqint\*(rq if
you have an older version of SYSTEM 5 which has this routine return an
\*(lqint\*(rq type.

.ti -.5i
sharedlib: off
.br
Makes libmh.a into a shared library (only for SunOS 4.0 and later).  
If you enable this, be sure to use \*(lqoptions SUN40\*(rq.

.ti -.5i
slibdir: /usr/local/lib
.br
The directory where the \fIMH\fP shared library should go.

Since some \fIMH\fP programs are setuid, they'll only look for
the library in \*(lqtrusted\*(rq locations.  Putting the library
somewhere besides \fB/usr/lib\fP or \fB/usr/local/lib\fP is not advisable.

You may need to run \fIldconfig\fP\0(8) manually whenever a new
shared object is installed on the system.
See \fIld\fR\0(1) for more information about using shared libraries.

.ti -.5i
oldload: off
.br
Support for the ALTOS loader if \*(lqon\*(rq.
Support for loaders not handling `\-x\0\-r' correctly if \*(lqnone\*(rq.

.ti -.5i
ranlib: on
.br
Support for systems with \fIranlib\fR\0(1).
For SYSTEM 5 systems,
this should be \*(lqoff\*(rq which tells \fIMH\fR to use \fIlorder\fR and
\fItsort\fR instead.
Some SYSTEM 5 sites reported that running this isn't always sufficient.
If this is the case,
then you should edit \fBconf/makefiles/uip\fR to include
\fB\&../sbr/libmh.a\fR and \fB../zotnet/libzot.a\fR twice in the LIBES
variable.

.ti -.5i
tma: off
.br
Support for the TTI \fItrusted mail agent\fR (TMA).
Although the TTI TMA is \fBnot\fR in the public domain,
the \fIMH\fR support for the TTI TMA \fBis\fR in the public domain.
You should enable this option only if you are licensed to run the TMA
software
(otherwise, you don't have the software in your \fIMH\fR source tree).

.ti -.5i
regtest: off
.br
Set this to \*(lqon\*(rq
if you are doing regression testing among different
compilations of \fIMH\fP, and you do not want the hostname
and compile date included in \fIMH\fP execuatbles.  
@


2.67
log
@delete SUN41
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.66 1992/05/12 21:04:45 jromine Exp jromine $
d360 3
d713 5
a717 1
information /etc/zoneinfo or /usr/lib/zoneinfo (SunOS).
@


2.66
log
@document making admin manual before installing software
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.65 1992/02/12 21:36:21 jromine Exp jromine $
a631 8
\*(lqoptions BSD42\*(rq, \*(lqoptions BSD43\*(rq, and
\*(lqoptions TYPESIG=void\*(rq.

.ti -.5i
SUN41
.br
Use on Sun OS 4.1 (and later?) systems.  You also want
\*(lqoptions SUN40\*(rq,
@


2.65
log
@GNU -traditional
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.64 1992/02/12 21:35:05 jromine Exp jromine $
d12 2
a13 1
Guide before you install \fIMH\fP.
d117 3
a119 4
Become the super-user and create a new directory under /usr/src/local/
(or whatever) for the \fIMH\fR area.
Traditionally, the directory's name should be mh/.
The distribution tape contains the hierarchy for the mh.6/ directory.
d123 1
a123 2
# mkdir /usr/src/local/mh
% cd /usr/src/local/mh
d125 1
d658 7
d869 26
d1056 1
a1056 1
Go to the mh.6/ directory and generate the system.
a1071 21
\fBBefore proceeding\fP,
you should familiarize yourself with the \fIAdministrator's Guide\fR.
To generate an \fInroff\fR version, go to the doc/ directory
and type:
.sp 1
.nf
% (cd doc/; make ADMIN.doc)
.fi
.sp 1
To generate a \fItroff\fR version, type
.sp 1
.nf
% (cd doc/; make guide)
.fi
.sp 1
instead.
.PP
If you're already running \fIMH\fR at your site,
you should also read the \fImh.6\fR changes documents.
The sources are in \fBpapers/mh6.5/\fR and \fBpapers/mh6.7/\fP.
.PP
d1115 1
a1115 1
files will not be installed over existing copies;
d1152 4
@


2.64
log
@try to document KERBEROS
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.63 1992/02/11 05:08:34 jromine Exp jromine $
d735 2
@


2.63
log
@document LOCKF, FLOCK, FCNTL
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.62 1992/02/06 16:48:48 jromine Exp $
d311 5
a315 2
Support for KERBEROS with POP.  This code was contributed, 
but there was no documentation made available.
d320 2
a321 2
Support for HESIOD.  This code was contributed, 
but there was no documentation made available.
@


2.62
log
@document comment syntax
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.61 1992/02/06 00:25:07 jromine Exp jromine $
d433 15
d471 4
a474 3
Directs \fIMH\fP to use the \fBlockf()\fP system call for UNIX-style
locking instead of \fBflock()\fP.  If you're using NFS to read or
write maildrops, you should enable this option.
@


2.61
log
@make NFS and SENDMAILBUG more explicit
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.60 1992/02/05 22:18:48 jromine Exp jromine $
d143 1
@


2.60
log
@add zmailer support
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.59 1992/02/05 21:52:46 jromine Exp jromine $
d509 3
a511 1
\fIMH\fP, you need this option.
d589 2
a590 1
Enable this if you know that your SendMail will
@


2.59
log
@add "regtest: on/off" to not include hostname and date
in version.c
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.58 1992/01/31 23:09:59 jromine Exp jromine $
d224 1
@


2.58
log
@drop WP
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.57 1992/01/31 22:55:36 jromine Exp jromine $
d803 9
@


2.57
log
@mention kpop/hesiod options
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.56 1992/01/31 22:47:36 jromine Exp jromine $
a676 6

.ti -.5i
WP
.br
Enables the White Pages service.
Contact wpp-manager@@psi.com for more information.
@


2.56
log
@add "cp" option
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.55 1992/01/30 16:41:35 jromine Exp jromine $
d305 12
@


2.55
log
@ATTVIBUG
SUN41
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.54 1991/01/24 08:27:50 mh Exp jromine $
d686 6
@


2.54
log
@mention undefined _index _rindex
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.53 91/01/23 14:54:18 mh Exp Locker: mh $
d326 14
d600 1
a600 1
SUNVIBUG
d602 4
a605 10
This option causes
\fIMH\fP to return to the \*(lqWhat now?\*(rq
prompt if your initial editor is \fBvi\fP
and it exits with non-zero status.
Use on Sun OS 4.1 and other systems where the
\fB/usr/ucb/vi\fP editor was changed to
exit with its status equal to the number of pseudo-\*(lqerrors\*(rq
encountered during the edit.  This causes a problem for programs that
test the exit status of their editor and abort if the status is non-zero.
(This includes \fIMH\fP and programs like \fB/usr/etc/vipw\fP).
d633 1
a633 1
(e.g., SYSTEM 5 V3.0 and later or Sun OS 4.0).
@


2.53
log
@add SUNVIBUG
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.52 91/01/23 14:44:18 mh Exp Locker: mh $
d797 4
a800 2
Now install the configured files into the source areas.  (On SYSTEM 5
systems you may need to use \*(lqmake sys5\*(rq to compile mhconfig.)
@


2.52
log
@add LOCKF docs
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.51 90/12/18 13:55:54 mh Exp Locker: mh $
d584 14
@


2.51
log
@sharedlibs
jlr
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.50 90/11/21 09:27:52 mh Exp Locker: mh $
d424 7
@


2.50
log
@document servers: a little better
jlr
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.49 90/11/16 14:55:57 mh Exp Locker: mh $
d235 2
a236 2
Guide\fR; be sure to set \*(lqservers:\*(rq as described in mh\-tailor(8) 
if you use this option.
d724 7
a730 2
The directory where the MH shared library should go.
You'll need to manually run \fIldconfig\fP\0(8) whenever a new
d732 1
a732 8

If you want to
put it somewhere other than \fB/usr/lib\fP or \fB/usr/local/lib\fP
(not advisable), you'll probably have to run \fIldconfig\fR\0(8) on
that directory, or
alter the environment variable \fBLD_LIBRARY_PATH\fP for each
user wishing to use the MH system (this is messy). See
\fIld\fR\0(1) for more information about how to do this.
@


2.49
log
@document POP2 option
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.48 90/04/09 13:27:27 sources Exp Locker: mh $
d225 1
d231 1
a231 4
The \*(lq/smtp\*(rq suffix is described in detail in the \fIAdministrator's
Guide\fR.
Hence,
for TCP/IP UNIX systems,
d234 3
@


2.48
log
@ZONEINFO
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.47 90/04/09 10:01:42 sources Exp Locker: sources $
d247 1
a247 1
include support for the UCI BBoards facility via the POP service;
d262 1
a262 1
the usual configuration would have \fIbbc\fR talk to a \fIPOP\fR or
d291 3
a293 3
If POP is enabled, there are two additional options which are of interest:
\*(lqRPOP\*(rq and \*(lqDPOP\*(rq.
The former indicates that support for the UNIX variant of POP,
d299 4
a302 1
Both of these options can be enabled via an \*(lqoptions\*(rq directive in the
d504 11
d518 5
a522 3
this defaults to \*(lqpop\*(rq.  The \fIMH\fP POP protocol
(POP version 3) has finally been assigned its own port number (110),
which differs from the original POP (version 1) port number (109).
d527 2
@


2.47
log
@POPSERVICE
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.46 90/04/08 19:35:27 sources Exp Locker: sources $
d592 1
a592 1
asked for alpha\-timezones (see the ATZ option).
d628 9
@


2.46
log
@*** empty log message ***
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.45 90/04/07 23:34:23 sources Exp Locker: sources $
d499 12
@


2.45
log
@minor cleanup.  don't justify with nroff
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.44 90/04/06 10:59:28 sources Exp Locker: sources $
d106 2
a107 1
format).  I'm working on getting Postscript versions of the documents.
@


2.44
log
@*** empty log message ***
@
text
@d1 3
a3 1
.\" @@(#)$Id: mh-gen.8,v 2.43 90/04/06 10:51:39 sources Exp Locker: sources $
d62 2
a63 2
Since you probably already have MH, you may not need to read this
unless you suspect you have an old version.
d79 3
a81 2
2.  You can send $75 US to the address below.  This covers the cost
of a magtape, handling, and shipping.  In addition, you'll get a
d83 2
a84 2
sure to include your USPS address with your check.  Checks should
be made payable to:
d89 1
a89 1
and must be drawn on U.S.  funds.  The distribution address is:  
d469 2
d543 2
a544 1
\*(lqoptions\ BSD42\*(rq and \*(lqoptions\ BSD43\*(rq.
a546 9
SUN41
.br
For Sun OS 4.1 this defines
\fIsprintf\fR as returning type \fIchar\ *\fR.
No \fIMH\fR program ever uses \fIsprintf\fR\|'s return value, but this
define prevents some compiler warnings.
Be sure to enable \*(lqoptions\ SUN40\*(rq too.

.ti -.5i
d549 1
a549 1
Use on AT&T SYSTEM 5 R3 (and newer?) UNIX system.  See also \fImailgroup\fR.
d554 2
a555 1
Define this if your system uses struct dirent instead of struct direct.
d677 1
a677 1
Makes libmh.a into a shared library (for SunOS 4.0).  
@


2.43
log
@*** empty log message ***
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.42 90/04/06 10:46:18 sources Exp Locker: sources $
d9 2
a10 2
also want to familiarize yourself with the \fBMH\fP Administrator's
Guide before you install \fBMH\fP.
d55 2
a56 2
discussing code changes to \fBMH\fP.  \fBMH-Users\fP is for general
discussion about how to use \fBMH\fP.
d60 1
a60 1
Since you probably alread have MH, you may not need to read this
d67 2
a68 2
(approx 1.5MB).  There should also be a \fBREADME\fR file in
that directory which tells what the current release of \fBMH\fP
d140 1
a140 1
Here are the \fIMH\fR configuraton options available:
d532 1
a532 1
but it might be usefull for SYSTEM 5 or HPUX systems with TCP/IP sockets.
d900 1
a900 1
then no futher MTS\-specific action is required on your part!
@


2.42
log
@*** empty log message ***
@
text
@d1 1
a1 1
.\" @@(#)$Id: mh-gen.8,v 2.41 90/04/05 16:08:57 sources Exp Locker: sources $
d7 5
a11 1
the UCI version of the RAND \fIMH\fR system.
d40 1
a40 1
.PP
@


2.41
log
@Id
@
text
@d1 1
a1 1
.\" @@(#)$Id:$
d47 1
d50 3
a52 1
and \fBMH\-Workers@@ICS.UCI.EDU\fR.
d57 2
a58 2
unless you suspect you have an old version.  There are two ways 
to get the latest release:
d61 1
a61 1
ics.uci.edu [128.195.1.1] and retrieve the file pub/mh-6.6.tar.Z.
d63 6
a68 2
(approx 1.5MB).  This file is also available on louie.udel.edu 
[128.175.1.3] in portal/mh-6.tar.Z.  You may also find MH.6.6 on
d77 1
a77 1
be made payable to
d83 1
d97 1
a97 1
still have to pay the $75.00.  The tar image has the documentation
d297 2
a298 1
\&`\-D' options to \fIcc\fR\0(1).
d321 1
a321 1
Directs \fIMH\fR to favor `!' over `@@'.
d920 1
a920 1
Before proceeding,
d938 2
a939 2
you should also read the \fImh.6\fR changes document.
The sources are in \fBpapers/mh6.5/\fR.
@


2.40
log
@*** empty log message ***
@
text
@d1 1
@


2.39
log
@add ID
@
text
@a0 1
.\" @@(#)$Id:$
d502 2
a503 2
It appears that some Sendmails return this code when they
don't mean to indicate a failure.
d558 3
a560 2
The default is \fBint\fR, but SYSTEM 5 systems (V.3.0 and later)
should probably set TYPESIG='void'.
d671 11
a681 3
The directory where the MH shared library should go.  If you want to
put it somewhere other than \fB/usr/lib\fR or \fB/usr/local/lib\fR
(not advisable), you'll probably have to run \fIldconfig\fR\0(8).
@


2.38
log
@typo
@
text
@d1 1
@


2.37
log
@RAND fixes
@
text
@d483 1
a483 1
Directs \fIinc\fR to note UNIX From: lines as Return-Path: info.
@


2.36
log
@NTOHL -> NTOHLSWAP
@
text
@d6 2
a7 2
the UCI version of the Rand \fIMH\fR system.
Although the \fIMH\fR system was originally developed by the Rand Corporation,
d9 1
a9 1
the Rand Corporation assumes no responsibility for \fIMH\fR
d32 1
a32 1
the authors ask only that you provide appropriate credit to the Rand
d36 1
a36 1
\fIMH\fR is a software package that is neither supported by the Rand
d356 14
@


2.35
log
@add sprintf config option
@
text
@d451 1
a451 1
NTOHL
@


2.34
log
@document WP
@
text
@d640 8
@


2.33
log
@typo
@
text
@d579 6
@


2.32
log
@typo
@
text
@d940 1
a940 1
The other files under \fB/usr/spool/bboards/fR will be overwritten
@


2.31
log
@typo
@
text
@d613 1
a613 1
Usually, \*(lq\-ns\*(rq is a good choice in any event.
@


2.30
log
@better documentation of BERK
@
text
@d564 1
a564 1
This may conflict with the interpretation of this file by \fINewsfR.
a595 1

@


2.29
log
@don't suggest using options UCI
@
text
@d317 3
a319 3
Makes a lot of simplifying assumptions that makes the code run a bit faster
by disabling nearly all of the address and header-parsing routines.
Unless you're on a really slow machine,
@


2.28
log
@make NTOHL positive
@
text
@d565 1
@


2.27
log
@add some detail
@
text
@d451 1
a451 1
NONTOHL
d453 6
a458 6
Tells \fIMH\fR not to use the \fBntohl()\fR macro when processing
\fImsh\fR binary map files.  \fIMH\fR uses this macro on 4BSD
systems to byte-swap the binary information in these map files.
If you need to be compatible with older versions of MH which did
not do this, or aren't using the same map files on machines
of different architectures, you probably want to define this option.
@


2.26
log
@redoc SUN41
@
text
@d300 2
a301 1
\fIrepl\fR will assume `\-nocc\ all' as the default instead of `\-cc\ all'.
d378 3
a380 2
Tells \fIrepl\fR to be more conservative in generating \*(lqcc:\*(rqs to the
user.
d386 1
a386 1
For example, LINK='\*(lq\\\\043\*(rq'.
d401 1
d519 1
d561 4
a564 1
Third, support for \fB$HOME/.signature\fR files is enabled.
@


2.25
log
@"bbdeliver: {on,off}"
@
text
@d512 4
a515 4
Apparently Sun and AT\&T have flip-flopped on whether 
the long\-suffering \fIsprintf()\fR
should return an \fIint\fR or \fIchar\ *\fR.  For Sun OS 4.1 this 
option defines it as \fIchar\ *\fR.
@


2.24
log
@mention saving mtstailor, etc.
@
text
@d225 1
d232 18
@


2.23
log
@suggest BSD43 with SUN40
@
text
@d897 1
a897 1
you may wish to preserve the following files:
d902 2
a903 2
\fIdirectory\fR \fIfiles\fR
etc/    MailAliases, mtstailor
d909 9
@


2.22
log
@merge "nntpbboards" and "popbboards" into "bboards: nntp/pop"
@
text
@d488 1
a488 1
\*(lqoptions BSD42\*(rq.
@


2.21
log
@*** empty log message ***
@
text
@d223 1
a223 1
Support for the UCI BBoards facility.
d225 6
a264 14

.ti -.5i
popbboards: off
.br
Support for the UCI BBoards facility via the POP service.
Requires both bboards and pop to be enabled.

.ti -.5i
nntpbboards: off
.br
Support for the UCI BBoards facility to read the Network News
via the NNTP.
Requires bboards to be enabled.  You cannot enable both
popbboards and nntpbboards.
@


2.20
log
@describe BSD43 a little better
@
text
@d332 2
a333 1
If your \fIopenlog()\fR syslog function takes three arguments instead of two,
d336 1
@


2.19
log
@add SUN41
@
text
@d332 3
@


2.18
log
@fix NONTOHL desc
@
text
@d494 8
d504 1
a504 1
Use on AT&T SYSTEM 5 UNIX system.  See also \fImailgroup\fR.
@


2.17
log
@doc NONTOHL
@
text
@d435 4
a438 4
msh binary map files.  Normally, \fIMH\fR will use this macro to byte-swap
binary information in \fImsh\fR map files.
If you need to be compatible with older versions of MH,
or aren't using the same map files on machines
@


2.16
log
@mention how to get MH
@
text
@d432 10
d558 1
a558 1
ccoptions: -O
@


2.15
log
@discourage TTYD use
@
text
@d49 42
a90 3
As of July 1989, I understand that \fBMH\-Users\fR
is being gatewayed into \fBcomp.mail.mh\fR, though I don't know
if messages are gatewayed from the newsgroup back to the list.
@


2.14
log
@sharedlibs, and ccoptions -- minor doc updates
@
text
@d460 1
a460 1
Support for TTYD.
@


2.13
log
@document DUMB a little better.
@
text
@d509 1
a509 1
ccoptions:
d513 2
d516 1
d562 3
a564 1
The directory where the MH shared library should go.
d613 1
a613 1
% mhconfig MH
@


2.12
log
@SUN40/TYPESIG predefined
@
text
@d309 2
a310 1
Directs \fIMH\fR to minimize address munging.
@


2.11
log
@minor documenting of SUN40/TYPESIG
@
text
@d440 2
a441 2
Use on Sun OS 4.0 (and later?) systems.  You'll also want
to set BSD42, BSD43, TYPESIG='void', and perhaps NFS.
@


2.10
log
@lex:
@
text
@d440 2
a441 1
Use on Sun OS 4.0 (and later?) systems
@


2.9
log
@MAILGROUP stuff
@
text
@d544 5
@


2.8
log
@SHADOW
@
text
@d117 6
d266 4
a269 5
Makes a lot of simplifying assumptions that makes the code run a bit faster;
disables much of the address and header-parsing routines.
Also enables one other change:
\fIscan\fR has a -[no]reverse switch which does the obvious thing.
\fIMH\fR purists hate this.
d445 1
a445 1
Use on AT&T SYSTEM 5 UNIX system.
a454 1

d500 5
@


2.7
log
@*** empty log message ***
@
text
@d418 7
@


2.6
log
@TZNAME
@
text
@d376 6
@


2.5
log
@*** empty log message ***
@
text
@d452 7
@


2.4
log
@SOCKETS
@
text
@d404 8
d417 1
a417 1
but it might be usefull for SYSTEM 5 systems with TCP/IP sockets.
@


2.3
log
@*** empty log message ***
@
text
@d153 1
a153 1
How \fIMH\fR shuld backup existing files when installing a new file.
d163 1
a163 1
On 4.2BSD UNIX systems 
d171 1
a171 1
for 4.2BSD UNIX systems,
d201 1
a201 1
This option currently works only on 4BSD UNIX systems.
d269 2
a270 1
If you are running with the BIND code under 4.{2,3}BSD,
d402 8
@


2.2
log
@TYPESIG
@
text
@d416 4
a419 1
This is true of System V Release 3.1 and later.
@


2.1
log
@defines for "make sys5"
@
text
@d424 8
@


2.0
log
@changes for SUN40 shared libraries and NNTP under bbc
@
text
@d539 2
a540 1
Now install the configured files into the source areas.
@


1.1
log
@Initial revision
@
text
@d49 3
a51 3
If there is sufficient interest,
corresponding Usenet news groups may be established along with the
appropriate gateways.
d201 1
a201 1
This option currently works only on 4.2BSD UNIX systems.
d222 8
d260 2
a261 1
Makes a lot of simplifying assumptions that makes the code run a bit faster.
d273 1
a273 1
BSD42
d275 1
a275 1
Use on Berkeley UNIX systems on or after 4.2BSD.
d278 1
a278 1
BSD41A
d280 1
a280 1
Use on 4.1a Berkeley UNIX systems.
d403 5
d413 6
d485 11
@