X-Git-Url: http://git.ipfire.org/?p=thirdparty%2Fcups.git;a=blobdiff_plain;f=man%2Fcupstestppd.man;h=e1070f5103515656adfc070b454f98e03424427b;hp=149ddbf94ab29030bc456669f3b2bb0272a57579;hb=ea75e93d17738a9abb81514029949e661c730869;hpb=f7faf1f5c3235dfa4f883522da7dc6446f028247 diff --git a/man/cupstestppd.man b/man/cupstestppd.man index 149ddbf94..e1070f510 100644 --- a/man/cupstestppd.man +++ b/man/cupstestppd.man @@ -1,115 +1,142 @@ .\" -.\" "$Id: cupstestppd.man 5099 2006-02-13 02:46:10Z 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-2006 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" "12 February 2006" "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. +\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 --q -.br +\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 --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 1997-2006 by Easy Software Products, All Rights Reserved. -.\" -.\" End of "$Id: cupstestppd.man 5099 2006-02-13 02:46:10Z mike $". -.\" +Copyright \[co] 2007-2018 by Apple Inc.