From: Michael R Sweet Date: Mon, 19 Mar 2018 22:41:59 +0000 (-0400) Subject: Deprecate printer drivers (Issue #5270) X-Git-Tag: v2.3b4~13 X-Git-Url: http://git.ipfire.org/?p=thirdparty%2Fcups.git;a=commitdiff_plain;h=ada35e599c31cd0556a3a780a524e5bdf7dabf9e Deprecate printer drivers (Issue #5270) Cleanup man page updates. --- diff --git a/doc/help/man-lpadmin.html b/doc/help/man-lpadmin.html index 3b04c8768..a4563304e 100644 --- a/doc/help/man-lpadmin.html +++ b/doc/help/man-lpadmin.html @@ -71,14 +71,13 @@ The following options are recognized when configuring a printer queue:
-c class
Adds the named printer to class. If class does not exist it is created automatically. -
-P ppd-file -
Specifies a PostScript Printer Description (PPD) file to use with the printer.
-m model
Sets a standard PPD file for the printer from the model directory or using one of the driver interfaces. Use the -m option with the lpinfo(8) command to get a list of supported models. The model "raw" clears any existing PPD file and the model "everywhere" queries the printer referred to by the specified IPP device-uri. +Note: Models other than "everywhere" are deprecated and will not be supported in a future version of CUPS.
-o cupsIPPSupplies=true
-o cupsIPPSupplies=false
Specifies whether IPP supply level values should be reported. @@ -157,7 +156,11 @@ The following lpadmin options are deprecated:
-i filename
This option historically has been used to provide either a System V interface script or (as an implementation side-effect) a PPD file. -Since interface scripts are no longer supported, the -P option is preferred for providing a PPD file for a printer. +Note: Interface scripts are not supported by CUPS. +PPD files and printer drivers are deprecated and will not be supported in a future version of CUPS. +
-P ppd-file +
Specifies a PostScript Printer Description (PPD) file to use with the printer. +Note: PPD files and printer drivers are deprecated and will not be supported in a future version of CUPS.

Conforming To

Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, "/", or "#". diff --git a/man/lpadmin.man b/man/lpadmin.man index ac0ed7ba1..63a5e7ded 100644 --- a/man/lpadmin.man +++ b/man/lpadmin.man @@ -76,16 +76,13 @@ The following options are recognized when configuring a printer queue: Adds the named \fIprinter\fR to \fIclass\fR. If \fIclass\fR does not exist it is created automatically. .TP 5 -\fB\-P \fIppd-file\fR -Specifies a PostScript Printer Description (PPD) file to use with the printer. -.TP 5 \fB\-m \fImodel\fR Sets a standard PPD file for the printer from the \fImodel\fR directory or using one of the driver interfaces. Use the \fI-m\fR option with the .BR lpinfo (8) command to get a list of supported models. The model "raw" clears any existing PPD file and the model "everywhere" queries the printer referred to by the specified IPP \fIdevice-uri\fR. -The "raw" model is deprecated and will not be supported in a future version of CUPS. +Note: Models other than "everywhere" are deprecated and will not be supported in a future version of CUPS. .TP 5 \fB\-o cupsIPPSupplies=true\fR .TP 5 @@ -189,7 +186,12 @@ The following \fBlpadmin\fR options are deprecated: .TP 5 \fB\-i \fIfilename\fR This option historically has been used to provide either a System V interface script or (as an implementation side-effect) a PPD file. -Since interface scripts are no longer supported, the \fI-P\fR option is preferred for providing a PPD file for a printer. +Note: Interface scripts are not supported by CUPS. +PPD files and printer drivers are deprecated and will not be supported in a future version of CUPS. +.TP 5 +\fB\-P \fIppd-file\fR +Specifies a PostScript Printer Description (PPD) file to use with the printer. +Note: PPD files and printer drivers are deprecated and will not be supported in a future version of CUPS. .SH CONFORMING TO Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, "/", or "#". Also, printer and class names are \fInot\fR case-sensitive. diff --git a/systemv/lpadmin.c b/systemv/lpadmin.c index 93579c5c4..85d57d83d 100644 --- a/systemv/lpadmin.c +++ b/systemv/lpadmin.c @@ -622,6 +622,10 @@ main(int argc, /* I - Number of command-line arguments */ num_options = cupsRemoveOption("ppd-name", num_options, &options); } + else if (ppd_name || file) + { + _cupsLangPuts(stderr, _("lpadmin: Printer drivers are deprecated and will stop working in a future version of CUPS.")); + } if (num_options || file) {