Use entities and add overview of directories

(This used to be commit 5957e3bf33e8992eda620a6ab0b4f8a1dbe8cb7a)

diff --git a/docs/docbook/devdoc/Tracing.sgml b/docs/docbook/devdoc/Tracing.sgml
index ccf1e1c3c849cecb88ea220461952e51b4f215e5..f55c47bc4e9ab44bbbd4ef81f7035a8310187827 100644 (file)
--- a/docs/docbook/devdoc/Tracing.sgml
+++ b/docs/docbook/devdoc/Tracing.sgml
@@ -1,11 +1,6 @@
 <chapter id="tracing">
 <chapterinfo>
-       <author>
-               <firstname>Andrew</firstname><surname>Tridgell</surname>
-               <affiliation>
-                       <orgname>Samba Team</orgname>
-               </affiliation>
-       </author>
+       &author.tridge;
 </chapterinfo>
 
 <title>Tracing samba system calls</title>

diff --git a/docs/docbook/devdoc/architecture.sgml b/docs/docbook/devdoc/architecture.sgml
index 312a63af97ec82d25a66f7339770f0337d6c11e6..e05039054b054b4c215db934decd9bc29476beef 100644 (file)
--- a/docs/docbook/devdoc/architecture.sgml
+++ b/docs/docbook/devdoc/architecture.sgml
@@ -4,6 +4,7 @@
                <firstname>Dan</firstname><surname>Shearer</surname>
        </author>
        <pubdate> November 1997</pubdate>
+       &author.jelmer;
 </chapterinfo>
 
 <title>Samba Architecture</title>
@@ -181,4 +182,56 @@ for browsing and WINS support.
 </para>
 
 </sect1>
+
+<sect1>
+<title>Samba's subsystems</title>
+
+<para>Samba's <filename>source/</filename> directory contains quite some directories. Here's a small explanation of what each of them contains.</para>
+
+<simplelist>
+<member>aparser - Obsolete</member>
+<member>auth - The authentication subsystem, maintained by Andrew Bartlett</member>
+<member>bin - Output directory for all the binary files</member>
+<member>client - Contains 'plain' SMB client sources: smbclient and 
+some mount help utilities</member>
+<member>groupdb - Group database and mapping code</member>
+<member>include - All of samba's include files</member>
+<member>intl - Internationalization files. Not used at the moment.</member>
+<member>lib - General C helper functions. Not SMB-specific.</member>
+<member>libads - Library with ActiveDirectory related functions.</member>
+<member>libsmb - Library with SMB specific functions.</member>
+<member>locking - Locking functions!</member>
+<member>modules - Source files for various modules (VFS and charset).</member>
+<member>msdfs - DCE-DFS code</member>
+<member>nmbd - Code for the nmbd daemon</member>
+<member>nsswitch - Winbind source code</member>
+<member>pam_smbpass - Source code for pam module for authenticating against samba's passdb</member>
+<member>param - smb.conf parsing code</member>
+<member>passdb - User database(SAM) code with the various backends</member>
+<member>po - Internationalisation code - not used atm</member>
+<member>popt - Samba's internal copy of the popt library</member>
+<member>printing - Printing stuff</member>
+<member>profile - Profiling support</member>
+<member>python - Python bindings for various libsmb functions</member>
+<member>registry - Registry backend</member>
+<member>rpc_client - RPC Client library for making remote procedure calls</member>
+<member>rpc_parse - Functions for parsing RPC structures (???)</member>
+<member>rpc_server - Functions for being an RPC server</member>
+<member>rpcclient - Command-line client that is a basically a front-end to rpc_client/</member>
+<member>sam - Code for the new (but unused) SAM</member>
+<member>script - Various scripts</member>
+<member>smbd - Source code for the smbd daemon</member>
+<member>smbwrapper - Source code for library that overloads VFS function calls, for usage with LD_PRELOAD=...</member>
+<member>stf - Testsuite system?</member>
+<member>tdb - Source code of samba's Trivial Database (much like gdbm)</member>
+<member>tests - Source code for the larger tests used by configure</member>
+<member>torture - 'Torture' utilities, used for testing samba and other cifs servers</member>
+<member>ubiqx - The ubiqx library from Chris Hertel</member>
+<member>utils - Various small utilities(pdbedit, net, etc)</member>
+<member>web - SWAT sourcecode</member>
+<member>wrepld - Sourcecode of the WINS replication daemon</member>
+</simplelist>
+
+</sect1>
+
 </chapter>

