Follow DTD more strictly

diff --git a/docs/docbook/projdoc/AccessControls.xml b/docs/docbook/projdoc/AccessControls.xml
index 6d3e4942267ad1e468725a444bc06c9c414b90ab..2badb828100752044be22fee2954e09ce1747f29 100644 (file)
--- a/docs/docbook/projdoc/AccessControls.xml
+++ b/docs/docbook/projdoc/AccessControls.xml
@@ -872,7 +872,7 @@ Before using any of the following options, please refer to the man page for &smb
                </para>
 
                <para>
-               <command><quote>SERVER\user (Long name)</quote></command>
+                       <command>"SERVER\user (Long name)"</command>
                </para>
 
                <para>
@@ -1027,10 +1027,10 @@ Before using any of the following options, please refer to the man page for &smb
                These are:
 
                <itemizedlist>
-                       <listitem><smbconfoption><name>security mask</name></smbconfoption></listitem>
-                       <listitem><smbconfoption><name>force security mode</name></smbconfoption></listitem>
-                       <listitem><smbconfoption><name>directory security mask</name></smbconfoption></listitem>
-                       <listitem><smbconfoption><name>force directory security mode</name></smbconfoption></listitem>
+                       <listitem><para><smbconfoption><name>security mask</name></smbconfoption></para></listitem>
+                       <listitem><para><smbconfoption><name>force security mode</name></smbconfoption></para></listitem>
+                       <listitem><para><smbconfoption><name>directory security mask</name></smbconfoption></para></listitem>
+                       <listitem><para><smbconfoption><name>force directory security mode</name></smbconfoption></para></listitem>
                </itemizedlist>
 
                </para>
@@ -1187,8 +1187,8 @@ are examples taken from the mailing list in recent times.
 </screen>
                        </para>
 
-                       <note><para>
-                               <para>This is the same as doing:</para>
+                       <note>
+                               <para>This is the same as doing:
 <screen>
 &prompt;<userinput>chown jack /foodbar</userinput>
 &prompt;<userinput>chgrp engr /foodbar</userinput>

diff --git a/docs/docbook/projdoc/AdvancedNetworkAdmin.xml b/docs/docbook/projdoc/AdvancedNetworkAdmin.xml
index 65d50b496e54e69c93765768e31ec27516d22b99..3534074b2c1cdb952705d4247f985e8a209dbd6b 100644 (file)
--- a/docs/docbook/projdoc/AdvancedNetworkAdmin.xml
+++ b/docs/docbook/projdoc/AdvancedNetworkAdmin.xml
@@ -53,9 +53,9 @@ on <application>Windows 9x/Me</application> systems. The tools set includes:
 </para>
 
 <itemizedlist>
-       <listitem>Server Manager</listitem>
-       <listitem>User Manager for Domains</listitem>
-       <listitem>Event Viewer</listitem>
+       <listitem><para>Server Manager</para></listitem>
+       <listitem><para>User Manager for Domains</para></listitem>
+       <listitem><para>Event Viewer</para></listitem>
 </itemizedlist>
 
 <para>
@@ -219,12 +219,12 @@ There are several opportunities for creating a custom network startup configurat
 </para>
 
 <itemizedlist>
-       <listitem>No Logon Script.</listitem>
-       <listitem>Simple universal Logon Script that applies to all users.</listitem>
-       <listitem>Use of a conditional Logon Script that applies per user or per group attributes.</listitem>
-       <listitem>Use of Samba's preexec and postexec functions on access to the NETLOGON share to create
-       a custom logon script and then execute it.</listitem>
-       <listitem>User of a tool such as KixStart.</listitem>
+       <listitem><para>No Logon Script.</para></listitem>
+       <listitem><para>Simple universal Logon Script that applies to all users.</para></listitem>
+       <listitem><para>Use of a conditional Logon Script that applies per user or per group attributes.</para></listitem>
+       <listitem><para>Use of Samba's preexec and postexec functions on access to the NETLOGON share to create
+       a custom logon script and then execute it.</para></listitem>
+       <listitem><para>User of a tool such as KixStart.</para></listitem>
 </itemizedlist>
 
 <para>
@@ -323,8 +323,8 @@ Those wishing to use more elaborate or capable logon processing system should ch
 </para>
 
 <itemizedlist>
-       <listitem><ulink noescape="1" url="http://www.craigelachi.e.org/rhacer/ntlogon">http://www.craigelachi.e.org/rhacer/ntlogon</ulink></listitem>
-       <listitem><ulink noescape="1" url="http://www.kixtart.org">http://www.kixtart.org</ulink></listitem>
+       <listitem><para><ulink noescape="1" url="http://www.craigelachi.e.org/rhacer/ntlogon">http://www.craigelachi.e.org/rhacer/ntlogon</ulink></para></listitem>
+       <listitem><para><ulink noescape="1" url="http://www.kixtart.org">http://www.kixtart.org</ulink></para></listitem>
 </itemizedlist>
 
 <sect2>

diff --git a/docs/docbook/projdoc/CUPS-printing.xml b/docs/docbook/projdoc/CUPS-printing.xml
index ece3b2acd1538cf1e8f4882e34d71a833d9076d4..ac1bb915c1c5492a907db5bce278acb8e82e1568 100644 (file)
--- a/docs/docbook/projdoc/CUPS-printing.xml
+++ b/docs/docbook/projdoc/CUPS-printing.xml
@@ -588,7 +588,7 @@ libcups.so.2 => /usr/lib/libcups.so.2 (0x40123000)
 
        <para>
 
