File: preface.html

package info (click to toggle)
cupsddk 1.2.3-5
  • links: PTS, VCS
  • area: main
  • in suites: lenny
  • size: 4,488 kB
  • ctags: 1,125
  • sloc: ansic: 7,074; cpp: 5,423; makefile: 526; xml: 227; sh: 153
file content (220 lines) | stat: -rw-r--r-- 5,355 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
<html>
<head>
	<meta name='copyright' content='Copyright 2007'>
	<meta name='docnumber' content='CUPS-DDK-1.2.3'>
	<meta name='author' content='Apple Inc.'>
	<title>CUPS Driver Development Kit Manual</title>
</head>
<body>

<div align='justify'>

<h1 align='right'><a name='PREFACE'>Preface</a></H1>

<p>This software users manual provides a step-by-step guide for
using the CUPS<SUp>TM</SUp> Driver Development Kit ('DDK'), version 1.2.3.</p>

<h2>Software Overview</h2>

<p>The CUPS Driver Development Kit ('DDK') provides a suite of
standard drivers, a PPD file compiler, and other utilities that
can be used to develop printer drivers for CUPS and other
printing environments.  CUPS provides a portable printing layer
for UNIX&reg;-based operating systems.  The CUPS DDK provides
the means for mass-producing PPD files and drivers/filters for
CUPS-based printer drivers.</p>

<p>The CUPS DDK is licensed under the GNU General Public
License version 2. Free support is available by posting messages to the
<tt>cups.ddk</tt> newsgroup at:</p>

<pre>
    <a href='http://www.cups.org/newsgroups.php'>http://www.cups.org/newsgroups.php</a>
</pre>

<p>The <tt>cups.ddk</tt> newsgroup is monitored by volunteers,
so your message may go unanswered for days or weeks. <em>Please be patient.</em>

<!-- NEED 3in -->
<h2>Document Overview</h2>

<p>This software users manual is organized into the following sections:</p>

<ul>

	<li><a href='#INSTALL'>1 - Building and Installing the
	CUPS DDK</a></li>

	<li><a href='#BASICS'>2 - Getting Started with the CUPS
	DDK</a></li>

	<li><a href='#RASTER_DRIVERS'>3 - Developing Raster
	Printer Drivers</a></li>

	<li><a href='#PS_DRIVERS'>4 - Developing PostScript
	Printer Drivers</a></li>

	<li><a href='#LOCALIZATION'>5 - Localizing Printer
	Drivers</a></li>

	<li><a href='#COLOR'>6 - Doing Raster Color
	Management</a></li>

	<li><a href='#DISTRIBUTING'>7 - Distributing Printer Drivers</a></li>

<!--	<li><a href='#CUSTOM_DRIVERS'>7 - Developing Custom
	Printer Drivers</a></li>-->

	<li><a href='#LICENSE'>A - Software License
	Agreement</a></li>

	<li><a href='#REFERENCE'>B - PPD Compiler Driver
	Information File Reference</a></li>

	<li><a href='#API'>C - CUPS Driver API
	Reference</a></li>

	<li><a href='#MANPAGES'>D - Man Pages</a></li>

	<li><a href='#RELNOTES'>E - Release Notes</a></li>

</ul>

<h2>Notation Conventions</h2>

<p>Various font and syntax conventions are used in this guide.
Examples and their meanings and uses are explained below:</p>

<center><table width='90%'>
<tr>
	<th>Example</th>
	<td>&nbsp;&nbsp;&nbsp;</td>
	<th>Description</th>
</tr>
<tr><td>&nbsp;</td></tr>
<tr valign='top'>
	<td><CODE>lpstat</CODE><br>
	<CODE>lpstat(1)</CODE></td>

	<td>&nbsp;&nbsp;&nbsp;</td>

	<td>The names of commands; the first mention of a command or
	function in a chapter is followed by a manual page section
	number.</td>
</tr>
<tr><td>&nbsp;</td></tr>
<tr valign='top'>
	<td><VAR>/var</VAR><br>
	<VAR>/usr/share/cups/data/testprint.ps</VAR></td>

	<td>&nbsp;&nbsp;&nbsp;</td>

	<td>File and directory names.</td>
</tr>
<tr><td>&nbsp;</td></tr>
<tr valign='top'>
	<td nowrap><tt>Request ID is Printer-123</tt></td>

	<td>&nbsp;&nbsp;&nbsp;</td>

	<td>Screen output.</td>
</tr>
<tr><td>&nbsp;</td></tr>
<tr valign='top'>
	<td nowrap><kbd>lp -d printer filename ENTER</kbd></td>

	<td>&nbsp;&nbsp;&nbsp;</td>

	<td>Literal user input; special keys like <kbd>ENTER</kbd> are
	in ALL CAPS.</td>
</tr>
<tr><td>&nbsp;</td></tr>
<tr valign='top'>
	<td>12.3</td>

	<td>&nbsp;&nbsp;&nbsp;</td>

	<td>Numbers in the text are written using the period (.) to indicate
	the decimal point.</td>
</tr>
</table></center>

<!-- NEED 3in -->
<h2>Abbreviations</h2>

<p>The following abbreviations are used throughout this manual:</p>

<dl>

	<dt>CMYK</dt>
	<dd>Cyan Magenta Yellow Black<br>&nbsp;</dd>

	<dt>DDK</dt>
	<dd>Driver Development Kit<br>&nbsp;</dd>

	<dt>ESC/P</dt>
	<dd>Epson Standard Code for Printers<br>&nbsp;</dd>

	<dt>Gb</dt>
	<dd>Gigabytes, or 1073741824 bytes<br>&nbsp;</dd>

	<dt>HP-PCL</dt>
	<dd>Hewlett Packard Page Control Language<br>&nbsp;</dd>

	<dt>K</dt>
	<dd>Black<br>&nbsp;</dd>

	<dt>kb</dt>
	<dd>Kilobytes, or 1024 bytes<br>&nbsp;</dd>

	<dt>Mb</dt>
	<dd>Megabytes, or 1048576 bytes<br>&nbsp;</dd>

	<dt>PJL</dt>
	<dd>Printer Job Language<br>&nbsp;</dd>

	<dt>PPD</dt>
	<dd>PostScript Printer Description<br>&nbsp;</dd>

	<dt>RGB</dt>
	<dd>Red Green Blue<br>&nbsp;</dd>
</dl>

<!-- NEW PAGE -->
<h2>Other References</h2>

<dl>

	<dt>Adobe PostScript Language Reference Manual, Third
	Edition</dt>

	<dd>The official reference manual for the PostScript
	language.<br>&nbsp;</dd>

	<dt>Adobe Technote #5003: PostScript Printer Description
	File Format Specification</dt>

	<dd>The official reference manual for the PPD file
	format.<br>&nbsp;</dd>

	<dt>CUPS PPD Extensions</dt>

	<dd>The official reference manual for CUPS extensions to the PPD format.<br>&nbsp;</dd>

</dl>

<h2>Providing Feedback</h2>

<p>Feedback and bug reports for this manual and the DDK as a
whole are welcome. Please use the <tt>cups.ddk</tt> newsgroup to
discuss potential problems and report all confirmed problems and
documentation errors using the form at the following URL:</p>

<pre>
    <a href='http://www.cups.org/ddk/str.php'>http://www.cups.org/ddk/str.php</a>
</pre>

</div>

</body>
</html>