First step towards XML: Use correct syntax

(This used to be commit 06f641bcb59f932c994e6023d400df18b54c2067)

1 files changed, 36 insertions, 33 deletions

diff --git a/docs/docbook/manpages/smbsh.1.sgml b/docs/docbook/manpages/smbsh.1.sgml
index c40609be4f..af080c298c 100644
--- a/docs/docbook/manpages/smbsh.1.sgml
+++ b/docs/docbook/manpages/smbsh.1.sgml
@@ -1,5 +1,5 @@
 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
-<refentry id="smbsh">
+<refentry id="smbsh.1">
 
 <refmeta>
 	<refentrytitle>smbsh</refentrytitle>
@@ -29,8 +29,8 @@
 <refsect1>
 	<title>DESCRIPTION</title>
 
-	<para>This tool is part of the <ulink url="samba.7.html">
-	Samba</ulink> suite.</para>
+	<para>This tool is part of the <citerefentry><refentrytitle>Samba</refentrytitle>
+	<manvolnum>7</manvolnum></citerefentry> suite.</para>
 
 	<para><command>smbsh</command> allows you to access an NT filesystem 
 	using UNIX commands such as <command>ls</command>, <command>
@@ -46,7 +46,8 @@
 	    <varlistentry>
 		<term>-W WORKGROUP</term>
 		<listitem><para>Override the default workgroup specified in the 
-		workgroup parameter of the <filename>smb.conf</filename> file 
+		workgroup parameter of the <citerefentry><refentrytitle>smb.conf</refentrytitle>
+		<manvolnum>5</manvolnum></citerefentry> file 
 		for this session. This may be needed to connect to some 
 		servers. </para></listitem>
 	    </varlistentry>
@@ -61,7 +62,8 @@
 	    </varlistentry>
 
 	    <varlistentry>
-		<term>-P prefix</term><listitem><para>This option allows
+		<term>-P prefix</term>
+		<listitem><para>This option allows
 		the user to set the directory prefix for SMB access. The 
 		default value if this option is not specified is 
 		<emphasis>smb</emphasis>.
@@ -75,19 +77,20 @@
 		host names to IP addresses. The option takes a space-separated 
 		string of different name resolution options.</para>
 
-		<para>The options are :"lmhosts", "host", "wins" and "bcast". 
+		<para>The options are: "lmhosts", "host", "wins" and "bcast". 
 		They cause names to be resolved as follows :</para>
 
 		<itemizedlist>
-			<listitem><para><constant>lmhosts</constant> : 
+			<listitem><para><constant>lmhosts</constant>: 
 			Lookup an IP address in the Samba lmhosts file. If the 
 			line in lmhosts has no name type attached to the 
 			NetBIOS name 
-			(see the <ulink url="lmhosts.5.html">lmhosts(5)</ulink>
-			for details) then any name type matches for lookup.
+			(see the <citerefentry><refentrytitle>lmhosts</refentrytitle>
+			<manvolnum>5</manvolnum></citerefentry>	for details) 
+			then any name type matches for lookup.
 			</para></listitem>
 
-			<listitem><para><constant>host</constant> : 
+			<listitem><para><constant>host</constant>: 
 			Do a standard host name to IP address resolution, using
 			the system <filename>/etc/hosts</filename>, NIS, or DNS
 			lookups. This method of name resolution is operating 
@@ -98,14 +101,14 @@
 			(server) name type, otherwise it is ignored.
 			</para></listitem>
 
-			<listitem><para><constant>wins</constant> : 
+			<listitem><para><constant>wins</constant>: 
 			Query a name with the IP address listed in the 
 			<parameter>wins server</parameter> parameter.  If no 
 			WINS server has been specified this method will be 
 			ignored.
 			</para></listitem>
 
-			<listitem><para><constant>bcast</constant> : 
+			<listitem><para><constant>bcast</constant>: 
 			Do a broadcast on each of the known local interfaces 
 			listed in the <parameter>interfaces</parameter>
 			parameter. This is the least reliable of the name 
