[thirdparty/cups.git] / doc / svd.shtml

<HTML>
<HEAD>
	<META NAME="COPYRIGHT" CONTENT="Copyright 1997-2001, All Rights Reserved">
	<META NAME="DOCNUMBER" CONTENT="CUPS-SVD-1.1">
	<META NAME="Author" CONTENT="Easy Software Products">
	<TITLE>CUPS Software Version Description</TITLE>
</HEAD>
<BODY>

<H1>Scope</H1>

<H2>Identification</H2>

This software version description document provides release information for the
Common UNIX Printing System ("CUPS") Version 1.1.

<EMBED SRC="system-overview.shtml">

<H2>Document Overview</H2>

<P>This software version description document is organized into the following
sections:</P>

<UL>
	<LI><A HREF="#1">1 - Scope</A></LI>
	<LI><A HREF="#2">2 - References</A></LI>
	<LI><A HREF="#3">3 - Additions</A></LI>
	<LI><A HREF="#4">4 - Changes</A></LI>
	<LI><A HREF="#5">A - Glossary</A></LI>
</UL>

<EMBED SRC="references.shtml">

<H1>Additions</H1>

<P>CUPS 1.1 includes many new features from the 1.0.x releases.

<H2>Filters</H2>

<H3><CODE>imagetoraster</CODE>, <CODE>imagetops</CODE></H3>

<P>The image file filters have been upgraded to support conversion of
Microsoft Bitmap ("BMP") and Alias PIX files.

<H3>pdftops</H3>

<P>A new pdftops filter has been developed that is based on the
excellent Xpdf 0.90 software from Derek B. Noonburg. The new filter is
faster, smaller, and considerably more reliable than the
Ghostscript-based filter in CUPS 1.0.

<H3>pstoraster</H3>

<P>The <CODE>pstoraster</CODE> filter has been integrated with GNU
GhostScript 5.50. The new RIP supports most Level 3 PostScript language
features.

<H3>rastertoepson</H3>

<P>The new <CODE>rastertoepson</CODE> filter supports EPSON printers
using the ESC/P or ESC/P2 command sets. PPDs are supplied for 9-pin,
24-pin, Stylus Color, and Stylus Photo printers.

<H2>User-Defined Printers and Options</H2>

<P>The new <CODE>lpoptions</CODE> command allows users to configure default
document options and create additional "instances" of existing printers,
each with unique options.

<P>The <CODE>lp</CODE>, <CODE>lpr</CODE>, and <CODE>lpstat</CODE> commands
have been upgraded to use this option and printer instance information
automatically.

<H2>Daemons</H2>

<P>CUPS 1.1 includes two new daemons that provide enhanced network printing
support.

<H3>cups-lpd</H3>

<P>The <CODE>cups-lpd</CODE> daemon provides support for clients using the
Line Printer Daemon protocol.

<H3>cups-polld</H3>

<P>The <CODE>cups-polld</CODE> daemon provides remote polling services for
the scheduler.

<H2>Commands</H2>

<P>CUPS 1.1 includes several new printing commands.

<H3>lpoptions</H3>

<P>The <CODE>lpoptions</CODE> command provides user-defined printers and
options.

<H3>lpmove</H3>

<P>The <CODE>lpmove</CODE> command moves a print job to a new destination.

<H3>lpinfo</H3>

<P>The <CODE>lpinfo</CODE> command lists the available PPD files or devices.

<H2>IPP Implementation</H2>

<P>CUPS 1.1 adds support for the <CODE>set-job-attributes</CODE>
extension operation as well as two new CUPS-specific extension
operations to determine which devices and printer drivers are available
on the system.

<P>Further information on the CUPS implementation of IPP can be found
in CUPS-IPP-1.1.


<H1>Changes</H1>

<P>CUPS 1.1 includes many changes from the 1.0.x releases.

<H2>Directory Structure</H2>

<P>The directory structure in CUPS 1.1 has been modified to conform to the
Filesystem Hierarchy Standard, 2.0. The following table describes the
new file locations.

