1 /*
2  * PostScript Printer Description definitions for CUPS.
3  *
4  * THESE APIS ARE DEPRECATED.  THIS HEADER AND THESE FUNCTIONS WILL BE REMOVED
5  * IN A FUTURE RELEASE OF CUPS.
6  *
7  * Copyright © 2007-2019 by Apple Inc.
8  * Copyright © 1997-2007 by Easy Software Products, all rights reserved.
9  *
10  * Licensed under Apache License v2.0.  See the file "LICENSE" for more
11  * information.
12  *
13  * PostScript is a trademark of Adobe Systems, Inc.
14  */
15 
16 #ifndef _CUPS_PPD_H_
17 #  define _CUPS_PPD_H_
18 
19 /*
20  * Include necessary headers...
21  */
22 
23 #  include <stdio.h>
24 #  include "cups.h"
25 #  include "array.h"
26 #  include "file.h"
27 #  include "raster.h"
28 
29 
30 /*
31  * C++ magic...
32  */
33 
34 #  ifdef __cplusplus
35 extern "C" {
36 #  endif /* __cplusplus */
37 
38 
39 /*
40  * PPD version...
41  */
42 
43 #  define PPD_VERSION	4.3		/* Kept in sync with Adobe version number */
44 
45 
46 /*
47  * PPD size limits (defined in Adobe spec)
48  */
49 
50 #  define PPD_MAX_NAME	41		/* Maximum size of name + 1 for nul */
51 #  define PPD_MAX_TEXT	81		/* Maximum size of text + 1 for nul */
52 #  define PPD_MAX_LINE	256		/* Maximum size of line + 1 for nul */
53 
54 
55 /*
56  * Types and structures...
57  */
58 
59 typedef int (*cups_interpret_cb_t)(cups_page_header2_t *header, int preferred_bits);
60 					/**** cupsRasterInterpretPPD callback function
61 					 *
62 					 * This function is called by
63 					 * @link cupsRasterInterpretPPD@ to
64 					 * validate (and update, as needed)
65 					 * the page header attributes. The
66 					 * "preferred_bits" argument provides
67 					 * the value of the
68 					 * @code cupsPreferredBitsPerColor@
69 					 * key from the PostScript page device
70 					 * dictionary and is 0 if undefined.
71 					 ****/
72 
73 typedef enum ppd_ui_e			/**** UI Types @deprecated@ ****/
74 {
75   PPD_UI_BOOLEAN,			/* True or False option */
76   PPD_UI_PICKONE,			/* Pick one from a list */
77   PPD_UI_PICKMANY			/* Pick zero or more from a list */
78 } ppd_ui_t;
79 
80 typedef enum ppd_section_e		/**** Order dependency sections @deprecated@ ****/
81 {
82   PPD_ORDER_ANY,			/* Option code can be anywhere in the file */
83   PPD_ORDER_DOCUMENT,			/* ... must be in the DocumentSetup section */
84   PPD_ORDER_EXIT,			/* ... must be sent prior to the document */
85   PPD_ORDER_JCL,			/* ... must be sent as a JCL command */
86   PPD_ORDER_PAGE,			/* ... must be in the PageSetup section */
87   PPD_ORDER_PROLOG			/* ... must be in the Prolog section */
88 } ppd_section_t;
89 
90 typedef enum ppd_cs_e			/**** Colorspaces @deprecated@ ****/
91 {
92   PPD_CS_CMYK = -4,			/* CMYK colorspace */
93   PPD_CS_CMY,				/* CMY colorspace */
94   PPD_CS_GRAY = 1,			/* Grayscale colorspace */
95   PPD_CS_RGB = 3,			/* RGB colorspace */
96   PPD_CS_RGBK,				/* RGBK (K = gray) colorspace */
97   PPD_CS_N				/* DeviceN colorspace */
98 } ppd_cs_t;
99 
100 typedef enum ppd_status_e		/**** Status Codes @deprecated@ ****/
101 {
102   PPD_OK = 0,				/* OK */
103   PPD_FILE_OPEN_ERROR,			/* Unable to open PPD file */
104   PPD_NULL_FILE,			/* NULL PPD file pointer */
105   PPD_ALLOC_ERROR,			/* Memory allocation error */
106   PPD_MISSING_PPDADOBE4,		/* Missing PPD-Adobe-4.x header */
107   PPD_MISSING_VALUE,			/* Missing value string */
108   PPD_INTERNAL_ERROR,			/* Internal error */
109   PPD_BAD_OPEN_GROUP,			/* Bad OpenGroup */
110   PPD_NESTED_OPEN_GROUP,		/* OpenGroup without a CloseGroup first */
111   PPD_BAD_OPEN_UI,			/* Bad OpenUI/JCLOpenUI */
112   PPD_NESTED_OPEN_UI,			/* OpenUI/JCLOpenUI without a CloseUI/JCLCloseUI first */
113   PPD_BAD_ORDER_DEPENDENCY,		/* Bad OrderDependency */
114   PPD_BAD_UI_CONSTRAINTS,		/* Bad UIConstraints */
115   PPD_MISSING_ASTERISK,			/* Missing asterisk in column 0 */
116   PPD_LINE_TOO_LONG,			/* Line longer than 255 chars */
117   PPD_ILLEGAL_CHARACTER,		/* Illegal control character */
118   PPD_ILLEGAL_MAIN_KEYWORD,		/* Illegal main keyword string */
119   PPD_ILLEGAL_OPTION_KEYWORD,		/* Illegal option keyword string */
120   PPD_ILLEGAL_TRANSLATION,		/* Illegal translation string */
121   PPD_ILLEGAL_WHITESPACE,		/* Illegal whitespace character */
122   PPD_BAD_CUSTOM_PARAM,			/* Bad custom parameter */
123   PPD_MISSING_OPTION_KEYWORD,		/* Missing option keyword */
124   PPD_BAD_VALUE,			/* Bad value string */
125   PPD_MISSING_CLOSE_GROUP,		/* Missing CloseGroup */
126   PPD_BAD_CLOSE_UI,			/* Bad CloseUI/JCLCloseUI */
127   PPD_MISSING_CLOSE_UI,			/* Missing CloseUI/JCLCloseUI */
128   PPD_MAX_STATUS			/* @private@ */
129 } ppd_status_t;
130 
131 enum ppd_conform_e			/**** Conformance Levels @deprecated@ ****/
132 {
133   PPD_CONFORM_RELAXED,			/* Relax whitespace and control char */
134   PPD_CONFORM_STRICT			/* Require strict conformance */
135 };
136 
137 typedef enum ppd_conform_e ppd_conform_t;
138 					/**** Conformance Levels @deprecated@ ****/
139 
140 typedef struct ppd_attr_s		/**** PPD Attribute Structure @deprecated@ ****/
141 {
142   char		name[PPD_MAX_NAME];	/* Name of attribute (cupsXYZ) */
143   char		spec[PPD_MAX_NAME];	/* Specifier string, if any */
144   char		text[PPD_MAX_TEXT];	/* Human-readable text, if any */
145   char		*value;			/* Value string */
146 } ppd_attr_t;
147 
148 typedef struct ppd_option_s ppd_option_t;
149 					/**** Options @deprecated@ ****/
150 
151 typedef struct ppd_choice_s		/**** Option choices @deprecated@ ****/
152 {
153   char		marked;			/* 0 if not selected, 1 otherwise */
154   char		choice[PPD_MAX_NAME];	/* Computer-readable option name */
155   char		text[PPD_MAX_TEXT];	/* Human-readable option name */
156   char		*code;			/* Code to send for this option */
157   ppd_option_t	*option;		/* Pointer to parent option structure */
158 } ppd_choice_t;
159 
160 struct ppd_option_s			/**** Options @deprecated@ ****/
161 {
162   char		conflicted;		/* 0 if no conflicts exist, 1 otherwise */
163   char		keyword[PPD_MAX_NAME];	/* Option keyword name ("PageSize", etc.) */
164   char		defchoice[PPD_MAX_NAME];/* Default option choice */
165   char		text[PPD_MAX_TEXT];	/* Human-readable text */
166   ppd_ui_t	ui;			/* Type of UI option */
167   ppd_section_t	section;		/* Section for command */
168   float		order;			/* Order number */
169   int		num_choices;		/* Number of option choices */
170   ppd_choice_t	*choices;		/* Option choices */
171 };
172 
173 typedef struct ppd_group_s		/**** Groups @deprecated@ ****/
174 {
175   /**** Group text strings are limited to 39 chars + nul in order to
176    **** preserve binary compatibility and allow applications to get
177    **** the group's keyword name.
178    ****/
179   char		text[PPD_MAX_TEXT - PPD_MAX_NAME];
180   					/* Human-readable group name */
181   char		name[PPD_MAX_NAME];	/* Group name @since CUPS 1.1.18/macOS 10.3@ */
182   int		num_options;		/* Number of options */
183   ppd_option_t	*options;		/* Options */
184   int		num_subgroups;		/* Number of sub-groups */
185   struct ppd_group_s *subgroups;	/* Sub-groups (max depth = 1) */
186 } ppd_group_t;
187 
188 typedef struct ppd_const_s		/**** Constraints @deprecated@ ****/
189 {
190   char		option1[PPD_MAX_NAME];	/* First keyword */
191   char		choice1[PPD_MAX_NAME];	/* First option/choice (blank for all) */
192   char		option2[PPD_MAX_NAME];	/* Second keyword */
193   char		choice2[PPD_MAX_NAME];	/* Second option/choice (blank for all) */
194 } ppd_const_t;
195 
196 typedef struct ppd_size_s		/**** Page Sizes @deprecated@ ****/
197 {
198   int		marked;			/* Page size selected? */
199   char		name[PPD_MAX_NAME];	/* Media size option */
200   float		width;			/* Width of media in points */
201   float		length;			/* Length of media in points */
202   float		left;			/* Left printable margin in points */
203   float		bottom;			/* Bottom printable margin in points */
204   float		right;			/* Right printable margin in points */
205   float		top;			/* Top printable margin in points */
206 } ppd_size_t;
207 
208 typedef struct ppd_emul_s		/**** Emulators @deprecated@ ****/
209 {
210   char		name[PPD_MAX_NAME];	/* Emulator name */
211   char		*start;			/* Code to switch to this emulation */
212   char		*stop;			/* Code to stop this emulation */
213 } ppd_emul_t;
214 
215 typedef struct ppd_profile_s		/**** sRGB Color Profiles @deprecated@ ****/
216 {
217   char		resolution[PPD_MAX_NAME];
218   					/* Resolution or "-" */
219   char		media_type[PPD_MAX_NAME];
220 					/* Media type or "-" */
221   float		density;		/* Ink density to use */
222   float		gamma;			/* Gamma correction to use */
223   float		matrix[3][3];		/* Transform matrix */
224 } ppd_profile_t;
225 
226 /**** New in CUPS 1.2/macOS 10.5 ****/
227 typedef enum ppd_cptype_e		/**** Custom Parameter Type @deprecated@ ****/
228 {
229   PPD_CUSTOM_UNKNOWN = -1,		/* Unknown type (error) */
230   PPD_CUSTOM_CURVE,			/* Curve value for f(x) = x^value */
231   PPD_CUSTOM_INT,			/* Integer number value */
232   PPD_CUSTOM_INVCURVE,			/* Curve value for f(x) = x^(1/value) */
233   PPD_CUSTOM_PASSCODE,			/* String of (hidden) numbers */
234   PPD_CUSTOM_PASSWORD,			/* String of (hidden) characters */
235   PPD_CUSTOM_POINTS,			/* Measurement value in points */
236   PPD_CUSTOM_REAL,			/* Real number value */
237   PPD_CUSTOM_STRING			/* String of characters */
238 } ppd_cptype_t;
239 
240 typedef union ppd_cplimit_u		/**** Custom Parameter Limit @deprecated@ ****/
241 {
242   float		custom_curve;		/* Gamma value */
243   int		custom_int;		/* Integer value */
244   float		custom_invcurve;	/* Gamma value */
245   int		custom_passcode;	/* Passcode length */
246   int		custom_password;	/* Password length */
247   float		custom_points;		/* Measurement value */
248   float		custom_real;		/* Real value */
249   int		custom_string;		/* String length */
250 } ppd_cplimit_t;
251 
252 typedef union ppd_cpvalue_u		/**** Custom Parameter Value @deprecated@ ****/
253 {
254   float		custom_curve;		/* Gamma value */
255   int		custom_int;		/* Integer value */
256   float		custom_invcurve;	/* Gamma value */
257   char		*custom_passcode;	/* Passcode value */
258   char		*custom_password;	/* Password value */
259   float		custom_points;		/* Measurement value */
260   float		custom_real;		/* Real value */
261   char		*custom_string;		/* String value */
262 } ppd_cpvalue_t;
263 
264 typedef struct ppd_cparam_s		/**** Custom Parameter @deprecated@ ****/
265 {
266   char		name[PPD_MAX_NAME];	/* Parameter name */
267   char		text[PPD_MAX_TEXT];	/* Human-readable text */
268   int		order;			/* Order (0 to N) */
269   ppd_cptype_t	type;			/* Parameter type */
270   ppd_cplimit_t	minimum,		/* Minimum value */
271 		maximum;		/* Maximum value */
272   ppd_cpvalue_t	current;		/* Current value */
273 } ppd_cparam_t;
274 
275 typedef struct ppd_coption_s		/**** Custom Option @deprecated@ ****/
276 {
277   char		keyword[PPD_MAX_NAME];	/* Name of option that is being extended... */
278   ppd_option_t	*option;		/* Option that is being extended... */
279   int		marked;			/* Extended option is marked */
280   cups_array_t	*params;		/* Parameters */
281 } ppd_coption_t;
282 
283 typedef struct _ppd_cache_s _ppd_cache_t;
284 					/**** PPD cache and mapping data @deprecated@ ****/
285 
286 typedef struct ppd_file_s		/**** PPD File @deprecated@ ****/
287 {
288   int		language_level;		/* Language level of device */
289   int		color_device;		/* 1 = color device, 0 = grayscale */
290   int		variable_sizes;		/* 1 = supports variable sizes, 0 = doesn't */
291   int		accurate_screens;	/* 1 = supports accurate screens, 0 = not */
292   int		contone_only;		/* 1 = continuous tone only, 0 = not */
293   int		landscape;		/* -90 or 90 */
294   int		model_number;		/* Device-specific model number */
295   int		manual_copies;		/* 1 = Copies done manually, 0 = hardware */
296   int		throughput;		/* Pages per minute */
297   ppd_cs_t	colorspace;		/* Default colorspace */
298   char		*patches;		/* Patch commands to be sent to printer */
299   int		num_emulations;		/* Number of emulations supported (no longer supported) @private@ */
300   ppd_emul_t	*emulations;		/* Emulations and the code to invoke them (no longer supported) @private@ */
301   char		*jcl_begin;		/* Start JCL commands */
302   char		*jcl_ps;		/* Enter PostScript interpreter */
303   char		*jcl_end;		/* End JCL commands */
304   char		*lang_encoding;		/* Language encoding */
305   char		*lang_version;		/* Language version (English, Spanish, etc.) */
306   char		*modelname;		/* Model name (general) */
307   char		*ttrasterizer;		/* Truetype rasterizer */
308   char		*manufacturer;		/* Manufacturer name */
309   char		*product;		/* Product name (from PS RIP/interpreter) */
310   char		*nickname;		/* Nickname (specific) */
311   char		*shortnickname;		/* Short version of nickname */
312   int		num_groups;		/* Number of UI groups */
313   ppd_group_t	*groups;		/* UI groups */
314   int		num_sizes;		/* Number of page sizes */
315   ppd_size_t	*sizes;			/* Page sizes */
316   float		custom_min[2];		/* Minimum variable page size */
317   float		custom_max[2];		/* Maximum variable page size */
318   float		custom_margins[4];	/* Margins around page */
319   int		num_consts;		/* Number of UI/Non-UI constraints */
320   ppd_const_t	*consts;		/* UI/Non-UI constraints */
321   int		num_fonts;		/* Number of pre-loaded fonts */
322   char		**fonts;		/* Pre-loaded fonts */
323   int		num_profiles;		/* Number of sRGB color profiles @deprecated@ */
324   ppd_profile_t	*profiles;		/* sRGB color profiles @deprecated@ */
325   int		num_filters;		/* Number of filters */
326   char		**filters;		/* Filter strings... */
327 
328   /**** New in CUPS 1.1 ****/
329   int		flip_duplex;		/* 1 = Flip page for back sides @deprecated@ */
330 
331   /**** New in CUPS 1.1.19 ****/
332   char		*protocols;		/* Protocols (BCP, TBCP) string @since CUPS 1.1.19/macOS 10.3@ */
333   char		*pcfilename;		/* PCFileName string @since CUPS 1.1.19/macOS 10.3@ */
334   int		num_attrs;		/* Number of attributes @since CUPS 1.1.19/macOS 10.3@ @private@ */
335   int		cur_attr;		/* Current attribute @since CUPS 1.1.19/macOS 10.3@ @private@ */
336   ppd_attr_t	**attrs;		/* Attributes @since CUPS 1.1.19/macOS 10.3@ @private@ */
337 
338   /**** New in CUPS 1.2/macOS 10.5 ****/
339   cups_array_t	*sorted_attrs;		/* Attribute lookup array @since CUPS 1.2/macOS 10.5@ @private@ */
340   cups_array_t	*options;		/* Option lookup array @since CUPS 1.2/macOS 10.5@ @private@ */
341   cups_array_t	*coptions;		/* Custom options array @since CUPS 1.2/macOS 10.5@ @private@ */
342 
343   /**** New in CUPS 1.3/macOS 10.5 ****/
344   cups_array_t	*marked;		/* Marked choices @since CUPS 1.3/macOS 10.5@ @private@ */
345 
346   /**** New in CUPS 1.4/macOS 10.6 ****/
347   cups_array_t	*cups_uiconstraints;	/* cupsUIConstraints @since CUPS 1.4/macOS 10.6@ @private@ */
348 
349   /**** New in CUPS 1.5 ****/
350   _ppd_cache_t	*cache;			/* PPD cache and mapping data @since CUPS 1.5/macOS 10.7@ @private@ */
351 } ppd_file_t;
352 
353 
354 /*
355  * Prototypes...
356  */
357 
358 extern const char	*cupsGetPPD(const char *name) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
359 extern const char	*cupsGetPPD2(http_t *http, const char *name) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
360 extern http_status_t	cupsGetPPD3(http_t *http, const char *name, time_t *modtime, char *buffer, size_t bufsize) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
361 extern char		*cupsGetServerPPD(http_t *http, const char *name) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
362 extern int		cupsMarkOptions(ppd_file_t *ppd, int num_options, cups_option_t *options) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
363 
364 extern void		ppdClose(ppd_file_t *ppd) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
365 extern int		ppdCollect(ppd_file_t *ppd, ppd_section_t section,
366 			           ppd_choice_t  ***choices) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
367 extern int		ppdConflicts(ppd_file_t *ppd) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
368 extern int		ppdEmit(ppd_file_t *ppd, FILE *fp,
369 			        ppd_section_t section) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
370 extern int		ppdEmitFd(ppd_file_t *ppd, int fd,
371 			          ppd_section_t section) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
372 extern int		ppdEmitJCL(ppd_file_t *ppd, FILE *fp, int job_id,
373 			           const char *user, const char *title)
374 			           _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
375 extern ppd_choice_t	*ppdFindChoice(ppd_option_t *o, const char *option)
376 			               _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
377 extern ppd_choice_t	*ppdFindMarkedChoice(ppd_file_t *ppd,
378 			                     const char *keyword)
379 			                     _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
380 extern ppd_option_t	*ppdFindOption(ppd_file_t *ppd, const char *keyword)
381 			               _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
382 extern int		ppdIsMarked(ppd_file_t *ppd, const char *keyword,
383 			            const char *option) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
384 extern void		ppdMarkDefaults(ppd_file_t *ppd) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
385 extern int		ppdMarkOption(ppd_file_t *ppd, const char *keyword,
386 			              const char *option) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
387 extern ppd_file_t	*ppdOpen(FILE *fp) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
388 extern ppd_file_t	*ppdOpenFd(int fd) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
389 extern ppd_file_t	*ppdOpenFile(const char *filename) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
390 extern float		ppdPageLength(ppd_file_t *ppd, const char *name)
391 			              _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
392 extern ppd_size_t	*ppdPageSize(ppd_file_t *ppd, const char *name)
393 			             _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
394 extern float		ppdPageWidth(ppd_file_t *ppd, const char *name)
395 			             _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
396 
397 /**** New in CUPS 1.1.19 ****/
398 extern const char	*ppdErrorString(ppd_status_t status) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
399 extern ppd_attr_t	*ppdFindAttr(ppd_file_t *ppd, const char *name,
400 			             const char *spec) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
401 extern ppd_attr_t	*ppdFindNextAttr(ppd_file_t *ppd, const char *name,
402 			                 const char *spec) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
403 extern ppd_status_t	ppdLastError(int *line) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
404 
405 /**** New in CUPS 1.1.20 ****/
406 extern void		ppdSetConformance(ppd_conform_t c) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
407 
408 /**** New in CUPS 1.2 ****/
409 extern int		cupsRasterInterpretPPD(cups_page_header2_t *h,
410 			                       ppd_file_t *ppd,
411 					       int num_options,
412 					       cups_option_t *options,
413 					       cups_interpret_cb_t func) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
414 extern int		ppdCollect2(ppd_file_t *ppd, ppd_section_t section,
415 			            float min_order, ppd_choice_t  ***choices)
416 			            _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
417 extern int		ppdEmitAfterOrder(ppd_file_t *ppd, FILE *fp,
418 			                  ppd_section_t section, int limit,
419 					  float min_order) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
420 extern int		ppdEmitJCLEnd(ppd_file_t *ppd, FILE *fp)
421 			              _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
422 extern char		*ppdEmitString(ppd_file_t *ppd, ppd_section_t section,
423 			               float min_order) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
424 extern ppd_coption_t	*ppdFindCustomOption(ppd_file_t *ppd,
425 			                     const char *keyword)
426 			                     _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
427 extern ppd_cparam_t	*ppdFindCustomParam(ppd_coption_t *opt,
428 			                    const char *name) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
429 extern ppd_cparam_t	*ppdFirstCustomParam(ppd_coption_t *opt)
430 			                     _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
431 extern ppd_option_t	*ppdFirstOption(ppd_file_t *ppd) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
432 extern ppd_cparam_t	*ppdNextCustomParam(ppd_coption_t *opt) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
433 extern ppd_option_t	*ppdNextOption(ppd_file_t *ppd) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
434 extern int		ppdLocalize(ppd_file_t *ppd) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
435 extern ppd_file_t	*ppdOpen2(cups_file_t *fp) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
436 
437 /**** New in CUPS 1.3/macOS 10.5 ****/
438 extern const char	*ppdLocalizeIPPReason(ppd_file_t *ppd,
439 			                      const char *reason,
440 					      const char *scheme,
441 					      char *buffer,
442 					      size_t bufsize) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
443 
444 /**** New in CUPS 1.4/macOS 10.6 ****/
445 extern int		cupsGetConflicts(ppd_file_t *ppd, const char *option,
446 					 const char *choice,
447 					 cups_option_t **options)
448 					 _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
449 extern int		cupsResolveConflicts(ppd_file_t *ppd,
450 			                     const char *option,
451 			                     const char *choice,
452 					     int *num_options,
453 					     cups_option_t **options)
454 					     _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
455 extern int		ppdInstallableConflict(ppd_file_t *ppd,
456 			                       const char *option,
457 					       const char *choice)
458 					       _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
459 extern ppd_attr_t	*ppdLocalizeAttr(ppd_file_t *ppd, const char *keyword,
460 			                 const char *spec) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
461 extern const char	*ppdLocalizeMarkerName(ppd_file_t *ppd,
462 			                       const char *name)
463 			                       _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
464 extern int		ppdPageSizeLimits(ppd_file_t *ppd,
465 			                  ppd_size_t *minimum,
466 					  ppd_size_t *maximum) _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.");
467 
468 
469 /*
470  * C++ magic...
471  */
472 
473 #  ifdef __cplusplus
474 }
475 #  endif /* __cplusplus */
476 #endif /* !_CUPS_PPD_H_ */
477