Document default of the printing config variable.
[kai/samba.git] / docs-xml / smbdotconf / printing / printing.xml
1 <samba:parameter name="printing"
2                  context="S"
3                                  type="enum"
4                  print="1"
5                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
6 <description>
7     <para>This parameters controls how printer status  information is
8     interpreted on your system. It also affects the  default values for
9     the <parameter moreinfo="none">print command</parameter>,  <parameter
10     moreinfo="none">lpq command</parameter>, <parameter
11     moreinfo="none">lppause command </parameter>, <parameter
12     moreinfo="none">lpresume command</parameter>, and  <parameter
13     moreinfo="none">lprm command</parameter> if specified in the 
14     [global] section.</para>
15
16     <para>Currently nine printing styles are supported. They are
17     <constant>BSD</constant>, <constant>AIX</constant>, 
18     <constant>LPRNG</constant>, <constant>PLP</constant>,
19     <constant>SYSV</constant>, <constant>HPUX</constant>,
20     <constant>QNX</constant>, <constant>SOFTQ</constant>,
21     and <constant>CUPS</constant>.</para>
22
23     <para>To see what the defaults are for the other print 
24     commands when using the various options use the <citerefentry><refentrytitle>testparm</refentrytitle>
25     <manvolnum>1</manvolnum></citerefentry> program.</para>
26
27     <para>This option can be set on a per printer basis.  Please be 
28     aware however, that you must place any of the various printing 
29     commands (e.g. print command, lpq command, etc...) after defining
30     the value for the <parameter>printing</parameter> option since it will 
31     reset the printing commands to default values.</para>
32
33     <para>See also the discussion in the <link linkend="PRINTERSSECT">
34     [printers]</link> section.</para>
35 </description>
36 <value type="default">Depends on the operating system, see
37 <command moreinfo="none">testparm -v.</command></value>
38 </samba:parameter>