<CENTER><TABLE WIDTH="80%" BORDER>
<CAPTION>Table 1: Directory structure changes from CUPS 1.0.x to 1.1.x.</CAPTION>
<TR>
	<TH>Description</TH>
	<TH>CUPS 1.0.x</TH>
	<TH>CUPS 1.1.x</TH>
</TR>
<TR>
	<TD>Backends</TD>
	<TD>/var/cups/backend</TD>
	<TD>/usr/lib/cups/backend</TD>
</TR>
<TR>
	<TD>CGI programs</TD>
	<TD>/var/cups/cgi-bin</TD>
	<TD>/usr/lib/cups/cgi-bin</TD>
</TR>
<TR>
	<TD>Configuration files</TD>
	<TD>/var/cups/conf</TD>
	<TD>/etc/cups</TD>
</TR>
<TR>
	<TD>Documentation</TD>
	<TD>/usr/share/cups/doc</TD>
	<TD>/usr/share/doc/cups</TD>
</TR>
<TR>
	<TD>Filter programs</TD>
	<TD>/var/cups/filter</TD>
	<TD>/usr/lib/cups/filter</TD>
</TR>
<TR>
	<TD>Interface scripts</TD>
	<TD>/var/cups/interfaces</TD>
	<TD>/etc/cups/interfaces</TD>
</TR>
<TR>
	<TD>Locale data</TD>
	<TD>/usr/lib/locale</TD>
	<TD>/usr/share/locale</TD>
</TR>
<TR>
	<TD>Log files</TD>
	<TD>/var/cups/logs</TD>
	<TD>/var/log/cups</TD>
</TR>
<TR>
	<TD>PPD files</TD>
	<TD>/var/cups/ppd</TD>
	<TD>/etc/cups/ppd</TD>
</TR>
<TR>
	<TD>Request files</TD>
	<TD>/var/cups/requests</TD>
	<TD>/var/spool/cups</TD>
</TR>
</TABLE></CENTER>

<H2>IPP Implementation</H2>

<P>CUPS 1.1 is based on version 1.1 of the Internet Printing Protocol.

<P>The new scheduler supports the <CODE>create-job</CODE> and
<CODE>send-document</CODE> operations. In addition, the
<CODE>job-sheets</CODE>, <CODE>job-sheets-default</CODE>, and
<CODE>job-sheets-supported</CODE> attributes are now supported for
banner pages.

<P>The <CODE>CUPS-get-printers</CODE> and <CODE>CUPS-get-classes</CODE>
operations have been upgraded to support limited filtering based upon
the <CODE>printer-type</CODE>, <CODE>printer-location</CODE>,
<CODE>printer-info</CODE>, and <CODE>printer-make-and-model</CODE>
attributes.

<P>The <CODE>CUPS-add-printer</CODE> operation now supports the
<CODE>ppd-name</CODE> attribute to specify a locally-available PPD file
rather than sending the PPD file from the client with the request.

<P>Further information on the CUPS implementation of IPP can be found
in CUPS-IPP-1.1.

<EMBED SRC="glossary.shtml">

</BODY>
</HTML>
Commit	Line	Data
979405f6	1	<HTML>
979405f6	2	<HEAD>
baee2cec	3	<META NAME="COPYRIGHT" CONTENT="Copyright 1997-2001, All Rights Reserved">
1aee2644	4	<META NAME="DOCNUMBER" CONTENT="CUPS-SVD-1.1">
979405f6	5	<META NAME="Author" CONTENT="Easy Software Products">
	6	<TITLE>CUPS Software Version Description</TITLE>
	7	</HEAD>
	8	<BODY>
	9
	10	<H1>Scope</H1>
	11
	12	<H2>Identification</H2>
	13
	14	This software version description document provides release information for the
	15	Common UNIX Printing System ("CUPS") Version 1.1.
	16
1aee2644	17	<EMBED SRC="system-overview.shtml">
979405f6	18
	19	<H2>Document Overview</H2>
	20
1aee2644	21	<P>This software version description document is organized into the following
979405f6	22	sections:</P>
	23
	24	<UL>
