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>

diff --git a/docs-xml/smbdotconf/printing/lppausecommand.xml b/docs-xml/smbdotconf/printing/lppausecommand.xml
index 0bb66226f2dfbc3c6e19e1d13c9bec95be4fe45a..a165375e04234ebea4f51b34f546c13feea4d01e 100644 (file)
--- a/docs-xml/smbdotconf/printing/lppausecommand.xml
+++ b/docs-xml/smbdotconf/printing/lppausecommand.xml
@@ -24,16 +24,19 @@
 
     <para>Note that it is good practice to include the absolute path 
     in the lppause command as the PATH may not be available to the server.</para>
-</description>
-
-<related>printing</related>
 
-<value type="default"><comment>Currently no default value is given to 
+    <para>Currently no default value is given to
     this string, unless the value of the <smbconfoption name="printing"/> 
     parameter is <constant>SYSV</constant>, in which case the default is : 
     <command moreinfo="none">lp -i %p-%j -H hold</command> or if the value of the 
     <parameter moreinfo="none">printing</parameter> parameter is 
     <constant>SOFTQ</constant>, then the default is: 
-    <command moreinfo="none">qstat -s -j%j -h</command>. </comment></value>
+    <command moreinfo="none">qstat -s -j%j -h</command>. </para>
+
+</description>
+
+<related>printing</related>
+
+<value type="default"><comment>determined by printing parameter</comment></value>
 <value type="example">/usr/bin/lpalt %p-%j -p0</value>
 </samba:parameter>

diff --git a/docs-xml/smbdotconf/printing/lpqcommand.xml b/docs-xml/smbdotconf/printing/lpqcommand.xml
index 8c06b758985aaf8266c18977a8ba8e40e352b7be..1e021399817ae17afbe3ec85cbc710e07838a8cb 100644 (file)
--- a/docs-xml/smbdotconf/printing/lpqcommand.xml
+++ b/docs-xml/smbdotconf/printing/lpqcommand.xml
@@ -38,5 +38,5 @@
 <related>printing</related>
 
 <value type="example">/usr/bin/lpq -P%p</value>
-<value type="default"></value>
+<value type="default"><comment>determined by printing parameter</comment></value>
 </samba:parameter>

diff --git a/docs-xml/smbdotconf/printing/lpresumecommand.xml b/docs-xml/smbdotconf/printing/lpresumecommand.xml
index 706a999b1f70d4f0c933fe062fe167146c056d6f..ef7639cbfa4fc21240358057c4c4005443f2a3a0 100644 (file)
--- a/docs-xml/smbdotconf/printing/lpresumecommand.xml
+++ b/docs-xml/smbdotconf/printing/lpresumecommand.xml
@@ -34,5 +34,6 @@
     <para><command moreinfo="none">qstat -s -j%j -r</command></para>
 </description>
 
+<value type="default"><comment>determined by printing parameter</comment></value>
 <value type="example">/usr/bin/lpalt %p-%j -p2</value>
 </samba:parameter>

diff --git a/docs-xml/smbdotconf/printing/lprmcommand.xml b/docs-xml/smbdotconf/printing/lprmcommand.xml
index 0b8375f94d9835724c2f828a6636f7c052a03be4..7ce99640b73793f466aaa5c30137a64b43ed76d6 100644 (file)
--- a/docs-xml/smbdotconf/printing/lprmcommand.xml
+++ b/docs-xml/smbdotconf/printing/lprmcommand.xml
@@ -32,5 +32,5 @@ lprm command = /usr/bin/cancel %p-%j
 </description>
 <related>printing</related>
 
-<value type="default"> determined by printing parameter</value>
+<value type="default"><comment>determined by printing parameter</comment></value>
 </samba:parameter>

diff --git a/docs-xml/smbdotconf/printing/printing.xml b/docs-xml/smbdotconf/printing/printing.xml
index eb5925f740f2b70ed4061ad1998fcec0165ef986..a1a2178940247ac0143e1ba1e7f41dc4712ab4de 100644 (file)
--- a/docs-xml/smbdotconf/printing/printing.xml
+++ b/docs-xml/smbdotconf/printing/printing.xml
@@ -36,7 +36,9 @@
 
     <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">Depends on the operating system, see
-<command moreinfo="none">testparm -v.</command></value>
+<value type="default"><comment>Depends on the operating system</comment></value>
 </samba:parameter>

diff --git a/docs-xml/smbdotconf/printing/queuepausecommand.xml b/docs-xml/smbdotconf/printing/queuepausecommand.xml
index aee822ea804f16524cf525a021a49468a98e4f3c..21b56c9665417e94952285c22dafb18681031ea8 100644 (file)
--- a/docs-xml/smbdotconf/printing/queuepausecommand.xml
+++ b/docs-xml/smbdotconf/printing/queuepausecommand.xml
@@ -24,5 +24,6 @@
        server.</para>
 </description>
 
+<value type="default"><comment>determined by printing parameter</comment></value>
 <value type="example">disable %p</value>
 </samba:parameter>

diff --git a/docs-xml/smbdotconf/printing/queueresumecommand.xml b/docs-xml/smbdotconf/printing/queueresumecommand.xml
index f6593c228995e32f3bc9ba4e98ac4905c3be6f04..749bb02c658c718d030b5f82c8d2cbce07f9246f 100644 (file)
--- a/docs-xml/smbdotconf/printing/queueresumecommand.xml
+++ b/docs-xml/smbdotconf/printing/queueresumecommand.xml
@@ -26,6 +26,6 @@
        server.</para>
 </description>
 
-<value type="default"></value>
+<value type="default"><comment>determined by printing parameter</comment></value>
 <value type="example">enable %p</value>
 </samba:parameter>