-       <image><imagedescription>Windows printing to a local printer.</imagedescription><imagefile>1small</imagefile></image>
+       <image id="small1"><imagedescription>Windows printing to a local printer.</imagedescription><imagefile>1small</imagefile></image>
        </para>
        </sect2>
 
@@ -681,7 +681,7 @@ libcups.so.2 =&gt; /usr/lib/libcups.so.2 (0x40123000)
        </note>
 
        <para>
-       <image><imagedescription>Printing to a PostScript printer.</imagedescription>
+               <image id="small2"><imagedescription>Printing to a PostScript printer.</imagedescription>
                        <imagefile>2small</imagefile></image>
        </para>
 
@@ -714,7 +714,7 @@ libcups.so.2 =&gt; /usr/lib/libcups.so.2 (0x40123000)
        </para>
 
        <para>
-       <image><imagedescription>Ghostscript as a RIP for non-postscript printers.</imagedescription>
+       <image id="small3"><imagedescription>Ghostscript as a RIP for non-postscript printers.</imagedescription>
                <imagefile>3small</imagefile>
        </image>
        </para>
@@ -1123,7 +1123,7 @@ print options already embedded into the file.
 </para>
 
 <para>
-       <image scale="25"><imagedescription>Pre-filtering in CUPS to form PostScript.</imagedescription>
+       <image id="small4" scale="25"><imagedescription>Pre-filtering in CUPS to form PostScript.</imagedescription>
        <imagefile>4small</imagefile>
 </image>
 </para>
@@ -1142,7 +1142,7 @@ stapling and punching it, and so on) into the PostScript file.
 </para>
 
 <para>
-       <image scale="25"><imagedescription>Adding device-specific print options.</imagedescription>
+       <image scale="25" id="small5"><imagedescription>Adding device-specific print options.</imagedescription>
                <imagefile>5small</imagefile>
        </image>
 </para>
@@ -1183,7 +1183,7 @@ that are able to generate device-specific printer data.
 </para>
 
 <para>
-       <image scale="25"><imagedescription>PostScript to intermediate raster format.</imagedescription><imagefile>6small</imagefile></image>
+       <image id="small6" scale="25"><imagedescription>PostScript to intermediate raster format.</imagedescription><imagefile>6small</imagefile></image>
 </para>
 
 <para>
@@ -1200,7 +1200,7 @@ than one vendor financing the development of CUPS raster drivers).
 </para>
 
 <para>
-       <image><imagedescription>CUPS-raster production using Ghostscript.</imagedescription>
+       <image id="small7"><imagedescription>CUPS-raster production using Ghostscript.</imagedescription>
                <imagefile>7small</imagefile>
        </image>
 </para>
@@ -1663,7 +1663,7 @@ specific model supports. See <link linkend="cups-ppds">the figure below</link> f
        <title>PPDs shipped with CUPS</title>
        <tgroup cols="2" align="left">
                <colspec align="left"/>
-               <colspec align="justify" width="1*"/>
+               <colspec align="justify" colwidth="1*"/>
                <thead><row><entry>PPD file</entry><entry>Printer type</entry></row></thead>
                <tbody>
                <row><entry>deskjet.ppd</entry><entry>older HP inkjet printers and compatible</entry></row>
@@ -2112,7 +2112,7 @@ simply use <smbconfoption><name>printing</name><value>sysv</value></smbconfoptio
 </para>
 
 <para>
-<image><imagedescription>Printing via CUPS/Samba server.</imagedescription>
+<image id="small13"><imagedescription>Printing via CUPS/Samba server.</imagedescription>
        <imagefile>13small</imagefile>
 </image>
 </para>
@@ -2533,9 +2533,9 @@ the Windows NT/2000/XP client.
 
 <para>
        <itemizedlist>
-               <listitem>cups.hlp</listitem>
-               <listitem>cupsdrvr.dll</listitem>
-               <listitem>cupsui.dll</listitem>
+               <listitem><para>cups.hlp</para></listitem>
+               <listitem><para>cupsdrvr.dll</para></listitem>
+               <listitem><para>cupsui.dll</para></listitem>
        </itemizedlist>
 </para>
 
@@ -2549,12 +2549,12 @@ different platforms.
 
 <para>
        <itemizedlist>
-       <listitem>ADFONTS.MFM</listitem>
-       <listitem>ADOBEPS4.DRV</listitem>
-       <listitem>ADOBEPS4.HLP</listitem>
-       <listitem>DEFPRTR2.PPD</listitem>
-       <listitem>ICONLIB.DLL</listitem>
-       <listitem>PSMON.DLL</listitem>
+       <listitem><para>ADFONTS.MFM</para></listitem>
+       <listitem><para>ADOBEPS4.DRV</para></listitem>
+       <listitem><para>ADOBEPS4.HLP</para></listitem>
+       <listitem><para>DEFPRTR2.PPD</para></listitem>
+       <listitem><para>ICONLIB.DLL</para></listitem>
+       <listitem><para>PSMON.DLL</para></listitem>
 </itemizedlist>
 </para>
 
@@ -2562,9 +2562,9 @@ different platforms.
 
 <para>
 <itemizedlist>