1aee2644	25	<LI><A HREF="#1">1 - Scope</A></LI>
	26	<LI><A HREF="#2">2 - References</A></LI>
	27	<LI><A HREF="#3">3 - Additions</A></LI>
	28	<LI><A HREF="#4">4 - Changes</A></LI>
	29	<LI><A HREF="#5">A - Glossary</A></LI>
979405f6	30	</UL>
979405f6	31
1aee2644	32	<EMBED SRC="references.shtml">
979405f6	33
	34	<H1>Additions</H1>
	35
551d3a88	36	<P>CUPS 1.1 includes many new features from the 1.0.x releases.
979405f6	37
1aee2644	38	<H2>Filters</H2>
979405f6	39
1aee2644	40	<H3><CODE>imagetoraster</CODE>, <CODE>imagetops</CODE></H3>
979405f6	41
551d3a88	42	<P>The image file filters have been upgraded to support conversion of
	43	Microsoft Bitmap ("BMP") and Alias PIX files.
	44
	45	<H3>pdftops</H3>
	46
	47	<P>A new pdftops filter has been developed that is based on the
	48	excellent Xpdf 0.90 software from Derek B. Noonburg. The new filter is
	49	faster, smaller, and considerably more reliable than the
	50	Ghostscript-based filter in CUPS 1.0.
979405f6	51
1aee2644	52	<H3>pstoraster</H3>
979405f6	53
551d3a88	54	<P>The <CODE>pstoraster</CODE> filter has been integrated with GNU
	55	GhostScript 5.50. The new RIP supports most Level 3 PostScript language
	56	features.
	57
	58	<H3>rastertoepson</H3>
	59
	60	<P>The new <CODE>rastertoepson</CODE> filter supports EPSON printers
	61	using the ESC/P or ESC/P2 command sets. PPDs are supplied for 9-pin,
	62	24-pin, Stylus Color, and Stylus Photo printers.
979405f6	63
1aee2644	64	<H2>User-Defined Printers and Options</H2>
979405f6	65
1aee2644	66	<P>The new <CODE>lpoptions</CODE> command allows users to configure default
	67	document options and create additional "instances" of existing printers,
	68	each with unique options.
979405f6	69
1aee2644	70	<P>The <CODE>lp</CODE>, <CODE>lpr</CODE>, and <CODE>lpstat</CODE> commands
	71	have been upgraded to use this option and printer instance information
	72	automatically.
979405f6	73
551d3a88	74	<H2>Daemons</H2>
	75
	76	<P>CUPS 1.1 includes two new daemons that provide enhanced network printing
	77	support.
	78
	79	<H3>cups-lpd</H3>
	80
	81	<P>The <CODE>cups-lpd</CODE> daemon provides support for clients using the
	82	Line Printer Daemon protocol.
	83
	84	<H3>cups-polld</H3>
	85
	86	<P>The <CODE>cups-polld</CODE> daemon provides remote polling services for
	87	the scheduler.
	88
	89	<H2>Commands</H2>
	90
	91	<P>CUPS 1.1 includes several new printing commands.
	92
	93	<H3>lpoptions</H3>
	94
	95	<P>The <CODE>lpoptions</CODE> command provides user-defined printers and
	96	options.
	97
	98	<H3>lpmove</H3>
	99
	100	<P>The <CODE>lpmove</CODE> command moves a print job to a new destination.
	101
	102	<H3>lpinfo</H3>
	103
	104	<P>The <CODE>lpinfo</CODE> command lists the available PPD files or devices.
	105
	106	<H2>IPP Implementation</H2>
	107
	108	<P>CUPS 1.1 adds support for the <CODE>set-job-attributes</CODE>
	109	extension operation as well as two new CUPS-specific extension
	110	operations to determine which devices and printer drivers are available
	111	on the system.
	112
	113	<P>Further information on the CUPS implementation of IPP can be found
	114	in CUPS-IPP-1.1.
979405f6	115
979405f6	116
1aee2644	117	<H1>Changes</H1>
979405f6	118
551d3a88	119	<P>CUPS 1.1 includes many changes from the 1.0.x releases.
1aee2644	120
	121	<H2>Directory Structure</H2>
	122
