Use more stricter syntax and work towards Docbook XML migration
[gd/samba/.git] / docs / docbook / projdoc / samba-doc.sgml
index ce16405d54d2c0e0de48d3cf35624c4bd14fd966..3c6028e61cdf4d9cb481a2c35209ef5d02f7239f 100644 (file)
@@ -1,73 +1,43 @@
 <!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 BUGS SYSTEM "Bugs.sgml">
-<!ENTITY SECURITY-LEVEL SYSTEM "security_level.sgml">
-<!ENTITY SPEED SYSTEM "Speed.sgml">
-<!ENTITY BROWSING SYSTEM "Browsing.sgml">
-<!ENTITY BROWSING-Quick SYSTEM "Browsing-Quickguide.sgml">
-<!ENTITY GROUP-MAPPING-HOWTO SYSTEM "GROUP-MAPPING-HOWTO.sgml">
-<!ENTITY Portability SYSTEM "Portability.sgml">
-<!ENTITY Other-Clients SYSTEM "Other-Clients.sgml">
-<!ENTITY ADS-HOWTO SYSTEM "ADS-HOWTO.sgml">
-<!ENTITY oplocks SYSTEM "oplocks.sgml">
-<!ENTITY pdb-mysql SYSTEM "pdb_mysql.sgml">
-<!ENTITY pdb-xml SYSTEM "pdb_xml.sgml">
-<!ENTITY VFS SYSTEM "VFS.sgml">
+<!ENTITY % globalentities SYSTEM '../global.ent'> %globalentities;
 ]>
 
 <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> : $Date: 2002/11/13 15:34:49 $
-</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> 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">
@@ -79,10 +49,8 @@ and how to configure the parts of samba you will most likely need.
 PLEASE read this.</para>
 </partintro>
 &UNIX-INSTALL;
-&BROWSING;
-&oplocks;
 &BROWSING-Quick;
-&ENCRYPTION;
+&Passdb;
 </part>
 
 <part id="type">
@@ -94,6 +62,7 @@ Samba can operate in various SMB networks. This part contains information on con
 for various environments.
 </para>
 </partintro>
+&ServerType;
 &SECURITY-LEVEL;
 &Samba-PDC-HOWTO;
 &Samba-BDC-HOWTO;
@@ -102,33 +71,39 @@ for various environments.
 </part>
 
 <part id="optional">
-<title>Optional configuration</title>
+<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>
+<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>
-&IntegratingWithWindows;
 &NT-Security;
-&Samba-PAM;
-&MS-Dfs-Setup;
+&GROUP-MAPPING-HOWTO;
 &PRINTER-DRIVER2;
+&CUPS;
 &WINBIND;
-&pdb-mysql;
-&pdb-xml;
+&AdvancedNetworkAdmin;
+&PolicyMgmt;
+&ProfileMgmt;
+&Trusts;
+&Samba-PAM;
 &VFS;
-&Samba-LDAP;
-&CVS-Access;
-&GROUP-MAPPING-HOWTO;
-&SPEED;
+&MS-Dfs-Setup;
+&IntegratingWithWindows;
+&BROWSING;
+&SecuringSamba;
+&unicode;
 </part>
 
 <part id="Appendixes">
 <title>Appendixes</title>
+&Compiling;
+&NT4Migration;
 &Portability;
 &Other-Clients;
-&BUGS;
+&SWAT;
+&SPEED;
 &Diagnosis;
+&problems;
+&BUGS;
 </part>
-
 </book>