Took Cygnusisms out of the sysadmin guide. Tweaked install & user guides
authorJeff Bigler <jcb@mit.edu>
Thu, 5 Sep 1996 22:44:31 +0000 (22:44 +0000)
committerJeff Bigler <jcb@mit.edu>
Thu, 5 Sep 1996 22:44:31 +0000 (22:44 +0000)
git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@9035 dc483132-0cff-0310-8789-dd5450dbe970

doc/admin.texinfo
doc/cyg-install.texinfo
doc/user-guide.texinfo

index c90a0ef138fc0812269caae82545432577b68504..04bc322d4909eff638dbbceb6aea0fe8301897c4 100644 (file)
@@ -3,8 +3,8 @@
 @c definitions added by jcb.
 @c %**start of header
 @c guide
-@setfilename kerbnet-admin.info
-@settitle Kerb*Net System Administrator's Guide
+@setfilename kerberos-admin.info
+@settitle Kerberos V5 System Administrator's Guide
 @c @setchapternewpage odd                  @c chapter begins on next odd page
 @setchapternewpage on                   @c chapter begins on next page
 @smallbook                              @c Format for 7" X 9.25" paper
@@ -15,7 +15,7 @@
 @end iftex
 
 @include definitions.texinfo
-@set EDITION 0.9 beta
+@set EDITION b6-1
 
 @finalout                               @c don't print black warning boxes
 
@@ -50,7 +50,6 @@ installation.
 @c is:
 @c
 @c @node New Section Name
-
 @c @section New Section Name
 @c
 @c M-x texinfo-every-node-update will take care of calculating the
@@ -65,6 +64,7 @@ installation.
 * Updates::                     
 * Backups of Secure Hosts::     
 * Support::                     
+* Bug Reporting::               
 * Appendix::                    
 @end menu
 
@@ -73,10 +73,12 @@ installation.
 @node Introduction, How Kerberos Works, Top, Top
 @chapter Introduction
 
+@ifset CYGNUS
 Congratulations on your purchase of @value{PRODUCT}.  @value{COMPANY}
 believes @value{PRODUCT} provides the best network security available.
 Please let us know if we can be of assistance in getting your
 installation of @value{PRODUCT} set up and running.
+@end ifset
 
 @menu
 * Why Should I use Kerberos?::  
@@ -1643,6 +1645,7 @@ Security}, by David Curry, is also a good starting point.
 This will have to wait until the next release.  *sigh*
 @end ignore
 
+@ifset CYGNUS
 @node Updates, Backups of Secure Hosts, Application Servers, Top
 @chapter Updates
 
@@ -1697,6 +1700,7 @@ new release and change any symbolic links to point to the new programs.
 Other than any functionality changes in the programs, the upgrade should
 be completely user-transparent.
 @c Reference to upgrading from Kerberos V4 document, once it's written.
+@end ifset
 
 @node Backups of Secure Hosts, Support, Updates, Top
 @chapter Backups of Secure Hosts
@@ -1718,22 +1722,24 @@ backups are kept as secure as the host's root password.
 @node Backing Up the Kerberos Database,  , Backups of Secure Hosts, Backups of Secure Hosts
 @section Backing Up the Kerberos Database
 
-It is possible that the Kerberos database could be corrupted.  If this
-happens on one of the slave KDCs, you might never notice, since the next
-automatic propagation of the database would install a fresh copy.
-However, if it happens to the master KDC, the corrupted database would
-be propagated to all of the slaves during the next propagation.  For
-this reason, @value{COMPANY} recommends that you back up your Kerberos
-database regularly.  Because the master KDC is continuously dumping the
-database to a file in order to propagate it to the slave KDCs, it is a
-simple matter to have a cron job periodically copy the dump file to a
-secure machine elsewhere on your network.  (Of course, it is important
-to make the host where these backups are stored as secure as your KDCs,
-and to encrypt its transmission across your network.)  Then if your
-database becomes corrupted, you can load the most recent dump onto the
-master KDC.  (@xref{Restoring a Kerberos Database from a Dump File}.)
-
-@node Support, Appendix, Backups of Secure Hosts, Top
+As with any file, it is possible that your Kerberos database could
+become corrupted.  If this happens on one of the slave KDCs, you might
+never notice, since the next automatic propagation of the database would
+install a fresh copy.  However, if it happens to the master KDC, the
+corrupted database would be propagated to all of the slaves during the
+next propagation.  For this reason, @value{COMPANY} recommends that you
+back up your Kerberos database regularly.  Because the master KDC is
+continuously dumping the database to a file in order to propagate it to
+the slave KDCs, it is a simple matter to have a cron job periodically
+copy the dump file to a secure machine elsewhere on your network.  (Of
+course, it is important to make the host where these backups are stored
+as secure as your KDCs, and to encrypt its transmission across your
+network.)  Then if your database becomes corrupted, you can load the
+most recent dump onto the master KDC.  (@xref{Restoring a Kerberos
+Database from a Dump File}.)
+
+@ifset CYGNUS
+@node Support, Bug Reporting, Backups of Secure Hosts, Top
 @chapter Support
 
 @menu
