Regenerate

(This used to be commit 25db62e3101dbcae8e9daee3cb16430297afa223)

1 files changed, 105 insertions, 131 deletions

diff --git a/docs/htmldocs/printing.html b/docs/htmldocs/printing.html
index 92eb52c7cc..91a1ad72b0 100644
--- a/docs/htmldocs/printing.html
+++ b/docs/htmldocs/printing.html
@@ -5,7 +5,7 @@
 >Printing Support</TITLE
 ><META
 NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.77+"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
 REL="HOME"
 TITLE="SAMBA Project Documentation"
 HREF="samba-howto-collection.html"><LINK
@@ -80,9 +80,9 @@ CLASS="SECT1"
 ><H1
 CLASS="SECT1"
 ><A
-NAME="AEN2054"
-></A
->13.1. Introduction</H1
+NAME="AEN1957"
+>13.1. Introduction</A
+></H1
 ><P
 >Beginning with the 2.2.0 release, Samba supports 
 the native Windows NT printing mechanisms implemented via 
@@ -163,9 +163,9 @@ CLASS="SECT1"
 ><H1
 CLASS="SECT1"
 ><A
-NAME="AEN2076"
-></A
->13.2. Configuration</H1
+NAME="AEN1979"
+>13.2. Configuration</A
+></H1
 ><DIV
 CLASS="WARNING"
 ><P
@@ -204,19 +204,15 @@ a printer$ service which provides read-only access via no
 password in order to support printer driver downloads.</P
 ><P
 >However, the initial implementation allowed for a 
-parameter named <TT
+parameter named <VAR
 CLASS="PARAMETER"
-><I
->printer driver location</I
-></TT
+>printer driver location</VAR
 > 
 to be used on a per share basis to specify the location of 
 the driver files associated with that printer.  Another 
-parameter named <TT
+parameter named <VAR
 CLASS="PARAMETER"
-><I
->printer driver</I
-></TT
+>printer driver</VAR
 > provided 
 a means of defining the printer driver name to be sent to 
 the client.</P
@@ -229,9 +225,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN2084"
-></A
->13.2.1. Creating [print$]</H2
+NAME="AEN1987"
+>13.2.1. Creating [print$]</A
+></H2
 ><P
 >In order to support the uploading of printer driver 
 files, you must first configure a file share named [print$].  
@@ -270,11 +266,9 @@ CLASS="PROGRAMLISTING"
 >The <A
 HREF="smb.conf.5.html#WRITELIST"
 TARGET="_top"
-><TT
+><VAR
 CLASS="PARAMETER"
-><I
->write list</I
-></TT
+>write list</VAR
 ></A
 > is used to allow administrative 
 level user accounts to have write access in order to update files 
@@ -414,12 +408,10 @@ one of two conditions must hold true:</P
 	must be a member of the <A
 HREF="smb.conf.5.html#PRINTERADMIN"
 TARGET="_top"
-><TT
+><VAR
 CLASS="PARAMETER"
-><I
 >printer 
-	admin</I
-></TT
+	admin</VAR
 ></A
 > list.</P
 ></LI
@@ -435,11 +427,9 @@ that all file shares are set to 'read only' by default.</P
 ><P
 >Once you have created the required [print$] service and 
 associated subdirectories, simply log onto the Samba server using 
