.\"
-.\" "$Id: cupstestppd.man 4493 2005-02-18 02:09:53Z mike $"
+.\" cupstestppd man page for CUPS.
.\"
-.\" cupstestppd man page for the Common UNIX Printing System (CUPS).
+.\" Copyright 2007-2014 by Apple Inc.
+.\" Copyright 1997-2006 by Easy Software Products.
.\"
-.\" Copyright 1997-2005 by Easy Software Products.
+.\" Licensed under Apache License v2.0. See the file "LICENSE" for more information.
.\"
-.\" These coded instructions, statements, and computer programs are the
-.\" property of Easy Software Products and are protected by Federal
-.\" copyright law. Distribution and use rights are outlined in the file
-.\" "LICENSE.txt" which should have been included with this file. If this
-.\" file is missing or damaged please contact Easy Software Products
-.\" at:
-.\"
-.\" Attn: CUPS Licensing Information
-.\" Easy Software Products
-.\" 44141 Airport View Drive, Suite 204
-.\" Hollywood, Maryland 20636 USA
-.\"
-.\" Voice: (301) 373-9600
-.\" EMail: cups-info@cups.org
-.\" WWW: http://www.cups.org
-.\"
-.TH cupstestppd 1 "Common UNIX Printing System" "1 August 2003" "Easy Software Products"
+.TH cupstestppd 1 "CUPS" "11 June 2014" "Apple Inc."
.SH NAME
cupstestppd \- test conformance of ppd files
.SH SYNOPSIS
.B cupstestppd
-[ -q ] [-r] [ -v[v] ] filename.ppd[.gz] [ ... filenameN.ppd[.gz] ]
+[
+.B \-I
+.I category
+] [
+.B \-R
+.I rootdir
+] [
+.B \-W
+.I category
+] [
+.B \-q
+] [
+.B \-r
+] [
+\fB\-v\fR[\fBv\fR]
+]
+.I filename.ppd[.gz]
+[ ...
+.I filename.ppd[.gz]
+]
.br
.B cupstestppd
-[ -q ] [-r] [ -v[v] ] -
+[
+.B \-R
+.I rootdir
+] [
+.B \-W
+.I category
+] [
+.B \-q
+] [
+.B \-r
+] [
+\fB\-v\fR[\fBv\fR]
+]
+.B \-
.SH DESCRIPTION
-\fIcupstestppd\fR tests the conformance of PPD files to the
-Adobe PostScript Printer Description file format specification
-version 4.3. It can also be used to list the supported options
-and available fonts in a PPD file. The results of testing and
-any other output are sent to the standard output.
-.LP
-The first form of \fIcupstestppd\fR tests one or more PPD files
-on the command-line. The second form tests the PPD file provided
-on the standard input.
+\fBcupstestppd\fR tests the conformance of PPD files to the Adobe PostScript Printer Description file format specification version 4.3.
+It can also be used to list the supported options and available fonts in a PPD file.
+The results of testing and any other output are sent to the standard output.
.LP
-The \fI-q\fR option specifies that no information should be displayed.
-.LP
-The \fI-r\fR option relaxes the PPD conformance requirements so
-that common whitespace, control character, and formatting
-problems are not treated as hard errors.
-.LP
-The \fI-v\fR option specifies that detailed conformance testing
-results should be displayed rather than the concise PASS/FAIL/ERROR
-status.
-.LP
-The \fI-vv\fR option specifies that all information in the PPD
-file should be displayed in addition to the detailed conformance
-testing results.
+The first form of \fBcupstestppd\fR tests one or more PPD files on the command-line.
+The second form tests the PPD file provided on the standard input.
+.SH OPTIONS
+\fBcupstestppd\fR supports the following options:
+.TP 5
+\fB\-I filename\fR
+Ignores all PCFileName warnings.
+.TP 5
+\fB\-I filters\fR
+Ignores all filter errors.
+.TP 5
+\fB\-I profiles\fR
+Ignores all profile errors.
+.TP 5
+\fB\-R \fIrootdir\fR
+Specifies an alternate root directory for the filter, pre-filter, and other support file checks.
+.TP 5
+\fB\-W constraints\fR
+Report all UIConstraint errors as warnings.
+.TP 5
+\fB\-W defaults\fR
+Except for size-related options, report all default option errors as warnings.
+.TP 5
+\fB\-W filters\fR
+Report all filter errors as warnings.
+.TP 5
+\fB\-W profiles\fR
+Report all profile errors as warnings.
+.TP 5
+\fB\-W sizes\fR
+Report all media size errors as warnings.
+.TP 5
+\fB\-W translations\fR
+Report all translation errors as warnings.
+.TP 5
+\fB\-W all\fR
+Report all of the previous errors as warnings.
+.TP 5
+\fB\-W none\fR
+Report all of the previous errors as errors.
+.TP 5
+.B \-q
+Specifies that no information should be displayed.
+.TP 5
+.B \-r
+Relaxes the PPD conformance requirements so that common whitespace, control character, and formatting problems are not treated as hard errors.
+.TP 5
+.B \-v
+Specifies that detailed conformance testing results should be displayed rather than the concise PASS/FAIL/ERROR status.
+.TP 5
+.B \-vv
+Specifies that all information in the PPD file should be displayed in addition to the detailed conformance testing results.
.LP
The \fI-q\fR, \fI-v\fR, and \fI-vv\fR options are mutually exclusive.
.SH EXIT STATUS
-\fIcupstestppd\fR returns zero on success and non-zero on error. The
-error codes are as follows:
+\fBcupstestppd\fR returns zero on success and non-zero on error.
+The error codes are as follows:
.TP 5
1
-.br
Bad command-line arguments or missing PPD filename.
.TP 5
2
-.br
Unable to open or read PPD file.
.TP 5
3
-.br
The PPD file contains format errors that cannot be skipped.
.TP 5
4
-.br
The PPD file does not conform to the Adobe PPD specification.
.SH EXAMPLES
-The following command will test all PPD files under the current
-directory and print the names of each file that does not
-conform:
+The following command will test all PPD files under the current directory and print the names of each file that does not conform:
.nf
- find . -name \\*.ppd \\! -exec cupstestppd -q '{}' \\; -print
+ find . \-name \\*.ppd \\! \-exec cupstestppd \-q '{}' \\; \-print
.fi
-The next command tests all PPD files under the current directory
-and print detailed conformance testing results for the files
-that do not conform:
+The next command tests all PPD files under the current directory and print detailed conformance testing results for the files that do not conform:
.nf
- find . -name \\*.ppd \\! -exec cupstestppd -q '{}' \\; \\
- -exec cupstestppd -v '{}' \\;
-
+ find . \-name \\*.ppd \\! \-exec cupstestppd \-q '{}' \\; \\
+ \-exec cupstestppd \-v '{}' \\;
.fi
.SH SEE ALSO
-CUPS Software Administrators Manual,
-CUPS Software Programmers Manual,
-http://localhost:631/documentation.html,
+.BR lpadmin (8),
+CUPS Online Help (http://localhost:631/help),
Adobe PostScript Printer Description File Format Specification, Version 4.3.
.SH COPYRIGHT
-Copyright 1993-2005 by Easy Software Products, All Rights Reserved.
-.\"
-.\" End of "$Id: cupstestppd.man 4493 2005-02-18 02:09:53Z mike $".
-.\"
+Copyright \[co] 2007-2018 by Apple Inc.
projects / thirdparty / cups.git / blobdiff