diff options
Diffstat (limited to 'man/cupstestppd.man')
-rw-r--r-- | man/cupstestppd.man | 162 |
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$". .\" |