551d3a88	123	<P>The directory structure in CUPS 1.1 has been modified to conform to the
1aee2644	124	Filesystem Hierarchy Standard, 2.0. The following table describes the
	125	new file locations.
	126
	127	<CENTER><TABLE WIDTH="80%" BORDER>
551d3a88	128	<CAPTION>Table 1: Directory structure changes from CUPS 1.0.x to 1.1.x.</CAPTION>
1aee2644	129	<TR>
	130	<TH>Description</TH>
	131	<TH>CUPS 1.0.x</TH>
	132	<TH>CUPS 1.1.x</TH>
	133	</TR>
	134	<TR>
	135	<TD>Backends</TD>
	136	<TD>/var/cups/backend</TD>
	137	<TD>/usr/lib/cups/backend</TD>
	138	</TR>
	139	<TR>
	140	<TD>CGI programs</TD>
	141	<TD>/var/cups/cgi-bin</TD>
	142	<TD>/usr/lib/cups/cgi-bin</TD>
	143	</TR>
	144	<TR>
	145	<TD>Configuration files</TD>
	146	<TD>/var/cups/conf</TD>
	147	<TD>/etc/cups</TD>
	148	</TR>
	149	<TR>
	150	<TD>Documentation</TD>
	151	<TD>/usr/share/cups/doc</TD>
	152	<TD>/usr/share/doc/cups</TD>
	153	</TR>
	154	<TR>
	155	<TD>Filter programs</TD>
	156	<TD>/var/cups/filter</TD>
	157	<TD>/usr/lib/cups/filter</TD>
	158	</TR>
	159	<TR>
	160	<TD>Interface scripts</TD>
	161	<TD>/var/cups/interfaces</TD>
	162	<TD>/etc/cups/interfaces</TD>
	163	</TR>
	164	<TR>
	165	<TD>Locale data</TD>
	166	<TD>/usr/lib/locale</TD>
	167	<TD>/usr/share/locale</TD>
	168	</TR>
	169	<TR>
	170	<TD>Log files</TD>
	171	<TD>/var/cups/logs</TD>
	172	<TD>/var/log/cups</TD>
	173	</TR>
	174	<TR>
	175	<TD>PPD files</TD>
	176	<TD>/var/cups/ppd</TD>
	177	<TD>/etc/cups/ppd</TD>
	178	</TR>
	179	<TR>
	180	<TD>Request files</TD>
	181	<TD>/var/cups/requests</TD>
	182	<TD>/var/spool/cups</TD>
	183	</TR>
	184	</TABLE></CENTER>
	185
	186	<H2>IPP Implementation</H2>
	187
551d3a88	188	<P>CUPS 1.1 is based on version 1.1 of the Internet Printing Protocol.
1aee2644	189
551d3a88	190	<P>The new scheduler supports the <CODE>create-job</CODE> and
	191	<CODE>send-document</CODE> operations. In addition, the
	192	<CODE>job-sheets</CODE>, <CODE>job-sheets-default</CODE>, and
	193	<CODE>job-sheets-supported</CODE> attributes are now supported for
	194	banner pages.
1aee2644	195
	196	<P>The <CODE>CUPS-get-printers</CODE> and <CODE>CUPS-get-classes</CODE>
	197	operations have been upgraded to support limited filtering based upon
	198	the <CODE>printer-type</CODE>, <CODE>printer-location</CODE>,
	199	<CODE>printer-info</CODE>, and <CODE>printer-make-and-model</CODE>
	200	attributes.
	201
	202	<P>The <CODE>CUPS-add-printer</CODE> operation now supports the
551d3a88	203	<CODE>ppd-name</CODE> attribute to specify a locally-available PPD file
551d3a88	204	rather than sending the PPD file from the client with the request.
1aee2644	205
	206	<P>Further information on the CUPS implementation of IPP can be found
	207	in CUPS-IPP-1.1.
	208
	209	<EMBED SRC="glossary.shtml">
979405f6	210
	211	</BODY>
	212	</HTML>