If heirloom shell is in /usr/lib/heirloom/5bin/sh, use it to run tests.
[mmh] / docs / historical / mh-6.8.5 / conf / RCS / mh-gen.8,v
1 head    2.119;
2 access;
3 symbols;
4 locks; strict;
5
6
7 2.119
8 date    96.02.08.19.20.25;      author jromine; state Exp;
9 branches;
10 next    2.118;
11
12 2.118
13 date    96.02.08.19.18.53;      author jromine; state Exp;
14 branches;
15 next    2.117;
16
17 2.117
18 date    95.12.05.19.36.14;      author jromine; state Exp;
19 branches;
20 next    2.116;
21
22 2.116
23 date    94.11.17.16.10.10;      author jromine; state Exp;
24 branches;
25 next    2.115;
26
27 2.115
28 date    93.12.01.00.44.23;      author jromine; state Exp;
29 branches;
30 next    2.114;
31
32 2.114
33 date    93.09.01.21.25.42;      author jromine; state Exp;
34 branches;
35 next    2.113;
36
37 2.113
38 date    93.08.27.22.22.08;      author jromine; state Exp;
39 branches;
40 next    2.112;
41
42 2.112
43 date    93.08.25.18.07.10;      author jromine; state Exp;
44 branches;
45 next    2.111;
46
47 2.111
48 date    93.08.20.19.47.56;      author jromine; state Exp;
49 branches;
50 next    2.110;
51
52 2.110
53 date    93.08.19.23.57.46;      author jromine; state Exp;
54 branches;
55 next    2.109;
56
57 2.109
58 date    93.08.19.23.34.15;      author jromine; state Exp;
59 branches;
60 next    2.108;
61
62 2.108
63 date    93.08.19.23.30.08;      author jromine; state Exp;
64 branches;
65 next    2.107;
66
67 2.107
68 date    93.06.03.17.54.12;      author jromine; state Exp;
69 branches;
70 next    2.106;
71
72 2.106
73 date    93.02.26.19.00.51;      author jromine; state Exp;
74 branches;
75 next    2.105;
76
77 2.105
78 date    92.12.14.17.19.19;      author jromine; state Exp;
79 branches;
80 next    2.104;
81
82 2.104
83 date    92.12.02.19.07.37;      author jromine; state Exp;
84 branches;
85 next    2.103;
86
87 2.103
88 date    92.11.21.20.46.59;      author jromine; state Exp;
89 branches;
90 next    2.102;
91
92 2.102
93 date    92.11.19.18.09.59;      author jromine; state Exp;
94 branches;
95 next    2.101;
96
97 2.101
98 date    92.11.19.17.45.16;      author jromine; state Exp;
99 branches;
100 next    2.100;
101
102 2.100
103 date    92.11.16.22.35.55;      author jromine; state Exp;
104 branches;
105 next    2.99;
106
107 2.99
108 date    92.11.12.23.30.09;      author jromine; state Exp;
109 branches;
110 next    2.98;
111
112 2.98
113 date    92.11.12.22.48.35;      author jromine; state Exp;
114 branches;
115 next    2.97;
116
117 2.97
118 date    92.11.12.00.07.59;      author jromine; state Exp;
119 branches;
120 next    2.96;
121
122 2.96
123 date    92.11.12.00.04.00;      author jromine; state Exp;
124 branches;
125 next    2.95;
126
127 2.95
128 date    92.11.11.22.58.26;      author jromine; state Exp;
129 branches;
130 next    2.94;
131
132 2.94
133 date    92.11.10.22.40.25;      author jromine; state Exp;
134 branches;
135 next    2.93;
136
137 2.93
138 date    92.11.09.18.45.48;      author jromine; state Exp;
139 branches;
140 next    2.92;
141
142 2.92
143 date    92.11.06.19.29.16;      author jromine; state Exp;
144 branches;
145 next    2.91;
146
147 2.91
148 date    92.11.06.01.06.04;      author jromine; state Exp;
149 branches;
150 next    2.90;
151
152 2.90
153 date    92.11.06.00.47.31;      author jromine; state Exp;
154 branches;
155 next    2.89;
156
157 2.89
158 date    92.11.05.19.25.27;      author jromine; state Exp;
159 branches;
160 next    2.88;
161
162 2.88
163 date    92.11.05.17.20.40;      author jromine; state Exp;
164 branches;
165 next    2.87;
166
167 2.87
168 date    92.11.02.19.01.33;      author jromine; state Exp;
169 branches;
170 next    2.86;
171
172 2.86
173 date    92.11.02.19.01.00;      author jromine; state Exp;
174 branches;
175 next    2.85;
176
177 2.85
178 date    92.11.02.18.39.35;      author jromine; state Exp;
179 branches;
180 next    2.84;
181
182 2.84
183 date    92.11.02.17.10.51;      author jromine; state Exp;
184 branches;
185 next    2.83;
186
187 2.83
188 date    92.10.31.06.24.13;      author jromine; state Exp;
189 branches;
190 next    2.82;
191
192 2.82
193 date    92.10.31.06.20.55;      author jromine; state Exp;
194 branches;
195 next    2.81;
196
197 2.81
198 date    92.10.29.22.20.55;      author jromine; state Exp;
199 branches;
200 next    2.80;
201
202 2.80
203 date    92.10.29.17.44.55;      author jromine; state Exp;
204 branches;
205 next    2.79;
206
207 2.79
208 date    92.10.29.17.39.14;      author jromine; state Exp;
209 branches;
210 next    2.78;
211
212 2.78
213 date    92.10.27.21.44.44;      author jromine; state Exp;
214 branches;
215 next    2.77;
216
217 2.77
218 date    92.10.27.18.11.52;      author jromine; state Exp;
219 branches;
220 next    2.76;
221
222 2.76
223 date    92.10.27.17.41.40;      author jromine; state Exp;
224 branches;
225 next    2.75;
226
227 2.75
228 date    92.10.27.17.00.27;      author jromine; state Exp;
229 branches;
230 next    2.74;
231
232 2.74
233 date    92.10.26.16.54.14;      author jromine; state Exp;
234 branches;
235 next    2.73;
236
237 2.73
238 date    92.10.26.16.29.56;      author jromine; state Exp;
239 branches;
240 next    2.72;
241
242 2.72
243 date    92.10.20.22.50.50;      author jromine; state Exp;
244 branches;
245 next    2.71;
246
247 2.71
248 date    92.10.19.21.57.08;      author jromine; state Exp;
249 branches;
250 next    2.70;
251
252 2.70
253 date    92.10.19.21.56.21;      author jromine; state Exp;
254 branches;
255 next    2.69;
256
257 2.69
258 date    92.10.19.21.48.20;      author jromine; state Exp;
259 branches;
260 next    2.68;
261
262 2.68
263 date    92.10.19.20.29.19;      author jromine; state Exp;
264 branches;
265 next    2.67;
266
267 2.67
268 date    92.05.12.21.05.04;      author jromine; state Exp;
269 branches;
270 next    2.66;
271
272 2.66
273 date    92.05.12.21.04.45;      author jromine; state Exp;
274 branches;
275 next    2.65;
276
277 2.65
278 date    92.02.12.21.36.21;      author jromine; state Exp;
279 branches;
280 next    2.64;
281
282 2.64
283 date    92.02.12.21.35.05;      author jromine; state Exp;
284 branches;
285 next    2.63;
286
287 2.63
288 date    92.02.11.05.08.34;      author jromine; state Exp;
289 branches;
290 next    2.62;
291
292 2.62
293 date    92.02.06.16.48.48;      author jromine; state Exp;
294 branches;
295 next    2.61;
296
297 2.61
298 date    92.02.06.00.25.07;      author jromine; state Exp;
299 branches;
300 next    2.60;
301
302 2.60
303 date    92.02.05.22.18.48;      author jromine; state Exp;
304 branches;
305 next    2.59;
306
307 2.59
308 date    92.02.05.21.52.46;      author jromine; state Exp;
309 branches;
310 next    2.58;
311
312 2.58
313 date    92.01.31.23.09.59;      author jromine; state Exp;
314 branches;
315 next    2.57;
316
317 2.57
318 date    92.01.31.22.55.36;      author jromine; state Exp;
319 branches;
320 next    2.56;
321
322 2.56
323 date    92.01.31.22.47.36;      author jromine; state Exp;
324 branches;
325 next    2.55;
326
327 2.55
328 date    92.01.30.16.41.35;      author jromine; state Exp;
329 branches;
330 next    2.54;
331
332 2.54
333 date    91.01.24.08.27.50;      author mh;      state Exp;
334 branches;
335 next    2.53;
336
337 2.53
338 date    91.01.23.14.54.18;      author mh;      state Exp;
339 branches;
340 next    2.52;
341
342 2.52
343 date    91.01.23.14.44.18;      author mh;      state Exp;
344 branches;
345 next    2.51;
346
347 2.51
348 date    90.12.18.13.55.54;      author mh;      state Exp;
349 branches;
350 next    2.50;
351
352 2.50
353 date    90.11.21.09.27.52;      author mh;      state Exp;
354 branches;
355 next    2.49;
356
357 2.49
358 date    90.11.16.14.55.57;      author mh;      state Exp;
359 branches;
360 next    2.48;
361
362 2.48
363 date    90.04.09.13.27.27;      author sources; state Exp;
364 branches;
365 next    2.47;
366
367 2.47
368 date    90.04.09.10.01.42;      author sources; state Exp;
369 branches;
370 next    2.46;
371
372 2.46
373 date    90.04.08.19.35.27;      author sources; state Exp;
374 branches;
375 next    2.45;
376
377 2.45
378 date    90.04.07.23.34.23;      author sources; state Exp;
379 branches;
380 next    2.44;
381
382 2.44
383 date    90.04.06.10.59.28;      author sources; state Exp;
384 branches;
385 next    2.43;
386
387 2.43
388 date    90.04.06.10.51.39;      author sources; state Exp;
389 branches;
390 next    2.42;
391
392 2.42
393 date    90.04.06.10.46.18;      author sources; state Exp;
394 branches;
395 next    2.41;
396
397 2.41
398 date    90.04.05.16.08.57;      author sources; state Exp;
399 branches;
400 next    2.40;
401
402 2.40
403 date    90.04.05.16.08.33;      author sources; state Exp;
404 branches;
405 next    2.39;
406
407 2.39
408 date    90.04.05.15.19.29;      author sources; state Exp;
409 branches;
410 next    2.38;
411
412 2.38
413 date    90.04.04.23.08.49;      author sources; state Exp;
414 branches;
415 next    2.37;
416
417 2.37
418 date    90.04.02.14.39.11;      author sources; state Exp;
419 branches;
420 next    2.36;
421
422 2.36
423 date    90.04.02.14.19.26;      author sources; state Exp;
424 branches;
425 next    2.35;
426
427 2.35
428 date    90.04.02.14.11.22;      author sources; state Exp;
429 branches;
430 next    2.34;
431
432 2.34
433 date    90.03.29.15.45.05;      author sources; state Exp;
434 branches;
435 next    2.33;
436
437 2.33
438 date    90.03.28.17.19.36;      author sources; state Exp;
439 branches;
440 next    2.32;
441
442 2.32
443 date    90.03.28.17.16.41;      author sources; state Exp;
444 branches;
445 next    2.31;
446
447 2.31
448 date    90.03.28.17.16.05;      author sources; state Exp;
449 branches;
450 next    2.30;
451
452 2.30
453 date    90.03.28.16.49.49;      author sources; state Exp;
454 branches;
455 next    2.29;
456
457 2.29
458 date    90.03.28.11.15.35;      author sources; state Exp;
459 branches;
460 next    2.28;
461
462 2.28
463 date    90.03.23.16.41.33;      author sources; state Exp;
464 branches;
465 next    2.27;
466
467 2.27
468 date    90.03.23.11.25.10;      author sources; state Exp;
469 branches;
470 next    2.26;
471
472 2.26
473 date    90.03.21.22.19.34;      author sources; state Exp;
474 branches;
475 next    2.25;
476
477 2.25
478 date    90.03.21.11.00.53;      author sources; state Exp;
479 branches;
480 next    2.24;
481
482 2.24
483 date    90.03.21.10.30.55;      author sources; state Exp;
484 branches;
485 next    2.23;
486
487 2.23
488 date    90.03.19.10.24.26;      author sources; state Exp;
489 branches;
490 next    2.22;
491
492 2.22
493 date    90.03.19.10.22.53;      author sources; state Exp;
494 branches;
495 next    2.21;
496
497 2.21
498 date    90.03.19.09.50.57;      author sources; state Exp;
499 branches;
500 next    2.20;
501
502 2.20
503 date    90.03.19.09.47.05;      author sources; state Exp;
504 branches;
505 next    2.19;
506
507 2.19
508 date    90.03.19.09.42.16;      author sources; state Exp;
509 branches;
510 next    2.18;
511
512 2.18
513 date    90.03.18.16.34.45;      author sources; state Exp;
514 branches;
515 next    2.17;
516
517 2.17
518 date    90.03.16.15.58.57;      author sources; state Exp;
519 branches;
520 next    2.16;
521
522 2.16
523 date    90.03.15.15.54.26;      author sources; state Exp;
524 branches;
525 next    2.15;
526
527 2.15
528 date    90.03.12.14.14.24;      author sources; state Exp;
529 branches;
530 next    2.14;
531
532 2.14
533 date    90.03.12.11.38.44;      author sources; state Exp;
534 branches;
535 next    2.13;
536
537 2.13
538 date    90.03.09.15.52.29;      author sources; state Exp;
539 branches;
540 next    2.12;
541
542 2.12
543 date    90.02.23.14.33.26;      author sources; state Exp;
544 branches;
545 next    2.11;
546
547 2.11
548 date    90.02.23.14.22.20;      author sources; state Exp;
549 branches;
550 next    2.10;
551
552 2.10
553 date    90.02.15.14.24.30;      author sources; state Exp;
554 branches;
555 next    2.9;
556
557 2.9
558 date    90.02.15.14.12.18;      author sources; state Exp;
559 branches;
560 next    2.8;
561
562 2.8
563 date    90.02.05.15.03.53;      author sources; state Exp;
564 branches;
565 next    2.7;
566
567 2.7
568 date    90.02.05.15.01.02;      author sources; state Exp;
569 branches;
570 next    2.6;
571
572 2.6
573 date    90.02.05.14.59.29;      author sources; state Exp;
574 branches;
575 next    2.5;
576
577 2.5
578 date    90.02.05.14.55.11;      author sources; state Exp;
579 branches;
580 next    2.4;
581
582 2.4
583 date    90.02.05.14.50.18;      author sources; state Exp;
584 branches;
585 next    2.3;
586
587 2.3
588 date    90.02.05.14.34.10;      author sources; state Exp;
589 branches;
590 next    2.2;
591
592 2.2
593 date    90.02.05.14.19.28;      author sources; state Exp;
594 branches;
595 next    2.1;
596
597 2.1
598 date    90.01.29.15.42.39;      author sources; state Exp;
599 branches;
600 next    2.0;
601
602 2.0
603 date    89.11.17.15.56.50;      author sources; state Exp;
604 branches;
605 next    1.1;
606
607 1.1
608 date    89.06.02.13.28.04;      author sources; state Exp;
609 branches;
610 next    ;
611
612
613 desc
614 @@
615
616
617 2.119
618 log
619 @typo
620 @
621 text
622 @.\" @@(#)$Id: mh-gen.8,v 2.118 1996/02/08 19:18:53 jromine Exp jromine $
623 .\" uneven inter-word spacing (nroff line adjusting) hampers readability
624 .if n .na
625 .TH MH-GEN 8 MH.6.8.4 [mh.6]
626 .SH NAME
627 mh-gen \- generating the MH system
628 .SH "READ THIS"
629 This documentation describes how to configure, generate, and install
630 the UCI version of the RAND \fIMH\fR system.  \fBBe certain\fP to 
631 read this document completely before you begin.  You probably will
632 also want to familiarize yourself with the \fIMH\fP Administrator's
633 Guide before you install \fIMH\fP.  A copy can be found in the
634 file \fBdoc/ADMIN.doc\fP is the \fIMH\fP sources.
635 .SH DISCLAIMER
636 Although the \fIMH\fR system was originally developed by the RAND Corporation,
637 and is now in the public domain,
638 the RAND Corporation assumes no responsibility for \fIMH\fR
639 or this particular modification of \fIMH\fR.
640 .PP
641 In addition,
642 the Regents of the University of California issue the following
643 \fBdisclaimer\fR in regard to the UCI version of \fIMH\fR:
644 .in +.5i
645 \*(lqAlthough each program has been tested by its contributor,
646 no warranty, express or implied,
647 is made by the contributor or the University of California,
648 as to the accuracy and functioning of the program
649 and related program material,
650 nor shall the fact of distribution constitute any such warranty,
651 and no responsibility is assumed by the contributor
652 or the University of California in connection herewith.\*(rq
653 .in -.5i
654 .PP
655 This version of \fIMH\fR is in the public domain,
656 and as such,
657 there are no real restrictions on its use.
658 The \fIMH\fR source code and documentation have no licensing restrictions
659 whatsoever.
660 As a courtesy,
661 the authors ask only that you provide appropriate credit to the RAND
662 Corporation and
663 the University of California for having developed the software.
664 .SH "GETTING HELP"
665 \fIMH\fR is a software package that is neither supported by the RAND
666 Corporation nor the University of California.
667 However,
668 since we do use the software ourselves and plan to continue using (and
669 improving) \fIMH\fR,
670 bug reports and their associated fixes should be reported back to us so that
671 we may include them in future releases.
672 The current computer mailbox for \fIMH\fR is \fBBug\-MH@@ICS.UCI.EDU\fR.
673 Current information about MH can be obtained from
674 the \fBMH Home Page\fP on the World Wide Web at
675 \fBhttp://www.ics.uci.edu/~mh\fP.
676 .PP
677 Presently,
678 there are two Internet discussion groups, \fBMH\-Users@@ICS.UCI.EDU\fR
679 and \fBMH\-Workers@@ICS.UCI.EDU\fR.  \fBMH\-Workers\fP is for people
680 discussing code changes to \fIMH\fP.  \fBMH-Users\fP is for general
681 discussion about how to use \fIMH\fP.
682 \fBMH\-Users\fR is bi-directionally 
683 gatewayed into USENET as \fBcomp.mail.mh\fR.
684 .SH "HOW TO GET MH"
685 Since you probably already have \fIMH\fP,
686 you may not need to read this unless you suspect you have an old version.
687 There are two ways to get the latest release:
688 .PP
689 1.  If you can FTP to the ARPA Internet, use anonymous FTP to
690 ftp.ics.uci.edu and retrieve the file pub/mh/mh-6.8.tar.Z.
691 This is a tar image after being run through the compress program
692 (approximately 1.8MB).  There should also be a \fBREADME\fR file in
693 that directory which tells what the current release of \fIMH\fP
694 is, and how to get updates.
695 .PP
696 You may also find MH on
697 various other hosts; to make sure you get the latest version and
698 don't waste your time re-fixing bugs, it's best to get it from
699 either ftp.ics.uci.edu or a site that mirrors ftp.ics.uci.edu.
700 .PP
701 2.  You can send $75 US to the address below.
702 This covers the cost of a 6250 BPI 9-track magtape,
703 handling, and shipping.  In addition, you'll get a
704 laser-printed hard-copy of the entire MH documentation set.  Be
705 sure to include your USPS address with your check.  Checks 
706 must be drawn on U.S\&. funds and should be made payable to:
707
708 .ti +1i
709 Regents of the University of California
710
711 The distribution address is:  
712
713 .nf
714 .RS 1i
715 Attn: MH distribution
716 Office of Academic Computing
717 Univeristy of California at Irvine
718 Irvine, CA  92717-2225  USA
719
720 +1 714 824 5153
721 .fi
722 .RE
723 .PP
724 Sadly, if you just want the hard-copies of the documentation, you
725 still have to pay the $75.  The tar image has the documentation
726 source (the manual is in roff format, but the rest are in TeX
727 format).  Postscript formatted versions of the TeX papers are 
728 available, as are crude tty-conversions of those papers.
729 .SH SYNOPSIS
730 MAKE
731 .SH DESCRIPTION
732 This is a description of how one can bring up an \fIMH\fR system.
733 It is assumed that you have super-user privileges in order to
734 (re\-)install \fIMH\fR.
735 Super-user privileges are not required to configure or generate \fIMH\fR.
736 .PP
737 Become the super-user and cd to /usr/src/local/
738 (or whatever you keep your local sources).
739 The distribution tape contains the hierarchy for the mh.6-8/ directory.
740 Bring the sources on-line:
741 .sp 1
742 .nf
743 # cd /usr/src/local
744 % tar xv
745 % cd mh-6.8
746 .fi
747 .SH CONFIGURATION
748 First, go to the conf/ directory.
749 .sp 1
750 .nf
751 % cd conf/
752 .fi
753 .sp 1
754 This directory contains files that will produce source files tailored
755 for your choice of \fIMH\fR configuration.
756 You should edit only the file \fBMH\fR.
757 This file contains configuration directives.
758 These configuration directives are read by the \fImhconfig\fR program to
759 produce customized files.
760 .sp
761 For examples of various configurations,
762 look in the directory \fBconf/examples/\fR.
763 The file \fBMH\fR provided in \fBconf/\fR is a reasonable default.
764 Lines beginning with `#' are comments, and are not otherwise interpreted.
765 .PP
766 Here are the \fIMH\fP configuration directives available.  Be sure
767 to read through this list completely before attempting to decide
768 what directives are appropriate for your system.  
769 .sp
770 More information on some of these options is available in the
771 the \fIAdministrator's Guide\fR.  If you do not have a printed
772 copy, you should configure your system with the default
773 configuration file, \fBMH\fP, then generate and print a copy
774 of the guide (as described below).
775 .in +.5i
776
777 .de Uh
778 .ti -.75i
779 .B "\\$1"
780 .ne 4
781 ..
782 .Uh "Installation paths"
783 .ti -.5i
784 bin: /usr/local
785 .br
786 The directory where user\-invoked programs go (see manual section 1).
787
788 .ti -.5i
789 etc: /usr/local/lib/mh
790 .br
791 The directory where pgm\-invoked programs go (see manual section 8).
792
793 .ti -.5i
794 mail: /usr/spool/mail
795 .br
796 The directory where the maildrops are stored.
797 If this pathname is absolute (i.e., begins with a \fB/\fR\0),
798 then the user's maildrop is a file called \fB$USER\fR in this directory.
799 If the pathname is not absolute,
800 then the user's maildrop is in the user's home directory under the given name.
801
802 .ti -.5i
803 mandir: /usr/man
804 .br
805 The parent directory of the manual entries.
806
807 .ti -.5i
808 manuals: standard
809 .br
810 Where manual entries should be installed,
811 relative to the directory given with \*(lqmandir\*(rq.
812 Either \*(lqlocal\*(rq to install manual entries under \fBmanl/\fR,
813 or \*(lqnew\*(rq to install manual entries under \fBmann/\fR,
814 or \*(lqold\*(rq to install manual entries under \fBmano/\fR,
815 or \*(lqstandard\*(rq to install manual entries under \fBman?/\fR,
816 or \*(lqbsd44\*(rq to install manual entries as \fBman?/\fIpage\fP.0\fR,
817 or \*(lqgen\*(rq to generate but not install them,
818 or \*(lqnone\*(rq to neither generate nor install them.
819
820 Any of these values may have the suffix \*(lq/cat\*(rq appended 
821 to it.   In that case, the manual entries will be formatted
822 with \*(lqnroff -man\*(rq and they will be installed in the
823 corresponding \*(lqcat?\*(rq directories.
824
825 For example,
826 to install manual entries under \fB/usr/man/u_man/man?\fR,
827 use \*(lqstandard\*(rq and \fB/usr/man/u_man\fR for \*(lqmandir\*(rq.
828 To install formatted manual entires under \fB/usr/contrib/man/cat?\fR,
829 use \*(lqstandard/cat\*(rq and \fB/usr/contrib/man\fR for \*(lqmandir\*(rq.
830 To install formatted manual entries using the BSD44 convention,
831 use \*(lqbsd44/cat\*(rq.
832
833 .ti -.5i
834 chown: /etc/chown
835 .br
836 The location of the \fIchown\fR\|(8) on your system.
837 If \fIchown\fR is in your search path,
838 just use the value of \*(lqchown\*(rq.
839 On SYS5 systems,
840 this should probably be \*(lq/bin/chown\*(rq.
841
842 .ti -.5i
843 cp: cp
844 .br
845 The command to copy files when installing, if not \*(lqcp\*(rq.
846 (Some sites use \*(lqcp\0\-p\*(rq.)
847
848 .ti -.5i
849 ln: ln
850 .br
851 The command to link files together in the source tree, if not \*(lqln\*(rq.
852 If you're using something like \fBlndir\fP to keep
853 your compile tree separate from your source tree,
854 set this to \*(lqln\0\-s\*(rq or \*(lqcp\*(rq.
855
856 .ti -.5i
857 remove: mv \-f
858 .br
859 How \fIMH\fR should make backup copies
860 of existing files when installing new files.
861 To simply remove the old files, use \*(lqrm\0\-f\*(rq.
862
863 .Uh "Compiler/loader"
864 .ti -.5i
865 cc: cc
866 .br
867 The name of your C compiler, if not \*(lqcc\*(rq.
868
869 .ti -.5i
870 ccoptions: \-O
871 .br
872 Options given directly to \fIcc\fR\|(1).
873 The most common is \*(lq\-M\*(rq if you're running \fIMH\fR on an ALTOS.
874 This defaults to \*(lq\-O\*(rq.  If you define this and want to 
875 keep \*(lq\-O\*(rq, be sure to include it explicitly.
876 If you're using the \fIGNU\fP C compiler, it should
877 include `\-traditional'.  See \*(lqoptions:\*(rq for `\-D' options.
878
879 .ti -.5i
880 curses: \-lcurses\0\-ltermlib
881 .br
882 This should be the loader option required to load the \fItermcap\fR\|(3)
883 and \fIcurses\fR\|(3) libraries on your system.
884 On SYS5 systems, it probably should be just \*(lq\-lcurses\*(rq.
885 Some sites have reported that both \*(lq\-lcurses\*(rq and
886 \*(lq\-ltermlib\*(rq are necessary.
887
888 .ti -.5i
889 ldoptions: \-s
890 .br
891 Options given directly to \fIld\fR\|(1) (via \fIcc\fR\|) at the beginning
892 of the command line.
893 Useful for machines which require arguments to tell \fIld\fR to increase the
894 stack space (e.g. the Gould, which uses \*(lq\-m\08\*(rq).
895 Usually, \*(lq\-s\*(rq is a good choice in any event.
896
897 .ti -.5i
898 ldoptlibs:
899 .br
900 Options given directly to \fIld\fR\|(1) (via \fIcc\fR\|) at the end of the
901 command line.
902 The two most common are:
903 \*(lq\-ldbm\*(rq if you're running MMDF with the \fIdbm\fR package;
904 and, \*(lq\-lndir\*(rq if you are generating \fIMH\fR on a system
905 which does not load the new directory access mechanism by default
906 (e.g., 4.1BSD, SYS5).
907 If you don't have \fIlibndir\fR on your system,
908 the sources are in \fBmiscellany/libndir/\fR.
909
910 .ti -.5i
911 lex: lex \-nt
912 .br
913 Alternative version of \fIlex\fR.  Used in \fBzotnet/tws/\fR.
914
915 .ti -.5i
916 oldload: off
917 .br
918 This controls how \fIMH\fP will try to process library object files to
919 eliminate local symbols.
920 Support for the ALTOS loader if \*(lqon\*(rq.
921 Support for loaders not handling `\-x\0\-r' correctly if \*(lqnone\*(rq.
922
923 .ti -.5i
924 ranlib: on
925 .br
926 Support for systems with \fIranlib\fR\|(1).
927 For SYSTEM 5 systems,
928 this should be \*(lqoff\*(rq which tells \fIMH\fR to use \fIlorder\fR and
929 \fItsort\fR instead.
930 Some SYSTEM 5 sites reported that running this isn't always sufficient.
931 If this is the case,
932 then you should edit \fBconf/makefiles/uip\fR to include
933 \fB\&../sbr/libmh.a\fR and \fB../zotnet/libzot.a\fR twice in the LIBES
934 variable.
935
936 .Uh "Message Transport System"
937 .ti -.5i
938 mts: sendmail
939 .br
940 Which message transport system to use.
941 Either \*(lqmmdf\*(rq to use \fIMMDF\fR as the transport system,
942 \*(lqmmdf2\*(rq to use \fIMMDF\-II\fR as the transport system,
943 \*(lqsendmail\*(rq to have \fISendMail\fR as the transport system,
944 \*(lqzmailer\*(rq to have \fIZMAILER\fP as the transport system,
945 or, \*(lqmh\*(rq to have \fIMH\fR as the transport system.
946
947 On UNIX systems supporting TCP/IP networking via sockets
948 you can add the suffix \*(lq/smtp\*(rq to the mts setting.
949 This often yields a superior interface as \fIMH\fR will post mail with the
950 local \fISMTP\fR server instead of interacting directly with \fIMMDF\fR or
951 \fISendMail\fR.
952 Hence, for TCP/IP UNIX systems,
953 the \*(lq/smtp\*(rq suffix to either \*(lqsendmail\*(rq or \*(lqmmdf2\*(rq is
954 the preferred MTS configuration.
955 The \*(lq/smtp\*(rq suffix is described in detail in the \fIAdministrator's
956 Guide\fR; be sure to set \*(lqservers:\*(rq as described in
957 \fImh\-tailor\fR\|(8) if you use this option.
958
959 .ti -.5i
960 mf: off
961 .br
962 Support for mail filtering on those systems in which the message transport
963 system isn't integrated with \fIUUCP\fR 
964 This option is strictly for an \fIMH\fR system using either \fIMMDF\-I\fR
965 as its transport system or one using \*(lqstand\-alone delivery\*(rq.
966
967 .Uh "UCI BBoards Facility"
968 .ti -.5i
969 bboards: off
970 .br
971 If \*(lqon\*(rq, include support for the UCI BBoards facility.
972 BBoards may be enabled with any mts setting.
973 If \*(lqoff\*(rq, the BBoard reading program \fIbbc\fR will not be installed.
974 If \*(lqnntp\*(rq,
975 include support for the UCI BBoards facility to read the Network News
976 via the NNTP.
977 If \*(lqpop\*(rq (formerly \*(lqpopbboards:\0on\*(rq),
978 include support for the UCI BBoards facility via the POP3 service;
979 this setting requires \*(lqpop:\0on\*(rq.
980
981 .ti -.5i
982 bbdelivery: off
983 .br
984 If \*(lqoff\*(rq,
985 the BBoards delivery agent and library files will not be installed.
986 If 
987 \*(lqon\*(rq,
988 and you set \*(lqbboards:\*(rq to something besides \*(lqoff\*(rq,
989 then 
990 the BBoards delivery agent and library files will be installed
991 in the \fIbbhome\fR directory (see below).
992 To read remote BBoards,
993 the usual configuration would have \fIbbc\fR talk to a \fIPOP3\fR or
994 \fINNTP\fR server.
995 However, it may be useful to set this to \*(lqoff\*(rq if 
996 you NFS mount the \fIbbhome\fR directory from another host
997 and want to use \fIbbc\fR to read those files directly.
998
999 .ti -.5i
1000 bbhome: /usr/spool/bboards
1001 .br
1002 The home directory for the BBoards user.
1003
1004 .Uh "Post Office Protocol"
1005 .ti -.5i
1006 pop: off
1007 .br
1008 Support for POP service.
1009 This allows local delivery for non\-local users
1010 (a major win).
1011 See \fBsupport/pop/pop.rfc\fR for more information on the POP.
1012 This option currently works only on UNIX systems with TCP/IP sockets.
1013 (It doesn't hurt to enable this option regardless of whether or not
1014 you intend to use POP.)  See also \*(lqbboards: pop\*(rq to enable
1015 reading bboards with the POP.
1016
1017 .ti -.5i
1018 popdir: /usr/etc
1019 .br
1020 The directory where the POP daemon (\fBpopd\fP) will be installed.
1021
1022 .ne 5
1023 .ti -.5i
1024 options:
1025 .br
1026 \&`\-D' options to \fIcc\fR\|(1).
1027 .sp
1028 .in +.25i
1029 .ti -.5i
1030 APOP='\*(lq/etc/pop.auth\*(rq'
1031 .br
1032 This option indicates that the POP daemon will
1033 support the non-standard \fBAPOP\fP command,
1034 and specifies the name of \fBAPOP\fP authorization database.
1035 The \fBAPOP\fP
1036 command provides a challenge-based authentication system using
1037 the \fBMD5\fP message digest algorithm.
1038 This facility is documented in 
1039 \fIThe Internet Message\fR (ISBN 0\-13\-092941\-7), a book by Marshall T. Rose.
1040 .sp
1041 This option also causes the
1042 \fBpopauth\fP program to be installed, which
1043 allows the administrator to manipulate the \fBAPOP\fP
1044 authorization database.
1045 For more details, see \fBsupport/pop/pop-more.txt\fR
1046 and the \fIAdministrator's Guide\fP.
1047
1048 .ti -.5i
1049 DPOP
1050 .br
1051 This option indicates that POP subscribers do not have
1052 entries in the \fIpasswd\fR\|(5) file,
1053 and instead have their own separate database (a win).
1054
1055 .ti -.5i
1056 KPOP
1057 .br
1058 Support for KERBEROS with POP.
1059 This code builds
1060 \fIpopd\fP, \fIinc\fP and \fImsgchk\fP to support only the 
1061 \*(lqkpop\*(rq protocol.
1062 This code is still experimental, but is available for 
1063 those sites wishing to test it.
1064
1065 .ti -.5i
1066 MPOP
1067 .br
1068 This option indicates that the POP daemon will
1069 support the non-standard
1070 \fBXTND SCAN\fP command which provides performance
1071 enhancements when using the POP over low-speed connections.
1072 This option also causes an interactive POP
1073 client program, \fBpopi\fP, to be compiled and installed.
1074 A man page for the \fBpopi\fP program is also provided.
1075 .sp
1076 These extensions are described in 
1077 \fIThe Internet Message\fR, a book by Marshall T. Rose.
1078 For more details, see \fBsupport/pop/pop-more.txt\fR.
1079 \fBNote:\fP this option requires \*(lqbboards: pop\*(rq.
1080
1081 .ti -.5i
1082 POP2
1083 .br
1084 Have the POP daemon understand the older
1085 POP2 protocol as well as the \fIMH\fP POP3 protocol \- a major win.
1086 The POP daemon auto-magically
1087 determines which POP protocol your client is using.
1088 If you're enabling POP service,
1089 there's no reason not to enable this option as well.
1090 See also \fIPOPSERVICE\fR.
1091
1092 .ti -.5i
1093 POPSERVICE
1094 .br
1095 The port name the \fIMH\fP POP will use.  For historical reasons,
1096 this defaults to \*(lqpop\*(rq.
1097 .sp
1098 In 1987, the \fIMH\fP POP protocol
1099 (POP version 3) was published as RFC1081 and
1100 was assigned its own port number (110),
1101 which differs from the original POP (version 1 and 2) port number (109).
1102 .sp
1103 To have \fIMH\fP POP use the new assigned port number, 
1104 set POPSERVICE='\*(lqpop3\*(rq', and be sure that this service
1105 name is listed in your \fB/etc/services\fP file on both POP client
1106 and server hosts as \*(lq110/tcp\*(rq.
1107 If you enable \fIPOP2\fP, you can safely leave \fIPOPSERVICE\fP
1108 undefined unless you are using POP3 clients besides \fIMH\fP.
1109
1110 .ti -.5i
1111 RPOP
1112 .br
1113 This option indicates that support for the UNIX variant of POP,
1114 RPOP, which uses privileged sockets for authentication be enabled.
1115 This peacefully co-exists with the standard POP.
1116
1117 .ti -.5i
1118 SHADOW
1119 .br
1120 Indicates that the \fBpopd\fP POP server
1121 can find encrypted passwords in the
1122 \fB/etc/shadow\fR file (and not in the \fB/etc/passwd\fR file).
1123 It should be used only for some (newer) SYSTEM 5 systems.
1124 .in -.25i
1125
1126 The \*(lqAPOP\*(rq and \*(lqMPOP\*(rq non-standard POP
1127 facilities are documented in
1128 \fIThe Internet Message\fR (ISBN 0\-13\-092941\-7),
1129 a book by Marshall T. Rose.
1130 For more details, see \fBsupport/pop/pop-more.txt\fR.
1131 The \*(lqAPOP\*(rq option peacefully co-exists with the standard POP.
1132 The \*(lqMPOP\*(rq option requires \*(lqbboards: pop\*(rq.
1133
1134 .Uh "Shared libraries"
1135 .ti -.5i
1136 sharedlib: off
1137 .br
1138 If \*(lqsun4\*(rq,
1139 makes libmh.a into a SunOS 4.0 (and later) shared library.
1140 If you enable this, be sure to also use \*(lqoptions SUN40\*(rq.
1141 If \*(lqsys5\*(rq, 
1142 makes libmh.a into a SYS5 R4 (and later) shared library.
1143 If you enable this, be sure to also use \*(lqoptions SVR4\*(rq.
1144
1145 .ti -.5i
1146 slflags: \-pic
1147 .br
1148 The compiler flags to produce position independent code.
1149
1150 .ti -.5i
1151 slibdir: /usr/local/lib
1152 .br
1153 The directory where the \fIMH\fP shared library should go.
1154
1155 .ne 4
1156 .ti -.25i
1157 Under SunOS (sun4)
1158 .br
1159 Since some \fIMH\fP programs are setuid, they'll only look for
1160 the library in \*(lqtrusted\*(rq locations.  Putting the library
1161 somewhere besides \fB/usr/lib\fP or \fB/usr/local/lib\fP is not advisable.
1162
1163 If you \fBmust\fP do this, be sure that you add the 
1164 path given by \fBslibdir\fP to the compiler's library search list 
1165 (e.g., \*(lqldoptions:\0\-L/usr/mh/lib\*(rq)
1166 and make sure the path starts with a leading `/'.
1167
1168 You may need to run \fIldconfig\fP\|(8) manually whenever a new
1169 shared object is installed on the system.
1170 See \fIld\fR\|(1) for more information about using shared libraries.
1171
1172 .ti -.25i
1173 Under Solaris 2.0 (and newer)
1174 .br
1175 The above instructions for SunOS apply, except you should set
1176 the run-time library search path using `\-R' instead of `\-L'
1177 (e.g., \*(lqldoptions: \-R/usr/mh/lib\*(rq).
1178
1179 .Uh "General System Dependencies"
1180 .in -.5i
1181 You should include the following directives 
1182 which are appropriate for your version of UNIX.
1183 If you don't know what an
1184 option does, it probably doesn't apply to you.
1185 .in +.5i
1186
1187 .ti -.5i
1188 mailgroup: off
1189 .br
1190 If set, \fIinc\fR is made set-group-id to this group name.
1191 Some SYS5 systems want this to be set to \*(lqmail\*(rq.
1192 Set this if your \fB/usr/spool/mail\fP is not world-writeable.
1193
1194 Note that \fBslocal\fP doesn't know how to deal with this,
1195 and will not work under these systems; just making it set-group-id
1196 will open a security hole.
1197 If you're using \*(lqmailgroup\*(rq,
1198 you should remove \fBslocal\fP (and its man page) from your system.
1199
1200 .ti -.5i
1201 signal: int
1202 .br
1203 The base type (int or void) of the function
1204 parameter/return value of \fIsignal\fR\|(2).
1205 The default is \fBint\fR.
1206 Set \*(lqsignal void\*(rq on systems which use this type
1207 (e.g., SYSTEM 5 V3.0 and later or Sun OS 4.0 and later).
1208
1209 .ti -.5i
1210 sprintf: char *
1211 .br
1212 The return value of the \fIsprintf\fR library routine.
1213 This defaults to \*(lqchar\0*\*(rq.  Set this to \*(lqint\*(rq if
1214 you have an older version of SYSTEM 5 which has this routine return an
1215 \*(lqint\*(rq type.
1216
1217 .ne 5
1218 .ti -.5i
1219 options:
1220 .br
1221 \&`\-D' options to \fIcc\fR\|(1).
1222 .sp
1223 .in +.25i
1224 .ti -.5i
1225 ALTOS
1226 .br
1227 Use on XENIX/v7 systems.
1228 Also, be sure to use \*(lqoptions V7\*(rq.
1229
1230 .ti -.5i
1231 ATTVIBUG
1232 .br
1233 This option causes
1234 \fIMH\fP to return to the \*(lqWhat now?\*(rq
1235 prompt if your initial editor is \fBvi\fP
1236 and it exits with non-zero status.
1237 Use on Sun OS 4.1 and other systems where the
1238 \fB/usr/ucb/vi\fP editor was changed to
1239 exit with its status equal to the number of pseudo-\*(lqerrors\*(rq
1240 encountered during the edit.  This causes a problem for programs that
1241 test the exit status of their editor and abort if the status is non-zero.
1242 (This includes \fIMH\fP and programs like \fB/usr/etc/vipw\fP).
1243
1244 .ti -.5i
1245 AUX
1246 .br
1247 Use with AUX systems.
1248
1249 .ti -.5i
1250 BIND
1251 .br
1252 If you are running with the BIND code on UNIX systems
1253 with TCP/IP sockets (e.g. 4.{2,3}BSD),
1254 be sure to define this.
1255
1256 .ti -.5i
1257 BSD41A
1258 .br
1259 Use on 4.1a Berkeley UNIX systems.
1260
1261 .ti -.5i
1262 BSD42
1263 .br
1264 Use on Berkeley UNIX systems on or after 4.2BSD.
1265
1266 .ti -.5i
1267 BSD43
1268 .br
1269 Use on 4.3 Berkeley UNIX systems.
1270 Also, be sure to use \*(lqoptions BSD42\*(rq.
1271 If \fIopenlog\fR\|(3) (see \*(lqman 3 syslog\*(rq)
1272 takes three arguments instead of two,
1273 and your \fIwrite\fR\|(1) command is set\-group\-id
1274 to group \*(lqtty\*(rq, use this option.
1275 If only one of these conditions is true, you lose.
1276
1277 .ti -.5i
1278 BSD44
1279 .br
1280 Use on Berkeley UNIX systems on or after 4.4BSD.
1281 Also, be sure to use \*(lqoptions BSD43\*(rq
1282 and \*(lqoptions BSD42\*(rq.
1283
1284 .ti -.5i
1285 DBMPWD
1286 .br
1287 Use this option if your \fIgetpwent\fR\|(3) routines read a 
1288 dbm database (such as with Yellow Pages) instead of doing
1289 a sequential read of \fB/etc/passwd\fR.
1290 Without DBMPWD the entire passwd file is read into
1291 memory one entry at a time for alias expansion.
1292 This is a performance improvement when reading
1293 a standard \fB/etc/passwd\fR file,
1294 but is \fIvery\fR slow on systems with a dbm database.
1295 At one site that runs
1296 YP on a large passwd file, it showed a 6:1 performance improvement.
1297
1298 .ti -.5in
1299 GCOS_HACK
1300 .br
1301 The so-called \*(lqgcos\*(rq field of the password file is 
1302 used as a last resort
1303 to find the user's full name (see \fImh-profile\fP\|(5) for details).
1304 Enable this option
1305 if your \fIpasswd\fP\|(5) man page notes that the `&'
1306 character in the \*(lqgcos\*(rq field stands for the login name.
1307
1308 .ti -.5i
1309 FCNTL
1310 .br
1311 Directs \fIMH\fP to use the \fBfcntl()\fP system call for kernel-level
1312 locking.  If you're using a SYS5 system, you may want
1313 this option.  (See also `FLOCK' and `LOCKF').
1314
1315 .ti -.5i
1316 FLOCK
1317 .br
1318 Directs \fIMH\fP to use the \fBflock()\fP system call for kernel-level
1319 locking.  If you're on a BSD42 system,
1320 and you're not using NFS to read or write maildrops,
1321 you should enable this option.  (See also `FCNTL' and `LOCKF').
1322
1323 .ti -.5i
1324 HESIOD
1325 .br
1326 Support for HESIOD.  
1327 This code was contributed, and included no documentation.
1328
1329 .ti -.5i
1330 LOCKF
1331 .br
1332 Directs \fIMH\fP to use the \fBlockf()\fP system call for kernel-level
1333 locking.  If you're using NFS to read or
1334 write maildrops, you should enable this option.  (See also `FLOCK'
1335 and `FCNTL').
1336
1337 .ti -.5i
1338 locname
1339 .br
1340 Hard-wires the local name for the host \fIMH\fR is running on.
1341 For example, locname='\*(lqPICKLE\*(rq'.
1342 It's probably better to either let UNIX tell \fIMH\fR this information,
1343 or to put the information in the host specific \fBmtstailor\fR file.
1344
1345 .ti -.5i
1346 MORE
1347 .br
1348 Defines  the location of the \fImore\fR\|(1) program.
1349 On ALTOS and DUAL systems, set
1350 MORE='\*(lq/usr/bin/more\*(rq'.
1351 The default is \*(lq/usr/ucb/more\*(rq.
1352
1353 .ti -.5i
1354 NDIR
1355 .br
1356 For non-Berkeley UNIX systems,
1357 this \fIMH\fR will try to find the new directory access mechanism by looking
1358 in \fB<ndir.h>\fR if this option is given.
1359 Otherwise, \fIMH\fR will try \fB<dir.h>\fR.
1360 If you still can't get this to work on your system,
1361 edit \fBh/local.h\fR as appropriate.
1362 (See also `SYS5DIR'.)
1363
1364 .ti -.5i
1365 NFS
1366 .br
1367 Tells \fIMH\fR to hack around a problem in the NFS C library.
1368 If you get an undefined symbol \*(lqruserpass\*(rq when compiling
1369 \fIMH\fP, you probably need this option.  If, however, you include this
1370 option and get an undefined symbol \*(lq\(ru\^\(ruruserpass\*(rq
1371 when compiling, then you should omit this option.
1372 (See also `NORUSERPASS'.)
1373
1374 .ti -.5i
1375 NOIOCTLH
1376 .br
1377 Tells \fIMH\fR not to include the file \fB<sys/ioctl.h>\fR.
1378 To be used on systems where this file is not present.
1379
1380 .ti -.5i
1381 NORUSERPASS
1382 .br
1383 Tells \fIMH\fR that your system doesn't have the
1384 \fIruserpass\fP\|(3) routine;
1385 \fIMH\fR will include its own copy of this
1386 routine in its library.
1387 (See also `NFS'.)
1388
1389 .ti -.5i
1390 NTOHLSWAP
1391 .br
1392 Tells \fIMH\fR to use the \fBntohl()\fR macro when processing
1393 \fImsh\fR binary map files.  \fIMH\fR can use this macro on
1394 systems with the include file \fBnetinet/in.h\fR,
1395 to byte-swap the binary information in these map files.
1396 If you're using the same map files on machines of different
1397 architectures, enable this option.
1398
1399 .ti -.5i
1400 RENAME
1401 .br
1402 Include this option if your system has a \fBrename()\fP library
1403 call.  This is true on BSD42 and newer and some SYS5 systems.
1404
1405 .ti -.5i
1406 SENDMAILBUG
1407 .br
1408 Causes SMTP reply code 451 (failure)
1409 to be considered the same as code 250 (OK).
1410 Since this might cause problems, only
1411 enable this if you are certain that your SendMail will
1412 return this code even when it doesn't mean to indicate a failure.
1413
1414 .\" .ti -.5i
1415 .\" SMTP_ONEX
1416 .\" .br
1417 .\" Causes \fIMH\fP to give the \*(lqONEX\*(rq SMTP command
1418 .\" when posting mail (a SendMail performance hack).
1419 .\" Useful only if you're running a SendMail
1420 .\" which will successfully reset with the \*(lqRSET\*(rq command
1421 .\" after seeing the \*(lqONEX\*(rq command;
1422 .\" otherwise, if you enable this 
1423 .\" you may have problems posting messages with \*(lqBCCs\*(rq.
1424 .\" 
1425 .ti -.5i
1426 SOCKETS
1427 .br
1428 Indicates the availability of a socket interface
1429 for TCP/IP networking that is compatible with 4.{2,3}BSD UNIX.
1430 It is not necessary to define this when BSD42 is already defined,
1431 but it might be useful for SYSTEM 5 or HPUX systems with TCP/IP sockets.
1432
1433 .ti -.5i
1434 SUN40
1435 .br
1436 Use on Sun OS 4.0 (and later?) systems.  You also will need
1437 \*(lqoptions BSD42\*(rq, \*(lqoptions BSD43\*(rq, and
1438 \*(lqsignal void\*(rq.
1439
1440 If you're using Sun's brain-damaged approach to offering Domain
1441 Name Service through NIS, be sure to include
1442 \*(lqoptions BIND\*(rq and
1443 \*(lqldoptions \-lresolv\*(rq to work around some NIS/DNS bugs.
1444
1445 .ti -.5i
1446 SYS5
1447 .br
1448 Use on AT&T SYSTEM 5 R3 (and newer?) UNIX systems.  See also \fImailgroup\fR.
1449
1450 .ti -.5i
1451 SYS5DIR
1452 .br
1453 Define this if your system uses \*(lqstruct dirent\*(rq
1454 instead of \*(lqstruct direct\*(rq.
1455 This is true of System V Release 3.0 and later.
1456 Uses include file \fB<dirent.h>\fR
1457 and the routines \fImkdir\fR, \fIrmdir\fR and \fIgetcwd\fR.
1458
1459 .ti -.5i
1460 SVR4
1461 .br
1462 Use on AT&T SYSTEM 5 R4 (and newer?) UNIX systems. You should 
1463 also include \*(lqoptions SYS5\*(rq and \*(lqoptions SYS5DIR\*(rq.
1464 See also \fImailgroup\fR.
1465 You will also need to include \*(lqoldload none\*(rq if your \fBld\fP
1466 doesn't handle `\-x\0\-r' correctly.
1467
1468 .ti -.5i
1469 TERMINFO
1470 .br
1471 Define TERMINFO if you have it.
1472 You get it automatically if you're running SYS5, and you don't get
1473 it if you're not.  (If you're not SYS5, you probably have termcap.)
1474
1475 .ti -.5i
1476 TZNAME
1477 .br
1478 Use time zone names from the \fItzname\fR variable, set via \fItzset\fR.
1479 Only applicable on SYSTEM 5 systems and only effective when you have
1480 asked for alpha\-timezones (see the ATZ option).  See also ZONEINFO.
1481
1482 .ti -.5i
1483 UNISTD
1484 .br
1485 Include this option if your system has the file \fB<unistd.h>\fP.
1486 If not specified, the LOCKF option will include \fB<sys/fcntl.h>\fP.
1487
1488 .ti -.5i
1489 V7
1490 .br
1491 Use on V7 UNIX systems.
1492 Also, be sure to use \*(lqoptions void=int\*(rq.
1493
1494 .ti -.5i
1495 VSPRINTF
1496 .br
1497 Include this option if your system has the \fIvsprintf\fP\|(3)
1498 library routine; otherwise, \fI\(rudoprnt\fP\|(3) will be used.
1499
1500 .ti -.5i
1501 WAITINT
1502 .br
1503 BSD42 based systems call the \fIwait\fP\|(2)
1504 system routine with a pointer to type \fIunion wait\fP.
1505 Include this option if you included \*(lqoptions BSD42\*(rq, but
1506 your system calls the \fIwait\fP\|(2)
1507 system routine with a pointer to type \fIint\fP
1508 (the non-BSD42 default).
1509
1510 .ti -.5i
1511 ZONEINFO
1512 .br
1513 Specify this if you have a BSD43 based system that keeps time zone
1514 information /etc/zoneinfo or /usr/lib/zoneinfo (SunOS),
1515 and where 
1516 the \fIstruct tm\fP 
1517 returned by \fIlocaltime\fP\|(3) contains a \fItm_gmtoff\fP element
1518 (see \fB/usr/include/time.h\fP).
1519 With this fix the GMT offset specified in outgoing mail
1520 will be corrected when the TZ enviornment variable is set
1521 to a different time zone.  See also TZNAME.
1522 .in -.25i
1523
1524 .Uh "Site Preferences"
1525 .br
1526 .in -.5i
1527 These options change the
1528 default behavior of \fIMH\fP or enable optional features.
1529 Add the options which are appropriate for your configuration 
1530 or your site preferences.
1531 .in +.5i
1532
1533 .ti -.5i
1534 editor: prompter
1535 .br
1536 The default editor for \fIMH\fR.
1537
1538 .ne 5
1539 .ti -.5i
1540 options:
1541 .br
1542 \&`\-D' options to \fIcc\fR\|(1).
1543 .sp
1544 .in +.25i
1545 .ne 4
1546 .ti -.5i
1547 ATZ
1548 .br
1549 Directs \fIMH\fR to use alpha\-timezones whenever possible.
1550 You should not use this option if you are on the Internet,
1551 since it will make your host non-compliant with RFC-1123
1552 (Requirements for Internet Hosts).
1553
1554 .ti -.5i
1555 ATHENA
1556 .br
1557 Makes \fIrepl\fR `\-nocc\0all' the default instead of `\-cc\0all'.
1558 You may want to enable this if you're using \fIxmh\fR.
1559
1560 .ti -.5i
1561 BANG
1562 .br
1563 Directs \fIMH\fR to favor `!' over `@@' in addressing.
1564
1565 .ti -.5i
1566 BERK
1567 .br
1568 Optional for for 4.{2,3}BSD sites running SendMail.
1569 Disables nearly all of the RFC822 address and header-parsing routines
1570 in favor of recognizing such formats as ASCnet, and so on.
1571 If you don't need to disable the parser for this reason,
1572 you probably want to use \*(lqoptions DUMB\*(rq instead.
1573
1574 .ti -.5i
1575 COMPAT
1576 .br
1577 If you previously ran a version of \fIMH\fR earlier than mh.4 use this option.
1578 After a short grace period,
1579 remove it and re-{configure,generate,install} everything.
1580
1581 .ti -.5i
1582 DUMB
1583 .br
1584 Directs \fIMH\fR not to try and rewrite addresses to their 
1585 \*(lqofficial\*(rq form.
1586
1587 .ti -.5i
1588 FOLDPROT
1589 .br
1590 Defines the octal value for default folder-protection.
1591 For example, FOLDPROT='\^\*(lq0700\*(rq\^'.
1592 The default is \*(lq0711\*(rq.
1593
1594 .ti -.5i
1595 ISI
1596 .br
1597 When using \*(lqrepl\0\-ccme\*(rq,
1598 only \*(lqcc:\*(rq the first address found which belongs to the user;
1599 any other \fIAlternate-Mailboxes\fR do not receive \*(lqcc:\*(rqs.
1600
1601 .ti -.5i
1602 LINK
1603 .br
1604 Defines the filename for alternate file name for \fIdist\fR and \fIrepl\fR.
1605 For example, LINK='\^\*(lq\^\\\^\\\^043\*(rq\^'
1606 to use the pound\-sign character.
1607 The default is \*(lq@@\*(rq.
1608
1609 .ti -.5i
1610 MHE
1611 .br
1612 Enables crude support for Brien Reid's MHE interface.
1613 Recommended for use with the GNU Emacs mh-e package.
1614
1615 .ti -.5i
1616 MHRC
1617 .br
1618 Enables \fIMH\fR to recognize the \fICShell\fR's `~'\-construct.
1619 This is useful for sites that run with a ~/.mhrc for their users.
1620
1621 .ti -.5i
1622 MIME
1623 .br
1624 Enables support for multi-media messages,
1625 as specified in RFC 1341 \-\- a major win.
1626 This allows you to include things like audio,
1627 graphics, and the like, in your mail messages.
1628 Several \fIMH\fP commands are extended to support these multi-media
1629 messages,
1630 and the \fImhn\fR command is provided to encode and decode
1631 \fBMIME\fP messages.
1632 For more details, see \fBmiscellany/multi-media/READ-ME\fP
1633 and \fImhn\fR\|(1).
1634
1635 .ti -.5i
1636 MSGID
1637 .br
1638 Enables \fBslocal\fP to detect and surpress duplicate messages received.
1639 This code uses the \fB<ndbm.h>\fP library,
1640 and requires \*(lqoptions BSD42\*(rq since
1641 it uses the \fIflock\fP\|(2) system call for locking.
1642 (Note that this means its database locking does not work over NFS.)
1643 It has only been tested under SUN40.
1644
1645 .ti -.5i
1646 MSGPROT
1647 .br
1648 Defines the octal value for default folder-protection.
1649 For example, MSGPROT='\^\*(lq0600\*(rq\^'.
1650 The default is \*(lq0644\*(rq.
1651
1652 .ti -.5i
1653 NOMHSEQ
1654 .br
1655 Directs \fIMH\fR to make private sequences the default.
1656
1657 .ti -.5i
1658 OVERHEAD
1659 .br
1660 Enable \fIMH\fR commands to read profile/context from open fd:s
1661 without doing an open(); see \fImh-profile\fP\|(5) for the details.
1662
1663 .ti -.5i
1664 RPATHS
1665 .br
1666 Directs \fIinc\fR to note UNIX \*(lqFrom\ \*(rq lines as Return-Path: info.
1667
1668 .ti -.5i
1669 SBACKUP
1670 .br
1671 Defines the prefix string for backup file names.
1672 For example, SBACKUP='\^\*(lq\^\\\^\\\^043\*(rq\^'.
1673 The default is \*(lq,\*(rq.
1674
1675 .ti -.5i
1676 TMA
1677 .br
1678 Support for the TTI \fItrusted mail agent\fR (TMA).
1679 Although the TTI TMA is \fBnot\fR in the public domain,
1680 the \fIMH\fR support for the TTI TMA \fBis\fR in the public domain.
1681 You should enable this option only if you are licensed to run the TMA
1682 software
1683 (otherwise, you don't have the software in your \fIMH\fR source tree).
1684
1685 .ti -.5i
1686 TTYD
1687 .br
1688 Support for TTYD.  This is no longer in wide use, and is not recommended.
1689
1690 .ti -.5i
1691 UCI
1692 .br
1693 First, \*(lq_\*(rq and \*(lq#\*(rq are recognized as the prefixes for
1694 scratch files.
1695 Second, support for the UCI group\-leadership mechanism is enabled in
1696 \fIconflict\fR.
1697 Third, the first line of the file
1698 file \fB$HOME/.signature\fR is used as the \fIFull Name\fR part
1699 of your \*(lqFrom:\*(rq header.
1700 This may conflict with the interpretation of this file by \fINews\fR.
1701 If you're not at UCI, you probably don't want this option.
1702
1703 .ti -.5i
1704 UK
1705 .br
1706 Directs the \fIscan\fR program to generate UK-style dates by default.
1707
1708 .ti -.5i
1709 WHATNOW
1710 .br
1711 Enable certain \fIMH\fR commands to act differently when $mhdraft set.
1712
1713 .ti -.5i
1714 YEARMOD
1715 .br
1716 This option makes the \fImh-format\fP \fB%(year)\fP function
1717 always return a value less than 100.
1718 Enable this option if you have local \fImh-format\fP\|(5) files
1719 which cannot handle 4-digit years.
1720 You should convert these files to use a 4-character field width,
1721 or use the \fB%(modulo 100)\fP function to obtain a 2-digit year value.
1722 After a short grace period,
1723 remove `YEARMOD' and re-{configure,generate,install} everything.
1724 .in -.25i
1725
1726 .Uh "Testing/debugging"
1727 .ti -.5i
1728 debug: off
1729 .br
1730 Support for debug mode of \fIMH\fR.
1731 Don't use this unless you know what you're doing,
1732 which isn't likely if you're reading this document!
1733
1734 .ti -.5i
1735 regtest: off
1736 .br
1737 Set this to \*(lqon\*(rq
1738 if you are doing regression testing among different
1739 compilations of \fIMH\fP, and you do not want the hostname
1740 and compile date included in \fIMH\fP binaries.  
1741
1742 .sp
1743 .in -.5i
1744 .PP
1745 Now edit \fBconf/config/mtstailor\fR,
1746 depending on your choice of the setting
1747 for mts in the \fIMH\fR configuration file.
1748 for an mts setting of \*(lqmh\*(rq,
1749 look at the file \fBconf/tailor/mhmts\fR;
1750 for an mts setting of \*(lqsendmail\*(rq, \*(lqsendmail/smtp\*(rq,
1751 \*(lqmmdf/smtp\*(rq, or \*(lqmmdf2/smtp\*(rq,
1752 look at the file \fBconf/tailor/sendmts\fR;
1753 and,
1754 for an mts setting of \*(lqmmdf\*(rq, or  \*(lqmmdf2\*(rq,
1755 look at the file \fBconf/tailor/mmdf\fR.
1756 .PP
1757 Now install the configured files into the source areas.  (On SYS5
1758 systems, or other systems where you get complaints about
1759 \*(lq_index\*(rq and \*(lq_rindex\*(rq being undefined,
1760 you should use \*(lqmake sys5\*(rq to compile mhconfig.)
1761 .sp 1
1762 .nf
1763 % make
1764 % ./mhconfig MH
1765 .fi
1766 .PP
1767 \fBBefore proceeding\fP,
1768 you should familiarize yourself with the \fIAdministrator's Guide\fR.
1769 To generate an \fInroff\fR version, go to the doc/ directory
1770 and type:
1771 .sp 1
1772 .nf
1773 % (cd ../doc/; make ADMIN.doc)
1774 .fi
1775 .sp
1776 .PP
1777 If you're already running \fIMH\fR at your site,
1778 you should also read the \fImh\fR changes document \fBCHANGES\fP.
1779 The source is in \fBpapers/changes/\fR.
1780 .PP
1781 After reading the \fIAdministrator's Guide\fR, you may decide
1782 to change your MH configuration.  If so, cd back to the \fBconf/\fP
1783 directory, re-edit the files \fBMH\fP
1784 and \fBconf/config/mtstailor\fR, and re-run \fImhconfig\fP.
1785 .PP
1786 You now proceed based on your choice of a transport system
1787 (the setting for mts above).
1788 The best interface is achieved with \*(lqsendmail\*(rq
1789 followed by \*(lqmmdf\*(rq or (\*(lqmmdf2\*(rq),
1790 and then \*(lqmh\*(rq (stand\-alone delivery, not recommended).
1791 .SS SENDMAIL
1792 If you have not enabled BBoards or POP
1793 then no further MTS\-specific action is required on your part!
1794
1795 If you have enabled POP, but you 
1796 want to let \fISendMail\fP deliver mail POP mail using its
1797 standard delivery program \fB/bin/mail\fP,
1798 then, again, no further MTS\-specific action is required on your part!
1799
1800 Otherwise,
1801 go to the mts/sendmail/ directory.
1802 .sp 1
1803 .nf
1804 % cd ../mts/sendmail/
1805 .fi
1806 .sp 1
1807 This directory contains files whose definitions correspond to the
1808 configuration of your \fISendMail\fR system.
1809 If you have enabled BBoards or POP service,
1810 then you will need to re\-configure \fISendMail\fR.
1811 First, in the \*(lqlocal info\*(rq section of your site's
1812 \fISendMail\fR configuration file,
1813 choose a free macro/class (B is used in this distribution),
1814 and add these lines:
1815 .sp 1
1816 .in +.5i
1817 .nf
1818 # BBoards support
1819 DBbboards
1820 CBbboards
1821 .fi
1822 .in -.5i
1823 .sp 1
1824 Second, immediately after the inclusion of the zerobase file,
1825 in the \*(lqmachine dependent part of ruleset zero\*(rq section,
1826 add these lines:
1827 .sp 1
1828 .in +.5i
1829 .nf
1830 # resolve names for the BBoards system
1831 R$+<@@$=B>              $#bboards$@@$2$:$1              topic@@bboards
1832 .fi
1833 .in -.5i
1834 .sp 1
1835 Be sure to use tabs when separating these fields.
1836 Third, add the line
1837 .sp 1
1838 .in +.5i
1839 .nf
1840 include(bboardsMH.m4)
1841 .fi
1842 .in -.5i
1843 .sp 1
1844 after the line
1845 .sp 1
1846 .in +.5i
1847 .nf
1848 include(localm.m4)
1849 .fi
1850 .in -.5i
1851 .sp 1
1852 in your site's \fISendMail\fR configuration file.
1853 Finally, you should link the file \fBmts/sendmail/bboardsMH.m4\fR into your
1854 \fISendMail\fR cf/ directory and re\-configure \fISendMail\fR.
1855 .PP
1856 If you have enabled POP service,
1857 a similar procedure must be used on the POP service host,
1858 to re\-configure \fISendMail\fR.
1859 First, in the \*(lqlocal info\*(rq section of your site's
1860 \fISendMail\fR configuration file,
1861 choose a free macro/class (P is used in this distribution),
1862 and add these lines:
1863 .sp 1
1864 .in +.5i
1865 .nf
1866 # POP support
1867 DPpop
1868 CPpop
1869 .fi
1870 .in -.5i
1871 .sp 1
1872 Second, immediately after the inclusion of the zerobase file,
1873 in the \*(lqmachine dependent part of ruleset zero\*(rq section,
1874 add these lines:
1875 .sp 1
1876 .in +.5i
1877 .nf
1878 # resolve names for the POP system
1879 R$+<@@$=P>              $#pop$@@$2$:$1                  subscriber@@pop
1880 .fi
1881 .in -.5i
1882 .sp 1
1883 Be sure to use tabs when separating these fields.
1884 Third, add the line
1885 .sp 1
1886 .in +.5i
1887 .nf
1888 include(popMH.m4)
1889 .fi
1890 .in -.5i
1891 .sp 1
1892 after the line
1893 .sp 1
1894 .in +.5i
1895 .nf
1896 include(localm.m4)
1897 .fi
1898 .in -.5i
1899 .sp 1
1900 in your site's \fISendMail\fR configuration file.
1901 Finally, you should link the file \fBmts/sendmail/popMH.m4\fR into your
1902 \fISendMail\fR cf/ directory and re\-configure \fISendMail\fR.
1903 .SS MMDF
1904 If you want \fIMMDF\fR to be your transport service,
1905 and have \fBNOT\fR specified \*(lqmmdf/smtp\*(rq (or \*(lqmmdf2/smtp\*(rq)
1906 as your mts setting,
1907 then go to the mmdf/ directory.
1908 (If you're using \*(lqmmdf/smtp\*(rq or \*(lqmmdf2/smtp\*(rq
1909 as your mts setting, then skip to the next section.)
1910 .sp 1
1911 .nf
1912 % cd ../mts/mmdf/
1913 .fi
1914 .sp 1
1915 This directory contains files whose definitions correspond to the
1916 configuration of your \fIMMDF\fR system.
1917 .PP
1918 If you're running \fIMMDF\-I\fR,
1919 then copy the following files from wherever you keep the \fIMMDF\fR sources
1920 to this directory: mmdf/h/ch.h, mmdf/h/conf.h, utildir/conf_util.h,
1921 utildir/ll_log.h, mmdf/h/mmdf.h, utildir/util.h, mmdf/mmdf_lib.a,
1922 and utildir/util_lib.a.
1923 .PP
1924 If you're running \fIMMDF\-II\fR,
1925 then copy the following files from where you keep the \fIMMDF\fR sources
1926 to this directory: h/ch.h, h/conf.h, h/dm.h, h/ll_log.h, h/mmdf.h, h/util.h,
1927 and lib/libmmdf.a
1928 .PP
1929 If you have enabled bboards,
1930 then the directories \fBsupport/bboards/mmdfI\fR
1931 and \fBsupport/bboards/mmdfII\fR
1932 contain information you'll need to
1933 put a UCI BBoards channel in your \fIMMDF\fR configuration.
1934 Similarly, if you have enabled option \*(lqmf\*(rq and are
1935 running \fIMMDF\-I\fR,
1936 then the \fBzotnet/mf/mmdfI/\fR directory contains information you'll need to
1937 put a \fIUUCP\fR channel in your \fIMMDF\-I\fR configuration.
1938 Finally, the directory \fBsupport/pop/mmdfII\fR contains information you'll
1939 need to put a POP channel in your \fIMMDF\-II\fR configuration.
1940 .PP
1941 Note that \fIMMDF\-II\fR is distributed with the BBoards channel,
1942 although the version in the \fIMH\fR distribution might be more current,
1943 the version in the \fIMMDF\-II\fR distribution has been tested with that
1944 revision of \fIMMDF\fR.
1945 .SS MMDF/SMTP
1946 If you are using \*(lqmmdf/smtp\*(rq as your mts setting,
1947 then no further MTS\-specific action is required on your part!
1948 .SS MMDF2/SMTP
1949 If you are using \*(lqmmdf2/smtp\*(rq as your mts setting,
1950 then no further MTS\-specific action is required on your part!
1951 .SS "STAND\-ALONE DELIVERY"
1952 If, instead, you want \fIMH\fR to handle its own mail delivery,
1953 then no further MTS\-specific action is required on your part!
1954 .SH GENERATION
1955 Go to the \fIMH\fP top-level directory and generate the system.
1956 .sp 1
1957 .nf
1958 % cd ../; make
1959 .fi
1960 .PP
1961 This will cause a complete generation of the \fIMH\fR system.
1962 If all goes well, proceed with installation.
1963 If not, complain, as there \*(lqshould be no problems\*(rq at this step.
1964 .SH INSTALLATION
1965 If the directories you chose for the user\-programs,
1966 support\-programs and manuals
1967 (\*(lqbin\*(rq, \*(lqetc\*(rq, \*(lqpopdir\*(rq, \*(lqslibdir\*(rq,
1968 and \*(lqmandir\*(rq in the \fBconf/MH\fR file)
1969 don't exist,
1970 you should create them at this point.
1971 .PP
1972 Next, if you enabled support for the UCI BBoards facility,
1973 then create a login
1974 called \*(lqbboards\*(rq with the following characteristics:
1975 home directory is \fB/usr/spool/bboards/\fR with mode 755
1976 (actually, use the value for \*(lqbbhome\*(rq given in the \fIMH\fR
1977 configuration file),
1978 login shell is \fB/bin/csh\fR (or \fB/bin/sh\fR),
1979 and, encrypted password field is \*(lq*\*(rq.
1980 The \*(lqbboards\*(rq login should own the \fB/usr/spool/bboards/\fR
1981 directory.
1982 In addition to creating \fB/usr/spool/bboards/\fR,
1983 also create \fB/usr/spool/bboards/etc/\fR
1984 and \fB/usr/spool/bboards/archive/\fR.
1985 These directories should also be owned by the \*(lqbboards\*(rq login.
1986 .PP
1987 If you enabled support for POP,
1988 then on the POP service host,
1989 create a login called \*(lqpop\*(rq with the following characteristics:
1990 home directory is \fB/usr/spool/pop/\fR with mode 755,
1991 login shell is \fB/bin/csh\fR,
1992 and, encrypted password field is \*(lq*\*(rq.
1993 If you don't have \fB/bin/csh\fR on your system (V7),
1994 then \fB/bin/sh\fR is just fine.
1995 The \*(lqpop\*(rq login should own the \fB/usr/spool/pop/\fR directory.
1996 You'll also need to add a line to the \fB/etc/services\fR file and the
1997 \fB/etc/rc.local\fR file,
1998 see the \fIAdministrator's Guide\fR  for more details.
1999 .PP
2000 If this is not the first time you have installed \fIMH\fR,
2001 these files will need particular attention:
2002
2003 .nf
2004 .in +.5i
2005 .ta \w'VeryVeryBigDirectoryName  'u
2006 \fIDirectory\fR \fIFiles\fR
2007 \*(lqetc/\*(rq  MailAliases, BBoardAliases, mtstailor
2008 /usr/spool/bboards/     BBoards, \&.cshrc, \&.mh\(ruprofile
2009 /usr/spool/bboards/etc/ *
2010 .re
2011 .in -.5i
2012 .fi
2013 .PP
2014 The \fBMailAliases\fR, \fBBBoardAliases\fR, \fBmtstailor\fR and \fBBBoards\fR
2015 files will \fBNOT\fP be installed over existing copies;
2016 you will need to edit these by
2017 hand and merge in any changes from your previous \fIMH\fR release.
2018 The other files under \fB/usr/spool/bboards/\fR will be overwritten
2019 if they exist.
2020 You may wish to preserve your old versions of these before installing
2021 \fIMH\fR.
2022 .PP
2023 As the super-user, and from the mh.6/ directory, install the system.
2024 .sp 1
2025 .nf
2026 # make inst\-all
2027 .fi
2028 .sp 1
2029 This will cause the \fIMH\fR 
2030 processes and files to be transferred to the appropriate areas
2031 with the appropriate attributes.
2032 .SH TAILORING
2033 See the \fIAdministrator's Guide\fR for information on tailoring \fIMH\fR for
2034 the MTS, BBoards, and POP.
2035 .SH DOCUMENTATION
2036 In addition to this document,
2037 the \fIAdministrator's Guide\fP,
2038 and the \fIUser's Manual\fP,
2039 there are several documents referenced by the user's manual which may be
2040 useful.
2041 The sources for all of these can be found under the \fBpapers/\fR directory.
2042 .SH "OTHER THINGS"
2043 Consult the directory \fBmiscellany/\fR for the sources to a number of things
2044 which aren't part of the mainstream \fIMH\fR distribution,
2045 but which are still quite useful.
2046 .SH FILES
2047 Too numerous to mention.  Really.
2048 .SH "SEE ALSO"
2049 make(1)
2050 .SH BUGS
2051 The \fImhconfig\fR program should be smarter.
2052 .PP
2053 There's no way to print the \fIAdministrator's Guide\fP
2054 until after you have configured the system; it is difficult
2055 to configure the system without the \fIAdministrator's Guide\fP.
2056 .PP
2057 The Makefiles should know when \fImhconfig\fR has been run and force
2058 \*(lqmake clean\*(rq behavior.
2059 @
2060
2061
2062 2.118
2063 log
2064 @update for 6.8.4
2065 drop UUCP address, add HTTP address
2066 drop louie.udel.edu distribution site
2067 @
2068 text
2069 @d1 1
2070 a1 1
2071 .\" @@(#)$Id: mh-gen.8,v 2.117 1995/12/05 19:36:14 jromine Exp jromine $
2072 d53 1
2073 a53 1
2074 the \fBMH Home Pagef\fP on the World Wide Web at
2075 @
2076
2077
2078 2.117
2079 log
2080 @update distribution address
2081 @
2082 text
2083 @d1 1
2084 a1 1
2085 .\" @@(#)$Id: mh-gen.8,v 2.116 1994/11/17 16:10:10 jromine Exp jromine $
2086 d4 1
2087 a4 1
2088 .TH MH-GEN 8 MH.6.8.3 [mh.6]
2089 d51 4
2090 a54 3
2091 The current computer mailbox for \fIMH\fR is \fBBug\-MH@@ICS.UCI.EDU\fR
2092 (in the ARPA Internet),
2093 and \fB...!ucbvax!ucivax!bug\-mh\fR (UUCP).
2094 d69 1
2095 a69 1
2096 ftp.ics.uci.edu [128.195.1.1] and retrieve the file pub/mh/mh-6.8.tar.Z.
2097 d75 1
2098 a75 2
2099 This tar file is also available on louie.udel.edu 
2100 [128.175.1.3] in portal/mh-6.8.tar.Z.  You may also find MH on
2101 d78 1
2102 a78 1
2103 either ftp.ics.uci.edu or louie.udel.edu.
2104 @
2105
2106
2107 2.116
2108 log
2109 @change UCI phone prefix
2110 @
2111 text
2112 @d1 1
2113 a1 1
2114 .\" @@(#)$Id: mh-gen.8,v 2.115 1993/12/01 00:44:23 jromine Exp jromine $
2115 d94 2
2116 d97 1
2117 a97 3
2118 Office of Academic Computing
2119 360 Computer Science
2120 Irvine, CA  92717  USA
2121 @
2122
2123
2124 2.115
2125 log
2126 @update for 6.8.3
2127 @
2128 text
2129 @d1 1
2130 a1 1
2131 .\" @@(#)$Id: mh-gen.8,v 2.114 1993/09/01 21:25:42 jromine Exp jromine $
2132 d99 1
2133 a99 1
2134 +1 714 856 5153
2135 @
2136
2137
2138 2.114
2139 log
2140 @warn about re-editing mtstailor
2141 @
2142 text
2143 @d1 1
2144 a1 1
2145 .\" @@(#)$Id: mh-gen.8,v 2.113 1993/08/27 22:22:08 jromine Exp jromine $
2146 d4 1
2147 a4 1
2148 .TH MH-GEN 8 MH.6.8.2 [mh.6]
2149 @
2150
2151
2152 2.113
2153 log
2154 @recommend creating mandir, popdir and slibdir
2155 @
2156 text
2157 @d1 1
2158 a1 1
2159 .\" @@(#)$Id: mh-gen.8,v 2.112 1993/08/25 18:07:10 jromine Exp jromine $
2160 d1162 2
2161 a1163 2
2162 directory, re-edit the file \fBMH\fP, and re-run
2163 \fImhconfig\fP.
2164 @
2165
2166
2167 2.112
2168 log
2169 @update to MH 6.8.2
2170 @
2171 text
2172 @d1 1
2173 a1 1
2174 .\" @@(#)$Id: mh-gen.8,v 2.111 1993/08/20 19:47:56 jromine Exp jromine $
2175 d1344 4
2176 a1347 3
2177 If the directories you chose for the user\-programs and
2178 support\-programs
2179 (\*(lqbin\*(rq and \*(lqetc\*(rq in the \fBconf/MH\fR file)
2180 @
2181
2182
2183 2.111
2184 log
2185 @update version
2186 remove ONEX
2187 @
2188 text
2189 @d1 1
2190 a1 1
2191 .\" @@(#)$Id: mh-gen.8,v 2.110 1993/08/19 23:57:46 jromine Exp jromine $
2192 d4 1
2193 a4 1
2194 .TH MH-GEN 8 MH.6.8.1 [mh.6]
2195 @
2196
2197
2198 2.110
2199 log
2200 @note bsd44 manuals convention
2201 @
2202 text
2203 @d1 1
2204 a1 1
2205 .\" @@(#)$Id: mh-gen.8,v 2.109 1993/08/19 23:34:15 jromine Exp jromine $
2206 d4 1
2207 a4 1
2208 .TH MH-GEN 8 MH.6.8 [mh.6]
2209 d793 11
2210 a803 11
2211 .ti -.5i
2212 SMTP_ONEX
2213 .br
2214 Causes \fIMH\fP to give the \*(lqONEX\*(rq SMTP command
2215 when posting mail (a SendMail performance hack).
2216 Useful only if you're running a SendMail
2217 which will successfully reset with the \*(lqRSET\*(rq command
2218 after seeing the \*(lqONEX\*(rq command;
2219 otherwise, if you enable this 
2220 you may have problems posting messages with \*(lqBCCs\*(rq.
2221
2222 @
2223
2224
2225 2.109
2226 log
2227 @document SMTP_ONEX
2228 @
2229 text
2230 @d1 1
2231 a1 1
2232 .\" @@(#)$Id: mh-gen.8,v 2.108 1993/08/19 23:30:08 jromine Exp jromine $
2233 d195 1
2234 d209 2
2235 @
2236
2237
2238 2.108
2239 log
2240 @document SM_ONEX, GCOS_HACK
2241 @
2242 text
2243 @d1 1
2244 a1 1
2245 .\" @@(#)$Id: mh-gen.8,v 2.107 1993/06/03 17:54:12 jromine Exp jromine $
2246 d791 1
2247 a791 1
2248 SM_ONEX
2249 d794 6
2250 a799 3
2251 when posting mail.  Useful only if you're running a SendMail
2252 which can still reset with the \*(lqRSET\*(rq SMTP command
2253 after seeing the \*(lqONEX\*(rq command.
2254 @
2255
2256
2257 2.107
2258 log
2259 @document new "manuals: standard/cat" syntax
2260 @
2261 text
2262 @d1 1
2263 a1 1
2264 .\" @@(#)$Id: mh-gen.8,v 2.106 1993/02/26 19:00:51 jromine Exp jromine $
2265 d674 10
2266 d789 8
2267 @
2268
2269
2270 2.106
2271 log
2272 @add NORUSERPASS for 386BSD
2273 @
2274 text
2275 @d1 1
2276 a1 1
2277 .\" @@(#)$Id: mh-gen.8,v 2.105 1992/12/14 17:19:19 jromine Exp jromine $
2278 d197 6
2279 d206 2
2280 @
2281
2282
2283 2.105
2284 log
2285 @WAITINT option
2286 @
2287 text
2288 @d1 1
2289 a1 1
2290 .\" @@(#)$Id: mh-gen.8,v 2.104 1992/12/02 19:07:37 jromine Exp jromine $
2291 d649 2
2292 a650 1
2293 This code is still under development.
2294 d727 1
2295 a727 1
2296 \fIMH\fP, you need this option.  If, however, you include this
2297 d730 1
2298 d737 9
2299 @
2300
2301
2302 2.104
2303 log
2304 @update for release 6.8
2305 @
2306 text
2307 @d1 1
2308 a1 1
2309 .\" @@(#)$Id: mh-gen.8,v 2.103 1992/11/21 20:46:59 jromine Exp jromine $
2310 d836 9
2311 @
2312
2313
2314 2.103
2315 log
2316 @clarify restrictions on MSGID option
2317 @
2318 text
2319 @d1 1
2320 a1 1
2321 .\" @@(#)$Id: mh-gen.8,v 2.102 1992/11/19 18:09:59 jromine Exp jromine $
2322 d4 1
2323 a4 1
2324 .TH MH-GEN 8 MH.6.7.5beta [mh.6]
2325 d68 1
2326 a68 1
2327 ftp.ics.uci.edu [128.195.1.1] and retrieve the file pub/mh/mh-6.7.tar.Z.
2328 d70 1
2329 a70 1
2330 (approximately 1.5MB).  There should also be a \fBREADME\fR file in
2331 d75 1
2332 a75 1
2333 [128.175.1.3] in portal/mh-6.7.tar.Z.  You may also find MH on
2334 d118 1
2335 a118 1
2336 The distribution tape contains the hierarchy for the mh.6-7/ directory.
2337 d124 1
2338 a124 1
2339 % cd mh-6.7
2340 d1105 2
2341 a1106 2
2342 you should also read the \fImh.6\fR changes documents.
2343 The sources are in \fBpapers/mh6.5/\fR and \fBpapers/mh6.7/\fP.
2344 @
2345
2346
2347 2.102
2348 log
2349 @cleanup format
2350 @
2351 text
2352 @d1 1
2353 a1 1
2354 .\" @@(#)$Id: mh-gen.8,v 2.101 1992/11/19 17:45:16 jromine Exp jromine $
2355 d966 5
2356 a970 3
2357 This code requires the \fB<ndbm.h>\fP library, and has only been tested
2358 under SUN40.  It uses the \fIflock\fP\|(2) system call for locking,
2359 so its database locking does not work over NFS.
2360 @
2361
2362
2363 2.101
2364 log
2365 @add note about Solaris sharedlibs; format fixup
2366 @
2367 text
2368 @d1 1
2369 a1 1
2370 .\" @@(#)$Id: mh-gen.8,v 2.100 1992/11/16 22:35:55 jromine Exp jromine $
2371 d259 1
2372 a259 1
2373 Options given directly to \fIld\fR\|(1) (via \fIcc\fR\0) at the beginning
2374 d268 1
2375 a268 1
2376 Options given directly to \fIld\fR\|(1) (via \fIcc\fR\0) at the end of the
2377 d345 1
2378 a345 1
2379 If \*(lqpop\*(rq (formerly \*(lqpopbboards:\ on\*(rq),
2380 d347 1
2381 a347 1
2382 this setting requires \*(lqpop:\ on\*(rq.
2383 d533 1
2384 a533 1
2385 (e.g., \*(lqldoptions:\ \-L/usr/mh/lib\*(rq)
2386 d581 1
2387 a581 1
2388 This defaults to \*(lqchar\ *\*(rq.  Set this to \*(lqint\*(rq if
2389 d727 1
2390 a727 1
2391 option and get an undefined symbol \*(lq\(ru\(ruruserpass\*(rq
2392 d833 2
2393 a834 2
2394 Include this option if your system has the \fIvsprintf()\fP 
2395 library routine; otherwise, \fI\(rudoprnt()\fP will be used.
2396 d844 1
2397 a844 1
2398 returned by \fIlocaltime()\fP contains a \fItm_gmtoff\fP element
2399 d884 1
2400 a884 1
2401 Makes \fIrepl\fR `\-nocc\ all' the default instead of `\-cc\ all'.
2402 d918 1
2403 a918 1
2404 For example, FOLDPROT='\*(lq0700\*(rq'.
2405 d924 1
2406 a924 1
2407 When using \*(lqrepl\ \-ccme\*(rq,
2408 d932 2
2409 a933 1
2410 For example, LINK='\*(lq\\\\043\*(rq' to use the pound\-sign character.
2411 d952 1
2412 a952 1
2413 as specified in RFC 1341 -- a major win.
2414 d967 1
2415 a967 1
2416 under SUN40.  It uses the \fIflock\fP\|() system call for locking,
2417 d974 1
2418 a974 1
2419 For example, MSGPROT='\*(lq0600\*(rq'.
2420 d986 1
2421 a986 1
2422 without doing an open(); see mh-profile(5) for the details.
2423 d997 1
2424 a997 1
2425 For example, SBACKUP='\*(lq\\\\043\*(rq'.
2426 d1022 2
2427 a1023 2
2428 Third, the file \fB$HOME/.signature\fR is considered to contain 
2429 a single line of text which is used as the \fIFull Name\fR part
2430 d1031 1
2431 a1031 1
2432 Directs the \fIscan\fR program to generate UK-style dates.
2433 d1043 1
2434 a1043 1
2435 Enable this option if you have local \fImh-format\fP files
2436 d1048 1
2437 a1048 1
2438 remove it and re-{configure,generate,install} everything.
2439 d1361 2
2440 a1362 2
2441 the administrator's guide,
2442 and the user's manual,
2443 @
2444
2445
2446 2.100
2447 log
2448 @typo
2449 @
2450 text
2451 @d1 1
2452 a1 1
2453 .\" @@(#)$Id: mh-gen.8,v 2.99 1992/11/12 23:30:09 jromine Exp jromine $
2454 d204 1
2455 a204 1
2456 The location of the \fIchown\fR\0(8) on your system.
2457 d240 1
2458 a240 1
2459 Options given directly to \fIcc\fR\0(1).
2460 d250 2
2461 a251 2
2462 This should be the loader option required to load the \fItermcap\fR\0(3)
2463 and \fIcurses\fR\0(3) libraries on your system.
2464 d257 1
2465 a257 1
2466 ldoptions: -s
2467 d259 1
2468 a259 1
2469 Options given directly to \fIld\fR\0(1) (via \fIcc\fR\0) at the beginning
2470 d268 1
2471 a268 1
2472 Options given directly to \fIld\fR\0(1) (via \fIcc\fR\0) at the end of the
2473 d279 1
2474 a279 1
2475 lex: lex -nt
2476 d294 1
2477 a294 1
2478 Support for systems with \fIranlib\fR\0(1).
2479 d325 1
2480 a325 1
2481 \fImh\-tailor\fR\0(8) if you use this option.
2482 d394 1
2483 a394 1
2484 \&`\-D' options to \fIcc\fR\0(1).
2485 d420 1
2486 a420 1
2487 entries in the \fIpasswd\fR\0(5) file,
2488 d533 1
2489 a533 1
2490 (e.g., \*(lqldoptions: -L/usr/mh/lib\*(rq)
2491 d536 1
2492 a536 1
2493 You may need to run \fIldconfig\fP\0(8) manually whenever a new
2494 d538 1
2495 a538 1
2496 See \fIld\fR\0(1) for more information about using shared libraries.
2497 d540 7
2498 d572 1
2499 a572 1
2500 parameter/return value of \fIsignal\fR\0(2).
2501 d589 1
2502 a589 1
2503 \&`\-D' options to \fIcc\fR\0(1).
2504 d639 1
2505 a639 1
2506 If \fIopenlog\fR\0(3) (see \*(lqman 3 syslog\*(rq)
2507 d641 1
2508 a641 1
2509 and your \fIwrite\fR\0(1) command is set\-group\-id
2510 d654 1
2511 a654 1
2512 Use this option if your \fIgetpwent\fR\0(3) routines read a 
2513 d705 1
2514 a705 1
2515 Defines  the location of the \fImore\fR\0(1) program.
2516 d779 1
2517 a779 1
2518 \*(lqldoptions -lresolv\*(rq to work around some NIS/DNS bugs.
2519 d869 1
2520 a869 1
2521 \&`\-D' options to \fIcc\fR\0(1).
2522 d959 1
2523 a959 1
2524 and \fImhn\fR\0(1).
2525 @
2526
2527
2528 2.99
2529 log
2530 @add TERMINFO
2531 @
2532 text
2533 @d1 1
2534 a1 1
2535 .\" @@(#)$Id: mh-gen.8,v 2.98 1992/11/12 22:48:35 jromine Exp jromine $
2536 d430 1
2537 a430 1
2538 This code is still expiremental, but is available for 
2539 @
2540
2541
2542 2.98
2543 log
2544 @note advantages of MIME
2545 @
2546 text
2547 @d1 1
2548 a1 1
2549 .\" @@(#)$Id: mh-gen.8,v 2.97 1992/11/12 00:07:59 jromine Exp jromine $
2550 d796 7
2551 @
2552
2553
2554 2.97
2555 log
2556 @change option indentation
2557 @
2558 text
2559 @d1 1
2560 a1 1
2561 .\" @@(#)$Id: mh-gen.8,v 2.96 1992/11/12 00:04:00 jromine Exp jromine $
2562 d938 2
2563 @
2564
2565
2566 2.96
2567 log
2568 @not pitfalls of MSGID
2569 @
2570 text
2571 @d1 1
2572 a1 1
2573 .\" @@(#)$Id: mh-gen.8,v 2.95 1992/11/11 22:58:26 jromine Exp jromine $
2574 d396 1
2575 a396 1
2576 .in +.5i
2577 d492 1
2578 a492 1
2579 .in -.5i
2580 d584 1
2581 a584 1
2582 .in +.5i
2583 d835 1
2584 a835 1
2585 .in -.5i
2586 d857 1
2587 a857 1
2588 .in +.5i
2589 d1032 1
2590 a1032 1
2591 .in -.5i
2592 @
2593
2594
2595 2.95
2596 log
2597 @add slflags
2598 @
2599 text
2600 @d1 1
2601 a1 1
2602 .\" @@(#)$Id: mh-gen.8,v 2.94 1992/11/10 22:40:25 jromine Exp jromine $
2603 d523 1
2604 d858 1
2605 d949 3
2606 @
2607
2608
2609 2.94
2610 log
2611 @note MPOP requires bboards: pop
2612 add "signal: int", drop TYPESIG
2613 @
2614 text
2615 @d1 1
2616 a1 1
2617 .\" @@(#)$Id: mh-gen.8,v 2.93 1992/11/09 18:45:48 jromine Exp jromine $
2618 d512 5
2619 @
2620
2621
2622 2.93
2623 log
2624 @document YEARMOD
2625 @
2626 text
2627 @d1 1
2628 a1 1
2629 .\" @@(#)$Id: mh-gen.8,v 2.92 1992/11/06 19:29:16 jromine Exp jromine $
2630 d447 1
2631 a447 1
2632 This option is incompatible with \*(lqbboards: nntp\*(rq.
2633 d500 1
2634 a500 1
2635 The \*(lqMPOP\*(rq option is incompatible with \*(lqbboards: nntp\*(rq.
2636 d556 9
2637 d761 1
2638 a761 1
2639 \*(lqoptions TYPESIG=void\*(rq.
2640 a789 10
2641
2642 .ti -.5i
2643 TYPESIG
2644 .br
2645 Defines the base type (int or void) of the functions
2646 being parameter/return value of \fIsignal\fR\0(2).
2647 The default is \fBint\fR.
2648 Set TYPESIG='void' on systems which use this type
2649 (e.g., SYSTEM 5 V3.0 and later or Sun OS 4.0 and later);
2650 otherwise, set TYPESIG='int'.
2651 @
2652
2653
2654 2.92
2655 log
2656 @add AUX
2657 @
2658 text
2659 @d1 1
2660 a1 1
2661 .\" @@(#)$Id: mh-gen.8,v 2.91 1992/11/06 01:06:04 jromine Exp jromine $
2662 d1011 12
2663 @
2664
2665
2666 2.91
2667 log
2668 @typos
2669 no MTS-specific action with sendmail unless bboards or pop
2670 put BERK in preferences list
2671 @
2672 text
2673 @d1 1
2674 a1 1
2675 .\" @@(#)$Id: mh-gen.8,v 2.90 1992/11/06 00:47:31 jromine Exp jromine $
2676 d589 5
2677 @
2678
2679
2680 2.90
2681 log
2682 @major changes to put "options" into sections
2683 @
2684 text
2685 @d1 1
2686 a1 1
2687 .\" @@(#)$Id: mh-gen.8,v 2.89 1992/11/05 19:25:27 jromine Exp jromine $
2688 d534 1
2689 a534 1
2690 .Uh "System Dependencies"
2691 a590 9
2692 BERK
2693 .br
2694 Optional for for 4.{2,3}BSD sites running SendMail.
2695 Disables nearly all of the RFC822 address and header-parsing routines
2696 in favor of recognizing such formats as ASCnet, and so on.
2697 If you don't need to disable the parser for this reason,
2698 you probably want to use \*(lqoptions DUMB\*(rq instead.
2699
2700 .ti -.5i
2701 d868 9
2702 d925 2
2703 a926 1
2704 Enables support for multi-media messages, as specified in RFC 1341.  
2705 d937 1
2706 a937 3
2707 Enables \fBslocal\fP to detect and surpress duplicate
2708 messages received.  It doesn't hurt to enable this option whether
2709 or not you intend to make use of the duplicate surpression capability.
2710 d942 1
2711 a942 1
2712 Defines the octal value for default folder-protection
2713 d1022 1
2714 a1022 1
2715 and compile date included in \fIMH\fP execuatbles.  
2716 d1057 1
2717 a1057 8
2718 .sp 1
2719 To generate a \fItroff\fR version, type
2720 .sp 1
2721 .nf
2722 % (cd ../doc/; make guide)
2723 .fi
2724 .sp 1
2725 instead.
2726 d1074 10
2727 a1083 2
2728 If you want \fISendMail\fR to transport messages for \fIMH\fR,
2729 then go to the mts/sendmail/ directory.
2730 d1232 1
2731 a1232 1
2732 then no futher MTS\-specific action is required on your part!
2733 d1235 1
2734 a1235 1
2735 then no futher MTS\-specific action is required on your part!
2736 @
2737
2738
2739 2.89
2740 log
2741 @add "ln".
2742 update "mailgroup" docs to mention slocal.
2743 @
2744 text
2745 @d1 1
2746 a1 1
2747 .\" @@(#)$Id: mh-gen.8,v 2.88 1992/11/05 17:20:40 jromine Exp jromine $
2748 d4 1
2749 a4 1
2750 .TH MH-GEN 8 MH [mh.6]
2751 a201 5
2752 popdir: /usr/etc
2753 .br
2754 The directory where the POP daemon (\fBpopd\fP) will be installed.
2755
2756 .ti -.5i
2757 a303 56
2758 .Uh "Shared libraries"
2759 .ti -.5i
2760 sharedlib: off
2761 .br
2762 If \*(lqsun4\*(rq,
2763 makes libmh.a into a SunOS 4.0 (and later) shared library.
2764 If you enable this, be sure to also use \*(lqoptions SUN40\*(rq.
2765
2766 .ti -.5i
2767 slibdir: /usr/local/lib
2768 .br
2769 The directory where the \fIMH\fP shared library should go.
2770
2771 .ti -.25i
2772 Under SunOS (sun4)
2773 .br
2774 Since some \fIMH\fP programs are setuid, they'll only look for
2775 the library in \*(lqtrusted\*(rq locations.  Putting the library
2776 somewhere besides \fB/usr/lib\fP or \fB/usr/local/lib\fP is not advisable.
2777
2778 If you \fBmust\fP do this, be sure that you add the 
2779 path given by \fBslibdir\fP to the compiler's library search list 
2780 (e.g., \*(lqldoptions: -L/usr/mh/lib\*(rq)
2781 and make sure the path starts with a leading `/'.
2782
2783 You may need to run \fIldconfig\fP\0(8) manually whenever a new
2784 shared object is installed on the system.
2785 See \fIld\fR\0(1) for more information about using shared libraries.
2786
2787 .Uh "Other system dependencies"
2788 .ti -.5i
2789 editor: prompter
2790 .br
2791 The default editor for \fIMH\fR.
2792
2793 .ti -.5i
2794 mailgroup: off
2795 .br
2796 If set, \fIinc\fR is made set-group-id to this group name.
2797 Some SYS5 systems want this to be set to \*(lqmail\*(rq.
2798 Set this if your \fB/usr/spool/mail\fP is not world-writeable.
2799
2800 Note that \fBslocal\fP doesn't know how to deal with this,
2801 and will not work under these systems; just making it set-group-id
2802 will open a security hole.
2803 If you're using \*(lqmailgroup\*(rq,
2804 you should remove \fBslocal\fP (and its man page) from your system.
2805
2806 .ti -.5i
2807 sprintf: char *
2808 .br
2809 The return value of the \fIsprintf\fR library routine.
2810 This defaults to \*(lqchar\ *\*(rq.  Set this to \*(lqint\*(rq if
2811 you have an older version of SYSTEM 5 which has this routine return an
2812 \*(lqint\*(rq type.
2813
2814 d382 13
2815 a394 5
2816 you intend to use POP.)
2817 Here is a brief summary of the options which are of interest when
2818 POP is enabled.
2819 Be sure to read the complete description of each option later in
2820 this file.
2821 d397 2
2822 a398 2
2823 .ti -.5i 
2824 RPOP
2825 d400 16
2826 a415 4
2827 The \*(lqRPOP\*(rq option
2828 indicates that support for the UNIX variant of POP,
2829 RPOP, which uses privileged sockets for authentication be enabled.
2830 This peacefully co-exists with the standard POP.
2831 d417 33
2832 d452 8
2833 a459 4
2834 The \*(lqPOP2\*(rq option
2835 indicates that the \fIMH\fP POP daemon should
2836 speak the older POP2 protocol in addition to the \fIMH\fP POP3 protocol \-
2837 a major win.
2838 d464 14
2839 a477 1
2840 this defaults to \*(lqpop\*(rq, instead of \*(lqpop3\*(rq.
2841 d479 1
2842 a479 1
2843 DPOP
2844 d481 4
2845 a484 4
2846 The \*(lqDPOP\*(rq option
2847 indicates that POP subscribers do not have
2848 entries in the \fIpasswd\fR\0(5) file,
2849 and instead have their own separate database (another win).
2850 d486 1
2851 a486 1
2852 APOP
2853 d488 4
2854 a491 16
2855 The \*(lqAPOP\*(rq option indicates that the POP daemon will
2856 support the non-standard \fBAPOP\fP command.  This command
2857 provides a challenge-based authentication system using
2858 the \fBMD5\fP message digest algorithm.
2859 .ti -.5i
2860 MPOP
2861 .br
2862 The \*(lqMPOP\*(rq option indicates that the POP daemon will
2863 support some non-standard extensions for \*(lqmobile pop\*(rq,
2864 which are useful when using the POP over low-speed connections.
2865 .\" .ti -.5i
2866 .\" KPOP
2867 .\" .br
2868 .\" The \*(lqKPOP\*(rq option indicates that the POP daemon will
2869 .\" support the KERBEROS \fBkpop\fP protocol.  This option is 
2870 .\" incompatible with the standard POP.
2871 d493 1
2872 a493 1
2873 .sp
2874 a500 3
2875 .sp
2876 All of these options can be enabled via an \*(lqoptions\*(rq directive in the
2877 \fIMH\fR configuration file.
2878 d502 1
2879 a502 1
2880 .Uh "Testing/debugging"
2881 d504 1
2882 a504 1
2883 debug: off
2884 d506 6
2885 a511 3
2886 Support for debug mode of \fIMH\fR.
2887 Don't use this unless you know what you're doing,
2888 which isn't likely if you're reading this document!
2889 d514 1
2890 a514 1
2891 regtest: off
2892 d516 1
2893 a516 4
2894 Set this to \*(lqon\*(rq
2895 if you are doing regression testing among different
2896 compilations of \fIMH\fP, and you do not want the hostname
2897 and compile date included in \fIMH\fP execuatbles.  
2898 d518 2
2899 a519 3
2900 .Uh "Compiler Options"
2901 .ti -.5i
2902 options:
2903 d521 18
2904 a538 1
2905 \&`\-D' options to \fIcc\fR\0(1).  If you don't know what an
2906 d540 1
2907 a541 6
2908 .in +.5i
2909 .\" .ti -.5i
2910 .\" AIX
2911 .\" .br
2912 .\" Use on AIX.  Also use \*(lqoptions TYPESIG=void SYS5 SYS5DIR\*(rq.
2913 .\" 
2914 d543 1
2915 a543 1
2916 ALTOS
2917 d545 3
2918 a547 2
2919 Use on XENIX/v7 systems.
2920 Also, be sure to use \*(lqoptions V7\*(rq.
2921 d549 6
2922 d556 1
2923 a556 1
2924 APOP='\*(lq/etc/pop.auth\*(rq'
2925 d558 4
2926 a561 11
2927 This option indicates that the POP daemon will
2928 support the non-standard \fBAPOP\fP command.  This
2929 command provides a challenge-based authentication system using
2930 the \fBMD5\fP message digest algorithm.
2931 This facility is documented in 
2932 \fIThe Internet Message\fR (ISBN 0\-13\-092941\-7), a book by Marshall T. Rose.
2933 The \fBpopauth\fP program is also installed, which
2934 allows the administrator to manipulate the \fBAPOP\fP
2935 authorization database.
2936 For more details, see \fBsupport/pop/pop-more.txt\fR
2937 and the \fIAdministrator's Guide\fP.
2938 d563 1
2939 d565 1
2940 a565 1
2941 ATHENA
2942 d567 8
2943 a574 2
2944 Makes \fIrepl\fR `\-nocc\ all' the default instead of `\-cc\ all'.
2945 You may want to enable this if you're using \fIxmh\fR.
2946 a590 13
2947 ATZ
2948 .br
2949 Directs \fIMH\fR to use alpha\-timezones whenever possible.
2950 You should not use this option if you are on the Internet,
2951 since it will make your host non-compliant with RFC-1123
2952 (Requirements for Internet Hosts).
2953
2954 .ti -.5i
2955 BANG
2956 .br
2957 Directs \fIMH\fR to favor `!' over `@@' in addressing.
2958
2959 .ti -.5i
2960 a626 5
2961 .\" .ti -.5i
2962 .\" BSD44
2963 .\" .br
2964 .\" Use on Berkeley UNIX systems on or after 4.4BSD.
2965
2966 d628 1
2967 a628 1
2968 COMPAT
2969 d630 2
2970 a631 3
2971 If you previously ran a version of \fIMH\fR earlier than mh.4 use this option.
2972 After a short grace period,
2973 remove it and re-{configure,generate,install} everything.
2974 a647 11
2975 DPOP
2976 .br
2977 Enables the POP database, useful only if POP service is enabled.
2978
2979 .ti -.5i
2980 DUMB
2981 .br
2982 Directs \fIMH\fR not to try and rewrite addresses to their 
2983 \*(lqofficial\*(rq form.
2984
2985 .ti -.5i
2986 d663 1
2987 a663 1
2988 FOLDPROT
2989 d665 2
2990 a666 3
2991 Defines the octal value for default folder-protection.
2992 For example, FOLDPROT='\*(lq0700\*(rq'.
2993 The default is \*(lq0711\*(rq.
2994 a667 6
2995 .\" .ti -.5i
2996 .\" HESIOD
2997 .\" .br
2998 .\" Support for HESIOD.  
2999 .\" This code was contributed, and included no documentation.
3000
3001 a668 23
3002 ISI
3003 .br
3004 When using \*(lqrepl\ \-ccme\*(rq,
3005 only \*(lqcc:\*(rq the first address found which belongs to the user;
3006 any other \fIAlternate-Mailboxes\fR do not receive \*(lqcc:\*(rqs.
3007
3008 .\" .ti -.5i
3009 .\" KPOP
3010 .\" .br
3011 .\" Support for KERBEROS with POP.
3012 .\" This code builds
3013 .\" \fIpopd\fP, \fIinc\fP and \fImsgchk\fP to support only the 
3014 .\" \*(lqkpop\*(rq protocol.
3015 .\" This code was contributed, and included no documentation.
3016
3017 .ti -.5i
3018 LINK
3019 .br
3020 Defines the filename for alternate file name for \fIdist\fR and \fIrepl\fR.
3021 For example, LINK='\*(lq\\\\043\*(rq' to use the pound\-sign character.
3022 The default is \*(lq@@\*(rq.
3023
3024 .ti -.5i
3025 d679 1
3026 a679 1
3027 Hard\-wires the local name for the host \fIMH\fR is running on.
3028 a684 23
3029 MHE
3030 .br
3031 Enables crude support for Brien Reid's MHE interface.
3032 Recommended for use with the GNU Emacs mh-e package.
3033
3034 .ti -.5i
3035 MHRC
3036 .br
3037 Enables \fIMH\fR to recognize the \fICShell\fR's `~'\-construct.
3038 This is useful for sites that run with a ~/.mhrc for their users.
3039
3040 .ti -.5i
3041 MIME
3042 .br
3043 Enables support for multi-media messages, as specified in RFC 1341.  
3044 Several \fIMH\fP commands are extended to support these multi-media
3045 messages,
3046 and the \fImhn\fR command is provided to encode and decode
3047 \fBMIME\fP messages.
3048 For more details, see \fBmiscellany/multi-media/READ-ME\fP
3049 and \fImhn\fR\0(1).
3050
3051 .ti -.5i
3052 d688 1
3053 a688 1
3054 For example, on ALTOS and DUAL systems,
3055 a692 29
3056 MPOP
3057 .br
3058 This option indicates that the POP daemon will
3059 support the non-standard
3060 \fBXTND SCAN\fP command which provides performance
3061 enhancements when using the POP over low-speed connections.
3062 This option also causes an interactive POP
3063 client program, \fBpopi\fP, to be compiled and installed.
3064 A man page for the \fBpopi\fP program is also provided.
3065 These extensions are described in 
3066 \fIThe Internet Message\fR, a book by Marshall T. Rose.
3067 For more details, see \fBsupport/pop/pop-more.txt\fR.
3068 This option is incompatible with \*(lqbboards: nntp\*(rq.
3069
3070 .ti -.5i
3071 MSGID
3072 .br
3073 Enables \fBslocal\fP to detect and surpress duplicate
3074 messages received.  It doesn't hurt to enable this option whether
3075 or not you intend to make use of the duplicate surpression capability.
3076
3077 .ti -.5i
3078 MSGPROT
3079 .br
3080 Defines the octal value for default folder-protection
3081 For example, MSGPROT='\*(lq0600\*(rq'.
3082 The default is \*(lq0644\*(rq.
3083
3084 .ti -.5i
3085 d701 1
3086 a718 5
3087 NOMHSEQ
3088 .br
3089 Directs \fIMH\fR to make private sequences the default.
3090
3091 .ti -.5i
3092 a728 33
3093 OVERHEAD
3094 .br
3095 Enable \fIMH\fR commands to read profile/context from open fd:s
3096 without doing an open(); see mh-profile(5) for the details.
3097
3098 .ti -.5i
3099 POP2
3100 .br
3101 Have the POP daemon understand the older
3102 POP2 protocol as well as the \fIMH\fP POP3 protocol \- a major win.
3103 The POP daemon auto-magically
3104 determines which POP protocol your client is using.
3105 If you're enabling POP service,
3106 there's no reason not to enable this option as well.
3107 See also \fIPOPSERVICE\fR.
3108
3109 .ti -.5i
3110 POPSERVICE
3111 .br
3112 The port name the \fIMH\fP POP will use.  For historical reasons,
3113 this defaults to \*(lqpop\*(rq.
3114 In 1987, the \fIMH\fP POP protocol
3115 (POP version 3) was published as RFC1081 and
3116 was assigned its own port number (110),
3117 which differs from the original POP (version 1 and 2) port number (109).
3118 To have \fIMH\fP POP use the new assigned port number, 
3119 set POPSERVICE='\*(lqpop3\*(rq', and be sure that this service
3120 name is listed in your \fB/etc/services\fP file on both POP client
3121 and server hosts as \*(lq110/tcp\*(rq.
3122 If you enable \fIPOP2\fP, you can safely leave this undefined unless
3123 you are using POP3 clients besides \fIMH\fP.
3124
3125 .ti -.5i
3126 a734 17
3127 RPATHS
3128 .br
3129 Directs \fIinc\fR to note UNIX \*(lqFrom\ \*(rq lines as Return-Path: info.
3130
3131 .ti -.5i
3132 RPOP
3133 .br
3134 Enables the RPOP variant of POP, useful only if POP service is enabled.
3135
3136 .ti -.5i
3137 SBACKUP
3138 .br
3139 Defines the prefix string for backup file names.
3140 For example, SBACKUP='\*(lq\\\\043\*(rq'.
3141 The default is \*(lq,\*(rq.
3142
3143 .ti -.5i
3144 a743 8
3145 SHADOW
3146 .br
3147 Indicates that the encrypted passwords can be found in the
3148 \fB/etc/shadow\fR file (and not in the \fB/etc/passwd\fR file).
3149 This option is used only by the \fBpopd\fP POP server. 
3150 It should be used only for some (newer) SYSTEM 5 systems.
3151
3152 .ti -.5i
3153 d760 1
3154 a786 15
3155 TMA
3156 .br
3157 Support for the TTI \fItrusted mail agent\fR (TMA).
3158 Although the TTI TMA is \fBnot\fR in the public domain,
3159 the \fIMH\fR support for the TTI TMA \fBis\fR in the public domain.
3160 You should enable this option only if you are licensed to run the TMA
3161 software
3162 (otherwise, you don't have the software in your \fIMH\fR source tree).
3163
3164 .ti -.5i
3165 TTYD
3166 .br
3167 Support for TTYD.  This is no longer in wide use, and is not recommended.
3168
3169 .ti -.5i
3170 d793 2
3171 a794 1
3172 (e.g., SYSTEM 5 V3.0 and later or Sun OS 4.0 and later).
3173 a803 18
3174 UCI
3175 .br
3176 First, \*(lq_\*(rq and \*(lq#\*(rq are recognized as the prefixes for
3177 scratch files.
3178 Second, support for the UCI group\-leadership mechanism is enabled in
3179 \fIconflict\fR.
3180 Third, the file \fB$HOME/.signature\fR is considered to contain 
3181 a single line of text which is used as the \fIFull Name\fR part
3182 of your \*(lqFrom:\*(rq header.
3183 This may conflict with the interpretation of this file by \fINews\fR.
3184 If you're not at UCI, you probably don't want this option.
3185
3186 .ti -.5i
3187 UK
3188 .br
3189 Directs the \fIscan\fR program to generate UK-style dates.
3190
3191 .ti -.5i
3192 a820 4
3193 .ti -.5i
3194 WHATNOW
3195 .br
3196 Enable certain \fIMH\fR commands to act differently when $mhdraft set.
3197 d836 190
3198 @
3199
3200
3201 2.88
3202 log
3203 @document "popdir" and VSPRINTF
3204 @
3205 text
3206 @d1 1
3207 a1 1
3208 .\" @@(#)$Id: mh-gen.8,v 2.87 1992/11/02 19:01:33 jromine Exp jromine $
3209 d222 8
3210 d234 1
3211 a234 1
3212 To remove the old files instead, use \*(lqrm\0\-f\*(rq.
3213 d350 1
3214 d352 4
3215 a355 1
3216 and will not work under these systems.
3217 @
3218
3219
3220 2.87
3221 log
3222 @drop AIX in favor of _AIX
3223 @
3224 text
3225 @d1 1
3226 a1 1
3227 .\" @@(#)$Id: mh-gen.8,v 2.86 1992/11/02 19:01:00 jromine Exp jromine $
3228 d202 5
3229 d219 1
3230 a219 1
3231 (Some sites use \*(lqcp -p\*(rq.)
3232 d224 3
3233 a226 1
3234 How \fIMH\fR should backup existing files when installing a new file.
3235 d995 6
3236 @
3237
3238
3239 2.86
3240 log
3241 @note SHADOW only affects popd
3242 @
3243 text
3244 @d1 1
3245 a1 1
3246 .\" @@(#)$Id: mh-gen.8,v 2.85 1992/11/02 18:39:35 jromine Exp jromine $
3247 d513 5
3248 a517 5
3249 .ti -.5i
3250 AIX
3251 .br
3252 Use on AIX.  Also use \*(lqoptions TYPESIG=void SYS5 SYS5DIR\*(rq.
3253
3254 @
3255
3256
3257 2.85
3258 log
3259 @add some notes about "oldload none"
3260 @
3261 text
3262 @d1 1
3263 a1 1
3264 .\" @@(#)$Id: mh-gen.8,v 2.84 1992/11/02 17:10:51 jromine Exp jromine $
3265 d883 2
3266 a884 1
3267 This option should only be used for some (newer) SYSTEM 5 systems.
3268 @
3269
3270
3271 2.84
3272 log
3273 @elaborate on "mailgroup" description
3274 @
3275 text
3276 @d1 1
3277 a1 1
3278 .\" @@(#)$Id: mh-gen.8,v 2.83 1992/10/31 06:24:13 jromine Exp jromine $
3279 d276 2
3280 d924 2
3281 @
3282
3283
3284 2.83
3285 log
3286 @drop mention of SunOS 3.5 -lresolv bugs
3287 @
3288 text
3289 @d1 1
3290 a1 1
3291 .\" @@(#)$Id: mh-gen.8,v 2.82 1992/10/31 06:20:55 jromine Exp jromine $
3292 d332 3
3293 @
3294
3295
3296 2.82
3297 log
3298 @note bugs in SunOS NIS/DNS lookup code (and give work-around)
3299 @
3300 text
3301 @d1 1
3302 a1 1
3303 .\" @@(#)$Id: mh-gen.8,v 2.81 1992/10/29 22:20:55 jromine Exp jromine $
3304 a574 9
3305
3306 If you're running SunOS 3.5 and using their brain-damaged approach
3307 to offering Domain Name Service through NIS,
3308 you're going to have to enable \*(lqoptions BERK\*(rq to
3309 prevent \fIMH \fP from trying to resolve hostnames.  
3310 This is because the Sun NIS/DNS interface is broken when
3311 resolving hosts which have no \*(lqA\*(rq resource records.
3312 You could use the \fBlibresolv.a\fP libarary to work around the NIS
3313 problems, but it's also broken under SunOS 3.5.  Sorry.
3314 @
3315
3316
3317 2.81
3318 log
3319 @describe how to put slibdir somewhere besides /usr/local/lib
3320 @
3321 text
3322 @d1 1
3323 a1 1
3324 .\" @@(#)$Id: mh-gen.8,v 2.80 1992/10/29 17:44:55 jromine Exp jromine $
3325 d576 9
3326 d900 1
3327 a900 1
3328 Use on Sun OS 4.0 (and later?) systems.  You probably also want
3329 d903 4
3330 @
3331
3332
3333 2.80
3334 log
3335 @add subheading for options:
3336 @
3337 text
3338 @d1 1
3339 a1 1
3340 .\" @@(#)$Id: mh-gen.8,v 2.79 1992/10/29 17:39:14 jromine Exp jromine $
3341 d298 1
3342 a298 1
3343 If you enable this, be sure to use \*(lqoptions SUN40\*(rq.
3344 d305 3
3345 d311 6
3346 @
3347
3348
3349 2.79
3350 log
3351 @add AIX
3352 @
3353 text
3354 @d1 1
3355 a1 1
3356 .\" @@(#)$Id: mh-gen.8,v 2.78 1992/10/27 21:44:44 jromine Exp jromine $
3357 d491 1
3358 @
3359
3360
3361 2.78
3362 log
3363 @fixup
3364 @
3365 text
3366 @d1 1
3367 a1 1
3368 .\" @@(#)$Id: mh-gen.8,v 2.77 1992/10/27 18:11:52 jromine Exp jromine $
3369 d498 5
3370 @
3371
3372
3373 2.77
3374 log
3375 @document NNTP/MPOP incompatibility
3376 @
3377 text
3378 @d1 1
3379 a1 1
3380 .\" @@(#)$Id: mh-gen.8,v 2.76 1992/10/27 17:41:40 jromine Exp jromine $
3381 d954 1
3382 @
3383
3384
3385 2.76
3386 log
3387 @move stuff into subsections
3388 @
3389 text
3390 @d1 1
3391 a1 1
3392 .\" @@(#)$Id: mh-gen.8,v 2.75 1992/10/27 17:00:27 jromine Exp jromine $
3393 d469 2
3394 a470 1
3395 These two options peacefully co-exist with the standard POP.
3396 d737 1
3397 @
3398
3399
3400 2.75
3401 log
3402 @RENAME, UNISTD
3403 @
3404 text
3405 @d1 1
3406 a1 1
3407 .\" @@(#)$Id: mh-gen.8,v 2.74 1992/10/26 16:54:14 jromine Exp jromine $
3408 d68 1
3409 a68 1
3410 ics.uci.edu [128.195.1.1] and retrieve the file pub/mh/mh-6.7.tar.Z.
3411 d78 1
3412 a78 1
3413 either ics.uci.edu or louie.udel.edu.
3414 d94 4
3415 a97 5
3416 Computing Support Group 
3417 Attn: MH distribution
3418 Department of Information and Computer Science
3419 University of California, Irvine
3420 Irvine, CA  92717
3421 d99 1
3422 a99 1
3423 714/856-7554
3424 d156 6
3425 d163 1
3426 a163 1
3427 bbdelivery: off
3428 d165 1
3429 a165 14
3430 If \*(lqoff\*(rq,
3431 the BBoards delivery agent and library files will not be installed.
3432 If 
3433 \*(lqon\*(rq,
3434 and you set \*(lqbboards:\*(rq to something besides \*(lqoff\*(rq,
3435 then 
3436 the BBoards delivery agent and library files will be installed
3437 in the \fIbbhome\fR directory (see below).
3438 To read remote BBoards,
3439 the usual configuration would have \fIbbc\fR talk to a \fIPOP3\fR or
3440 \fINNTP\fR server.
3441 However, it may be useful to set this to \*(lqoff\*(rq if 
3442 you NFS mount the \fIbbhome\fR directory from another host
3443 and want to use \fIbbc\fR to read those files directly.
3444 d168 1
3445 a168 1
3446 bboards: off
3447 d170 1
3448 a170 9
3449 If \*(lqon\*(rq, include support for the UCI BBoards facility.
3450 BBoards may be enabled with any mts setting.
3451 If \*(lqoff\*(rq, the BBoard reading program \fIbbc\fR will not be installed.
3452 If \*(lqnntp\*(rq,
3453 include support for the UCI BBoards facility to read the Network News
3454 via the NNTP.
3455 If \*(lqpop\*(rq (formerly \*(lqpopbboards:\ on\*(rq),
3456 include support for the UCI BBoards facility via the POP3 service;
3457 this setting requires \*(lqpop:\ on\*(rq.
3458 d173 1
3459 a173 1
3460 bbhome: /usr/spool/bboards
3461 d175 5
3462 a179 1
3463 The home directory for the BBoards user.
3464 d182 1
3465 a182 1
3466 bin: /usr/local
3467 d184 1
3468 a184 1
3469 The directory where user\-invoked programs go (see manual section 1).
3470 d187 1
3471 a187 1
3472 cc:
3473 d189 11
3474 a199 1
3475 The name of your C compiler, if not \*(lqcc\*(rq.
3476 a201 10
3477 ccoptions: \-O
3478 .br
3479 Options given directly to \fIcc\fR\0(1).
3480 The most common is \*(lq\-M\*(rq if you're running \fIMH\fR on an ALTOS.
3481 This defaults to \*(lq\-O\*(rq.  If you define this and want to 
3482 keep \*(lq\-O\*(rq, be sure to include it explicitly.
3483 If you're using the \fIGNU\fP C compiler, it should
3484 include `\-traditional'.  See \*(lqoptions:\*(rq for `\-D' options.
3485
3486 .ti -.5i
3487 d211 1
3488 a211 1
3489 cp:
3490 d217 1
3491 a217 1
3492 curses: \-lcurses\0\-ltermlib
3493 d219 1
3494 a219 5
3495 This should be the loader option required to load the \fItermcap\fR\0(3)
3496 and \fIcurses\fR\0(3) libraries on your system.
3497 On SYS5 systems, it probably should be just \*(lq\-lcurses\*(rq.
3498 Some sites have reported that both \*(lq\-lcurses\*(rq and
3499 \*(lq\-ltermlib\*(rq are necessary.
3500 d221 1
3501 d223 1
3502 a223 1
3503 debug: off
3504 d225 1
3505 a225 3
3506 Support for debug mode of \fIMH\fR.
3507 Don't use this unless you know what you're doing,
3508 which isn't likely if you're reading this document!
3509 d228 1
3510 a228 1
3511 editor: prompter
3512 d230 6
3513 a235 1
3514 The default editor for \fIMH\fR.
3515 d238 1
3516 a238 1
3517 etc: /usr/local/lib/mh
3518 d240 5
3519 a244 1
3520 The directory where pgm\-invoked programs go (see manual section 8).
3521 d247 1
3522 a247 1
3523 ldoptions:
3524 d274 1
3525 a274 1
3526 mail: /usr/spool/mail
3527 d276 2
3528 a277 5
3529 The directory where the maildrops are stored.
3530 If this pathname is absolute (i.e., begins with a \fB/\fR\0),
3531 then the user's maildrop is a file called \fB$USER\fR in this directory.
3532 If the pathname is not absolute,
3533 then the user's maildrop is in the user's home directory under the given name.
3534 d280 39
3535 d325 1
3536 a325 1
3537 mandir: /usr/man
3538 d327 4
3539 a330 1
3540 The parent directory of the manual entries.
3541 d332 1
3542 a333 15
3543 manuals: standard
3544 .br
3545 Where manual entries should be installed,
3546 relative to the directory given with \*(lqmandir\*(rq.
3547 Either \*(lqlocal\*(rq to install manual entries under \fBmanl/\fR,
3548 or \*(lqnew\*(rq to install manual entries under \fBmann/\fR,
3549 or \*(lqold\*(rq to install manual entries under \fBmano/\fR,
3550 or \*(lqstandard\*(rq to install manual entries under \fBman?/\fR,
3551 or \*(lqgen\*(rq to generate but not install them,
3552 or \*(lqnone\*(rq to neither generate nor install them.
3553 For example,
3554 to install manual entries under \fB/usr/man/u_man/man?\fR,
3555 use \*(lqstandard\*(rq and \fB/usr/man/u_man\fR for \*(lqmandir\*(rq.
3556
3557 .ti -.5i
3558 d363 1
3559 d365 1
3560 a365 1
3561 oldload: off
3562 d367 9
3563 a375 2
3564 Support for the ALTOS loader if \*(lqon\*(rq.
3565 Support for loaders not handling `\-x\0\-r' correctly if \*(lqnone\*(rq.
3566 d378 24
3567 d474 1
3568 d476 1
3569 a476 1
3570 ranlib: on
3571 d478 3
3572 a480 9
3573 Support for systems with \fIranlib\fR\0(1).
3574 For SYSTEM 5 systems,
3575 this should be \*(lqoff\*(rq which tells \fIMH\fR to use \fIlorder\fR and
3576 \fItsort\fR instead.
3577 Some SYSTEM 5 sites reported that running this isn't always sufficient.
3578 If this is the case,
3579 then you should edit \fBconf/makefiles/uip\fR to include
3580 \fB\&../sbr/libmh.a\fR and \fB../zotnet/libzot.a\fR twice in the LIBES
3581 variable.
3582 a490 32
3583 remove: mv \-f
3584 .br
3585 How \fIMH\fR should backup existing files when installing a new file.
3586
3587 .ti -.5i
3588 sharedlib: off
3589 .br
3590 Makes libmh.a into a shared library (only for SunOS 4.0 and later).  
3591 If you enable this, be sure to use \*(lqoptions SUN40\*(rq.
3592
3593 .ti -.5i
3594 slibdir: /usr/local/lib
3595 .br
3596 The directory where the \fIMH\fP shared library should go.
3597
3598 Since some \fIMH\fP programs are setuid, they'll only look for
3599 the library in \*(lqtrusted\*(rq locations.  Putting the library
3600 somewhere besides \fB/usr/lib\fP or \fB/usr/local/lib\fP is not advisable.
3601
3602 You may need to run \fIldconfig\fP\0(8) manually whenever a new
3603 shared object is installed on the system.
3604 See \fIld\fR\0(1) for more information about using shared libraries.
3605
3606 .ti -.5i
3607 sprintf: char *
3608 .br
3609 The return value of the \fIsprintf\fR library routine.
3610 This defaults to \*(lqchar\ *\*(rq.  Set this to \*(lqint\*(rq if
3611 you have an older version of SYSTEM 5 which has this routine return an
3612 \*(lqint\*(rq type.
3613
3614 .ti -.5i
3615 d588 5
3616 d757 1
3617 a757 1
3618 Otherwise, \fIMH\fR will try \fB<ndir.h>\fR.
3619 @
3620
3621
3622 2.74
3623 log
3624 @document MSGID
3625 @
3626 text
3627 @d1 1
3628 a1 1
3629 .\" @@(#)$Id: mh-gen.8,v 2.73 1992/10/26 16:29:56 jromine Exp jromine $
3630 d808 6
3631 d930 5
3632 @
3633
3634
3635 2.73
3636 log
3637 @give ISBN of The Internet Message
3638 mention POPSERVICE in pop options summary
3639 sprintf: char * (default)
3640 @
3641 text
3642 @d1 1
3643 a1 1
3644 .\" @@(#)$Id: mh-gen.8,v 2.72 1992/10/20 22:50:50 jromine Exp jromine $
3645 d719 7
3646 @
3647
3648
3649 2.72
3650 log
3651 @DBM->DBMPWD (conflict with ndbm.h)
3652 @
3653 text
3654 @d1 1
3655 a1 1
3656 .\" @@(#)$Id: mh-gen.8,v 2.71 1992/10/19 21:57:08 jromine Exp jromine $
3657 d362 4
3658 a365 1
3659 If POP is enabled, there are several options which are of interest:
3660 d383 5
3661 d417 2
3662 a418 1
3663 \fIThe Internet Message\fR, a book by Marshall T. Rose.
3664 d420 1
3665 a420 1
3666 These options co-exist with the standard POP.
3667 d450 1
3668 d471 1
3669 a471 1
3670 sprintf: int
3671 d499 1
3672 a499 1
3673 \fIThe Internet Message\fR, a book by Marshall T. Rose.
3674 @
3675
3676
3677 2.71
3678 log
3679 @typo
3680 @
3681 text
3682 @d1 1
3683 a1 1
3684 .\" @@(#)$Id: mh-gen.8,v 2.70 1992/10/19 21:56:21 jromine Exp jromine $
3685 d574 1
3686 a574 1
3687 DBM
3688 d579 1
3689 a579 1
3690 Without DBM the entire passwd file is read into
3691 @
3692
3693
3694 2.70
3695 log
3696 @document APOP database
3697 @
3698 text
3699 @d1 1
3700 a1 1
3701 .\" @@(#)$Id: mh-gen.8,v 2.69 1992/10/19 21:48:20 jromine Exp jromine $
3702 a493 1
3703 and the \fIAdministrator's Guide\fP.
3704 @
3705
3706
3707 2.69
3708 log
3709 @re-order directives alphabetically
3710 include MPOP, APOP, etc. options
3711 @
3712 text
3713 @d1 1
3714 a1 1
3715 .\" @@(#)$Id: mh-gen.8,v 2.68 1992/10/19 20:29:19 jromine Exp jromine $
3716 d482 1
3717 a482 1
3718 APOP
3719 d490 6
3720 a495 1
3721 For more details, see \fBsupport/pop/pop-more.txt\fR.
3722 a681 1
3723 For more details, see support/
3724 d686 2
3725 a687 1
3726 For more details, see \fBmiscellany/multi-media/READ-ME\fP.
3727 @
3728
3729
3730 2.68
3731 log
3732 @explain zoneinfo
3733 @
3734 text
3735 @d1 1
3736 a1 1
3737 .\" @@(#)$Id: mh-gen.8,v 2.67 1992/05/12 21:05:04 jromine Exp jromine $
3738 d140 1
3739 d146 9
3740 a154 1
3741 Here are the \fIMH\fP configuration options available:
3742 d156 1
3743 d158 36
3744 d199 39
3745 d245 5
3746 d255 27
3747 a316 19
3748 chown: /etc/chown
3749 .br
3750 The location of the \fIchown\fR\0(8) on your system.
3751 If \fIchown\fR is in your search path,
3752 just use the value of \*(lqchown\*(rq.
3753 On SYS5 systems,
3754 this should probably be \*(lq/bin/chown\*(rq.
3755
3756 .ti -.5i
3757 editor: prompter
3758 .br
3759 The default editor for \fIMH\fR.
3760
3761 .ti -.5i
3762 remove: mv \-f
3763 .br
3764 How \fIMH\fR should backup existing files when installing a new file.
3765
3766 .ti -.5i
3767 a338 36
3768 bboards: off
3769 .br
3770 If \*(lqon\*(rq, include support for the UCI BBoards facility.
3771 BBoards may be enabled with any mts setting.
3772 If \*(lqoff\*(rq, the BBoard reading program \fIbbc\fR will not be installed.
3773 If \*(lqnntp\*(rq,
3774 include support for the UCI BBoards facility to read the Network News
3775 via the NNTP.
3776 If \*(lqpop\*(rq (formerly \*(lqpopbboards:\ on\*(rq),
3777 include support for the UCI BBoards facility via the POP3 service;
3778 this setting requires \*(lqpop:\ on\*(rq.
3779
3780 .ti -.5i
3781 bbdelivery: off
3782 .br
3783 If \*(lqoff\*(rq,
3784 the BBoards delivery agent and library files will not be installed.
3785 If 
3786 \*(lqon\*(rq,
3787 and you set \*(lqbboards:\*(rq to something besides \*(lqoff\*(rq,
3788 then 
3789 the BBoards delivery agent and library files will be installed
3790 in the \fIbbhome\fR directory (see below).
3791 To read remote BBoards,
3792 the usual configuration would have \fIbbc\fR talk to a \fIPOP3\fR or
3793 \fINNTP\fR server.
3794 However, it may be useful to set this to \*(lqoff\*(rq if 
3795 you NFS mount the \fIbbhome\fR directory from another host
3796 and want to use \fIbbc\fR to read those files directly.
3797
3798 .ti -.5i
3799 bbhome: /usr/spool/bboards
3800 .br
3801 The home directory for the BBoards user.
3802
3803 .ti -.5i
3804 d347 6
3805 d362 8
3806 a369 3
3807 If POP is enabled, there are three additional options which are of interest:
3808 \*(lqRPOP\*(rq, \*(lqDPOP\*(rq and \*(lqPOP2\*(rq.
3809 The first indicates that support for the UNIX variant of POP,
3810 d371 6
3811 a376 5
3812 This peacefully co\-exists with the standard POP.
3813 The \*(lqDPOP\*(rq option indicates that POP subscribers do not have
3814 entries in the \fIpasswd\fR\0(5) file,
3815 and instead have their own separate database (another major win).
3816 The \*(lqPOP2\*(rq option indicates that the \fIMH\fP POP daemon should
3817 d379 34
3818 d417 1
3819 a417 1
3820 kpop: off
3821 d419 9
3822 a427 5
3823 Support for KERBEROS with POP.
3824 This code appears to build
3825 \fIpopd\fP, \fIinc\fP and \fImsgchk\fP to support only the 
3826 \*(lqkpop\*(rq protocol.
3827 This code was contributed, and included no documentation.
3828 d430 1
3829 a430 1
3830 hesiod: off
3831 d432 4
3832 a435 2
3833 Support for HESIOD.  
3834 This code was contributed, and included no documentation.
3835 d438 31
3836 d482 11
3837 d616 6
3838 d629 9
3839 d674 11
3840 d693 14
3841 d856 10
3842 a927 121
3843
3844 .ti -.5i
3845 cp:
3846 .br
3847 The command to copy files when installing, if not \*(lqcp\*(rq.
3848 (Some sites use \*(lqcp -p\*(rq.)
3849
3850 .ti -.5i
3851 cc:
3852 .br
3853 The name of your C compiler, if not \*(lqcc\*(rq.
3854
3855 .ti -.5i
3856 ccoptions: \-O
3857 .br
3858 Options given directly to \fIcc\fR\0(1).
3859 The most common is \*(lq\-M\*(rq if you're running \fIMH\fR on an ALTOS.
3860 This defaults to \*(lq\-O\*(rq.  If you define this and want to 
3861 keep \*(lq\-O\*(rq, be sure to include it explicitly.
3862 If you're using the \fIGNU\fP C compiler, it should
3863 include `\-traditional'.
3864
3865 .ti -.5i
3866 curses: \-lcurses\0\-ltermlib
3867 .br
3868 This should be the loader option required to load the \fItermcap\fR\0(3)
3869 and \fIcurses\fR\0(3) libraries on your system.
3870 On SYS5 systems, it probably should be just \*(lq\-lcurses\*(rq.
3871 Some sites have reported that both \*(lq\-lcurses\*(rq and
3872 \*(lq\-ltermlib\*(rq are necessary.
3873
3874 .ti -.5i
3875 ldoptions:
3876 .br
3877 Options given directly to \fIld\fR\0(1) (via \fIcc\fR\0) at the beginning
3878 of the command line.
3879 Useful for machines which require arguments to tell \fIld\fR to increase the
3880 stack space (e.g. the Gould, which uses \*(lq\-m\08\*(rq).
3881 Usually, \*(lq\-s\*(rq is a good choice in any event.
3882
3883 .ti -.5i
3884 ldoptlibs:
3885 .br
3886 Options given directly to \fIld\fR\0(1) (via \fIcc\fR\0) at the end of the
3887 command line.
3888 The two most common are:
3889 \*(lq\-ldbm\*(rq if you're running MMDF with the \fIdbm\fR package;
3890 and, \*(lq\-lndir\*(rq if you are generating \fIMH\fR on a system
3891 which does not load the new directory access mechanism by default
3892 (e.g., 4.1BSD, SYS5).
3893 If you don't have \fIlibndir\fR on your system,
3894 the sources are in \fBmiscellany/libndir/\fR.
3895
3896 .ti -.5i
3897 lex: lex -nt
3898 .br
3899 Alternative version of \fIlex\fR.  Used in \fBzotnet/tws/\fR.
3900
3901 .ti -.5i
3902 sprintf: int
3903 .br
3904 The return value of the \fIsprintf\fR library routine.
3905 This defaults to \*(lqchar\ *\*(rq.  Set this to \*(lqint\*(rq if
3906 you have an older version of SYSTEM 5 which has this routine return an
3907 \*(lqint\*(rq type.
3908
3909 .ti -.5i
3910 sharedlib: off
3911 .br
3912 Makes libmh.a into a shared library (only for SunOS 4.0 and later).  
3913 If you enable this, be sure to use \*(lqoptions SUN40\*(rq.
3914
3915 .ti -.5i
3916 slibdir: /usr/local/lib
3917 .br
3918 The directory where the \fIMH\fP shared library should go.
3919
3920 Since some \fIMH\fP programs are setuid, they'll only look for
3921 the library in \*(lqtrusted\*(rq locations.  Putting the library
3922 somewhere besides \fB/usr/lib\fP or \fB/usr/local/lib\fP is not advisable.
3923
3924 You may need to run \fIldconfig\fP\0(8) manually whenever a new
3925 shared object is installed on the system.
3926 See \fIld\fR\0(1) for more information about using shared libraries.
3927
3928 .ti -.5i
3929 oldload: off
3930 .br
3931 Support for the ALTOS loader if \*(lqon\*(rq.
3932 Support for loaders not handling `\-x\0\-r' correctly if \*(lqnone\*(rq.
3933
3934 .ti -.5i
3935 ranlib: on
3936 .br
3937 Support for systems with \fIranlib\fR\0(1).
3938 For SYSTEM 5 systems,
3939 this should be \*(lqoff\*(rq which tells \fIMH\fR to use \fIlorder\fR and
3940 \fItsort\fR instead.
3941 Some SYSTEM 5 sites reported that running this isn't always sufficient.
3942 If this is the case,
3943 then you should edit \fBconf/makefiles/uip\fR to include
3944 \fB\&../sbr/libmh.a\fR and \fB../zotnet/libzot.a\fR twice in the LIBES
3945 variable.
3946
3947 .ti -.5i
3948 tma: off
3949 .br
3950 Support for the TTI \fItrusted mail agent\fR (TMA).
3951 Although the TTI TMA is \fBnot\fR in the public domain,
3952 the \fIMH\fR support for the TTI TMA \fBis\fR in the public domain.
3953 You should enable this option only if you are licensed to run the TMA
3954 software
3955 (otherwise, you don't have the software in your \fIMH\fR source tree).
3956
3957 .ti -.5i
3958 regtest: off
3959 .br
3960 Set this to \*(lqon\*(rq
3961 if you are doing regression testing among different
3962 compilations of \fIMH\fP, and you do not want the hostname
3963 and compile date included in \fIMH\fP execuatbles.  
3964 @
3965
3966
3967 2.67
3968 log
3969 @delete SUN41
3970 @
3971 text
3972 @d1 1
3973 a1 1
3974 .\" @@(#)$Id: mh-gen.8,v 2.66 1992/05/12 21:04:45 jromine Exp jromine $
3975 d360 3
3976 d713 5
3977 a717 1
3978 information /etc/zoneinfo or /usr/lib/zoneinfo (SunOS).
3979 @
3980
3981
3982 2.66
3983 log
3984 @document making admin manual before installing software
3985 @
3986 text
3987 @d1 1
3988 a1 1
3989 .\" @@(#)$Id: mh-gen.8,v 2.65 1992/02/12 21:36:21 jromine Exp jromine $
3990 a631 8
3991 \*(lqoptions BSD42\*(rq, \*(lqoptions BSD43\*(rq, and
3992 \*(lqoptions TYPESIG=void\*(rq.
3993
3994 .ti -.5i
3995 SUN41
3996 .br
3997 Use on Sun OS 4.1 (and later?) systems.  You also want
3998 \*(lqoptions SUN40\*(rq,
3999 @
4000
4001
4002 2.65
4003 log
4004 @GNU -traditional
4005 @
4006 text
4007 @d1 1
4008 a1 1
4009 .\" @@(#)$Id: mh-gen.8,v 2.64 1992/02/12 21:35:05 jromine Exp jromine $
4010 d12 2
4011 a13 1
4012 Guide before you install \fIMH\fP.
4013 d117 3
4014 a119 4
4015 Become the super-user and create a new directory under /usr/src/local/
4016 (or whatever) for the \fIMH\fR area.
4017 Traditionally, the directory's name should be mh/.
4018 The distribution tape contains the hierarchy for the mh.6/ directory.
4019 d123 1
4020 a123 2
4021 # mkdir /usr/src/local/mh
4022 % cd /usr/src/local/mh
4023 d125 1
4024 d658 7
4025 d869 26
4026 d1056 1
4027 a1056 1
4028 Go to the mh.6/ directory and generate the system.
4029 a1071 21
4030 \fBBefore proceeding\fP,
4031 you should familiarize yourself with the \fIAdministrator's Guide\fR.
4032 To generate an \fInroff\fR version, go to the doc/ directory
4033 and type:
4034 .sp 1
4035 .nf
4036 % (cd doc/; make ADMIN.doc)
4037 .fi
4038 .sp 1
4039 To generate a \fItroff\fR version, type
4040 .sp 1
4041 .nf
4042 % (cd doc/; make guide)
4043 .fi
4044 .sp 1
4045 instead.
4046 .PP
4047 If you're already running \fIMH\fR at your site,
4048 you should also read the \fImh.6\fR changes documents.
4049 The sources are in \fBpapers/mh6.5/\fR and \fBpapers/mh6.7/\fP.
4050 .PP
4051 d1115 1
4052 a1115 1
4053 files will not be installed over existing copies;
4054 d1152 4
4055 @
4056
4057
4058 2.64
4059 log
4060 @try to document KERBEROS
4061 @
4062 text
4063 @d1 1
4064 a1 1
4065 .\" @@(#)$Id: mh-gen.8,v 2.63 1992/02/11 05:08:34 jromine Exp jromine $
4066 d735 2
4067 @
4068
4069
4070 2.63
4071 log
4072 @document LOCKF, FLOCK, FCNTL
4073 @
4074 text
4075 @d1 1
4076 a1 1
4077 .\" @@(#)$Id: mh-gen.8,v 2.62 1992/02/06 16:48:48 jromine Exp $
4078 d311 5
4079 a315 2
4080 Support for KERBEROS with POP.  This code was contributed, 
4081 but there was no documentation made available.
4082 d320 2
4083 a321 2
4084 Support for HESIOD.  This code was contributed, 
4085 but there was no documentation made available.
4086 @
4087
4088
4089 2.62
4090 log
4091 @document comment syntax
4092 @
4093 text
4094 @d1 1
4095 a1 1
4096 .\" @@(#)$Id: mh-gen.8,v 2.61 1992/02/06 00:25:07 jromine Exp jromine $
4097 d433 15
4098 d471 4
4099 a474 3
4100 Directs \fIMH\fP to use the \fBlockf()\fP system call for UNIX-style
4101 locking instead of \fBflock()\fP.  If you're using NFS to read or
4102 write maildrops, you should enable this option.
4103 @
4104
4105
4106 2.61
4107 log
4108 @make NFS and SENDMAILBUG more explicit
4109 @
4110 text
4111 @d1 1
4112 a1 1
4113 .\" @@(#)$Id: mh-gen.8,v 2.60 1992/02/05 22:18:48 jromine Exp jromine $
4114 d143 1
4115 @
4116
4117
4118 2.60
4119 log
4120 @add zmailer support
4121 @
4122 text
4123 @d1 1
4124 a1 1
4125 .\" @@(#)$Id: mh-gen.8,v 2.59 1992/02/05 21:52:46 jromine Exp jromine $
4126 d509 3
4127 a511 1
4128 \fIMH\fP, you need this option.
4129 d589 2
4130 a590 1
4131 Enable this if you know that your SendMail will
4132 @
4133
4134
4135 2.59
4136 log
4137 @add "regtest: on/off" to not include hostname and date
4138 in version.c
4139 @
4140 text
4141 @d1 1
4142 a1 1
4143 .\" @@(#)$Id: mh-gen.8,v 2.58 1992/01/31 23:09:59 jromine Exp jromine $
4144 d224 1
4145 @
4146
4147
4148 2.58
4149 log
4150 @drop WP
4151 @
4152 text
4153 @d1 1
4154 a1 1
4155 .\" @@(#)$Id: mh-gen.8,v 2.57 1992/01/31 22:55:36 jromine Exp jromine $
4156 d803 9
4157 @
4158
4159
4160 2.57
4161 log
4162 @mention kpop/hesiod options
4163 @
4164 text
4165 @d1 1
4166 a1 1
4167 .\" @@(#)$Id: mh-gen.8,v 2.56 1992/01/31 22:47:36 jromine Exp jromine $
4168 a676 6
4169
4170 .ti -.5i
4171 WP
4172 .br
4173 Enables the White Pages service.
4174 Contact wpp-manager@@psi.com for more information.
4175 @
4176
4177
4178 2.56
4179 log
4180 @add "cp" option
4181 @
4182 text
4183 @d1 1
4184 a1 1
4185 .\" @@(#)$Id: mh-gen.8,v 2.55 1992/01/30 16:41:35 jromine Exp jromine $
4186 d305 12
4187 @
4188
4189
4190 2.55
4191 log
4192 @ATTVIBUG
4193 SUN41
4194 @
4195 text
4196 @d1 1
4197 a1 1
4198 .\" @@(#)$Id: mh-gen.8,v 2.54 1991/01/24 08:27:50 mh Exp jromine $
4199 d686 6
4200 @
4201
4202
4203 2.54
4204 log
4205 @mention undefined _index _rindex
4206 @
4207 text
4208 @d1 1
4209 a1 1
4210 .\" @@(#)$Id: mh-gen.8,v 2.53 91/01/23 14:54:18 mh Exp Locker: mh $
4211 d326 14
4212 d600 1
4213 a600 1
4214 SUNVIBUG
4215 d602 4
4216 a605 10
4217 This option causes
4218 \fIMH\fP to return to the \*(lqWhat now?\*(rq
4219 prompt if your initial editor is \fBvi\fP
4220 and it exits with non-zero status.
4221 Use on Sun OS 4.1 and other systems where the
4222 \fB/usr/ucb/vi\fP editor was changed to
4223 exit with its status equal to the number of pseudo-\*(lqerrors\*(rq
4224 encountered during the edit.  This causes a problem for programs that
4225 test the exit status of their editor and abort if the status is non-zero.
4226 (This includes \fIMH\fP and programs like \fB/usr/etc/vipw\fP).
4227 d633 1
4228 a633 1
4229 (e.g., SYSTEM 5 V3.0 and later or Sun OS 4.0).
4230 @
4231
4232
4233 2.53
4234 log
4235 @add SUNVIBUG
4236 @
4237 text
4238 @d1 1
4239 a1 1
4240 .\" @@(#)$Id: mh-gen.8,v 2.52 91/01/23 14:44:18 mh Exp Locker: mh $
4241 d797 4
4242 a800 2
4243 Now install the configured files into the source areas.  (On SYSTEM 5
4244 systems you may need to use \*(lqmake sys5\*(rq to compile mhconfig.)
4245 @
4246
4247
4248 2.52
4249 log
4250 @add LOCKF docs
4251 @
4252 text
4253 @d1 1
4254 a1 1
4255 .\" @@(#)$Id: mh-gen.8,v 2.51 90/12/18 13:55:54 mh Exp Locker: mh $
4256 d584 14
4257 @
4258
4259
4260 2.51
4261 log
4262 @sharedlibs
4263 jlr
4264 @
4265 text
4266 @d1 1
4267 a1 1
4268 .\" @@(#)$Id: mh-gen.8,v 2.50 90/11/21 09:27:52 mh Exp Locker: mh $
4269 d424 7
4270 @
4271
4272
4273 2.50
4274 log
4275 @document servers: a little better
4276 jlr
4277 @
4278 text
4279 @d1 1
4280 a1 1
4281 .\" @@(#)$Id: mh-gen.8,v 2.49 90/11/16 14:55:57 mh Exp Locker: mh $
4282 d235 2
4283 a236 2
4284 Guide\fR; be sure to set \*(lqservers:\*(rq as described in mh\-tailor(8) 
4285 if you use this option.
4286 d724 7
4287 a730 2
4288 The directory where the MH shared library should go.
4289 You'll need to manually run \fIldconfig\fP\0(8) whenever a new
4290 d732 1
4291 a732 8
4292
4293 If you want to
4294 put it somewhere other than \fB/usr/lib\fP or \fB/usr/local/lib\fP
4295 (not advisable), you'll probably have to run \fIldconfig\fR\0(8) on
4296 that directory, or
4297 alter the environment variable \fBLD_LIBRARY_PATH\fP for each
4298 user wishing to use the MH system (this is messy). See
4299 \fIld\fR\0(1) for more information about how to do this.
4300 @
4301
4302
4303 2.49
4304 log
4305 @document POP2 option
4306 @
4307 text
4308 @d1 1
4309 a1 1
4310 .\" @@(#)$Id: mh-gen.8,v 2.48 90/04/09 13:27:27 sources Exp Locker: mh $
4311 d225 1
4312 d231 1
4313 a231 4
4314 The \*(lq/smtp\*(rq suffix is described in detail in the \fIAdministrator's
4315 Guide\fR.
4316 Hence,
4317 for TCP/IP UNIX systems,
4318 d234 3
4319 @
4320
4321
4322 2.48
4323 log
4324 @ZONEINFO
4325 @
4326 text
4327 @d1 1
4328 a1 1
4329 .\" @@(#)$Id: mh-gen.8,v 2.47 90/04/09 10:01:42 sources Exp Locker: sources $
4330 d247 1
4331 a247 1
4332 include support for the UCI BBoards facility via the POP service;
4333 d262 1
4334 a262 1
4335 the usual configuration would have \fIbbc\fR talk to a \fIPOP\fR or
4336 d291 3
4337 a293 3
4338 If POP is enabled, there are two additional options which are of interest:
4339 \*(lqRPOP\*(rq and \*(lqDPOP\*(rq.
4340 The former indicates that support for the UNIX variant of POP,
4341 d299 4
4342 a302 1
4343 Both of these options can be enabled via an \*(lqoptions\*(rq directive in the
4344 d504 11
4345 d518 5
4346 a522 3
4347 this defaults to \*(lqpop\*(rq.  The \fIMH\fP POP protocol
4348 (POP version 3) has finally been assigned its own port number (110),
4349 which differs from the original POP (version 1) port number (109).
4350 d527 2
4351 @
4352
4353
4354 2.47
4355 log
4356 @POPSERVICE
4357 @
4358 text
4359 @d1 1
4360 a1 1
4361 .\" @@(#)$Id: mh-gen.8,v 2.46 90/04/08 19:35:27 sources Exp Locker: sources $
4362 d592 1
4363 a592 1
4364 asked for alpha\-timezones (see the ATZ option).
4365 d628 9
4366 @
4367
4368
4369 2.46
4370 log
4371 @*** empty log message ***
4372 @
4373 text
4374 @d1 1
4375 a1 1
4376 .\" @@(#)$Id: mh-gen.8,v 2.45 90/04/07 23:34:23 sources Exp Locker: sources $
4377 d499 12
4378 @
4379
4380
4381 2.45
4382 log
4383 @minor cleanup.  don't justify with nroff
4384 @
4385 text
4386 @d1 1
4387 a1 1
4388 .\" @@(#)$Id: mh-gen.8,v 2.44 90/04/06 10:59:28 sources Exp Locker: sources $
4389 d106 2
4390 a107 1
4391 format).  I'm working on getting Postscript versions of the documents.
4392 @
4393
4394
4395 2.44
4396 log
4397 @*** empty log message ***
4398 @
4399 text
4400 @d1 3
4401 a3 1
4402 .\" @@(#)$Id: mh-gen.8,v 2.43 90/04/06 10:51:39 sources Exp Locker: sources $
4403 d62 2
4404 a63 2
4405 Since you probably already have MH, you may not need to read this
4406 unless you suspect you have an old version.
4407 d79 3
4408 a81 2
4409 2.  You can send $75 US to the address below.  This covers the cost
4410 of a magtape, handling, and shipping.  In addition, you'll get a
4411 d83 2
4412 a84 2
4413 sure to include your USPS address with your check.  Checks should
4414 be made payable to:
4415 d89 1
4416 a89 1
4417 and must be drawn on U.S.  funds.  The distribution address is:  
4418 d469 2
4419 d543 2
4420 a544 1
4421 \*(lqoptions\ BSD42\*(rq and \*(lqoptions\ BSD43\*(rq.
4422 a546 9
4423 SUN41
4424 .br
4425 For Sun OS 4.1 this defines
4426 \fIsprintf\fR as returning type \fIchar\ *\fR.
4427 No \fIMH\fR program ever uses \fIsprintf\fR\|'s return value, but this
4428 define prevents some compiler warnings.
4429 Be sure to enable \*(lqoptions\ SUN40\*(rq too.
4430
4431 .ti -.5i
4432 d549 1
4433 a549 1
4434 Use on AT&T SYSTEM 5 R3 (and newer?) UNIX system.  See also \fImailgroup\fR.
4435 d554 2
4436 a555 1
4437 Define this if your system uses struct dirent instead of struct direct.
4438 d677 1
4439 a677 1
4440 Makes libmh.a into a shared library (for SunOS 4.0).  
4441 @
4442
4443
4444 2.43
4445 log
4446 @*** empty log message ***
4447 @
4448 text
4449 @d1 1
4450 a1 1
4451 .\" @@(#)$Id: mh-gen.8,v 2.42 90/04/06 10:46:18 sources Exp Locker: sources $
4452 d9 2
4453 a10 2
4454 also want to familiarize yourself with the \fBMH\fP Administrator's
4455 Guide before you install \fBMH\fP.
4456 d55 2
4457 a56 2
4458 discussing code changes to \fBMH\fP.  \fBMH-Users\fP is for general
4459 discussion about how to use \fBMH\fP.
4460 d60 1
4461 a60 1
4462 Since you probably alread have MH, you may not need to read this
4463 d67 2
4464 a68 2
4465 (approx 1.5MB).  There should also be a \fBREADME\fR file in
4466 that directory which tells what the current release of \fBMH\fP
4467 d140 1
4468 a140 1
4469 Here are the \fIMH\fR configuraton options available:
4470 d532 1
4471 a532 1
4472 but it might be usefull for SYSTEM 5 or HPUX systems with TCP/IP sockets.
4473 d900 1
4474 a900 1
4475 then no futher MTS\-specific action is required on your part!
4476 @
4477
4478
4479 2.42
4480 log
4481 @*** empty log message ***
4482 @
4483 text
4484 @d1 1
4485 a1 1
4486 .\" @@(#)$Id: mh-gen.8,v 2.41 90/04/05 16:08:57 sources Exp Locker: sources $
4487 d7 5
4488 a11 1
4489 the UCI version of the RAND \fIMH\fR system.
4490 d40 1
4491 a40 1
4492 .PP
4493 @
4494
4495
4496 2.41
4497 log
4498 @Id
4499 @
4500 text
4501 @d1 1
4502 a1 1
4503 .\" @@(#)$Id:$
4504 d47 1
4505 d50 3
4506 a52 1
4507 and \fBMH\-Workers@@ICS.UCI.EDU\fR.
4508 d57 2
4509 a58 2
4510 unless you suspect you have an old version.  There are two ways 
4511 to get the latest release:
4512 d61 1
4513 a61 1
4514 ics.uci.edu [128.195.1.1] and retrieve the file pub/mh-6.6.tar.Z.
4515 d63 6
4516 a68 2
4517 (approx 1.5MB).  This file is also available on louie.udel.edu 
4518 [128.175.1.3] in portal/mh-6.tar.Z.  You may also find MH.6.6 on
4519 d77 1
4520 a77 1
4521 be made payable to
4522 d83 1
4523 d97 1
4524 a97 1
4525 still have to pay the $75.00.  The tar image has the documentation
4526 d297 2
4527 a298 1
4528 \&`\-D' options to \fIcc\fR\0(1).
4529 d321 1
4530 a321 1
4531 Directs \fIMH\fR to favor `!' over `@@'.
4532 d920 1
4533 a920 1
4534 Before proceeding,
4535 d938 2
4536 a939 2
4537 you should also read the \fImh.6\fR changes document.
4538 The sources are in \fBpapers/mh6.5/\fR.
4539 @
4540
4541
4542 2.40
4543 log
4544 @*** empty log message ***
4545 @
4546 text
4547 @d1 1
4548 @
4549
4550
4551 2.39
4552 log
4553 @add ID
4554 @
4555 text
4556 @a0 1
4557 .\" @@(#)$Id:$
4558 d502 2
4559 a503 2
4560 It appears that some Sendmails return this code when they
4561 don't mean to indicate a failure.
4562 d558 3
4563 a560 2
4564 The default is \fBint\fR, but SYSTEM 5 systems (V.3.0 and later)
4565 should probably set TYPESIG='void'.
4566 d671 11
4567 a681 3
4568 The directory where the MH shared library should go.  If you want to
4569 put it somewhere other than \fB/usr/lib\fR or \fB/usr/local/lib\fR
4570 (not advisable), you'll probably have to run \fIldconfig\fR\0(8).
4571 @
4572
4573
4574 2.38
4575 log
4576 @typo
4577 @
4578 text
4579 @d1 1
4580 @
4581
4582
4583 2.37
4584 log
4585 @RAND fixes
4586 @
4587 text
4588 @d483 1
4589 a483 1
4590 Directs \fIinc\fR to note UNIX From: lines as Return-Path: info.
4591 @
4592
4593
4594 2.36
4595 log
4596 @NTOHL -> NTOHLSWAP
4597 @
4598 text
4599 @d6 2
4600 a7 2
4601 the UCI version of the Rand \fIMH\fR system.
4602 Although the \fIMH\fR system was originally developed by the Rand Corporation,
4603 d9 1
4604 a9 1
4605 the Rand Corporation assumes no responsibility for \fIMH\fR
4606 d32 1
4607 a32 1
4608 the authors ask only that you provide appropriate credit to the Rand
4609 d36 1
4610 a36 1
4611 \fIMH\fR is a software package that is neither supported by the Rand
4612 d356 14
4613 @
4614
4615
4616 2.35
4617 log
4618 @add sprintf config option
4619 @
4620 text
4621 @d451 1
4622 a451 1
4623 NTOHL
4624 @
4625
4626
4627 2.34
4628 log
4629 @document WP
4630 @
4631 text
4632 @d640 8
4633 @
4634
4635
4636 2.33
4637 log
4638 @typo
4639 @
4640 text
4641 @d579 6
4642 @
4643
4644
4645 2.32
4646 log
4647 @typo
4648 @
4649 text
4650 @d940 1
4651 a940 1
4652 The other files under \fB/usr/spool/bboards/fR will be overwritten
4653 @
4654
4655
4656 2.31
4657 log
4658 @typo
4659 @
4660 text
4661 @d613 1
4662 a613 1
4663 Usually, \*(lq\-ns\*(rq is a good choice in any event.
4664 @
4665
4666
4667 2.30
4668 log
4669 @better documentation of BERK
4670 @
4671 text
4672 @d564 1
4673 a564 1
4674 This may conflict with the interpretation of this file by \fINewsfR.
4675 a595 1
4676
4677 @
4678
4679
4680 2.29
4681 log
4682 @don't suggest using options UCI
4683 @
4684 text
4685 @d317 3
4686 a319 3
4687 Makes a lot of simplifying assumptions that makes the code run a bit faster
4688 by disabling nearly all of the address and header-parsing routines.
4689 Unless you're on a really slow machine,
4690 @
4691
4692
4693 2.28
4694 log
4695 @make NTOHL positive
4696 @
4697 text
4698 @d565 1
4699 @
4700
4701
4702 2.27
4703 log
4704 @add some detail
4705 @
4706 text
4707 @d451 1
4708 a451 1
4709 NONTOHL
4710 d453 6
4711 a458 6
4712 Tells \fIMH\fR not to use the \fBntohl()\fR macro when processing
4713 \fImsh\fR binary map files.  \fIMH\fR uses this macro on 4BSD
4714 systems to byte-swap the binary information in these map files.
4715 If you need to be compatible with older versions of MH which did
4716 not do this, or aren't using the same map files on machines
4717 of different architectures, you probably want to define this option.
4718 @
4719
4720
4721 2.26
4722 log
4723 @redoc SUN41
4724 @
4725 text
4726 @d300 2
4727 a301 1
4728 \fIrepl\fR will assume `\-nocc\ all' as the default instead of `\-cc\ all'.
4729 d378 3
4730 a380 2
4731 Tells \fIrepl\fR to be more conservative in generating \*(lqcc:\*(rqs to the
4732 user.
4733 d386 1
4734 a386 1
4735 For example, LINK='\*(lq\\\\043\*(rq'.
4736 d401 1
4737 d519 1
4738 d561 4
4739 a564 1
4740 Third, support for \fB$HOME/.signature\fR files is enabled.
4741 @
4742
4743
4744 2.25
4745 log
4746 @"bbdeliver: {on,off}"
4747 @
4748 text
4749 @d512 4
4750 a515 4
4751 Apparently Sun and AT\&T have flip-flopped on whether 
4752 the long\-suffering \fIsprintf()\fR
4753 should return an \fIint\fR or \fIchar\ *\fR.  For Sun OS 4.1 this 
4754 option defines it as \fIchar\ *\fR.
4755 @
4756
4757
4758 2.24
4759 log
4760 @mention saving mtstailor, etc.
4761 @
4762 text
4763 @d225 1
4764 d232 18
4765 @
4766
4767
4768 2.23
4769 log
4770 @suggest BSD43 with SUN40
4771 @
4772 text
4773 @d897 1
4774 a897 1
4775 you may wish to preserve the following files:
4776 d902 2
4777 a903 2
4778 \fIdirectory\fR \fIfiles\fR
4779 etc/    MailAliases, mtstailor
4780 d909 9
4781 @
4782
4783
4784 2.22
4785 log
4786 @merge "nntpbboards" and "popbboards" into "bboards: nntp/pop"
4787 @
4788 text
4789 @d488 1
4790 a488 1
4791 \*(lqoptions BSD42\*(rq.
4792 @
4793
4794
4795 2.21
4796 log
4797 @*** empty log message ***
4798 @
4799 text
4800 @d223 1
4801 a223 1
4802 Support for the UCI BBoards facility.
4803 d225 6
4804 a264 14
4805
4806 .ti -.5i
4807 popbboards: off
4808 .br
4809 Support for the UCI BBoards facility via the POP service.
4810 Requires both bboards and pop to be enabled.
4811
4812 .ti -.5i
4813 nntpbboards: off
4814 .br
4815 Support for the UCI BBoards facility to read the Network News
4816 via the NNTP.
4817 Requires bboards to be enabled.  You cannot enable both
4818 popbboards and nntpbboards.
4819 @
4820
4821
4822 2.20
4823 log
4824 @describe BSD43 a little better
4825 @
4826 text
4827 @d332 2
4828 a333 1
4829 If your \fIopenlog()\fR syslog function takes three arguments instead of two,
4830 d336 1
4831 @
4832
4833
4834 2.19
4835 log
4836 @add SUN41
4837 @
4838 text
4839 @d332 3
4840 @
4841
4842
4843 2.18
4844 log
4845 @fix NONTOHL desc
4846 @
4847 text
4848 @d494 8
4849 d504 1
4850 a504 1
4851 Use on AT&T SYSTEM 5 UNIX system.  See also \fImailgroup\fR.
4852 @
4853
4854
4855 2.17
4856 log
4857 @doc NONTOHL
4858 @
4859 text
4860 @d435 4
4861 a438 4
4862 msh binary map files.  Normally, \fIMH\fR will use this macro to byte-swap
4863 binary information in \fImsh\fR map files.
4864 If you need to be compatible with older versions of MH,
4865 or aren't using the same map files on machines
4866 @
4867
4868
4869 2.16
4870 log
4871 @mention how to get MH
4872 @
4873 text
4874 @d432 10
4875 d558 1
4876 a558 1
4877 ccoptions: -O
4878 @
4879
4880
4881 2.15
4882 log
4883 @discourage TTYD use
4884 @
4885 text
4886 @d49 42
4887 a90 3
4888 As of July 1989, I understand that \fBMH\-Users\fR
4889 is being gatewayed into \fBcomp.mail.mh\fR, though I don't know
4890 if messages are gatewayed from the newsgroup back to the list.
4891 @
4892
4893
4894 2.14
4895 log
4896 @sharedlibs, and ccoptions -- minor doc updates
4897 @
4898 text
4899 @d460 1
4900 a460 1
4901 Support for TTYD.
4902 @
4903
4904
4905 2.13
4906 log
4907 @document DUMB a little better.
4908 @
4909 text
4910 @d509 1
4911 a509 1
4912 ccoptions:
4913 d513 2
4914 d516 1
4915 d562 3
4916 a564 1
4917 The directory where the MH shared library should go.
4918 d613 1
4919 a613 1
4920 % mhconfig MH
4921 @
4922
4923
4924 2.12
4925 log
4926 @SUN40/TYPESIG predefined
4927 @
4928 text
4929 @d309 2
4930 a310 1
4931 Directs \fIMH\fR to minimize address munging.
4932 @
4933
4934
4935 2.11
4936 log
4937 @minor documenting of SUN40/TYPESIG
4938 @
4939 text
4940 @d440 2
4941 a441 2
4942 Use on Sun OS 4.0 (and later?) systems.  You'll also want
4943 to set BSD42, BSD43, TYPESIG='void', and perhaps NFS.
4944 @
4945
4946
4947 2.10
4948 log
4949 @lex:
4950 @
4951 text
4952 @d440 2
4953 a441 1
4954 Use on Sun OS 4.0 (and later?) systems
4955 @
4956
4957
4958 2.9
4959 log
4960 @MAILGROUP stuff
4961 @
4962 text
4963 @d544 5
4964 @
4965
4966
4967 2.8
4968 log
4969 @SHADOW
4970 @
4971 text
4972 @d117 6
4973 d266 4
4974 a269 5
4975 Makes a lot of simplifying assumptions that makes the code run a bit faster;
4976 disables much of the address and header-parsing routines.
4977 Also enables one other change:
4978 \fIscan\fR has a -[no]reverse switch which does the obvious thing.
4979 \fIMH\fR purists hate this.
4980 d445 1
4981 a445 1
4982 Use on AT&T SYSTEM 5 UNIX system.
4983 a454 1
4984
4985 d500 5
4986 @
4987
4988
4989 2.7
4990 log
4991 @*** empty log message ***
4992 @
4993 text
4994 @d418 7
4995 @
4996
4997
4998 2.6
4999 log
5000 @TZNAME
5001 @
5002 text
5003 @d376 6
5004 @
5005
5006
5007 2.5
5008 log
5009 @*** empty log message ***
5010 @
5011 text
5012 @d452 7
5013 @
5014
5015
5016 2.4
5017 log
5018 @SOCKETS
5019 @
5020 text
5021 @d404 8
5022 d417 1
5023 a417 1
5024 but it might be usefull for SYSTEM 5 systems with TCP/IP sockets.
5025 @
5026
5027
5028 2.3
5029 log
5030 @*** empty log message ***
5031 @
5032 text
5033 @d153 1
5034 a153 1
5035 How \fIMH\fR shuld backup existing files when installing a new file.
5036 d163 1
5037 a163 1
5038 On 4.2BSD UNIX systems 
5039 d171 1
5040 a171 1
5041 for 4.2BSD UNIX systems,
5042 d201 1
5043 a201 1
5044 This option currently works only on 4BSD UNIX systems.
5045 d269 2
5046 a270 1
5047 If you are running with the BIND code under 4.{2,3}BSD,
5048 d402 8
5049 @
5050
5051
5052 2.2
5053 log
5054 @TYPESIG
5055 @
5056 text
5057 @d416 4
5058 a419 1
5059 This is true of System V Release 3.1 and later.
5060 @
5061
5062
5063 2.1
5064 log
5065 @defines for "make sys5"
5066 @
5067 text
5068 @d424 8
5069 @
5070
5071
5072 2.0
5073 log
5074 @changes for SUN40 shared libraries and NNTP under bbc
5075 @
5076 text
5077 @d539 2
5078 a540 1
5079 Now install the configured files into the source areas.
5080 @
5081
5082
5083 1.1
5084 log
5085 @Initial revision
5086 @
5087 text
5088 @d49 3
5089 a51 3
5090 If there is sufficient interest,
5091 corresponding Usenet news groups may be established along with the
5092 appropriate gateways.
5093 d201 1
5094 a201 1
5095 This option currently works only on 4.2BSD UNIX systems.
5096 d222 8
5097 d260 2
5098 a261 1
5099 Makes a lot of simplifying assumptions that makes the code run a bit faster.
5100 d273 1
5101 a273 1
5102 BSD42
5103 d275 1
5104 a275 1
5105 Use on Berkeley UNIX systems on or after 4.2BSD.
5106 d278 1
5107 a278 1
5108 BSD41A
5109 d280 1
5110 a280 1
5111 Use on 4.1a Berkeley UNIX systems.
5112 d403 5
5113 d413 6
5114 d485 11
5115 @