Fixing typos.
[sfrench/samba-autobuild/.git] / docs / docbook / projdoc / samba-doc.sgml
index f1211c0ac6a92d14872d7dffe121cf2613661f6b..a729caf99fff81699ceadf6931c06fc16de90f72 100644 (file)
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
-<!ENTITY UNIX-INSTALL SYSTEM "UNIX_INSTALL.sgml">
-<!ENTITY ENCRYPTION SYSTEM "ENCRYPTION.sgml">
-<!ENTITY MS-Dfs-Setup SYSTEM "msdfs_setup.sgml">
-<!ENTITY PRINTER-DRIVER2 SYSTEM "printer_driver2.sgml">
-<!ENTITY DOMAIN-MEMBER SYSTEM "DOMAIN_MEMBER.sgml">
-<!ENTITY WINBIND SYSTEM "winbind.sgml">
-<!ENTITY NT-Security SYSTEM "NT_Security.sgml">
-<!ENTITY OS2-Client SYSTEM "OS2-Client-HOWTO.sgml">
-<!ENTITY Samba-PDC-HOWTO SYSTEM "Samba-PDC-HOWTO.sgml">
-<!ENTITY CVS-Access SYSTEM "CVS-Access.sgml">
-<!ENTITY IntegratingWithWindows SYSTEM "Integrating-with-Windows.sgml">
-<!ENTITY Samba-PAM SYSTEM "PAM-Authentication-And-Samba.sgml">
-<!ENTITY INDEX-FILE SYSTEM "index.sgml">
+<!ENTITY % globalentities SYSTEM '../global.ent'> %globalentities;
 ]>
 
-<book id="Samba-Project-Documentation">
-
+<book id="Samba-HOWTO-Collection">
 <title>SAMBA Project Documentation</title>
 
 <bookinfo>
        <author>
-               <surname>SAMBA Team</surname>
+               <othername>SAMBA Team</othername>
+               <affiliation><address><email>samba@samba.org</email></address></affiliation>
        </author>
-       <address><email>samba@samba.org</email></address>
-</bookinfo>
+       <editor>&person.jelmer;</editor>
+       <editor>&person.jht;</editor>
+       <editor>&person.jerry;</editor>
 
-<dedication>
-<title>Abstract</title>
+       <pubdate>Monday April 21, 2003</pubdate>
 
+<abstract>
 <para>
-<emphasis>Last Update</emphasis> : Tue Jul 31 15:58:03 CDT 2001
+This book is a collection of HOWTOs added to Samba documentation over the years.
+Samba is always under development, and so is its' documentation. This release of the
+documentation represents a major revision or layout as well as contents.
+The most recent version of this document can be found at
+<ulink url="http://www.samba.org/">http://www.samba.org/</ulink>
+on the "Documentation" page.  Please send updates to
+<ulink url="mailto:jelmer@samba.org">jelmer@samba.org</ulink>,
+<ulink url="mailto:jht@samba.org">jht@samba.org</ulink> or
+<ulink url="mailto:jerry@samba.org">jerry@samba.org</ulink>.
 </para>
 
 <para>
-This book is a collection of HOWTOs added to Samba documentation over the years.
-I try to ensure that all are current, but sometimes the is a larger job
-than one person can maintain.  The most recent version of this document
-can be found at <ulink url="http://www.samba.org/">http://www.samba.org/</ulink>
-on the "Documentation" page.  Please send updates to <ulink 
-url="mailto:jerry@samba.org">jerry@samba.org</ulink>.
+The Samba-Team would like to express sincere thanks to the many people who have with
+or without their knowledge contributed to this update. The size and scope of this
+project would not have been possible without significant community contribution. A not
+insignificant number of ideas for inclusion (if not content itself) has been obtained
+from a number of Unofficial HOWTOs - to each such author a big "Thank-you" is also offered.
+Please keep publishing your Unofficial HOWTO's - they are a source of inspiration and
+application knowledge that is most to be desired by many Samba users and administrators.
 </para>
 
+</abstract>
+<legalnotice>
 <para>
-Cheers, jerry
+This documentation is distributed under the GNU General Public License (GPL) 
+version 2.  A copy of the license is included with the Samba source
+distribution.  A copy can be found on-line at <ulink 
+url="http://www.fsf.org/licenses/gpl.txt">http://www.fsf.org/licenses/gpl.txt</ulink>
 </para>
+</legalnotice>
+</bookinfo>
 
-</dedication>
 
 <!-- Chapters -->
+<part id="introduction">
+<title>General Installation</title>
+<partintro>
+<title>Preparing Samba for Configuration</title>
+<para>This section of the Samba-HOWTO-Collection contains general info on how to install samba 
+and how to configure the parts of samba you will most likely need.
+PLEASE read this.</para>
+</partintro>
+&IntroSMB;
 &UNIX-INSTALL;
-&IntegratingWithWindows;
-&Samba-PAM;
-&MS-Dfs-Setup;
+</part>
+
+<part id="type">
+<title>Server Configuration Basics</title>
+<partintro>
+<title>First Steps in Server Configuration</title>
+<para>
+Samba can operate in various modes within SMB networks. This HOWTO section contains information on
+configuring samba to function as the type of server your network requires. Please read this
+section carefully.
+</para>
+</partintro>
+&ServerType;
+&SECURITY-LEVEL;
+&Samba-PDC-HOWTO;
+&Samba-BDC-HOWTO;
+&ADS-HOWTO;
+&DOMAIN-MEMBER;
+</part>
+
+<part id="optional">
+<title>Advanced Configuration</title>
+<partintro>
+<title>Valuable Nuts and Bolts Information</title>
+<para>
+Samba has several features that you might want or might not want to use. The chapters in this part each cover specific Samba features.
+</para>
+</partintro>
+&NetworkBrowsing;
+&Passdb;
 &NT-Security;
+&GROUP-MAPPING-HOWTO;
 &PRINTER-DRIVER2;
-&DOMAIN-MEMBER;
-&Samba-PDC-HOWTO;
+&CUPS;
 &WINBIND;
-&OS2-Client;
-&CVS-Access;
+&AdvancedNetworkAdmin;
+&PolicyMgmt;
+&ProfileMgmt;
+&Trusts;
+&Samba-PAM;
+&VFS;
+&MS-Dfs-Setup;
+&IntegratingWithWindows;
+&SecuringSamba;
+&unicode;
+&locking;
+</part>
 
-<!-- Autogenerated Index -->
-&INDEX-FILE;
+<part id="troubleshooting">
+<title>Troubleshooting</title>
+&Diagnosis;
+&problems;
+&BUGS;
+</part>
 
+<part id="Appendixes">
+<title>Appendixes</title>
+&Compiling;
+&NT4Migration;
+&Portability;
+&Other-Clients;
+&SWAT;
+&SPEED;
+</part>
 </book>