summaryrefslogtreecommitdiff
path: root/docs/smbdotconf/printing
diff options
context:
space:
mode:
authorJohn Terpstra <jht@samba.org>2005-10-22 00:04:38 +0000
committerGerald W. Carter <jerry@samba.org>2008-04-23 08:47:10 -0500
commitf88faa0105fdf47eccfa3212870ac3066ff8113c (patch)
tree3047258902356d4d4eff006087e3b8a3a1ad0659 /docs/smbdotconf/printing
parent90dd48edb48f0c3fdd52b2adcb206257a3de639a (diff)
downloadsamba-f88faa0105fdf47eccfa3212870ac3066ff8113c.tar.gz
samba-f88faa0105fdf47eccfa3212870ac3066ff8113c.tar.bz2
samba-f88faa0105fdf47eccfa3212870ac3066ff8113c.zip
Fixes and reformatting from Bug #3190, plus a clean-up.
(This used to be commit 8250e36fe34394938df16533f77869b93d3be761)
Diffstat (limited to 'docs/smbdotconf/printing')
-rw-r--r--docs/smbdotconf/printing/printcapname.xml54
1 files changed, 28 insertions, 26 deletions
diff --git a/docs/smbdotconf/printing/printcapname.xml b/docs/smbdotconf/printing/printcapname.xml
index 7ade8881b6..90c575f31c 100644
--- a/docs/smbdotconf/printing/printcapname.xml
+++ b/docs/smbdotconf/printing/printcapname.xml
@@ -5,48 +5,50 @@
xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
<synonym>printcap</synonym>
<description>
- <para>This parameter may be used to override the
- compiled-in default printcap name used by the server (usually <filename moreinfo="none">
- /etc/printcap</filename>). See the discussion of the <link
- linkend="PRINTERSSECT">[printers]</link> section above for reasons
- why you might want to do this.</para>
+ <para>
+ This parameter may be used to override the compiled-in default printcap name used by the server (usually
+ <filename moreinfo="none"> /etc/printcap</filename>). See the discussion of the <link
+ linkend="PRINTERSSECT">[printers]</link> section above for reasons why you might want to do this.
+ </para>
- <para>To use the CUPS printing interface set <command moreinfo="none">printcap name = cups
- </command>. This should be supplemented by an addtional setting
- <smbconfoption name="printing">cups</smbconfoption> in the [global]
- section. <command moreinfo="none">printcap name = cups</command> will use the
- &quot;dummy&quot; printcap created by CUPS, as specified in your CUPS
- configuration file.
+ <para>
+ To use the CUPS printing interface set <command moreinfo="none">printcap name = cups </command>. This should
+ be supplemented by an addtional setting <smbconfoption name="printing">cups</smbconfoption> in the [global]
+ section. <command moreinfo="none">printcap name = cups</command> will use the &quot;dummy&quot; printcap
+ created by CUPS, as specified in your CUPS configuration file.
</para>
- <para>On System V systems that use <command moreinfo="none">lpstat</command> to
+ <para>
+ On System V systems that use <command moreinfo="none">lpstat</command> to
list available printers you can use <command moreinfo="none">printcap name = lpstat
</command> to automatically obtain lists of available printers. This
is the default for systems that define SYSV at configure time in
Samba (this includes most System V based systems). If <parameter moreinfo="none">
printcap name</parameter> is set to <command moreinfo="none">lpstat</command> on
these systems then Samba will launch <command moreinfo="none">lpstat -v</command> and
- attempt to parse the output to obtain a printer list.</para>
+ attempt to parse the output to obtain a printer list.
+ </para>
- <para>A minimal printcap file would look something like this:</para>
-
-<para><programlisting format="linespecific">
+ <para>
+ A minimal printcap file would look something like this:
+<programlisting format="linespecific">
print1|My Printer 1
print2|My Printer 2
print3|My Printer 3
print4|My Printer 4
print5|My Printer 5
-</programlisting></para>
-
- <para>where the '|' separates aliases of a printer. The fact
- that the second alias has a space in it gives a hint to Samba
- that it's a comment.</para>
+</programlisting>
+ where the '|' separates aliases of a printer. The fact that the second alias has a space in
+ it gives a hint to Samba that it's a comment.
+ </para>
+
+ <note><para>
+ Under AIX the default printcap name is <filename moreinfo="none">/etc/qconfig</filename>. Samba will
+ assume the file is in AIX <filename moreinfo="none">qconfig</filename> format if the string <filename
+ moreinfo="none">qconfig</filename> appears in the printcap filename.
+ </para></note>
- <note><para>Under AIX the default printcap
- name is <filename moreinfo="none">/etc/qconfig</filename>. Samba will assume the
- file is in AIX <filename moreinfo="none">qconfig</filename> format if the string
- <filename moreinfo="none">qconfig</filename> appears in the printcap filename.</para></note>
- </description>
+</description>
<value type="default">/etc/printcap</value>
<value type="example">/etc/myprintcap</value>