Use more stricter syntax and work towards Docbook XML migration
[gd/samba/.git] / docs / docbook / projdoc / samba-doc.sgml
index 75c5c379d32386d6992ae536414c9999a20a64f5..3c6028e61cdf4d9cb481a2c35209ef5d02f7239f 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 Samba-PDC-HOWTO SYSTEM "Samba-PDC-HOWTO.sgml">
-<!ENTITY Samba-BDC-HOWTO SYSTEM "Samba-BDC-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 Samba-LDAP SYSTEM "Samba-LDAP-HOWTO.sgml">
-<!ENTITY Diagnosis SYSTEM "Diagnosis.sgml">
-<!ENTITY PRINTING SYSTEM "Printing.sgml">
-<!ENTITY BUGS SYSTEM "Bugs.sgml">
-<!ENTITY SECURITY-LEVEL SYSTEM "security_level.sgml">
-<!ENTITY SPEED SYSTEM "Speed.sgml">
-<!ENTITY BROWSING SYSTEM "Browsing.sgml">
-<!ENTITY GROUP-MAPPING-HOWTO SYSTEM "GROUP-MAPPING-HOWTO.sgml">
-<!ENTITY Portability SYSTEM "Portability.sgml">
-<!ENTITY Other-Clients SYSTEM "Other-Clients.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>
-
-<dedication>
-<title>Abstract</title>
+       <editor>&person.jht;</editor>
+       <editor>&person.jelmer;</editor>
+       <editor>&person.jerry;</editor>
 
-<para>
-<emphasis>Last Update</emphasis> : Thu Aug 15 12:48:45 CDT 2002
-</para>
+       <pubdate>Sunday 6 April</pubdate>
 
+<abstract>
 <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
+Samba is always under development, and so is it's documentation.
+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>.
+url="mailto:jerry@samba.org">jerry@samba.org</ulink> or 
+<ulink url="mailto:jelmer@samba.org">jelmer@samba.org</ulink>.
 </para>
 
+</abstract>
+<legalnotice>
 <para>
 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>
 
-<para>
-Cheers, jerry
-</para>
-
-</dedication>
 
 <!-- Chapters -->
+<part id="introduction">
+<title>General installation</title>
+<partintro>
+<title>Introduction</title>
+<para>This part 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>
 &UNIX-INSTALL;
-&Diagnosis;
-&IntegratingWithWindows;
-&Samba-PAM;
-&MS-Dfs-Setup;
-&NT-Security;
-&PRINTER-DRIVER2;
-&PRINTING;
+&BROWSING-Quick;
+&Passdb;
+</part>
+
+<part id="type">
+<title>Type of installation</title>
+<partintro>
+<title>Introduction</title>
+<para>
+Samba can operate in various SMB networks. This part contains information on configuring samba 
+for various environments.
+</para>
+</partintro>
+&ServerType;
 &SECURITY-LEVEL;
-&DOMAIN-MEMBER;
-&WINBIND;
 &Samba-PDC-HOWTO;
 &Samba-BDC-HOWTO;
-&Samba-LDAP;
+&ADS-HOWTO;
+&DOMAIN-MEMBER;
+</part>
+
+<part id="optional">
+<title>Advanced Configuration</title>
+<partintro>
+<title>Introduction</title>
+<para>Samba has several features that you might want or might not want to use. The chapters in this part each cover one specific feature.</para>
+</partintro>
+&NT-Security;
+&GROUP-MAPPING-HOWTO;
+&PRINTER-DRIVER2;
+&CUPS;
+&WINBIND;
+&AdvancedNetworkAdmin;
+&PolicyMgmt;
+&ProfileMgmt;
+&Trusts;
+&Samba-PAM;
+&VFS;
+&MS-Dfs-Setup;
+&IntegratingWithWindows;
 &BROWSING;
-&SPEED;
+&SecuringSamba;
+&unicode;
+</part>
+
+<part id="Appendixes">
+<title>Appendixes</title>
+&Compiling;
+&NT4Migration;
+&Portability;
 &Other-Clients;
-&CVS-Access;
+&SWAT;
+&SPEED;
+&Diagnosis;
+&problems;
 &BUGS;
-&GROUP-MAPPING-HOWTO;
-&Portability;
-
+</part>
 </book>