-a root (or <TT
+a root (or <VAR
 CLASS="PARAMETER"
-><I
->printer admin</I
-></TT
+>printer admin</VAR
 >) account
 from a Windows NT 4.0/2k client.  Open "Network Neighbourhood" or
 "My Network Places" and browse for the Samba host.  Once you have located
@@ -452,9 +442,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN2119"
-></A
->13.2.2. Setting Drivers for Existing Printers</H2
+NAME="AEN2022"
+>13.2.2. Setting Drivers for Existing Printers</A
+></H2
 ><P
 >The initial listing of printers in the Samba host's 
 Printers folder will have no real printer driver assigned 
@@ -524,9 +514,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN2135"
-></A
->13.2.3. Support a large number of printers</H2
+NAME="AEN2038"
+>13.2.3. Support a large number of printers</A
+></H2
 ><P
 >One issue that has arisen during the development
 phase of Samba 2.2 is the need to support driver downloads for
@@ -547,9 +537,9 @@ of how this could be accomplished:</P
 ><PRE
 CLASS="PROGRAMLISTING"
 > 
-<TT
+<SAMP
 CLASS="PROMPT"
->$ </TT
+>$ </SAMP
 >rpcclient pogo -U root%secret -c "enumdrivers"
 Domain=[NARNIA] OS=[Unix] Server=[Samba 2.2.0-alpha3]
  
@@ -563,9 +553,9 @@ Printer Driver Info 1:
 Printer Driver Info 1:
      Driver Name: [HP LaserJet 4Si/4SiMX PS]
 				  
-<TT
+<SAMP
 CLASS="PROMPT"
->$ </TT
+>$ </SAMP
 >rpcclient pogo -U root%secret -c "enumprinters"
 Domain=[NARNIA] OS=[Unix] Server=[Samba 2.2.0-alpha3]
      flags:[0x800000]
@@ -573,13 +563,13 @@ Domain=[NARNIA] OS=[Unix] Server=[Samba 2.2.0-alpha3]
      description:[POGO\\POGO\hp-print,NO DRIVER AVAILABLE FOR THIS PRINTER,]
      comment:[]
 				  
-<TT
+<SAMP
 CLASS="PROMPT"
->$ </TT
+>$ </SAMP
 >rpcclient pogo -U root%secret \
-<TT
+<SAMP
 CLASS="PROMPT"
->&gt; </TT
+>&#62; </SAMP
 > -c "setdriver hp-print \"HP LaserJet 4000 Series PS\""
 Domain=[NARNIA] OS=[Unix] Server=[Samba 2.2.0-alpha3]
 Successfully set hp-print to driver HP LaserJet 4000 Series PS.</PRE
@@ -590,9 +580,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN2146"
-></A
->13.2.4. Adding New Printers via the Windows NT APW</H2
+NAME="AEN2049"
+>13.2.4. Adding New Printers via the Windows NT APW</A
+></H2
 ><P
 >By default, Samba offers all printer shares defined in <TT
 CLASS="FILENAME"
@@ -607,11 +597,9 @@ Add Printer Wizard icon.  The APW will be show only if</P
 ><P
 >The connected user is able to successfully
 	execute an OpenPrinterEx(\\server) with administrative
-	privileges (i.e. root or <TT
+	privileges (i.e. root or <VAR
 CLASS="PARAMETER"
-><I
->printer admin</I
-></TT
+>printer admin</VAR
 >).
 	</P
 ></LI
@@ -620,12 +608,10 @@ CLASS="PARAMETER"
 ><A
 HREF="smb.conf.5.html#SHOWADDPRINTERWIZARD"
 TARGET="_top"
-><TT
+><VAR
 CLASS="PARAMETER"
-><I
 >show 
-	add printer wizard = yes</I
-></TT
+	add printer wizard = yes</VAR
 ></A
 > (the default).
 	</P
@@ -636,12 +622,10 @@ CLASS="PARAMETER"
 server, the <A
 HREF="smb.conf.5.html#ADDPRINTERCOMMAND"
 TARGET="_top"
-><TT
+><VAR
 CLASS="PARAMETER"
-><I
 >add 
-printer command</I
-></TT
+printer command</VAR
 ></A
 > must have a defined value.  The program
 hook must successfully add the printer to the system (i.e. 
@@ -658,35 +642,29 @@ CLASS="FILENAME"
 not exist, <B
 CLASS="COMMAND"
 >smbd</B
-> will execute the <TT
+> will execute the <VAR
 CLASS="PARAMETER"
-><I
 >add printer 
-command</I
-></TT
+command</VAR
 > and reparse to the <TT
 CLASS="FILENAME"
 >smb.conf</TT
 >
 to attempt to locate the new printer share.  If the share is still not defined,
 an error of "Access Denied" is returned to the client.  Note that the 
-<TT
+<VAR
 CLASS="PARAMETER"
-><I
->add printer program</I
-></TT
+>add printer program</VAR
 > is executed under the context
 of the connected user, not necessarily a root account.</P
 ><P
 >There is a complementary <A
 HREF="smb.conf.5.html#DELETEPRINTERCOMMAND"
 TARGET="_top"
-><TT
+><VAR
 CLASS="PARAMETER"
-><I
 >delete
-printer command</I
-></TT
+printer command</VAR
 ></A
 > for removing entries from the "Printers..."
 folder.</P
@@ -694,11 +672,9 @@ folder.</P
 >The following is an example <A
 HREF="smb.conf.5.html#ADDPRINTERCOMMAN"
 TARGET="_top"
-><TT
+><VAR
 CLASS="PARAMETER"
-><I
->add printer command</I
-></TT
+>add printer command</VAR
 ></A
 > script. It adds the appropriate entries to <TT
 CLASS="FILENAME"
@@ -733,8 +709,8 @@ echo "  :sd=/var/spool/lpd/$2:\\" 			&#62;&#62; $PRINTCAP
 echo "  :mx=0:ml=0:sh:\\" 				&#62;&#62; $PRINTCAP
 echo "  :lp=/usr/local/samba/var/print/$5.prn:" 	&#62;&#62; $PRINTCAP
 
-touch "/usr/local/samba/var/print/$5.prn" &#62;&#62; /tmp/printadd.$$ 2&#62;&amp;1
-chown $LP "/usr/local/samba/var/print/$5.prn" &#62;&#62; /tmp/printadd.$$ 2&#62;&amp;1
+touch "/usr/local/samba/var/print/$5.prn" &#62;&#62; /tmp/printadd.$$ 2&#62;&#38;1
+chown $LP "/usr/local/samba/var/print/$5.prn" &#62;&#62; /tmp/printadd.$$ 2&#62;&#38;1
 
 mkdir /var/spool/lpd/$2
 chmod 700 /var/spool/lpd/$2
@@ -759,9 +735,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN2176"
-></A
->13.2.5. Samba and Printer Ports</H2
+NAME="AEN2079"
+>13.2.5. Samba and Printer Ports</A
+></H2
 ><P
 >Windows NT/2000 print servers associate a port with each printer.  These normally
 take the form of LPT1:, COM1:, FILE:, etc...  Samba must also support the
@@ -780,12 +756,10 @@ CLASS="FILENAME"
 > possesses a <A
 HREF="smb.conf.5.html#ENUMPORTSCOMMAND"
 TARGET="_top"
-><TT
+><VAR
 CLASS="PARAMETER"
-><I
 >enumports 
-command</I
-></TT
+command</VAR
 ></A
 > which can be used to define an external program 
 that generates a listing of ports on a system.</P
@@ -796,9 +770,9 @@ CLASS="SECT1"
 ><H1
 CLASS="SECT1"
 ><A
-NAME="AEN2184"
-></A
->13.3. The Imprints Toolset</H1
+NAME="AEN2087"
+>13.3. The Imprints Toolset</A
+></H1
 ><P
 >The Imprints tool set provides a UNIX equivalent of the 
 	Windows NT Add Printer Wizard.  For complete information, please 
@@ -814,9 +788,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN2188"
-></A
->13.3.1. What is Imprints?</H2
+NAME="AEN2091"
+>13.3.1. What is Imprints?</A
+></H2
 ><P
 >Imprints is a collection of tools for supporting the goals 
 		of</P
@@ -846,9 +820,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN2198"
-></A
->13.3.2. Creating Printer Driver Packages</H2
+NAME="AEN2101"
+>13.3.2. Creating Printer Driver Packages</A
+></H2
 ><P
 >The process of creating printer driver packages is beyond
 		the scope of this document (refer to Imprints.txt also included
@@ -862,9 +836,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN2201"
-></A
->13.3.3. The Imprints server</H2
+NAME="AEN2104"
+>13.3.3. The Imprints server</A
+></H2
 ><P
 >The Imprints server is really a database server that 
 		may be queried via standard HTTP mechanisms.  Each printer 
@@ -886,9 +860,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN2205"
-></A
->13.3.4. The Installation Client</H2
+NAME="AEN2108"
+>13.3.4. The Installation Client</A
+></H2
 ><P
 >More information regarding the Imprints installation client 
 		is available in the <TT
@@ -980,17 +954,17 @@ CLASS="SECT1"
 ><H1
 CLASS="SECT1"
 ><A
-NAME="AEN2227"
-></A
->13.4. Diagnosis</H1
+NAME="AEN2130"
+>13.4. Diagnosis</A
+></H1
 ><DIV
 CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN2229"
-></A
->13.4.1. Introduction</H2
+NAME="AEN2132"
+>13.4.1. Introduction</A
+></H2
 ><P
 >This is a short description of how to debug printing problems with
 Samba. This describes how to debug problems with printing from a SMB
@@ -1052,7 +1026,7 @@ and it should be periodically cleaned out.  Samba used the lpq
 command to determine the "job number" assigned to your print job
 by the spooler.</P
 ><P
->The %&gt;letter&lt; are "macros" that get dynamically replaced with appropriate
+>The %&#62;letter&#60; are "macros" that get dynamically replaced with appropriate
 values when they are used. The %s gets replaced with the name of the spool
 file that Samba creates and the %p gets replaced with the name of the
 printer. The %j gets replaced with the "job number" which comes from
@@ -1063,9 +1037,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN2245"
-></A
->13.4.2. Debugging printer problems</H2
+NAME="AEN2148"
+>13.4.2. Debugging printer problems</A
+></H2
 ><P
 >One way to debug printing problems is to start by replacing these
 command with shell scripts that record the arguments and the contents
@@ -1081,7 +1055,7 @@ CLASS="PROGRAMLISTING"
     /usr/bin/id -p &#62;/tmp/tmp.print
     # we run the command and save the error messages
     # replace the command with the one appropriate for your system
-    /usr/bin/lpr -r -P$1 $2 2&#62;&#62;&amp;/tmp/tmp.print</PRE
+    /usr/bin/lpr -r -P$1 $2 2&#62;&#62;&#38;/tmp/tmp.print</PRE
 ></P
 ><P
 >Then you print a file and try removing it.  You may find that the
@@ -1120,9 +1094,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN2254"
-></A
->13.4.3. What printers do I have?</H2
+NAME="AEN2157"
+>13.4.3. What printers do I have?</A
+></H2
 ><P
 >You can use the 'testprns' program to check to see if the printer
 name you are using is recognized by Samba.  For example,  you can
@@ -1149,9 +1123,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN2262"
-></A
->13.4.4. Setting up printcap and print servers</H2
+NAME="AEN2165"
+>13.4.4. Setting up printcap and print servers</A
+></H2
 ><P
 >You may need to set up some printcaps for your Samba system to use.
 It is strongly recommended that you use the facilities provided by
@@ -1233,9 +1207,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN2290"
-></A
->13.4.5. Job sent, no output</H2
+NAME="AEN2193"
+>13.4.5. Job sent, no output</A
+></H2
 ><P
 >This is the most frustrating part of printing.  You may have sent the
 job,  verified that the job was forwarded,  set up a wrapper around
@@ -1278,9 +1252,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN2301"
-></A
->13.4.6. Job sent, strange output</H2
+NAME="AEN2204"
+>13.4.6. Job sent, strange output</A
+></H2
 ><P
 >Once you have the job printing, you can then start worrying about
 making it print nicely.</P
@@ -1324,9 +1298,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN2313"
-></A
->13.4.7. Raw PostScript printed</H2
+NAME="AEN2216"
+>13.4.7. Raw PostScript printed</A
+></H2
 ><P
 >This is a problem that is usually caused by either the print spooling
 system putting information at the start of the print job that makes
@@ -1339,9 +1313,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN2316"
-></A
->13.4.8. Advanced Printing</H2
+NAME="AEN2219"
+>13.4.8. Advanced Printing</A
+></H2
 ><P
 >Note that you can do some pretty magic things by using your
 imagination with the "print command" option and some shell scripts.
@@ -1355,9 +1329,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="AEN2319"
-></A
->13.4.9. Real debugging</H2
+NAME="AEN2222"
+>13.4.9. Real debugging</A
+></H2
 ><P
 >If the above debug tips don't help, then maybe you need to bring in
 the bug guns, system tracing. See Tracing.txt in this directory.</P