diff --git a/docs/docbook/devdoc/dev-doc.sgml b/docs/docbook/devdoc/dev-doc.sgml
index 5e1af3d3a0354acc8f1fddb2a9c9bb3cf09ffd59..ee2a40535d82d4a7b76cb656624dce3bf5ea3b3f 100644 (file)
--- a/docs/docbook/devdoc/dev-doc.sgml
+++ b/docs/docbook/devdoc/dev-doc.sgml
@@ -1,4 +1,5 @@
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
+<!ENTITY % globalentities SYSTEM '../global.ent'> %globalentities;
 <!ENTITY NetBIOS SYSTEM "NetBIOS.sgml">
 <!ENTITY Architecture SYSTEM "architecture.sgml">
 <!ENTITY debug SYSTEM "debug.sgml">
@@ -26,6 +27,7 @@
                <surname>SAMBA Team</surname>
        </author>
        <address><email>samba@samba.org</email></address>
+    <editor>&person.jelmer;</editor>
 </bookinfo>
 
 <dedication>

diff --git a/docs/docbook/devdoc/encryption.sgml b/docs/docbook/devdoc/encryption.sgml
index 3ca8aa109c08f82a0fa0949c8f94bb5f5c4e221c..64ff4262cb59d31ea04940528ffc02d2a6dbcd3e 100644 (file)
--- a/docs/docbook/devdoc/encryption.sgml
+++ b/docs/docbook/devdoc/encryption.sgml
@@ -2,16 +2,7 @@
 
 
 <chapterinfo>
-       <author>
-               <firstname>Jeremy</firstname><surname>Allison</surname>
-               <affiliation>
-                       <orgname>Samba Team</orgname>
-                       <address>
-                               <email>samba@samba.org</email>
-                       </address>
-               </affiliation>
-       </author>
-
+       &author.jeremy;
        <pubdate>19 Apr 1999</pubdate>
 </chapterinfo>
        

diff --git a/docs/docbook/devdoc/gencache.sgml b/docs/docbook/devdoc/gencache.sgml
index 1ba2f77c9d4b9c81f767931d38df2568ff88bfcc..096bdce7896910bdc30a0751d8e3389f6810ceac 100644 (file)
--- a/docs/docbook/devdoc/gencache.sgml
+++ b/docs/docbook/devdoc/gencache.sgml
@@ -1,8 +1,6 @@
 <chapter id="gencache">
 <chapterinfo>
-       <author>
-               <firstname>Rafal</firstname><surname>Szczesniak</surname>
-       </author>
+       &author.mimir;
        <pubdate>April 2003</pubdate>
 </chapterinfo>
 

diff --git a/docs/docbook/devdoc/modules.sgml b/docs/docbook/devdoc/modules.sgml
index 0bcdadc66ce5f6c0b24299560141be50b3af08e4..c43e8a91180983c01f3544c48471bf0c0172013b 100644 (file)
--- a/docs/docbook/devdoc/modules.sgml
+++ b/docs/docbook/devdoc/modules.sgml
@@ -1,12 +1,6 @@
 <chapter id="modules">
 <chapterinfo>
-       <author>
-               <firstname>Jelmer</firstname><surname>Vernooij</surname>
-               <affiliation>
-                       <orgname>Samba Team</orgname>
-                       <address><email>jelmer@samba.org</email></address>
-               </affiliation>
-       </author>
+       &author.jelmer;
        <pubdate> 19 March 2003 </pubdate>
 </chapterinfo>
 

diff --git a/docs/docbook/devdoc/packagers.sgml b/docs/docbook/devdoc/packagers.sgml
index fb47c7305c359fd03f8a776d2b68858b39834277..edc581cf057698c2f6ee36d6c84b76cde897ada5 100644 (file)
--- a/docs/docbook/devdoc/packagers.sgml
+++ b/docs/docbook/devdoc/packagers.sgml
@@ -1,8 +1,6 @@
 <chapter id="Packaging">
 <chapterinfo>
