Update lpadmin man page (Issue #5369)

diff --git a/CHANGES.md b/CHANGES.md
index 1a350802099079255f0a0de17e53c43551ff8d56..f82326d1fd1ada8c260a1248273d27f5d7697314 100644 (file)
--- a/CHANGES.md
+++ b/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

diff --git a/doc/help/man-cups-files.conf.html b/doc/help/man-cups-files.conf.html
index 131c33f013b26ee1f327bbb0ab14aea5c757407e..6144a165ceb5a688f432bfb140b843212ef0ff11 100644 (file)
--- a/doc/help/man-cups-files.conf.html
+++ b/doc/help/man-cups-files.conf.html
@@ -115,6 +115,9 @@ The server name may be included in filenames using the string "%s", for example:
 
 </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 @@ macOS uses its keychain database to store certificates and keys while other plat
 <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.

diff --git a/doc/help/man-cupsd.conf.html b/doc/help/man-cupsd.conf.html
index 0fff92d2e41effee678f66f7ca907e964ef93682..62700a5b878ca0746c2382dfd4e8e18d1b726e9a 100644 (file)
--- a/doc/help/man-cupsd.conf.html
+++ b/doc/help/man-cupsd.conf.html
@@ -227,8 +227,6 @@ The default is "1048576" (1MB).
 <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 @@ command.
 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>

diff --git a/doc/help/man-lpadmin.html b/doc/help/man-lpadmin.html
index a4563304ef327103fb8b56e2ca9e99f4359896fc..42c0f7ebcb07a754b81a84cce289ca782feab761 100644 (file)
--- a/doc/help/man-lpadmin.html
+++ b/doc/help/man-lpadmin.html
@@ -143,7 +143,8 @@ command to get a list of supported device URIs and schemes.
 <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 @@ This differs from the System V version which requires the root user to execute t
 <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">

diff --git a/man/lpadmin.man b/man/lpadmin.man
index 63a5e7ded4d97947d8741871049018c844ec2321..f870d816e2016d4bc248840150e306b0e22d2a52 100644 (file)
--- a/man/lpadmin.man
+++ b/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