-       <listitem>ADOBEPS5.DLL</listitem>
-       <listitem>ADOBEPSU.DLL</listitem>
-       <listitem>ADOBEPSU.HLP</listitem>
+       <listitem><para>ADOBEPS5.DLL</para></listitem>
+       <listitem><para>ADOBEPSU.DLL</para></listitem>
+       <listitem><para>ADOBEPSU.HLP</para></listitem>
 </itemizedlist>
 
 </para>

diff --git a/docs/docbook/projdoc/Compiling.xml b/docs/docbook/projdoc/Compiling.xml
index da28e43859b26f4ac963e220e00e2abf805e61f3..20f27ce0e55bb806a57b790441057375c240afbf 100644 (file)
--- a/docs/docbook/projdoc/Compiling.xml
+++ b/docs/docbook/projdoc/Compiling.xml
@@ -329,8 +329,8 @@ example of what you would not want to see would be:
        <para>On Debian, you need to install the following packages:</para>
        <para>
                <itemizedlist>
-                       <listitem>libkrb5-dev</listitem>
-                       <listitem>krb5-user</listitem>
+                       <listitem><para>libkrb5-dev</para></listitem>
+                       <listitem><para>krb5-user</para></listitem>
                </itemizedlist>
        </para>
        </sect3>
@@ -341,9 +341,9 @@ example of what you would not want to see would be:
        <para>On Red Hat Linux, this means you should have at least: </para>
        <para>
                <itemizedlist>
-                       <listitem>krb5-workstation (for kinit)</listitem>
-                       <listitem>krb5-libs (for linking with)</listitem>
-                       <listitem>krb5-devel (because you are compiling from source)</listitem>
+                       <listitem><para>krb5-workstation (for kinit)</para></listitem>
+                       <listitem><para>krb5-libs (for linking with)</para></listitem>
+                       <listitem><para>krb5-devel (because you are compiling from source)</para></listitem>
                </itemizedlist>
        </para>
 

diff --git a/docs/docbook/projdoc/DOMAIN_MEMBER.xml b/docs/docbook/projdoc/DOMAIN_MEMBER.xml
index b528fe9b617c235ffe10aea423cd54d6b9571c71..059d586c54a3cf9b293a121188f247b0b8c160e2 100644 (file)
--- a/docs/docbook/projdoc/DOMAIN_MEMBER.xml
+++ b/docs/docbook/projdoc/DOMAIN_MEMBER.xml
@@ -463,12 +463,12 @@ Server, and so on.
 </emphasis>
 </para>
 
-<para><note>
+<note><para>
 When Samba is configured to use an LDAP, or other identity management and/or
 directory service, it is Samba that continues to perform user and machine
 authentication. It should be noted that the LDAP server does not perform
 authentication handling in place of what Samba is designed to do.
-</note></para>
+</para></note>
 
 <para>
 Please refer to <link linkend="samba-pdc"></link>, for more information regarding
@@ -867,7 +867,7 @@ may want to create the machine account within a particular organizational unit.
 this to be done using the following syntax:
 <screen>
 &rootprompt;  <userinput>kinit Administrator@your.kerberos.REALM</userinput>
-&rootprompt; <userinput>net ads join <quote>organizational_unit</quote></userinput>
+&rootprompt; <userinput>net ads join "organizational_unit"</userinput>
 </screen>
 </para>
 
@@ -925,9 +925,9 @@ be logged in with Kerberos without needing to know a password. If this fails the
 an encryption type of DES-CBC-MD5? 
 </para>
 
-<para><note>
+<note><para>
 Samba can use both DES-CBC-MD5 encryption as well as ARCFOUR-HMAC-MD5 encoding.
-</note></para>
+</para></note>
 
 </sect2>
 

diff --git a/docs/docbook/projdoc/GROUP-MAPPING-HOWTO.xml b/docs/docbook/projdoc/GROUP-MAPPING-HOWTO.xml
index 3e7dca6358bb15fcec309e908b5a39575346256d..9e9d1a0e0192f520f34d240095f2e7e8224bedf2 100644 (file)
--- a/docs/docbook/projdoc/GROUP-MAPPING-HOWTO.xml
+++ b/docs/docbook/projdoc/GROUP-MAPPING-HOWTO.xml
@@ -165,7 +165,7 @@
 
                <para>
        <screen>
-       &rootprompt;<userinput>net groupmap add ntgroup=<quote>Domain Admins</quote> UNIXgroup=domadm</userinput>
+       &rootprompt;<userinput>net groupmap add ntgroup="Domain Admins" UNIXgroup=domadm</userinput>
        </screen>
        </para>
                
@@ -221,10 +221,10 @@
        Aliases, and RIDs are shown in <link linkend="WKURIDS"/>.
        </para>
 
-       <para><note>
+       <note><para>
        When the <parameter>passdb backend</parameter> uses LDAP (<constant>ldapsam</constant>) it is the
        admininstrators' responsibility to create the essential Domain Groups, and to assign each its default RID.
-       </note></para>
+       </para></note>
 
        <para>
        It is permissible to create any Domain Group that may be necessary, just make certain that the essential

diff --git a/docs/docbook/projdoc/NT4Migration.xml b/docs/docbook/projdoc/NT4Migration.xml
index b5ba7c1ced9f1f8cd9582b30cfa25d7d303c3fe2..b5e651ae6761797ac2158108092e61bc2710d1ca 100644 (file)
--- a/docs/docbook/projdoc/NT4Migration.xml
+++ b/docs/docbook/projdoc/NT4Migration.xml
@@ -298,7 +298,7 @@ generally fit into three basic categories. <link linkend="majtypes"/> shows the
 <table frame="all" id="majtypes"><title>The Three Major Site Types</title>
 <tgroup cols="2">
        <colspec align="left"/>
