summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorMichael R Sweet <michaelrsweet@gmail.com>2017-11-01 12:15:35 -0400
committerMichael R Sweet <michaelrsweet@gmail.com>2017-11-01 12:15:35 -0400
commitd0df9cd33768b02cf5327c9d625568d21ced0297 (patch)
treeaac4996063ea10fd8b5476ea8d6d38196be54c5b /man
parentb00c84094b1750612e7172251ab95a69627e044b (diff)
downloadcups-d0df9cd33768b02cf5327c9d625568d21ced0297.tar.gz
Update lpadmin documentation and show a meaningful error message for interface scripts (Issue #5111)
Diffstat (limited to 'man')
-rw-r--r--man/lpadmin.man13
1 files changed, 9 insertions, 4 deletions
diff --git a/man/lpadmin.man b/man/lpadmin.man
index 17607287c..6d776555c 100644
--- a/man/lpadmin.man
+++ b/man/lpadmin.man
@@ -1,7 +1,7 @@
.\"
.\" lpadmin man page for CUPS.
.\"
-.\" Copyright 2007-2016 by Apple Inc.
+.\" Copyright 2007-2017 by Apple Inc.
.\" Copyright 1997-2006 by Easy Software Products.
.\"
.\" These coded instructions, statements, and computer programs are the
@@ -10,7 +10,7 @@
.\" which should have been included with this file. If this file is
.\" file is missing or damaged, see the license at "http://www.cups.org/".
.\"
-.TH lpadmin 8 "CUPS" "29 March 2016" "Apple Inc."
+.TH lpadmin 8 "CUPS" "1 November 2017" "Apple Inc."
.SH NAME
lpadmin \- configure cups printers and classes
.SH SYNOPSIS
@@ -80,8 +80,6 @@ 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\-i \fIppd-file\fR
-.TP 5
\fB\-P \fIppd-file\fR
Specifies a PostScript Printer Description (PPD) file to use with the printer.
.TP 5
@@ -189,6 +187,12 @@ programs on the destination.
.TP 5
\fB\-L "\fIlocation\fB"\fR
Provides a textual location of the destination.
+.SH DEPRECATED OPTIONS
+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.
.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.
@@ -196,6 +200,7 @@ Finally, the CUPS version of \fBlpadmin\fR may ask the user for an access passwo
This differs from the System V version which requires the root user to execute this command.
.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.
.SH EXAMPLE
Create an IPP Everywhere print queue:
.nf