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