-       <colspec align="justify" colspec="1*"/>
+       <colspec align="justify" colwidth="1*"/>
        <thead>
        <row><entry>Number of Users</entry><entry>Description</entry></row>
        </thead>

diff --git a/docs/docbook/projdoc/NetworkBrowsing.xml b/docs/docbook/projdoc/NetworkBrowsing.xml
index 251b387a05cd143dd020bac278989d60ea0ee6a8..8b4f9bfd47fb2a7c0810c742072422c629b50a27 100644 (file)
--- a/docs/docbook/projdoc/NetworkBrowsing.xml
+++ b/docs/docbook/projdoc/NetworkBrowsing.xml
@@ -92,12 +92,12 @@ The technologies (or methods) employed in making all of this work include:
 </para>
 
 <itemizedlist>
-       <listitem>MS Windows machines register their presence to the network.</listitem>
-       <listitem>Machines announce themselves to other machines on the network.</listitem>
-       <listitem>One or more machine on the network collates the local announcements.</listitem>
-       <listitem>The client machine finds the machine that has the collated list of machines.</listitem>
-       <listitem>The client machine is able to resolve the machine names to IP addresses.</listitem>
-       <listitem>The client machine is able to connect to a target machine.</listitem>
+       <listitem><para>MS Windows machines register their presence to the network.</para></listitem>
+       <listitem><para>Machines announce themselves to other machines on the network.</para></listitem>
+       <listitem><para>One or more machine on the network collates the local announcements.</para></listitem>
+       <listitem><para>The client machine finds the machine that has the collated list of machines.</para></listitem>
+       <listitem><para>The client machine is able to resolve the machine names to IP addresses.</para></listitem>
+       <listitem><para>The client machine is able to connect to a target machine.</para></listitem>
 </itemizedlist>
 
 <para>
@@ -1062,17 +1062,17 @@ are:
 </para>
 
 <itemizedlist>
-       <listitem>WINS &smbmdash; the best tool.</listitem>
-       <listitem>LMHOSTS &smbmdash; static and hard to maintain.</listitem>
-       <listitem>Broadcast &smbmdash; uses UDP and cannot resolve names across remote segments.</listitem>
+       <listitem><para>WINS &smbmdash; the best tool.</para></listitem>
+       <listitem><para>LMHOSTS &smbmdash; static and hard to maintain.</para></listitem>
+       <listitem><para>Broadcast &smbmdash; uses UDP and cannot resolve names across remote segments.</para></listitem>
 </itemizedlist>
 
 <para>
 Alternative means of name resolution include:
 </para>
 <itemizedlist>
-<listitem>Static <filename>/etc/hosts</filename> &smbmdash;  hard to maintain, and lacks name_type info.</listitem>
-<listitem>DNS &smbmdash; is a good choice but lacks essential name_type info.</listitem>
+<listitem><para>Static <filename>/etc/hosts</filename> &smbmdash;  hard to maintain, and lacks name_type info.</para></listitem>
+<listitem><para>DNS &smbmdash; is a good choice but lacks essential name_type info.</para></listitem>
 </itemizedlist>
 
 <para>
@@ -1437,7 +1437,7 @@ as shown in <link linkend="brsex3"/>.
        <tgroup cols="3" align="left">
                <colspec align="left"/>
                <colspec align="left"/>
-               <colspec align="justify" width="1*"/>
+               <colspec align="justify" colwidth="1*"/>
 
        <thead>
                <row><entry>Subnet</entry><entry>Browse Master</entry><entry>List</entry></row>

diff --git a/docs/docbook/projdoc/Other-Clients.xml b/docs/docbook/projdoc/Other-Clients.xml
index 76909e5236e95efc968996d6bf822b595a707889..735c858e7c4149800f7b2ac2ea043f20788cd2d1 100644 (file)
--- a/docs/docbook/projdoc/Other-Clients.xml
+++ b/docs/docbook/projdoc/Other-Clients.xml
@@ -48,9 +48,9 @@ For more info on these packages, Samba, and Linux (and other UNIX-based systems)
                <para>Basically, you need three components:</para>
                
                <itemizedlist>
-                       <listitem>The File and Print Client (IBM Peer)</listitem>
-                       <listitem>TCP/IP (Internet support) </listitem>
-                       <listitem>The <quote>NetBIOS over TCP/IP</quote> driver (TCPBEUI)</listitem>
+                       <listitem><para>The File and Print Client (IBM Peer)</para></listitem>
+                       <listitem><para>TCP/IP (Internet support) </para></listitem>
+                       <listitem><para>The <quote>NetBIOS over TCP/IP</quote> driver (TCPBEUI)</para></listitem>
                </itemizedlist>
                
                <para>Installing the first two together with the base operating 

diff --git a/docs/docbook/projdoc/PolicyMgmt.xml b/docs/docbook/projdoc/PolicyMgmt.xml
index fc06ffefb13dd7618cf5520c6fb5e017d7e6ef4f..10ecc0e44096c8bf5ab7de3fe11a2783ecb80aca 100644 (file)
--- a/docs/docbook/projdoc/PolicyMgmt.xml
+++ b/docs/docbook/projdoc/PolicyMgmt.xml
@@ -339,11 +339,11 @@ Common restrictions that are frequently used include:
 <para>
 <indexterm><primary>Account Controls</primary></indexterm>
 <itemizedlist>
