fix core dump caused by writing to read-only memory
[unix-history] / usr / src / usr.sbin / sendmail / READ_ME
index 14d1471..982b82a 100644 (file)
@@ -1,5 +1,5 @@
 /*-
 /*-
- *     @(#)READ_ME     8.1 (Berkeley) %G%
+ *     @(#)READ_ME     8.5 (Berkeley) %G%
  */
 
                        SENDMAIL RELEASE 8
  */
 
                        SENDMAIL RELEASE 8
@@ -12,6 +12,39 @@ Report any bugs to sendmail@CS.Berkeley.EDU.
 The latest version of sendmail is kept on FTP.CS.Berkeley.EDU, directory
 /ucb/sendmail; check there for the latest revision.
 
 The latest version of sendmail is kept on FTP.CS.Berkeley.EDU, directory
 /ucb/sendmail; check there for the latest revision.
 
+
++--------------+
+| MANUAL PAGES |
++--------------+
+
+The sendmail manual pages use contemporary Berkeley troff macros.  If
+your system does not process these manual pages, you can pick up the
+new macros in a BSD Net/2 FTP site (e.g.  on FTP.UU.NET, the files
+/systems/unix/bsd-sources/share/tmac/me/strip.sed and
+/systems/unix/bsd-sources/share/tmac/*).
+
+The strip.sed file is only used in installation.
+
+After installation, edit tmac.doc and tmac.andoc to reflect the
+installation path of the tmac files.  Those files contain pointers to
+/usr/share/tmac/, and those pointers are not changed by the `make
+install` process.
+
+Rename the existing tmac.an to be tmac.an.old, and rename tmac.andoc
+to be tmac.an.
+
+tmac.an will choose between tmac.an.old, your old macros, or tmac.doc,
+which are the new macros, so that both the new man pages and the
+existing man pages will be translated properly.
+
+I'm also told that the groff distribution from MIT has a tmac.doc
+macro set that is compatible with these macros.
+
+
++--------------+
+| RELATED RFCS |
++--------------+
+
 There are several related RFCs that you may wish to read -- they are
 available via anonymous FTP to several sites, including nic.ddn.mil
 (directory rfc), ftp.nisc.sri.com (rfc), nis.nsf.net (RFC),
 There are several related RFCs that you may wish to read -- they are
 available via anonymous FTP to several sites, including nic.ddn.mil
 (directory rfc), ftp.nisc.sri.com (rfc), nis.nsf.net (RFC),
@@ -49,9 +82,10 @@ you to get this make from Net2 (available on many public FTP archives).
 Failing that, some directories have a "Makefile.dist" that will work on
 older versions of make (but don't have the niceties included).
 
 Failing that, some directories have a "Makefile.dist" that will work on
 older versions of make (but don't have the niceties included).
 
-Similar comments apply to the man pages -- they use the new Berkeley
--mandoc macros instead of the -man macros.  You can get these from
-Net2 as well.
+
++-------------------+
+| DATABASE ROUTINES |
++-------------------+
 
 IF YOU WANT TO RUN THE NEW BERKELEY DB SOFTWARE:  ****  DO NOT  ****
 use the version that was on the Net2 tape -- it has a number of
 
 IF YOU WANT TO RUN THE NEW BERKELEY DB SOFTWARE:  ****  DO NOT  ****
 use the version that was on the Net2 tape -- it has a number of
@@ -63,6 +97,11 @@ faster, and the interface is nicer to animals and plants.  You will
 also probably find that you have to add -I/where/you/put/db/include
 to the sendmail makefile to get db.h to work properly.
 
 also probably find that you have to add -I/where/you/put/db/include
 to the sendmail makefile to get db.h to work properly.
 
+
++---------------------+
+| DIRECTORY STRUCTURE |
++---------------------+
+
 The structure of this directory tree is:
 
 cf             Source for Berkeley configuration files.  These are
 The structure of this directory tree is:
 
 cf             Source for Berkeley configuration files.  These are
@@ -92,3 +131,4 @@ rmail                Source for rmail(8).  This is used as a delivery
                other non-socket oriented mailers.  Older versions of
                rmail are probably deficient.
 src            Source for the sendmail program itself.
                other non-socket oriented mailers.  Older versions of
                rmail are probably deficient.
 src            Source for the sendmail program itself.
+test           Some test scripts (currently only for compilation aids).