@@ -1748,8 +1754,23 @@ master KDC.  (@xref{Restoring a Kerberos Database from a Dump File}.)
 @section Using sendpr
 
 @include send-pr.texinfo
-
-@node Appendix,  , Support, Top
+@end ifset
+
+@ifset MIT
+@node Bug Reporting, Appendix, Support, Top
+@chapter Bug Reporting
+
+In any complex software, there will be bugs. Please send bug reports or
+other problems you may uncover to the e-mail address
+@b{krb5-bugs@@mit.edu}.  Please mention which version of the Kerberos V5
+distribution you are using, and whether you have made any private
+changes.  Bug reports that include proposed fixes are especially
+welcome.  If you do include fixes, please send them using either context
+diffs or unified diffs (using @samp{diff -c} or @samp{diff -u},
+respectively).
+@end ifset
+
+@node Appendix,  , Bug Reporting, Top
 @appendix Appendix
 
 @menu
index 689987618081268241974b89c0f256ebd7ba1e9b..af6db45e0c91094da82d8e28625b477b6cbf9a4c 100644 (file)
@@ -19,7 +19,7 @@
 @end iftex
 
 @include definitions.texinfo
-@set EDITION 0.91 beta
+@set EDITION b6-1
 
 @finalout                               @c don't print black warning boxes
 
@@ -325,14 +325,14 @@ parallel.  To do this, have the master KDC propagate the database to one
 set of slaves, and then have each of these slaves propagate the database
 to additional slaves.
 
-@ifset MIT
+@ifclear CYGNUS
 
 @node Compiling @value{PRODUCT}, Installing @value{PRODUCT}, Realm Configuration Decisions, Top
 @chapter Compiling @value{PRODUCT}
 
 @include build.texinfo
 
-@end ifset
+@end ifclear
 
 @node Installing @value{PRODUCT}, Support, Compiling @value{PRODUCT}, Top
 @chapter Installing @value{PRODUCT}
index d62664ccd36387fb761e78b7e84f27c20fde3cde..67483a63f0f5ff40753eeb532bfeaa8eb35a9b93 100644 (file)
@@ -1,8 +1,8 @@
 \input texinfo @c -*-texinfo-*-
 @c %**start of header
 @c guide
-@setfilename KerbNet-User.info
-@settitle Kerb*Net UNIX User's Guide
+@setfilename kerberos-user.info
+@settitle Kerberos V5 UNIX User's Guide
 @setchapternewpage odd                  @c chapter begins on next odd page
 @c @setchapternewpage on                   @c chapter begins on next page
 @smallbook                              @c Format for 7" X 9.25" paper
@@ -14,7 +14,7 @@
 @end iftex
 
 @include definitions.texinfo
-@set EDITION 0.9 beta
+@set EDITION b6-1
 
 @finalout                               @c don't print black warning boxes
 
@@ -46,7 +46,6 @@ This file describes how to use the @value{PRODUCT} client programs.
 @c comand before each @section or @subsection!  All you need to enter
 @c is:
 @c
-
 @c @section New Section Name
 @c
 @c M-x texinfo-every-node-update will take care of calculating the
@@ -212,7 +211,7 @@ versions, when you type their command names.
 
 On many systems, Kerberos is built into the login program, and you get
 tickets automatically when you log in.  Other programs, such as
-@code{rsh}, @code{rcp}, @code{telnet}, and @code{rlogin}, can forward
+/@code{rsh}, @code{rcp}, @code{telnet}, and @code{rlogin}, can forward
 copies of your tickets to the remote host.  Most of these programs also
 automatically destroy your tickets when they exit.  However,
 @value{COMPANY} recommends that you explicitly destroy your Kerberos