-       <listitem>Logon hours</listitem>
-       <listitem>Password aging</listitem>
-       <listitem>Permitted logon from certain machines only</listitem>
-       <listitem>Account type (local or global)</listitem>
-       <listitem>User rights</listitem>
+       <listitem><para>Logon hours</para></listitem>
+       <listitem><para>Password aging</para></listitem>
+       <listitem><para>Permitted logon from certain machines only</para></listitem>
+       <listitem><para>Account type (local or global)</para></listitem>
+       <listitem><para>User rights</para></listitem>
 </itemizedlist>
 </para>
 

diff --git a/docs/docbook/projdoc/Problems.xml b/docs/docbook/projdoc/Problems.xml
index 2058b6867f82efdde72074477405890528e6b751..23da2052921408165b7e080982eed9a14aca662c 100644 (file)
--- a/docs/docbook/projdoc/Problems.xml
+++ b/docs/docbook/projdoc/Problems.xml
@@ -236,13 +236,13 @@ If you do post a message to one of the lists, please observe the following guide
        <listitem><para>In addition to the version, if you obtained Samba via
        CVS, mention the date when you last checked it out.</para></listitem>
 
-       <listitem><para> Try and make your questions clear and brief. Lots of long, 
+       <listitem><para>Try and make your questions clear and brief. Lots of long, 
        convoluted questions get deleted before they are completely read!
        Do not post HTML encoded messages. Most people on mailing lists simply delete
        them.
        </para></listitem>
 
-       <listitem><para> If you run one of those nifty <quote>I'm on holidays</quote> things when
+       <listitem><para>If you run one of those nifty <quote>I'm on holidays</quote> things when
        you are away, make sure its configured to not answer mailing list traffic. Auto-responses
        to mailing lists really irritate the thousands of people who end up having to deal
        with such bad netiquet bahavior.
@@ -262,7 +262,7 @@ If you do post a message to one of the lists, please observe the following guide
 
        <listitem><para>If you have a complete Netmon trace (from the opening of
        the pipe to the error), you can send the *.CAP file as well.</para></listitem> 