@@ -115,14 +118,15 @@
 		</itemizedlist>
 
 		<para>If this parameter is not set then the name resolve order 
-		defined in the <filename>smb.conf</filename> file parameter  
-		(name resolve order) will be used. </para>
+		defined in the <citerefentry><refentrytitle>smb.conf</refentrytitle>
+		<manvolnum>5</manvolnum></citerefentry> file parameter  
+		(<parameter>name resolve order</parameter>) will be used. </para>
 
 		<para>The default order is lmhosts, host, wins, bcast. Without 
 		this parameter or any entry in the <parameter>name resolve order
-		</parameter> parameter of the <filename>smb.conf</filename> 
-		file, the name resolution methods will be attempted in this 
-		order. </para></listitem>
+		</parameter> parameter of the <citerefentry><refentrytitle>smb.conf</refentrytitle>
+		<manvolnum>5</manvolnum></citerefentry> file, the name resolution methods 
+		will be attempted in this order. </para></listitem>
 	    </varlistentry>
 
 	    <varlistentry>
@@ -133,7 +137,8 @@
 		is zero.</para>
 
 		<para>The higher this value, the more detail will be logged
-		about the activities of <command>nmblookup</command>. At level
+		about the activities of <citerefentry><refentrytitle>nmblookup</refentrytitle>
+		<manvolnum>1</manvolnum></citerefentry>. At level
 		0, only critical errors and serious warnings will be logged.
 		</para></listitem>
 	    </varlistentry>
@@ -164,13 +169,12 @@
 	<para>To use the <command>smbsh</command> command, execute <command>
 	smbsh</command> from the prompt and enter the username and password 
 	that authenticates you to the machine running the Windows NT 
-	operating system.</para>
-
-	<para><programlisting>
-	<prompt>system% </prompt><userinput>smbsh</userinput>
-	<prompt>Username: </prompt><userinput>user</userinput>
-	<prompt>Password: </prompt><userinput>XXXXXXX</userinput>
-	</programlisting></para>
+	operating system.
+<programlisting>
+<prompt>system% </prompt><userinput>smbsh</userinput>
+<prompt>Username: </prompt><userinput>user</userinput>
+<prompt>Password: </prompt><userinput>XXXXXXX</userinput>
+</programlisting></para>
 
 
 	<para>Any dynamically linked command you execute from 
@@ -188,8 +192,7 @@
 <refsect1>
 	<title>VERSION</title>
 
-	<para>This man page is correct for version 3.0 of 
-	the Samba suite.</para>
+	<para>This man page is correct for version 3.0 of the Samba suite.</para>
 </refsect1>
 
 <refsect1>
@@ -210,9 +213,9 @@
 
 <refsect1>
 	<title>SEE ALSO</title>
-	<para><ulink url="smbd.8.html"><command>smbd(8)</command></ulink>, 
-	<ulink url="smb.conf.5.html">smb.conf(5)</ulink>
-	</para>
+	<para><citerefentry><refentrytitle>smbd</refentrytitle>
+	<manvolnum>8</manvolnum></citerefentry>, <citerefentry><refentrytitle>smb.conf</refentrytitle>
+	<manvolnum>5</manvolnum></citerefentry></para>
 </refsect1>
 
 <refsect1>
@@ -225,11 +228,11 @@
 	
 	<para>The original Samba man pages were written by Karl Auer. 
 	The man page sources were converted to YODL format (another 
-	excellent piece of Open Source software, available at
-	<ulink url="ftp://ftp.icce.rug.nl/pub/unix/">
+	excellent piece of Open Source software, available at <ulink url="ftp://ftp.icce.rug.nl/pub/unix/">
 	ftp://ftp.icce.rug.nl/pub/unix/</ulink>) and updated for the Samba 2.0 
 	release by Jeremy Allison.  The conversion to DocBook for 
-	Samba 2.2 was done by Gerald Carter</para>
+	Samba 2.2 was done by Gerald Carter. The conversion to DocBook XML 4.2
+	for Samba 3.0 was done by Alexander Bokovoy.</para>
 </refsect1>
 
 </refentry>