summaryrefslogtreecommitdiff
path: root/man/cupstestppd.man
diff options
context:
space:
mode:
Diffstat (limited to 'man/cupstestppd.man')
-rw-r--r--man/cupstestppd.man162
1 files changed, 74 insertions, 88 deletions
diff --git a/man/cupstestppd.man b/man/cupstestppd.man
index 56ac582b9..550e21fa5 100644
--- a/man/cupstestppd.man
+++ b/man/cupstestppd.man
@@ -1,165 +1,151 @@
.\"
.\" "$Id$"
.\"
-.\" cupstestppd man page for CUPS.
+.\" cupstestppd man page for CUPS.
.\"
-.\" Copyright 2007-2013 by Apple Inc.
-.\" Copyright 1997-2006 by Easy Software Products.
+.\" Copyright 2007-2014 by Apple Inc.
+.\" Copyright 1997-2006 by Easy Software Products.
.\"
-.\" These coded instructions, statements, and computer programs are the
-.\" property of Apple Inc. 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
-.\" file is missing or damaged, see the license at "http://www.cups.org/".
+.\" These coded instructions, statements, and computer programs are the
+.\" property of Apple Inc. 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
+.\" file is missing or damaged, see the license at "http://www.cups.org/".
.\"
-.TH cupstestppd 1 "CUPS" "19 November 2009" "Apple Inc."
+.TH cupstestppd 1 "CUPS" "11 June 2014" "Apple Inc."
.SH NAME
cupstestppd \- test conformance of ppd files
.SH SYNOPSIS
.B cupstestppd
-[ -I
+[
+.B \-I
.I category
-] [ -R
+] [
+.B \-R
.I rootdir
-] [ -W
+] [
+.B \-W
.I category
-] [ -q ] [-r] [ -v[v] ] filename.ppd[.gz] [ ... filenameN.ppd[.gz] ]
+] [
+.B \-q
+] [
+.B \-r
+] [
+\fB\-v\fR[\fBv\fR]
+]
+.I filename.ppd[.gz]
+[ ...
+.I filename.ppd[.gz]
+]
.br
.B cupstestppd
-[ -R
+[
+.B \-R
.I rootdir
-] [ -W
+] [
+.B \-W
.I category
-] [ -q ] [-r] [ -v[v] ] -
+] [
+.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.
+\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 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.
+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
-\fIcupstestppd\fR supports the following options:
+\fBcupstestppd\fR supports the following options:
.TP 5
--I filename
-.br
+\fB\-I filename\fR
Ignores all PCFileName warnings.
.TP 5
--I filters
-.br
+\fB\-I filters\fR
Ignores all filter errors.
.TP 5
--I profiles
-.br
+\fB\-I profiles\fR
Ignores all profile errors.
.TP 5
--R rootdir
-.br
-Specifies an alternate root directory for the filter, pre-filter,
-and other support file checks.
+\fB\-R \fIrootdir\fR
+Specifies an alternate root directory for the filter, pre-filter, and other support file checks.
.TP 5
--W constraints
-.br
+\fB\-W constraints\fR
Report all UIConstraint errors as warnings.
.TP 5
--W defaults
-.br
+\fB\-W defaults\fR
Except for size-related options, report all default option errors as warnings.
.TP 5
--W filters
-.br
+\fB\-W filters\fR
Report all filter errors as warnings.
.TP 5
--W profiles
-.br
+\fB\-W profiles\fR
Report all profile errors as warnings.
.TP 5
--W sizes
-.br
+\fB\-W sizes\fR
Report all media size errors as warnings.
.TP 5
--W translations
-.br
+\fB\-W translations\fR
Report all translation errors as warnings.
.TP 5
--W all
-.br
+\fB\-W all\fR
Report all of the previous errors as warnings.
.TP 5
--W none
-.br
+\fB\-W none\fR
Report all of the previous errors as errors.
.TP 5
--q
-.br
+.B \-q
Specifies that no information should be displayed.
.TP 5
--r
-.br
-Relaxes the PPD conformance requirements so that common
-whitespace, control character, and formatting problems are not
-treated as hard errors.
+.B \-r
+Relaxes the PPD conformance requirements so that common whitespace, control character, and formatting problems are not treated as hard errors.
.TP 5
--v
-.br
-Specifies that detailed conformance testing results should be
-displayed rather than the concise PASS/FAIL/ERROR status.
+.B \-v
+Specifies that detailed conformance testing results should be displayed rather than the concise PASS/FAIL/ERROR status.
.TP 5
--vv
-.br
-Specifies that all information in the PPD file should be
-displayed in addition to the detailed conformance testing
-results.
+.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
-\fIlpadmin(8)\fR,
-.br
-http://localhost:631/help
-.br
+.BR lpadmin (8),
+CUPS Online Help (http://localhost:631/help),
Adobe PostScript Printer Description File Format Specification, Version 4.3.
.SH COPYRIGHT
-Copyright 2007-2013 by Apple Inc.
+Copyright \[co] 2007-2014 by Apple Inc.
.\"
.\" End of "$Id$".
.\"