Update lpadmin man page (Issue #5369)

CHANGES.md

@@ -1,10 +1,11 @@
-CHANGES - 2.3b6 - 2018-08-18
+CHANGES - 2.3b6 - 2018-08-19
 ============================
 
 Changes in CUPS v2.3b6
 ----------------------
 
 - Localization update (Issue #5339, Issue #5348, Issue #5362)
+- Documenation updates (Issue #5369)
 - The lpadmin command would create a non-working printer in some error cases
   (Issue #5305)
 - The scheduler would crash if an empty `AccessLog` directive was specified

doc/help/man-cups-files.conf.html

@@ -115,6 +115,9 @@ <h3><a name="DIRECTIVES">Directives</a></h3>
 
 </pre>
 The default is "/var/log/cups/page_log".
+<dt><a name="PassEnv"></a><b>PassEnv </b><i>variable </i>[ ... <i>variable </i>]
+<dd style="margin-left: 5.0em">Passes the specified environment variable(s) to child processes.
+Note: the standard CUPS filter and backend environment variables cannot be overridden using this directive.
 <dt><a name="RemoteRoot"></a><b>RemoteRoot </b><i>username</i>
 <dd style="margin-left: 5.0em">Specifies the username that is associated with unauthenticated accesses by clients claiming to be the root user.
 The default is "remroot".
@@ -136,6 +139,9 @@ <h3><a name="DIRECTIVES">Directives</a></h3>
 <dt><a name="ServerRoot"></a><b>ServerRoot </b><i>directory</i>
 <dd style="margin-left: 5.0em">Specifies the directory containing the server configuration files.
 The default is "/etc/cups".
+<dt><a name="SetEnv"></a><b>SetEnv </b><i>variable value</i>
+<dd style="margin-left: 5.0em">Set the specified environment variable to be passed to child processes.
+Note: the standard CUPS filter and backend environment variables cannot be overridden using this directive.
 <dt><a name="StateDir"></a><b>StateDir </b><i>directory</i>
 <dd style="margin-left: 5.0em">Specifies the directory to use for PID and local certificate files.
 The default is "/var/run/cups" or "/etc/cups" depending on the platform.

doc/help/man-cupsd.conf.html

@@ -227,8 +227,6 @@ <h3><a name="TOP_LEVEL_DIRECTIVES">Top-level Directives</a></h3>
 <dt><a name="MultipleOperationTimeout"></a><b>MultipleOperationTimeout </b><i>seconds</i>
 <dd style="margin-left: 5.0em">Specifies the maximum amount of time to allow between files in a multiple file print job.
 The default is "300" (5 minutes).
-<dt><a name="PassEnv"></a><b>PassEnv </b><i>variable </i>[ ... <i>variable </i>]
-<dd style="margin-left: 5.0em">Passes the specified environment variable(s) to child processes.
 <dt><a name="Policy"></a><b>&lt;Policy </b><i>name</i><b>> </b>... <b>&lt;/Policy></b>
 <dd style="margin-left: 5.0em">Specifies access control for the named policy.
 <dt><a name="Port"></a><b>Port </b><i>number</i>
@@ -280,8 +278,6 @@ <h3><a name="TOP_LEVEL_DIRECTIVES">Top-level Directives</a></h3>
 command.
 "Full" reports "CUPS 2.0.0 (UNAME) IPP/2.0".
 The default is "Minimal".
-<dt><a name="SetEnv"></a><b>SetEnv </b><i>variable value</i>
-<dd style="margin-left: 5.0em">Set the specified environment variable to be passed to child processes.
 <dt><a name="SSLListen"></a><b>SSLListen </b><i>ipv4-address</i><b>:</b><i>port</i>
 <dd style="margin-left: 5.0em"><dt><b>SSLListen [</b><i>ipv6-address</i><b>]:</b><i>port</i>
 <dd style="margin-left: 5.0em"><dt><b>SSLListen *:</b><i>port</i>

doc/help/man-lpadmin.html

@@ -143,7 +143,8 @@ <h2 class="title"><a name="OPTIONS">Options</a></h2>
 <dt><b>-D "</b><i>info</i><b>"</b>
 <dd style="margin-left: 5.0em">Provides a textual description of the destination.
 <dt><b>-E</b>
-<dd style="margin-left: 5.0em">Enables the destination and accepts jobs; this is the same as running the
+<dd style="margin-left: 5.0em">When specified before the <b>-d</b>, <b>-p</b>, or <b>-x</b> options, forces the use of TLS encryption on the connection to the scheduler.
+Otherwise, enables the destination and accepts jobs; this is the same as running the
 <a href="man-cupsaccept.html?TOPIC=Man+Pages"><b>cupsaccept</b>(8)</a>
 and
 <a href="man-cupsenable.html?TOPIC=Man+Pages"><b>cupsenable</b>(8)</a>
@@ -170,6 +171,7 @@ <h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
 <h2 class="title"><a name="NOTES">Notes</a></h2>
 The CUPS version of <b>lpadmin</b> does not support all of the System V or Solaris printing system configuration options.
 Interface scripts are not supported for security reasons.
+<p>The double meaning of the <b>-E</b> option is an unfortunate historical oddity.
 <h2 class="title"><a name="EXAMPLE">Example</a></h2>
 Create an IPP Everywhere print queue:
 <pre class="man">

man/lpadmin.man

@@ -6,7 +6,7 @@
 .\"
 .\" Licensed under Apache License v2.0.  See the file "LICENSE" for more information.
 .\"
-.TH lpadmin 8 "CUPS" "19 March 2018" "Apple Inc."
+.TH lpadmin 8 "CUPS" "19 August 2018" "Apple Inc."
 .SH NAME
 lpadmin \- configure cups printers and classes
 .SH SYNOPSIS
@@ -173,7 +173,8 @@ command to get a list of supported device URIs and schemes.
 Provides a textual description of the destination.
 .TP 5
 .B \-E
-Enables the destination and accepts jobs; this is the same as running the
+When specified before the \fB\-d\fR, \fB\-p\fR, or \fB\-x\fR options, forces the use of TLS encryption on the connection to the scheduler.
+Otherwise, enables the destination and accepts jobs; this is the same as running the
 .BR cupsaccept (8)
 and
 .BR cupsenable (8)
@@ -200,6 +201,8 @@ This differs from the System V version which requires the root user to execute t
 .SH NOTES
 The CUPS version of \fBlpadmin\fR does not support all of the System V or Solaris printing system configuration options.
 Interface scripts are not supported for security reasons.
+.PP
+The double meaning of the \fB\-E\fR option is an unfortunate historical oddity.
 .SH EXAMPLE
 Create an IPP Everywhere print queue:
 .nf