1
0
mirror of https://github.com/samba-team/samba.git synced 2025-01-26 10:04:02 +03:00
Andrew Bartlett 92b0344e68 docs: explain where the defaults for these printing parameters comes from
The use of <comment> allows the XML parser in the tests to skip the descriptive text.

Signed-off-by: Andrew Bartlett <abartlet@samba.org>
Reviewed-by: Alexander Bokovoy <ab@samba.org>
2014-01-28 17:26:40 +13:00

45 lines
2.1 KiB
XML

<samba:parameter name="printing"
context="S"
type="enum"
print="1"
xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
<description>
<para>This parameters controls how printer status information is
interpreted on your system. It also affects the default values for
the <parameter moreinfo="none">print command</parameter>, <parameter
moreinfo="none">lpq command</parameter>, <parameter
moreinfo="none">lppause command </parameter>, <parameter
moreinfo="none">lpresume command</parameter>, and <parameter
moreinfo="none">lprm command</parameter> if specified in the
[global] section.</para>
<para>Currently nine printing styles are supported. They are
<constant>BSD</constant>, <constant>AIX</constant>,
<constant>LPRNG</constant>, <constant>PLP</constant>,
<constant>SYSV</constant>, <constant>HPUX</constant>,
<constant>QNX</constant>, <constant>SOFTQ</constant>,
<constant>CUPS</constant> and <constant>IPRINT</constant>.</para>
<para>Be aware that CUPS and IPRINT are only available if the CUPS
development library was available at the time Samba was compiled
or packaged.</para>
<para>To see what the defaults are for the other print
commands when using the various options use the <citerefentry><refentrytitle>testparm</refentrytitle>
<manvolnum>1</manvolnum></citerefentry> program.</para>
<para>This option can be set on a per printer basis. Please be
aware however, that you must place any of the various printing
commands (e.g. print command, lpq command, etc...) after defining
the value for the <parameter>printing</parameter> option since it will
reset the printing commands to default values.</para>
<para>See also the discussion in the <link linkend="PRINTERSSECT">
[printers]</link> section.</para>
<para>See <command moreinfo="none">testparm -v.</command> for the default
value on your system</para>
</description>
<value type="default"><comment>Depends on the operating system</comment></value>
</samba:parameter>