]> git.ipfire.org Git - thirdparty/cups.git/commitdiff
Deprecate cups-config (Issue #97)
authorMichael R Sweet <michael.r.sweet@gmail.com>
Wed, 10 Mar 2021 21:12:03 +0000 (16:12 -0500)
committerMichael R Sweet <msweet@msweet.org>
Thu, 11 Mar 2021 00:25:29 +0000 (19:25 -0500)
CHANGES.md
cups-config.in
doc/help/man-cups-config.html
doc/help/man-cupsd.conf.html
man/cups-config.1

index eadccfe235542d6eb149d8bf12c6ea3e93560959..0a04a1a1ae51a74e494b5449ac98ddc56d70ba63 100644 (file)
@@ -14,12 +14,15 @@ CUPS v2.4rc1 (Pending)
   by default (Issue #85)
 - The `cupsfilter` command now shows error messages when options are used
   incorrectly (Issue #88)
-- Documentation fixes (Issue #92)
-- Kerberos (`AuthType Negotiate`) authentication is now deprecated (Issue #98)
 - The PPD functions now treat boolean values as case-insensitive (Issue #106)
 - Temporary queue names no longer end with an underscore (Issue #110)
 - The USB backend now runs as root (Issue #121)
+- Added pkg-config file for libcups (Issue #122)
 - Fixed a PPD memory leak caused by emulator definitions (Issue #124)
+- Documentation fixes (Issue #92)
+- Localization updates (Issue #123)
+- Deprecated cups-config (Issue #97)
+- Deprecated Kerberos (`AuthType Negotiate`) authentication (Issue #98)
 - Removed support for the (long deprecated and unused) `FontPath`,
   `LPDConfigFile`, `RIPCache`, and `SMBConfigFile` directives in `cupsd.conf`
   and `cups-files.conf`.
index 0e60b49487f2a2be2b96f94b9ad18ba8c054c6b7..f6221b6d740a0618f1b24e35f1332d09a2c7813b 100755 (executable)
@@ -11,7 +11,7 @@
 #
 
 VERSION="@CUPS_VERSION@"
-APIVERSION="2.3"
+APIVERSION="2.4"
 BUILD="@CUPS_BUILD@"
 
 prefix=@prefix@
@@ -50,7 +50,7 @@ else
 fi
 
 
-usage ()
+usage()
 {
     echo "Usage: cups-config --api-version"
     echo "       cups-config --build"
@@ -62,6 +62,9 @@ usage ()
     echo "       cups-config --serverbin"
     echo "       cups-config --serverroot"
     echo "       cups-config --version"
+    echo ""
+    echo "Note: The cups-config utility is deprecated and will be removed in a future"
+    echo "      version of CUPS.  Use the pkg-config utility instead."
 
     exit $1
 }
index 563a7e7c5538dd546a0f4d73a319e5c9bb6b3c2e..71b441c631081425e4d62444db51ce333238e663 100644 (file)
@@ -8,7 +8,7 @@
 <body>
 <h1 class="title">cups-config(1)</h1>
 <h2 class="title"><a name="NAME">Name</a></h2>
-cups-config - get cups api, compiler, directory, and link information.
+cups-config - get cups api, compiler, directory, and link information (deprecated).
 <h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
 <b>cups-config</b>
 <i>--api-version</i>
@@ -48,6 +48,11 @@ cups-config - get cups api, compiler, directory, and link information.
 <h2 class="title"><a name="DESCRIPTION">Description</a></h2>
 The <b>cups-config</b> command allows application developers to determine the necessary command-line options for the compiler and linker, as well as the installation directories for filters, configuration files, and drivers.
 All values are reported to the standard output.
+<b>Note:</b>
+This command is deprecated and will be removed in a future version of CUPS.
+The
+<b>pkg-config</b>(1)
+command should be used instead.
 <h2 class="title"><a name="OPTIONS">Options</a></h2>
 The <b>cups-config</b> command accepts the following command-line options:
 <dl class="man">
@@ -95,6 +100,7 @@ The following options are deprecated but continue to work for backwards compatib
 </dl>
 <h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
 <b>cups</b>(1),
+<b>pkg-config</b>(1),
 CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
 <h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
 Copyright &copy; 2021 by OpenPrinting.
index 4d653c90f261da163f404b4ba5a7dbb932ba9389..d66f67e55b7dceaad6aefd0d62b47ee5d1eda2e7 100644 (file)
@@ -58,7 +58,6 @@ The default is "No".
 Specifies whether shared printers are advertised.
 The default is "No".
 <dt><a name="DefaultAuthType"></a><b>DefaultAuthType Basic</b>
-<dd style="margin-left: 5.0em"><dt><b>DefaultAuthType Negotiate</b>
 <dd style="margin-left: 5.0em"><br>
 Specifies the default type of authentication to use.
 The default is "Basic".
@@ -111,9 +110,6 @@ The default limit is "0".
 value) of filters that are run to print a job.
 The nice value ranges from 0, the highest priority, to 19, the lowest priority.
 The default is 0.
-<dt><a name="GSSServiceName"></a><b>GSSServiceName </b><i>name</i>
-<dd style="margin-left: 5.0em">Specifies the service name when using Kerberos authentication.
-The default service name is "http."
 <dt><b>HostNameLookups On</b>
 <dd style="margin-left: 5.0em"><dt><a name="HostNameLookups"></a><b>HostNameLookups Off</b>
 <dd style="margin-left: 5.0em"><dt><b>HostNameLookups Double</b>
@@ -464,7 +460,6 @@ The Order directive controls whether Allow lines are evaluated before or after D
 <dt><b>AuthType None</b>
 <dd style="margin-left: 5.0em"><dt><b>AuthType Basic</b>
 <dd style="margin-left: 5.0em"><dt><b>AuthType Default</b>
-<dd style="margin-left: 5.0em"><dt><b>AuthType Negotiate</b>
 <dd style="margin-left: 5.0em">Specifies the type of authentication required.
 The value "Default" corresponds to the DefaultAuthType value.
 <dt><b>Deny all</b>
@@ -547,6 +542,8 @@ The "default" values are "notify-events", "notify-pull-method", "notify-recipien
 <h3><a name="DEPRECATED_DIRECTIVES">Deprecated Directives</a></h3>
 The following directives are deprecated and will be removed in a future release of CUPS:
 <dl class="man">
+<dt><b>AuthType Negotiate</b>
+<dd style="margin-left: 5.0em">Specifies Kerberos authentication is required.
 <dt><a name="Classification"></a><b>Classification </b><i>banner</i>
 <dd style="margin-left: 5.0em"><br>
 Specifies the security classification of the server.
@@ -557,6 +554,11 @@ The default is no classification banner.
 <dd style="margin-left: 5.0em"><br>
 Specifies whether users may override the classification (cover page) of individual print jobs using the "job-sheets" option.
 The default is "No".
+<dt><b>DefaultAuthType Negotiate</b>
+<dd style="margin-left: 5.0em">Specifies that Kerberos authentication is required by default.
+<dt><a name="GSSServiceName"></a><b>GSSServiceName </b><i>name</i>
+<dd style="margin-left: 5.0em">Specifies the service name when using Kerberos authentication.
+The default service name is "http."
 <dt><a name="PageLogFormat"></a><b>PageLogFormat </b><i>format-string</i>
 <dd style="margin-left: 5.0em">Specifies the format of PageLog lines.
 Sequences beginning with percent (%) characters are replaced with the corresponding information, while all other characters are copied literally.
index 531ed4727882a0a983070f82be5ec26a7774935c..eb6de8123c4c1d9dfa1f6700f0e753d01c5a0a24 100644 (file)
@@ -8,9 +8,9 @@
 .\" Licensed under Apache License v2.0.  See the file "LICENSE" for more
 .\" information.
 .\"
-.TH cups-config 1 "CUPS" "2021-02-28" "OpenPrinting"
+.TH cups-config 1 "CUPS" "2021-03-10" "OpenPrinting"
 .SH NAME
-cups\-config \- get cups api, compiler, directory, and link information.
+cups\-config \- get cups api, compiler, directory, and link information (deprecated).
 .SH SYNOPSIS
 .B cups\-config
 .I \-\-api\-version
@@ -50,6 +50,11 @@ cups\-config \- get cups api, compiler, directory, and link information.
 .SH DESCRIPTION
 The \fBcups-config\fR command allows application developers to determine the necessary command-line options for the compiler and linker, as well as the installation directories for filters, configuration files, and drivers.
 All values are reported to the standard output.
+.B Note:
+This command is deprecated and will be removed in a future version of CUPS.
+The
+.BR pkg-config (1)
+command should be used instead.
 .SH OPTIONS
 The \fBcups-config\fR command accepts the following command-line options:
 .TP 5
@@ -105,6 +110,7 @@ The following options are deprecated but continue to work for backwards compatib
 Formerly used to add the CUPS imaging library to the list of libraries.
 .SH SEE ALSO
 .BR cups (1),
+.BR pkg-config (1),
 CUPS Online Help (http://localhost:631/help)
 .SH COPYRIGHT
 Copyright \[co] 2021 by OpenPrinting.