-       <author>
-               <firstname>Jelmer</firstname><surname>Vernooij</surname>
-       </author>
+       &author.jelmer;
 </chapterinfo>
 
 <title>Notes to packagers</title>

diff --git a/docs/docbook/devdoc/printing.sgml b/docs/docbook/devdoc/printing.sgml
index 363b9fb6e50bab052313d806f21f23387a418753..150652ac37a35a9231e7b9ab38ddf384ca17745d 100644 (file)
--- a/docs/docbook/devdoc/printing.sgml
+++ b/docs/docbook/devdoc/printing.sgml
@@ -1,8 +1,6 @@
 <chapter id="printing">
 <chapterinfo>
-       <author>
-               <firstname>Gerald</firstname><surname>Carter</surname>
-       </author>
+       &author.jerry;
        <pubdate>October 2002</pubdate>
 </chapterinfo>
 

diff --git a/docs/docbook/devdoc/rpc_plugin.sgml b/docs/docbook/devdoc/rpc_plugin.sgml
index c83742a2476a02ff175dbd576a87d05f0e166fa0..a2d1bd4c356ccdd153cdf98afca507a6c33bbf03 100644 (file)
--- a/docs/docbook/devdoc/rpc_plugin.sgml
+++ b/docs/docbook/devdoc/rpc_plugin.sgml
@@ -7,13 +7,7 @@
                        <address><email>aliguor@us.ibm.com</email></address>
                </affiliation>
        </author>
-       <author>
-               <firstname>Jelmer</firstname><surname>Vernooij</surname>
-               <affiliation>
-                       <orgname>Samba Team</orgname>
-                       <address><email>jelmer@samba.org</email></address>
-               </affiliation>
-       </author>
+       &author.jelmer;
        <pubdate>January 2003</pubdate>
 </chapterinfo>
 

diff --git a/docs/docbook/devdoc/sam.sgml b/docs/docbook/devdoc/sam.sgml
index 84c17d65e26123590d613b0d384f4563ffc3e56a..d4c065ca2101322270076e7db092598ed63e25d4 100644 (file)
--- a/docs/docbook/devdoc/sam.sgml
+++ b/docs/docbook/devdoc/sam.sgml
@@ -9,6 +9,9 @@
 
 <title>The Upcoming SAM System</title>
 
+<note><para>The design as described in this document is _NOT_ the design that 
+made it into samba 3.0. </para></note>
+
 <sect1>
 <title>Security in the 'new SAM'</title>
 

diff --git a/docs/docbook/devdoc/unix-smb.sgml b/docs/docbook/devdoc/unix-smb.sgml
index d6a658089c40cb28e2ae9a4a40d875b639e3b5c7..eea02012e01548d5aa17b979f8926f8f15131017 100644 (file)
--- a/docs/docbook/devdoc/unix-smb.sgml
+++ b/docs/docbook/devdoc/unix-smb.sgml
@@ -1,8 +1,6 @@
 <chapter id="unix-smb">
 <chapterinfo>
-       <author>
-               <firstname>Andrew</firstname><surname>Tridgell</surname>
-       </author>
+       &author.tridge;
        <pubdate>April 1995</pubdate>
 </chapterinfo>
 

diff --git a/docs/docbook/devdoc/wins.sgml b/docs/docbook/devdoc/wins.sgml
index 53410316c567d8fa295a3f751a9bbf3b7db2d0b2..5cdf760406bc4d53e00d01df7a3a581301d4af9a 100644 (file)
--- a/docs/docbook/devdoc/wins.sgml
+++ b/docs/docbook/devdoc/wins.sgml
@@ -1,8 +1,6 @@
 <chapter id="wins">
 <chapterinfo>
-       <author>
-               <firstname>Gerald</firstname><surname>Carter</surname>
-       </author>
+       &author.jerry;
        <pubdate>October 2002</pubdate>
 </chapterinfo>