summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJelmer Vernooij <jelmer@samba.org>2009-05-01 22:27:03 +0200
committerJelmer Vernooij <jelmer@samba.org>2009-05-01 22:49:14 +0200
commitf04382344969440e50b84f3facdf8cbe1a44b427 (patch)
tree134de28f2ab732985b0102c072c41be7f9798ad5
parent0b2380b188825868cd12f41b6f760669f73ffaee (diff)
downloadsamba-f04382344969440e50b84f3facdf8cbe1a44b427.tar.gz
samba-f04382344969440e50b84f3facdf8cbe1a44b427.tar.bz2
samba-f04382344969440e50b84f3facdf8cbe1a44b427.zip
Fix most of the invalid usages of DocBook in the Samba 3 HOWTO.
make check FTW!
-rw-r--r--docs-xml/Samba3-HOWTO/TOSHARG-BDC.xml2
-rw-r--r--docs-xml/Samba3-HOWTO/TOSHARG-CUPS-printing.xml24
-rw-r--r--docs-xml/Samba3-HOWTO/TOSHARG-IDMAP.xml4
-rw-r--r--docs-xml/Samba3-HOWTO/TOSHARG-NetworkBrowsing.xml4
-rw-r--r--docs-xml/Samba3-HOWTO/TOSHARG-PDC.xml8
-rw-r--r--docs-xml/Samba3-HOWTO/TOSHARG-ProfileMgmt.xml2
-rw-r--r--docs-xml/Samba3-HOWTO/TOSHARG-Securing.xml2
-rw-r--r--docs-xml/Samba3-HOWTO/TOSHARG-TheNetCommand.xml2
-rw-r--r--docs-xml/Samba3-HOWTO/TOSHARG-Winbind.xml2
-rw-r--r--docs-xml/Samba3-HOWTO/TOSHARG-locking.xml1
10 files changed, 25 insertions, 26 deletions
diff --git a/docs-xml/Samba3-HOWTO/TOSHARG-BDC.xml b/docs-xml/Samba3-HOWTO/TOSHARG-BDC.xml
index 35fdd9ee57..ec3dea7c5b 100644
--- a/docs-xml/Samba3-HOWTO/TOSHARG-BDC.xml
+++ b/docs-xml/Samba3-HOWTO/TOSHARG-BDC.xml
@@ -153,7 +153,7 @@ provided this capability. The technology has become known as the LanMan Netlogon
</para>
<para>
-<indexterm>network<primary></primary><secondary>logon</secondary><tertiary>service</tertiary></indexterm>
+<indexterm><primary>network</primary><secondary>logon</secondary><tertiary>service</tertiary></indexterm>
<indexterm><primary>Windows NT3.10</primary></indexterm>
When MS Windows NT3.10 was first released, it supported a new style of Domain Control
and with it a new form of the network logon service that has extended functionality.
diff --git a/docs-xml/Samba3-HOWTO/TOSHARG-CUPS-printing.xml b/docs-xml/Samba3-HOWTO/TOSHARG-CUPS-printing.xml
index 50d2f6b32e..70581121fb 100644
--- a/docs-xml/Samba3-HOWTO/TOSHARG-CUPS-printing.xml
+++ b/docs-xml/Samba3-HOWTO/TOSHARG-CUPS-printing.xml
@@ -627,11 +627,11 @@ application/octet-stream application/vnd.cups-raw 0 -
</para></note>
<para>
- The example in <link linkend="1small">Windows Printing to a Local Printer</link> illustrates local Windows
+ The example in <link linkend="f1small">Windows Printing to a Local Printer</link> illustrates local Windows
printing.
</para>
- <figure id="1small">
+ <figure id="f1small">
<title>Windows Printing to a Local Printer.</title>
<imagefile>1small</imagefile>
</figure>
@@ -714,11 +714,11 @@ application/octet-stream application/vnd.cups-raw 0 -
PPD-aware. PPDs are <quote>PostScript Printer Description</quote> files. They enable you to specify and
control all options a printer supports: duplexing, stapling, and punching. Therefore, UNIX users for a long
time couldn't choose many of the supported device and job options, unlike Windows or Apple users. But now
- there is CUPS. as illustrated in <link linkend="2small">Printing to a PostScript Printer</link>.
+ there is CUPS. as illustrated in <link linkend="f2small">Printing to a PostScript Printer</link>.
</para>
</note>
- <figure id="2small">
+ <figure id="f2small">
<title>Printing to a PostScript Printer.</title>
<imagefile>2small</imagefile>
</figure>
@@ -742,10 +742,10 @@ application/octet-stream application/vnd.cups-raw 0 -
used on UNIX platforms. It is a RIP in software, capable of doing a <emphasis>lot</emphasis> of file format
conversions for a very broad spectrum of hardware devices as well as software file formats. Ghostscript
technology and drivers are what enable PostScript printing to non-PostScript hardware. This is shown in
- <link linkend="3small">Ghostscript as a RIP for Non-PostScript Printers</link>.
+ <link linkend="f3small">Ghostscript as a RIP for Non-PostScript Printers</link>.
</para>
- <figure id="3small">
+ <figure id="f3small">
<title>Ghostscript as a RIP for Non-PostScript Printers.</title>
<imagefile>3small</imagefile>
</figure>
@@ -1176,11 +1176,11 @@ text/plain application/postscript 33 texttops
embedded into the PostScript by CUPS and that the next filter to be called is pstops). Another prefilter is
running on all supported image formats, the <parameter>imagetops</parameter> filter. Its outcome is always of
MIME type <parameter>application/vnd.cups-postscript</parameter> (not application/postscript), meaning it has
- the print options already embedded into the file. This is shown in <link linkend="4small">Prefiltering in
+ the print options already embedded into the file. This is shown in <link linkend="f4small">Prefiltering in
CUPS to Form PostScript</link>.
</para>
- <figure id="4small">
+ <figure id="f4small">
<title>Prefiltering in CUPS to Form PostScript.</title>
<imagefile scale="25">4small</imagefile>
</figure>
@@ -1202,10 +1202,10 @@ text/plain application/postscript 33 texttops
<parameter>application/vnd.cups-postscript</parameter>. As stated earlier, this filter inserts all
device-specific print options (commands to the printer to ask for the duplexing of output, or stapling and
punching it, and so on) into the PostScript file. An example is illustrated in <link
- linkend="5small">Adding Device-Specific Print Options</link>.
+ linkend="f5small">Adding Device-Specific Print Options</link>.
</para>
- <figure id="5small">
+ <figure id="f5small">
<title>Adding Device-Specific Print Options.</title>
<imagefile scale="25">5small</imagefile>
</figure>
@@ -2213,11 +2213,11 @@ long as Samba has been compiled with CUPS library (libcups) support. If Samba ha
support, and if no other print commands are set up, then printing will use the <emphasis>System V</emphasis>
AT&amp;T command set, with the -oraw option automatically passing through (if you want your own defined print
commands to work with a Samba server that has CUPS support compiled in, simply use <smbconfoption
-name="classicalprinting">sysv</smbconfoption>). This is illustrated in <link linkend="13small">the Printing via
+name="classicalprinting">sysv</smbconfoption>). This is illustrated in <link linkend="f13small">the Printing via
CUPS/Samba Server diagram</link>.
</para>
- <figure id="13small">
+ <figure id="f13small">
<title>Printing via CUPS/Samba Server.</title>
<imagefile>13small</imagefile>
</figure>
diff --git a/docs-xml/Samba3-HOWTO/TOSHARG-IDMAP.xml b/docs-xml/Samba3-HOWTO/TOSHARG-IDMAP.xml
index 2ff794939c..4781994881 100644
--- a/docs-xml/Samba3-HOWTO/TOSHARG-IDMAP.xml
+++ b/docs-xml/Samba3-HOWTO/TOSHARG-IDMAP.xml
@@ -56,9 +56,9 @@ reduced. This works reasonably well if the servers belong to a single domain, an
are not needed. On the other hand, if the Samba servers are NT4 domain members, or ADS domain members,
or if there is a need to keep the security name-space separate (i.e., the user
<literal>DOMINICUS\FJones</literal> must not be given access to the account resources of the user
-<literal>FRANCISCUS\FJones</literal><footnote>Samba local account mode results in both
+<literal>FRANCISCUS\FJones</literal><footnote><para>Samba local account mode results in both
<literal>DOMINICUS\FJones</literal> and <literal>FRANCISCUS\FJones</literal> mapping to the UNIX user
-<literal>FJones</literal>.</footnote> free from inadvertent cross-over, close attention should be given
+<literal>FJones</literal>.</para></footnote> free from inadvertent cross-over, close attention should be given
to the way that the IDMAP facility is configured.
</para>
diff --git a/docs-xml/Samba3-HOWTO/TOSHARG-NetworkBrowsing.xml b/docs-xml/Samba3-HOWTO/TOSHARG-NetworkBrowsing.xml
index 563550ee9b..58aaa29d17 100644
--- a/docs-xml/Samba3-HOWTO/TOSHARG-NetworkBrowsing.xml
+++ b/docs-xml/Samba3-HOWTO/TOSHARG-NetworkBrowsing.xml
@@ -898,14 +898,14 @@ in <link linkend="xremmb">&smb.conf; for Not Being a master browser</link>
</para>
<para>
-<example id="xremmb">
+<smbconfexample id="xremmb">
<title>&smb.conf; for Not Being a master browser</title>
<smbconfsection name="[global]"/>
<smbconfoption name="domain master">no</smbconfoption>
<smbconfoption name="local master">no</smbconfoption>
<smbconfoption name="preferred master">no</smbconfoption>
<smbconfoption name="os level">0</smbconfoption>
-</example>
+</smbconfexample>
</para>
</sect2>
diff --git a/docs-xml/Samba3-HOWTO/TOSHARG-PDC.xml b/docs-xml/Samba3-HOWTO/TOSHARG-PDC.xml
index d37edbe17f..a9a81c46e6 100644
--- a/docs-xml/Samba3-HOWTO/TOSHARG-PDC.xml
+++ b/docs-xml/Samba3-HOWTO/TOSHARG-PDC.xml
@@ -80,7 +80,7 @@ to not inflict pain on others. Do your learning on a test network.
</para>
<para>
-<indexterm>single sign-on<primary></primary><see>SSO</see></indexterm>
+<indexterm><primary>single sign-on</primary><see>SSO</see></indexterm>
<indexterm><primary>trust</primary></indexterm>
<indexterm><primary>account</primary></indexterm>
<indexterm><primary>domain</primary><secondary>security</secondary><tertiary>protocols</tertiary></indexterm>
@@ -462,7 +462,7 @@ Before we branch into a brief overview of domain control, there are three basic
<indexterm><primary>PDC</primary></indexterm>
<indexterm><primary>powerful</primary></indexterm>
<indexterm><primary>network</primary><secondary>performance</secondary></indexterm>
-<indexterm><primary>domain</primary><secondary>member</secondary><secondary>server</secondary></indexterm>
+<indexterm><primary>domain</primary><secondary>member</secondary><tertiary>server</tertiary></indexterm>
The <emphasis>Primary Domain Controller</emphasis> or PDC plays an important role in MS Windows NT4. In
Windows 200x domain control architecture, this role is held by domain controllers. Folklore dictates that
because of its role in the MS Windows network, the domain controller should be the most powerful and most
@@ -486,7 +486,7 @@ database with BDCs.
<para>
<indexterm><primary>domain</primary><secondary>controller</secondary><tertiary>hierarchy</tertiary></indexterm>
<indexterm><primary>LDAP</primary></indexterm>
-<indexterm>account<primary></primary><secondary>backend</secondary></indexterm>
+<indexterm><primary>account</primary><secondary>backend</secondary></indexterm>
<indexterm><primary>machine account</primary></indexterm>
With MS Windows 200x Server-based Active Directory domains, one domain controller initiates a potential
hierarchy of domain controllers, each with its own area of delegated control. The master domain
@@ -500,7 +500,7 @@ LDAP-based user and machine account backend.
<indexterm><primary>registry</primary></indexterm>
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><para>See also <link linkend="passdb">Account Information
-Databases</link>.</para>.</footnote>
+Databases</link>.</para></footnote>
</para>
<para>
diff --git a/docs-xml/Samba3-HOWTO/TOSHARG-ProfileMgmt.xml b/docs-xml/Samba3-HOWTO/TOSHARG-ProfileMgmt.xml
index 571ca323ce..48c99c542c 100644
--- a/docs-xml/Samba3-HOWTO/TOSHARG-ProfileMgmt.xml
+++ b/docs-xml/Samba3-HOWTO/TOSHARG-ProfileMgmt.xml
@@ -571,7 +571,7 @@ and Windows 2003.
<para>
The UPHClean software package can be downloaded from the User Profile Hive Cleanup
-Service<footnote>http://www.microsoft.com/downloads/details.aspx?FamilyID=1B286E6D-8912-4E18-B570-42470E2F3582&amp;displaylang=en</footnote>
+Service<footnote><para>http://www.microsoft.com/downloads/details.aspx?FamilyID=1B286E6D-8912-4E18-B570-42470E2F3582&amp;displaylang=en</para></footnote>
web site.
</para>
diff --git a/docs-xml/Samba3-HOWTO/TOSHARG-Securing.xml b/docs-xml/Samba3-HOWTO/TOSHARG-Securing.xml
index 21218ea9da..0a90ff1aa9 100644
--- a/docs-xml/Samba3-HOWTO/TOSHARG-Securing.xml
+++ b/docs-xml/Samba3-HOWTO/TOSHARG-Securing.xml
@@ -80,7 +80,7 @@ name="[IPC$]"/> share is used for browsing purposes as well as to establish TCP/
<para>
<indexterm><primary>Access Control Entries</primary><see>ACE</see></indexterm>
<indexterm><primary>ACL</primary></indexterm>
-<indexterm>controls<primary></primary></indexterm>
+<indexterm><primary>controls</primary></indexterm>
Another method by which Samba may be secured is by setting Access Control Entries (ACEs) in an Access
Control List (ACL) on the shares themselves. This is discussed in
<link linkend="AccessControls">File, Directory, and Share Access Controls</link>.
diff --git a/docs-xml/Samba3-HOWTO/TOSHARG-TheNetCommand.xml b/docs-xml/Samba3-HOWTO/TOSHARG-TheNetCommand.xml
index d1895829a9..ea0ed485c0 100644
--- a/docs-xml/Samba3-HOWTO/TOSHARG-TheNetCommand.xml
+++ b/docs-xml/Samba3-HOWTO/TOSHARG-TheNetCommand.xml
@@ -1662,7 +1662,7 @@ net rpc share MIGRATE ALL &lt;share-name&gt; -S &lt;source&gt;
the application that receives the network requests to create the necessary services must call out
to the operating system in order to create the underlying printers. The call-out is implemented
by way of an interface script that can be specified by the &smb.conf; file parameter
- <smbconfoption id="add printer script"/>. This script is essential to the migration process.
+ <smbconfoption name="add printer script"/>. This script is essential to the migration process.
A suitable example script may be obtained from the <filename>$SAMBA_SOURCES/examples/scripts</filename>
directory. Take note that this script must be customized to suit the operating system environment
and may use its tools to create a print queue.
diff --git a/docs-xml/Samba3-HOWTO/TOSHARG-Winbind.xml b/docs-xml/Samba3-HOWTO/TOSHARG-Winbind.xml
index adb0ba24d3..33e2697bd3 100644
--- a/docs-xml/Samba3-HOWTO/TOSHARG-Winbind.xml
+++ b/docs-xml/Samba3-HOWTO/TOSHARG-Winbind.xml
@@ -93,7 +93,7 @@
<indexterm><primary>idmap uid</primary></indexterm>
<indexterm><primary>idmap gid</primary></indexterm>
<indexterm><primary>idmap backend</primary></indexterm>
-<indexterm><primary></primary>LDAP</indexterm>
+<indexterm><primary>LDAP</primary></indexterm>
Winbind maintains a database called winbind_idmap.tdb in which it stores
mappings between UNIX UIDs, GIDs, and NT SIDs. This mapping is used only
for users and groups that do not have a local UID/GID. It stores the UID/GID
diff --git a/docs-xml/Samba3-HOWTO/TOSHARG-locking.xml b/docs-xml/Samba3-HOWTO/TOSHARG-locking.xml
index ee48f8c90d..297585d45d 100644
--- a/docs-xml/Samba3-HOWTO/TOSHARG-locking.xml
+++ b/docs-xml/Samba3-HOWTO/TOSHARG-locking.xml
@@ -1091,7 +1091,6 @@ tdb(/usr/local/samba_2.2.7/var/locks/locking.tdb): rec_read bad magic
</sect2>
<sect2>
-
<title>Long Delays Deleting Files over Network with XP SP1</title>
<para><quote>It sometimes takes approximately 35 seconds to delete files over the network after XP SP1 has been applied.</quote></para>