[thirdparty/cups.git] / man / ppdc.man

.\"
.\" "$Id: ppdc.man 7600 2008-05-20 21:06:23Z mike $"
.\"
.\"   ppdc man page for the Common UNIX Printing System.
.\"
.\"   Copyright 2007-2008 by Apple Inc.
.\"   Copyright 1997-2007 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/".
.\"
.TH ppdc 1 "Common UNIX Printing System" "20 May 2008" "Apple Inc."
.SH NAME
ppdc \- cups ppd compiler
.SH SYNOPSIS
.B ppdc
[ -D
.I name=value
] [ -I
.I include-directory
] [ -c
.I message-catalog
] [ -d
.I output-directory
] [ -l
.I language(s)
] [-m] [-t] [ -v ] [ -z ] [ --cr ] [ --crlf ] [ --lf ]
.I source-file
.SH DESCRIPTION
\fIppdc\fR compiles PPDC source files into one or more PPD
files.
.PP
The \fI-D\fR option sets the named variable for use in the
source file. It is equivalent to using the #define directive
in the source file.
.PP
The \fI-I\fR option specifies an alternate include directory;
multiple \fI-I\fR options can be supplied to add additional
directories.
.PP
The \fI-c\fR option specifies a single message catalog file in GNU
gettext source format (filename.po) to be used for localization.
.PP
The \fI-d\fR option specifies the output directory for PPD
files. The default output directory is "ppd".
.PP
The \fI-l\fR option specifies one or more languages to use when
localizing the PPD file(s). The default language is "en"
(English). Separate multiple languages with commas, for example
"de_DE,en_UK,es_ES,es_MX,es_US,fr_CA,fr_FR,it_IT" will create PPD
files with German, UK English, Spanish (Spain, Mexico, and US),
French (France and Canada), and Italian languages in each file.
.PP
The \fI-m\fR option specifies that the output filename should be
based on the ModelName value instead of FileName or PCFilenName.
.PP
The \fI-t\fR option specifies that PPD files should be tested instead
of generated.
.PP
The \fI-v\fR option provides more verbose output, basically a
running status of which files are being loaded or written.
.PP
The \fI-z\fR option generates compressed PPD files (filename.ppd.gz).
The default is to generate uncompressed PPD files.
.PP
The \fI--cr\fR, \fI--crlf\fR, and \fI--lf\fR options specify the
line ending to use - carriage return, carriage return and line feed,
or line feed. The default is to use the line feed character alone.
.SH SEE ALSO
ppdhtml(1), ppdi(1), ppdmerge(1), ppdpo(1), ppdcfile(5)
.br
http://localhost:631/help
.SH COPYRIGHT
Copyright 2007-2008 by Apple Inc.
.\"
.\" End of "$Id: ppdc.man 7600 2008-05-20 21:06:23Z mike $".
.\"
Commit	Line	Data
ac884b6a	1	.\"
75bd9771	2	.\" "$Id: ppdc.man 7600 2008-05-20 21:06:23Z mike $"
ac884b6a	3	.\"
bdd6c45b	4	.\" ppdc man page for the Common UNIX Printing System.
ac884b6a	5	.\"
bdd6c45b	6	.\" Copyright 2007-2008 by Apple Inc.
ac884b6a MS	7	.\" Copyright 1997-2007 by Easy Software Products.
	8	.\"
	9	.\" These coded instructions, statements, and computer programs are the
	10	.\" property of Apple Inc. and are protected by Federal copyright
	11	.\" law. Distribution and use rights are outlined in the file "LICENSE.txt"
	12	.\" which should have been included with this file. If this file is
	13	.\" file is missing or damaged, see the license at "http://www.cups.org/".
	14	.\"
bdd6c45b	15	.TH ppdc 1 "Common UNIX Printing System" "20 May 2008" "Apple Inc."
ac884b6a MS	16	.SH NAME
	17	ppdc \- cups ppd compiler
	18	.SH SYNOPSIS
	19	.B ppdc
	20	[ -D
	21	.I name=value
	22	] [ -I
	23	.I include-directory
	24	] [ -c
	25	.I message-catalog
	26	] [ -d
	27	.I output-directory
	28	] [ -l
	29	.I language(s)
bdd6c45b	30	] [-m] [-t] [ -v ] [ -z ] [ --cr ] [ --crlf ] [ --lf ]
ac884b6a MS	31	.I source-file
	32	.SH DESCRIPTION
	33	\fIppdc\fR compiles PPDC source files into one or more PPD
	34	files.
	35	.PP
	36	The \fI-D\fR option sets the named variable for use in the
	37	source file. It is equivalent to using the #define directive
	38	in the source file.
	39	.PP
	40	The \fI-I\fR option specifies an alternate include directory;
	41	multiple \fI-I\fR options can be supplied to add additional
	42	directories.
	43	.PP
	44	The \fI-c\fR option specifies a single message catalog file in GNU
	45	gettext source format (filename.po) to be used for localization.
	46	.PP
	47	The \fI-d\fR option specifies the output directory for PPD
	48	files. The default output directory is "ppd".
	49	.PP
	50	The \fI-l\fR option specifies one or more languages to use when
	51	localizing the PPD file(s). The default language is "en"
	52	(English). Separate multiple languages with commas, for example
	53	"de_DE,en_UK,es_ES,es_MX,es_US,fr_CA,fr_FR,it_IT" will create PPD
	54	files with German, UK English, Spanish (Spain, Mexico, and US),
	55	French (France and Canada), and Italian languages in each file.
	56	.PP
bdd6c45b MS	57	The \fI-m\fR option specifies that the output filename should be
	58	based on the ModelName value instead of FileName or PCFilenName.
	59	.PP
	60	The \fI-t\fR option specifies that PPD files should be tested instead
	61	of generated.
	62	.PP
ac884b6a MS	63	The \fI-v\fR option provides more verbose output, basically a
	64	running status of which files are being loaded or written.
	65	.PP
	66	The \fI-z\fR option generates compressed PPD files (filename.ppd.gz).
	67	The default is to generate uncompressed PPD files.
	68	.PP
	69	The \fI--cr\fR, \fI--crlf\fR, and \fI--lf\fR options specify the
	70	line ending to use - carriage return, carriage return and line feed,
	71	or line feed. The default is to use the line feed character alone.
	72	.SH SEE ALSO
bdd6c45b MS	73	ppdhtml(1), ppdi(1), ppdmerge(1), ppdpo(1), ppdcfile(5)
	74	.br
	75	http://localhost:631/help
ac884b6a	76	.SH COPYRIGHT
bdd6c45b	77	Copyright 2007-2008 by Apple Inc.
ac884b6a	78	.\"
75bd9771	79	.\" End of "$Id: ppdc.man 7600 2008-05-20 21:06:23Z mike $".
ac884b6a	80	.\"