Very large number of markup fixes, layout updates, etc.

(This used to be commit 8dfbaafb843d17b865855ba1fef1e62cd38d3964)

1 files changed, 18 insertions, 14 deletions

diff --git a/docs/docbook/projdoc/Portability.xml b/docs/docbook/projdoc/Portability.xml
index 72c3d20547..9f1188e4a2 100644
--- a/docs/docbook/projdoc/Portability.xml
+++ b/docs/docbook/projdoc/Portability.xml
@@ -1,6 +1,8 @@
 <chapter id="Portability">
 <chapterinfo>
 	&author.jelmer;
+	<!-- Some other people as well, but there were no author names in the text files
+	this file is based on-->
 </chapterinfo>
 
 <title>Portability</title>
@@ -14,14 +16,14 @@ platform-specific information about compiling and using samba.</para>
 
 <para>
 HP's implementation of supplementary groups is, er, non-standard (for
-hysterical reasons).  There are two group files, /etc/group and
-/etc/logingroup; the system maps UIDs to numbers using the former, but
+hysterical reasons).  There are two group files, <filename>/etc/group</filename> and
+<filename>/etc/logingroup</filename>; the system maps UIDs to numbers using the former, but
 initgroups() reads the latter.  Most system admins who know the ropes
-symlink /etc/group to /etc/logingroup (hard link doesn't work for reasons
-too stupid to go into here).  initgroups() will complain if one of the
-groups you're in in /etc/logingroup has what it considers to be an invalid
-ID, which means outside the range [0..UID_MAX], where UID_MAX is (I think)
-60000 currently on HP-UX.  This precludes -2 and 65534, the usual 'nobody'
+symlink <filename>/etc/group</filename> to <filename>/etc/logingroup</filename>
+(hard link doesn't work for reasons too stupid to go into here).  initgroups() will complain if one of the
+groups you're in in <filename>/etc/logingroup</filename> has what it considers to be an invalid
+ID, which means outside the range <constant>[0..UID_MAX]</constant>, where <constant>UID_MAX</constant> is (I think)
+60000 currently on HP-UX.  This precludes -2 and 65534, the usual <constant>nobody</constant>
 GIDs.
 </para>
 
@@ -46,14 +48,15 @@ Samba.
 <title>SCO Unix</title>
 
 <para> 
-If you run an old version of  SCO Unix then you may need to get important 
+If you run an old version of SCO Unix then you may need to get important 
 TCP/IP patches for Samba to work correctly. Without the patch, you may 
 encounter corrupt data transfers using samba.
 </para>
 
 <para>
 The patch you need is UOD385 Connection Drivers SLS. It is available from
-SCO (ftp.sco.com, directory SLS, files uod385a.Z and uod385a.ltr.Z).
+SCO (<ulink url="ftp://ftp.sco.com/">ftp.sco.com</ulink>, directory SLS,
+files uod385a.Z and uod385a.ltr.Z).
 </para>
 
 </sect1>
@@ -121,8 +124,10 @@ _seteuid:
 after creating the above files you then assemble them using
 </para>
 
-<para><command>as seteuid.s</command></para>
-<para><command>as setegid.s</command></para>
+<screen>
+	<prompt>$ </prompt><userinput>as seteuid.s</userinput>
+	<prompt>$ </prompt><userinput>as setegid.s</userinput>
+</screen>
 
 <para>
 that should produce the files <filename>seteuid.o</filename> and 
@@ -155,7 +160,7 @@ You should then remove the line:
 
 <para>
 By default RedHat Rembrandt-II during installation adds an
-entry to /etc/hosts as follows:
+entry to <filename>/etc/hosts</filename> as follows:
 <programlisting>
 	127.0.0.1 loopback "hostname"."domainname"
 </programlisting>
@@ -209,8 +214,7 @@ has not been released yet.
 
 <para>
 The patch revision for 2.6 is 105181-34
-for 8 is 108528-19
-and for 9 is 112233-04
+for 8 is 108528-19 and for 9 is 112233-04
 </para>
 
 <para>