-           `
+           
        <listitem><para>Please think carefully before attaching a document to an email.
        Consider pasting the relevant parts into the body of the message. The Samba
        mailing lists go to a huge number of people. Do they all need a copy of your 

diff --git a/docs/docbook/projdoc/ProfileMgmt.xml b/docs/docbook/projdoc/ProfileMgmt.xml
index 71718844109e4d461b97c62aa73b60bc05f84ef3..7e70158c133626f0e8c046635696be5496030d13 100644 (file)
--- a/docs/docbook/projdoc/ProfileMgmt.xml
+++ b/docs/docbook/projdoc/ProfileMgmt.xml
@@ -408,7 +408,7 @@ workstation as follows: </para>
 
        <note><para>You will need to log on if a logon box opens up. 
        For example, connect as <replaceable>DOMAIN</replaceable>\root, password:
-       <replaceable>mypassword</replaceable>.</para></note> </step>
+       <replaceable>mypassword</replaceable>.</para></note></step>
 
        <step><para> To make the profile capable of being used by anyone, select <quote>Everyone</quote>. </para></step>
 
@@ -424,7 +424,7 @@ workstation as follows: </para>
 <note><para>
 Under Windows NT/200x, the use of mandatory profiles forces the use of MS Exchange storage of mail
 data and keeps it out of the desktop profile. That keeps desktop profiles from becoming unusable.
-</para> </note>
+</para></note>
 
 <sect4>
 <title>Windows XP Service Pack 1</title>
@@ -830,7 +830,7 @@ since it will involve copying a new default profile to every MS Windows 200x/XP
 exists there it will copy this to the workstation to the <filename>C:\Documents and Settings\</filename>
 under the Windows login name of the user. </para>
 
-<note> <para> This path translates, in Samba parlance, to the &smb.conf;
+<note><para> This path translates, in Samba parlance, to the &smb.conf;
 <smbconfsection>[NETLOGON]</smbconfsection> share. The directory should be created at the root
 of this share and must be called <filename>Default Profile</filename>. </para> </note>
 
@@ -968,9 +968,9 @@ per-user settings using the Domain User Manager (as with MS Windows NT4/ Win 200
 <para> In any case, you can configure only one profile per user. That profile can be either: </para>
 
 <itemizedlist>
-       <listitem>A profile unique to that user.</listitem>
-       <listitem>A mandatory profile (one the user cannot change).</listitem>
-       <listitem>A group profile (really should be mandatory, that is unchangable).</listitem>
+       <listitem><para>A profile unique to that user.</para></listitem>
+       <listitem><para>A mandatory profile (one the user cannot change).</para></listitem>
+       <listitem><para>A group profile (really should be mandatory, that is unchangable).</para></listitem>
 </itemizedlist>
 
 </sect2>

diff --git a/docs/docbook/projdoc/Samba-PDC-HOWTO.xml b/docs/docbook/projdoc/Samba-PDC-HOWTO.xml
index f86a4d5904447acc839d80df6b48eb8cda1ef40d..2541d7a4851db703353d1c691fbff8fd402c895a 100644 (file)
--- a/docs/docbook/projdoc/Samba-PDC-HOWTO.xml
+++ b/docs/docbook/projdoc/Samba-PDC-HOWTO.xml
@@ -33,7 +33,7 @@ network clients.
 
 <figure id="domain-example"><title>An Example Domain.</title>
 <mediaobject>
-<imageobject role="latex"><imagedata fileref="projdoc/imagefiles/domain" width="4in" height="3in" scalefit="1"/></imageobject>
+<imageobject role="latex"><imagedata fileref="projdoc/imagefiles/domain" width="4in" scalefit="1"/></imageobject>
 <imageobject><imagedata fileref="projdoc/imagefiles/domain.png" scale="50" scalefit="1"/></imageobject>
 </mediaobject>
 </figure>
@@ -243,7 +243,7 @@ LDAP-based user and machine account backend.
 
 <para>
 New to Samba-3 is the ability to use a backend database that holds the same type of data as
-the NT4-style SAM database (one of the registry files)<footnote>See also <link linkend="passdb"/>.</footnote>.
+the NT4-style SAM database (one of the registry files)<footnote><para>See also <link linkend="passdb"/>.</para></footnote>.
 </para>
 
 <para>
@@ -292,12 +292,12 @@ management requirements. Samba can act as a NT4-style DC in a Windows 2000/XP
 environment. However, there are certain compromises:
 
 <itemizedlist>
-       <listitem>No machine policy files.</listitem>
-       <listitem>No Group Policy Objects.</listitem>
-       <listitem>No synchronously executed AD logon scripts.</listitem>
-       <listitem>Can't use Active Directory management tools to manage users and machines.</listitem>
-       <listitem>Registry changes tattoo the main registry, while with AD they do not leave permanent changes in effect.</listitem>
-       <listitem>Without AD you cannot perform the function of exporting specific applications to specific users or groups.</listitem>
+       <listitem><para>No machine policy files.</para></listitem>
+       <listitem><para>No Group Policy Objects.</para></listitem>
+       <listitem><para>No synchronously executed AD logon scripts.</para></listitem>
+       <listitem><para>Can't use Active Directory management tools to manage users and machines.</para></listitem>
+       <listitem><para>Registry changes tattoo the main registry, while with AD they do not leave permanent changes in effect.</para></listitem>
+               <listitem><para>Without AD you cannot perform the function of exporting specific applications to specific users or groups.</para></listitem>
 </itemizedlist>
 </para>
 
@@ -407,7 +407,7 @@ A Domain Controller is an SMB/CIFS server that:
 It is rather easy to configure Samba to provide these. Each Samba Domain Controller must provide
 the NETLOGON service that Samba calls the <smbconfoption><name>domain logons</name></smbconfoption> functionality
 (after the name of the parameter in the &smb.conf; file). Additionally, one server in a Samba-3
-Domain must advertise itself as the Domain Master Browser<footnote>See <link linkend="NetworkBrowsing"/>.</footnote>.
+Domain must advertise itself as the Domain Master Browser<footnote><para>See <link linkend="NetworkBrowsing"/>.</para></footnote>.
 This causes the Primary Domain Controller to claim a domain-specific NetBIOS name that identifies it as a
 Domain Master Browser for its given domain or workgroup. Local master browsers in the same domain or workgroup on
 broadcast-isolated subnets then ask for a complete copy of the browse list for the whole wide area network.
@@ -829,7 +829,7 @@ Create a user without the <quote>$</quote>. Then use <command>vipw</command> to
 the <quote>$</quote>. Or create the whole entry with vipw if you like; make sure you use a unique user login ID.
 </para>
 
-<para><note>The machine account must have the exact name that the workstation has.</note></para>
+<note><para>The machine account must have the exact name that the workstation has.</para></note>
 
 <note><para>
 The UNIX tool <command>vipw</command> is a common tool for directly editing the <filename>/etc/passwd</filename> file.

diff --git a/docs/docbook/projdoc/ServerType.xml b/docs/docbook/projdoc/ServerType.xml
index c7ee63cef2ba0096adaf06ac750561c15657f5b7..f400cdd647a14e25cb4d1e26099cd68298adaa0d 100644 (file)
--- a/docs/docbook/projdoc/ServerType.xml
+++ b/docs/docbook/projdoc/ServerType.xml
@@ -101,15 +101,15 @@ different type of servers:</para>
 <itemizedlist>
        <listitem><para>Domain Controller</para>
                <itemizedlist>
-                       <listitem>Primary Domain Controller</listitem>
-                       <listitem>Backup Domain Controller</listitem>
-                       <listitem>ADS Domain Controller</listitem>
+                       <listitem><para>Primary Domain Controller</para></listitem>
+                       <listitem><para>Backup Domain Controller</para></listitem>
+                       <listitem><para>ADS Domain Controller</para></listitem>
                </itemizedlist>
        </listitem>
        <listitem><para>Domain Member Server</para>
                <itemizedlist>
-                       <listitem>Active Directory Domain Server</listitem>
-                       <listitem>NT4 Style Domain Domain Server</listitem>
+                       <listitem><para>Active Directory Domain Server</para></listitem>
+                               <listitem><para>NT4 Style Domain Domain Server</para></listitem>
                </itemizedlist>
        </listitem>
        <listitem><para>Stand-alone Server</para></listitem>

diff --git a/docs/docbook/projdoc/VFS.xml b/docs/docbook/projdoc/VFS.xml
index 58bb64d3efba7cfbd4529ab8c223afc764d85577..90bcff2fd6cb597d98125a47ebaa53e0bbfabfa3 100644 (file)
--- a/docs/docbook/projdoc/VFS.xml
+++ b/docs/docbook/projdoc/VFS.xml
@@ -88,10 +88,10 @@ This can be done using a configuration similar to the one shown in <link linkend
                A simple module to audit file access to the syslog
                facility. The following operations are logged:
                <itemizedlist>
-                       <listitem>share</listitem>
-                       <listitem>connect/disconnect</listitem>
-                       <listitem>directory opens/create/remove</listitem>
-                       <listitem>file open/close/rename/unlink/chmod</listitem>
+                       <listitem><para>share</para></listitem>
+                       <listitem><para>connect/disconnect</para></listitem>
+                       <listitem><para>directory opens/create/remove</para></listitem>
+                       <listitem><para>file open/close/rename/unlink/chmod</para></listitem>
                </itemizedlist>
                </para>
 

diff --git a/docs/docbook/projdoc/locking.xml b/docs/docbook/projdoc/locking.xml
index 8bdb06ca8ff358fa4efc00c7dba80acbe1221cf5..c2c0401e30af406848c83092af3928eacec7bc53 100644 (file)
--- a/docs/docbook/projdoc/locking.xml
+++ b/docs/docbook/projdoc/locking.xml
@@ -986,11 +986,13 @@ so far:
        <para>
        <quote>
        We are seeing lots of errors in the Samba logs, like:
+</quote>
 <programlisting>
 tdb(/usr/local/samba_2.2.7/var/locks/locking.tdb): rec_read bad magic
  0x4d6f4b61 at offset=36116
 </programlisting>
 
+<quote>
        What do these mean?
        </quote>
        </para>

diff --git a/docs/docbook/projdoc/passdb.xml b/docs/docbook/projdoc/passdb.xml
index 1e0fcc6e2bfa848e228ccd35e6b40e6169cbb714..043c452a1fc84a244e0804e01fb4875b7e61e46d 100644 (file)
--- a/docs/docbook/projdoc/passdb.xml
+++ b/docs/docbook/projdoc/passdb.xml
@@ -106,6 +106,9 @@ as follows:
 
 </sect2>
 
+<sect2>
+<title>New Backends</title>
+
 <para>
 Samba-3 introduces a number of new password backend capabilities.
 <indexterm><primary>SAM backend</primary><secondary>tdbsam</secondary></indexterm>
@@ -114,9 +117,6 @@ Samba-3 introduces a number of new password backend capabilities.
 <indexterm><primary>SAM backend</primary><secondary>xmlsam</secondary></indexterm>
 </para>
 
-<sect2>
-<title>New Backends</title>
-
 <variablelist>
        <varlistentry><term>tdbsam</term>
                <listitem>
@@ -279,10 +279,10 @@ Samba-3 introduces a number of new password backend capabilities.
                </para>
 
                <itemizedlist>
-                       <listitem>MS DOS Network client 3.0 with the basic network redirector installed.</listitem>
-                       <listitem>Windows 95 with the network redirector update installed.</listitem>
-                       <listitem>Windows 98 [Second Edition].</listitem>
-                       <listitem>Windows Me.</listitem>
+                       <listitem><para>MS DOS Network client 3.0 with the basic network redirector installed.</para></listitem>
+                       <listitem><para>Windows 95 with the network redirector update installed.</para></listitem>
+                       <listitem><para>Windows 98 [Second Edition].</para></listitem>
+                       <listitem><para>Windows Me.</para></listitem>
                </itemizedlist>
 
                <note>
@@ -296,11 +296,11 @@ Samba-3 introduces a number of new password backend capabilities.
                </para>
 
                <itemizedlist>
-                       <listitem>Windows NT 3.5x.</listitem>
-                       <listitem>Windows NT 4.0.</listitem>
-                       <listitem>Windows 2000 Professional.</listitem>
-                       <listitem>Windows 200x Server/Advanced Server.</listitem>
-                       <listitem>Windows XP Professional.</listitem>
+                       <listitem><para>Windows NT 3.5x.</para></listitem>
+                       <listitem><para>Windows NT 4.0.</para></listitem>
+                       <listitem><para>Windows 2000 Professional.</para></listitem>
+                       <listitem><para>Windows 200x Server/Advanced Server.</para></listitem>
+                       <listitem><para>Windows XP Professional.</para></listitem>
                </itemizedlist>
                        
                <para>
@@ -414,10 +414,9 @@ Samba-3 introduces a number of new password backend capabilities.
 <indexterm><primary>SAM backend</primary><secondary>ldapsam</secondary></indexterm>
 <smbconfexample id="idmapbackendexample">
 <title>Example configuration with the LDAP idmap backend</title>
-<indexterm><primary>SAM backend</primary><secondary>xmlsam</secondary></indexterm>
 <smbconfsection>[global]</smbconfsection>
 <smbconfoption><name>idmap backend</name><value>ldapsam:ldap://ldap-server.quenya.org:636</value></smbconfoption>
-<smbcomment>Alternately, this could be specified as:</smbcomment>
+<smbconfcomment>Alternately, this could be specified as:</smbconfcomment>
 <smbconfoption><name>idmap backend</name><value>ldapsam:ldaps://ldap-server.quenya.org</value></smbconfoption>
 </smbconfexample>
        </para>
@@ -495,12 +494,12 @@ be announced in time for the Samba-3.0.1 release.
                </para>
 
                <itemizedlist>
-                       <listitem><emphasis>add</emphasis> user or machine accounts.</listitem>
-                       <listitem><emphasis>delete</emphasis> user or machine accounts.</listitem>
-                       <listitem><emphasis>enable</emphasis> user or machine accounts.</listitem>
-                       <listitem><emphasis>disable</emphasis> user or machine accounts.</listitem>
-                       <listitem><emphasis>set to NULL</emphasis> user passwords.</listitem>
-                       <listitem><emphasis>manage interdomain trust accounts.</emphasis></listitem>
+                       <listitem><para><emphasis>add</emphasis> user or machine accounts.</para></listitem>
+                       <listitem><para><emphasis>delete</emphasis> user or machine accounts.</para></listitem>
+                       <listitem><para><emphasis>enable</emphasis> user or machine accounts.</para></listitem>
+                       <listitem><para><emphasis>disable</emphasis> user or machine accounts.</para></listitem>
+                       <listitem><para><emphasis>set to NULL</emphasis> user passwords.</para></listitem>
+                       <listitem><para><emphasis>manage interdomain trust accounts.</emphasis></para></listitem>
                </itemizedlist>
                
                <para>
@@ -563,9 +562,9 @@ be announced in time for the Samba-3.0.1 release.
                </para>
 
                <itemizedlist>
-                       <listitem>add, remove or modify user accounts.</listitem>
-                       <listitem>list user accounts.</listitem>
-                       <listitem>migrate user accounts.</listitem>
+                       <listitem><para>add, remove or modify user accounts.</para></listitem>
+                       <listitem><para>list user accounts.</para></listitem>
+                       <listitem><para>migrate user accounts.</para></listitem>
                </itemizedlist>
 
                <para>
@@ -1326,10 +1325,10 @@ access to attrs=lmPassword,ntPassword
                        </para>
 
                        <itemizedlist>
-                               <listitem>sambaHomePath</listitem>
-                               <listitem>sambaLogonScript</listitem>
-                               <listitem>sambaProfilePath</listitem>
-                               <listitem>sambaHomeDrive</listitem>
+                               <listitem><para>sambaHomePath</para></listitem>
+                               <listitem><para>sambaLogonScript</para></listitem>
+                               <listitem><para>sambaProfilePath</para></listitem>
+                               <listitem><para>sambaHomeDrive</para></listitem>
                        </itemizedlist>
 
                        <para>
@@ -1418,11 +1417,11 @@ access to attrs=lmPassword,ntPassword
                <para>The <smbconfoption><name>ldap passwd sync</name></smbconfoption> options can have the  values shown in
                <link linkend="ldappwsync"/>.</para>
 
-               <table iframe="all" id="ldappwsync">
+               <table frame="all" id="ldappwsync">
                        <title>Possible <emphasis>ldap passwd sync</emphasis> values</title>
                <tgroup cols="2">
-                       <colspec align="left" width="1*"/>
-                       <colspec align="justify" width="4*"/>
+                       <colspec align="left" colwidth="1*"/>
+                       <colspec align="justify" colwidth="4*"/>
                <thead>
                        <row><entry align="left">Value</entry><entry align="center">Description</entry></row>
                </thead>
@@ -1690,10 +1689,7 @@ access to attrs=lmPassword,ntPassword
 
        <para>
        <smbconfblock>
-       <smbconfsection>[global]</smbconfsection>
-       <member>...</member>
        <smbconfoption><name>passdb backend</name><value>smbpasswd, tdbsam</value></smbconfoption>
-       <member>...</member>
        </smbconfblock>
        </para>
 
@@ -1704,10 +1700,10 @@ access to attrs=lmPassword,ntPassword
 
        <para>
 <smbconfblock>
-[globals]
-...
+       <smbconfsection>[globals]</smbconfsection>
+       <member>...</member>
 <smbconfoption><name>passdb backend</name><value>tdbsam, smbpasswd</value></smbconfoption>
-...
+       <member>...</member>
 </smbconfblock>
        </para>
 

diff --git a/docs/docbook/projdoc/upgrading-to-3.0.xml b/docs/docbook/projdoc/upgrading-to-3.0.xml
index 4461f0fdcb08dbf6a192cbd59faaff3378f12509..6556d847534bc1b7d29df962beb123f7b9c5e654 100644 (file)
--- a/docs/docbook/projdoc/upgrading-to-3.0.xml
+++ b/docs/docbook/projdoc/upgrading-to-3.0.xml
@@ -51,7 +51,7 @@ See <link linkend="pdbeditthing"/>.
 The major new features are:
 </para>
 
-<orderedlist numberation="arabic">
+<orderedlist numeration="arabic">
        <listitem><para>
        Active Directory support. This release is able to join an ADS realm
        as a member server and authenticate users using LDAP/kerberos.
@@ -327,7 +327,7 @@ complete descriptions of new or modified parameters.
         <table frame='all' id="tdbfiledesc"><title>TDB File Descriptions</title>
         <tgroup cols='3'>
                        <colspec align="left"/>
-                       <colspec align="justify" width="1*"/>
+                       <colspec align="justify" colwidth="1*"/>
                        <colspec align="left"/>
                 <thead>
                 <row>