Import cups.org releases

git-svn-id: svn+ssh://src.apple.com/svn/cups/cups.org/tags/release-1.0b3@4306 a1ca3aef-8c08-0410-bb20-df032aa958be
2013-05-10 18:56:23 +00:00
@@ -5,265 +5,382 @@

 <BODY BGCOLOR=#ffffff>

-<H1 ALIGN=CENTER><FONT FACE="Arial,HELVETICA">Aladdin Free Public License</FONT></H1>
+<H2 ALIGN="CENTER">Common UNIX Printing System License Agreement</H2>

-<P ALIGN=CENTER>(Version 6, June 17, 1997)</P>
+<P ALIGN="CENTER">Copyright 1997-1999 by Easy Software Products<BR>
+44141 AIRPORT VIEW DR STE 204<BR>
+HOLLYWOOD, MARYLAND 20636-3111 USA<BR>
+<BR>
+Voice: +1.301.373.9603<BR>
+Email: cups-info@cups.org<BR>
+WWW: http://www.cups.org

-<P ALIGN=CENTER>Copyright &copy; 1994, 1995, 1997 Aladdin Enterprises,<BR><BR>
-Menlo Park, California, U.S.A.  All rights reserved.</P>
+<H3>Introduction</H3>

-<BLOCKQUOTE>
-NOTE: This License is not the same as any of the GNU Licenses published
-by the Free Software Foundation.  Its terms are substantially different
-from those of the GNU Licenses. If you are familiar with the GNU
-Licenses, please read this license with extra care.
+<P>The Common UNIX Printing System<SUP>TM</SUP>, or CUPS<SUP>TM</SUP>,
+is provided under the GNU General Public License, Version 2. A copy of
+this license follows this introduction.
+
+<P>For those not familiar with the GNU General Public License, the license
+basically allows you to:
+
+<UL>
+
+	<LI>Use the CUPS software at no charge.
+
+	<LI>Distribute verbatim copies of the software in source or
+	binary form.
+
+	<LI>Sell verbatim copies of the software for a media fee, or
+	sell support for the software.
+
+	<LI>Distribute or sell printer drivers and filters that use the
+	CUPS API so long as source code is made available under the GPL.
+
+</UL>
+
+<P>What this license <B>does not</B> allow you to do is make changes or
+add features to CUPS and then sell a binary distribution without source
+code. You have to provide source for any new drivers, changes, or
+additions to the software, and all code must be provided under the GPL.
+
+<P>Also, since we have trademarked the Common UNIX Printing System, CUPS,
+and CUPS logo, you may not release a derivative product using those names
+without permission from Easy Software Products.
+
+<H3>Binary Distribution Rights</H3>
+
+<P>Easy Software Products also sells rights to the CUPS source code
+under a binary distribution license for vendors that are unable to
+release source code for their drivers or additions and modifications to
+CUPS under the GPL. For pricing information please contact us at the
+address shown above.
+
+<P>The Common UNIX Printing System utilizes GNU GhostScript 4.03 to
+convert PostScript files into a stream of raster images. For binary
+distribution licensing of this software, please contact:
+
+<BLOCKQUOTE>Miles Jones<BR>
+Director of Marketing<BR>
+Artifex Software Inc.<BR>
+454 Las Gallinas Ave., Suite 108<BR>
+San Rafael, CA 94903 USA<BR>
+Voice: +1.415.492.9861<BR>
+Fax: +1.415.492.9862<BR>
+EMail: info@arsoft.com
 </BLOCKQUOTE>

-<P>Aladdin Enterprises hereby grants to anyone the permission to apply
-this License to their own work, as long as the entire License
-(including the above notices and this paragraph) is copied with no
-changes, additions, or deletions except for changing the first
-paragraph of Section 0 to include a suitable description of the work to
-which the license is being applied and of the person or entity that
-holds the copyright in the work, and, if the License is being applied
-to a work created in a country other than the United States, replacing
-the first paragraph of Section 6 with an appropriate reference to the
-laws of the appropriate country.</P>
+<H3>Support</H3>

-<H2><FONT FACE="Arial,HELVETICA">0. Subject Matter</FONT></H2>
+<P>Easy Software Products sells software support for distributors and
+resellers of CUPS. Support for users of CUPS is available from Easy
+Software Products through our ESP Print software.

-This License applies to the Common UNIX Printing System ("PROGRAM").
-The Common UNIX Printing System is a copyrighted work whose copyright
-is held by Easy Software Products (the "LICENSOR").  The Common UNIX
-Printing System, CUPS, and the CUPS logo are the trademark property of
-Easy Software Products.
+<H3>Trademarks</H3>

-<P>A "work based on the PROGRAM" means either the PROGRAM or any
-derivative work of the PROGRAM, as defined in the United States
-Copyright Act of 1976, such as a translation or a modification.
+<P>The Common UNIX Printing System, CUPS, and the CUPS logo are the
+trademark property of Easy Software Products. Any derivative of this
+software may not use any of these trademarks without the expressed
+written consent of Easy Software Products.

-<P>BY MODIFYING OR DISTRIBUTING THE PROGRAM (OR ANY WORK BASED ON THE
-PROGRAM), YOU INDICATE YOUR ACCEPTANCE OF THIS LICENSE TO DO SO, AND
-ALL ITS TERMS AND CONDITIONS FOR COPYING, DISTRIBUTING OR MODIFYING THE
-PROGRAM OR WORKS BASED ON IT.  NOTHING OTHER THAN THIS LICENSE GRANTS
-YOU PERMISSION TO MODIFY OR DISTRIBUTE THE PROGRAM OR ITS DERIVATIVE
-WORKS. THESE ACTIONS ARE PROHIBITED BY LAW.  IF YOU DO NOT ACCEPT THESE
-TERMS AND CONDITIONS, DO NOT MODIFY OR DISTRIBUTE THE PROGRAM.
+<H2 ALIGN="CENTER">GNU General Public License</H2>

-<H2><FONT FACE="Arial,HELVETICA">1. Licenses</FONT></H2>
+<P ALIGN="CENTER">Version 2, June 1991<BR>
+<BR>
+Copyright 1989, 1991 Free Software Foundation, Inc.<BR>
+59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

-LICENSOR hereby grants you the following rights, provided that you comply
-with all of the restrictions set forth in this License and provided,
-further, that you distribute an unmodified copy of this License with the
-PROGRAM:
+<P ALIGN="CENTER">Everyone is permitted to copy and distribute verbatim
+copies of this license document, but changing it is not allowed.

-<OL TYPE=a>
+<H3>Preamble</H3>

-	<LI>You may copy and distribute literal (i.e., verbatim) copies
-	of the PROGRAM's source code as you receive it throughout the
-	world, in any medium.<BR><BR>
+<P>The licenses for most software are designed to take away your
+freedom to share and change it.  By contrast, the GNU General Public
+License is intended to guarantee your freedom to share and change free
+software--to make sure the software is free for all its users.  This
+General Public License applies to most of the Free Software
+Foundation's software and to any other program whose authors commit to
+using it.  (Some other Free Software Foundation software is covered by
+the GNU Library General Public License instead.)  You can apply it to
+your programs, too.

-	<LI>You may modify the PROGRAM, create works based on the
-	PROGRAM and distribute copies of such throughout the world, in
-	any medium.<BR><BR>
+<P>When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+this service if you wish), that you receive source code or can get it
+if you want it, that you can change the software or use pieces of it
+in new free programs; and that you know you can do these things.
+
+<P>To protect your rights, we need to make restrictions that forbid
+anyone to deny you these rights or to ask you to surrender the rights.
+These restrictions translate to certain responsibilities for you if you
+distribute copies of the software, or if you modify it.
+
+<P>For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must give the recipients all the rights that
+you have.  You must make sure that they, too, receive or can get the
+source code.  And you must show them these terms so they know their
+rights.
+
+<P>We protect your rights with two steps: (1) copyright the software, and
+(2) offer you this license which gives you legal permission to copy,
+distribute and/or modify the software.
+
+<P>Also, for each author's protection and ours, we want to make certain
+that everyone understands that there is no warranty for this free
+software.  If the software is modified by someone else and passed on, we
+want its recipients to know that what they have is not the original, so
+that any problems introduced by others will not reflect on the original
+authors' reputations.
+
+<P>Finally, any free program is threatened constantly by software
+patents.  We wish to avoid the danger that redistributors of a free
+program will individually obtain patent licenses, in effect making the
+program proprietary.  To prevent this, we have made it clear that any
+patent must be licensed for everyone's free use or not licensed at all.
+
+<P>The precise terms and conditions for copying, distribution and
+modification follow.
+
+<H3>GNU GENERAL PUBLIC LICENSE<BR>
+TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION</H3>
+
+<OL START="0">
+
+<LI>This License applies to any program or other work which contains
+a notice placed by the copyright holder saying it may be distributed
+under the terms of this General Public License.  The "Program", below,
+refers to any such program or work, and a "work based on the Program"
+means either the Program or any derivative work under copyright law:
+that is to say, a work containing the Program or a portion of it,
+either verbatim or with modifications and/or translated into another
+language.  (Hereinafter, translation is included without limitation in
+the term "modification".)  Each licensee is addressed as "you".
+
+<P>Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope.  The act of
+running the Program is not restricted, and the output from the Program
+is covered only if its contents constitute a work based on the
+Program (independent of having been made by running the Program).
+Whether that is true depends on what the Program does.
+
+<LI>You may copy and distribute verbatim copies of the Program's
+source code as you receive it, in any medium, provided that you
+conspicuously and appropriately publish on each copy an appropriate
+copyright notice and disclaimer of warranty; keep intact all the
+notices that refer to this License and to the absence of any warranty;
+and give any other recipients of the Program a copy of this License
+along with the Program.
+
+<P>You may charge a fee for the physical act of transferring a copy, and
+you may at your option offer warranty protection in exchange for a fee.
+
+<LI>You may modify your copy or copies of the Program or any portion
+of it, thus forming a work based on the Program, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+<OL TYPE="a">
+
+<LI>You must cause the modified files to carry prominent notices
+stating that you changed the files and the date of any change.
+
+<LI>You must cause any work that you distribute or publish, that in
+whole or in part contains or is derived from the Program or any
+part thereof, to be licensed as a whole at no charge to all third
+parties under the terms of this License.
+
+<LI>if the modified program normally reads commands interactively
+when run, you must cause it, when started running for such
+interactive use in the most ordinary way, to print or display an
+announcement including an appropriate copyright notice and a
+notice that there is no warranty (or else, saying that you provide
+a warranty) and that users may redistribute the program under
+these conditions, and telling the user how to view a copy of this
+License.  (Exception: if the Program itself is interactive but
+does not normally print such an announcement, your work based on
+the Program is not required to print an announcement.)

 </OL>

-<H2><FONT FACE="Arial,HELVETICA">2. Restrictions</FONT></H2>
+<P>These requirements apply to the modified work as a whole.  If
+identifiable sections of that work are not derived from the Program,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works.  But when you
+distribute the same sections as part of a whole which is a work based
+on the Program, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote it.

-This license is subject to the following restrictions:
+<P>Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Program.

-<OL TYPE=a>
+<P>In addition, mere aggregation of another work not based on the Program
+with the Program (or with a work based on the Program) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.

-	<LI>Distribution of the PROGRAM or any work based on the
-	PROGRAM by a commercial organization to any third party is
-	prohibited if any payment is made in connection with such
-	distribution, whether directly (as in payment for a copy of the
-	PROGRAM) or indirectly (as in payment for some service related
-	to the PROGRAM, or payment for some product or service that
-	includes a copy of the PROGRAM "without charge"; these are only
-	examples, and not an exhaustive enumeration of prohibited
-	activities).  The following methods of distribution involving
-	payment shall not in and of themselves be a violation of this
-	restriction:<BR><BR>
+<LI>You may copy and distribute the Program (or a work based on it,
+under Section 2) in object code or executable form under the terms of
+Sections 1 and 2 above provided that you also do one of the following:

-	<OL TYPE=i>
+<OL TYPE="a">

-		<LI>Posting the PROGRAM on a public access information
-		storage and retrieval service for which a fee is
-		received for retrieving information (such as an on-line
-		service), provided that the fee is not
-		content-dependent (i.e., the fee would be the same for
-		retrieving the same volume of information consisting of
-		random data) and that access to the service and to the
-		PROGRAM is available independent of any other product
-		or service.  An example of a service that does not fall
-		under this section is an on-line service that is
-		operated by a company and that is only available to
-		customers of that company.  (This is not an exhaustive
-		enumeration.)<BR><BR>
+<LI>Accompany it with the complete corresponding machine-readable
+source code, which must be distributed under the terms of Sections
+1 and 2 above on a medium customarily used for software interchange; or,

-		<LI>Distributing the PROGRAM on removable
-		computer-readable media, provided that the files
-		containing the PROGRAM are reproduced entirely and
-		verbatim on such media, that all information on such
-		media be redistributable for non-commercial purposes
-		without charge, and that such media are distributed by
-		themselves (except for accompanying documentation)
-		independent of any other product or service.  Examples
-		of such media include CD-ROM, magnetic tape, and
-		optical storage media.  (This is not intended to be an
-		exhaustive list.)  An example of a distribution that
-		does not fall under this section is a CD-ROM included
-		in a book or magazine.  (This is not an exhaustive
-		enumeration.)<BR><BR>
+<LI>Accompany it with a written offer, valid for at least three
+years, to give any third party, for a charge no more than your
+cost of physically performing source distribution, a complete
+machine-readable copy of the corresponding source code, to be
+distributed under the terms of Sections 1 and 2 above on a medium
+customarily used for software interchange; or,

-	</OL>
-
-	<LI>Activities other than copying, distribution and
-	modification of the PROGRAM are not subject to this License and
-	they are outside its scope. Functional use (running) of the
-	PROGRAM is not restricted, and any output produced through the
-	use of the PROGRAM is subject to this license only if its
-	contents constitute a work based on the PROGRAM (independent of
-	having been made by running the PROGRAM).<BR><BR>
-
-	<LI>You must meet all of the following conditions with respect to any work
-	that you distribute or publish that in whole or in part contains or is
-	derived from the PROGRAM or any part thereof ("the Work"):<BR><BR>
-
-	<OL TYPE=i>
-
-		<LI>If you have modified the PROGRAM, you must cause
-		the Work to carry prominent notices stating that you
-		have modified the PROGRAM's files and the date of any
-		change;<BR><BR>
-
-		<LI>You must cause the Work to be licensed as a whole
-		and at no charge to all third parties under the terms
-		of this License;<BR><BR>
-
-		<LI>If the Work normally reads commands interactively
-		when run, you must cause it, at each time the Work
-		commences operation, to print or display an
-		announcement including an appropriate copyright notice
-		and a notice that there is no warranty (or else, saying
-		that you provide a warranty).  Such notice must also
-		state that users may redistribute the Work only under
-		the conditions of this License and tell the user how to
-		view the copy of this License included with the Work. 
-		(Exceptions: if the PROGRAM is interactive but normally
-		prints or displays such an announcement only at the
-		request of a user, such as in an "About box", the Work
-		is required to print or display the notice only under
-		the same circumstances; if the PROGRAM itself is
-		interactive but does not normally print such an
-		announcement, the Work is not required to print an
-		announcement.);<BR><BR>
-
-		<LI>You must accompany the Work with the complete
-		corresponding machine-readable source code, delivered
-		on a medium customarily used for software interchange. 
-		The source code for a work means the preferred form of
-		the work for making modifications to it.  For an
-		executable work, complete source code means all the
-		source code for all modules it contains, plus any
-		associated interface definition files, plus the scripts
-		used to control compilation and installation of the
-		executable code.  If you distribute with the Work any
-		component that is normally distributed (in either
-		source or binary form) with the major components
-		(compiler, kernel, and so on) of the operating system
-		on which the executable runs, you must also distribute
-		the source code of that component if you have it and
-		are allowed to do so;<BR><BR>
-
-		<LI>If you distribute any written or printed material
-		at all with the Work, such material must include either
-		a written copy of this License, or a prominent written
-		indication that the Work is covered by this License and
-		written instructions for printing and/or displaying the
-		copy of the License on the distribution medium;<BR><BR>
-
-		<LI>You may not impose any further restrictions on the
-		recipient's exercise of the rights granted herein.<BR><BR>
-
-	</OL>
+<LI>Accompany it with the information you received as to the offer
+to distribute corresponding source code.  (This alternative is
+allowed only for noncommercial distribution and only if you
+received the program in object code or executable form with such
+an offer, in accord with Subsection b above.)

 </OL>

-If distribution of executable or object code is made by offering the
-equivalent ability to copy from a designated place, then offering
-equivalent ability to copy the source code from the same place counts
-as distribution of the source code, even though third parties are not
-compelled to copy the source code along with the object code.
+<P>The source code for a work means the preferred form of the work for
+making modifications to it.  For an executable work, complete source
+code means all the source code for all modules it contains, plus any
+associated interface definition files, plus the scripts used to
+control compilation and installation of the executable.  However, as a
+special exception, the source code distributed need not include
+anything that is normally distributed (in either source or binary
+form) with the major components (compiler, kernel, and so on) of the
+operating system on which the executable runs, unless that component
+itself accompanies the executable.

-<H2><FONT FACE="Arial,HELVETICA">3. Reservation of Rights</FONT></H2>
+<P>If distribution of executable or object code is made by offering
+access to copy from a designated place, then offering equivalent
+access to copy the source code from the same place counts as
+distribution of the source code, even though third parties are not
+compelled to copy the source along with the object code.

-No rights are granted to the PROGRAM except as expressly set forth
-herein. You may not copy, modify, sublicense, or distribute the PROGRAM
-except as expressly provided under this License.  Any attempt otherwise
-to copy, modify, sublicense or distribute the PROGRAM is void, and will
-automatically terminate your rights under this License.  However,
-parties who have received copies, or rights, from you under this
-License will not have their licenses terminated so long as such parties
-remain in full compliance.
+<LI>You may not copy, modify, sublicense, or distribute the Program
+except as expressly provided under this License.  Any attempt
+otherwise to copy, modify, sublicense or distribute the Program is
+void, and will automatically terminate your rights under this License.
+However, parties who have received copies, or rights, from you under
+this License will not have their licenses terminated so long as such
+parties remain in full compliance.

-<H2><FONT FACE="Arial,HELVETICA">4. Other Restrictions</FONT></H2>
+<LI>You are not required to accept this License, since you have not
+signed it.  However, nothing else grants you permission to modify or
+distribute the Program or its derivative works.  These actions are
+prohibited by law if you do not accept this License.  Therefore, by
+modifying or distributing the Program (or any work based on the
+Program), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Program or works based on it.

-If the distribution and/or use of the PROGRAM is restricted in certain
-countries for any reason, LICENSOR may add an explicit geographical
-distribution limitation excluding those countries, so that distribution
-is permitted only in or among countries not thus excluded.  In such
-case, this License incorporates the limitation as if written in the
-body of this License.
+<LI>Each time you redistribute the Program (or any work based on the
+Program), the recipient automatically receives a license from the
+original licensor to copy, distribute or modify the Program subject to
+these terms and conditions.  You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties to
+this License.

-<H2><FONT FACE="Arial,HELVETICA">5. Limitations</FONT></H2>
+<LI>If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Program at all.  For example, if a patent
+license would not permit royalty-free redistribution of the Program by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Program.

-THE PROGRAM IS PROVIDED TO YOU "AS IS", WITHOUT WARRANTY.  THERE IS NO
-WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT
-NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
-FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. 
-THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS
-WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
-ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+<P>If any portion of this section is held invalid or unenforceable under
+any particular circumstance, the balance of the section is intended to
+apply and the section as a whole is intended to apply in other
+circumstances.

-<P>IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
-WILL LICENSOR, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE
-THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING
-ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT
-OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
-TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED
-BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY
-OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF
-THE POSSIBILITY OF SUCH DAMAGES.
+<P>It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system, which is
+implemented by public license practices.  Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.

-<H2><FONT FACE="Arial,HELVETICA">6. General</FONT></H2>
+<P>This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.

-This License is governed by the laws of the State of Maryland, U.S.A.,
-excluding choice of law rules.
+<LI>If the distribution and/or use of the Program is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Program under this License
+may add an explicit geographical distribution limitation excluding
+those countries, so that distribution is permitted only in or among
+countries not thus excluded.  In such case, this License incorporates
+the limitation as if written in the body of this License.

-<P>If any part of this License is found to be in conflict with the law,
-that part shall be interpreted in its broadest meaning consistent with
-the law, and no other parts of the License shall be affected.
+<LI>The Free Software Foundation may publish revised and/or new versions
+of the General Public License from time to time.  Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.

-<P>For United States Government users, the PROGRAM is provided with
-RESTRICTED RIGHTS.  If you are a unit or agency of the United States
-Government or are acquiring the Software for any such unit or agency,
-the following apply:
+<P>Each version is given a distinguishing version number.  If the Program
+specifies a version number of this License which applies to it and "any
+later version", you have the option of following the terms and conditions
+either of that version or of any later version published by the Free
+Software Foundation.  If the Program does not specify a version number of
+this License, you may choose any version ever published by the Free Software
+Foundation.

-<BLOCKQUOTE>
-If the unit or agency is the Department of Defense ("DOD"), the
-Software and its documentation are classified as "commercial computer
-software" and "commercial computer software documentation" respectively
-and, pursuant to DFAR Section 227.7202, the Government is acquiring the
-Software and its documentation in accordance with the terms of this
-License.  If the unit or agency is other than DOD, the Software and its
-documentation are classified as "commercial computer software" and
-"commercial computer software documentation" respectively and, pursuant
-to FAR Section 12.212, the Government is acquiring the Software and its
-documentation in accordance with the terms of this License.
-</BLOCKQUOTE>
+<LI>If you wish to incorporate parts of the Program into other free
+programs whose distribution conditions are different, write to the author
+to ask for permission.  For software which is copyrighted by the Free
+Software Foundation, write to the Free Software Foundation; we sometimes
+make exceptions for this.  Our decision will be guided by the two goals
+of preserving the free status of all derivatives of our free software and
+of promoting the sharing and reuse of software generally.
+
+</OL>
+
+<H3>NO WARRANTY</H3>
+
+<OL START="11">
+
+<LI>BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
+FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
+OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
+PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
+OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
+TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
+PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
+REPAIR OR CORRECTION.
+
+<LI>IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
+REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
+INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
+OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
+TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
+YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
+PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGES.
+
+</OL>
+
+<H3>END OF TERMS AND CONDITIONS</H3>

 </BODY>
 </HTML>
@@ -1,223 +1,332 @@
-                         Aladdin Free Public License
+                Common UNIX Printing System License Agreement

-                         (Version 6, June 17, 1997)
+                Copyright 1997-1999 by Easy Software Products
+                        44141 AIRPORT VIEW DR STE 204
+                     HOLLYWOOD, MARYLAND 20636-3111 USA

-              Copyright © 1994, 1995, 1997 Aladdin Enterprises,
+                           Voice: +1.301.373.9603
+                          Email: cups-info@cups.org
+                          WWW: http://www.cups.org

-             Menlo Park, California, U.S.A. All rights reserved.
+Introduction

-     NOTE: This License is not the same as any of the GNU Licenses
-     published by the Free Software Foundation. Its terms are
-     substantially different from those of the GNU Licenses. If you are
-     familiar with the GNU Licenses, please read this license with
-     extra care.
+The Common UNIX Printing SystemTM, or CUPSTM, is provided under the GNU
+General Public License, Version 2. A copy of this license follows this
+introduction.

-Aladdin Enterprises hereby grants to anyone the permission to apply this
-License to their own work, as long as the entire License (including the
-above notices and this paragraph) is copied with no changes, additions, or
-deletions except for changing the first paragraph of Section 0 to include a
-suitable description of the work to which the license is being applied and
-of the person or entity that holds the copyright in the work, and, if the
-License is being applied to a work created in a country other than the
-United States, replacing the first paragraph of Section 6 with an
-appropriate reference to the laws of the appropriate country.
+For those not familiar with the GNU General Public License, the license
+basically allows you to:

-0. Subject Matter
+   * Use the CUPS software at no charge.
+   * Distribute verbatim copies of the software in source or binary form.
+   * Sell verbatim copies of the software for a media fee, or sell support
+     for the software.
+   * Distribute or sell printer drivers and filters that use the CUPS API so
+     long as source code is made available under the GPL.

-This License applies to the Common UNIX Printing System ("PROGRAM"). The
-Common UNIX Printing System is a copyrighted work whose copyright is held by
-Easy Software Products (the "LICENSOR"). The Common UNIX Printing System,
-CUPS, and the CUPS logo are the trademark property of Easy Software
-Products.
+What this license does not allow you to do is make changes or add features
+to CUPS and then sell a binary distribution without source code. You have to
+provide source for any new drivers, changes, or additions to the software,
+and all code must be provided under the GPL.

-A "work based on the PROGRAM" means either the PROGRAM or any derivative
-work of the PROGRAM, as defined in the United States Copyright Act of 1976,
-such as a translation or a modification.
+Also, since we have trademarked the Common UNIX Printing System, CUPS, and
+CUPS logo, you may not release a derivative product using those names
+without permission from Easy Software Products.

-BY MODIFYING OR DISTRIBUTING THE PROGRAM (OR ANY WORK BASED ON THE PROGRAM),
-YOU INDICATE YOUR ACCEPTANCE OF THIS LICENSE TO DO SO, AND ALL ITS TERMS AND
-CONDITIONS FOR COPYING, DISTRIBUTING OR MODIFYING THE PROGRAM OR WORKS BASED
-ON IT. NOTHING OTHER THAN THIS LICENSE GRANTS YOU PERMISSION TO MODIFY OR
-DISTRIBUTE THE PROGRAM OR ITS DERIVATIVE WORKS. THESE ACTIONS ARE PROHIBITED
-BY LAW. IF YOU DO NOT ACCEPT THESE TERMS AND CONDITIONS, DO NOT MODIFY OR
-DISTRIBUTE THE PROGRAM.
+Binary Distribution Rights

-1. Licenses
+Easy Software Products also sells rights to the CUPS source code under a
+binary distribution license for vendors that are unable to release source
+code for their drivers or additions and modifications to CUPS under the GPL.
+For pricing information please contact us at the address shown above.

-LICENSOR hereby grants you the following rights, provided that you comply
-with all of the restrictions set forth in this License and provided,
-further, that you distribute an unmodified copy of this License with the
-PROGRAM:
+The Common UNIX Printing System utilizes GNU GhostScript 4.03 to convert
+PostScript files into a stream of raster images. For binary distribution
+licensing of this software, please contact:

-  a. You may copy and distribute literal (i.e., verbatim) copies of the
-     PROGRAM's source code as you receive it throughout the world, in any
-     medium.
+     Miles Jones
+     Director of Marketing
+     Artifex Software Inc.
+     454 Las Gallinas Ave., Suite 108
+     San Rafael, CA 94903 USA
+     Voice: +1.415.492.9861
+     Fax: +1.415.492.9862
+     EMail: info@arsoft.com

-  b. You may modify the PROGRAM, create works based on the PROGRAM and
-     distribute copies of such throughout the world, in any medium.
+Support

-2. Restrictions
+Easy Software Products sells software support for distributors and resellers
+of CUPS. Support for users of CUPS is available from Easy Software Products
+through our ESP Print software.

-This license is subject to the following restrictions:
+Trademarks

-  a. Distribution of the PROGRAM or any work based on the PROGRAM by a
-     commercial organization to any third party is prohibited if any payment
-     is made in connection with such distribution, whether directly (as in
-     payment for a copy of the PROGRAM) or indirectly (as in payment for
-     some service related to the PROGRAM, or payment for some product or
-     service that includes a copy of the PROGRAM "without charge"; these are
-     only examples, and not an exhaustive enumeration of prohibited
-     activities). The following methods of distribution involving payment
-     shall not in and of themselves be a violation of this restriction:
+The Common UNIX Printing System, CUPS, and the CUPS logo are the trademark
+property of Easy Software Products. Any derivative of this software may not
+use any of these trademarks without the expressed written consent of Easy
+Software Products.

-       i. Posting the PROGRAM on a public access information storage and
-          retrieval service for which a fee is received for retrieving
-          information (such as an on-line service), provided that the fee is
-          not content-dependent (i.e., the fee would be the same for
-          retrieving the same volume of information consisting of random
-          data) and that access to the service and to the PROGRAM is
-          available independent of any other product or service. An example
-          of a service that does not fall under this section is an on-line
-          service that is operated by a company and that is only available
-          to customers of that company. (This is not an exhaustive
-          enumeration.)
+                         GNU General Public License

-      ii. Distributing the PROGRAM on removable computer-readable media,
-          provided that the files containing the PROGRAM are reproduced
-          entirely and verbatim on such media, that all information on such
-          media be redistributable for non-commercial purposes without
-          charge, and that such media are distributed by themselves (except
-          for accompanying documentation) independent of any other product
-          or service. Examples of such media include CD-ROM, magnetic tape,
-          and optical storage media. (This is not intended to be an
-          exhaustive list.) An example of a distribution that does not fall
-          under this section is a CD-ROM included in a book or magazine.
-          (This is not an exhaustive enumeration.)
+                            Version 2, June 1991

-  b. Activities other than copying, distribution and modification of the
-     PROGRAM are not subject to this License and they are outside its scope.
-     Functional use (running) of the PROGRAM is not restricted, and any
-     output produced through the use of the PROGRAM is subject to this
-     license only if its contents constitute a work based on the PROGRAM
-     (independent of having been made by running the PROGRAM).
+             Copyright 1989, 1991 Free Software Foundation, Inc.
+           59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

-  c. You must meet all of the following conditions with respect to any work
-     that you distribute or publish that in whole or in part contains or is
-     derived from the PROGRAM or any part thereof ("the Work"):
+Everyone is permitted to copy and distribute verbatim copies of this license
+                 document, but changing it is not allowed.

-       i. If you have modified the PROGRAM, you must cause the Work to carry
-          prominent notices stating that you have modified the PROGRAM's
-          files and the date of any change;
+Preamble

-      ii. You must cause the Work to be licensed as a whole and at no charge
-          to all third parties under the terms of this License;
+The licenses for most software are designed to take away your freedom to
+share and change it. By contrast, the GNU General Public License is intended
+to guarantee your freedom to share and change free software--to make sure
+the software is free for all its users. This General Public License applies
+to most of the Free Software Foundation's software and to any other program
+whose authors commit to using it. (Some other Free Software Foundation
+software is covered by the GNU Library General Public License instead.) You
+can apply it to your programs, too.

-     iii. If the Work normally reads commands interactively when run, you
-          must cause it, at each time the Work commences operation, to print
-          or display an announcement including an appropriate copyright
-          notice and a notice that there is no warranty (or else, saying
-          that you provide a warranty). Such notice must also state that
-          users may redistribute the Work only under the conditions of this
-          License and tell the user how to view the copy of this License
-          included with the Work. (Exceptions: if the PROGRAM is interactive
-          but normally prints or displays such an announcement only at the
-          request of a user, such as in an "About box", the Work is required
-          to print or display the notice only under the same circumstances;
-          if the PROGRAM itself is interactive but does not normally print
-          such an announcement, the Work is not required to print an
-          announcement.);
+When we speak of free software, we are referring to freedom, not price. Our
+General Public Licenses are designed to make sure that you have the freedom
+to distribute copies of free software (and charge for this service if you
+wish), that you receive source code or can get it if you want it, that you
+can change the software or use pieces of it in new free programs; and that
+you know you can do these things.

-      iv. You must accompany the Work with the complete corresponding
-          machine-readable source code, delivered on a medium customarily
-          used for software interchange. The source code for a work means
-          the preferred form of the work for making modifications to it. For
-          an executable work, complete source code means all the source code
-          for all modules it contains, plus any associated interface
-          definition files, plus the scripts used to control compilation and
-          installation of the executable code. If you distribute with the
-          Work any component that is normally distributed (in either source
-          or binary form) with the major components (compiler, kernel, and
-          so on) of the operating system on which the executable runs, you
-          must also distribute the source code of that component if you have
-          it and are allowed to do so;
+To protect your rights, we need to make restrictions that forbid anyone to
+deny you these rights or to ask you to surrender the rights. These
+restrictions translate to certain responsibilities for you if you distribute
+copies of the software, or if you modify it.

-       v. If you distribute any written or printed material at all with the
-          Work, such material must include either a written copy of this
-          License, or a prominent written indication that the Work is
-          covered by this License and written instructions for printing
-          and/or displaying the copy of the License on the distribution
-          medium;
+For example, if you distribute copies of such a program, whether gratis or
+for a fee, you must give the recipients all the rights that you have. You
+must make sure that they, too, receive or can get the source code. And you
+must show them these terms so they know their rights.

-      vi. You may not impose any further restrictions on the recipient's
-          exercise of the rights granted herein.
+We protect your rights with two steps: (1) copyright the software, and (2)
+offer you this license which gives you legal permission to copy, distribute
+and/or modify the software.

-If distribution of executable or object code is made by offering the
-equivalent ability to copy from a designated place, then offering equivalent
-ability to copy the source code from the same place counts as distribution
-of the source code, even though third parties are not compelled to copy the
-source code along with the object code.
+Also, for each author's protection and ours, we want to make certain that
+everyone understands that there is no warranty for this free software. If
+the software is modified by someone else and passed on, we want its
+recipients to know that what they have is not the original, so that any
+problems introduced by others will not reflect on the original authors'
+reputations.

-3. Reservation of Rights
+Finally, any free program is threatened constantly by software patents. We
+wish to avoid the danger that redistributors of a free program will
+individually obtain patent licenses, in effect making the program
+proprietary. To prevent this, we have made it clear that any patent must be
+licensed for everyone's free use or not licensed at all.

-No rights are granted to the PROGRAM except as expressly set forth herein.
-You may not copy, modify, sublicense, or distribute the PROGRAM except as
-expressly provided under this License. Any attempt otherwise to copy,
-modify, sublicense or distribute the PROGRAM is void, and will automatically
-terminate your rights under this License. However, parties who have received
-copies, or rights, from you under this License will not have their licenses
-terminated so long as such parties remain in full compliance.
+The precise terms and conditions for copying, distribution and modification
+follow.

-4. Other Restrictions
+GNU GENERAL PUBLIC LICENSE
+TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION

-If the distribution and/or use of the PROGRAM is restricted in certain
-countries for any reason, LICENSOR may add an explicit geographical
-distribution limitation excluding those countries, so that distribution is
-permitted only in or among countries not thus excluded. In such case, this
-License incorporates the limitation as if written in the body of this
-License.
+  1. This License applies to any program or other work which contains a
+     notice placed by the copyright holder saying it may be distributed
+     under the terms of this General Public License. The "Program", below,
+     refers to any such program or work, and a "work based on the Program"
+     means either the Program or any derivative work under copyright law:
+     that is to say, a work containing the Program or a portion of it,
+     either verbatim or with modifications and/or translated into another
+     language. (Hereinafter, translation is included without limitation in
+     the term "modification".) Each licensee is addressed as "you".

-5. Limitations
+     Activities other than copying, distribution and modification are not
+     covered by this License; they are outside its scope. The act of running
+     the Program is not restricted, and the output from the Program is
+     covered only if its contents constitute a work based on the Program
+     (independent of having been made by running the Program). Whether that
+     is true depends on what the Program does.
+  2. You may copy and distribute verbatim copies of the Program's source
+     code as you receive it, in any medium, provided that you conspicuously
+     and appropriately publish on each copy an appropriate copyright notice
+     and disclaimer of warranty; keep intact all the notices that refer to
+     this License and to the absence of any warranty; and give any other
+     recipients of the Program a copy of this License along with the
+     Program.

-THE PROGRAM IS PROVIDED TO YOU "AS IS", WITHOUT WARRANTY. THERE IS NO
-WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
-LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
-PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. THE ENTIRE
-RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD
-THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
-REPAIR OR CORRECTION.
+     You may charge a fee for the physical act of transferring a copy, and
+     you may at your option offer warranty protection in exchange for a fee.
+  3. You may modify your copy or copies of the Program or any portion of it,
+     thus forming a work based on the Program, and copy and distribute such
+     modifications or work under the terms of Section 1 above, provided that
+     you also meet all of these conditions:
+       a. You must cause the modified files to carry prominent notices
+          stating that you changed the files and the date of any change.
+       b. You must cause any work that you distribute or publish, that in
+          whole or in part contains or is derived from the Program or any
+          part thereof, to be licensed as a whole at no charge to all third
+          parties under the terms of this License.
+       c. if the modified program normally reads commands interactively when
+          run, you must cause it, when started running for such interactive
+          use in the most ordinary way, to print or display an announcement
+          including an appropriate copyright notice and a notice that there
+          is no warranty (or else, saying that you provide a warranty) and
+          that users may redistribute the program under these conditions,
+          and telling the user how to view a copy of this License.
+          (Exception: if the Program itself is interactive but does not
+          normally print such an announcement, your work based on the
+          Program is not required to print an announcement.)

-IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL
-LICENSOR, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM
-AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL,
-SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
-INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR
-DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES
-OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF
-SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
-DAMAGES.
+     These requirements apply to the modified work as a whole. If
+     identifiable sections of that work are not derived from the Program,
+     and can be reasonably considered independent and separate works in
+     themselves, then this License, and its terms, do not apply to those
+     sections when you distribute them as separate works. But when you
+     distribute the same sections as part of a whole which is a work based
+     on the Program, the distribution of the whole must be on the terms of
+     this License, whose permissions for other licensees extend to the
+     entire whole, and thus to each and every part regardless of who wrote
+     it.

-6. General
+     Thus, it is not the intent of this section to claim rights or contest
+     your rights to work written entirely by you; rather, the intent is to
+     exercise the right to control the distribution of derivative or
+     collective works based on the Program.

-This License is governed by the laws of the State of Maryland, U.S.A.,
-excluding choice of law rules.
+     In addition, mere aggregation of another work not based on the Program
+     with the Program (or with a work based on the Program) on a volume of a
+     storage or distribution medium does not bring the other work under the
+     scope of this License.
+  4. You may copy and distribute the Program (or a work based on it, under
+     Section 2) in object code or executable form under the terms of
+     Sections 1 and 2 above provided that you also do one of the following:
+       a. Accompany it with the complete corresponding machine-readable
+          source code, which must be distributed under the terms of Sections
+          1 and 2 above on a medium customarily used for software
+          interchange; or,
+       b. Accompany it with a written offer, valid for at least three years,
+          to give any third party, for a charge no more than your cost of
+          physically performing source distribution, a complete
+          machine-readable copy of the corresponding source code, to be
+          distributed under the terms of Sections 1 and 2 above on a medium
+          customarily used for software interchange; or,
+       c. Accompany it with the information you received as to the offer to
+          distribute corresponding source code. (This alternative is allowed
+          only for noncommercial distribution and only if you received the
+          program in object code or executable form with such an offer, in
+          accord with Subsection b above.)

-If any part of this License is found to be in conflict with the law, that
-part shall be interpreted in its broadest meaning consistent with the law,
-and no other parts of the License shall be affected.
+     The source code for a work means the preferred form of the work for
+     making modifications to it. For an executable work, complete source
+     code means all the source code for all modules it contains, plus any
+     associated interface definition files, plus the scripts used to control
+     compilation and installation of the executable. However, as a special
+     exception, the source code distributed need not include anything that
+     is normally distributed (in either source or binary form) with the
+     major components (compiler, kernel, and so on) of the operating system
+     on which the executable runs, unless that component itself accompanies
+     the executable.

-For United States Government users, the PROGRAM is provided with RESTRICTED
-RIGHTS. If you are a unit or agency of the United States Government or are
-acquiring the Software for any such unit or agency, the following apply:
+     If distribution of executable or object code is made by offering access
+     to copy from a designated place, then offering equivalent access to
+     copy the source code from the same place counts as distribution of the
+     source code, even though third parties are not compelled to copy the
+     source along with the object code.
+  5. You may not copy, modify, sublicense, or distribute the Program except
+     as expressly provided under this License. Any attempt otherwise to
+     copy, modify, sublicense or distribute the Program is void, and will
+     automatically terminate your rights under this License. However,
+     parties who have received copies, or rights, from you under this
+     License will not have their licenses terminated so long as such parties
+     remain in full compliance.
+  6. You are not required to accept this License, since you have not signed
+     it. However, nothing else grants you permission to modify or distribute
+     the Program or its derivative works. These actions are prohibited by
+     law if you do not accept this License. Therefore, by modifying or
+     distributing the Program (or any work based on the Program), you
+     indicate your acceptance of this License to do so, and all its terms
+     and conditions for copying, distributing or modifying the Program or
+     works based on it.
+  7. Each time you redistribute the Program (or any work based on the
+     Program), the recipient automatically receives a license from the
+     original licensor to copy, distribute or modify the Program subject to
+     these terms and conditions. You may not impose any further restrictions
+     on the recipients' exercise of the rights granted herein. You are not
+     responsible for enforcing compliance by third parties to this License.
+  8. If, as a consequence of a court judgment or allegation of patent
+     infringement or for any other reason (not limited to patent issues),
+     conditions are imposed on you (whether by court order, agreement or
+     otherwise) that contradict the conditions of this License, they do not
+     excuse you from the conditions of this License. If you cannot
+     distribute so as to satisfy simultaneously your obligations under this
+     License and any other pertinent obligations, then as a consequence you
+     may not distribute the Program at all. For example, if a patent license
+     would not permit royalty-free redistribution of the Program by all
+     those who receive copies directly or indirectly through you, then the
+     only way you could satisfy both it and this License would be to refrain
+     entirely from distribution of the Program.

-     If the unit or agency is the Department of Defense ("DOD"), the
-     Software and its documentation are classified as "commercial
-     computer software" and "commercial computer software
-     documentation" respectively and, pursuant to DFAR Section
-     227.7202, the Government is acquiring the Software and its
-     documentation in accordance with the terms of this License. If the
-     unit or agency is other than DOD, the Software and its
-     documentation are classified as "commercial computer software" and
-     "commercial computer software documentation" respectively and,
-     pursuant to FAR Section 12.212, the Government is acquiring the
-     Software and its documentation in accordance with the terms of
-     this License.
+     If any portion of this section is held invalid or unenforceable under
+     any particular circumstance, the balance of the section is intended to
+     apply and the section as a whole is intended to apply in other
+     circumstances.
+
+     It is not the purpose of this section to induce you to infringe any
+     patents or other property right claims or to contest validity of any
+     such claims; this section has the sole purpose of protecting the
+     integrity of the free software distribution system, which is
+     implemented by public license practices. Many people have made generous
+     contributions to the wide range of software distributed through that
+     system in reliance on consistent application of that system; it is up
+     to the author/donor to decide if he or she is willing to distribute
+     software through any other system and a licensee cannot impose that
+     choice.
+
+     This section is intended to make thoroughly clear what is believed to
+     be a consequence of the rest of this License.
+  9. If the distribution and/or use of the Program is restricted in certain
+     countries either by patents or by copyrighted interfaces, the original
+     copyright holder who places the Program under this License may add an
+     explicit geographical distribution limitation excluding those
+     countries, so that distribution is permitted only in or among countries
+     not thus excluded. In such case, this License incorporates the
+     limitation as if written in the body of this License.
+ 10. The Free Software Foundation may publish revised and/or new versions of
+     the General Public License from time to time. Such new versions will be
+     similar in spirit to the present version, but may differ in detail to
+     address new problems or concerns.
+
+     Each version is given a distinguishing version number. If the Program
+     specifies a version number of this License which applies to it and "any
+     later version", you have the option of following the terms and
+     conditions either of that version or of any later version published by
+     the Free Software Foundation. If the Program does not specify a version
+     number of this License, you may choose any version ever published by
+     the Free Software Foundation.
+ 11. If you wish to incorporate parts of the Program into other free
+     programs whose distribution conditions are different, write to the
+     author to ask for permission. For software which is copyrighted by the
+     Free Software Foundation, write to the Free Software Foundation; we
+     sometimes make exceptions for this. Our decision will be guided by the
+     two goals of preserving the free status of all derivatives of our free
+     software and of promoting the sharing and reuse of software generally.
+
+NO WARRANTY
+
+ 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
+     FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
+     OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
+     PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER
+     EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+     WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE
+     ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH
+     YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL
+     NECESSARY SERVICING, REPAIR OR CORRECTION.
+ 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+     WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
+     REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR
+     DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL
+     DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM
+     (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED
+     INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF
+     THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR
+     OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+END OF TERMS AND CONDITIONS
@@ -61,6 +61,7 @@ install:
 	(cd data; make install)
 	(cd doc; make install)
 	(cd fonts; make install)
+	(cd ppd; make install)

 #
 # End of "$Id$".
@@ -4,21 +4,18 @@
 </HEAD>
 <BODY>

-<H1>README - CUPS v1.0b1</H1>
+<H1>README - CUPS v1.0b3</H1>

 <H2>Contents</H2>

 <UL>
 	<LI><A HREF="#intro">Introduction</A>
 	<LI><A HREF="#require">Requirements</A>
-	<LI><A HREF="#compile">Compiling CUPS</A>
-	<LI><A HREF="#config">Configuring the Software</A>
-	<LI><A HREF="#run">Running the Software</A>
-	<LI><A HREF="#use">Using the Software</A>
+	<LI><A HREF="#use">Using CUPS</A>
 	<LI><A HREF="#known">Known Problems</A>
 	<LI><A HREF="#report">Reporting Problems</A>
 	<LI><A HREF="#resources">Other Resources</A>
-	<LI><A HREF="#license">Legal Stuff</A>
+	<LI><A HREF="#legal">Legal Stuff</A>
 </UL>

 <H2><A NAME="intro">Introduction</A></H2>
@@ -58,128 +55,29 @@ nroff-like package.
 <P>The documentation is formatted using the HTMLDOC software (again, not
 needed unless you make changes.)

-<H2><A NAME="compile">Compiling CUPS</A></H2>
+<H2><A NAME="use">Using CUPS</A></H2>

-CUPS uses GNU autoconf to configure the makefiles and source code for your
-system. To configure CUPS for your system type:
+<P>Pre-compiled binary distributions are available for CUPS from our
+web site at
+<A HREF="http://www.cups.org/software.html">http://www.cups.org/software.html</A>.
+If you'd like to build CUPS from the source, please read the Software
+Administrator's Manual.

-<UL><PRE>
-% ./configure ENTER
-</PRE></UL>
-
-The default installation will put the CUPS software in the <CODE>/usr</CODE>
-and <CODE>/var</CODE> directories on your system, which will overwrite any
-existing printing commands on your system. To install the CUPS software in
-another location use the <CODE>--prefix</CODE> option:
-
-<UL><PRE>
-% ./configure --prefix=/usr/local ENTER
-</PRE></UL>
-
-Once you have configured things, just type:
-
-<UL><PRE>
-% make ENTER
-</PRE></UL>
-
-to build the software.
-
-<H2><A NAME="install">Installing the Software</A></H2>
-
-To install the software type:
-
-<UL><PRE>
-% make install ENTER
-</PRE></UL>
-
-<H2><A NAME="config">Configuring the Software</A></H2>
-
-Before you run CUPS for the first time you'll need to edit the CUPS
-configuration files which are normally located in /var/cups/conf.
-
-<UL>
-
-	The <CODE>cupsd.conf</CODE> file configures all of the
-	"global" server settings and access control. The default
-	settings are usually appropriate for most environments.
-
-	<P>The <CODE>printers.conf</CODE> file configures each printer
-	queue. You'll need to add a listing for each printer on your
-	system.
-
-	<P>The <CODE>classes.conf</CODE> file configures each printer
-	class. You'll need to add a listing for each printer class you
-	want.
-
-	<P>The <CODE>mime.types</CODE> file defines all of the
-	recognized file types. You don't normally have to edit this
-	file.
-
-	<P>The <CODE>mime.convs</CODE> file defines all of the file
-	conversion filters. You don't normally have to edit this file.
-
-</UL>
-
-In addition to the files in the /var/cups/conf directory, you'll also need
-to copy PPD files for each printer to the /var/cups/ppd directory.  If you
-don't have a PPD file for your printer, the drivers will still work, just
-with reduced functionality.
-
-<H2><A NAME="run">Running the Software</A></H2>
-
-Once you have configured the software you can start the CUPS daemon by
-typing:
-
-<UL><PRE>
-% /usr/sbin/cupsd &amp; ENTER
-</PRE></UL>
-
-<H2><A NAME="use">Using the Software</A></H2>
-
-Once you have installed the software, you can use the normal lp or lpr
-commands to print jobs. If you installed the software under /usr then
-you shouldn't have to reconfigure any applications to recognize the new
-printing system.
-
-<P>One of the advantages of CUPS is that you don't always have to send
-PostScript or Text files to your printers. If you have a JPEG file, you
-can just type "lp filename.jpg" and CUPS will handle converting it for
-you!
-
-<P>You can monitor the status of jobs via the lpstat command or with your
-web browser by pointing it at "http://localhost:631".
+<P>Once you have installed CUPS, the Software Administrator's Manual and
+Software User's Manual are excellent places to start setting things up.

 <H2><A NAME="known">Known Problems</A></H2>

 The following known problems are being worked on and should be resolved for
-the second beta release of CUPS:
+the fourth beta release of CUPS:

 <UL>

 	<LI>Documentation is not completed.

-	<LI>The lpadmin command is currently not provided.
-
-	<LI>The lpq command is currently not provided.
-
 	<LI>The lpc command currently only supports the help and status
 	commands.

-	<LI>While both GNU GhostScript and the CUPS image RIP are
-	provided, no sample raster printer driver is provided. The
-	final release of CUPS will include a PCL printer driver.
-
-	<LI>Automatic classing is currently not supported.
-
-	<LI>The CUPS server should disable core dumps by filters, backends,
-	and CGI programs.
-
-	<LI>The CUPS server should increase the FD limit to the maximum
-	allowed on the system.
-
-	<LI>The CUPS server should close stdin, stdout, and stderr and
-	run in the background ("daemon" mode...)
-
 	<LI>The class and job CGIs are currently not provided.

 </UL>
@@ -220,9 +118,9 @@ and the Common UNIX Printing System are the trademark property of Easy Software
 Products.

 <P>CUPS is provided under the terms of the
-<A HREF="LICENSE.html">Aladdin Free Public License</A>
+<A HREF="LICENSE.html">GNU General Public License</A>
 which is located in the files "LICENSE.html" and "LICENSE.txt". For commercial
-licensing information, please contact:
+support and "binary-only" licensing information, please contact:

 <UL>
 	Attn: CUPS Licensing Information
@@ -1,19 +1,16 @@
-README - CUPS v1.0b1
+README - CUPS v1.0b3

-CONTENTS
+Contents

   * Introduction
   * Requirements
-   * Compiling CUPS
-   * Configuring the Software
-   * Running the Software
-   * Using the Software
+   * Using CUPS
   * Known Problems
   * Reporting Problems
   * Other Resources
   * Legal Stuff

-INTRODUCTION
+Introduction

 The Common UNIX Printing System provides a portable printing layer for UNIX®
 operating systems. It has been developed by Easy Software Products to
@@ -33,7 +30,7 @@ CUPS also includes a customized version of GNU GhostScript (currently based
 off GNU GhostScript 4.03) and an image file RIP that can be used to support
 non-PostScript printers.

-REQUIREMENTS
+Requirements

 You'll need an ANSI C compiler to build CUPS on your system. As its name
 implies, CUPS is designed to run on the UNIX operating system, however the
@@ -49,98 +46,22 @@ nroff-like package.
 The documentation is formatted using the HTMLDOC software (again, not needed
 unless you make changes.)

-COMPILING CUPS
+Using CUPS

-CUPS uses GNU autoconf to configure the makefiles and source code for your
-system. To configure CUPS for your system type:
+Pre-compiled binary distributions are available for CUPS from our web site
+at http://www.cups.org/software.html. If you'd like to build CUPS from the
+source, please read the Software Administrator's Manual.

-     % ./configure ENTER
+Once you have installed CUPS, the Software Administrator's Manual and
+Software User's Manual are excellent places to start setting things up.

-The default installation will put the CUPS software in the /usr and /var
-directories on your system, which will overwrite any existing printing
-commands on your system. To install the CUPS software in another location
-use the --prefix option:
-
-     % ./configure --prefix=/usr/local ENTER
-
-Once you have configured things, just type:
-
-     % make ENTER
-
-to build the software.
-
-INSTALLING THE SOFTWARE
-
-To install the software type:
-
-     % make install ENTER
-
-CONFIGURING THE SOFTWARE
-
-Before you run CUPS for the first time you'll need to edit the CUPS
-configuration files which are normally located in /var/cups/conf.
-
-     The cupsd.conf file configures all of the "global" server settings and
-     access control. The default settings are usually appropriate for most
-     environments.
-
-     The printers.conf file configures each printer queue. You'll need to
-     add a listing for each printer on your system.
-
-     The classes.conf file configures each printer class. You'll need to add
-     a listing for each printer class you want.
-
-     The mime.types file defines all of the recognized file types. You don't
-     normally have to edit this file.
-
-     The mime.convs file defines all of the file conversion filters. You
-     don't normally have to edit this file.
-
-In addition to the files in the /var/cups/conf directory, you'll also need
-to copy PPD files for each printer to the /var/cups/ppd directory. If you
-don't have a PPD file for your printer, the drivers will still work, just
-with reduced functionality.
-
-RUNNING THE SOFTWARE
-
-Once you have configured the software you can start the CUPS daemon by
-typing:
-
-     % /usr/sbin/cupsd & ENTER
-
-USING THE SOFTWARE
-
-Once you have installed the software, you can use the normal lp or lpr
-commands to print jobs. If you installed the software under /usr then you
-shouldn't have to reconfigure any applications to recognize the new printing
-system.
-
-One of the advantages of CUPS is that you don't always have to send
-PostScript or Text files to your printers. If you have a JPEG file, you can
-just type "lp filename.jpg" and CUPS will handle converting it for you!
-
-You can monitor the status of jobs via the lpstat command or with your web
-browser by pointing it at "http://localhost:631".
-
-KNOWN PROBLEMS
+Known Problems

 The following known problems are being worked on and should be resolved for
-the second beta release of CUPS:
+the fourth beta release of CUPS:

   * Documentation is not completed.
-   * The lpadmin command is currently not provided.
-   * The lpq command is currently not provided.
   * The lpc command currently only supports the help and status commands.
-   * While both GNU GhostScript and the CUPS image RIP are provided, no
-     sample raster printer driver is provided. The final release of CUPS
-     will include a PCL printer driver.
-   * Automatic classing is currently not supported.
-   * The CUPS server should disable core dumps by filters, backends, and CGI
-     programs.
-   * The CUPS server should increase the FD limit to the maximum allowed on
-     the system.
-   * The CUPS server should close stdin, stdout, and stderr and run in the
-     background ("daemon" mode...)
   * The class and job CGIs are currently not provided.

 CUPS has been built and tested on the following operating systems:
@@ -154,13 +75,13 @@ CUPS has been built and tested on the following operating systems:
 The client libraries and filters have been successfully compiled under
 Microsoft Windows using Visual C++ 6.0.

-REPORTING PROBLEMS
+Reporting Problems

 If you have problems, please send an email to cups-support@cups.org. Include
 your operating system and version, compiler and version, and any errors or
 problems you've run into.

-OTHER RESOURCES
+Other Resources

 See the CUPS web site at "http://www.cups.org" for other site links.

@@ -169,15 +90,15 @@ You can subscribe to the CUPS mailing list by sending a message containing
 problems, questions, and improvements to the CUPS software. New releases of
 CUPS are announced to this list as well.

-LEGAL STUFF
+Legal Stuff

 CUPS is Copyright 1993-1999 by Easy Software Products. CUPS, the CUPS logo,
 and the Common UNIX Printing System are the trademark property of Easy
 Software Products.

-CUPS is provided under the terms of the Aladdin Free Public License which is
+CUPS is provided under the terms of the GNU General Public License which is
 located in the files "LICENSE.html" and "LICENSE.txt". For commercial
-licensing information, please contact:
+support and "binary-only" licensing information, please contact:

     Attn: CUPS Licensing Information
     Easy Software Products
@@ -24,8 +24,8 @@

 include ../Makedefs

-TARGETS	=	lpc lpr lprm
-OBJS	=	lpc.o lpr.o lprm.o
+TARGETS	=	lpc lpq lpr lprm
+OBJS	=	lpc.o lpq.o lpr.o lprm.o

 #
 # Make all targets...
@@ -59,6 +59,15 @@ lpc:	lpc.o ../cups/libcups.a

 lpc.o:	../cups/cups.h ../Makedefs

+#
+# lpq
+#
+
+lpq:	lpq.o ../cups/libcups.a
+	$(CC) $(LDFLAGS) -o lpq lpq.o $(LIBS)
+
+lpq.o:	../cups/cups.h ../Makedefs
+
 #
 # lpr
 #
@@ -225,7 +225,7 @@ show_status(http_t *http,	/* I - HTTP connection to server */
 				/* Printer URI */


-  DEBUG_printf(("show_printers(%08x, %08x)\n", http, dests));
+  DEBUG_printf(("show_status(%08x, %08x)\n", http, dests));

  if (http == NULL)
    return;
@@ -257,7 +257,7 @@ show_status(http_t *http,	/* I - HTTP connection to server */

  if ((response = cupsDoRequest(http, request, "/printers/")) != NULL)
  {
-    DEBUG_puts("show_printers: request succeeded...");
+    DEBUG_puts("show_status: request succeeded...");

   /*
    * Loop through the printers returned in the list and display
@@ -397,15 +397,15 @@ show_status(http_t *http,	/* I - HTTP connection to server */

 	  language = cupsLangDefault();

-	  attr = ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_CHARSET,
-                	      "attributes-charset", NULL,
-			      cupsLangEncoding(language));
+	  ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_CHARSET,
+                       "attributes-charset", NULL,
+		       cupsLangEncoding(language));

-	  attr = ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_LANGUAGE,
-                	      "attributes-natural-language", NULL,
-			      language->language);
+	  ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_LANGUAGE,
+                       "attributes-natural-language", NULL,
+		       language->language);

-          sprintf(printer_uri, "http://localhost/printers/%s", printer);
+          sprintf(printer_uri, "ipp://localhost/printers/%s", printer);
 	  attr = ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_URI,
 	                      "printer-uri", NULL, printer_uri);

@@ -0,0 +1,366 @@
+/*
+ * "$Id$"
+ *
+ *   "lpq" command for the Common UNIX Printing System (CUPS).
+ *
+ *   Copyright 1997-1999 by Easy Software Products.
+ *
+ *   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-3111 USA
+ *
+ *       Voice: (301) 373-9603
+ *       EMail: cups-info@cups.org
+ *         WWW: http://www.cups.org
+ *
+ * Contents:
+ *
+ */
+
+/*
+ * Include necessary headers...
+ */
+
+/*
+ * Include necessary headers...
+ */
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <ctype.h>
+#include <cups/cups.h>
+#include <cups/language.h>
+#include <cups/debug.h>
+
+
+/*
+ * Local functions...
+ */
+
+static int	show_jobs(http_t *, char *, char *, int, int);
+
+
+/*
+ * 'main()' - Parse options and commands.
+ */
+
+int
+main(int  argc,		/* I - Number of command-line arguments */
+     char *argv[])	/* I - Command-line arguments */
+{
+  int		i;		/* Looping var */
+  http_t	*http;		/* Connection to server */
+  char		*dest,		/* Desired printer */
+		*user;		/* Desired user */
+  int		id,		/* Desired job ID */
+		interval,	/* Reporting interval */
+		longstatus;	/* Show file details */
+
+ /*
+  * Connect to the scheduler...
+  */
+
+  http = httpConnect("localhost", ippPort());
+
+ /*
+  * Check for command-line options...
+  */
+
+  dest       = NULL;
+  user       = NULL;
+  id         = 0;
+  interval   = 0;
+  longstatus = 0;
+
+  for (i = 1; i < argc; i ++)
+    if (argv[i][0] == '+')
+      interval = atoi(argv[i] + 1);
+    else if (argv[i][0] == '-')
+    {
+      switch (argv[i][1])
+      {
+        case 'P' : /* Printer */
+	    if (argv[i][2])
+	      dest = argv[i] + 2;
+	    else
+	    {
+	      i ++;
+	      dest = argv[i];
+	    }
+	    break;
+
+	case 'l' : /* Long status */
+	    longstatus = 1;
+	    break;
+
+	default :
+	    fputs("Usage: lpq [-P dest] [-l] [+interval]\n", stderr);
+	    return (1);
+      }
+    }
+    else if (isdigit(argv[i][0]))
+      id = atoi(argv[i]);
+    else
+      user = argv[i];
+
+ /*
+  * Show the status in a loop...
+  */
+
+  for (;;)
+  {
+    i = show_jobs(http, dest, user, id, longstatus);
+
+    if (i && interval)
+      sleep(interval);
+    else
+      break;
+  }
+
+ /*
+  * Close the connection to the server and return...
+  */
+
+  httpClose(http);
+
+  return (0);
+}
+
+
+/*
+ * 'show_jobs()' - Show printers.
+ */
+
+static int			/* O - Number of jobs in queue */
+show_jobs(http_t *http,		/* I - HTTP connection to server */
+          char   *dest,		/* I - Destination */
+	  char   *user,		/* I - User */
+	  int    id,		/* I - Job ID */
+	  int    longstatus)	/* I - 1 if long report desired */
+{
+  ipp_t		*request,	/* IPP Request */
+		*response;	/* IPP Response */
+  ipp_attribute_t *attr;	/* Current attribute */
+  cups_lang_t	*language;	/* Default language */
+  char		*jobdest,	/* Pointer into job-printer-uri */
+		*jobuser,	/* Pointer to job-originating-user-name */
+		*jobname;	/* Pointer to job-name */
+  ipp_jstate_t	jobstate;	/* job-state */
+  int		jobid,		/* job-id */
+		jobsize,	/* job-k-octets */
+		jobpriority,	/* job-priority */
+		jobcount,	/* Number of jobs */
+		rank;		/* Rank of job */
+  char		resource[1024];	/* Resource string */
+  static char	*ranks[10] =	/* Ranking strings */
+		{
+		  "th",
+		  "st",
+		  "nd",
+		  "rd",
+		  "th",
+		  "th",
+		  "th",
+		  "th",
+		  "th",
+		  "th"
+		};
+
+
+  DEBUG_printf(("show_jobs(%08x, %08x, %08x, %d, %d)\n", http, dest, user, id,
+                longstatus));
+
+  if (http == NULL)
+    return (0);
+
+ /*
+  * Build an IPP_GET_JOBS or IPP_GET_JOB_ATTRIBUTES request, which requires
+  * the following attributes:
+  *
+  *    attributes-charset
+  *    attributes-natural-language
+  *    job-uri or printer-uri
+  *    [
+  */
+
+  request = ippNew();
+
+  request->request.op.operation_id = id ? IPP_GET_JOB_ATTRIBUTES : IPP_GET_JOBS;
+  request->request.op.request_id   = 1;
+
+  language = cupsLangDefault();
+
+  attr = ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_CHARSET,
+                      "attributes-charset", NULL, cupsLangEncoding(language));
+
+  attr = ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_LANGUAGE,
+                      "attributes-natural-language", NULL, language->language);
+
+  if (dest == NULL)
+  {
+    if (id)
+      sprintf(resource, "ipp://localhost/jobs/%d", id);
+    else
+      strcpy(resource, "ipp://localhost/jobs");
+
+    ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_URI, "job-uri",
+                 NULL, resource);
+  }
+  else
+  {
+    sprintf(resource, "ipp://localhost/printers/%s", dest);
+
+    ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_URI, "job-uri",
+                 NULL, resource);
+  }
+
+  if (user)
+  {
+    ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_NAME,
+                 "requesting-user-name", NULL, user);
+    ippAddBoolean(request, IPP_TAG_OPERATION, "my-jobs", 1);
+  }
+
+ /*
+  * Do the request and get back a response...
+  */
+
+  if (!longstatus)
+    puts("Rank\tPri   Owner  Job    Files              Total Size");
+
+  jobcount = 0;
+
+  if ((response = cupsDoRequest(http, request, "/jobs/")) != NULL)
+  {
+    rank = 1;
+
+   /*
+    * Loop through the job list and display them...
+    */
+
+    for (attr = response->attrs; attr != NULL; attr = attr->next)
+    {
+     /*
+      * Skip leading attributes until we hit a job...
+      */
+
+      while (attr != NULL && attr->group_tag != IPP_TAG_JOB)
+        attr = attr->next;
+
+      if (attr == NULL)
+        break;
+
+     /*
+      * Pull the needed attributes from this job...
+      */
+
+      jobid       = 0;
+      jobsize     = 0;
+      jobpriority = 50;
+      jobstate    = IPP_JOB_PENDING;
+      jobname     = "untitled";
+      jobuser     = NULL;
+      jobdest     = NULL;
+
+      while (attr != NULL && attr->group_tag == IPP_TAG_JOB)
+      {
+        if (strcmp(attr->name, "job-id") == 0 &&
+	    attr->value_tag == IPP_TAG_INTEGER)
+	  jobid = attr->values[0].integer;
+
+        if (strcmp(attr->name, "job-k-octets") == 0 &&
+	    attr->value_tag == IPP_TAG_INTEGER)
+	  jobsize = attr->values[0].integer * 1024;
+
+        if (strcmp(attr->name, "job-priority") == 0 &&
+	    attr->value_tag == IPP_TAG_INTEGER)
+	  jobpriority = attr->values[0].integer;
+
+        if (strcmp(attr->name, "job-state") == 0 &&
+	    attr->value_tag == IPP_TAG_ENUM)
+	  jobstate = (ipp_jstate_t)attr->values[0].integer;
+
+        if (strcmp(attr->name, "job-printer-uri") == 0 &&
+	    attr->value_tag == IPP_TAG_URI)
+	  if ((jobdest = strrchr(attr->values[0].string.text, '/')) != NULL)
+	    jobdest ++;
+
+        if (strcmp(attr->name, "job-originating-user-name") == 0 &&
+	    attr->value_tag == IPP_TAG_NAME)
+	  jobuser = attr->values[0].string.text;
+
+        if (strcmp(attr->name, "job-name") == 0 &&
+	    attr->value_tag == IPP_TAG_NAME)
+	  jobname = attr->values[0].string.text;
+
+        attr = attr->next;
+      }
+
+     /*
+      * See if we have everything needed...
+      */
+
+      if (jobdest == NULL || jobid == 0)
+      {
+        if (attr == NULL)
+	  break;
+	else
+          continue;
+      }
+
+      jobcount ++;
+
+     /*
+      * Display the job...
+      */
+
+      if (longstatus)
+      {
+        puts("");
+
+        if (jobstate == IPP_JOB_PROCESSING)
+	  printf("%s: active\t\t\t\t ", jobuser);
+	else
+	{
+	  printf("%s: %d%s\t\t\t\t ", jobuser, rank, ranks[rank % 10]);
+	  rank ++;
+	}
+
+        printf("[job %03dlocalhost]\n", jobid);
+        printf("\t%-33s%d bytes\n", jobname, jobsize);
+      }
+      else
+      {
+        if (jobstate == IPP_JOB_PROCESSING)
+	  printf("active\t");
+	else
+	{
+	  printf("%d%s\t", rank, ranks[rank % 10]);
+	  rank ++;
+	}
+
+        printf(" %-5d%-7.7s%-7d%-19s%d bytes\n", jobpriority, jobuser, jobid,
+	       jobname, jobsize);
+      }
+      if (attr == NULL)
+        break;
+    }
+
+    ippDelete(response);
+  }
+
+  return (jobcount);
+}
+
+
+/*
+ * End of "$Id$".
+ */
@@ -146,7 +146,7 @@ main(int  argc,			/* I - Number of command-line arguments */

      if (dest)
      {
-        sprintf(uri, "http://localhost/printers/%s", dest);
+        sprintf(uri, "ipp://localhost/printers/%s", dest);
 	ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_URI,
 	             "printer-uri", NULL, uri);
 	ippAddInteger(request, IPP_TAG_OPERATION, IPP_TAG_INTEGER, "job-id",
@@ -154,7 +154,7 @@ main(int  argc,			/* I - Number of command-line arguments */
      }
      else
      {
-        sprintf(uri, "http://localhost/jobs/%d", job_id);
+        sprintf(uri, "ipp://localhost/jobs/%d", job_id);
 	ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_URI, "job-uri", NULL,
 	             uri);
      }
@@ -46,6 +46,8 @@ clean:
 #

 install:
+	-$(MKDIR) $(SERVERROOT)/cgi-bin
+	$(CP) $(TARGETS) $(SERVERROOT)/cgi-bin

 #
 # printers.cgi
@@ -54,7 +54,7 @@ install:
 		else \
 			$(CP) $$file $(SERVERROOT)/conf ; \
 		fi ; \
-	end
+	done

 #
 # End of "$Id$".
@@ -1,5 +1,5 @@
 #
-# "$Id: classes.conf 320 1999-05-13 20:40:14Z mike $"
+# "$Id: classes.conf 333 1999-05-17 18:03:40Z mike $"
 #
 #   Sample class configuration file for the Common UNIX Printing System
 #   (CUPS) scheduler.
@@ -40,33 +40,33 @@
 # the default.
 #

-<Class sample>
+#<Class sample>
 #
 # Info: the description for the class.
 #

-Info Acme LaserPrint 1000 Printers
+#Info Acme LaserPrint 1000 Printers

 #
 # MoreInfo: a URL for more information on the printer.
 #

-MoreInfo http://www.acme.com/lp1000.html
+#MoreInfo http://www.acme.com/lp1000.html

 #
 # Location: the location of the printer.
 #

-Location Room 101 in the activities building
+#Location Room 101 in the activities building

 #
 # Printer: adds a printer to the class.
 #

-Printer sample@host1
-Printer sample@host2
-</Class>
+#Printer sample
+#Printer sample@host2
+#</Class>

 #
-# End of "$Id: classes.conf 320 1999-05-13 20:40:14Z mike $".
+# End of "$Id: classes.conf 333 1999-05-17 18:03:40Z mike $".
 #
@@ -1,5 +1,5 @@
 #
-# "$Id: cupsd.conf 327 1999-05-14 17:03:06Z mike $"
+# "$Id: cupsd.conf 349 1999-05-21 20:53:02Z mike $"
 #
 #   Sample configuration file for the Common UNIX Printing System (CUPS)
 #   scheduler.
@@ -92,7 +92,7 @@ SystemGroup sys
 # By default the compiled-in value.
 #

-#ServerRoot /var/spool/cups
+#ServerRoot /var/cups

 #
 # AccessLog: the access log file; if this does not start with a leading /
@@ -110,6 +110,14 @@ SystemGroup sys

 #ErrorLog logs/error_log

+#
+# PageLog: the page log file; if this does not start with a leading /
+# then it is assumed to be relative to ServerRoot.  By default set to
+# "logs/page_log"
+#
+
+#PageLog logs/page_log
+
 #
 # LogLevel: controls the number of messages logged to the ErrorLog
 # file and can be one of the following:
@@ -121,21 +129,21 @@ SystemGroup sys
 #     none      Log nothing.
 #

-LogLevel warn
+LogLevel info

 #
 # MaxLogSize: controls the maximum size of each log file before they are
 # rotated.  Defaults to 1048576 (1MB).  Set to 0 to disable log rotating.
 #

-#MaxLogSize: 0
+#MaxLogSize 0

 #
 # MaxRequestSize: controls the maximum size of print files.  Set to 0 to
 # disable this feature (defaults to 0.)
 #

-#MaxRequestSize: 0
+#MaxRequestSize 0

 #
 # HostNameLookups: whether or not to do lookups on IP addresses to get a
@@ -269,7 +277,7 @@ LogLevel warn
 # supported.
 #
 # AuthClass: the authorization class; currently only "Anonymous", "User",
-# "System" (valid user belonging to group SystemGroupName), and "Group"
+# "System" (valid user belonging to group SystemGroup), and "Group"
 # (valid user belonging to the specified group) are supported.
 #
 # AuthGroupName: the group name for "Group" authorization.
@@ -320,5 +328,5 @@ Allow From 127.0.0.1
 </Location>

 #
-# End of "$Id: cupsd.conf 327 1999-05-14 17:03:06Z mike $".
+# End of "$Id: cupsd.conf 349 1999-05-21 20:53:02Z mike $".
 #
@@ -1,5 +1,5 @@
 #
-# "$Id: printers.conf 320 1999-05-13 20:40:14Z mike $"
+# "$Id: printers.conf 334 1999-05-17 18:11:26Z mike $"
 #
 #   Sample printer configuration file for the Common UNIX Printing System
 #   (CUPS) scheduler.
@@ -40,24 +40,24 @@
 # default.
 #

-<Printer sample>
+#<Printer sample>
 #
 # Info: the description for the printer.
 #

-Info Acme LaserPrint 1000
+#Info Acme LaserPrint 1000

 #
 # MoreInfo: a URL for more information on the printer.
 #

-MoreInfo http://www.acme.com/lp1000.html
+#MoreInfo http://www.acme.com/lp1000.html

 #
 # Location: the location of the printer.
 #

-Location Room 101 in the activities building
+#Location Room 101 in the activities building

 #
 # DeviceURI: the device URI for this printer.
@@ -73,18 +73,6 @@ Location Room 101 in the activities building
 #DeviceURI ipp://hostname/path
 #DeviceURI smb://hostname/printer

-#
-# AddFilter: adds a filter for this printer.  Format is:
-#
-#    AddFilter from-type cost program
-#
-# Filter programs must accept the standard filter options outlined in
-# the CUPS documentation.  A filter program of "-" means that the
-# two types are equivalent.
-#
-
-AddFilter application/cups-postscript 0 -
-
 #
 # State: sets the initial state of the printer.  Can be one of the
 # following:
@@ -93,9 +81,9 @@ AddFilter application/cups-postscript 0 -
 #     Stopped - Printer is disabled but accepting new jobs.
 #

-State Idle
-</Printer>
+#State Idle
+#</Printer>

 #
-# End of "$Id: printers.conf 320 1999-05-13 20:40:14Z mike $".
+# End of "$Id: printers.conf 334 1999-05-17 18:11:26Z mike $".
 #
@@ -68,6 +68,12 @@

 #undef HAVE_SHADOW_H

+/*
+ * Do we have <crypt.h>?
+ */
+
+#undef HAVE_CRYPT_H
+
 /*
 * Do we have the strXXX() functions?
 */
@@ -29,14 +29,27 @@ AC_PREFIX_DEFAULT(/usr)
 dnl Clear default debugging options and set normal optimization by
 dnl default unless the user asks for debugging specifically.

+dnl CFLAGS="${CFLAGS:=}"
+dnl CXXFLAGS="${CXXFLAGS:=}"
+dnl OPTIM="-O"
+dnl AC_SUBST(OPTIM)
+
+dnl AC_ARG_ENABLE(debug, [  --enable-debug          turn on debugging [default=no]],
+dnl if eval "test x$enable_debug = xyes"; then
+dnl 	OPTIM="-g"
+dnl fi)
+
+dnl Clear default debugging options and set debugging by
+dnl default unless the user asks for no debugging specifically.
+
 CFLAGS="${CFLAGS:=}"
 CXXFLAGS="${CXXFLAGS:=}"
-OPTIM="-O"
+OPTIM="-g"
 AC_SUBST(OPTIM)

-AC_ARG_ENABLE(debug, [  --enable-debug          turn on debugging [default=no]],
-if eval "test x$enable_debug = xyes"; then
-	OPTIM="-g"
+AC_ARG_ENABLE(debug, [  --disable-debug          turn off debugging [default=no]],
+if eval "test x$disable_debug = xyes"; then
+	OPTIM="-O"
 fi)

 dnl Checks for programs...
@@ -60,6 +73,7 @@ fi

 dnl Check for libraries...
 AC_CHECK_LIB(c,crypt,LIBS="$LIBS",AC_CHECK_LIB(crypt,crypt))
+AC_CHECK_HEADER(crypt.h, AC_DEFINE(HAVE_CRYPT_H))
 AC_CHECK_LIB(sec,getspent)
 AC_CHECK_LIB(socket,socket,
 if test "$uname" != "IRIX"; then
@@ -76,22 +90,18 @@ fi)

 IMGLIBS=""
 AC_SUBST(IMGLIBS)
-AC_CHECK_LIB(jpeg,jpeg_destroy_decompress,
-    AC_CHECK_HEADER(jpeglib.h,
-        AC_DEFINE(HAVE_LIBJPEG)
-        IMGLIBS="$IMGLIBS -ljpeg"))
-AC_CHECK_LIB(png,png_read_info,
-    AC_CHECK_HEADER(png.h,
-        AC_DEFINE(HAVE_LIBPNG)
-        IMGLIBS="$IMGLIBS -lpng"))
-AC_CHECK_LIB(tiff,TIFFGetField,
-    AC_CHECK_HEADER(tiff.h,
-        AC_DEFINE(HAVE_LIBTIFF)
-        IMGLIBS="$IMGLIBS -ltiff"))
-AC_CHECK_LIB(z,deflate,
-    AC_CHECK_HEADER(zlib.h,
-        AC_DEFINE(HAVE_LIBZ)
-        IMGLIBS="$IMGLIBS -lz"))
+AC_CHECK_HEADER(jpeglib.h,
+    AC_DEFINE(HAVE_LIBJPEG)
+    IMGLIBS="$IMGLIBS -ljpeg")
+AC_CHECK_HEADER(zlib.h,
+    AC_DEFINE(HAVE_LIBZ)
+    IMGLIBS="$IMGLIBS -lz")
+AC_CHECK_HEADER(png.h,
+    AC_DEFINE(HAVE_LIBPNG)
+    IMGLIBS="$IMGLIBS -lpng")
+AC_CHECK_HEADER(tiff.h,
+    AC_DEFINE(HAVE_LIBTIFF)
+    IMGLIBS="$IMGLIBS -ltiff")

 dnl Checks for header files.
 AC_HEADER_STDC
@@ -105,8 +105,9 @@ typedef struct				/**** Printer Options ****/
 */

 extern int		cupsCancelJob(char *printer, int job);
-extern ipp_t		*cupsDoRequest(http_t *http, ipp_t *request,
-			               char *resource);
+#define			cupsDoRequest(http,request,resource) cupsDoFileRequest((http),(request),(resource),NULL)
+extern ipp_t		*cupsDoFileRequest(http_t *http, ipp_t *request,
+			                   char *resource, char *filename);
 extern int		cupsGetClasses(char ***classes);
 extern char		*cupsGetPPD(char *printer);
 extern char		*cupsGetDefault(void);
@@ -27,38 +27,6 @@
 *   mimeFilter()    - Find the fastest way to convert from one type to another.
 *   compare()       - Compare two filter types...
 *   lookup()        - Lookup a filter...
- *
- * Revision History:
- *
- *   $Log: filter.c,v $
- *   Revision 1.6  1999/04/21 14:49:49  mike
- *   cupsDoRequest() needed to retry requests when doing authorization.
- *
- *   mimeFilter() didn't always return the least-cost filter.
- *
- *   Revision 1.5  1999/03/01 20:51:51  mike
- *   Code cleanup - removed extraneous semi-colons...
- *
- *   Revision 1.4  1999/02/05 17:40:51  mike
- *   Added IPP client read/write code.
- *
- *   Added string functions missing from some UNIXs.
- *
- *   Added option parsing functions.
- *
- *   Added IPP convenience functions (not implemented yet).
- *
- *   Updated source files to use local string.h as needed (for
- *   missing string functions)
- *
- *   Revision 1.3  1999/01/24 14:18:43  mike
- *   Check-in prior to CVS use.
- *
- *   Revision 1.2  1998/08/06 14:38:38  mike
- *   Finished coding and testing for CUPS 1.0.
- *
- *   Revision 1.1  1998/06/11 20:50:53  mike
- *   Initial revision
 */

 /*
@@ -165,12 +133,6 @@ mimeAddFilter(mime_t      *mime,	/* I - MIME database */

 /*
 * 'mimeFilter()' - Find the fastest way to convert from one type to another.
- *
- * NOTE: Currently we do not use the "cost" field provided with each filter.
- *       This will be addressed in a future version of this function.  For
- *       now all filters are assumed to be equally costly and we find the
- *       smallest number of filters to run that satisfies the filter
- *       requirements.
 */

 mime_filter_t *				/* O - Array of filters to run */
@@ -179,9 +141,11 @@ mimeFilter(mime_t      *mime,		/* I - MIME database */
 	   mime_type_t *dst,		/* I - Destination file type */
           int         *num_filters)	/* O - Number of filters to run */
 {
-  int		i;			/* Looping var */
-  int		num_temp,		/* Number of temporary filters */
-		num_mintemp;		/* Current minimum */
+  int		i, j,			/* Looping vars */
+		num_temp,		/* Number of temporary filters */
+		num_mintemp,		/* Number of filters in the minimum */
+		cost,			/* Current cost */
+		mincost;		/* Current minimum */
  mime_filter_t	*temp,			/* Temporary filter */
 		*mintemp,		/* Current minimum */
 		*mincurrent,		/* Current filter for minimum */
@@ -220,8 +184,8 @@ mimeFilter(mime_t      *mime,		/* I - MIME database */
  * OK, now look for filters from the source type to any other type...
  */

-  num_mintemp = 100000;
-  mintemp     = NULL;
+  mincost = 9999999;
+  mintemp = NULL;

  for (i = mime->num_filters, current = mime->filters; i > 0; i --, current ++)
    if (current->src == src)
@@ -239,13 +203,17 @@ mimeFilter(mime_t      *mime,		/* I - MIME database */
      * any...)
      */

-      if (num_temp < num_mintemp)
+      for (j = 0, cost = 0; j < num_temp; j ++)
+        cost += temp->cost;
+
+      if (cost < mincost)
      {
        if (mintemp != NULL)
 	  free(mintemp);

-	num_mintemp = num_temp;
+	mincost     = cost;
 	mintemp     = temp;
+	num_mintemp = num_temp;
 	mincurrent  = current;
      }
      else
@@ -768,7 +768,6 @@ httpWrite(http_t *http,			/* I - HTTP data */
    bytes = send(http->fd, buffer, length, 0);
    if (bytes < 0)
    {
-      perror("httpWrite");
      DEBUG_puts("httpWrite: error writing data...\n");
      return (-1);
    }
@@ -191,7 +191,8 @@ typedef enum			/**** IPP operations... ****/
  CUPS_ADD_CLASS,
  CUPS_DELETE_CLASS,
  CUPS_ACCEPT_JOBS,
-  CUPS_REJECT_JOBS
+  CUPS_REJECT_JOBS,
+  CUPS_SET_DEFAULT
 } ipp_op_t;

 typedef enum			/**** IPP status codes... ****/
@@ -59,9 +59,10 @@ static void	ppd_default(ppd_option_t *o);
 int				/* O - Number of conflicts found */
 ppdConflicts(ppd_file_t *ppd)	/* I - PPD to check */
 {
-  int		i, j,		/* Looping variables */
+  int		i, j, k,	/* Looping variables */
 		conflicts;	/* Number of conflicts */
  ppd_const_t	*c;		/* Current constraint */
+  ppd_group_t	*g, *sg;	/* Groups */
  ppd_option_t	*o1, *o2;	/* Options */
  ppd_choice_t	*c1, *c2;	/* Choices */

@@ -69,8 +70,22 @@ ppdConflicts(ppd_file_t *ppd)	/* I - PPD to check */
  if (ppd == NULL)
    return (0);

+ /*
+  * Clear all conflicts...
+  */
+
  conflicts = 0;

+  for (i = ppd->num_groups, g = ppd->groups; i > 0; i --, g ++)
+  {
+    for (j = g->num_options, o1 = g->options; j > 0; j --, o1 ++)
+      o1->conflicted = 0;
+
+    for (j = g->num_subgroups, sg = g->subgroups; j > 0; j --, sg ++)
+      for (k = sg->num_options, o1 = sg->options; k > 0; k --, o1 ++)
+        o1->conflicted = 0;
+  }
+
 /*
  * Loop through all of the UI constraints and flag any options
  * that conflict...
@@ -149,11 +164,6 @@ ppdConflicts(ppd_file_t *ppd)	/* I - PPD to check */
      o1->conflicted = 1;
      o2->conflicted = 1;
    }
-    else
-    {
-      o1->conflicted = 0;
-      o2->conflicted = 0;
-    }
  }

 /*
@@ -279,28 +279,18 @@ cupsMarkOptions(ppd_file_t    *ppd,		/* I - PPD file */
 {
  int	i;					/* Looping var */
  int	conflict;				/* Option conflicts */
-  char	media_size[64];				/* Updated media size */


  conflict = 0;

  for (i = num_options; i > 0; i --, options ++)
-    if (strcmp(options->name, "media-size") == 0)
+    if (strcmp(options->name, "media") == 0)
    {
-      strcpy(media_size, options->value);
-
-      if (strncmp(options->value, "us-", 3) == 0)
-      {
-        strcpy(media_size, media_size + 3);
-	media_size[0] = toupper(media_size[0]);
-      }
-      else if (strncmp(options->value, "iso-", 4) == 0)
-      {
-        strcpy(media_size, media_size + 4);
-	media_size[0] = toupper(media_size[0]);
-      }
-
-      if (ppdMarkOption(ppd, "PageSize", media_size))
+      if (ppdMarkOption(ppd, "PageSize", options->value))
+        conflict = 1;
+      if (ppdMarkOption(ppd, "InputSlot", options->value))
+        conflict = 1;
+      if (ppdMarkOption(ppd, "MediaType", options->value))
        conflict = 1;
    }
    else if (strcmp(options->name, "sides") == 0)
@@ -321,6 +311,13 @@ cupsMarkOptions(ppd_file_t    *ppd,		/* I - PPD file */
 	  conflict = 1;
      }
    }
+    else if (strcmp(options->name, "resolution") == 0)
+    {
+      if (ppdMarkOption(ppd, "Resolution", options->value))
+        conflict = 1;
+      if (ppdMarkOption(ppd, "JCLResolution", options->value))
+        conflict = 1;
+    }
    else if (ppdMarkOption(ppd, options->name, options->value))
      conflict = 1;

@@ -40,6 +40,10 @@
 *   ppdOpenFile()     - Read a PPD file into memory.
 *   ppd_read()        - Read a line from a PPD file, skipping comment lines
 *                       as necessary.
+ *   compare_strings() - Compare two strings.
+ *   compare_groups()  - Compare two groups.
+ *   compare_options() - Compare two options.
+ *   compare_choices() - Compare two choices.
 */

 /*
@@ -75,6 +79,10 @@
 * Local functions...
 */

+static int		compare_strings(char *s, char *t);
+static int		compare_groups(ppd_group_t *g0, ppd_group_t *g1);
+static int		compare_options(ppd_option_t *o0, ppd_option_t *o1);
+static int		compare_choices(ppd_choice_t *c0, ppd_choice_t *c1);
 static int		ppd_read(FILE *fp, char *keyword, char *option,
 			         char *text, char **string);
 static void		ppd_decode(char *string);
@@ -408,6 +416,7 @@ ppdOpen(FILE *fp)		/* I - File to read from */
  float		order;		/* Order dependency number */
  ppd_section_t	section;	/* Order dependency section */
  ppd_profile_t	*profile;	/* Pointer to color profile */
+  char		**filter;	/* Pointer to filter */


 /*
@@ -590,6 +599,24 @@ ppdOpen(FILE *fp)		/* I - File to read from */
 	     profile->matrix[2] + 0, profile->matrix[2] + 1,
 	     profile->matrix[2] + 2);
    }
+    else if (strcmp(keyword, "cupsFilter") == 0)
+    {
+      if (ppd->num_filters == 0)
+        filter = malloc(sizeof(char *));
+      else
+        filter = realloc(ppd->filters, sizeof(char *) * (ppd->num_filters + 1));
+
+      ppd->filters     = filter;
+      filter           += ppd->num_filters;
+      ppd->num_filters ++;
+
+     /*
+      * Copy filter string and prevent it from being freed below...
+      */
+
+      *filter = string;
+      string  = NULL;
+    }
    else if (strcmp(keyword, "VariablePaperSize") == 0 &&
             strcmp(string, "True") == 0)
    {
@@ -754,40 +781,36 @@ ppdOpen(FILE *fp)		/* I - File to read from */

      if (subgroup != NULL)
        option = ppd_get_option(subgroup, name);
-      else
+      else if (group == NULL)
      {
+        if (strcmp(name, "Collate") != 0 &&
+            strcmp(name, "Duplex") != 0 &&
+            strcmp(name, "InputSlot") != 0 &&
+            strcmp(name, "ManualFeed") != 0 &&
+            strcmp(name, "MediaType") != 0 &&
+            strcmp(name, "MediaColor") != 0 &&
+            strcmp(name, "MediaWeight") != 0 &&
+            strcmp(name, "OutputBin") != 0 &&
+            strcmp(name, "OutputMode") != 0 &&
+            strcmp(name, "OutputOrder") != 0 &&
+	    strcmp(name, "PageSize") != 0 &&
+            strcmp(name, "PageRegion") != 0)
+	  group = ppd_get_group(ppd, "Extra");
+	else
+	  group = ppd_get_group(ppd, "General");
+
        if (group == NULL)
 	{
-          if (strcmp(name, "Collate") != 0 &&
-              strcmp(name, "Duplex") != 0 &&
-              strcmp(name, "InputSlot") != 0 &&
-              strcmp(name, "ManualFeed") != 0 &&
-              strcmp(name, "MediaType") != 0 &&
-              strcmp(name, "MediaColor") != 0 &&
-              strcmp(name, "MediaWeight") != 0 &&
-              strcmp(name, "OutputBin") != 0 &&
-              strcmp(name, "OutputMode") != 0 &&
-              strcmp(name, "OutputOrder") != 0 &&
-	      strcmp(name, "PageSize") != 0 &&
-              strcmp(name, "PageRegion") != 0)
-	    group = ppd_get_group(ppd, "Printer");
-	  else
-	    group = ppd_get_group(ppd, "General");
-
-          if (group == NULL)
-	  {
-	    ppdClose(ppd);
-	    free(string);
-	    return (NULL);
-	  }
-
-          option = ppd_get_option(group, name);
-	  group  = NULL;
+	  ppdClose(ppd);
+	  free(string);
+	  return (NULL);
 	}
-	else
-          option = ppd_get_option(group, name);
+
+        option = ppd_get_option(group, name);
 	group  = NULL;
      }
+      else
+        option = ppd_get_option(group, name);

      if (option == NULL)
      {
@@ -807,7 +830,19 @@ ppdOpen(FILE *fp)		/* I - File to read from */
      else
        option->ui = PPD_UI_PICKONE;

-      strcpy(option->text, text);
+      if (text[0])
+        strcpy(option->text, text);
+      else
+      {
+        if (strcmp(name, "PageSize") == 0)
+	  strcpy(option->text, "Media Size");
+	else if (strcmp(name, "MediaType") == 0)
+	  strcpy(option->text, "Media Type");
+	else if (strcmp(name, "InputSlot") == 0)
+	  strcpy(option->text, "Media Source");
+        else
+	  strcpy(option->text, name);
+      }

      option->section = PPD_ORDER_ANY;
    }
@@ -884,6 +919,7 @@ ppdOpen(FILE *fp)		/* I - File to read from */
      if (strchr(string, '/') != NULL)	/* Just show human readable text */
        strcpy(string, strchr(string, '/') + 1);

+      ppd_decode(string);
      group = ppd_get_group(ppd, string);
    }
    else if (strcmp(keyword, "CloseGroup") == 0)
@@ -1053,13 +1089,17 @@ ppdOpen(FILE *fp)		/* I - File to read from */

 	    if (constraint->choice1[0] == '*')
 	    {
+	      strcpy(constraint->choice2, constraint->option2);
 	      strcpy(constraint->option2, constraint->choice1 + 1);
              constraint->choice1[0] = '\0';
 	    }
-	    else if (constraint->option2[0] == '*')
-  	      strcpy(constraint->option2, constraint->option2 + 1);
+	    else
+	    {
+	      if (constraint->option2[0] == '*')
+  	        strcpy(constraint->option2, constraint->option2 + 1);

-            constraint->choice2[0] = '\0';
+              constraint->choice2[0] = '\0';
+	    }
 	    break;
 	    
 	case 4 : /* Two options, two choices... */
@@ -1130,24 +1170,48 @@ ppdOpen(FILE *fp)		/* I - File to read from */
  * Set the option back-pointer for each choice...
  */

+  qsort(ppd->groups, ppd->num_groups, sizeof(ppd_group_t),
+        (int (*)(const void *, const void *))compare_groups);
+
  for (i = ppd->num_groups, group = ppd->groups;
       i > 0;
       i --, group ++)
  {
+    qsort(group->options, group->num_options, sizeof(ppd_option_t),
+          (int (*)(const void *, const void *))compare_options);
+
    for (j = group->num_options, option = group->options;
         j > 0;
 	 j --, option ++)
+    {
+      qsort(option->choices, option->num_choices, sizeof(ppd_choice_t),
+            (int (*)(const void *, const void *))compare_choices);
+
      for (k = 0; k < option->num_choices; k ++)
        option->choices[k].option = (void *)option;
+    }
+
+    qsort(group->subgroups, group->num_subgroups, sizeof(ppd_group_t),
+          (int (*)(const void *, const void *))compare_groups);

    for (j = group->num_subgroups, subgroup = group->subgroups;
         j > 0;
 	 j --, subgroup ++)
+    {
+      qsort(subgroup->options, subgroup->num_options, sizeof(ppd_option_t),
+            (int (*)(const void *, const void *))compare_options);
+
      for (k = group->num_options, option = group->options;
           k > 0;
 	   k --, option ++)
+      {
+	qsort(option->choices, option->num_choices, sizeof(ppd_choice_t),
+              (int (*)(const void *, const void *))compare_choices);
+
        for (m = 0; m < option->num_choices; m ++)
          option->choices[m].option = (void *)option;
+      }
+    }
  }

  return (ppd);
@@ -1226,6 +1290,147 @@ ppdOpenFile(char *filename)	/* I - File to read from */
 }


+/*
+ * 'compare_strings()' - Compare two strings.
+ */
+
+int				/* O - Result of comparison */
+compare_strings(char *s,	/* I - First string */
+                char *t)	/* I - Second string */
+{
+  int	diff,			/* Difference between digits */
+	digits;			/* Number of digits */
+
+
+ /*
+  * Loop through both strings, returning only when a difference is
+  * seen.  Also, compare whole numbers rather than just characters, too!
+  */
+
+  while (*s && *t)
+  {
+    if (isdigit(*s) && isdigit(*t))
+    {
+     /*
+      * Got a number; start by skipping leading 0's...
+      */
+
+      while (*s == '0')
+        s ++;
+      while (*t == '0')
+        t ++;
+
+     /*
+      * Skip equal digits...
+      */
+
+      while (isdigit(*s) && *s == *t)
+      {
+        s ++;
+	t ++;
+      }
+
+     /*
+      * Bounce out if *s and *t aren't both digits...
+      */
+
+      if (!isdigit(*s) || !isdigit(*t))
+        continue;     
+
+      if (*s < *t)
+        diff = -1;
+      else
+        diff = 1;
+
+     /*
+      * Figure out how many more digits there are...
+      */
+
+      digits = 0;
+
+      while (isdigit(*s))
+      {
+        digits ++;
+	s ++;
+      }
+
+      while (isdigit(*t))
+      {
+        digits --;
+	t ++;
+      }
+
+     /*
+      * Return if the number or value of the digits is different...
+      */
+
+      if (digits < 0)
+        return (-1);
+      else if (digits > 0)
+        return (1);
+      else
+        return (diff);
+    }
+    else if (tolower(*s) < tolower(*t))
+      return (-1);
+    else if (tolower(*s) > tolower(*t))
+      return (1);
+    else
+    {
+      s ++;
+      t ++;
+    }
+  }
+
+ /*
+  * Return the results of the final comparison...
+  */
+
+  if (*s)
+    return (1);
+  else if (*t)
+    return (-1);
+  else
+    return (0);
+}
+
+
+/*
+ * 'compare_groups()' - Compare two groups.
+ */
+
+static int			/* O - Result of comparison */
+compare_groups(ppd_group_t *g0,	/* I - First group */
+               ppd_group_t *g1)	/* I - Second group */
+{
+  return (compare_strings(g0->text, g1->text));
+}
+
+
+/*
+ * 'compare_options()' - Compare two options.
+ */
+
+static int			/* O - Result of comparison */
+compare_options(ppd_option_t *o0,/* I - First option */
+                ppd_option_t *o1)/* I - Second option */
+{
+  return (compare_strings(o0->text, o1->text));
+}
+
+
+/*
+ * 'compare_choices()' - Compare two choices.
+ */
+
+static int			/* O - Result of comparison */
+compare_choices(ppd_choice_t *c0,/* I - First choice */
+                ppd_choice_t *c1)/* I - Second choice */
+{
+  return (compare_strings(c0->text, c1->text));
+}
+
+
 /*
 * 'ppd_read()' - Read a line from a PPD file, skipping comment lines as
 *                necessary.
@@ -1476,8 +1681,6 @@ ppd_decode(char *string)	/* I - String to decode */
 }


-
-
 /*
 * End of "$Id$".
 */
@@ -194,6 +194,8 @@ typedef struct			/**** Files ****/
  char		**fonts;	/* Pre-loaded fonts */
  int		num_profiles;	/* Number of sRGB color profiles */
  ppd_profile_t	*profiles;	/* sRGB color profiles */
+  int		num_filters;	/* Number of filters */
+  char		**filters;	/* Filter strings... */
 } ppd_file_t;


@@ -129,8 +129,13 @@ typedef enum
  CUPS_CSPACE_CMYK,			/* Cyan, magenta, yellow, black */
  CUPS_CSPACE_YMCK,			/* Yellow, magenta, cyan, black */
  CUPS_CSPACE_KCMY,			/* Black, cyan, magenta, yellow */
-  CUPS_CSPACE_KCMYcm			/* Black, cyan, magenta, yellow, *
+  CUPS_CSPACE_KCMYcm,			/* Black, cyan, magenta, yellow, *
 					 * light-cyan, light-magenta     */
+  CUPS_CSPACE_GMCK,			/* Gold, magenta, yellow, black */
+  CUPS_CSPACE_GMCS,			/* Gold, magenta, yellow, silver */
+  CUPS_CSPACE_WHITE,			/* White ink (as black) */
+  CUPS_CSPACE_GOLD,			/* Gold foil */
+  CUPS_CSPACE_SILVER			/* Silver foil */
 } cups_cspace_t;


@@ -23,14 +23,14 @@
 *
 * Contents:
 *
- *   cupsCancelJob()   - Cancel a print job.
- *   cupsDoRequest()   - Do an IPP request...
- *   cupsGetClasses()  - Get a list of printer classes.
- *   cupsGetDefault()  - Get the default printer or class.
- *   cupsGetPPD()      - Get the PPD file for a printer.
- *   cupsGetPrinters() - Get a list of printers.
- *   cupsPrintFile()   - Print a file to a printer or class.
- *   cups_connect()    - Connect to the specified host...
+ *   cupsCancelJob()     - Cancel a print job.
+ *   cupsDoFileRequest() - Do an IPP request...
+ *   cupsGetClasses()    - Get a list of printer classes.
+ *   cupsGetDefault()    - Get the default printer or class.
+ *   cupsGetPPD()        - Get the PPD file for a printer.
+ *   cupsGetPrinters()   - Get a list of printers.
+ *   cupsPrintFile()     - Print a file to a printer or class.
+ *   cups_connect()      - Connect to the specified host...
 */

 /*
@@ -133,17 +133,22 @@ cupsCancelJob(char *name,	/* I - Name of printer or class */


 /*
- * 'cupsDoRequest()' - Do an IPP request...
+ * 'cupsDoFileRequest()' - Do an IPP request...
 */

-ipp_t *				/* O - Response data */
-cupsDoRequest(http_t *http,	/* I - HTTP connection to server */
-              ipp_t  *request,	/* I - IPP request */
-              char   *resource)	/* I - HTTP resource for POST */
+ipp_t *					/* O - Response data */
+cupsDoFileRequest(http_t *http,		/* I - HTTP connection to server */
+                  ipp_t  *request,	/* I - IPP request */
+                  char   *resource,	/* I - HTTP resource for POST */
+		  char   *filename)	/* I - File to send or NULL */
 {
  ipp_t		*response;	/* IPP response data */
  char		length[255];	/* Content-Length field */
  http_status_t	status;		/* Status of HTTP request */
+  FILE		*file;		/* File to send */
+  struct stat	fileinfo;	/* File information */
+  int		bytes;		/* Number of bytes read/written */
+  char		buffer[8192];	/* Output buffer */
 #if !defined(WIN32) && !defined(__EMX__)
  char		*password,	/* Password string */
 		plain[255],	/* Plaintext username:password */
@@ -154,99 +159,178 @@ cupsDoRequest(http_t *http,	/* I - HTTP connection to server */
 				/* Authorization string */


-  DEBUG_printf(("cupsDoRequest(%08x, %08s, \'%s\')\n", http, request, resource));
+  DEBUG_printf(("cupsDoFileRequest(%08x, %08s, \'%s\', \'%s\')\n",
+                http, request, resource, filename ? filename : "(null)"));

 /*
-  * Setup the HTTP variables needed...
+  * See if we have a file to send...
  */

-  sprintf(length, "%d", ippLength(request));
-  httpClearFields(http);
-  httpSetField(http, HTTP_FIELD_CONTENT_LENGTH, length);
-  httpSetField(http, HTTP_FIELD_CONTENT_TYPE, "application/ipp");
-  httpSetField(http, HTTP_FIELD_AUTHORIZATION, authstring);
-
- /*
-  * Try the request...
-  */
-
-  if (httpPost(http, resource))
-    if (httpPost(http, resource))
+  if (filename != NULL)
+  {
+    if (stat(filename, &fileinfo))
    {
+     /*
+      * Can't get file information!
+      */
+
      ippDelete(request);
      return (NULL);
    }

- /*
-  * Send the IPP data and wait for the response...
-  */
-
-  ippWrite(http, request);
-
-  if ((status = httpUpdate(http)) == HTTP_UNAUTHORIZED)
-  {
-   /*
-    * Flush any error message...
-    */
-
-    httpFlush(http);
-
-#if !defined(WIN32) && !defined(__EMX__)
-    if ((password = getpass("Password:")) != NULL)
+    if ((file = fopen(filename, "rb")) == NULL)
    {
     /*
-      * Got a password; now send it to the server...
+      * Can't open file!
      */

-      sprintf(plain, "%s:%s", cuserid(NULL), password);
-      httpEncode64(encode, plain);
-      sprintf(authstring, "Basic %s", encode);
-
-      httpClearFields(http);
-      httpSetField(http, HTTP_FIELD_CONTENT_LENGTH, length);
-      httpSetField(http, HTTP_FIELD_CONTENT_TYPE, "application/ipp");
-      httpSetField(http, HTTP_FIELD_AUTHORIZATION, authstring);
-
-      if (httpPost(http, resource))
-        httpPost(http, resource);
-      request->state = IPP_IDLE;
-      ippWrite(http, request);
-      status = httpUpdate(http);
+      ippDelete(request);
+      return (NULL);
    }
-#endif /* !WIN32 && !__EMX__ */
  }

-  if (status != HTTP_OK)
+ /*
+  * Loop until we can send the request without authorization problems.
+  */
+
+  response = NULL;
+
+  while (response == NULL)
  {
+    DEBUG_puts("cupsDoFileRequest: setup...");
+
   /*
-    * Flush any error message...
+    * Setup the HTTP variables needed...
    */

-    httpFlush(http);
+    if (filename != NULL)
+      sprintf(length, "%u", ippLength(request) + fileinfo.st_size);
+    else
+      sprintf(length, "%u", ippLength(request));
+
+    httpClearFields(http);
+    httpSetField(http, HTTP_FIELD_CONTENT_LENGTH, length);
+    httpSetField(http, HTTP_FIELD_CONTENT_TYPE, "application/ipp");
+    httpSetField(http, HTTP_FIELD_AUTHORIZATION, authstring);

-    response = NULL;
-  }
-  else
-  {
   /*
-    * Read the response...
+    * Try the request...
    */

-    response = ippNew();
+    DEBUG_puts("cupsDoFileRequest: post...");

-    if (ippRead(http, response) == IPP_ERROR)
+    if (httpPost(http, resource))
+      if (httpPost(http, resource))
+        break;
+
+   /*
+    * Send the IPP data and wait for the response...
+    */
+
+    DEBUG_puts("cupsDoFileRequest: ipp write...");
+
+    request->state = IPP_IDLE;
+    if (ippWrite(http, request) != IPP_ERROR)
+      if (filename != NULL)
+      {
+        DEBUG_puts("cupsDoFileRequest: file write...");
+
+       /*
+        * Send the file...
+        */
+
+        rewind(file);
+
+        while ((bytes = fread(buffer, 1, sizeof(buffer), file)) > 0)
+  	  if (httpWrite(http, buffer, bytes) < bytes)
+            break;
+      }
+
+   /*
+    * Get the server's return status...
+    */
+
+    DEBUG_puts("cupsDoFileRequest: update...");
+
+    while ((status = httpUpdate(http)) == HTTP_CONTINUE);
+
+#if !defined(WIN32) && !defined(__EMX__)
+    if (status == HTTP_UNAUTHORIZED)
    {
-      ippDelete(response);
-      response = NULL;
+      DEBUG_puts("cupsDoFileRequest: unauthorized...");

     /*
-      * Flush any remaining data...
+      * Flush any error message...
      */

      httpFlush(http);
+
+      if ((password = getpass("Password:")) != NULL)
+      {
+       /*
+	* Got a password; send it to the server...
+	*/
+
+        if (!password[0])
+          break;
+	sprintf(plain, "%s:%s", cuserid(NULL), password);
+	httpEncode64(encode, plain);
+	sprintf(authstring, "Basic %s", encode);
+
+        continue;
+      }
+      else
+        break;
+    }
+#endif /* !WIN32 && !__EMX__ */
+
+    if (status != HTTP_OK)
+    {
+      DEBUG_printf(("cupsDoFileRequest: error %d...\n", status));
+
+     /*
+      * Flush any error message...
+      */
+
+      httpFlush(http);
+      break;
+    }
+    else
+    {
+     /*
+      * Read the response...
+      */
+
+      DEBUG_puts("cupsDoFileRequest: response...");
+
+      response = ippNew();
+
+      if (ippRead(http, response) == IPP_ERROR)
+      {
+       /*
+        * Delete the response...
+	*/
+
+	ippDelete(response);
+	response = NULL;
+
+       /*
+	* Flush any remaining data...
+	*/
+
+	httpFlush(http);
+	break;
+      }
    }
  }

+ /*
+  * Close the file if needed...
+  */
+
+  if (filename != NULL)
+    fclose(file);
+
 /*
  * Delete the original request and return the response...
  */
@@ -593,9 +677,6 @@ cupsPrintFile(char          *name,	/* I - Printer or class name */
 		printer[HTTP_MAX_URI],	/* Printer or class name */
 		uri[HTTP_MAX_URI];	/* Printer URI */
  cups_lang_t	*language;		/* Language to use */
-  struct stat	filestats;		/* File information */
-  FILE		*fp;			/* File pointer */
-  char		buffer[8192];		/* Copy buffer */
  int		jobid;			/* New job ID */


@@ -605,34 +686,17 @@ cupsPrintFile(char          *name,	/* I - Printer or class name */
  if (name == NULL || filename == NULL)
    return (0);

- /*
-  * See if the file exists and is readable...
-  */
-
-  if (stat(filename, &filestats))
-    return (0);
-
-  if ((fp = fopen(filename, "rb")) == NULL)
-  {
-    DEBUG_puts("cupsPrintFile: Unable to open file!");
-    return (0);
-  }
-
 /*
  * Setup a connection and request data...
  */

  if ((request = ippNew()) == NULL)
-  {
-    fclose(fp);
    return (0);
-  }

  if (!cups_connect(name, printer, hostname))
  {
    DEBUG_printf(("cupsPrintFile: Unable to open connection - %s.\n",
                  strerror(errno)));
-    fclose(fp);
    ippDelete(request);
    return (0);
  }
@@ -806,76 +870,29 @@ cupsPrintFile(char          *name,	/* I - Printer or class name */
  }

 /*
-  * Setup the necessary HTTP fields...
-  */
-
-  httpClearFields(cups_server);
-  httpSetField(cups_server, HTTP_FIELD_CONTENT_TYPE, "application/ipp");
-
-  sprintf(buffer, "%u", (unsigned)(ippLength(request) + filestats.st_size));
-  httpSetField(cups_server, HTTP_FIELD_CONTENT_LENGTH, buffer);
-
- /*
-  * Finally, issue a POST request for the printer and send the IPP data and
-  * file.
+  * Try printing the file...
  */

  sprintf(uri, "/printers/%s", printer);

-  response = ippNew();
-
-  if (httpPost(cups_server, uri))
+  if ((response = cupsDoFileRequest(cups_server, request, uri, filename)) == NULL)
+    jobid = 0;
+  else if (response->request.status.status_code > IPP_OK_CONFLICT)
  {
-    DEBUG_puts("httpPost() failed.");
+    DEBUG_printf(("IPP response code was 0x%x!\n",
+                  response->request.status.status_code));
    jobid = 0;
  }
-  else if (ippWrite(cups_server, request) == IPP_ERROR)
+  else if ((attr = ippFindAttribute(response, "job-id", IPP_TAG_INTEGER)) == NULL)
  {
-    DEBUG_puts("ippWrite() failed.");
+    DEBUG_puts("No job ID!");
    jobid = 0;
  }
  else
-  {
-    while ((i = fread(buffer, 1, sizeof(buffer), fp)) > 0)
-      if (httpWrite(cups_server, buffer, i) < i)
-      {
-        DEBUG_puts("httpWrite() failed.");
+    jobid = attr->values[0].integer;

-	fclose(fp);
-	ippDelete(request);
-	ippDelete(response);
-	httpClose(cups_server);
-	return (0);
-      }
-
-    if (httpUpdate(cups_server) == HTTP_ERROR)
-    {
-      DEBUG_puts("httpUpdate() failed.");
-      jobid = 0;
-    }
-    else if ((ippRead(cups_server, response)) == IPP_ERROR)
-    {
-      DEBUG_puts("ippRead() failed.");
-      jobid = 0;
-    }
-    else if (response->request.status.status_code > IPP_OK_CONFLICT)
-    {
-      DEBUG_printf(("IPP response code was 0x%x!\n",
-                    response->request.status.status_code));
-      jobid = 0;
-    }
-    else if ((attr = ippFindAttribute(response, "job-id", IPP_TAG_INTEGER)) == NULL)
-    {
-      DEBUG_puts("No job ID!");
-      jobid = 0;
-    }
-    else
-      jobid = attr->values[0].integer;
-  }
-
-  fclose(fp);
-  ippDelete(request);
-  ippDelete(response);
+  if (response != NULL)
+    ippDelete(response);

  return (jobid);
 }
@@ -41,10 +41,11 @@ include ../Makedefs

 DOCUMENTS	=	cmp.shtml idd.shtml sam.shtml sdd.shtml ssr.shtml \
 			stp.shtml sum.shtml svd.shtml
-DOCIMAGES	=	images/navbar.gif
+DOCIMAGES	=	images/cups-block-diagram.gif images/cups-large.gif \
+			images/cups-medium.gif images/cups-small.gif
 WEBPAGES	=	cups.css cupsdoc.css index.html documentation.html
-WEBIMAGES	=	images/navbar.gif images/printer-idle.gif \
-			images/printer-processing.gif \
+WEBIMAGES	=	images/logo.gif images/navbar.gif \
+			images/printer-idle.gif	images/printer-processing.gif \
 			images/printer-stopped.gif

 #
@@ -68,22 +69,34 @@ clean:
 #

 install:
-	-$(MKDIR) $(SERVERROOT)/doc
-	$(CP) $(WEBPAGES) $(SERVERROOT)/doc
-	$(CP) overview.html overview.pdf $(SERVERROOT)/doc
-	$(CP) $(DOCUMENTS:.shtml=.html) $(SERVERROOT)/doc
-	$(CP) $(DOCUMENTS:.shtml=.pdf) $(SERVERROOT)/doc
-	-$(MKDIR) $(SERVERROOT)/doc/images
-	$(CP) $(WEBIMAGES) $(SERVERROOT)/doc/images
-	$(CP) $(DOCIMAGES) $(SERVERROOT)/doc/images
+	-$(MKDIR) $(DATADIR)/doc
+	$(CP) $(WEBPAGES) $(DATADIR)/doc
+	$(CP) overview.html overview.pdf $(DATADIR)/doc
+	$(CP) $(DOCUMENTS:.shtml=.html) $(DATADIR)/doc
+	$(CP) $(DOCUMENTS:.shtml=.pdf) $(DATADIR)/doc
+	-$(MKDIR) $(DATADIR)/doc/images
+	$(CP) $(WEBIMAGES) $(DATADIR)/doc/images
+	$(CP) $(DOCIMAGES) $(DATADIR)/doc/images

 #
-# The overview PDF file gets special attention...
+# The overview, admin guide, and user's guide get special attention...
 #

 overview.pdf:	overview.html
 	htmldoc --duplex --compression=9 --jpeg --webpage -f $@ $<

+sam.html:	sam.shtml
+	htmldoc --title images/cups-large.gif -f $@ $<
+sam.pdf:	sam.shtml
+	htmldoc --title images/cups-large.gif --duplex --compression=9 \
+		--jpeg -f $@ $<
+
+sum.html:	sum.shtml
+	htmldoc --title images/cups-large.gif -f $@ $<
+sum.pdf:	sum.shtml
+	htmldoc --title images/cups-large.gif --duplex --compression=9 \
+		--jpeg -f $@ $<
+
 #
 # End of Makefile.
 #
@@ -118,6 +118,9 @@ with reduced functionality. </P>
 <P>CUPS adds network printer browsing and PostScript Printer 
 Description (&quot;PPD&quot;)-based printing options to support real world 
 applications under UNIX. </P>
+<P>CUPS also includes a customized version of GNU GhostScript 
+(currently based off GNU GhostScript 4.03) and an image file RIP that 
+can be used to support non-PostScript printers. </P>
 <H2><A NAME=1_3>1.3 Document Overview</A></H2>
 This configuration management document is organized into the following 
 sections: 
@@ -337,7 +340,7 @@ extension of &quot;.h&quot;.
 the file, the purpose or nature of the source file, the copyright and 
 licensing notice, and the functions contained in the file.  The file 
 name and revision information is provided by the CVS &quot;$Id: cmp.shtml,v 
-1.2 1999/05/13 20:40:40 mike Exp $&quot; tag: 
+1.3 1999/05/21 20:54:04 mike Exp $&quot; tag: 
 <UL>
 <PRE>
 /*
@@ -373,7 +376,7 @@ name and revision information is provided by the CVS &quot;$Id: cmp.shtml,v
 </PRE>
 </UL>
 The bottom of each source file shall contain a trailer giving the name 
-of the file using the CVS &quot;$Id: cmp.shtml,v 1.2 1999/05/13 20:40:40 
+of the file using the CVS &quot;$Id: cmp.shtml,v 1.3 1999/05/21 20:54:04 
 mike Exp $&quot; tag. The primary purpose of this is to mark the end of a 
 source file; if the trailer is missing it is possible that code has 
 been lost near the end of the file: 
@@ -1,6 +1,6 @@
 %PDF-1.2
 %âãÏÓ
-1 0 obj<</Producer(htmldoc 2.0b1 Copyright 1997-1999 Michael Sweet, All Rights Reserved.)/CreationDate(D:19990514170117Z)/Title(CUPS Configuration Management Plan)/Author(Easy Software Products)>>endobj
+1 0 obj<</Producer(htmldoc 2.0b1 Copyright 1997-1999 Michael Sweet, All Rights Reserved.)/CreationDate(D:19990521210307Z)/Title(CUPS Configuration Management Plan)/Author(Easy Software Products)>>endobj
 2 0 obj<</Type/Encoding/BaseEncoding/WinAnsiEncoding>>endobj
 3 0 obj<</Type/Font/Subtype/Type1/BaseFont/Courier/Encoding 2 0 R>>endobj
 4 0 obj<</Type/Font/Subtype/Type1/BaseFont/Times-Roman/Encoding 2 0 R>>endobj
@@ -16,9 +16,9 @@
 14 0 obj<</Subtype/Link/Rect[108.0 646.8 124.5 659.8]/Border[0 0 0]/Dest[198 0 R/XYZ null 658 0]>>endobj
 15 0 obj<</Subtype/Link/Rect[124.5 646.8 159.6 659.8]/Border[0 0 0]/Dest[198 0 R/XYZ null 658 0]>>endobj
 16 0 obj<</Subtype/Link/Rect[159.6 646.8 203.0 659.8]/Border[0 0 0]/Dest[198 0 R/XYZ null 658 0]>>endobj
-17 0 obj<</Subtype/Link/Rect[108.0 633.6 124.5 646.6]/Border[0 0 0]/Dest[198 0 R/XYZ null 474 0]>>endobj
-18 0 obj<</Subtype/Link/Rect[124.5 633.6 173.1 646.6]/Border[0 0 0]/Dest[198 0 R/XYZ null 474 0]>>endobj
-19 0 obj<</Subtype/Link/Rect[173.1 633.6 216.4 646.6]/Border[0 0 0]/Dest[198 0 R/XYZ null 474 0]>>endobj
+17 0 obj<</Subtype/Link/Rect[108.0 633.6 124.5 646.6]/Border[0 0 0]/Dest[198 0 R/XYZ null 434 0]>>endobj
+18 0 obj<</Subtype/Link/Rect[124.5 633.6 173.1 646.6]/Border[0 0 0]/Dest[198 0 R/XYZ null 434 0]>>endobj
+19 0 obj<</Subtype/Link/Rect[173.1 633.6 216.4 646.6]/Border[0 0 0]/Dest[198 0 R/XYZ null 434 0]>>endobj
 20 0 obj<</Subtype/Link/Rect[72.0 607.2 80.2 620.2]/Border[0 0 0]/Dest[204 0 R/XYZ null 818 0]>>endobj
 21 0 obj<</Subtype/Link/Rect[80.2 607.2 131.6 620.2]/Border[0 0 0]/Dest[204 0 R/XYZ null 818 0]>>endobj
 22 0 obj<</Subtype/Link/Rect[108.0 594.0 124.5 607.0]/Border[0 0 0]/Dest[204 0 R/XYZ null 737 0]>>endobj
@@ -263,7 +263,7 @@
 138 0 obj<</D[198 0 R/XYZ null 818 null]>>endobj
 139 0 obj<</D[198 0 R/XYZ null 737 null]>>endobj
 140 0 obj<</D[198 0 R/XYZ null 658 null]>>endobj
-141 0 obj<</D[198 0 R/XYZ null 474 null]>>endobj
+141 0 obj<</D[198 0 R/XYZ null 434 null]>>endobj
 142 0 obj<</D[204 0 R/XYZ null 818 null]>>endobj
 143 0 obj<</D[204 0 R/XYZ null 737 null]>>endobj
 144 0 obj<</D[204 0 R/XYZ null 540 null]>>endobj
@@ -380,12 +380,14 @@ endobj
 Õ;c`<k»ñÎ™¡µ€±¯ïdŠÉÐP¶ÀÆ³¿bY™>R°0qí{±;ÂçT®„4`6µƒ¢Y™Kz�ÉÐ|€#·	&……Kæ`1 "Íë9ƒ‹ö	›òMÏRØê€…Ý…‚U˜«âµëU‹`4,}<Vö
 îdÝ'–^ªÀV”v{Õ“6ƒEm2U2VÃm4°çùOÖÁ³Å,¤~PÀæÊCXõ›ÎQå†þ1k>WÂâòü[ê`1,¾)hãb˜ç�ÇVóÚ¨•+ò¸ÿ¥ó÷‚5�s.éñË9Ê³Þo_qØvž]¶™ã=“ªeùÐÎe2`{´ýï¾	Ù¿wnÈE]†)
 òò¡6nò~š<®Ü”+óì”³óÅbñêaSî‹‹Ðð·Í�¹l˜õÒ–ÿˆá’rÍ-p™Iâ Ã…ãroÀ–V¸œ°ö/—Ûp!¹§6}Ä†’+]âZÛãJÇ5\h.ÖNGGÛäÊœášç6¹œÑzÜñžK†cÑxwgÑ q9!Øó^
-—�Ò¸°DôÑ!‰kpKÄgÐ¸²‘X!•kàø—p€MäÔ)¹/T®!½3åø‰Ê5``OJš#s
-6Åhi/t®�¦1±ŒÁ5Ì#ží2¸™bÔ,%=pÍ`sõ®ôT9WÏÚÁÈdrIá®špõ)Š¬Ôa.W`¼L26#í§ÇeÌÕÓbŒyãÀ€«ÿìs/R˜puoŠü,M#®®Á’OÍ¸ºUE“daC®.´Q´)Ww`fÉøÆ\äêŽ&ö¹ºX¶¦«Ûá²/‹æ÷&¬påÒ®-^š÷È×Æí
-Ùd�»Ã•ËwË&—¥!;_ç®qåòÆX_Ùê‹M.~jõ�êÒ^Oìr¤W#R·‡äâ’Ù¥ê‚‹CvþÊvºà"æÅû‹ÞsÑ
+—�Ò¸°DôÑ!‰kpKÄgÐ¸²‘X!•kàø—p€MäÔ)¹/T®!½3åø‰Ê5``OJš#s
+6Åhi/t®�¦1±ŒÁ5Ì#ží2¸™bÔ,%=pÍ`sõ®ôT9WÏÚÁÈdrIá®špõ)Š¬Ôa.W`¼L26#í§ÇeÌÕÓbŒyãÀ€«ÿìs/R˜puoŠü,M#®®Á’OÍ¸ºUE“daC®.´Q´)Ww`fÉøÆ\äêŽ&ö¹ºX¶¦«Ûá²/‹æ÷&¬påÒ®-^š÷È×Æí
+Ùd�»Ã•ËwË&—¥!;_ç®qåòÆX_Ùê‹M.~jõ�êÒ^Oìr¤W#R·‡äâ’Ù¥ê‚‹CvþÊvºà"æÅû‹ÞsÑ
+×¦<à²ãýóÛN>¾3®Ý¨µäÙâ¡«Ïî’k7l7‹3õ8]>tù¹]sín{Ãaqq¶-ç‹ÅåÃCçÙ×â�/’wòÅ›?¾×ï…üA¼ûîê[q»ººòûºÏ!÷¿þòÃO?þþåÓ×Ÿ~ýEüéÓ/Ÿ~üü—Ï¿|ðó§_þYþÏ¦ñ¸¾Þ6¾~ûîêx}ýöêæ±ùëû?Áëë«Õ¶âëëÛ«kñúæÝþ·ÇŸ~û»È~ýáëÿ}úòYÀ—_¿ÿýÏ_ÛU¼}{õ®ð{~ýß¿ùéÇÿþºéãûo_oþ÷þ_Ä‡Ÿéö‡¿‰ôóoŸ¿üíó÷Û¦±Üý?ÚiñÜendstream
+endobj
 194 0 obj
 6320
-194 0 obj
+endobj
 195 0 obj<</Type/Page/Parent 191 0 R/Contents 196 0 R/Resources<</ProcSet[/PDF/Text]/Font<</F8 7 0 R>>>>>>endobj
 196 0 obj<</Length 197 0 R/Filter/FlateDecode>>stream
 xÚ+ä2T0BCc3JÎår
@@ -486,24 +488,19 @@ endobj
 221 0 obj
 216
 endobj
-222 0 obj<</Type/Page/Parent 191 0 R/Contents 223 0 R/Resources<</ProcSet[/PDF/Text]/Font<</F0 3 0 R/F4 4 0 R/F8 7 0 R/F9 8 0 R>>>>>>endobj
-223 0 obj<</Length 224 0 R/Filter/FlateDecode>>stream
-xÚ�VMSÛ0½çWìpjgˆ'’Þ€�N/�”¤\Y^'flÉ•d(ÿ¾»’çchÃ!±õôöí7¿1Œè/†«1L¦ ËÁÍjðå~ñV�L¯.`•~º„¥ÎÜ«0X °h?¯žò2šìðrtÃ#›k?ê2A“«uÀ_@7èñ4 o-–P#pƒ8¬„qðÒ(Oép˜Bò1êÔ‚Ó`°2hQ9º‹PŠgmÎ¡Ì	•B%œÜÊ‹f
-d9žDc¶¨í× ms~�q ¶�öFÌž=òä‘çÝ9�£Q4ÚõrÈTŸ7èÄÐ¡ur˜â™«”ÔçY\U…*¥xy
-tŽœ¿�L…~
->Hê¼H›Øü¿þÄÓì{‘Ä'ü¸†ÛÇ%X%*»ÑrkTr“iH™{ƒ„¼õ	Èr%ŠÖeÿÆçš�è¥˜)1ÝúØKVŠ³—3Oòš»�'IQæ%Y¨t®œåz(„$5…ÖX©©@>£—øiôÔ ÷òDLî™ÜµF%�QòÆqMg¢.(LŠ~Ú¶‰l�í›uXÒ�4X"kgwvêµ‰Lß3ºø{aYæíðÝ-}Š6_+Ðøæ¢3ÚƒSß#§H¥«BÁãï©9Ø=ÀÝç¸G^¦7H5!uYQÊ°x#DÐƒi×£ÿ ¢g6ø°×Ú
-‘}§çÃ9ojèsŸjP_¼=¯ß!ÇŒ\¢Ô$â4 #ŒNké¸à�áã=”B°
+222 0 obj<</Type/Page/Parent 191 0 R/Contents 223 0 R/Resources<</ProcSet[/PDF/Text]/Font<</F0 3 0 R/F4 4 0 R/F8 7 0 R/F9 8 0 R>>>>>>endobj
+223 0 obj<</Length 224 0 R/Filter/FlateDecode>>stream
 xÚ�VMSÛ0½çWìpjgˆ'’Þ€�N/�”¤\Y^'flÉ•d(ÿ¾»’çchÃ!±õôöí7¿1Œè/†«1L¦ ËÁÍjðå~ñV�L¯.`•~º„¥ÎÜ«0X °h?¯žò2šìðrtÃ#›k?ê2A“«uÀ_@7èñ4 o-–P#pƒ8¬„qðÒ(Oép˜Bò1êÔ‚Ó`°2hQ9º‹PŠgmÎ¡Ì	•B%œÜÊ‹f
 d9žDc¶¨í× ms~�q ¶�öFÌž=òä‘çÝ9�£Q4ÚõrÈTŸ7èÄÐ¡ur˜â™«”ÔçY\U…*¥xy
-224 0 obj
+tŽœ¿�L…~
 >Hê¼H›Øü¿þÄÓì{‘Ä'ü¸†ÛÇ%X%*»ÑrkTr“iH™{ƒ„¼õ	Èr%ŠÖeÿÆçš�è¥˜)1ÝúØKVŠ³—3Oòš»�'IQæ%Y¨t®œåz(„$5…ÖX©©@>£—øiôÔ ÷òDLî™ÜµF%�QòÆqMg¢.(LŠ~Ú¶‰l�í›uXÒ�4X"kgwvêµ‰Lß3ºø{aYæíðÝ-}Š6_+Ðøæ¢3ÚƒSß#§H¥«BÁãï©9Ø=ÀÝç¸G^¦7H5!uYQÊ°x#DÐƒi×£ÿ ¢g6ø°×Ú
 ‘}§çÃ9ojèsŸjP_¼=¯ß!ÇŒ\¢Ô$â4 #ŒNké¸à�áã=”B°
 Ô‹=ÒcWâ.zh¦Ö.ô4{ÿÊø`	:ngâ.ôû¸£ÝrñÍ6™·ëeßÂÈ¡»G÷ÊvcmÇÝˆPe½�ÅÍkk)ÑÚ¬.¨bÛâM»–rF×IÁd•6.‚kbÒÉ3õ×b¯FñÊÚ	ÆgyñÞrŠ�·¢f¸Ji•‘†’>�ŠšQ~´Ó*[›fžX]Ù²§X$=¦Ñ�MÜ…j+Z9§öï6N.;±\à” nEI-l%í›Ø·ùö&›€E!Ô¹?.W‹!× ÜVè™m/FRÐ€åêÁ¯ñ�¤Ðs3?Ã2š"YZJMôÆÝYçÈt�ü“r1EsÂbÎÏw«ÁÏÁ_øe¼?endstream
-226 0 obj<</Length 227 0 R/Filter/FlateDecode>>stream
-xÚmP½R„0îyŠ+-	Ç¶Þh§sz¨õ^XŽ8�`6Ì�oï,,œ¤Úý~÷+Q�ÉS°-ã×crß$·�w vi
+endobj
+224 0 obj
 845
 endobj
-endobj
+225 0 obj<</Type/Page/Parent 191 0 R/Contents 226 0 R/Resources<</ProcSet[/PDF/Text]/Font<</F4 4 0 R/F8 7 0 R/F9 8 0 R>>>>>>endobj
 226 0 obj<</Length 227 0 R/Filter/FlateDecode>>stream
 xÚmP½R„0îyŠ+-	Ç¶Þh§sz¨õ^XŽ8�`6Ì�oï,,œ¤Úý~÷+Q�ÉS°-ã×crß$·�w vi
 M'»²ªÒšöz—ðJ!ÓMó)¨”Z1›¼”¥`>z²ˆƒ±gè‘áD2Ðnœ
@@ -586,7 +583,7 @@ endobj
 248 0 obj
 749
 endobj
-*<Ó;ñNV*•~hª½qÑû™5¦Uòq¯Æd†§Ii<¡D&=3%K-3Í#þ�ÍøL"•¯!mc�%^±4z•'9m‡´HW[ã¢Y:ÓVÄÆEË�e0—"KA@óÑ˜—xò�ÚÍM‘›0��~ÊÓ“F\©>™'Y–µõnSü�ƒÙçY�Ã)tN€Ã+:(RE³zžœLÝ†*²qóµs;kÌæÕááÊcÕ>~K‰É‹ÎÅÝåùÛ‹“ÇyüÛëgÆun·¢U/dÉÕ³šóÅÞÿ_½ð*$Iðb]ƒhW"»ß£N™‘¨žî%¹NnG!!¦³ºMÌ7íH_<úv=¿BiãQé9Û¶ÉÍƒãQþ3_|úCø<+ïXÂæ¹	à:b¹a[vHoZÃngçaØ§P~gMàÂ©}¨ýû‡Žendstream
+249 0 obj<</Type/Page/Parent 191 0 R/Contents 250 0 R/Resources<</ProcSet[/PDF/Text]/Font<</F0 3 0 R/F4 4 0 R/F8 7 0 R/F9 8 0 R>>>>>>endobj
 250 0 obj<</Length 251 0 R/Filter/FlateDecode>>stream
 xÚ•V]OÛ0}ï¯¸Ê0š6´
 Û$`LBb[»í&ä&7‡kw¶Ó&þû®í”,ác¬’Ø¾¾_çø¤¿:	ôé›À`×ýÒEçxÒé}A2ˆw`’ÓÚî~â³�ãxDc{+psò3X%Á¦;Å»61ƒ3™¡´Ìr%ƒí°¶ÝÙ�‡ÎöHHU†0*½1€2Ê`Ó[˜j–Þ 5`æŒÌ¦8ãJnç`çj‰’Ë™·¢‘K\b2ðnÉRB®„P¥qIPèPU¶a,ÓÖyhì–[Ô>BðÌdÜ÷ÅPb;`–4oª ”m�Ùù€KA£¬é¸=ää¶Úu®Ì†Â4§B™¨Búþ„öa!˜<'nð»1òa�BoÎ•Zºp+¦a«×0kîémµ|lÁ…VT±¡Fª)m_1Q �´Z–VÁh4Šã¸½í¥ äJÃÕ‡wÐ?o!é÷ýÓ›7W›-ÛvQ™º¶snÈÁÕæáÓ«Ì>¹zßß7‰Ùu}]SsLÝØõ¤ ®X\jà¢LEÛ¡0èîT‘»ñœ®Ž4Q9ç£ö>¦0%
@@ -839,128 +836,128 @@ xref
 0000013664 00000 n 
 0000013770 00000 n 
 0000013876 00000 n 
-0000013452 00000 n 
-0000013558 00000 n 
-0000013664 00000 n 
-0000013770 00000 n 
-0000013876 00000 n 
-0000013980 00000 n 
-0000014084 00000 n 
-0000014189 00000 n 
-0000014295 00000 n 
-0000014401 00000 n 
-0000014635 00000 n 
-0000014669 00000 n 
-0000014703 00000 n 
-0000015402 00000 n 
-0000015451 00000 n 
-0000015500 00000 n 
-0000015549 00000 n 
-0000015598 00000 n 
-0000015647 00000 n 
-0000015696 00000 n 
-0000015745 00000 n 
-0000015794 00000 n 
-0000015843 00000 n 
-0000015892 00000 n 
-0000015941 00000 n 
-0000015990 00000 n 
-0000016039 00000 n 
-0000016088 00000 n 
-0000016137 00000 n 
-0000016186 00000 n 
-0000016235 00000 n 
-0000016284 00000 n 
-0000016333 00000 n 
-0000016382 00000 n 
-0000016431 00000 n 
-0000016480 00000 n 
-0000016529 00000 n 
-0000016578 00000 n 
-0000016627 00000 n 
-0000016676 00000 n 
-0000016725 00000 n 
-0000016774 00000 n 
-0000016823 00000 n 
-0000016872 00000 n 
-0000016921 00000 n 
-0000016970 00000 n 
-0000017019 00000 n 
-0000017068 00000 n 
-0000017117 00000 n 
-0000017166 00000 n 
-0000017215 00000 n 
-0000017264 00000 n 
-0000017313 00000 n 
-0000017362 00000 n 
-0000017411 00000 n 
-0000017460 00000 n 
-0000017509 00000 n 
-0000017558 00000 n 
-0000017607 00000 n 
-0000017656 00000 n 
-0000017705 00000 n 
-0000017754 00000 n 
-0000017803 00000 n 
-0000017852 00000 n 
-0000017901 00000 n 
-0000017950 00000 n 
-0000017999 00000 n 
-0000018260 00000 n 
-0000018412 00000 n 
-0000024803 00000 n 
-0000024825 00000 n 
-0000024938 00000 n 
-0000025040 00000 n 
-0000025060 00000 n 
-0000025200 00000 n 
-0000026050 00000 n 
-0000026071 00000 n 
-0000026184 00000 n 
-0000026372 00000 n 
-0000026393 00000 n 
-0000026533 00000 n 
-0000027126 00000 n 
-0000027147 00000 n 
-0000027260 00000 n 
-0000027453 00000 n 
-0000027474 00000 n 
-0000027605 00000 n 
-0000028218 00000 n 
-0000028239 00000 n 
-0000028352 00000 n 
-0000028541 00000 n 
-0000028562 00000 n 
-0000028693 00000 n 
-0000029637 00000 n 
-0000029658 00000 n 
-0000029789 00000 n 
-0000030076 00000 n 
-0000030097 00000 n 
-0000030237 00000 n 
-0000031153 00000 n 
-0000031174 00000 n 
-0000031305 00000 n 
-0000031663 00000 n 
-0000031684 00000 n 
-0000031824 00000 n 
-0000032320 00000 n 
-0000032341 00000 n 
-0000032472 00000 n 
-0000032924 00000 n 
-0000032945 00000 n 
-0000033085 00000 n 
-0000034223 00000 n 
-0000034245 00000 n 
-0000034385 00000 n 
-0000035289 00000 n 
-0000035310 00000 n 
-0000035450 00000 n 
-0000036376 00000 n 
-0000036397 00000 n 
-0000036537 00000 n 
+0000013980 00000 n 
+0000014084 00000 n 
+0000014189 00000 n 
+0000014295 00000 n 
+0000014401 00000 n 
+0000014635 00000 n 
+0000014669 00000 n 
+0000014703 00000 n 
+0000015402 00000 n 
+0000015451 00000 n 
+0000015500 00000 n 
+0000015549 00000 n 
+0000015598 00000 n 
+0000015647 00000 n 
+0000015696 00000 n 
+0000015745 00000 n 
+0000015794 00000 n 
+0000015843 00000 n 
+0000015892 00000 n 
+0000015941 00000 n 
+0000015990 00000 n 
+0000016039 00000 n 
+0000016088 00000 n 
+0000016137 00000 n 
+0000016186 00000 n 
+0000016235 00000 n 
+0000016284 00000 n 
+0000016333 00000 n 
+0000016382 00000 n 
+0000016431 00000 n 
+0000016480 00000 n 
+0000016529 00000 n 
+0000016578 00000 n 
+0000016627 00000 n 
+0000016676 00000 n 
+0000016725 00000 n 
+0000016774 00000 n 
+0000016823 00000 n 
+0000016872 00000 n 
+0000016921 00000 n 
+0000016970 00000 n 
+0000017019 00000 n 
+0000017068 00000 n 
+0000017117 00000 n 
+0000017166 00000 n 
+0000017215 00000 n 
+0000017264 00000 n 
+0000017313 00000 n 
+0000017362 00000 n 
+0000017411 00000 n 
+0000017460 00000 n 
+0000017509 00000 n 
+0000017558 00000 n 
+0000017607 00000 n 
+0000017656 00000 n 
+0000017705 00000 n 
+0000017754 00000 n 
+0000017803 00000 n 
+0000017852 00000 n 
+0000017901 00000 n 
+0000017950 00000 n 
+0000017999 00000 n 
+0000018260 00000 n 
+0000018412 00000 n 
+0000024803 00000 n 
+0000024825 00000 n 
+0000024938 00000 n 
+0000025040 00000 n 
+0000025060 00000 n 
+0000025200 00000 n 
+0000026140 00000 n 
+0000026161 00000 n 
+0000026274 00000 n 
+0000026462 00000 n 
+0000026483 00000 n 
+0000026623 00000 n 
+0000027216 00000 n 
+0000027237 00000 n 
+0000027350 00000 n 
+0000027543 00000 n 
+0000027564 00000 n 
+0000027695 00000 n 
+0000028308 00000 n 
+0000028329 00000 n 
+0000028442 00000 n 
+0000028631 00000 n 
+0000028652 00000 n 
+0000028783 00000 n 
+0000029727 00000 n 
+0000029748 00000 n 
+0000029879 00000 n 
+0000030166 00000 n 
+0000030187 00000 n 
+0000030327 00000 n 
+0000031243 00000 n 
+0000031264 00000 n 
+0000031395 00000 n 
+0000031753 00000 n 
+0000031774 00000 n 
+0000031914 00000 n 
+0000032410 00000 n 
+0000032431 00000 n 
+0000032562 00000 n 
+0000033014 00000 n 
+0000033035 00000 n 
+0000033175 00000 n 
+0000034315 00000 n 
+0000034337 00000 n 
+0000034477 00000 n 
+0000035383 00000 n 
+0000035404 00000 n 
+0000035544 00000 n 
+0000036470 00000 n 
+0000036491 00000 n 
+0000036631 00000 n 
+0000037277 00000 n 
+0000037298 00000 n 
+0000037438 00000 n 
+0000038258 00000 n 
+0000038279 00000 n 
 0000038419 00000 n 
 0000039346 00000 n 
 0000039367 00000 n 
-0000038164 00000 n 
+0000039507 00000 n 
 0000039911 00000 n 
@@ -31,6 +31,10 @@ supported with reduced functionality.
 Description (&quot;PPD&quot;)-based printing options to support real
 world applications under UNIX.

+<P>CUPS also includes a customized version of GNU GhostScript
+(currently based off GNU GhostScript 4.03) and an image file RIP that
+can be used to support non-PostScript printers.
+
 <H2>Document Overview</H2>

 This configuration management document is organized into the following
@@ -330,12 +334,12 @@ extension of ".h".
 The top of each source file shall contain a header giving the name of the
 file, the purpose or nature of the source file, the copyright and licensing
 notice, and the functions contained in the file.  The file name and revision
-information is provided by the CVS "$Id: cmp.shtml 322 1999-05-13 20:40:46Z mike $" tag:
+information is provided by the CVS "$Id: cmp.shtml 351 1999-05-21 20:54:09Z mike $" tag:

 <UL>
 <PRE>
 /*
- * "$Id: cmp.shtml 322 1999-05-13 20:40:46Z mike $"
+ * "$Id: cmp.shtml 351 1999-05-21 20:54:09Z mike $"
 *
 *   Description of file contents.
 *
@@ -368,14 +372,14 @@ information is provided by the CVS "$Id: cmp.shtml 322 1999-05-13 20:40:46Z mike
 </UL>

 The bottom of each source file shall contain a trailer giving the name
-of the file using the CVS "$Id: cmp.shtml 322 1999-05-13 20:40:46Z mike $" tag. The primary purpose of this is to
+of the file using the CVS "$Id: cmp.shtml 351 1999-05-21 20:54:09Z mike $" tag. The primary purpose of this is to
 mark the end of a source file; if the trailer is missing it is possible
 that code has been lost near the end of the file:

 <UL>
 <PRE>
 /*
- * End of "$Id: cmp.shtml 322 1999-05-13 20:40:46Z mike $".
+ * End of "$Id: cmp.shtml 351 1999-05-21 20:54:09Z mike $".
 */
 </PRE>
 </UL>
@@ -1,3 +1,4 @@
 BODY { background-color: #cccc99 }
-H1 { font-family: sans-serif; margin-left: 5% }
+H1 { font-family: sans-serif; }
+H2 { font-family: sans-serif; }
 TH { background-color: #999966 }
@@ -0,0 +1,9 @@
+H1 { font-family: sans-serif }
+H2 { font-family: sans-serif }
+H3 { font-family: sans-serif }
+H4 { font-family: sans-serif }
+H5 { font-family: sans-serif }
+H6 { font-family: sans-serif }
+SUP { font-family: sans-serif; font-size: 6pt }
+PRE { margin-left: 2em }
+CODE { font-weight: bold }
@@ -3,11 +3,11 @@
 	<TITLE>Documentation - Common UNIX Printing System</TITLE>
 	<LINK REL=STYLESHEET TYPE="text/css" HREF="cups.css">
 	<MAP NAME="navbar">
-		<AREA SHAPE="RECT" COORDS="10,10,100,35" HREF="printers" ALT="Current Printer Status">
-		<AREA SHAPE="RECT" COORDS="115,10,205,35" HREF="classes" ALT="Current Printer Classes Status">
-		<AREA SHAPE="RECT" COORDS="220,10,280,35" HREF="jobs" ALT="Current Jobs Status">
-		<AREA SHAPE="RECT" COORDS="295,10,470,35" HREF="documentation.html" ALT="Read CUPS Documentation On-Line">
-		<AREA SHAPE="RECT" COORDS="485,10,590,35" HREF="http://www.cups.org" ALT="Download the Current CUPS Software">
+		<AREA SHAPE="RECT" COORDS="10,10,85,30" HREF="printers" ALT="Current Printer Status">
+		<AREA SHAPE="RECT" COORDS="95,10,175,30" HREF="classes" ALT="Current Printer Classes Status">
+		<AREA SHAPE="RECT" COORDS="185,10,235,30" HREF="jobs" ALT="Current Jobs Status">
+		<AREA SHAPE="RECT" COORDS="245,10,395,30" HREF="documentation.html" ALT="Read CUPS Documentation On-Line">
+		<AREA SHAPE="RECT" COORDS="405,10,490,30" HREF="http://www.cups.org" ALT="Download the Current CUPS Software">
        </MAP>
 </HEAD>

@@ -19,19 +19,21 @@

 <H1>Documentation</H1>

-The following documentation is available (or will be shortly) for CUPS:
+The following documentation for CUPS is available on this server:

 <UL>

-	<LI>Online man pages (for users and administrators)
-
 	<LI>Whitepaper - An Overview of the Common UNIX Printing System (
 	<A HREF="overview.html">HTML</A> |
 	<A HREF="overview.pdf">PDF</A> )

-	<LI>Software Users Manual (Not Yet Available)
+	<LI>Software Users Manual (
+	<A HREF="sum.html">HTML</A> |
+	<A HREF="sum.pdf">PDF</A> )

-	<LI>Software Administrators Manual (Not Yet Available)
+	<LI>Software Administrators Manual (
+	<A HREF="sum.html">HTML</A> |
+	<A HREF="sum.pdf">PDF</A> )

 	<LI>Configuration Management Plan (
 	<A HREF="cmp.html">HTML</A> |
@@ -57,47 +59,6 @@ The following documentation is available (or will be shortly) for CUPS:

 </UL>

-The source code is documented and formatted according to the Configuration
-Management Plan, CUPS-CMP-1.0. The design documents should provide the
-programmer more than enough information to understand (and maintain, if
-necessary) the code.
-
-<H1>RFCs</H1>
-
-The following RFCs are applicable to CUPS:
-
-<UL>
-
-	<LI><A HREF="http://www.ietf.org/rfc/files/rfc1179.txt">
-	RFC 1179: Line Printer Daemon Protocol</A>
-
-	<LI><A HREF="http://www.ietf.org/rfc/files/rfc2046.txt">
-	RFC 2046: Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types</A>
-
-	<LI><A HREF="http://www.ietf.org/rfc/files/rfc2068.txt">
-	RFC 2068: Hypertext Transfer Protocol -- HTTP/1.1</A>
-
-	<LI><A HREF="http://www.ietf.org/rfc/files/rfc2069.txt">
-	RFC 2069: An Extension to HTTP: Digest Access Authentication</A>
-
-	<LI><A HREF="http://www.ietf.org/rfc/files/rfc2565.txt">
-	RFC 2565: Internet Printing Protocol/1.0: Encoding and Transport</A>
-
-	<LI><A HREF="http://www.ietf.org/rfc/files/rfc2566.txt">
-	RFC 2566: Internet Printing Protocol/1.0: Model and Semantics</A>
-
-	<LI><A HREF="http://www.ietf.org/rfc/files/rfc2567.txt">
-	RFC 2567: Design Goals for an Internet Printing Protocol</A>
-
-	<LI><A HREF="http://www.ietf.org/rfc/files/rfc2568.txt">
-	RFC 2568: Rationale for the Structure of the Model and Protocol
-        for the Internet Printing Protocol</A>
-
-	<LI><A HREF="http://www.ietf.org/rfc/files/rfc2569.txt">
-	RFC 2569: Mapping between LPD and IPP Protocols</A>
-
-</UL>
-
 <HR>

 <P>The Common UNIX Printing System, CUPS, and the CUPS logo are the
@@ -35,33 +35,48 @@ Copyright 1997-1999, All Rights Reserved<BR>
 <LI><A HREF=#3_3_1>3.3.1 mime.types</A></LI>
 <LI><A HREF=#3_3_2>3.3.2 mime.convs</A></LI>
 </UL>
-<LI><A HREF=#3_4>3.4 PPD Files</A></LI>
+<LI><A HREF=#3_4>3.4 PostScript Printer Description Files</A></LI>
+<UL>
+<LI><A HREF=#3_4_1>3.4.1 CUPS Extensions to PPD Files</A></LI>
+</UL>
 <LI><A HREF=#3_5>3.5 Scheduler Configuration Files</A></LI>
 <UL>
-<LI><A HREF=#3_5_1>3.5.1 cupsd.conf</A></LI>
-<LI><A HREF=#3_5_2>3.5.2 printers.conf</A></LI>
-<LI><A HREF=#3_5_3>3.5.3 classes.conf</A></LI>
+<LI><A HREF=#3_5_1>3.5.1 classes.conf</A></LI>
+<LI><A HREF=#3_5_2>3.5.2 cupsd.conf</A></LI>
+<LI><A HREF=#3_5_3>3.5.3 printers.conf</A></LI>
 </UL>
 </UL>
 <B><A HREF=#4>4 External Interfaces</A></B>
 <UL>
-<LI><A HREF=#4_1>4.1 Application Socket Protocol</A></LI>
+<LI><A HREF=#4_1>4.1 AppSocket Protocol</A></LI>
 <LI><A HREF=#4_2>4.2 CUPS Browsing Protocol</A></LI>
 <LI><A HREF=#4_3>4.3 CUPS PostScript File</A></LI>
 <LI><A HREF=#4_4>4.4 CUPS Raster File</A></LI>
-<LI><A HREF=#4_5>4.5 Internet Printing Protocol</A></LI>
-<LI><A HREF=#4_6>4.6 Line Printer Daemon Protocol</A></LI>
-<LI><A HREF=#4_7>4.7 Parallel Device</A></LI>
-<LI><A HREF=#4_8>4.8 Serial Device</A></LI>
+<LI><A HREF=#4_5>4.5 CUPS Raw Files</A></LI>
+<LI><A HREF=#4_6>4.6 File Transfer Protocol</A></LI>
+<LI><A HREF=#4_7>4.7 Internet Printing Protocol</A></LI>
+<UL>
+<LI><A HREF=#4_7_1>4.7.1 Get Default Destination (CUPS_GET_DEFAULT = 
+0x4001)</A></LI>
+<LI><A HREF=#4_7_2>4.7.2 Get Printers (CUPS_GET_PRINTERS = 0x4002)</A></LI>
+<LI><A HREF=#4_7_3>4.7.3 Add Printer (CUPS_ADD_PRINTER = 0x4003)</A></LI>
+<LI><A HREF=#4_7_4>4.7.4 Delete Printer (CUPS_DELETE_PRINTER = 0x4004)</A>
+</LI>
+<LI><A HREF=#4_7_5>4.7.5 Get Classes (CUPS_GET_CLASSES = 0x4005)</A></LI>
+<LI><A HREF=#4_7_6>4.7.6 Add Class (CUPS_ADD_CLASS = 0x4006)</A></LI>
+<LI><A HREF=#4_7_7>4.7.7 Delete Class (CUPS_DELETE_CLASS = 0x4007)</A></LI>
+<LI><A HREF=#4_7_8>4.7.8 Accept Jobs (CUPS_ACCEPT_JOBS = 0x4008)</A></LI>
+<LI><A HREF=#4_7_9>4.7.9 Reject Jobs (CUPS_REJECT_JOBS = 0x4009)</A></LI>
+<LI><A HREF=#4_7_10>4.7.10 Set Default Destination (CUPS_SET_DEFAULT = 
+0x400A)</A></LI>
+</UL>
+<LI><A HREF=#4_8>4.8 Line Printer Daemon Protocol</A></LI>
 <LI><A HREF=#4_9>4.9 Server Message Block Protocol</A></LI>
 <LI><A HREF=#4_10>4.10 Trivial File Transfer Protocol</A></LI>
 </UL>
-<B><A HREF=#5>5 Command-Line Interfaces</A></B>
-<UL>
-<LI><A HREF=#5_1>5.1 Backend Interfaces</A></LI>
-<LI><A HREF=#5_2>5.2 Filter Interfaces</A></LI>
-</UL>
-<B><A HREF=#6>A Glossary</A></B>
+<B><A HREF=#5>5 5 - Directories</A></B>
+<BR>
+<BR><B><A HREF=#6>A Glossary</A></B>
 <UL>
 <LI><A HREF=#6_1>A.1 Terms</A></LI>
 <LI><A HREF=#6_2>A.2 Acronyms</A></LI>
@@ -69,15 +84,15 @@ Copyright 1997-1999, All Rights Reserved<BR>
 <HR>
 <H1><A NAME=1>1 Scope</A></H1>
 <H2><A NAME=1_1>1.1 Identification</A></H2>
- This interface design description document provides detailed file 
+<P>This interface design description document provides detailed file 
 formats, message formats, and program conventions for the Common UNIX 
-Printing System (&quot;CUPS&quot;) Version 1.0. 
+Printing System (&quot;CUPS&quot;) Version 1.0. </P>
 <H2><A NAME=1_2>1.2 System Overview</A></H2>
- The Common UNIX Printing System provides a portable printing layer for 
- UNIX&reg; operating systems. It has been developed by Easy Software 
+<P>The Common UNIX Printing System provides a portable printing layer 
+for  UNIX&reg; operating systems. It has been developed by Easy Software 
 Products to promote a standard printing solution for all UNIX vendors 
 and users. CUPS provides the System V and Berkeley command-line 
-interfaces. 
+interfaces. </P>
 <P>CUPS uses the Internet Printing Protocol (IETF-IPP) as the basis for 
 managing print jobs and queues. The Line Printer Daemon (LPD, RFC1179), 
 Server Message Block (SMB), and AppSocket protocols are also supported 
@@ -85,20 +100,23 @@ with reduced functionality. </P>
 <P>CUPS adds network printer browsing and PostScript Printer 
 Description (&quot;PPD&quot;)-based printing options to support real world 
 applications under UNIX. </P>
+<P>CUPS also includes a customized version of GNU GhostScript 
+(currently based off GNU GhostScript 4.03) and an image file RIP that 
+can be used to support non-PostScript printers. </P>
 <H2><A NAME=1_3>1.3 Document Overview</A></H2>
- This interface design description document is organized into the 
-following sections: 
+<P>This interface design description document is organized into the 
+following sections: </P>
 <UL>
 <LI>1 - Scope </LI>
 <LI>2 - References </LI>
 <LI>3 - Internal Interfaces </LI>
 <LI>4 - External Interfaces </LI>
-<LI>5 - Command-Line Interfaces </LI>
+<LI>5 - Directories </LI>
 <LI>A - Glossary </LI>
 </UL>
 <H1><A NAME=2>2 References</A></H1>
 <H2><A NAME=2_1>2.1 CUPS Documentation</A></H2>
- The following CUPS documentation is referenced by this document: 
+<P>The following CUPS documentation is referenced by this document: </P>
 <UL>
 <LI>CUPS-CMP-1.0: CUPS Configuration Management Plan </LI>
 <LI>CUPS-IDD-1.0: CUPS System Interface Design Description </LI>
@@ -111,7 +129,7 @@ following sections:
 <LI>CUPS-SVD-1.0.x: CUPS Software Version Description </LI>
 </UL>
 <H2><A NAME=2_2>2.2 Other Documents</A></H2>
- The following non-CUPS documents are referenced by this document: 
+<P>The following non-CUPS documents are referenced by this document: </P>
 <UL>
 <LI>IEEE 1387.4, System Administration: Printing (draft) </LI>
 <LI>IPP/1.0: Additional Optional Operations - Set 1 </LI>
@@ -122,28 +140,285 @@ following sections:
 </UL>
 <H1><A NAME=3>3 Internal Interfaces</A></H1>
 <H2><A NAME=3_1>3.1 Character Set Files</A></H2>
+<P>The character set files define a mapping between 8-bit characters 
+and the Unicode character set. They are named using the ISO standard 
+number defined for the character set. Each file consists of up to 256 
+lines of ASCII text. Each line consists of two hexadecimal numbers; the 
+first number is the character number in the character set (0x00 to 
+0xff), and the second number is the Unicode character number (0x0000 to 
+0xffff). </P>
 <H2><A NAME=3_2>3.2 Language Files</A></H2>
+<P>The language files define the default character set and a collection 
+of text messages in that language. They are named by prefixing the 
+string &quot;cups_&quot; to the front of the language specifier (e.g. &quot;cups_en&quot;, 
+&quot;cups_fr&quot;, etc.) Each file consists of two or more lines of ASCII text. </P>
+<P>The first line identifies the character set to be used for the 
+messages. The currently recognized values are: </P>
+<UL>
+<LI>us-ascii </LI>
+<LI>utf-8 </LI>
+<LI>iso-8859-1 </LI>
+<LI>iso-8859-2 </LI>
+<LI>iso-8859-3 </LI>
+<LI>iso-8859-4 </LI>
+<LI>iso-8859-5 </LI>
+<LI>iso-8859-6 </LI>
+<LI>iso-8859-7 </LI>
+<LI>iso-8859-8 </LI>
+<LI>iso-8859-9 </LI>
+<LI>iso-8859-14 </LI>
+<LI>iso-8859-15 </LI>
+</UL>
+<P>The second and succeeding lines define text messages. If the message 
+text is preceded by a number, then the current message number is 
+updated and the text after the number is used. </P>
 <H2><A NAME=3_3>3.3 MIME Files</A></H2>
+<P>CUPS uses two MIME files in its standard configuration. </P>
 <H3><A NAME=3_3_1>3.3.1 mime.types</A></H3>
+<P>The mime.types file defines the recognized file types and consists 
+of 1 or more lines of ASCII text. Comment lines start with the pound 
+(&quot;#&quot;) character. The backslash (&quot;\&quot;) character can be used at the end 
+of a line to continue that line to the next. </P>
+<P>Each non-blank line starts with a MIME type identifier 
+(&quot;super/type&quot;) as registered with the IANA. All text following the MIME 
+type is treated as a series of type recognition rules: </P>
+<UL>
+<PRE>
+mime-type := super &quot;/&quot; type { SP rule }*
+super := { &quot;a-z&quot; | &quot;A-Z&quot; }*
+type := { &quot;a-z&quot; | &quot;A-Z&quot; | &quot;-&quot; | &quot;.&quot; | &quot;0-9&quot; }*
+rule := { extension | match | operator | &quot;(&quot; rule &quot;)&quot; }*
+extension := { &quot;a-z&quot; | &quot;A-Z&quot; | &quot;0-9&quot; }*
+match := &quot;match(&quot; regexp &quot;)&quot; |
+         &quot;ascii(&quot; offset &quot;,&quot; length &quot;)&quot; |
+	 &quot;printable(&quot; offset &quot;,&quot; length &quot;)&quot; |
+	 &quot;string(&quot; offset &quot;,&quot; string &quot;)&quot; |
+	 &quot;char(&quot; offset &quot;,&quot; value &quot;)&quot; |
+	 &quot;short(&quot; offset &quot;,&quot; value &quot;)&quot; |
+	 &quot;int(&quot; offset &quot;,&quot; value &quot;)&quot; |
+	 &quot;locale(&quot; string &quot;)&quot;
+operator := &quot;+&quot; |	[ logical AND ]
+            &quot;,&quot; | SP    [ logical OR ]
+	    &quot;!&quot;         [ unary NOT ]
+</PRE>
+</UL>
+<P>The <CODE>int</CODE> and <CODE>short</CODE> rules match look for 
+integers in network byte order (a.k.a. big-endian) with the 
+most-significant byte first. </P>
 <H3><A NAME=3_3_2>3.3.2 mime.convs</A></H3>
-<H2><A NAME=3_4>3.4 PPD Files</A></H2>
+<P>The mime.types file defines the recognized file filters and consists 
+of 1 or more lines of ASCII text. Comment lines start with the pound 
+(&quot;#&quot;) character. </P>
+<P>Each non-blank line starts with two MIME type identifiers 
+(&quot;super/type&quot;) representing the source and destination types. Following 
+the MIME types are a cost value (0 to 100) and the filter program to 
+use. If the filter program is not specified using the full path then it 
+must reside in the CUPS filter directory. </P>
+<H2><A NAME=3_4>3.4 PostScript Printer Description Files</A></H2>
+<P>The PostScript Printer Description (PPD) file format is described in <A
+HREF=http://partners.adobe.com/supportservice/devrelations/PDFS/TN/5003.PPD_Spec_v4.3.pdf>
+Adobe TechNote #5003: PostScript Printer Description File Format 
+Specification Version 4.3</A>. </P>
+<H3><A NAME=3_4_1>3.4.1 CUPS Extensions to PPD Files</A></H3>
+<P>CUPS adds several new attributes that are described below. </P>
+<H4>3.4.1.1 cupsFilter</H4>
+<P>This string attribute provides a conversion rule of the form: </P>
+<UL>
+<PRE>
+source/type cost program
+</PRE>
+</UL>
+<P>The destination type is assumed to the printer's type. If a printer 
+supports the source type directly the special filter program &quot;-&quot; may be 
+specified. </P>
+<H4>3.4.1.2 cupsManualCopies</H4>
+<P>This boolean attribute notifies the RIP filters that the destination 
+printer does not support copy generation in hardware. The default value 
+is false. </P>
+<H4>3.4.1.3 cupsModelNumber</H4>
+<P>This integer attribute specifies a printer-specific model number. 
+This number can be used by a filter program to adjust the output for a 
+specific model of printer. </P>
+<H4>3.4.1.4 cupsProfile</H4>
+<P>This string attribute specifies a color profile of the form: </P>
+<UL>
+<PRE>
+resolution/type density m00 m01 m02 m10 m11 m12 m20 m21 m22
+</PRE>
+</UL>
+<P>The <I>resolution</I> and <I>type</I> values may be &quot;-&quot; to act as a 
+wildcard. Otherwise they must match one of the <CODE>Resolution</CODE>
+ or <CODE>MediaType</CODE> attributes defined in the PPD file. </P>
+<P>The <I>density</I> value defines a gamma and density adjustment 
+function such that: </P>
+<UL>
+<PRE>
+f(x) = d * x<SUP>1/d</SUP>
+</PRE>
+</UL>
+<P>The <I>m00</I> through <I>m22</I> values define a 3x3 transformation 
+matrix for the CMY color values. The density function is applied <I>
+after</I> the CMY transformation. </P>
+<H4>3.4.1.5 cupsVersion</H4>
+<P>This required attribute describes which version of the CUPS IDD was 
+used for the PPD file extensions. Currently it must be the string 
+&quot;1.0&quot;. </P>
 <H2><A NAME=3_5>3.5 Scheduler Configuration Files</A></H2>
-<H3><A NAME=3_5_1>3.5.1 cupsd.conf</A></H3>
-<H3><A NAME=3_5_2>3.5.2 printers.conf</A></H3>
-<H3><A NAME=3_5_3>3.5.3 classes.conf</A></H3>
+<P>The scheduler reads three configuration files that define the 
+available printers, classes, and services: </P>
+<DL>
+<DT>classes.conf </DT>
+<DD>This file defines all of the printer classes known to the  system. </DD>
+<DT>cupsd.conf </DT>
+<DD>This file defines the files, directories, passwords, etc.  used by 
+the scheduler. </DD>
+<DT>printers.conf </DT>
+<DD>This file defines all of the printers known to the system. </DD>
+</DL>
+<H3><A NAME=3_5_1>3.5.1 classes.conf</A></H3>
+<P>The classes.conf file consists of 1 or more lines of ASCII text. 
+ Comment lines start with the pound (&quot;#&quot;) character. </P>
+<P>Each non-blank line starts with the name of a configuration 
+directive followed by its value. The following directives are 
+understood: 
+<CENTER>
+<TABLE BORDER=1 WIDTH=90%>
+<TR><TH WIDTH=25%>Directive</TH><TH>Description</TH></TR>
+<TR><TD>&lt;Class name&gt;
+<BR> &lt;/Class&gt;</TD><TD></TR>
+<TR><TD>&lt;DefaultClass name&gt;
+<BR> &lt;/Class&gt;</TD><TD></TR>
+<TR><TD>Info</TD><TD></TR>
+<TR><TD>Location</TD><TD></TR>
+<TR><TD>MoreInfo</TD><TD></TR>
+<TR><TD>Printer</TD><TD></TR>
+</TABLE>
+</CENTER>
+</P>
+<H3><A NAME=3_5_2>3.5.2 cupsd.conf</A></H3>
+<P>The cupsd.conf file consists of 1 or more lines of ASCII text. 
+ Comment lines start with the pound (&quot;#&quot;) character. </P>
+<P>Each non-blank line starts with the name of a configuration 
+directive followed by its value. The following directives are 
+understood: 
+<CENTER>
+<TABLE BORDER=1 WIDTH=90%>
+<TR><TH WIDTH=25%>Directive</TH><TH>Description</TH></TR>
+<TR><TD>AccessLog</TD><TD>Specifies the location of the access log file 
+(default  &quot;logs/access_log&quot;).</TD></TR>
+<TR><TD>Allow</TD><TD></TR>
+<TR><TD>AuthClass</TD><TD></TR>
+<TR><TD>AuthType</TD><TD></TR>
+<TR><TD>BrowseAddress</TD><TD></TR>
+<TR><TD>BrowseInterval</TD><TD></TR>
+<TR><TD>BrowsePort</TD><TD></TR>
+<TR><TD>BrowseTimeout</TD><TD></TR>
+<TR><TD>Browsing</TD><TD></TR>
+<TR><TD>DefaultCharset</TD><TD></TR>
+<TR><TD>DefaultLanguage</TD><TD></TR>
+<TR><TD>Deny</TD><TD></TR>
+<TR><TD>DocumentRoot</TD><TD></TR>
+<TR><TD>ErrorLog</TD><TD></TR>
+<TR><TD>Group</TD><TD></TR>
+<TR><TD>HostNameLookups</TD><TD></TR>
+<TR><TD>ImplicitClasses</TD><TD></TR>
+<TR><TD>KeepAlive</TD><TD></TR>
+<TR><TD>KeepAliveTimeout</TD><TD></TR>
+<TR><TD>&lt;Location path&gt;
+<BR> &lt;/Location&gt;</TD><TD></TR>
+<TR><TD>LogLevel</TD><TD></TR>
+<TR><TD>MaxLogSize</TD><TD></TR>
+<TR><TD>MaxRequestSize</TD><TD></TR>
+<TR><TD>Order</TD><TD></TR>
+<TR><TD>PageLog</TD><TD></TR>
+<TR><TD>Port</TD><TD></TR>
+<TR><TD>RIPCache</TD><TD></TR>
+<TR><TD>ServerAdmin</TD><TD></TR>
+<TR><TD>ServerName</TD><TD></TR>
+<TR><TD>ServerRoot</TD><TD></TR>
+<TR><TD>SystemGroup</TD><TD></TR>
+<TR><TD>Timeout</TD><TD></TR>
+<TR><TD>User</TD><TD></TR>
+</TABLE>
+</CENTER>
+</P>
+<H3><A NAME=3_5_3>3.5.3 printers.conf</A></H3>
+<P>The printers.conf file consists of 1 or more lines of ASCII text. 
+ Comment lines start with the pound (&quot;#&quot;) character. </P>
+<P>Each non-blank line starts with the name of a configuration 
+directive followed by its value. The following directives are 
+understood: 
+<CENTER>
+<TABLE BORDER=1 WIDTH=90%>
+<TR><TH WIDTH=25%>Directive</TH><TH>Description</TH></TR>
+<TR><TD>&lt;DefaultPrinter name&gt;
+<BR> &lt;/Printer&gt;</TD><TD></TR>
+<TR><TD>DeviceURI</TD><TD></TR>
+<TR><TD>Info</TD><TD></TR>
+<TR><TD>Location</TD><TD></TR>
+<TR><TD>MoreInfo</TD><TD></TR>
+<TR><TD>&lt;Printer name&gt;
+<BR> &lt;/Printer&gt;</TD><TD></TR>
+<TR><TD>State</TD><TD></TR>
+</TABLE>
+</CENTER>
+</P>
 <H1><A NAME=4>4 External Interfaces</A></H1>
-<H2><A NAME=4_1>4.1 Application Socket Protocol</A></H2>
+<H2><A NAME=4_1>4.1 AppSocket Protocol</A></H2>
+<P>The AppSocket protocol is an 8-bit clean TCP/IP socket connection. 
+The default IP service port is 9100. </P>
 <H2><A NAME=4_2>4.2 CUPS Browsing Protocol</A></H2>
+<P>The CUPS Browsing Protocol is a UDP/IP-based broadcast service. By 
+default this service operates on IP service port 631. </P>
+<P>Each broadcast packet describes the state of a single printer or 
+class and is an ASCII text string of up to 1450 bytes ending with a 
+newline (0x0a). The string is formatted as follows: </P>
+<UL>
+<PRE>
+type SP state SP uri NL
+</PRE>
+</UL>
+<P>The <I>state</I> and <I>uri</I> values correspond to the IPP <CODE>
+printer-state</CODE> and <CODE>printer-uri-supported</CODE> attributes. </P>
+<P>The <I>type</I> value is a hexadecimal number string representing 
+capability/type bits: 
+<CENTER>
+<TABLE BORDER=1 WIDTH=40%>
+<TR><TH WIDTH=8%>Bit</TH><TH>Description</TH></TR>
+<TR><TD>0</TD><TD>0 = printer
+<BR> 1 = class</TD></TR>
+<TR><TD>1</TD><TD>0 = local
+<BR> 1 = remote</TD></TR>
+<TR><TD>2</TD><TD>1 = can print B</TD></TR>
+<TR><TD>3</TD><TD>1 = can print color</TD></TR>
+<TR><TD>4</TD><TD>1 = can duplex</TD></TR>
+<TR><TD>5</TD><TD>1 = can staple</TD></TR>
+<TR><TD>6</TD><TD>1 = can do fast copies</TD></TR>
+<TR><TD>7</TD><TD>1 = can do fast collating</TD></TR>
+<TR><TD>8</TD><TD>1 = can punch holes</TD></TR>
+<TR><TD>9</TD><TD>1 = can cover</TD></TR>
+<TR><TD>10</TD><TD>1 = can bind</TD></TR>
+<TR><TD>11</TD><TD>1 = can sort</TD></TR>
+<TR><TD>12</TD><TD>1 = can print up to 9x14 inches</TD></TR>
+<TR><TD>13</TD><TD>1 = can print up to 18x24 inches</TD></TR>
+<TR><TD>14</TD><TD>1 = can print up to 36x48 inches</TD></TR>
+<TR><TD>15</TD><TD>1 = can print variable sizes</TD></TR>
+</TABLE>
+</CENTER>
+</P>
 <H2><A NAME=4_3>4.3 CUPS PostScript File</A></H2>
- CUPS PostScript files are device-dependent Adobe PostScript program 
-files. The PostScript language is described in the PostScript Language 
-Reference Manual, Third Edition. 
+<P>CUPS PostScript files are device-dependent Adobe PostScript program 
+files. The PostScript language is described in the <A HREF=http://partners.adobe.com/supportservice/devrelations/PDFS/TN/PLRM.pdf>
+Adobe PostScript Language Reference Manual, Third Edition</A>. </P>
+<P>The MIME type for CUPS PostScript files is <CODE>
+application/vnd.cups-postscript</CODE>. </P>
 <H2><A NAME=4_4>4.4 CUPS Raster File</A></H2>
- CUPS raster files are device-dependent raster image files that contain 
-a PostScript page device dictionary and device-dependent raster imagery 
-for each page in the document.  These files are used to transfer raster 
-data from the PostScript and image file RIPs to device-dependent 
-filters that convert the raster data to a printable format. 
+<P>CUPS raster files are device-dependent raster image files that 
+contain a PostScript page device dictionary and device-dependent raster 
+imagery for each page in the document.  These files are used to 
+transfer raster data from the PostScript and image file RIPs to 
+device-dependent filters that convert the raster data to a printable 
+format. </P>
 <P>A raster file begins with a four byte synchronization word: 
 0x52615374 (&quot;RaSt&quot;) for big-endian architectures and 0x74536152 
 (&quot;tSaR&quot;) for little-endian architectures.  The writer of the raster 
@@ -156,7 +431,8 @@ automatically. </P>
 immediately by the raster data for that page. 
 <CENTER>
 <TABLE BORDER=1 WIDTH=80%>
-<TR><TH>Bytes</TH><TH>Description</TH><TH>Values</TH></TR>
+<TR><TH WIDTH=10%>Bytes</TH><TH WIDTH=20%>Description</TH><TH>Values</TH>
+</TR>
 <TR><TD>0-63</TD><TD>MediaClass</TD><TD>Nul-terminated ASCII string</TD></TR>
 <TR><TD>64-127</TD><TD>MediaColor</TD><TD>Nul-terminated ASCII string</TD>
 </TR>
@@ -165,7 +441,7 @@ immediately by the raster data for that page.
 <TR><TD>192-255</TD><TD>OutputType</TD><TD>Nul-terminated ASCII string</TD>
 </TR>
 <TR><TD>256-259</TD><TD>AdvanceDistance</TD><TD>0 to 2<SUP>32</SUP> - 1 
-pixels</TD></TR>
+points</TD></TR>
 <TR><TD>260-263</TD><TD>AdvanceMedia</TD><TD>0 = Never advance roll
 <BR> 1 = Advance roll after file
 <BR> 2 = Advance roll after job
@@ -184,7 +460,7 @@ pixels</TD></TR>
 resolution in dots-per-inch.</TD></TR>
 <TR><TD>284-299</TD><TD>ImagingBoundingBox</TD><TD>Four integers giving 
 the left, bottom, right, and top positions  of the page bounding box in 
-pixels</TD></TR>
+points</TD></TR>
 <TR><TD>300-303</TD><TD>InsertSheet</TD><TD>0 = Do not insert separator 
 sheets
 <BR> 1 = Insert separator sheets</TD></TR>
@@ -197,7 +473,7 @@ sheets
 <BR> 2 = Bottom edge is first
 <BR> 3 = Left edge is first</TD></TR>
 <TR><TD>312-319</TD><TD>Margins</TD><TD>Left and bottom origin of image 
-in pixels</TD></TR>
+in points</TD></TR>
 <TR><TD>320-323</TD><TD>ManualFeed</TD><TD>0 = Do not manually feed 
 media
 <BR> 1 = Manually feed media</TD></TR>
@@ -207,24 +483,211 @@ media
 meter squared</TD></TR>
 <TR><TD>332-335</TD><TD>MirrorPrint</TD><TD>0 = Do not mirror prints
 <BR> 1 = Mirror prints</TD></TR>
-<TR><TD>336-339</TD><TD>NegativePrint</TD><TD></TR>
-<TR><TD><TD><TD></TR>
-<TR><TD><TD><TD></TR>
-<TR><TD><TD><TD></TR>
-<TR><TD><TD><TD></TR>
-<TR><TD><TD><TD></TR>
+<TR><TD>336-339</TD><TD>NegativePrint</TD><TD>0 = Do not invert prints
+<BR> 1 = Invert prints</TD></TR>
+<TR><TD>340-343</TD><TD>NumCopies</TD><TD>1 to 2<SUP>32</SUP> - 1</TD></TR>
+<TR><TD>344-347</TD><TD>Orientation</TD><TD>0 = Do not rotate page
+<BR> 1 = Rotate page counter-clockwise
+<BR> 2 = Turn page upside down
+<BR> 3 = Rotate page clockwise</TD></TR>
+<TR><TD>348-351</TD><TD>OutputFaceUp</TD><TD>0 = Output face down
+<BR> 1 = Output face up</TD></TR>
+<TR><TD>352-359</TD><TD>PageSize</TD><TD>Width and length in points</TD></TR>
+<TR><TD>360-363</TD><TD>Separations</TD><TD>0 = Print composite image
+<BR> 1 = Print color separations</TD></TR>
+<TR><TD>364-367</TD><TD>TraySwitch</TD><TD>0 = Do not change trays if 
+selected tray is empty
+<BR> 1 = Change trays if selected tray is empty</TD></TR>
+<TR><TD>368-371</TD><TD>Tumble</TD><TD>0 = Do not rotate even pages 
+when duplexing
+<BR> 1 = Rotate even pages when duplexing</TD></TR>
+<TR><TD>372-375</TD><TD>cupsWidth</TD><TD>Width of page image in pixels</TD>
+</TR>
+<TR><TD>376-379</TD><TD>cupsHeight</TD><TD>Height of page image in 
+pixels</TD></TR>
+<TR><TD>380-383</TD><TD>cupsMediaType</TD><TD>Driver-specific 0 to 2<SUP>
+32</SUP> - 1</TD></TR>
+<TR><TD>384-387</TD><TD>cupsBitsPerColor</TD><TD>1, 2, 4, 8 bits</TD></TR>
+<TR><TD>388-391</TD><TD>cupsBitsPerPixel</TD><TD>1 to 32 bits</TD></TR>
+<TR><TD>392-395</TD><TD>cupsBytesPerLine</TD><TD>1 to 2<SUP>32</SUP> - 
+1 bytes</TD></TR>
+<TR><TD>396-399</TD><TD>cupsColorOrder</TD><TD>0 = chunky pixels (CMYK 
+CMYK CMYK)
+<BR> 1 = banded pixels (CCC MMM YYY KKK)
+<BR> 2 = planar pixels (CCC... MMM... YYY... KKK...)</TD></TR>
+<TR><TD>400-403</TD><TD>cupsColorSpace</TD><TD>0 = white
+<BR> 1 = RGB
+<BR> 2 = RGBA
+<BR> 3 = black
+<BR> 4 = CMY
+<BR> 5 = YMC
+<BR> 6 = CMYK
+<BR> 7 = YMCK
+<BR> 8 = KCMY
+<BR> 9 = KCMYcm</TD></TR>
+<TR><TD>404-407</TD><TD>cupsCompression</TD><TD>Driver-specific 0 to 2<SUP>
+32</SUP> - 1</TD></TR>
+<TR><TD>408-411</TD><TD>cupsRowCount</TD><TD>Driver-specific 0 to 2<SUP>
+32</SUP> - 1</TD></TR>
+<TR><TD>412-415</TD><TD>cupsRowFeed</TD><TD>Driver-specific 0 to 2<SUP>
+32</SUP> - 1</TD></TR>
+<TR><TD>416-419</TD><TD>cupsRowStep</TD><TD>Driver-specific 0 to 2<SUP>
+32</SUP> - 1</TD></TR>
 </TABLE>
 </CENTER>
 </P>
-<H2><A NAME=4_5>4.5 Internet Printing Protocol</A></H2>
-<H2><A NAME=4_6>4.6 Line Printer Daemon Protocol</A></H2>
-<H2><A NAME=4_7>4.7 Parallel Device</A></H2>
-<H2><A NAME=4_8>4.8 Serial Device</A></H2>
+<P>The MIME type for CUPS Raster files is <CODE>
+application/vnd.cups-raster</CODE>. </P>
+<H2><A NAME=4_5>4.5 CUPS Raw Files</A></H2>
+<P>Raw files are printer-dependent print files that are in a format 
+suitable to the destination printer (e.g. HP-PCL, HP-RTL, etc.) The 
+MIME type for CUPS Raw files is <CODE>application/vnd.cups-raw</CODE>. </P>
+<H2><A NAME=4_6>4.6 File Transfer Protocol</A></H2>
+<P>The File Transfer Protocol (FTP) is described by <A HREF=http://www.ietf.org/rfc/rfc959.txt>
+RFC 959: File Transfer Protocol</A>. </P>
+<H2><A NAME=4_7>4.7 Internet Printing Protocol</A></H2>
+<P>The Internet Printing Protocol is described by the following RFCs: </P>
+<UL>
+<LI><A HREF=http://www.ietf.org/rfc/rfc2565.txt>RFC 2565: Internet 
+Printing Protocol/1.0: Encoding and Transport</A></LI>
+<LI><A HREF=http://www.ietf.org/rfc/rfc2566.txt>RFC 2566: Internet 
+Printing Protocol/1.0: Model and Semantics</A></LI>
+<LI><A HREF=http://www.ietf.org/rfc/rfc2567.txt>RFC 2567: Design Goals 
+for an Internet Printing Protocol</A></LI>
+<LI><A HREF=http://www.ietf.org/rfc/rfc2568.txt>RFC 2568: Rationale for 
+the Structure of the Model and Protocol  for the Internet Printing 
+Protocol</A></LI>
+<LI><A HREF=http://www.ietf.org/rfc/rfc2569.txt>RFC 2569: Mapping 
+between LPD and IPP Protocols</A></LI>
+</UL>
+<P>CUPS defines the following extension operations to IPP. </P>
+<H3><A NAME=4_7_1>4.7.1 Get Default Destination (CUPS_GET_DEFAULT = 
+0x4001)</A></H3>
+<P>The get default destination operation returns the printer attributes 
+for the system default printer or class. The only required attributes 
+are <CODE>attributes-charset</CODE> and <CODE>
+attributes-natural-language</CODE>. </P>
+<P>Get default destination will only return <CODE>ipp-ok</CODE>. </P>
+<H3><A NAME=4_7_2>4.7.2 Get Printers (CUPS_GET_PRINTERS = 0x4002)</A></H3>
+<P>The get printers operation returns the printer attributes for all 
+printers known to the system. The only required attributes are <CODE>
+attributes-charset</CODE> and <CODE>attributes-natural-language</CODE>. </P>
+<P>Get printers will only return <CODE>ipp-ok</CODE>. </P>
+<H3><A NAME=4_7_3>4.7.3 Add Printer (CUPS_ADD_PRINTER = 0x4003)</A></H3>
+<P>The add printer operation adds or replaces the specified printer. 
+The <CODE>attributes-charset</CODE>, <CODE>attributes-natural-language</CODE>
+ and <CODE>printer-uri</CODE> attributes are required. </P>
+<P>The <CODE>printer-location</CODE>, <CODE>printer-info</CODE>, <CODE>
+printer-more-info</CODE>, and <CODE>device-uri</CODE> attributes are 
+required when initially adding a printer and optional when modifying a 
+printer. </P>
+<P>A PPD file or System V interface script may follow the IPP request 
+body. Note that the printer will be disabled until a valid interface 
+script or PPD file is sent. </P>
+<P>Add printer will return <CODE>ipp-ok</CODE>, <CODE>ipp-not-authorized</CODE>
+, <CODE>ipp-bad-request</CODE>, or <CODE>ipp-attributes</CODE>. </P>
+<H3><A NAME=4_7_4>4.7.4 Delete Printer (CUPS_DELETE_PRINTER = 0x4004)</A>
+</H3>
+<P>The delete printer operation removes the specified printer. The only 
+required attributes are <CODE>attributes-charset</CODE>, <CODE>
+attributes-natural-language</CODE>, and <CODE>printer-uri</CODE>. </P>
+<P>Delete printer will return <CODE>ipp-ok</CODE>, <CODE>ipp-not-found</CODE>
+, or <CODE>ipp-not-authorized</CODE>. </P>
+<H3><A NAME=4_7_5>4.7.5 Get Classes (CUPS_GET_CLASSES = 0x4005)</A></H3>
+<P>The get classes operation returns the printer attributes for all 
+classes known to the system. The only required attributes are <CODE>
+attributes-charset</CODE> and <CODE>attributes-natural-language</CODE>. </P>
+<P>Get classes will only return <CODE>ipp-ok</CODE>. </P>
+<H3><A NAME=4_7_6>4.7.6 Add Class (CUPS_ADD_CLASS = 0x4006)</A></H3>
+<P>The add class operation adds or replaces the specified class. The <CODE>
+attributes-charset</CODE>, <CODE>attributes-natural-language</CODE>, 
+and <CODE>printer-uri</CODE> attributes are required. </P>
+<P>The <CODE>printer-location</CODE>, <CODE>printer-info</CODE>, <CODE>
+printer-more-info</CODE>, and <CODE>member-uris</CODE> attributes are 
+required when initially adding a printer and optional when modifying a 
+printer. </P>
+<P>Add class will return <CODE>ipp-ok</CODE>, <CODE>ipp-not-authorized</CODE>
+, <CODE>ipp-bad-request</CODE>, or <CODE>ipp-attributes</CODE>. </P>
+<H3><A NAME=4_7_7>4.7.7 Delete Class (CUPS_DELETE_CLASS = 0x4007)</A></H3>
+<P>The delete class operation removes the specified class. The only 
+required attributes are <CODE>attributes-charset</CODE>, <CODE>
+attributes-natural-language</CODE>, and <CODE>printer-uri</CODE>. </P>
+<P>Delete class will return <CODE>ipp-ok</CODE>, <CODE>ipp-not-found</CODE>
+, or <CODE>ipp-not-authorized</CODE>. </P>
+<H3><A NAME=4_7_8>4.7.8 Accept Jobs (CUPS_ACCEPT_JOBS = 0x4008)</A></H3>
+<P>The accept jobs operation allows jobs to be accepted by the 
+specified destination. The only required attributes are <CODE>
+attributes-charset</CODE>, <CODE>attributes-natural-language</CODE>, 
+and <CODE>printer-uri</CODE>. </P>
+<P>Accept jobs will return <CODE>ipp-ok</CODE>, <CODE>ipp-not-found</CODE>
+, or <CODE>ipp-not-authorized</CODE>. </P>
+<H3><A NAME=4_7_9>4.7.9 Reject Jobs (CUPS_REJECT_JOBS = 0x4009)</A></H3>
+<P>The reject jobs operation prevents jobs from being accepted by the 
+specified destination. The only required attributes are <CODE>
+attributes-charset</CODE>, <CODE>attributes-natural-language</CODE>, 
+and <CODE>printer-uri</CODE>. </P>
+<P>Reject jobs will return <CODE>ipp-ok</CODE>, <CODE>ipp-not-found</CODE>
+, or <CODE>ipp-not-authorized</CODE>. </P>
+<H3><A NAME=4_7_10>4.7.10 Set Default Destination (CUPS_SET_DEFAULT = 
+0x400A)</A></H3>
+<P>The set default destination operation returns the printer attributes 
+for the system default printer or class. The only required attributes 
+are <CODE>attributes-charset</CODE>, <CODE>attributes-natural-language</CODE>
+, and <CODE>printer-uri</CODE>. </P>
+<P>Set default destination will return <CODE>ipp-ok</CODE>, <CODE>
+ipp-not-authorized</CODE>, <CODE>ipp-bad-request</CODE>, or <CODE>
+ipp-not-found</CODE>. </P>
+<H2><A NAME=4_8>4.8 Line Printer Daemon Protocol</A></H2>
+<P>The Line Printer Daemon (LPD) protocol is described by <A HREF=http://www.ietf.org/rfc/rfc1179.txt>
+RFC 1179: Line Printer Daemon Protocol</A>. </P>
 <H2><A NAME=4_9>4.9 Server Message Block Protocol</A></H2>
+<P>The Server Message Block (SMB) and related Common Internet File 
+System (CIFS) protocols are described at <A HREF=http://anu.samba.org/cifs>
+http://anu.samba.org/cifs</A>. </P>
 <H2><A NAME=4_10>4.10 Trivial File Transfer Protocol</A></H2>
-<H1><A NAME=5>5 Command-Line Interfaces</A></H1>
-<H2><A NAME=5_1>5.1 Backend Interfaces</A></H2>
-<H2><A NAME=5_2>5.2 Filter Interfaces</A></H2>
+<P>The Trivial File Transfer Protocol (TFTP) is described by <A HREF=http://www.ietf.org/rfc/rfc1350.txt>
+RFC 1350: The TFTP Protocol (Revision 2)</A>. </P>
+<H1><A NAME=5>5 5 - Directories</A></H1>
+<DL>
+<DT>/usr/bin </DT>
+<DD>The <CODE>cancel</CODE>, <CODE>lp</CODE>, <CODE>lpq</CODE>, <CODE>
+lpr</CODE>, <CODE>lprm</CODE>, and <CODE>lpstat</CODE> commands  reside 
+here. </DD>
+<DT>/usr/lib </DT>
+<DD>The <CODE>accept</CODE>, <CODE>disable</CODE>, <CODE>enable</CODE>, <CODE>
+lpadmin</CODE>, and <CODE>reject</CODE> commands reside here. </DD>
+<DT>/usr/sbin </DT>
+<DD>The <CODE>lpc</CODE> and <CODE>cupsd</CODE> commands resize here. </DD>
+<DT>/usr/share/cups </DT>
+<DD>The character set and filter data files reside here. </DD>
+<DT>/usr/share/cups/fonts </DT>
+<DD>The <CODE>pstoraster</CODE> font files reside here. </DD>
+<DT>/usr/share/cups/model </DT>
+<DD>The sample PPD files reside here. </DD>
+<DT>/usr/share/cups/pstoraster </DT>
+<DD>The <CODE>pstoraster</CODE> data files reside here. </DD>
+<DT>/var/cups </DT>
+<DD>This is the root directory of the CUPS scheduler. </DD>
+<DT>/var/cups/backend </DT>
+<DD>The backend filters reside here. </DD>
+<DT>/var/cups/cgi-bin </DT>
+<DD>The CGI programs reside here. </DD>
+<DT>/var/cups/conf </DT>
+<DD>The scheduler configuration and MIME files reside here. </DD>
+<DT>/var/cups/doc </DT>
+<DD>The scheduler documentation files reside here. </DD>
+<DT>/var/cups/filter </DT>
+<DD>The file filters reside here. </DD>
+<DT>/var/cups/interfaces </DT>
+<DD>System V interface scripts reside here. </DD>
+<DT>/var/cups/logs </DT>
+<DD>The <CODE>access_log</CODE>, <CODE>error_log</CODE>, and <CODE>
+page_log</CODE> files reside here. </DD>
+<DT>/var/cups/ppd </DT>
+<DD>This directory contains PPD files for each printer. </DD>
+<DT>/var/cups/requests </DT>
+<DD>This directory contains pending print job files. </DD>
+</DL>
 <H1 TYPE=A VALUE=1><A NAME=6>A Glossary</A></H1>
 <H2><A NAME=6_1>A.1 Terms</A></H2>
 <DL>
@@ -11,13 +11,13 @@

 <H2>Identification</H2>

-This interface design description document provides detailed file
+<P>This interface design description document provides detailed file
 formats, message formats, and program conventions for the Common UNIX
 Printing System ("CUPS") Version 1.0.

 <H2>System Overview</H2>

-The Common UNIX Printing System provides a portable printing layer for 
+<P>The Common UNIX Printing System provides a portable printing layer for 
 UNIX&reg; operating systems. It has been developed by Easy Software 
 Products to promote a standard printing solution for all UNIX vendors 
 and users. CUPS provides the System V and Berkeley command-line interfaces.
@@ -31,9 +31,13 @@ supported with reduced functionality.
 Description (&quot;PPD&quot;)-based printing options to support real
 world applications under UNIX.

+<P>CUPS also includes a customized version of GNU GhostScript
+(currently based off GNU GhostScript 4.03) and an image file RIP that
+can be used to support non-PostScript printers.
+
 <H2>Document Overview</H2>

-This interface design description document is organized into the following
+<P>This interface design description document is organized into the following
 sections:

 <UL>
@@ -41,7 +45,7 @@ sections:
 	<LI>2 - References
 	<LI>3 - Internal Interfaces
 	<LI>4 - External Interfaces
-	<LI>5 - Command-Line Interfaces
+	<LI>5 - Directories
 	<LI>A - Glossary
 </UL>

@@ -49,7 +53,7 @@ sections:

 <H2>CUPS Documentation</H2>

-The following CUPS documentation is referenced by this document:
+<P>The following CUPS documentation is referenced by this document:

 <UL>
 	<LI>CUPS-CMP-1.0: CUPS Configuration Management Plan 
@@ -65,7 +69,7 @@ The following CUPS documentation is referenced by this document:

 <H2>Other Documents</H2>

-The following non-CUPS documents are referenced by this document:
+<P>The following non-CUPS documents are referenced by this document:

 <UL>
 	<LI>IEEE 1387.4, System Administration: Printing (draft) 
@@ -80,39 +84,522 @@ The following non-CUPS documents are referenced by this document:

 <H2>Character Set Files</H2>

+<P>The character set files define a mapping between 8-bit characters
+and the Unicode character set. They are named using the ISO standard
+number defined for the character set. Each file consists of up to 256
+lines of ASCII text. Each line consists of two hexadecimal numbers; the
+first number is the character number in the character set (0x00 to
+0xff), and the second number is the Unicode character number (0x0000 to
+0xffff).
+
 <H2>Language Files</H2>

+<P>The language files define the default character set and a collection of
+text messages in that language. They are named by prefixing the string "cups_"
+to the front of the language specifier (e.g. "cups_en", "cups_fr", etc.) Each
+file consists of two or more lines of ASCII text.
+
+<P>The first line identifies the character set to be used for the messages.
+The currently recognized values are:
+
+<UL>
+	<LI>us-ascii
+	<LI>utf-8
+	<LI>iso-8859-1
+	<LI>iso-8859-2
+	<LI>iso-8859-3
+	<LI>iso-8859-4
+	<LI>iso-8859-5
+	<LI>iso-8859-6
+	<LI>iso-8859-7
+	<LI>iso-8859-8
+	<LI>iso-8859-9
+	<LI>iso-8859-14
+	<LI>iso-8859-15
+</UL>
+
+<P>The second and succeeding lines define text messages. If the message text
+is preceded by a number, then the current message number is updated and the
+text after the number is used.
+
 <H2>MIME Files</H2>

+<P>CUPS uses two MIME files in its standard configuration.
+
 <H3>mime.types</H3>

+<P>The mime.types file defines the recognized file types and consists
+of 1 or more lines of ASCII text. Comment lines start with the pound
+("#") character. The backslash ("\") character can be used at the end
+of a line to continue that line to the next.
+
+<P>Each non-blank line starts with a MIME type identifier ("super/type")
+as registered with the IANA. All text following the MIME type is treated as
+a series of type recognition rules:
+
+<UL><PRE>
+mime-type := super "/" type { SP rule }*
+super := { "a-z" | "A-Z" }*
+type := { "a-z" | "A-Z" | "-" | "." | "0-9" }*
+rule := { extension | match | operator | "(" rule ")" }*
+extension := { "a-z" | "A-Z" | "0-9" }*
+match := "match(" regexp ")" |
+         "ascii(" offset "," length ")" |
+	 "printable(" offset "," length ")" |
+	 "string(" offset "," string ")" |
+	 "char(" offset "," value ")" |
+	 "short(" offset "," value ")" |
+	 "int(" offset "," value ")" |
+	 "locale(" string ")"
+operator := "+" |	[ logical AND ]
+            "," | SP    [ logical OR ]
+	    "!"         [ unary NOT ]
+</PRE></UL>
+
+<P>The <CODE>int</CODE> and <CODE>short</CODE> rules match look for integers
+in network byte order (a.k.a. big-endian) with the most-significant byte first.
+
 <H3>mime.convs</H3>

-<H2>PPD Files</H2>
+<P>The mime.types file defines the recognized file filters and consists
+of 1 or more lines of ASCII text. Comment lines start with the pound
+("#") character.
+
+<P>Each non-blank line starts with two MIME type identifiers ("super/type")
+representing the source and destination types. Following the MIME types are
+a cost value (0 to 100) and the filter program to use. If the filter program
+is not specified using the full path then it must reside in the CUPS filter
+directory.
+
+<H2>PostScript Printer Description Files</H2>
+
+<P>The PostScript Printer Description (PPD) file format is described in
+<A HREF="http://partners.adobe.com/supportservice/devrelations/PDFS/TN/5003.PPD_Spec_v4.3.pdf">
+Adobe TechNote #5003: PostScript Printer Description File Format
+Specification Version 4.3</A>.
+
+<H3>CUPS Extensions to PPD Files</H3>
+
+<P>CUPS adds several new attributes that are described below.
+
+<H4>cupsFilter</H4>
+
+<P>This string attribute provides a conversion rule of the form:
+
+<UL><PRE>
+source/type cost program
+</PRE></UL>
+
+<P>The destination type is assumed to the printer's type. If a printer
+supports the source type directly the special filter program "-" may be
+specified.
+
+<H4>cupsManualCopies</H4>
+
+<P>This boolean attribute notifies the RIP filters that the destination printer
+does not support copy generation in hardware. The default value is false.
+
+<H4>cupsModelNumber</H4>
+
+<P>This integer attribute specifies a printer-specific model number. This number
+can be used by a filter program to adjust the output for a specific model of
+printer.
+
+<H4>cupsProfile</H4>
+
+<P>This string attribute specifies a color profile of the form:
+
+<UL><PRE>
+resolution/type density m00 m01 m02 m10 m11 m12 m20 m21 m22
+</PRE></UL>
+
+<P>The <I>resolution</I> and <I>type</I> values may be "-" to act as a
+wildcard. Otherwise they must match one of the <CODE>Resolution</CODE> or
+<CODE>MediaType</CODE> attributes defined in the PPD file.
+
+<P>The <I>density</I> value defines a gamma and density adjustment function
+such that:
+
+<UL><PRE>
+f(x) = d * x<SUP>1/d</SUP>
+</PRE></UL>
+
+<P>The <I>m00</I> through <I>m22</I> values define a 3x3 transformation
+matrix for the CMY color values. The density function is applied <I>after</I>
+the CMY transformation.
+
+<H4>cupsVersion</H4>
+
+<P>This required attribute describes which version of the CUPS IDD was used
+for the PPD file extensions. Currently it must be the string "1.0".

 <H2>Scheduler Configuration Files</H2>

-<H3>cupsd.conf</H3>
+<P>The scheduler reads three configuration files that define the available
+printers, classes, and services:

-<H3>printers.conf</H3>
+<DL>
+
+	<DT>classes.conf
+	<DD>This file defines all of the printer classes known to the
+	system.
+
+	<DT>cupsd.conf
+	<DD>This file defines the files, directories, passwords, etc.
+	used by the scheduler.
+
+	<DT>printers.conf
+	<DD>This file defines all of the printers known to the system.
+
+</DL>

 <H3>classes.conf</H3>

+<P>The classes.conf file consists of 1 or more lines of ASCII text. 
+Comment lines start with the pound ("#") character.
+
+<P>Each non-blank line starts with the name of a configuration directive
+followed by its value. The following directives are understood:
+
+<CENTER><TABLE WIDTH="90%" BORDER="1">
+<TR>
+	<TH WIDTH="25%">Directive</TH>
+	<TH>Description</TH>
+</TR>
+<TR>
+	<TD>&lt;Class name&gt;<BR>
+	&lt;/Class&gt;</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>&lt;DefaultClass name&gt;<BR>
+	&lt;/Class&gt;</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>Info</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>Location</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>MoreInfo</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>Printer</TD>
+	<TD></TD>
+</TR>
+</TABLE></CENTER>
+
+<H3>cupsd.conf</H3>
+
+<P>The cupsd.conf file consists of 1 or more lines of ASCII text. 
+Comment lines start with the pound ("#") character.
+
+<P>Each non-blank line starts with the name of a configuration directive
+followed by its value. The following directives are understood:
+
+<CENTER><TABLE WIDTH="90%" BORDER="1">
+<TR>
+	<TH WIDTH="25%">Directive</TH>
+	<TH>Description</TH>
+</TR>
+<TR>
+	<TD>AccessLog</TD>
+	<TD>Specifies the location of the access log file (default
+	"logs/access_log").</TD>
+</TR>
+<TR>
+	<TD>Allow</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>AuthClass</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>AuthType</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>BrowseAddress</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>BrowseInterval</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>BrowsePort</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>BrowseTimeout</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>Browsing</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>DefaultCharset</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>DefaultLanguage</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>Deny</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>DocumentRoot</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>ErrorLog</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>Group</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>HostNameLookups</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>ImplicitClasses</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>KeepAlive</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>KeepAliveTimeout</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>&lt;Location path&gt;<BR>
+	&lt;/Location&gt;</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>LogLevel</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>MaxLogSize</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>MaxRequestSize</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>Order</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>PageLog</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>Port</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>RIPCache</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>ServerAdmin</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>ServerName</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>ServerRoot</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>SystemGroup</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>Timeout</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>User</TD>
+	<TD></TD>
+</TR>
+</TABLE></CENTER>
+
+<H3>printers.conf</H3>
+
+<P>The printers.conf file consists of 1 or more lines of ASCII text. 
+Comment lines start with the pound ("#") character.
+
+<P>Each non-blank line starts with the name of a configuration directive
+followed by its value. The following directives are understood:
+
+<CENTER><TABLE WIDTH="90%" BORDER="1">
+<TR>
+	<TH WIDTH="25%">Directive</TH>
+	<TH>Description</TH>
+</TR>
+<TR>
+	<TD>&lt;DefaultPrinter name&gt;<BR>
+	&lt;/Printer&gt;</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>DeviceURI</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>Info</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>Location</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>MoreInfo</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>&lt;Printer name&gt;<BR>
+	&lt;/Printer&gt;</TD>
+	<TD></TD>
+</TR>
+<TR>
+	<TD>State</TD>
+	<TD></TD>
+</TR>
+</TABLE></CENTER>
+
 <H1>External Interfaces</H1>

-<H2>Application Socket Protocol</H2>
+<H2>AppSocket Protocol</H2>
+
+<P>The AppSocket protocol is an 8-bit clean TCP/IP socket connection.
+The default IP service port is 9100.

 <H2>CUPS Browsing Protocol</H2>

+<P>The CUPS Browsing Protocol is a UDP/IP-based broadcast service. By default
+this service operates on IP service port 631.
+
+<P>Each broadcast packet describes the state of a single printer or class and
+is an ASCII text string of up to 1450 bytes ending with a newline (0x0a). The
+string is formatted as follows:
+
+<UL><PRE>
+type SP state SP uri NL
+</PRE></UL>
+
+<P>The <I>state</I> and <I>uri</I> values correspond to the IPP
+<CODE>printer-state</CODE> and <CODE>printer-uri-supported</CODE> attributes.
+
+<P>The <I>type</I> value is a hexadecimal number string representing
+capability/type bits:
+
+<CENTER><TABLE WIDTH="40%" BORDER="1">
+<TR>
+	<TH WIDTH="8%">Bit</TH>
+	<TH>Description</TH>
+</TR>
+<TR>
+	<TD>0</TD>
+	<TD>0 = printer<BR>
+	1 = class</TD>
+</TR>
+<TR>
+	<TD>1</TD>
+	<TD>0 = local<BR>
+	1 = remote</TD>
+</TR>
+<TR>
+	<TD>2</TD>
+	<TD>1 = can print B&W</TD>
+</TR>
+<TR>
+	<TD>3</TD>
+	<TD>1 = can print color</TD>
+</TR>
+<TR>
+	<TD>4</TD>
+	<TD>1 = can duplex</TD>
+</TR>
+<TR>
+	<TD>5</TD>
+	<TD>1 = can staple</TD>
+</TR>
+<TR>
+	<TD>6</TD>
+	<TD>1 = can do fast copies</TD>
+</TR>
+<TR>
+	<TD>7</TD>
+	<TD>1 = can do fast collating</TD>
+</TR>
+<TR>
+	<TD>8</TD>
+	<TD>1 = can punch holes</TD>
+</TR>
+<TR>
+	<TD>9</TD>
+	<TD>1 = can cover</TD>
+</TR>
+<TR>
+	<TD>10</TD>
+	<TD>1 = can bind</TD>
+</TR>
+<TR>
+	<TD>11</TD>
+	<TD>1 = can sort</TD>
+</TR>
+<TR>
+	<TD>12</TD>
+	<TD>1 = can print up to 9x14 inches</TD>
+</TR>
+<TR>
+	<TD>13</TD>
+	<TD>1 = can print up to 18x24 inches</TD>
+</TR>
+<TR>
+	<TD>14</TD>
+	<TD>1 = can print up to 36x48 inches</TD>
+</TR>
+<TR>
+	<TD>15</TD>
+	<TD>1 = can print variable sizes</TD>
+</TR>
+</TABLE></CENTER>
+
 <H2>CUPS PostScript File</H2>

-CUPS PostScript files are device-dependent Adobe PostScript program files.
-The PostScript language is described in the PostScript Language Reference
-Manual, Third Edition.
+<P>CUPS PostScript files are device-dependent Adobe PostScript program files.
+The PostScript language is described in the
+<A HREF="http://partners.adobe.com/supportservice/devrelations/PDFS/TN/PLRM.pdf">
+Adobe PostScript Language Reference Manual, Third Edition</A>.
+
+<P>The MIME type for CUPS PostScript files is
+<CODE>application/vnd.cups-postscript</CODE>.

 <H2>CUPS Raster File</H2>

-CUPS raster files are device-dependent raster image files that contain a
+<P>CUPS raster files are device-dependent raster image files that contain a
 PostScript page device dictionary and device-dependent raster imagery for
 each page in the document.  These files are used to transfer raster data
 from the PostScript and image file RIPs to device-dependent filters that
@@ -131,8 +618,8 @@ raster data for that page.

 <CENTER><TABLE WIDTH="80%" BORDER="1">
 <TR>
-	<TH>Bytes</TH>
-	<TH>Description</TH>
+	<TH WIDTH="10%">Bytes</TH>
+	<TH WIDTH="20%">Description</TH>
 	<TH>Values</TH>
 </TR>
 <TR>
@@ -158,7 +645,7 @@ raster data for that page.
 <TR>
 	<TD>256-259</TD>
 	<TD>AdvanceDistance</TD>
-	<TD>0 to 2<SUP>32</SUP> - 1 pixels</TD>
+	<TD>0 to 2<SUP>32</SUP> - 1 points</TD>
 </TR>
 <TR>
 	<TD>260-263</TD>
@@ -199,7 +686,7 @@ raster data for that page.
 	<TD>284-299</TD>
 	<TD>ImagingBoundingBox</TD>
 	<TD>Four integers giving the left, bottom, right, and top positions
-	of the page bounding box in pixels</TD>
+	of the page bounding box in points</TD>
 </TR>
 <TR>
 	<TD>300-303</TD>
@@ -226,7 +713,7 @@ raster data for that page.
 <TR>
 	<TD>312-319</TD>
 	<TD>Margins</TD>
-	<TD>Left and bottom origin of image in pixels</TD>
+	<TD>Left and bottom origin of image in points</TD>
 </TR>
 <TR>
 	<TD>320-323</TD>
@@ -253,52 +740,355 @@ raster data for that page.
 <TR>
 	<TD>336-339</TD>
 	<TD>NegativePrint</TD>
-	<TD></TD>
+	<TD>0 = Do not invert prints<BR>
+	1 = Invert prints</TD>
 </TR>
 <TR>
-	<TD></TD>
-	<TD></TD>
-	<TD></TD>
+	<TD>340-343</TD>
+	<TD>NumCopies</TD>
+	<TD>1 to 2<SUP>32</SUP> - 1</TD>
 </TR>
 <TR>
-	<TD></TD>
-	<TD></TD>
-	<TD></TD>
+	<TD>344-347</TD>
+	<TD>Orientation</TD>
+	<TD>0 = Do not rotate page<BR>
+	1 = Rotate page counter-clockwise<BR>
+	2 = Turn page upside down<BR>
+	3 = Rotate page clockwise</TD>
 </TR>
 <TR>
-	<TD></TD>
-	<TD></TD>
-	<TD></TD>
+	<TD>348-351</TD>
+	<TD>OutputFaceUp</TD>
+	<TD>0 = Output face down<BR>
+	1 = Output face up</TD>
 </TR>
 <TR>
-	<TD></TD>
-	<TD></TD>
-	<TD></TD>
+	<TD>352-359</TD>
+	<TD>PageSize</TD>
+	<TD>Width and length in points</TD>
 </TR>
 <TR>
-	<TD></TD>
-	<TD></TD>
-	<TD></TD>
+	<TD>360-363</TD>
+	<TD>Separations</TD>
+	<TD>0 = Print composite image<BR>
+	1 = Print color separations</TD>
+</TR>
+<TR>
+	<TD>364-367</TD>
+	<TD>TraySwitch</TD>
+	<TD>0 = Do not change trays if selected tray is empty<BR>
+	1 = Change trays if selected tray is empty</TD>
+</TR>
+<TR>
+	<TD>368-371</TD>
+	<TD>Tumble</TD>
+	<TD>0 = Do not rotate even pages when duplexing<BR>
+	1 = Rotate even pages when duplexing</TD>
+</TR>
+<TR>
+	<TD>372-375</TD>
+	<TD>cupsWidth</TD>
+	<TD>Width of page image in pixels</TD>
+</TR>
+<TR>
+	<TD>376-379</TD>
+	<TD>cupsHeight</TD>
+	<TD>Height of page image in pixels</TD>
+</TR>
+<TR>
+	<TD>380-383</TD>
+	<TD>cupsMediaType</TD>
+	<TD>Driver-specific 0 to 2<SUP>32</SUP> - 1</TD>
+</TR>
+<TR>
+	<TD>384-387</TD>
+	<TD>cupsBitsPerColor</TD>
+	<TD>1, 2, 4, 8 bits</TD>
+</TR>
+<TR>
+	<TD>388-391</TD>
+	<TD>cupsBitsPerPixel</TD>
+	<TD>1 to 32 bits</TD>
+</TR>
+<TR>
+	<TD>392-395</TD>
+	<TD>cupsBytesPerLine</TD>
+	<TD>1 to 2<SUP>32</SUP> - 1 bytes</TD>
+</TR>
+<TR>
+	<TD>396-399</TD>
+	<TD>cupsColorOrder</TD>
+	<TD>0 = chunky pixels (CMYK CMYK CMYK)<BR>
+	1 = banded pixels (CCC MMM YYY KKK)<BR>
+	2 = planar pixels (CCC... MMM... YYY... KKK...)</TD>
+</TR>
+<TR>
+	<TD>400-403</TD>
+	<TD>cupsColorSpace</TD>
+	<TD>0 = white<BR>
+	1 = RGB<BR>
+	2 = RGBA<BR>
+	3 = black<BR>
+	4 = CMY<BR>
+	5 = YMC<BR>
+	6 = CMYK<BR>
+	7 = YMCK<BR>
+	8 = KCMY<BR>
+	9 = KCMYcm</TD>
+</TR>
+<TR>
+	<TD>404-407</TD>
+	<TD>cupsCompression</TD>
+	<TD>Driver-specific 0 to 2<SUP>32</SUP> - 1</TD>
+</TR>
+<TR>
+	<TD>408-411</TD>
+	<TD>cupsRowCount</TD>
+	<TD>Driver-specific 0 to 2<SUP>32</SUP> - 1</TD>
+</TR>
+<TR>
+	<TD>412-415</TD>
+	<TD>cupsRowFeed</TD>
+	<TD>Driver-specific 0 to 2<SUP>32</SUP> - 1</TD>
+</TR>
+<TR>
+	<TD>416-419</TD>
+	<TD>cupsRowStep</TD>
+	<TD>Driver-specific 0 to 2<SUP>32</SUP> - 1</TD>
 </TR>
 </TABLE></CENTER>

+<P>The MIME type for CUPS Raster files is
+<CODE>application/vnd.cups-raster</CODE>.
+
+<H2>CUPS Raw Files</H2>
+
+<P>Raw files are printer-dependent print files that are in a format suitable
+to the destination printer (e.g. HP-PCL, HP-RTL, etc.) The MIME type for CUPS
+Raw files is <CODE>application/vnd.cups-raw</CODE>.
+
+<H2>File Transfer Protocol</H2>
+
+<P>The File Transfer Protocol (FTP) is described by
+<A HREF="http://www.ietf.org/rfc/rfc959.txt">RFC 959: File Transfer
+Protocol</A>.
+
 <H2>Internet Printing Protocol</H2>

+<P>The Internet Printing Protocol is described by the following RFCs:
+
+<UL>
+
+	<LI><A HREF="http://www.ietf.org/rfc/rfc2565.txt">
+	RFC 2565: Internet Printing Protocol/1.0: Encoding and Transport</A>
+
+	<LI><A HREF="http://www.ietf.org/rfc/rfc2566.txt">
+	RFC 2566: Internet Printing Protocol/1.0: Model and Semantics</A>
+
+	<LI><A HREF="http://www.ietf.org/rfc/rfc2567.txt">
+	RFC 2567: Design Goals for an Internet Printing Protocol</A>
+
+	<LI><A HREF="http://www.ietf.org/rfc/rfc2568.txt">
+	RFC 2568: Rationale for the Structure of the Model and Protocol
+        for the Internet Printing Protocol</A>
+
+	<LI><A HREF="http://www.ietf.org/rfc/rfc2569.txt">
+	RFC 2569: Mapping between LPD and IPP Protocols</A>
+
+</UL>
+
+<P>CUPS defines the following extension operations to IPP.
+
+<H3>Get Default Destination (CUPS_GET_DEFAULT = 0x4001)</H3>
+
+<P>The get default destination operation returns the printer attributes
+for the system default printer or class. The only required attributes
+are <CODE>attributes-charset</CODE> and
+<CODE>attributes-natural-language</CODE>.
+
+<P>Get default destination will only return <CODE>ipp-ok</CODE>.
+
+<H3>Get Printers (CUPS_GET_PRINTERS = 0x4002)</H3>
+
+<P>The get printers operation returns the printer attributes for all
+printers known to the system. The only required attributes are
+<CODE>attributes-charset</CODE> and
+<CODE>attributes-natural-language</CODE>.
+
+<P>Get printers will only return <CODE>ipp-ok</CODE>.
+
+<H3>Add Printer (CUPS_ADD_PRINTER = 0x4003)</H3>
+
+<P>The add printer operation adds or replaces the specified printer. The
+<CODE>attributes-charset</CODE>,
+<CODE>attributes-natural-language</CODE> and <CODE>printer-uri</CODE>
+attributes are required.
+
+<P>The <CODE>printer-location</CODE>, <CODE>printer-info</CODE>,
+<CODE>printer-more-info</CODE>, and <CODE>device-uri</CODE> attributes
+are required when initially adding a printer and optional when modifying
+a printer.
+
+<P>A PPD file or System V interface script may follow the IPP request
+body. Note that the printer will be disabled until a valid interface script or
+PPD file is sent.
+
+<P>Add printer will return <CODE>ipp-ok</CODE>, <CODE>ipp-not-authorized</CODE>,
+<CODE>ipp-bad-request</CODE>, or <CODE>ipp-attributes</CODE>.
+
+<H3>Delete Printer (CUPS_DELETE_PRINTER = 0x4004)</H3>
+
+<P>The delete printer operation removes the specified printer. The only
+required attributes are <CODE>attributes-charset</CODE>,
+<CODE>attributes-natural-language</CODE>, and <CODE>printer-uri</CODE>.
+
+<P>Delete printer will return <CODE>ipp-ok</CODE>, <CODE>ipp-not-found</CODE>,
+or <CODE>ipp-not-authorized</CODE>.
+
+<H3>Get Classes (CUPS_GET_CLASSES = 0x4005)</H3>
+
+<P>The get classes operation returns the printer attributes for all
+classes known to the system. The only required attributes are
+<CODE>attributes-charset</CODE> and
+<CODE>attributes-natural-language</CODE>.
+
+<P>Get classes will only return <CODE>ipp-ok</CODE>.
+
+<H3>Add Class (CUPS_ADD_CLASS = 0x4006)</H3>
+
+<P>The add class operation adds or replaces the specified class. The
+<CODE>attributes-charset</CODE>,
+<CODE>attributes-natural-language</CODE>, and <CODE>printer-uri</CODE>
+attributes are required.
+
+<P>The <CODE>printer-location</CODE>, <CODE>printer-info</CODE>,
+<CODE>printer-more-info</CODE>, and <CODE>member-uris</CODE> attributes
+are required when initially adding a printer and optional when modifying
+a printer.
+
+<P>Add class will return <CODE>ipp-ok</CODE>, <CODE>ipp-not-authorized</CODE>,
+<CODE>ipp-bad-request</CODE>, or <CODE>ipp-attributes</CODE>.
+
+<H3>Delete Class (CUPS_DELETE_CLASS = 0x4007)</H3>
+
+<P>The delete class operation removes the specified class. The only
+required attributes are <CODE>attributes-charset</CODE>,
+<CODE>attributes-natural-language</CODE>, and <CODE>printer-uri</CODE>.
+
+<P>Delete class will return <CODE>ipp-ok</CODE>, <CODE>ipp-not-found</CODE>,
+or <CODE>ipp-not-authorized</CODE>.
+
+<H3>Accept Jobs (CUPS_ACCEPT_JOBS = 0x4008)</H3>
+
+<P>The accept jobs operation allows jobs to be accepted by the
+specified destination. The only required attributes are
+<CODE>attributes-charset</CODE>,
+<CODE>attributes-natural-language</CODE>, and
+<CODE>printer-uri</CODE>.
+
+<P>Accept jobs will return <CODE>ipp-ok</CODE>, <CODE>ipp-not-found</CODE>,
+or <CODE>ipp-not-authorized</CODE>.
+
+<H3>Reject Jobs (CUPS_REJECT_JOBS = 0x4009)</H3>
+
+<P>The reject jobs operation prevents jobs from being accepted by the
+specified destination. The only required attributes are
+<CODE>attributes-charset</CODE>,
+<CODE>attributes-natural-language</CODE>, and
+<CODE>printer-uri</CODE>.
+
+<P>Reject jobs will return <CODE>ipp-ok</CODE>, <CODE>ipp-not-found</CODE>,
+or <CODE>ipp-not-authorized</CODE>.
+
+<H3>Set Default Destination (CUPS_SET_DEFAULT = 0x400A)</H3>
+
+<P>The set default destination operation returns the printer attributes
+for the system default printer or class. The only required attributes
+are <CODE>attributes-charset</CODE>,
+<CODE>attributes-natural-language</CODE>, and <CODE>printer-uri</CODE>.
+
+<P>Set default destination will return <CODE>ipp-ok</CODE>,
+<CODE>ipp-not-authorized</CODE>, <CODE>ipp-bad-request</CODE>, or
+<CODE>ipp-not-found</CODE>.
+
 <H2>Line Printer Daemon Protocol</H2>

-<H2>Parallel Device</H2>
-
-<H2>Serial Device</H2>
+<P>The Line Printer Daemon (LPD) protocol is described by
+<A HREF="http://www.ietf.org/rfc/rfc1179.txt">RFC 1179: Line Printer Daemon
+Protocol</A>.

 <H2>Server Message Block Protocol</H2>

+<P>The Server Message Block (SMB) and related Common Internet File
+System (CIFS) protocols are described at
+<A HREF="http://anu.samba.org/cifs">http://anu.samba.org/cifs</A>.
+
 <H2>Trivial File Transfer Protocol</H2>

-<H1>Command-Line Interfaces</H1>
+<P>The Trivial File Transfer Protocol (TFTP) is described by
+<A HREF="http://www.ietf.org/rfc/rfc1350.txt">RFC 1350: The TFTP Protocol
+(Revision 2)</A>.

-<H2>Backend Interfaces</H2>
+<H1>5 - Directories</H1>

-<H2>Filter Interfaces</H2>
+<DL>
+
+	<DT>/usr/bin
+	<DD>The <CODE>cancel</CODE>, <CODE>lp</CODE>, <CODE>lpq</CODE>,
+	<CODE>lpr</CODE>, <CODE>lprm</CODE>, and <CODE>lpstat</CODE> commands
+	reside here.
+
+	<DT>/usr/lib
+	<DD>The <CODE>accept</CODE>, <CODE>disable</CODE>, <CODE>enable</CODE>,
+	<CODE>lpadmin</CODE>, and <CODE>reject</CODE> commands reside here.
+
+	<DT>/usr/sbin
+	<DD>The <CODE>lpc</CODE> and <CODE>cupsd</CODE> commands resize here.
+
+	<DT>/usr/share/cups
+	<DD>The character set and filter data files reside here.
+
+	<DT>/usr/share/cups/fonts
+	<DD>The <CODE>pstoraster</CODE> font files reside here.
+
+	<DT>/usr/share/cups/model
+	<DD>The sample PPD files reside here.
+
+	<DT>/usr/share/cups/pstoraster
+	<DD>The <CODE>pstoraster</CODE> data files reside here.
+
+	<DT>/var/cups
+	<DD>This is the root directory of the CUPS scheduler.
+
+	<DT>/var/cups/backend
+	<DD>The backend filters reside here.
+
+	<DT>/var/cups/cgi-bin
+	<DD>The CGI programs reside here.
+
+	<DT>/var/cups/conf
+	<DD>The scheduler configuration and MIME files reside here.
+
+	<DT>/var/cups/doc
+	<DD>The scheduler documentation files reside here.
+
+	<DT>/var/cups/filter
+	<DD>The file filters reside here.
+
+	<DT>/var/cups/interfaces
+	<DD>System V interface scripts reside here.
+
+	<DT>/var/cups/logs
+	<DD>The <CODE>access_log</CODE>, <CODE>error_log</CODE>, and
+	<CODE>page_log</CODE> files reside here.
+
+	<DT>/var/cups/ppd
+	<DD>This directory contains PPD files for each printer.
+
+	<DT>/var/cups/requests
+	<DD>This directory contains pending print job files.
+
+</DL>

 <H1 TYPE=A VALUE=1>Glossary</H1>

@@ -3,11 +3,11 @@
 	<TITLE>Common UNIX Printing System</TITLE>
 	<LINK REL=STYLESHEET TYPE="text/css" HREF="cups.css">
 	<MAP NAME="navbar">
-		<AREA SHAPE="RECT" COORDS="10,10,100,35" HREF="printers" ALT="Current Printer Status">
-		<AREA SHAPE="RECT" COORDS="115,10,205,35" HREF="classes" ALT="Current Printer Classes Status">
-		<AREA SHAPE="RECT" COORDS="220,10,280,35" HREF="jobs" ALT="Current Jobs Status">
-		<AREA SHAPE="RECT" COORDS="295,10,470,35" HREF="documentation.html" ALT="Read CUPS Documentation On-Line">
-		<AREA SHAPE="RECT" COORDS="485,10,590,35" HREF="http://www.cups.org" ALT="Download the Current CUPS Software">
+		<AREA SHAPE="RECT" COORDS="10,10,85,30" HREF="printers" ALT="Current Printer Status">
+		<AREA SHAPE="RECT" COORDS="95,10,175,30" HREF="classes" ALT="Current Printer Classes Status">
+		<AREA SHAPE="RECT" COORDS="185,10,235,30" HREF="jobs" ALT="Current Jobs Status">
+		<AREA SHAPE="RECT" COORDS="245,10,395,30" HREF="documentation.html" ALT="Read CUPS Documentation On-Line">
+		<AREA SHAPE="RECT" COORDS="405,10,490,30" HREF="http://www.cups.org" ALT="Download the Current CUPS Software">
        </MAP>
 </HEAD>

@@ -15,55 +15,732 @@ Copyright 1997-1999, All Rights Reserved<BR>
 <HR>
 <H1 ALIGN=CENTER><A NAME=CONTENTS>Table of Contents</A></H1>
 <BR>
-<BR><B><A HREF=#1>1 Scope</A></B>
+<BR><B><A HREF=#1>Preface</A></B>
 <UL>
-<LI><A HREF=#1_1>1.1 Identification</A></LI>
-<LI><A HREF=#1_2>1.2 Document Overview</A></LI>
+<LI><A HREF=#1_1>System Overview</A></LI>
+<LI><A HREF=#1_2>Document Overview</A></LI>
 </UL>
-<B><A HREF=#2>2 Printing System Overview</A></B>
-<BR>
-<BR><B><A HREF=#3>3 Printer Queue Management</A></B>
+<B><A HREF=#2>1 - Printing System Overview</A></B>
 <UL>
-<LI><A HREF=#3_1>3.1 Adding Printers</A></LI>
-<LI><A HREF=#3_2>3.2 Removing Printers</A></LI>
-<LI><A HREF=#3_3>3.3 Reconfiguring Printers</A></LI>
-<LI><A HREF=#3_4>3.4 Printer Options</A></LI>
-<LI><A HREF=#3_5>3.5 Printer Security</A></LI>
-<LI><A HREF=#3_6>3.6 Printer Accounting</A></LI>
+<LI><A HREF=#2_1>The Printing Problem</A></LI>
+<LI><A HREF=#2_2>The Technology</A></LI>
+<LI><A HREF=#2_3>Filters</A></LI>
+<LI><A HREF=#2_4>Printer Drivers</A></LI>
 </UL>
-<B><A HREF=#4>4 Printing System Management</A></B>
+<B><A HREF=#3>2 - Building and Installing CUPS</A></B>
 <UL>
-<LI><A HREF=#4_1>4.1 Log Files</A></LI>
-<LI><A HREF=#4_2>4.2 Network Configuration</A></LI>
-<LI><A HREF=#4_3>4.3 Adding File Types</A></LI>
+<LI><A HREF=#3_1>Installing a Source Distribution</A></LI>
+<UL>
+<LI><A HREF=#3_1_1>Requirements</A></LI>
+<LI><A HREF=#3_1_2>Compiling CUPS</A></LI>
+<LI><A HREF=#3_1_3>Installing the Software</A></LI>
+<LI><A HREF=#3_1_4>Running the Software</A></LI>
+</UL>
+<LI><A HREF=#binary>Installing a Binary Distribution</A></LI>
+</UL>
+<B><A HREF=#4>3 - Printer Queue Management</A></B>
+<UL>
+<LI><A HREF=#4_1>The lpadmin Command</A></LI>
+<LI><A HREF=#4_2>Adding and Modifying Printers</A></LI>
+<UL>
+<LI><A HREF=#4_2_1>Using Standard Printer Drivers</A></LI>
+</UL>
+<LI><A HREF=#4_3>Removing Printers</A></LI>
+<LI><A HREF=#4_4>Printer Classes</A></LI>
+<LI><A HREF=#4_5>Setting the Default Printer</A></LI>
+</UL>
+<B><A HREF=#5>4 - Printing System Management</A></B>
+<UL>
+<LI><A HREF=#5_1>Network Configuration</A></LI>
+<UL>
+<LI><A HREF=#5_1_1>Port</A></LI>
+<LI><A HREF=#5_1_2>Listen</A></LI>
+<LI><A HREF=#5_1_3>BrowsePort</A></LI>
+<LI><A HREF=#5_1_4>BrowseAddress</A></LI>
+</UL>
+<LI><A HREF=#5_2>Printer Security</A></LI>
+<UL>
+<LI><A HREF=#5_2_1>Location</A></LI>
+<LI><A HREF=#5_2_2>Order</A></LI>
+<LI><A HREF=#5_2_3>Allow</A></LI>
+<LI><A HREF=#5_2_4>Deny</A></LI>
+<LI><A HREF=#5_2_5>AuthType</A></LI>
+<LI><A HREF=#5_2_6>AuthClass</A></LI>
+<LI><A HREF=#5_2_7>AuthGroupName</A></LI>
+<LI><A HREF=#5_2_8>SystemGroup</A></LI>
+</UL>
+<LI><A HREF=#5_3>File Formats</A></LI>
+<UL>
+<LI><A HREF=#5_3_1>mime.types</A></LI>
+<LI><A HREF=#5_3_2>mime.convs</A></LI>
+</UL>
+</UL>
+<B><A HREF=#6>5 - Printer Accounting</A></B>
+<UL>
+<LI><A HREF=#6_1>Where to Find the Log Files</A></LI>
+<LI><A HREF=#6_2>The access_log File</A></LI>
+<LI><A HREF=#6_3>The error_log File</A></LI>
+<LI><A HREF=#6_4>The page_log File</A></LI>
 </UL>
 <HR>
-<H1><A NAME=1>1 Scope</A></H1>
-<H2><A NAME=1_1>1.1 Identification</A></H2>
- This softwae administrators manual provides printer administration 
+<H1 ALIGN=RIGHT><A NAME=1>Preface</A></H1>
+ This software administrators manual provides printer administration 
 information for the Common UNIX Printing System (&quot;CUPS&quot;) Version 1.0.0. 
-<H2><A NAME=1_2>1.2 Document Overview</A></H2>
+<H2><A NAME=1_1>System Overview</A></H2>
+ The Common UNIX Printing System provides a portable printing layer for 
+ UNIX&reg; operating systems. It has been developed by Easy Software 
+ Products to promote a standard printing solution for all UNIX vendors 
+ and users. CUPS provides the System V and Berkeley command-line 
+interfaces. 
+<P>CUPS uses the Internet Printing Protocol (IETF-IPP) as the basis for 
+managing print jobs and queues. The Line Printer Daemon (LPD, RFC1179), 
+Server Message Block (SMB), and AppSocket protocols are also supported 
+with reduced functionality. </P>
+<P>CUPS adds network printer browsing and PostScript Printer 
+Description (&quot;PPD&quot;)-based printing options to support real world 
+applications under UNIX. </P>
+<P>CUPS also includes a customized version of GNU GhostScript 
+(currently based off GNU GhostScript 4.03) and an image file RIP that 
+can be used to support non-PostScript printers. </P>
+<H2><A NAME=1_2>Document Overview</A></H2>
 <P>This software administrators manual is organized into the following 
 sections:</P>
 <UL>
-<LI>1 - Scope</LI>
-<LI>2 - References</LI>
-<LI>3 - Printing System Overview</LI>
-<LI>4 - Printer Queue Management</LI>
-<LI>5 - Printing System Management</LI>
-<LI>A - Glossary</LI>
+<LI>1 - Printing System Overview</LI>
+<LI>2 - Building and Installing CUPS</LI>
+<LI>3 - Printer Queue Management</LI>
+<LI>4 - Printing System Management</LI>
+<LI>5 - Printer Accounting</LI>
 </UL>
-<H1><A NAME=2>2 Printing System Overview</A></H1>
-<H1><A NAME=3>3 Printer Queue Management</A></H1>
-<H2><A NAME=3_1>3.1 Adding Printers</A></H2>
-<H2><A NAME=3_2>3.2 Removing Printers</A></H2>
-<H2><A NAME=3_3>3.3 Reconfiguring Printers</A></H2>
-<H2><A NAME=3_4>3.4 Printer Options</A></H2>
-<H2><A NAME=3_5>3.5 Printer Security</A></H2>
-<H2><A NAME=3_6>3.6 Printer Accounting</A></H2>
-<H1><A NAME=4>4 Printing System Management</A></H1>
-<H2><A NAME=4_1>4.1 Log Files</A></H2>
-<H2><A NAME=4_2>4.2 Network Configuration</A></H2>
-<H2><A NAME=4_3>4.3 Adding File Types</A></H2>
+<H1 ALIGN=RIGHT><A NAME=2>1 - Printing System Overview</A></H1>
+<P>This chapter provides an overview of how the Common UNIX Printing 
+System works. </P>
+<H2><A NAME=2_1>The Printing Problem</A></H2>
+<P>For years <I>the printing problem</I> has plagued UNIX&reg;. Unlike 
+Microsoft&reg; Windows&reg; or MacOS, UNIX has no standard interface or system 
+in place for supporting printers. Among the solutions previously 
+available, the Berkeley and System V printing systems are the most 
+prevalent. </P>
+<P>These printing systems support line printers (text only) or 
+PostScript printers (text and graphics), and with some coaxing they can 
+be made to support a full range of printers and file formats. However, 
+because each varient of the UNIX operating system uses a different 
+printing system than the next, developing printer drivers for a wide 
+range of printers is extremely difficult. That combined with the 
+limited volume of customers for each UNIX varient has forced most 
+printer vendors to give up supporting UNIX entirely. </P>
+<P>The Common UNIX Printing System, or CUPS, is designed to eliminate <I>
+the printing problem</I>. One common printing system can be used by all 
+UNIX varients to support the printing needs of users. Printer vendors 
+can use its modular filter interface to develop a single driver program 
+that supports a wide range of file formats with little or no effort. 
+ Since CUPS provides both the System V and Berkeley printing commands, 
+users (and applications) can reap the benefits of this new technology 
+with no changes. </P>
+<H2><A NAME=2_2>The Technology</A></H2>
+<P>CUPS is based upon an emerging Internet standard called the Internet 
+Printing Protocol, or IPP. IPP has been embraced by dozens of printer 
+and printer server manufacturers, and will be supported by the next 
+Microsoft Windows operating system. </P>
+<P>IPP defines a standard protocol for printing as well as managing 
+print jobs and printer options like media size, resolution, and so 
+forth. Like all IP-based protocols, IPP can be used locally or over the 
+Internet to printers hundreds or thousands of miles away. Unlike other 
+protocols, however, IPP also supports access control, authentication, 
+and encryption, making it a much more secure printing solution than 
+older ones. </P>
+<P>IPP is layered on top of the Hyper-Text Transport Protocol, or HTTP, 
+which is the basis of web servers on the Internet. This allows the user 
+to view documentation and status information on a printer or server 
+using their web browser. </P>
+<P>CUPS provides a complete IPP/1.0-based printing system that provides 
+Basic authentication and domain or IP-based access control. Digest 
+authentication and TLS encryption will be available in future versions 
+of CUPS. </P>
+<H2><A NAME=2_3>Filters</A></H2>
+<P>Filters allow a user or application to print many types of files 
+without extra effort. Print jobs sent to a CUPS server are filtered 
+before sending them to a printer. Some filters convert job files to 
+different formats that the printer can understand. Others perform page 
+selection and ordering tasks. <I>Backend</I> filters perform the most 
+important task of all - they send the filtered print data to the 
+printer. </P>
+<P>CUPS provides filters for printing many types of image files, 
+HP-GL/2 files, PDF files, and text files. CUPS also supplies PostScript 
+and image file Raster Image Processors, or RIPs, that convert 
+PostScript or image files into bitmaps that can be sent to a raster 
+printer. </P>
+<P>CUPS provides backends for printing over parallel and serial ports, 
+and over the network via the JetDirect (AppSocket), Server Message 
+Block, and Line Printer Daemon protocols. </P>
+<H2><A NAME=2_4>Printer Drivers</A></H2>
+<P>Printer drivers in CUPS consist of one of more filters specific to a 
+printer. CUPS includes a sample printer driver for Hewlett-Packard 
+LaserJet and DeskJet printers. While this driver does not generate 
+optimal output for different printer models, it does demonstrate how 
+you can write your own printer drivers and incorporate them into CUPS. </P>
+<H1 ALIGN=RIGHT><A NAME=3>2 - Building and Installing CUPS</A></H1>
+<P>This chapter shows how to build and install the Common UNIX Printing 
+System. If you are installing a binary distribution from the CUPS web 
+site, proceed to the section titled, <A HREF=#binary>Installing a 
+Binary Distribution</A>. </P>
+<H2><A NAME=3_1>Installing a Source Distribution</A></H2>
+<H3><A NAME=3_1_1>Requirements</A></H3>
+<P>You'll need an ANSI C compiler to build CUPS on your system. As its 
+name implies, CUPS is designed to run on the UNIX operating system, 
+however the CUPS interface library and most of the filters and backends 
+supplied with CUPS should also run under Microsoft&reg; Windows&reg;. </P>
+<P>For the image file filters and PostScript RIP, you'll need the JPEG, 
+PNG, TIFF, and ZLIB libraries. CUPS will build without these, but with 
+reduced functionality. Easy Software Products maintains a mirror of the 
+current versions of these libraries at: </P>
+<UL>
+<PRE>
+<A HREF=ftp://ftp.easysw.com/pub/libraries>ftp://ftp.easysw.com/pub/libraries</A>
+</PRE>
+</UL>
+<P>If you make changes to the man pages you'll need GNU groff or 
+another nroff-like package. GNU groff is available from: </P>
+<UL>
+<PRE>
+<A HREF=ftp://ftp.gnu.org/pub/groff>ftp://ftp.gnu.org/pub/groff</A>
+</PRE>
+</UL>
+<P>The documentation is formatted using the HTMLDOC software. If you 
+need to make changes you can get the HTMLDOC software from: </P>
+<UL>
+<PRE>
+<A HREF=http://www.easysw.com/htmldoc>http://www.easysw.com/htmldoc</A>
+</PRE>
+</UL>
+<H3><A NAME=3_1_2>Compiling CUPS</A></H3>
+<P>CUPS uses GNU autoconf to configure the makefiles and source code 
+for your system. To configure CUPS for your system type: </P>
+<UL>
+<PRE>
+% ./configure ENTER
+</PRE>
+</UL>
+<P>The default installation will put the CUPS software in the <CODE>/usr</CODE>
+ and <CODE>/var</CODE> directories on your system, which will overwrite 
+any existing printing commands on your system. To install the CUPS 
+software in another location use the <CODE>--prefix</CODE> option: </P>
+<UL>
+<PRE>
+% ./configure --prefix=/usr/local ENTER
+</PRE>
+</UL>
+<P>If the PNG, JPEG, TIFF, and ZLIB libraries are not installed in a 
+system default location (typically <CODE>/usr/include</CODE> and <CODE>
+/usr/lib</CODE>) you'll need to set the <CODE>CFLAGS</CODE> and <CODE>
+LDFLAGS</CODE> environment variables prior to running configure: </P>
+<UL>
+<PRE>
+% setenv CFLAGS &quot;-I/some/directory&quot;
+% setenv LDFLAGS &quot;-L/some/directory&quot;
+% ./configure ... ENTER
+</PRE>
+</UL>
+<P>Once you have configured things, just type: </P>
+<UL>
+<PRE>
+% make ENTER
+</PRE>
+</UL>
+<P>to build the software. </P>
+<H3><A NAME=3_1_3>Installing the Software</A></H3>
+<P>To install the software type: </P>
+<UL>
+<PRE>
+% make install ENTER
+</PRE>
+</UL>
+<H3><A NAME=3_1_4>Running the Software</A></H3>
+ Once you have installed the software you can start the CUPS daemon by 
+typing: 
+<UL>
+<PRE>
+% /usr/sbin/cupsd &amp; ENTER
+</PRE>
+</UL>
+<H2><A NAME=binary>Installing a Binary Distribution</A></H2>
+<P>We are currently distributing CUPS binary distributions in TAR 
+format with installation and removal scripts. </P>
+<UL><B>WARNING:</B>
+<P>Installing CUPS will overwrite your existing printing  system. If 
+you experience difficulties with the CUPS software  and need to go back 
+to your old printing system, you will need  to remove the CUPS software 
+with the provided script and  reinstall the printing system from your 
+operating system CDs. </P>
+</UL>
+<P>To install the CUPS software you will need to be logged in as root 
+(doing an &quot;su&quot; is good enough). Once you are the root user, run the 
+installation script with: </P>
+<UL>
+<PRE>
+./cups.install ENTER
+</PRE>
+</UL>
+<P>After asking you a few yes/no questions the CUPS software will be 
+installed and the scheduler will be started automatically. </P>
+<H1 ALIGN=RIGHT><A NAME=4>3 - Printer Queue Management</A></H1>
+<P>This chapter discusses how to add, modify, and delete print queues 
+on your system. </P>
+<H2><A NAME=4_1>The lpadmin Command</A></H2>
+<P>The <CODE>lpadmin</CODE> command allows you to perform most printer 
+administration tasks from the command-line. Since <CODE>lpadmin</CODE>
+ is also a System V printing system command, it is located in the <CODE>
+/usr/lib</CODE> directory instead of a more common one like <CODE>
+/usr/bin</CODE> or <CODE>/usr/sbin</CODE>. </P>
+<H2><A NAME=4_2>Adding and Modifying Printers</A></H2>
+<P>To add a printer to CUPS you simply run the <CODE>lpadmin</CODE>
+ command with the &quot;-p&quot; option: </P>
+<UL>
+<PRE>
+% /usr/lib/lpadmin -p<I>printer</I> -v<I>device</I> -P<I>ppd</I> ENTER
+</PRE>
+</UL>
+<P>Spaces between the option letter and value are optional. </P>
+<P>The <I>printer</I> name can be up to 127 letters, digits, hyphens, 
+and underscores. Unlike other printing systems, the printer name in 
+CUPS is <I>not</I> case-sensitive, so you can't add two printers named <CODE>
+LaserJet</CODE> and <CODE>laserjet</CODE>. </P>
+<P>The <I>device</I> argument specifies the device URI or filename for 
+the printer. The following devices are supported in a basic 
+installation of CUPS: </P>
+<DL>
+<DT>file:/dev/filename </DT>
+<DT>/dev/filename </DT>
+<DD>Sends all output to the specified file. </DD>
+<DT>ipp://hostname[:port]/resource </DT>
+<DD>Sends all output to the specified IPP printer or server.  The <I>
+port</I> parameters defaults to 631. </DD>
+<DT>lpd://hostname/queue </DT>
+<DD>Sends all output to the specified LPD printer queue. </DD>
+<DT>parallel:/dev/filename </DT>
+<DD>Sends all output to the specified parallel port device. </DD>
+<DT>serial:/dev/filename[?options] </DT>
+<DD>Sends all output to the specified serial port device.  The <I>
+options</I> can be any of the following separated by the  plus (+) 
+character: 
+<UL>
+<LI><CODE>baud=<I>rate</I></CODE> - Sets the baud rate  for the device. </LI>
+<LI><CODE>bits=<I>7 or 8</I></CODE> - Sets the number  of data bits. </LI>
+<LI><CODE>parity=<I>even</I></CODE> - Sets even parity  checking. </LI>
+<LI><CODE>parity=<I>odd</I></CODE> - Sets odd parity  checking. </LI>
+<LI><CODE>parity=<I>none</I></CODE> - Turns parity  checking off. </LI>
+</UL>
+</DD>
+<DT>socket://hostname[:port] </DT>
+<DD>Sends all output to the specified printer using the  AppSocket 
+protocol. The <I>port</I> parameter defaults to 9100. </DD>
+</DL>
+<P>The <I>ppd</I> argument specifies the PostScript Printer Description 
+file to use for this printer. Many options (such as media size, etc.) 
+will not be available if you omit this part of the <CODE>lpadmin</CODE>
+ command. </P>
+<H3><A NAME=4_2_1>Using Standard Printer Drivers</A></H3>
+<P>The <CODE>lpadmin</CODE> command allows you to use &quot;standard&quot; PPD 
+files and interface scripts located in the <CODE>/usr/share/cups/model</CODE>
+ directory with the &quot;-m&quot; option: </P>
+<UL>
+<PRE>
+% /usr/lib/lpadmin -p<I>printer</I> -v<I>device</I> -m<I>model</I> ENTER
+</PRE>
+</UL>
+<P>The <I>model</I> argument specifies the name of the PPD file or 
+interface script. For example, to add a printer using the sample HP 
+DeskJet series driver connected to parallel port 1 under Linux you 
+would use: </P>
+<UL>
+<PRE>
+% /usr/lib/lpadmin -pDeskJet -vparallel:/dev/par1 -mdeskjet.ppd ENTER
+</PRE>
+</UL>
+<H2><A NAME=4_3>Removing Printers</A></H2>
+<P>To remove a printer to CUPS you simply run the <CODE>lpadmin</CODE>
+ command with the &quot;-x&quot; option: </P>
+<UL>
+<PRE>
+% /usr/lib/lpadmin -x<I>printer</I> ENTER
+</PRE>
+</UL>
+<H2><A NAME=4_4>Printer Classes</A></H2>
+<P>CUPS allows you to group similar printers in a <I>printer class</I>. 
+When a user sends a print job to a class, the job will be processed by 
+the first available printer in that class. </P>
+<P>To add a printer to a class you simply run the <CODE>lpadmin</CODE>
+ command with the &quot;-p&quot; and &quot;-c&quot; options: </P>
+<UL>
+<PRE>
+% /usr/lib/lpadmin -p<I>printer</I> -c<I>class</I> ENTER
+</PRE>
+</UL>
+<P>The <I>class</I> is created automatically if it doesn't exist. To 
+remove a class just use the &quot;-x&quot; option: </P>
+<UL>
+<PRE>
+% /usr/lib/lpadmin -x<I>class</I> ENTER
+</PRE>
+</UL>
+<H2><A NAME=4_5>Setting the Default Printer</A></H2>
+<P>To set the default printer or class simply run the <CODE>lpadmin</CODE>
+ command with the &quot;-d&quot; option: </P>
+<UL>
+<PRE>
+% /usr/lib/lpadmin -d<I>destination</I> ENTER
+</PRE>
+</UL>
+<P>The <I>destination</I> argument is the name of the printer or class. </P>
+<H1 ALIGN=RIGHT><A NAME=5>4 - Printing System Management</A></H1>
+<P>This chapter shows how you can configure the CUPS server. </P>
+<H2><A NAME=5_1>Network Configuration</A></H2>
+<P>The default configuration of the CUPS server listens for connections 
+from all network interfaces on port 631 (the standard IPP port). 
+Administration functions are limited to local connections with the 
+appropriate username and password. </P>
+<P>If you'd like to limit access to your system you'll need to edit the <CODE>
+/var/cups/conf/cupsd.conf</CODE> file. </P>
+<H3><A NAME=5_1_1>Port</A></H3>
+<P>The <CODE>Port</CODE> directive specifies a port to listen on for 
+all interfaces. Besides the standard IPP port (631) you can also setup 
+your server to listen on the HTTP port (80) to use your CUPS server as 
+a standard web server as well. </P>
+<H3><A NAME=5_1_2>Listen</A></H3>
+<P>The <CODE>Listen</CODE> directive specifies a listening address and 
+port, extending the functionality of the <CODE>Port</CODE> directive. 
+If you want to allow connections only from the local machine you can 
+use: </P>
+<UL>
+<PRE>
+Listen 127.0.0.1:631
+</PRE>
+</UL>
+<P>instead of the <CODE>Port</CODE> directive. </P>
+<P>If you want to limit access to a specific network/subnet, make sure 
+you specify only the network address and not your system's network 
+address! </P>
+<H3><A NAME=5_1_3>BrowsePort</A></H3>
+<P>The <CODE>BrowsePort</CODE> directive controls which port is 
+monitored for remote printers. By default it is set to the IPP port 
+(631), however you can change it as needed. </P>
+<UL><B>NOTE:</B>
+<P>You must set the <CODE>BrowsePort</CODE> to the same value  on all 
+of the systems that you want to see. </P>
+</UL>
+<H3><A NAME=5_1_4>BrowseAddress</A></H3>
+<P>The <CODE>BrowseAddress</CODE> directive specifies a broadcast 
+address to use when sending printer status updates over the network. 
+The default browse address is <CODE>255.255.255.255</CODE> which will 
+send printer information to all subnets. </P>
+<UL><B>NOTE:</B>
+<P>If you are using HP-UX 10.20 and a subnet that is not 24,  16, or 8 
+bits, printer browsing (and in fact all broadcast  reception) will not 
+work. This problem appears to be fixed in  HP-UX 11.0. </P>
+</UL>
+<H2><A NAME=5_2>Printer Security</A></H2>
+<P>CUPS provides IP and domain-name based access control and Basic 
+authentication for authentication. </P>
+<H3><A NAME=5_2_1>Location</A></H3>
+<P>The <CODE>Location</CODE> directive defines access control for a 
+specific HTTP directory. The following pseudo directories are provided 
+by the CUPS server: </P>
+<UL>
+<LI><CODE>/admin</CODE> - This is the URI that must be referenced to 
+ do printer administation commands. </LI>
+<LI><CODE>/classes</CODE> - This is the URI that must be referenced to 
+ access printer classes. </LI>
+<LI><CODE>/jobs</CODE> - This is the URI that must be referenced to 
+ access jobs. </LI>
+<LI><CODE>/printers</CODE> - This is the URI that must be referenced to 
+ access printers. </LI>
+</UL>
+<P>All other directories are taken from the <CODE>/usr/share/cups/doc</CODE>
+ directory. </P>
+<P>The <CODE>Location</CODE> directive surrounds the other access 
+control directives described below. The default server configuration 
+uses: </P>
+<UL>
+<PRE>
+&lt;Location /admin&gt;
+AuthType Basic
+AuthClass System
+
+Order Deny,Allow
+Deny From All
+Allow From 127.0.0.1
+&lt;/Location&gt;
+</PRE>
+</UL>
+<H3><A NAME=5_2_2>Order</A></H3>
+<P>The <CODE>Order</CODE> directive defines the default access control. 
+The following values are supported: </P>
+<UL>
+<LI><CODE>Order Allow,Deny</CODE> - Allow requests from all  systems <I>
+except</I> for those listed in a <CODE>Deny</CODE> directive. </LI>
+<LI><CODE>Order Deny,Allow</CODE> - Allow requests only from  those 
+listed in an <CODE>Allow</CODE> directive. </LI>
+</UL>
+<P>The <CODE>Order</CODE> directive must appear inside a <CODE>Location</CODE>
+ directive. </P>
+<H3><A NAME=5_2_3>Allow</A></H3>
+<P>The <CODE>Allow</CODE> directive specifies a hostname, IP address, 
+or network that is allowed access to the server: </P>
+<UL>
+<PRE>
+Allow from All
+Allow from None
+Allow from *.domain.com
+Allow from .domain.com
+Allow from host.domain.com
+Allow from nnn.*
+Allow from nnn.nnn.*
+Allow from nnn.nnn.nnn.*
+Allow from nnn.nnn.nnn.nnn
+Allow from nnn.nnn.nnn.nnn/mm
+Allow from nnn.nnn.nnn.nnn/mmm.mmm.mmm.mmm
+</PRE>
+</UL>
+<P><CODE>Allow</CODE> directives are cummulative, so multiple <CODE>
+Allow</CODE> directives can be used to allow access for multiple hosts 
+or networks. </P>
+<P>The <CODE>Allow</CODE> directive must appear inside a <CODE>Location</CODE>
+ directive. </P>
+<H3><A NAME=5_2_4>Deny</A></H3>
+<P>The <CODE>Deny</CODE> directive specifies a hostname, IP address, or 
+network that is allowed access to the server: </P>
+<UL>
+<PRE>
+Deny from All
+Deny from None
+Deny from *.domain.com
+Deny from .domain.com
+Deny from host.domain.com
+Deny from nnn.*
+Deny from nnn.nnn.*
+Deny from nnn.nnn.nnn.*
+Deny from nnn.nnn.nnn.nnn
+Deny from nnn.nnn.nnn.nnn/mm
+Deny from nnn.nnn.nnn.nnn/mmm.mmm.mmm.mmm
+</PRE>
+</UL>
+<P><CODE>Deny</CODE> directives are cummulative, so multiple <CODE>Deny</CODE>
+ directives can be used to allow access for multiple hosts or networks. </P>
+<P>The <CODE>Deny</CODE> directive must appear inside a <CODE>Location</CODE>
+ directive. </P>
+<H3><A NAME=5_2_5>AuthType</A></H3>
+<P>The <CODE>AuthType</CODE> directive defines the type of 
+authentication to perform: </P>
+<UL>
+<LI><CODE>None</CODE> - No authentication should be performed 
+ (default.) </LI>
+<LI><CODE>Basic</CODE> - Basic authentication should be  performed 
+using the UNIX password and group files. </LI>
+</UL>
+<P>The <CODE>AuthType</CODE> directive must appear inside a <CODE>
+Location</CODE> directive. </P>
+<H3><A NAME=5_2_6>AuthClass</A></H3>
+<P>The <CODE>AuthClass</CODE> directive defines what level of <CODE>
+Basic</CODE> access is required: </P>
+<UL>
+<LI><CODE>Anonymous</CODE> - No authentication should be performed 
+ (default.) </LI>
+<LI><CODE>User</CODE> - A valid username and password is required. </LI>
+<LI><CODE>System</CODE> - A valid username and password is  required, 
+and the username must belong to the &quot;sys&quot; group (this  can be changed 
+using the <CODE>SystemGroup</CODE> directive,  below. </LI>
+<LI><CODE>Group</CODE> - A valid username and password is  required, 
+and the username must belong to the group named by  the <CODE>
+AuthGroupName</CODE> directive. </LI>
+</UL>
+<P>The <CODE>AuthClass</CODE> directive must appear inside a <CODE>
+Location</CODE> directive. </P>
+<H3><A NAME=5_2_7>AuthGroupName</A></H3>
+<P>The <CODE>AuthGroupName</CODE> directive sets the group to use for <CODE>
+Group</CODE> authentication. </P>
+<P>The <CODE>AuthGroupName</CODE> directive must appear inside a <CODE>
+Location</CODE> directive. </P>
+<H3><A NAME=5_2_8>SystemGroup</A></H3>
+<P>The <CODE>SystemGroup</CODE> directive sets the administration group 
+used when authenticating the <CODE>System</CODE> type. It defaults to 
+the &quot;sys&quot; group. </P>
+<H2><A NAME=5_3>File Formats</A></H2>
+<P>CUPS provides a MIME-based file typing and filtering mechanism to 
+convert files to a printable format for each printer. The <CODE>
+mime.types</CODE> and <CODE>mime.convs</CODE> files define the file 
+type and filters that are available on the system. </P>
+<H3><A NAME=5_3_1>mime.types</A></H3>
+<P>The <CODE>mime.types</CODE> defines the known file types. Each line 
+of the file starts with the MIME type and may be followed by one or 
+more file type recognition rules. For example, the <CODE>text/html</CODE>
+ file type is defined as: </P>
+<UL>
+<PRE>
+text/html html htm \
+          printable(0,1024) + (string(0,&quot;&lt;HTML&gt;&quot;) string(0,&quot;&lt;!DOCTYPE&quot;))
+</PRE>
+</UL>
+<P>The first two rules say that any file with an extension of &quot;.html&quot; 
+or &quot;.htm&quot; is a HTML file. The third rules says that any file whose 
+first 1024 characters are printable text and starts with the strings 
+&quot;&lt;HTML&gt;&quot; or &quot;&lt;!DOCTYPE&quot; is a HTML file as well. </P>
+<P>The first two rules deal solely with the name of the file being 
+typed. This is useful when the original filename is known, however for 
+print files the server doesn't always have a filename to work with. The 
+third rule takes care of this possibility and automatically figures out 
+the file type based upon the contents of the file instead. </P>
+<P>The available tests are: </P>
+<UL>
+<LI><CODE>( expr )</CODE> - Parenthesis for expression grouping </LI>
+<LI><CODE>+</CODE> - Logical AND </LI>
+<LI><CODE>,</CODE> or whitespace - Logical OR </LI>
+<LI><CODE>!</CODE> - Logical NOT </LI>
+<LI><CODE>match(&quot;pattern&quot;)</CODE> - Pattern match on filename </LI>
+<LI><CODE>extension</CODE> - Pattern match on &quot;*.extension&quot; </LI>
+<LI><CODE>ascii(offset,length)</CODE> - True if bytes are valid 
+ printable ASCII (CR, NL, TAB, BS, 32-126) </LI>
+<LI><CODE>printable(offset,length)</CODE> - True if bytes are 
+ printable 8-bit chars (CR, NL, TAB, BS, 32-126, 160-254) </LI>
+<LI><CODE>string(offset,&quot;string&quot;)</CODE> - True if bytes are  identical 
+to string </LI>
+<LI><CODE>char(offset,value)</CODE> - True if byte is identical </LI>
+<LI><CODE>short(offset,value)</CODE> - True if 16-bit integer  is 
+identical (network or &quot;big-endian&quot; byte order) </LI>
+<LI><CODE>int(offset,value)</CODE> - True if 32-bit integer is 
+ identical (network or &quot;big-endian&quot; byte order) </LI>
+<LI><CODE>locale(&quot;string&quot;)</CODE> - True if current locale  matches 
+string </LI>
+</UL>
+<H3><A NAME=5_3_2>mime.convs</A></H3>
+<P>The <CODE>mime.convs</CODE> file defines all of the filter programs 
+that are known to the system. Each line consists of: </P>
+<UL>
+<PRE>
+source destination cost program
+
+text/plain application/postscript 50 texttops
+application/vnd.cups-postscript application/vnd.cups-raster 50 pstoraster
+image/* application/vnd.cups-postscript 50 imagetops
+image/* application/vnd.cups-raster 50 imagetoraster
+</PRE>
+</UL>
+<P>The <I>source</I> field is a MIME type, optionally using a wildcard 
+for the super-type or sub-type (e.g. &quot;text/plain&quot;, &quot;image/*&quot;, 
+&quot;*/postscript&quot;). </P>
+<P>The <I>destination</I> field is a MIME type defined in the <CODE>
+mime.types</CODE> file. </P>
+<P>The <I>cost</I> field defines a relative cost for the filtering 
+operation from 1 to 100. The cost is used to choose between two 
+different sets of filters when converting a file. For example, to 
+convert from <CODE>image/jpeg</CODE> to <CODE>
+application/vnd.cups-raster</CODE>, you could use the <CODE>imagetops</CODE>
+ and <CODE>pstoraster</CODE> filters for a total cost of 100, or the <CODE>
+imagetoraster</CODE> filter for a total cost of 50. </P>
+<P>The <I>program</I> field defines the filter program to run; the 
+special program &quot;-&quot; can be used to make two file types equivalent. The 
+program must accept the standard filter arguments and environment 
+variables described in the CUPS Interface Design Document: </P>
+<UL>
+<PRE>
+program job user title options [filename]
+</PRE>
+</UL>
+<P>If specified, the <I>filename</I> argument defines a file to read 
+when filtering, otherwise the filter must read from the standard input. 
+All filtered output must go to the standard output. </P>
+<H1 ALIGN=RIGHT><A NAME=6>5 - Printer Accounting</A></H1>
+ This chapter describes the CUPS log files. 
+<H2><A NAME=6_1>Where to Find the Log Files</A></H2>
+<P>The log files are normally stored in the <CODE>/var/cups/logs</CODE>
+ directory. You can change this by editing the <CODE>
+/var/cups/conf/cupsd.conf</CODE> configuration file. </P>
+<H2><A NAME=6_2>The access_log File</A></H2>
+<P>The <CODE>access_log</CODE> file lists each HTTP resource that is 
+accessed by a web browser or CUPS/IPP client. Each line is in the 
+so-called &quot;Common Log Format&quot; used by many web servers and web 
+reporting tools: </P>
+<UL>
+<PRE>
+host group user date-time \&quot;method resource version\&quot; status bytes
+
+127.0.0.1 - - [20/May/1999:19:20:29 +0000] &quot;POST /admin/ HTTP/1.1&quot; 401 0
+127.0.0.1 - mike [20/May/1999:19:20:31 +0000] &quot;POST /admin/ HTTP/1.1&quot; 200 0
+</PRE>
+</UL>
+<P>The <I>host</I> field will normally only be an IP address unless you 
+have changed the <CODE>HostnameLookups</CODE> directive on in the <CODE>
+cupsd.conf</CODE> file. </P>
+<P>The <I>group</I> field always contains &quot;-&quot;. </P>
+<P>The <I>user</I> field is the authenticated username of the 
+requesting user. If no username and password is supplied for the 
+request then this field contains &quot;-&quot;. </P>
+<P>The <I>date-time</I> field is the date and time of the request in 
+Greenwich Mean Time (a.k.a. ZULU) and is in the format: </P>
+<UL>
+<PRE>
+[DD/MON/YYYY:HH:MM:SS +0000]
+</PRE>
+</UL>
+<P>The <I>method</I> field is the HTTP method used (&quot;GET&quot;, &quot;PUT&quot;, 
+&quot;POST&quot;, etc.) </P>
+<P>The <I>resource</I> field is the filename of the requested resource. </P>
+<P>The <I>version</I> field is the HTTP specification version used by 
+the client. For CUPS clients this will always be &quot;HTTP/1.1&quot;. </P>
+<P>The <I>status</I> field contains the HTTP result status of the 
+request. Usually it is &quot;200&quot;, but other HTTP status codes are possible. 
+For example, 401 is the &quot;unauthorized access&quot; status in the example 
+above. </P>
+<P>The <I>bytes</I> field contains the number of bytes in the request. 
+For POST requests the <I>bytes</I> field contains the number of bytes 
+of non-IPP data that is received from the client. </P>
+<H2><A NAME=6_3>The error_log File</A></H2>
+<P>The <CODE>error_log</CODE> file lists messages from the scheduler 
+(errors, warnings, etc.): </P>
+<UL>
+<PRE>
+level date-time message
+
+I [20/May/1999:19:18:28 +0000] Job 1 queued on 'DeskJet' by 'mike'.
+I [20/May/1999:19:21:02 +0000] Job 2 queued on 'DeskJet' by 'mike'.
+I [20/May/1999:19:22:24 +0000] Job 2 was cancelled by 'mike'.
+</PRE>
+</UL>
+<P>The <I>level</I> field contains the type of message: </P>
+<UL>
+<LI><CODE>E</CODE> - An error occurred. </LI>
+<LI><CODE>W</CODE> - The server was unable to perform some action. </LI>
+<LI><CODE>I</CODE> - Informational message. </LI>
+<LI><CODE>D</CODE> - Debugging message. </LI>
+</UL>
+<P>The <I>date-time</I> field contains the date and time of when the 
+page started printing. The format of this field is identical to the <I>
+data-time</I> field in the <CODE>access_log</CODE> file. </P>
+<P>The <I>message</I> fields contains a free-form textual message. </P>
+<H2><A NAME=6_4>The page_log File</A></H2>
+<P>The <CODE>page_log</CODE> file lists each page that is sent to a 
+printer. Each line contains the following information: </P>
+<UL>
+<PRE>
+printer user job-id date-time page-number num-copies
+
+DeskJet root 2 [20/May/1999:19:21:05 +0000] 1 0
+</PRE>
+</UL>
+<P>The <I>printer</I> field contains the name of the printer that 
+printed the page. If you send a job to a printer class, this field will 
+contain the name of the printer that was assigned the job. </P>
+<P>The <I>user</I> field contains the name of the user (the IPP <CODE>
+requesting-user-name</CODE> attribute) that submitted this file for 
+printing. </P>
+<P>The <I>job-id</I> field contains the job number of the page being 
+printed. Job numbers are reset to 1 whenever the CUPS server is 
+started, so don't depend on this number being unique! </P>
+<P>The <I>date-time</I> field contains the date and time of when the 
+page started printing. The format of this field is identical to the <I>
+data-time</I> field in the <CODE>access_log</CODE> file. </P>
+<P>The <I>page-number</I> and <I>num-pages</I> fields contain the page 
+number and number of copies being printed of that page. For printer 
+that can not produce copies on their own, the <I>num-pages</I> field 
+will always be 1. </P>
 </BODY>
 </HTML>
@@ -7,49 +7,846 @@
 </HEAD>
 <BODY>

-<H1>Scope</H1>
+<H1 ALIGN=RIGHT>Preface</H1>

-<H2>Identification</H2>
-
-This softwae administrators manual provides printer administration
+This software administrators manual provides printer administration
 information for the Common UNIX Printing System ("CUPS") Version 1.0.0.

+<H2>System Overview</H2>
+
+The Common UNIX Printing System provides a portable printing layer for 
+UNIX&reg; operating systems. It has been developed by Easy Software 
+Products to promote a standard printing solution for all UNIX vendors 
+and users. CUPS provides the System V and Berkeley command-line interfaces.
+
+<P>CUPS uses the Internet Printing Protocol (IETF-IPP) as the basis
+for managing print jobs and queues. The Line Printer Daemon (LPD,
+RFC1179), Server Message Block (SMB), and AppSocket protocols are also
+supported with reduced functionality.
+
+<P>CUPS adds network printer browsing and PostScript Printer
+Description (&quot;PPD&quot;)-based printing options to support real
+world applications under UNIX.
+
+<P>CUPS also includes a customized version of GNU GhostScript
+(currently based off GNU GhostScript 4.03) and an image file RIP that
+can be used to support non-PostScript printers.
+
 <H2>Document Overview</H2>

 <P>This software administrators manual is organized into the following sections:</P>

 <UL>
-	<LI>1 - Scope</LI>
-	<LI>2 - References</LI>
-	<LI>3 - Printing System Overview</LI>
-	<LI>4 - Printer Queue Management</LI>
-	<LI>5 - Printing System Management</LI>
-	<LI>A - Glossary</LI>
+	<LI>1 - Printing System Overview</LI>
+	<LI>2 - Building and Installing CUPS</LI>
+	<LI>3 - Printer Queue Management</LI>
+	<LI>4 - Printing System Management</LI>
+	<LI>5 - Printer Accounting</LI>
 </UL>

-<H1>Printing System Overview</H1>
+<H1 ALIGN=RIGHT>1 - Printing System Overview</H1>

-<H1>Printer Queue Management</H1>
+<P>This chapter provides an overview of how the Common UNIX Printing System
+works.

-<H2>Adding Printers</H2>
+<H2>The Printing Problem</H2>
+
+<P>For years <I>the printing problem</I> has plagued UNIX&reg;. Unlike
+Microsoft&reg; Windows&reg; or MacOS, UNIX has no standard interface or
+system in place for supporting printers. Among the solutions previously
+available, the Berkeley and System V printing systems are the most
+prevalent.
+
+<P>These printing systems support line printers (text only) or
+PostScript printers (text and graphics), and with some coaxing they can
+be made to support a full range of printers and file formats. However,
+because each varient of the UNIX operating system uses a different
+printing system than the next, developing printer drivers for a wide
+range of printers is extremely difficult. That combined with the
+limited volume of customers for each UNIX varient has forced most
+printer vendors to give up supporting UNIX entirely.
+
+<P>The Common UNIX Printing System, or CUPS, is designed to eliminate
+<I>the printing problem</I>. One common printing system can be used by
+all UNIX varients to support the printing needs of users. Printer
+vendors can use its modular filter interface to develop a single driver
+program that supports a wide range of file formats with little or no
+effort.  Since CUPS provides both the System V and Berkeley printing
+commands, users (and applications) can reap the benefits of this new
+technology with no changes.
+
+<H2>The Technology</H2>
+
+<P>CUPS is based upon an emerging Internet standard called the Internet
+Printing Protocol, or IPP. IPP has been embraced by dozens of printer
+and printer server manufacturers, and will be supported by the next
+Microsoft Windows operating system.
+
+<P>IPP defines a standard protocol for printing as well as managing print
+jobs and printer options like media size, resolution, and so forth. Like all
+IP-based protocols, IPP can be used locally or over the Internet to printers
+hundreds or thousands of miles away. Unlike other protocols, however, IPP
+also supports access control, authentication, and encryption, making it a
+much more secure printing solution than older ones.
+
+<P>IPP is layered on top of the Hyper-Text Transport Protocol, or HTTP,
+which is the basis of web servers on the Internet. This allows the user to
+view documentation and status information on a printer or server using their
+web browser.
+
+<P>CUPS provides a complete IPP/1.0-based printing system that provides Basic
+authentication and domain or IP-based access control. Digest authentication
+and TLS encryption will be available in future versions of CUPS.
+
+<H2>Filters</H2>
+
+<P>Filters allow a user or application to print many types of files
+without extra effort. Print jobs sent to a CUPS server are filtered
+before sending them to a printer. Some filters convert job files to
+different formats that the printer can understand. Others perform page
+selection and ordering tasks. <I>Backend</I> filters perform the most
+important task of all - they send the filtered print data to the
+printer.
+
+<P>CUPS provides filters for printing many types of image files,
+HP-GL/2 files, PDF files, and text files. CUPS also supplies
+PostScript and image file Raster Image Processors, or RIPs, that
+convert PostScript or image files into bitmaps that can be sent to a
+raster printer.
+
+<P>CUPS provides backends for printing over parallel and serial ports,
+and over the network via the JetDirect (AppSocket), Server Message
+Block, and Line Printer Daemon protocols.
+
+<H2>Printer Drivers</H2>
+
+<P>Printer drivers in CUPS consist of one of more filters specific to a
+printer. CUPS includes a sample printer driver for Hewlett-Packard
+LaserJet and DeskJet printers. While this driver does not generate
+optimal output for different printer models, it does demonstrate how
+you can write your own printer drivers and incorporate them into CUPS.
+
+<H1 ALIGN=RIGHT>2 - Building and Installing CUPS</H1>
+
+<P>This chapter shows how to build and install the Common UNIX Printing System.
+If you are installing a binary distribution from the CUPS web site, proceed to
+the section titled, <A HREF="#binary">Installing a Binary Distribution</A>.
+
+<H2>Installing a Source Distribution</H2>
+
+<H3>Requirements</H3>
+
+<P>You'll need an ANSI C compiler to build CUPS on your system. As its name
+implies, CUPS is designed to run on the UNIX operating system, however
+the CUPS interface library and most of the filters and backends supplied
+with CUPS should also run under Microsoft&reg; Windows&reg;.
+
+<P>For the image file filters and PostScript RIP, you'll need the JPEG,
+PNG, TIFF, and ZLIB libraries. CUPS will build without these, but with
+reduced functionality. Easy Software Products maintains a mirror of the
+current versions of these libraries at:
+
+<UL><PRE>
+<A HREF="ftp://ftp.easysw.com/pub/libraries">ftp://ftp.easysw.com/pub/libraries</A>
+</PRE></UL>
+
+<P>If you make changes to the man pages you'll need GNU groff or another
+nroff-like package. GNU groff is available from:
+
+<UL><PRE>
+<A HREF="ftp://ftp.gnu.org/pub/groff">ftp://ftp.gnu.org/pub/groff</A>
+</PRE></UL>
+
+<P>The documentation is formatted using the HTMLDOC software. If you need to
+make changes you can get the HTMLDOC software from:
+
+<UL><PRE>
+<A HREF="http://www.easysw.com/htmldoc">http://www.easysw.com/htmldoc</A>
+</PRE></UL>
+
+<H3>Compiling CUPS</H3>
+
+<P>CUPS uses GNU autoconf to configure the makefiles and source code
+for your system. To configure CUPS for your system type:
+
+<UL><PRE>
+% ./configure ENTER
+</PRE></UL>
+
+<P>The default installation will put the CUPS software in the
+<CODE>/usr</CODE> and <CODE>/var</CODE> directories on your system,
+which will overwrite any existing printing commands on your system. To
+install the CUPS software in another location use the
+<CODE>--prefix</CODE> option:
+
+<UL><PRE>
+% ./configure --prefix=/usr/local ENTER
+</PRE></UL>
+
+<P>If the PNG, JPEG, TIFF, and ZLIB libraries are not installed in a
+system default location (typically <CODE>/usr/include</CODE> and
+<CODE>/usr/lib</CODE>) you'll need to set the <CODE>CFLAGS</CODE> and
+<CODE>LDFLAGS</CODE> environment variables prior to running configure:
+
+<UL><PRE>
+% setenv CFLAGS "-I/some/directory"
+% setenv LDFLAGS "-L/some/directory"
+% ./configure ... ENTER
+</PRE></UL>
+
+<P>Once you have configured things, just type:
+
+<UL><PRE>
+% make ENTER
+</PRE></UL>
+
+<P>to build the software.
+
+<H3>Installing the Software</H3>
+
+<P>To install the software type:
+
+<UL><PRE>
+% make install ENTER
+</PRE></UL>
+
+<H3>Running the Software</A></H3>
+
+Once you have installed the software you can start the CUPS daemon by
+typing:
+
+<UL><PRE>
+% /usr/sbin/cupsd &amp; ENTER
+</PRE></UL>
+
+<H2><A NAME="binary">Installing a Binary Distribution</A></H2>
+
+<P>We are currently distributing CUPS binary distributions in TAR format
+with installation and removal scripts.
+
+<UL>
+	<B>WARNING:</B>
+	
+	<P>Installing CUPS will overwrite your existing printing
+	system. If you experience difficulties with the CUPS software
+	and need to go back to your old printing system, you will need
+	to remove the CUPS software with the provided script and
+	reinstall the printing system from your operating system CDs.
+</UL>
+
+<P>To install the CUPS software you will need to be logged in as root
+(doing an "su" is good enough). Once you are the root user, run the
+installation script with:
+
+<UL><PRE>
+./cups.install ENTER
+</PRE></UL>
+
+<P>After asking you a few yes/no questions the CUPS software will be
+installed and the scheduler will be started automatically.
+
+<H1 ALIGN=RIGHT>3 - Printer Queue Management</H1>
+
+<P>This chapter discusses how to add, modify, and delete print queues
+on your system.
+
+<H2>The lpadmin Command</H2>
+
+<P>The <CODE>lpadmin</CODE> command allows you to perform most printer
+administration tasks from the command-line. Since <CODE>lpadmin</CODE>
+is also a System V printing system command, it is located in the
+<CODE>/usr/lib</CODE> directory instead of a more common one like
+<CODE>/usr/bin</CODE> or <CODE>/usr/sbin</CODE>.
+
+<H2>Adding and Modifying Printers</H2>
+
+<P>To add a printer to CUPS you simply run the <CODE>lpadmin</CODE> command
+with the "-p" option:
+
+<UL><PRE>
+% /usr/lib/lpadmin -p<I>printer</I> -v<I>device</I> -P<I>ppd</I> ENTER
+</PRE></UL>
+
+<P>Spaces between the option letter and value are optional.
+
+<P>The <I>printer</I> name can be up to 127 letters, digits, hyphens,
+and underscores. Unlike other printing systems, the printer name in
+CUPS is <I>not</I> case-sensitive, so you can't add two printers named
+<CODE>LaserJet</CODE> and <CODE>laserjet</CODE>.
+
+<P>The <I>device</I> argument specifies the device URI or filename for the
+printer. The following devices are supported in a basic installation of
+CUPS:
+
+<DL>
+
+	<DT>file:/dev/filename
+	<DT>/dev/filename
+	<DD>Sends all output to the specified file.
+
+	<DT>ipp://hostname[:port]/resource
+	<DD>Sends all output to the specified IPP printer or server.
+	The <I>port</I> parameters defaults to 631.
+
+	<DT>lpd://hostname/queue
+	<DD>Sends all output to the specified LPD printer queue.
+
+	<DT>parallel:/dev/filename
+	<DD>Sends all output to the specified parallel port device.
+
+	<DT>serial:/dev/filename[?options]
+	<DD>Sends all output to the specified serial port device.  The
+	<I>options</I> can be any of the following separated by the
+	plus (+) character:
+	<UL>
+		<LI><CODE>baud=<I>rate</I></CODE> - Sets the baud rate
+		for the device.
+		<LI><CODE>bits=<I>7 or 8</I></CODE> - Sets the number
+		of data bits.
+		<LI><CODE>parity=<I>even</I></CODE> - Sets even parity
+		checking.
+		<LI><CODE>parity=<I>odd</I></CODE> - Sets odd parity
+		checking.
+		<LI><CODE>parity=<I>none</I></CODE> - Turns parity
+		checking off.
+	</UL>
+
+	<DT>socket://hostname[:port]
+	<DD>Sends all output to the specified printer using the
+	AppSocket protocol. The <I>port</I> parameter defaults to 9100.
+
+</DL>
+
+<P>The <I>ppd</I> argument specifies the PostScript Printer Description file
+to use for this printer. Many options (such as media size, etc.) will not
+be available if you omit this part of the <CODE>lpadmin</CODE> command.
+
+<H3>Using Standard Printer Drivers</H2>
+
+<P>The <CODE>lpadmin</CODE> command allows you to use "standard" PPD files
+and interface scripts located in the <CODE>/usr/share/cups/model</CODE>
+directory with the "-m" option:
+
+<UL><PRE>
+% /usr/lib/lpadmin -p<I>printer</I> -v<I>device</I> -m<I>model</I> ENTER
+</PRE></UL>
+
+<P>The <I>model</I> argument specifies the name of the PPD file or interface
+script. For example, to add a printer using the sample HP DeskJet series
+driver connected to parallel port 1 under Linux you would use:
+
+<UL><PRE>
+% /usr/lib/lpadmin -pDeskJet -vparallel:/dev/par1 -mdeskjet.ppd ENTER
+</PRE></UL>

 <H2>Removing Printers</H2>

-<H2>Reconfiguring Printers</H2>
+<P>To remove a printer to CUPS you simply run the <CODE>lpadmin</CODE> command
+with the "-x" option:

-<H2>Printer Options</H2>
+<UL><PRE>
+% /usr/lib/lpadmin -x<I>printer</I> ENTER
+</PRE></UL>

-<H2>Printer Security</H2>
+<H2>Printer Classes</H2>

-<H2>Printer Accounting</H2>
+<P>CUPS allows you to group similar printers in a <I>printer class</I>. When
+a user sends a print job to a class, the job will be processed by the first
+available printer in that class.

-<H1>Printing System Management</H1>
+<P>To add a printer to a class you simply run the <CODE>lpadmin</CODE> command
+with the "-p" and "-c" options:

-<H2>Log Files</H2>
+<UL><PRE>
+% /usr/lib/lpadmin -p<I>printer</I> -c<I>class</I> ENTER
+</PRE></UL>
+
+<P>The <I>class</I> is created automatically if it doesn't exist. To remove a
+class just use the "-x" option:
+
+<UL><PRE>
+% /usr/lib/lpadmin -x<I>class</I> ENTER
+</PRE></UL>
+
+<H2>Setting the Default Printer</H2>
+
+<P>To set the default printer or class simply run the <CODE>lpadmin</CODE>
+command with the "-d" option:
+
+<UL><PRE>
+% /usr/lib/lpadmin -d<I>destination</I> ENTER
+</PRE></UL>
+
+<P>The <I>destination</I> argument is the name of the printer or class.
+
+<H1 ALIGN=RIGHT>4 - Printing System Management</H1>
+
+<P>This chapter shows how you can configure the CUPS server.

 <H2>Network Configuration</H2>

-<H2>Adding File Types</H2>
+<P>The default configuration of the CUPS server listens for connections from
+all network interfaces on port 631 (the standard IPP port). Administration
+functions are limited to local connections with the appropriate username and
+password.
+
+<P>If you'd like to limit access to your system you'll need to edit the
+<CODE>/var/cups/conf/cupsd.conf</CODE> file.
+
+<H3>Port</H3>
+
+<P>The <CODE>Port</CODE> directive specifies a port to listen on for
+all interfaces. Besides the standard IPP port (631) you can also setup
+your server to listen on the HTTP port (80) to use your CUPS server as
+a standard web server as well.
+
+<H3>Listen</H3>
+
+<P>The <CODE>Listen</CODE> directive specifies a listening address and port,
+extending the functionality of the <CODE>Port</CODE> directive. If you want
+to allow connections only from the local machine you can use:
+
+<UL><PRE>
+Listen 127.0.0.1:631
+</PRE></UL>
+
+<P>instead of the <CODE>Port</CODE> directive.
+
+<P>If you want to limit access to a specific network/subnet, make sure you
+specify only the network address and not your system's network address!
+
+<H3>BrowsePort</H3>
+
+<P>The <CODE>BrowsePort</CODE> directive controls which port is monitored for
+remote printers. By default it is set to the IPP port (631), however you can
+change it as needed.
+
+<UL>
+
+	<B>NOTE:</B>
+
+	<P>You must set the <CODE>BrowsePort</CODE> to the same value
+	on all of the systems that you want to see.
+
+</UL>
+
+<H3>BrowseAddress</H3>
+
+<P>The <CODE>BrowseAddress</CODE> directive specifies a broadcast address to
+use when sending printer status updates over the network. The default
+browse address is <CODE>255.255.255.255</CODE> which will send printer
+information to all subnets.
+
+<UL>
+
+	<B>NOTE:</B>
+
+	<P>If you are using HP-UX 10.20 and a subnet that is not 24,
+	16, or 8 bits, printer browsing (and in fact all broadcast
+	reception) will not work. This problem appears to be fixed in
+	HP-UX 11.0.
+
+</UL>
+
+<H2>Printer Security</H2>
+
+<P>CUPS provides IP and domain-name based access control and Basic
+authentication for authentication.
+
+<H3>Location</H3>
+
+<P>The <CODE>Location</CODE> directive defines access control for a
+specific HTTP directory. The following pseudo directories are provided
+by the CUPS server:
+
+<UL>
+
+	<LI><CODE>/admin</CODE> - This is the URI that must be referenced to
+	do printer administation commands.
+
+	<LI><CODE>/classes</CODE> - This is the URI that must be referenced to
+	access printer classes.
+
+	<LI><CODE>/jobs</CODE> - This is the URI that must be referenced to
+	access jobs.
+
+	<LI><CODE>/printers</CODE> - This is the URI that must be referenced to
+	access printers.
+
+</UL>
+
+<P>All other directories are taken from the
+<CODE>/usr/share/cups/doc</CODE> directory.
+
+<P>The <CODE>Location</CODE> directive surrounds the other access control
+directives described below. The default server configuration uses:
+
+<UL><PRE>
+&lt;Location /admin&gt;
+AuthType Basic
+AuthClass System
+
+Order Deny,Allow
+Deny From All
+Allow From 127.0.0.1
+&lt;/Location&gt;
+</PRE></UL>
+
+<H3>Order</H3>
+
+<P>The <CODE>Order</CODE> directive defines the default access control.
+The following values are supported:
+
+<UL>
+
+	<LI><CODE>Order Allow,Deny</CODE> - Allow requests from all
+	systems <I>except</I> for those listed in a <CODE>Deny</CODE>
+	directive.
+
+	<LI><CODE>Order Deny,Allow</CODE> - Allow requests only from
+	those listed in an <CODE>Allow</CODE> directive.
+
+</UL>
+
+<P>The <CODE>Order</CODE> directive must appear inside a
+<CODE>Location</CODE> directive.
+
+<H3>Allow</H3>
+
+<P>The <CODE>Allow</CODE> directive specifies a hostname, IP address, or
+network that is allowed access to the server:
+
+<UL><PRE>
+Allow from All
+Allow from None
+Allow from *.domain.com
+Allow from .domain.com
+Allow from host.domain.com
+Allow from nnn.*
+Allow from nnn.nnn.*
+Allow from nnn.nnn.nnn.*
+Allow from nnn.nnn.nnn.nnn
+Allow from nnn.nnn.nnn.nnn/mm
+Allow from nnn.nnn.nnn.nnn/mmm.mmm.mmm.mmm
+</PRE></UL>
+
+<P><CODE>Allow</CODE> directives are cummulative, so multiple <CODE>Allow</CODE>
+directives can be used to allow access for multiple hosts or networks.
+
+<P>The <CODE>Allow</CODE> directive must appear inside a
+<CODE>Location</CODE> directive.
+
+<H3>Deny</H3>
+
+<P>The <CODE>Deny</CODE> directive specifies a hostname, IP address, or
+network that is allowed access to the server:
+
+<UL><PRE>
+Deny from All
+Deny from None
+Deny from *.domain.com
+Deny from .domain.com
+Deny from host.domain.com
+Deny from nnn.*
+Deny from nnn.nnn.*
+Deny from nnn.nnn.nnn.*
+Deny from nnn.nnn.nnn.nnn
+Deny from nnn.nnn.nnn.nnn/mm
+Deny from nnn.nnn.nnn.nnn/mmm.mmm.mmm.mmm
+</PRE></UL>
+
+<P><CODE>Deny</CODE> directives are cummulative, so multiple <CODE>Deny</CODE>
+directives can be used to allow access for multiple hosts or networks.
+
+<P>The <CODE>Deny</CODE> directive must appear inside a
+<CODE>Location</CODE> directive.
+
+<H3>AuthType</H3>
+
+<P>The <CODE>AuthType</CODE> directive defines the type of authentication to
+perform:
+
+<UL>
+
+	<LI><CODE>None</CODE> - No authentication should be performed
+	(default.)
+
+	<LI><CODE>Basic</CODE> - Basic authentication should be
+	performed using the UNIX password and group files.
+
+</UL>
+
+<P>The <CODE>AuthType</CODE> directive must appear inside a
+<CODE>Location</CODE> directive.
+
+<H3>AuthClass</H3>
+
+<P>The <CODE>AuthClass</CODE> directive defines what level of <CODE>Basic</CODE>
+access is required:
+
+<UL>
+
+	<LI><CODE>Anonymous</CODE> - No authentication should be performed
+	(default.)
+
+	<LI><CODE>User</CODE> - A valid username and password is required.
+
+	<LI><CODE>System</CODE> - A valid username and password is
+	required, and the username must belong to the "sys" group (this
+	can be changed using the <CODE>SystemGroup</CODE> directive,
+	below.
+
+	<LI><CODE>Group</CODE> - A valid username and password is
+	required, and the username must belong to the group named by
+	the <CODE>AuthGroupName</CODE> directive.
+
+</UL>
+
+<P>The <CODE>AuthClass</CODE> directive must appear inside a
+<CODE>Location</CODE> directive.
+
+<H3>AuthGroupName</H3>
+
+<P>The <CODE>AuthGroupName</CODE> directive sets the group to use for
+<CODE>Group</CODE> authentication.
+
+<P>The <CODE>AuthGroupName</CODE> directive must appear inside a
+<CODE>Location</CODE> directive.
+
+<H3>SystemGroup</H3>
+
+<P>The <CODE>SystemGroup</CODE> directive sets the administration group used
+when authenticating the <CODE>System</CODE> type. It defaults to the "sys"
+group.
+
+<H2>File Formats</H2>
+
+<P>CUPS provides a MIME-based file typing and filtering mechanism to
+convert files to a printable format for each printer. The
+<CODE>mime.types</CODE> and <CODE>mime.convs</CODE> files define the
+file type and filters that are available on the system.
+
+<H3>mime.types</H3>
+
+<P>The <CODE>mime.types</CODE> defines the known file types. Each line
+of the file starts with the MIME type and may be followed by one or
+more file type recognition rules. For example, the
+<CODE>text/html</CODE> file type is defined as:
+
+<UL><PRE>
+text/html html htm \
+          printable(0,1024) + (string(0,"&lt;HTML&gt;") string(0,"&lt;!DOCTYPE"))
+</PRE></UL>
+
+<P>The first two rules say that any file with an extension of ".html" or
+".htm" is a HTML file. The third rules says that any file whose first
+1024 characters are printable text and starts with the strings "&lt;HTML&gt;"
+or "&lt;!DOCTYPE" is a HTML file as well.
+
+<P>The first two rules deal solely with the name of the file being
+typed. This is useful when the original filename is known, however for
+print files the server doesn't always have a filename to work with. The
+third rule takes care of this possibility and automatically figures out
+the file type based upon the contents of the file instead.
+
+<P>The available tests are:
+
+<UL>
+
+	<LI><CODE>( expr )</CODE> - Parenthesis for expression grouping
+
+	<LI><CODE>+</CODE> - Logical AND
+
+	<LI><CODE>,</CODE> or whitespace - Logical OR
+
+	<LI><CODE>!</CODE> - Logical NOT
+
+	<LI><CODE>match("pattern")</CODE> - Pattern match on filename
+
+	<LI><CODE>extension</CODE> - Pattern match on "*.extension"
+
+	<LI><CODE>ascii(offset,length)</CODE> - True if bytes are valid
+	printable ASCII (CR, NL, TAB, BS, 32-126)
+
+	<LI><CODE>printable(offset,length)</CODE> - True if bytes are
+	printable 8-bit chars (CR, NL, TAB, BS, 32-126, 160-254)
+
+	<LI><CODE>string(offset,"string")</CODE> - True if bytes are
+	identical to string
+
+	<LI><CODE>char(offset,value)</CODE> - True if byte is identical
+
+	<LI><CODE>short(offset,value)</CODE> - True if 16-bit integer
+	is identical (network or "big-endian" byte order)
+
+	<LI><CODE>int(offset,value)</CODE> - True if 32-bit integer is
+	identical (network or "big-endian" byte order)
+
+	<LI><CODE>locale("string")</CODE> - True if current locale
+	matches string
+
+</UL>
+
+<H3>mime.convs</H3>
+
+<P>The <CODE>mime.convs</CODE> file defines all of the filter programs that
+are known to the system. Each line consists of:
+
+<UL><PRE>
+source destination cost program
+
+text/plain application/postscript 50 texttops
+application/vnd.cups-postscript application/vnd.cups-raster 50 pstoraster
+image/* application/vnd.cups-postscript 50 imagetops
+image/* application/vnd.cups-raster 50 imagetoraster
+</PRE></UL>
+
+<P>The <I>source</I> field is a MIME type, optionally using a wildcard for
+the super-type or sub-type (e.g. "text/plain", "image/*", "*/postscript").
+
+<P>The <I>destination</I> field is a MIME type defined in the
+<CODE>mime.types</CODE> file.
+
+<P>The <I>cost</I> field defines a relative cost for the filtering
+operation from 1 to 100. The cost is used to choose between two
+different sets of filters when converting a file. For example, to convert
+from <CODE>image/jpeg</CODE> to <CODE>application/vnd.cups-raster</CODE>,
+you could use the <CODE>imagetops</CODE> and <CODE>pstoraster</CODE>
+filters for a total cost of 100, or the <CODE>imagetoraster</CODE> filter
+for a total cost of 50.
+
+<P>The <I>program</I> field defines the filter program to run; the
+special program "-" can be used to make two file types equivalent. The
+program must accept the standard filter arguments and environment
+variables described in the CUPS Interface Design Document:
+
+<UL><PRE>
+program job user title options [filename]
+</PRE></UL>
+
+<P>If specified, the <I>filename</I> argument defines a file to read
+when filtering, otherwise the filter must read from the standard input.
+All filtered output must go to the standard output.
+
+<H1 ALIGN=RIGHT>5 - Printer Accounting</H1>
+
+This chapter describes the CUPS log files.
+
+<H2>Where to Find the Log Files</H2>
+
+<P>The log files are normally stored in the <CODE>/var/cups/logs</CODE>
+directory. You can change this by editing the
+<CODE>/var/cups/conf/cupsd.conf</CODE> configuration file.
+
+<H2>The access_log File</H2>
+
+<P>The <CODE>access_log</CODE> file lists each HTTP resource that is accessed
+by a web browser or CUPS/IPP client. Each line is in the so-called "Common
+Log Format" used by many web servers and web reporting tools:
+
+<UL><PRE>
+host group user date-time \"method resource version\" status bytes
+
+127.0.0.1 - - [20/May/1999:19:20:29 +0000] "POST /admin/ HTTP/1.1" 401 0
+127.0.0.1 - mike [20/May/1999:19:20:31 +0000] "POST /admin/ HTTP/1.1" 200 0
+</PRE></UL>
+
+<P>The <I>host</I> field will normally only be an IP address unless you
+have changed the <CODE>HostnameLookups</CODE> directive on in the
+<CODE>cupsd.conf</CODE> file.
+
+<P>The <I>group</I> field always contains "-".
+
+<P>The <I>user</I> field is the authenticated username of the requesting user.
+If no username and password is supplied for the request then this field
+contains "-".
+
+<P>The <I>date-time</I> field is the date and time of the request in Greenwich
+Mean Time (a.k.a. ZULU) and is in the format:
+
+<UL><PRE>
+[DD/MON/YYYY:HH:MM:SS +0000]
+</PRE></UL>
+
+<P>The <I>method</I> field is the HTTP method used ("GET", "PUT", "POST", etc.)
+
+<P>The <I>resource</I> field is the filename of the requested resource.
+
+<P>The <I>version</I> field is the HTTP specification version used by the
+client. For CUPS clients this will always be "HTTP/1.1".
+
+<P>The <I>status</I> field contains the HTTP result status of the
+request. Usually it is "200", but other HTTP status codes are possible.
+For example, 401 is the "unauthorized access" status in the example
+above.
+
+<P>The <I>bytes</I> field contains the number of bytes in the request.
+For POST requests the <I>bytes</I> field contains the number of bytes
+of non-IPP data that is received from the client.
+
+<H2>The error_log File</H2>
+
+<P>The <CODE>error_log</CODE> file lists messages from the scheduler (errors,
+warnings, etc.):
+
+<UL><PRE>
+level date-time message
+
+I [20/May/1999:19:18:28 +0000] Job 1 queued on 'DeskJet' by 'mike'.
+I [20/May/1999:19:21:02 +0000] Job 2 queued on 'DeskJet' by 'mike'.
+I [20/May/1999:19:22:24 +0000] Job 2 was cancelled by 'mike'.
+</PRE></UL>
+
+<P>The <I>level</I> field contains the type of message:
+
+<UL>
+
+	<LI><CODE>E</CODE> - An error occurred.
+
+	<LI><CODE>W</CODE> - The server was unable to perform some action.
+
+	<LI><CODE>I</CODE> - Informational message.
+
+	<LI><CODE>D</CODE> - Debugging message.
+
+</UL>
+
+<P>The <I>date-time</I> field contains the date and time of when the page
+started printing. The format of this field is identical to the <I>data-time</I>
+field in the <CODE>access_log</CODE> file.
+
+<P>The <I>message</I> fields contains a free-form textual message.
+
+<H2>The page_log File</H2>
+
+<P>The <CODE>page_log</CODE> file lists each page that is sent to a printer.
+Each line contains the following information:
+
+<UL><PRE>
+printer user job-id date-time page-number num-copies
+
+DeskJet root 2 [20/May/1999:19:21:05 +0000] 1 0
+</PRE></UL>
+
+<P>The <I>printer</I> field contains the name of the printer that
+printed the page. If you send a job to a printer class, this field will
+contain the name of the printer that was assigned the job.
+
+<P>The <I>user</I> field contains the name of the user (the IPP
+<CODE>requesting-user-name</CODE> attribute) that submitted this file for
+printing.
+
+<P>The <I>job-id</I> field contains the job number of the page being printed.
+Job numbers are reset to 1 whenever the CUPS server is started, so don't depend
+on this number being unique!
+
+<P>The <I>date-time</I> field contains the date and time of when the page
+started printing. The format of this field is identical to the <I>data-time</I>
+field in the <CODE>access_log</CODE> file.
+
+<P>The <I>page-number</I> and <I>num-pages</I> fields contain the page number
+and number of copies being printed of that page. For printer that can not
+produce copies on their own, the <I>num-pages</I> field will always be 1.

 </BODY>
 </HTML>
@@ -116,6 +116,9 @@ with reduced functionality. </P>
 <P>CUPS adds network printer browsing and PostScript Printer 
 Description (&quot;PPD&quot;)-based printing options to support real world 
 applications under UNIX. </P>
+<P>CUPS also includes a customized version of GNU GhostScript 
+(currently based off GNU GhostScript 4.03) and an image file RIP that 
+can be used to support non-PostScript printers. </P>
 <H2><A NAME=1_3>1.3 Document Overview</A></H2>
 This software design description document is organized into the 
 following sections: 
@@ -1,6 +1,6 @@
 %PDF-1.2
 %âãÏÓ
-1 0 obj<</Producer(htmldoc 2.0b1 Copyright 1997-1999 Michael Sweet, All Rights Reserved.)/CreationDate(D:19990513142506Z)/Title(DRAFT - CUPS Software Design Description)/Author(Easy Software Products)>>endobj
+1 0 obj<</Producer(htmldoc 2.0b1 Copyright 1997-1999 Michael Sweet, All Rights Reserved.)/CreationDate(D:19990521210321Z)/Title(DRAFT - CUPS Software Design Description)/Author(Easy Software Products)>>endobj
 2 0 obj<</Type/Encoding/BaseEncoding/WinAnsiEncoding>>endobj
 3 0 obj<</Type/Font/Subtype/Type1/BaseFont/Courier/Encoding 2 0 R>>endobj
 4 0 obj<</Type/Font/Subtype/Type1/BaseFont/Courier-Oblique/Encoding 2 0 R>>endobj
@@ -17,9 +17,9 @@
 15 0 obj<</Subtype/Link/Rect[108.0 646.8 124.5 659.8]/Border[0 0 0]/Dest[219 0 R/XYZ null 658 0]>>endobj
 16 0 obj<</Subtype/Link/Rect[124.5 646.8 159.6 659.8]/Border[0 0 0]/Dest[219 0 R/XYZ null 658 0]>>endobj
 17 0 obj<</Subtype/Link/Rect[159.6 646.8 203.0 659.8]/Border[0 0 0]/Dest[219 0 R/XYZ null 658 0]>>endobj
-18 0 obj<</Subtype/Link/Rect[108.0 633.6 124.5 646.6]/Border[0 0 0]/Dest[219 0 R/XYZ null 474 0]>>endobj
-19 0 obj<</Subtype/Link/Rect[124.5 633.6 173.1 646.6]/Border[0 0 0]/Dest[219 0 R/XYZ null 474 0]>>endobj
-20 0 obj<</Subtype/Link/Rect[173.1 633.6 216.4 646.6]/Border[0 0 0]/Dest[219 0 R/XYZ null 474 0]>>endobj
+18 0 obj<</Subtype/Link/Rect[108.0 633.6 124.5 646.6]/Border[0 0 0]/Dest[219 0 R/XYZ null 434 0]>>endobj
+19 0 obj<</Subtype/Link/Rect[124.5 633.6 173.1 646.6]/Border[0 0 0]/Dest[219 0 R/XYZ null 434 0]>>endobj
+20 0 obj<</Subtype/Link/Rect[173.1 633.6 216.4 646.6]/Border[0 0 0]/Dest[219 0 R/XYZ null 434 0]>>endobj
 21 0 obj<</Subtype/Link/Rect[72.0 607.2 80.2 620.2]/Border[0 0 0]/Dest[225 0 R/XYZ null 818 0]>>endobj
 22 0 obj<</Subtype/Link/Rect[80.2 607.2 131.6 620.2]/Border[0 0 0]/Dest[225 0 R/XYZ null 818 0]>>endobj
 23 0 obj<</Subtype/Link/Rect[108.0 594.0 124.5 607.0]/Border[0 0 0]/Dest[225 0 R/XYZ null 737 0]>>endobj
@@ -292,7 +292,7 @@
 153 0 obj<</D[219 0 R/XYZ null 818 null]>>endobj
 154 0 obj<</D[219 0 R/XYZ null 737 null]>>endobj
 155 0 obj<</D[219 0 R/XYZ null 658 null]>>endobj
-156 0 obj<</D[219 0 R/XYZ null 474 null]>>endobj
+156 0 obj<</D[219 0 R/XYZ null 434 null]>>endobj
 157 0 obj<</D[225 0 R/XYZ null 818 null]>>endobj
 158 0 obj<</D[225 0 R/XYZ null 737 null]>>endobj
 159 0 obj<</D[225 0 R/XYZ null 540 null]>>endobj
@@ -408,17 +408,13 @@ endobj
 œéöÐ1‡ �à,�sdÞ Tê×ŒÌÇ3 ÔKÎcîç$ÆÇÜa:\‡±†;peu°ÃµfŽàB*ý@±ž1ð?j˜c†	À©ÃtXÄë€í‡é°”éL�/AƒÈ!Qà¸ÖX°•Ý5CreŽt˜Œ¸A8F†Xûª¥qB
 Õ,
 3Cìuâ,ùV…™!öªõØ§»@sá
-±GéÈl
-SCô“‘5^)^`&°}ZâÇ7C-—ôÆ¶ÄÜHº 06Äž4QùP0´=yg´ªWÆÀxÔöã�sCkc_ßË“‘¡l��'fÆ²6}¤`aàÚ÷bw„T®”Ôa6µƒ¢Y!™Kz#�ÉÈ|€#·	&……›‚%s°P‘Æõ‚ÁE»Ãcùn`)l	uÀÂêBÉ*ÌUñÊŽ‰€�ùªE0–>+ë%w²K/U`+J;‚½H	Û7ƒÁ¢6™ª«å4Øóü'ëàÙbQo²¹ŠˆVÿ¦sT¹¦ßfÃçJY\žCí,†Å·Å]\Ìó¼ó¤çÎjŸurÅ·à¿tþ^°†qaÂ%=~9GYc~Áûô•—A‡mÇÙe—9Þ3©:¦Ý\&¶G{ÐöuÄþÜ…!u¦4ÈË‡F¿Éûedò¸
-S®Ü³SÎÎ—Ëåë‡Çr¿\^D†Ÿ¶0æ²ÑaÖKWþ#†K:Èµ°Àe&‰£tŽË½[Yár®Ãº—¾p\rjÝ…ä"ìÚQzH®"r‰kc�+›Vw¡¹X+=i|b“+w†kQØärFëqÛx.MEãi\Ü%œDƒÆå„t`÷{)\r2VHãrÀÑ[‡$®Ñ-Ÿu@ãÊ'b…T®‘ã_Â6‘kTK¤ä¾P¹ÆôÎ”í'*×ˆ�=)iŽÌ5Ú£¥½Ð¹FbÄÄ2×8CŒ¸·ËàeˆQ³8\”ôÀ14ƒÍ5¸vÐSåx\k#�É%…»RhÂ5¤(²R‡¹\Ã�ñ2ÉØ\Œ´ŸA—1×@“1æ‰®!ü³Ï=HaÂÕ¿)ò³4�¸ú3H>5ãêWM’…
-¹útÐF9Ð¦\ý�™%ãs‘s¨{š˜ØçêcÚb˜®n‡Ë¾,šŸ›°ÂUH»¶xiÞ";\�¶h¯Ë‚MáW!/Üé,›\–ºì|S¸ÆUÈkc|m«-6¹ø©ÕªK{-±Ëe�^�HÝ“‹Kf—ª.ÙùkÛmèƒ‹˜ï/{xÏE?\�å—ïŸßôrûÞ¸v½Öa�gË‡¾îÝ'×®Û®—gê~º|èó¾}sí;n{Âayq¶-çËååÃCï·„k„É§Wé«;ùêÝ�ÅÕG!'n®ÅÍúí��?ÿÓCvû£oÄ}¹ÈýÝ·¿ýöËgñðùë/¿ÿãö??}ùåOß~ùõ�ÿ,ÿ÷ñnÄÕÕö®>¼ûA¼¹zÿözû!Û‹ßäo®Þ®·ß\Ý¼ýA¼¹þ°¿GòÛ¯?}6|ùõç¿üôíë®âMõs~ýÓß¿üòûÿùöØÎ�?¼yü×Ç·øƒÈ¶¿ü*²Ï_?ùëçŸ·—&ò‘êÿTMòšendstream
-endobj
-215 0 obj
-6311
-endobj
+±GéÈl
+SCô“‘5^)^`&°}ZâÇ7C-—ôÆ¶ÄÜHº 06Äž4QùP0´=yg´ªWÆÀxÔöã�sCkc_ßË“‘¡l��'fÆ²6}¤`aàÚ÷bw„T®”Ôa6µƒ¢Y!™Kz#�ÉÈ|€#·	&……›‚%s°P‘Æõ‚ÁE»Ãcùn`)l	uÀÂêBÉ*ÌUñÊŽ‰€�ùªE0–>+ë%w²K/U`+J;‚½H	Û7ƒÁ¢6™ª«å4Øóü'ëàÙbQo²¹ŠˆVÿ¦sT¹¦ßfÃçJY\žCí,†Å·Å]\Ìó¼ó¤çÎjŸurÅ·à¿tþ^°†qaÂ%=~9GYc~Áûô•—A‡mÇÙe—9Þ3©:¦Ý\&¶G{ÐöuÄþÜ…!u¦4ÈË‡F¿Éûedò¸
+S®Ü³SÎÎ—Ëåë‡Çr¿\^D†Ÿ¶0æ²ÑaÖKWþ#†K:Èµ°Àe&‰£tŽË½[Yár®Ãº—¾p\rjÝ…ä"ìÚQzH®"r‰kc�+›Vw¡¹X+=i|b“+w†kQØärFëqÛx.MEãi\Ü%œDƒÆå„t`÷{)\r2VHãrÀÑ[‡$®Ñ-Ÿu@ãÊ'b…T®‘ã_Â6‘kTK¤ä¾P¹ÆôÎ”í'*×ˆ�=)iŽÌ5Ú£¥½Ð¹FbÄÄ2×8CŒ¸·ËàeˆQ³8\”ôÀ14ƒÍ5¸vÐSåx\k#�É%…»RhÂ5¤(²R‡¹\Ã�ñ2ÉØ\Œ´ŸA—1×@“1æ‰®!ü³Ï=HaÂÕ¿)ò³4�¸ú3H>5ãêWM’…
+¹útÐF9Ð¦\ý�™%ãs‘s¨{š˜ØçêcÚb˜®n‡Ë¾,šŸ›°ÂUH»¶xiÞ";\�¶h¯Ë‚MáW!/Üé,›\–ºì|S¸ÆUÈkc|m«-6¹ø©ÕªK{-±Ëe�^�HÝ“‹Kf—ª.ÙùkÛmèƒ‹˜ï/{xÏE?\�å—ïŸßôrûÞ¸v½Öa�gË‡¾îÝ'×®Û®—gê~º|èó¾}sí;n{Âayq¶-çËååÃCï·„k„É§Wé«;ùêÝ�ÅÕG!'n®ÅÍúí��?ÿÓCvû£oÄ}¹ÈýÝ·¿ýöËgñðùë/¿ÿãö??}ùåOß~ùõ�ÿ,ÿ÷ñnÄÕÕö®>¼ûA¼¹zÿözû!Û‹ßäo®Þ®·ß\Ý¼ýA¼¹þ°¿GòÛ¯?}6|ùõç¿üôíë®âMõs~ýÓß¿üòûÿùöØÎ�?¼yü×Ç·øƒÈ¶¿ü*²Ï_?ùëçŸ·—&ò‘êÿTMòšendstream
 endobj
 215 0 obj
-xÚ+ä2T0BCc3JÎår
+6311
 endobj
 216 0 obj<</Type/Page/Parent 212 0 R/Contents 217 0 R/Resources<</ProcSet[/PDF/Text]/Font<</F8 8 0 R>>>>>>endobj
 217 0 obj<</Length 218 0 R/Filter/FlateDecode>>stream
@@ -592,7 +588,7 @@ endobj
 xÚ+ä2T0BCc3JÎår
 áÒw³P04TIS046Ò3W072PIÑp	rtQÐUp
 VÎO+)O,JUpI-ÎLÏQÉE™%™ùyš!Y\º�ºP†& A=#°€	PCIbfNj
-260 0 obj
+Ô�¼kW ~ö&;endstream
 endobj
 260 0 obj
 126
@@ -872,122 +868,122 @@ xref
 0000017515 00000 n 
 0000017564 00000 n 
 0000017613 00000 n 
-0000017760 00000 n 
-0000017809 00000 n 
-0000017858 00000 n 
-0000017907 00000 n 
-0000017956 00000 n 
-0000018005 00000 n 
-0000018054 00000 n 
-0000018103 00000 n 
-0000018152 00000 n 
-0000018201 00000 n 
-0000018250 00000 n 
-0000018299 00000 n 
-0000018348 00000 n 
-0000018397 00000 n 
-0000018446 00000 n 
-0000018495 00000 n 
-0000018544 00000 n 
-0000018593 00000 n 
-0000018642 00000 n 
-0000018691 00000 n 
-0000018740 00000 n 
-0000018789 00000 n 
-0000018838 00000 n 
-0000018887 00000 n 
-0000018936 00000 n 
-0000018985 00000 n 
-0000019034 00000 n 
-0000019083 00000 n 
-0000019132 00000 n 
-0000019181 00000 n 
-0000019230 00000 n 
-0000019279 00000 n 
-0000019328 00000 n 
-0000019377 00000 n 
-0000019426 00000 n 
-0000019475 00000 n 
-0000019524 00000 n 
-0000019573 00000 n 
-0000019622 00000 n 
-0000019671 00000 n 
-0000019720 00000 n 
-0000019769 00000 n 
-0000019818 00000 n 
-0000019867 00000 n 
-0000019916 00000 n 
-0000019965 00000 n 
-0000020014 00000 n 
-0000020063 00000 n 
-0000020112 00000 n 
-0000020341 00000 n 
-0000020493 00000 n 
-0000026875 00000 n 
-0000026897 00000 n 
-0000027010 00000 n 
-0000027112 00000 n 
-0000027132 00000 n 
-0000027273 00000 n 
-0000028082 00000 n 
-0000028103 00000 n 
-0000028216 00000 n 
-0000028408 00000 n 
-0000028429 00000 n 
-0000028570 00000 n 
-0000029163 00000 n 
-0000029184 00000 n 
-0000029297 00000 n 
-0000029493 00000 n 
-0000029514 00000 n 
-0000029664 00000 n 
-0000030677 00000 n 
-0000030698 00000 n 
-0000030857 00000 n 
-0000032012 00000 n 
-0000032034 00000 n 
-0000032165 00000 n 
-0000033044 00000 n 
-0000033065 00000 n 
-0000033206 00000 n 
-0000034316 00000 n 
-0000034338 00000 n 
-0000034469 00000 n 
-0000035451 00000 n 
-0000035472 00000 n 
-0000035612 00000 n 
-0000036603 00000 n 
-0000036624 00000 n 
-0000036755 00000 n 
-0000037427 00000 n 
-0000037448 00000 n 
-0000037561 00000 n 
-0000037758 00000 n 
-0000037779 00000 n 
-0000037901 00000 n 
-0000038066 00000 n 
-0000038086 00000 n 
-0000038199 00000 n 
-0000038396 00000 n 
-0000038417 00000 n 
-0000038557 00000 n 
-0000039053 00000 n 
-0000039074 00000 n 
-0000039205 00000 n 
-0000039656 00000 n 
-0000039677 00000 n 
-0000039832 00000 n 
-0000042073 00000 n 
-0000042095 00000 n 
-0000042250 00000 n 
-0000043158 00000 n 
-0000043179 00000 n 
-0000043234 00000 n 
-0000043339 00000 n 
-0000043483 00000 n 
-0000043589 00000 n 
+0000017662 00000 n 
+0000017711 00000 n 
+0000017760 00000 n 
+0000017809 00000 n 
+0000017858 00000 n 
+0000017907 00000 n 
+0000017956 00000 n 
+0000018005 00000 n 
+0000018054 00000 n 
+0000018103 00000 n 
+0000018152 00000 n 
+0000018201 00000 n 
+0000018250 00000 n 
+0000018299 00000 n 
+0000018348 00000 n 
+0000018397 00000 n 
+0000018446 00000 n 
+0000018495 00000 n 
+0000018544 00000 n 
+0000018593 00000 n 
+0000018642 00000 n 
+0000018691 00000 n 
+0000018740 00000 n 
+0000018789 00000 n 
+0000018838 00000 n 
+0000018887 00000 n 
+0000018936 00000 n 
+0000018985 00000 n 
+0000019034 00000 n 
+0000019083 00000 n 
+0000019132 00000 n 
+0000019181 00000 n 
+0000019230 00000 n 
+0000019279 00000 n 
+0000019328 00000 n 
+0000019377 00000 n 
+0000019426 00000 n 
+0000019475 00000 n 
+0000019524 00000 n 
+0000019573 00000 n 
+0000019622 00000 n 
+0000019671 00000 n 
+0000019720 00000 n 
+0000019769 00000 n 
+0000019818 00000 n 
+0000019867 00000 n 
+0000019916 00000 n 
+0000019965 00000 n 
+0000020014 00000 n 
+0000020063 00000 n 
+0000020112 00000 n 
+0000020341 00000 n 
+0000020493 00000 n 
+0000026875 00000 n 
+0000026897 00000 n 
+0000027010 00000 n 
+0000027112 00000 n 
+0000027132 00000 n 
+0000027273 00000 n 
+0000028169 00000 n 
+0000028190 00000 n 
+0000028303 00000 n 
+0000028495 00000 n 
+0000028516 00000 n 
+0000028657 00000 n 
+0000029250 00000 n 
+0000029271 00000 n 
+0000029384 00000 n 
+0000029580 00000 n 
+0000029601 00000 n 
+0000029751 00000 n 
+0000030764 00000 n 
+0000030785 00000 n 
+0000030944 00000 n 
+0000032099 00000 n 
+0000032121 00000 n 
+0000032252 00000 n 
+0000033131 00000 n 
+0000033152 00000 n 
+0000033293 00000 n 
+0000034403 00000 n 
+0000034425 00000 n 
+0000034556 00000 n 
+0000035538 00000 n 
+0000035559 00000 n 
+0000035699 00000 n 
+0000036690 00000 n 
+0000036711 00000 n 
+0000036842 00000 n 
+0000037514 00000 n 
+0000037535 00000 n 
+0000037648 00000 n 
+0000037845 00000 n 
+0000037866 00000 n 
+0000037988 00000 n 
+0000038153 00000 n 
+0000038173 00000 n 
+0000038286 00000 n 
+0000038483 00000 n 
+0000038504 00000 n 
+0000038644 00000 n 
+0000039140 00000 n 
+0000039161 00000 n 
+0000039292 00000 n 
+0000039743 00000 n 
+0000039764 00000 n 
+0000039919 00000 n 
+0000042160 00000 n 
+0000042182 00000 n 
+0000042337 00000 n 
+0000043245 00000 n 
+0000043266 00000 n 
+0000043321 00000 n 
+0000043426 00000 n 
 0000043570 00000 n 
 0000043676 00000 n 
 0000043796 00000 n 
-0000044077 00000 n 
+0000043905 00000 n 
 0000044054 00000 n 
@@ -31,6 +31,10 @@ supported with reduced functionality.
 Description (&quot;PPD&quot;)-based printing options to support real
 world applications under UNIX.

+<P>CUPS also includes a customized version of GNU GhostScript
+(currently based off GNU GhostScript 4.03) and an image file RIP that
+can be used to support non-PostScript printers.
+
 <H2>Document Overview</H2>

 This software design description document is organized into the 
@@ -60,6 +60,9 @@ with reduced functionality. </P>
 <P>CUPS adds network printer browsing and PostScript Printer 
 Description (&quot;PPD&quot;)-based printing options to support real world 
 applications under UNIX. </P>
+<P>CUPS also includes a customized version of GNU GhostScript 
+(currently based off GNU GhostScript 4.03) and an image file RIP that 
+can be used to support non-PostScript printers. </P>
 <H2><A NAME=1_3>1.3 Document Overview</A></H2>
 <P>This software security report is organized into the following 
 sections:</P>
@@ -1,6 +1,6 @@
 %PDF-1.2
 %âãÏÓ
-1 0 obj<</Producer(htmldoc 2.0b1 Copyright 1997-1999 Michael Sweet, All Rights Reserved.)/CreationDate(D:19990513142508Z)/Title(DRAFT - CUPS Software Security Report)/Author(Easy Software Products)>>endobj
+1 0 obj<</Producer(htmldoc 2.0b1 Copyright 1997-1999 Michael Sweet, All Rights Reserved.)/CreationDate(D:19990521210323Z)/Title(DRAFT - CUPS Software Security Report)/Author(Easy Software Products)>>endobj
 2 0 obj<</Type/Encoding/BaseEncoding/WinAnsiEncoding>>endobj
 3 0 obj<</Type/Font/Subtype/Type1/BaseFont/Times-Roman/Encoding 2 0 R>>endobj
 4 0 obj<</Type/Font/Subtype/Type1/BaseFont/Times-Bold/Encoding 2 0 R>>endobj
@@ -15,9 +15,9 @@
 13 0 obj<</Subtype/Link/Rect[108.0 646.8 124.5 659.8]/Border[0 0 0]/Dest[82 0 R/XYZ null 658 0]>>endobj
 14 0 obj<</Subtype/Link/Rect[124.5 646.8 159.6 659.8]/Border[0 0 0]/Dest[82 0 R/XYZ null 658 0]>>endobj
 15 0 obj<</Subtype/Link/Rect[159.6 646.8 203.0 659.8]/Border[0 0 0]/Dest[82 0 R/XYZ null 658 0]>>endobj
-16 0 obj<</Subtype/Link/Rect[108.0 633.6 124.5 646.6]/Border[0 0 0]/Dest[82 0 R/XYZ null 474 0]>>endobj
-17 0 obj<</Subtype/Link/Rect[124.5 633.6 173.1 646.6]/Border[0 0 0]/Dest[82 0 R/XYZ null 474 0]>>endobj
-18 0 obj<</Subtype/Link/Rect[173.1 633.6 216.4 646.6]/Border[0 0 0]/Dest[82 0 R/XYZ null 474 0]>>endobj
+16 0 obj<</Subtype/Link/Rect[108.0 633.6 124.5 646.6]/Border[0 0 0]/Dest[82 0 R/XYZ null 434 0]>>endobj
+17 0 obj<</Subtype/Link/Rect[124.5 633.6 173.1 646.6]/Border[0 0 0]/Dest[82 0 R/XYZ null 434 0]>>endobj
+18 0 obj<</Subtype/Link/Rect[173.1 633.6 216.4 646.6]/Border[0 0 0]/Dest[82 0 R/XYZ null 434 0]>>endobj
 19 0 obj<</Subtype/Link/Rect[72.0 607.2 80.2 620.2]/Border[0 0 0]/Dest[88 0 R/XYZ null 818 0]>>endobj
 20 0 obj<</Subtype/Link/Rect[80.2 607.2 131.6 620.2]/Border[0 0 0]/Dest[88 0 R/XYZ null 818 0]>>endobj
 21 0 obj<</Subtype/Link/Rect[108.0 594.0 124.5 607.0]/Border[0 0 0]/Dest[88 0 R/XYZ null 737 0]>>endobj
@@ -107,7 +107,7 @@
 59 0 obj<</D[82 0 R/XYZ null 818 null]>>endobj
 60 0 obj<</D[82 0 R/XYZ null 737 null]>>endobj
 61 0 obj<</D[82 0 R/XYZ null 658 null]>>endobj
-62 0 obj<</D[82 0 R/XYZ null 474 null]>>endobj
+62 0 obj<</D[82 0 R/XYZ null 434 null]>>endobj
 63 0 obj<</D[88 0 R/XYZ null 818 null]>>endobj
 64 0 obj<</D[88 0 R/XYZ null 737 null]>>endobj
 65 0 obj<</D[88 0 R/XYZ null 540 null]>>endobj
@@ -183,13 +183,14 @@ endobj
 œd™‘½¬	6°‹ÉsXC>°rHz�€5EVFÔ
 œåöÐ1‡ Ïàl�sdÞ$Tê×Œ	ÌÇ3 ÔKÎcîç$ÆÇÜi:Ü€±¦;peu°ÃõfŽàB*ý@±ž1ð?j˜c†	ÀŸ©ÃXÄë€í‡°”éL�/AƒÈ)Qà¸ÖX°•Ã5CreŽ˜Œ¸A8F†Xû©¥qB
 Õ*
-3Cìuá,ùV…™!öªõØ§»@sá
-±GéÈl
-SCô“‘5^)^`&°}Zâ'�o†Z.é�m‰¹‘tAalˆ=i¢0ò¡`<i{òÎh+TïŒ�ñ¬íÇ;ç†ÖÆ¾¾—)&#CÙOÌþŠemúHÁÂÄµïÅî	_\P¹RÒ€ÙÔŠf…d.é�&#ó	vŒÜ&˜¾,™ƒÅ€Š4¯.Ú7lË7KaK¨vJVa®Š7vLl¬W-‚Ñ°ôñXÙ_(¹“Í�Xz©[QÚ	ìõ@JØ~µÉT=ÈX-·ÑÀžç?[ÏóˆúE!›«ˆ8`õ_:G•[ú×lø\)‹Ëóï¨ƒÅ°ø¶8 ‹‹9`žw™ô<Xík£N®Øãü�Î?Ö4.L¸¤Ç/—(kÌ¯xŸ¾2â2°Ý<»î2Ç&UÇò¡›ËdÀh�úÏ¾�ØŸ»0ä¢.Ã”yýØ7ù°ŒLWaÊ•{vÊÅår¹|ý¸-ËåUdøic.f½tå?b¸¤ƒ\\f’8Êpá¸Ü°•.ç¬{ëÇ%§6\H.Â©Í±¡‡ä*"—¸6ö¸²i
-š‹µÓÑ“Æ'6¹rg¸…M.g´w¼�ç’ÑT4žÆÅÝÂA4h\NHö¼—Â%'c…4.,}tHâÝñY4®|"VHå9þ%`¹FµDJî•kLïL9~¢r�Ø“’æÈ\£M1ZÚ�k¤)FL,cp�3Åˆg»®Q¦5Ë€ÃEIC3Ø\ƒk=UŽÇ5°v02™\R¸+…&\CŠ"+u˜Ë5/“ŒÍÅHûÄqs
+3Cìuá,ùV…™!öªõØ§»@sá
+±GéÈl
+SCô“‘5^)^`&°}Zâ'�o†Z.é�m‰¹‘tAalˆ=i¢0ò¡`<i{òÎh+TïŒ�ñ¬íÇ;ç†ÖÆ¾¾—)&#CÙOÌþŠemúHÁÂÄµïÅî	_\P¹RÒ€ÙÔŠf…d.é�&#ó	vŒÜ&˜¾,™ƒÅ€Š4¯.Ú7lË7KaK¨vJVa®Š7vLl¬W-‚Ñ°ôñXÙ_(¹“Í�Xz©[QÚ	ìõ@JØ~µÉT=ÈX-·ÑÀžç?[ÏóˆúE!›«ˆ8`õ_:G•[ú×lø\)‹Ëóï¨ƒÅ°ø¶8 ‹‹9`žw™ô<Xík£N®Øãü�Î?Ö4.L¸¤Ç/—(kÌ¯xŸ¾2â2°Ý<»î2Ç&UÇò¡›ËdÀh�úÏ¾�ØŸ»0ä¢.Ã”yýØ7ù°ŒLWaÊ•{vÊÅår¹|ý¸-ËåUdøic.f½tå?b¸¤ƒ\\f’8Êpá¸Ü°•.ç¬{ëÇ%§6\H.Â©Í±¡‡ä*"—¸6ö¸²i
+š‹µÓÑ“Æ'6¹rg¸…M.g´w¼�ç’ÑT4žÆÅÝÂA4h\NHö¼—Â%'c…4.,}tHâÝñY4®|"VHå9þ%`¹FµDJî•kLïL9~¢r�Ø“’æÈ\£M1ZÚ�k¤)FL,cp�3Åˆg»®Q¦5Ë€ÃEIC3Ø\ƒk=UŽÇ5°v02™\R¸+…&\CŠ"+u˜Ë5/“ŒÍÅHûÄqs
+´cÞ80àÂ?ûÜ‹&\ý›"?KÓˆ«o0ƒäS3®~UÑ$YØ�«Om”mÊÕ˜Y2¾19‡º§…‰}®>–-†éêv¸ìË¢ù½	+\…´k‹×æ=²ÃµµE{Cl
 w¸
 yåÎ`Ùä²4d—›Â5®BÞËàk[}±ÉÅO>R]Ûë‰].ƒôjDêö˜\\2»T}pqÈ._ÛîC\Ä¼xÙÃ{.úáÚ–G\v¼y×Ë×÷Æµµƒ¼X>öõÝ}rí‡ívy¡§ëÇ>¿·o®ÃÀín8,¯.vår¹¼~|ìý+á¡@òÃ«ôÕ½|õîû�âæ£�›ïÞ~wë·wBþôO�Ù§ï¥x#
-yåÎ`Ùä²4d—›Â5®BÞËàk[}±ÉÅO>R]Ûë‰].ƒôjDêö˜\\2»T}pqÈ._ÛîC\Ä¼xÙÃ{.úáÚ–G\v¼y×Ë×÷Æµµƒ¼X>öõÝ}rí‡ívy¡§ëÇ>¿·o®ÃÀín8,¯.vår¹¼~|ìý+á¡@òÃ«ôÕ½|õîû�âæ£�›ïÞ~wë·wBþôO�Ù§ï¥x#
+ÈEþó¿þß¾|ùçýò§¯¿‰ìó_þòõŸåŸ·íïÄÍÍ®ýÍÝGñææýÛÛ]û]»7yž½¹y»ÞU{s³Ù~ú›Û‡�OþðËoç�…/?ÿôë�_ÙW¼{ÿöCés~þëo_þôßÿóuÛÉ�ß½ÙþßÇŸþò‘íþò—mG~ùüåïŸÚ5MäéÿiÁñ½endstream
 endobj
 78 0 obj
 6308
@@ -292,7 +293,7 @@ endobj
 106 0 obj<</Type/Page/Parent 75 0 R/Contents 107 0 R/Resources<</ProcSet[/PDF/Text]/Font<</F4 3 0 R/F6 5 0 R/F8 6 0 R/F9 7 0 R>>>>>>endobj
 107 0 obj<</Length 108 0 R/Filter/FlateDecode>>stream
 xÚ�T]o›0}çWÜÇíZÒ4…Ç%i¤ªc‚J}uÍ
-108 0 obj
+õâf;‹òïwZ©ÝŠ¥N „uçžã{ð¯$‡Kºr¸™ÁÕ¸J¾µÉÅº„¼„vG•ÅÍÚîË6Ò8Çìékûs\gÅI¯‹le9´h•1Èó€ Þt¶!ÕXšPZ7j8x´ ™î¬Çì=Qú>0Ë¤D9MØ î„îÁX°ÈQü‹ŽyÊXÿÌ4Ýà…Š7ÆÔ�é‘�‚uÐ‚3/ŒvÀ©�F	Oè�ˆüÑÀ`Mo™r±v`ÿåîžœá{ô1W$÷ìJ“|c÷î²¿S‘RžÒ«ò53Xrkô)�eSm·)Š6„ÓÈÏtÇl•évä«é©ÎŠè�Tõñ]=ÔÍt«Š<ÕÃýöj+´[ÛœœGá\5ÕE=Mºª›ï÷ˆ?7@ë"Ìë6Â»¡µL»6ã
 72Âv[§›»i¾[<Jô>ß¡Ë†gÁÜ½ü”ã§Å+uô¼ 	ÿsJÌ‹Ë¬¤ó�
 eX¯ÚäGò�E8%endstream
 endobj
@@ -392,61 +393,61 @@ xref
 0000003840 00000 n 
 0000003944 00000 n 
 0000004049 00000 n 
-0000004574 00000 n 
-0000004679 00000 n 
-0000004784 00000 n 
-0000004889 00000 n 
-0000004992 00000 n 
-0000005096 00000 n 
-0000005201 00000 n 
-0000005306 00000 n 
-0000005411 00000 n 
-0000005516 00000 n 
-0000005854 00000 n 
-0000005886 00000 n 
-0000005918 00000 n 
-0000006128 00000 n 
-0000006175 00000 n 
-0000006222 00000 n 
-0000006269 00000 n 
-0000006316 00000 n 
-0000006363 00000 n 
-0000006410 00000 n 
-0000006457 00000 n 
-0000006504 00000 n 
-0000006551 00000 n 
-0000006598 00000 n 
-0000006646 00000 n 
-0000006694 00000 n 
-0000006742 00000 n 
-0000006790 00000 n 
-0000006838 00000 n 
-0000006886 00000 n 
-0000007058 00000 n 
-0000007207 00000 n 
-0000013584 00000 n 
-0000013605 00000 n 
-0000013715 00000 n 
-0000013815 00000 n 
-0000013834 00000 n 
-0000013971 00000 n 
-0000014774 00000 n 
-0000014794 00000 n 
-0000014904 00000 n 
-0000015091 00000 n 
-0000015111 00000 n 
-0000015248 00000 n 
-0000015839 00000 n 
-0000015859 00000 n 
-0000015969 00000 n 
-0000016159 00000 n 
-0000016179 00000 n 
-0000016298 00000 n 
-0000016513 00000 n 
-0000016533 00000 n 
-0000016643 00000 n 
+0000004154 00000 n 
+0000004259 00000 n 
+0000004364 00000 n 
+0000004469 00000 n 
+0000004574 00000 n 
+0000004679 00000 n 
+0000004784 00000 n 
+0000004889 00000 n 
+0000004992 00000 n 
+0000005096 00000 n 
+0000005201 00000 n 
+0000005306 00000 n 
+0000005411 00000 n 
+0000005516 00000 n 
+0000005854 00000 n 
+0000005886 00000 n 
+0000005918 00000 n 
+0000006128 00000 n 
+0000006175 00000 n 
+0000006222 00000 n 
+0000006269 00000 n 
+0000006316 00000 n 
+0000006363 00000 n 
+0000006410 00000 n 
+0000006457 00000 n 
+0000006504 00000 n 
+0000006551 00000 n 
+0000006598 00000 n 
+0000006646 00000 n 
+0000006694 00000 n 
+0000006742 00000 n 
+0000006790 00000 n 
+0000006838 00000 n 
+0000006886 00000 n 
+0000007058 00000 n 
+0000007207 00000 n 
+0000013584 00000 n 
+0000013605 00000 n 
+0000013715 00000 n 
+0000013815 00000 n 
+0000013834 00000 n 
+0000013971 00000 n 
+0000014864 00000 n 
+0000014884 00000 n 
+0000014994 00000 n 
+0000015181 00000 n 
+0000015201 00000 n 
+0000015338 00000 n 
+0000015929 00000 n 
+0000015949 00000 n 
+0000016059 00000 n 
+0000016249 00000 n 
+0000016269 00000 n 
 0000016388 00000 n 
 0000016603 00000 n 
 0000016623 00000 n 
-0000017194 00000 n 
+0000016733 00000 n 
 0000016932 00000 n 
@@ -30,6 +30,10 @@ supported with reduced functionality.
 Description (&quot;PPD&quot;)-based printing options to support real
 world applications under UNIX.

+<P>CUPS also includes a customized version of GNU GhostScript
+(currently based off GNU GhostScript 4.03) and an image file RIP that
+can be used to support non-PostScript printers.
+
 <H2>Document Overview</H2>

 <P>This software security report is organized into the following sections:</P>
@@ -54,6 +54,9 @@ with reduced functionality. </P>
 <P>CUPS adds network printer browsing and PostScript Printer 
 Description (&quot;PPD&quot;)-based printing options to support real world 
 applications under UNIX. </P>
+<P>CUPS also includes a customized version of GNU GhostScript 
+(currently based off GNU GhostScript 4.03) and an image file RIP that 
+can be used to support non-PostScript printers. </P>
 <H2><A NAME=1_3>1.3 Document Overview</A></H2>
 This software test plan is organized into the following sections: 
 <UL>
@@ -31,6 +31,10 @@ supported with reduced functionality.
 Description (&quot;PPD&quot;)-based printing options to support real
 world applications under UNIX.

+<P>CUPS also includes a customized version of GNU GhostScript
+(currently based off GNU GhostScript 4.03) and an image file RIP that
+can be used to support non-PostScript printers.
+
 <H2>Document Overview</H2>

 This software test plan is organized into the following sections:
@@ -15,40 +15,457 @@ Copyright 1997-1999, All Rights Reserved<BR>
 <HR>
 <H1 ALIGN=CENTER><A NAME=CONTENTS>Table of Contents</A></H1>
 <BR>
-<BR><B><A HREF=#1>1 Scope</A></B>
+<BR><B><A HREF=#1>Preface</A></B>
 <UL>
-<LI><A HREF=#1_1>1.1 Identification</A></LI>
-<LI><A HREF=#1_2>1.2 Document Overview</A></LI>
+<LI><A HREF=#1_1>System Overview</A></LI>
+<LI><A HREF=#1_2>Document Overview</A></LI>
 </UL>
-<B><A HREF=#2>2 Printing System Overview</A></B>
-<BR>
-<BR><B><A HREF=#3>3 Using the Printing System</A></B>
+<B><A HREF=#2>1 - Printing System Overview</A></B>
 <UL>
-<LI><A HREF=#3_1>3.1 Choosing a Printer</A></LI>
-<LI><A HREF=#3_2>3.2 Setting Printer Options</A></LI>
-<LI><A HREF=#3_3>3.3 Submitting Files for Printing</A></LI>
-<LI><A HREF=#3_4>3.4 Checking the Printer Status</A></LI>
+<LI><A HREF=#2_1>The Printing Problem</A></LI>
+<LI><A HREF=#2_2>The Technology</A></LI>
+<LI><A HREF=#2_3>Filters</A></LI>
+<LI><A HREF=#2_4>Printer Drivers</A></LI>
+</UL>
+<B><A HREF=#3>2 - Using the Printing System</A></B>
+<UL>
+<LI><A HREF=#3_1>Submitting Files for Printing</A></LI>
+<LI><A HREF=#3_2>Choosing a Printer</A></LI>
+<LI><A HREF=#3_3>Setting Printer Options</A></LI>
+<LI><A HREF=#3_4>Printing Multiple Copies</A></LI>
+<LI><A HREF=#3_5>Checking the Printer Status from the Command-Line</A></LI>
+<LI><A HREF=#3_6>Checking the Printer Status from the Web</A></LI>
+<LI><A HREF=#3_7>Canceling a Print Job</A></LI>
+</UL>
+<B><A HREF=#4>3 - Standard Printer Options</A></B>
+<UL>
+<LI><A HREF=#4_1>General Options</A></LI>
+<UL>
+<LI><A HREF=#4_1_1>Selecting the Media Size</A></LI>
+<LI><A HREF=#4_1_2>Setting the Orientation</A></LI>
+<LI><A HREF=#4_1_3>Printing On Both Sides of the Paper</A></LI>
+<LI><A HREF=#4_1_4>Selecting a Range of Pages</A></LI>
+<LI><A HREF=#4_1_5>Setting the Brightness</A></LI>
+<LI><A HREF=#4_1_6>Setting the Gamma Correction</A></LI>
+</UL>
+<LI><A HREF=#4_2>Text Options</A></LI>
+<UL>
+<LI><A HREF=#4_2_1>Setting the Number of Characters Per Inch</A></LI>
+<LI><A HREF=#4_2_2>Setting the Number of Lines Per Inch</A></LI>
+<LI><A HREF=#4_2_3>Setting the Number of Columns</A></LI>
+<LI><A HREF=#4_2_4>Setting the Page Margins</A></LI>
+<LI><A HREF=#4_2_5>Pretty Printing</A></LI>
+</UL>
+<LI><A HREF=#4_3>Image Options</A></LI>
+<UL>
+<LI><A HREF=#4_3_1>Scaling the Image</A></LI>
+<LI><A HREF=#4_3_2>Adjusting the Hue (Tint) of an Image</A></LI>
+<LI><A HREF=#4_3_3>Adjusting the Saturation (Color) of an Image</A></LI>
+</UL>
 </UL>
 <HR>
-<H1><A NAME=1>1 Scope</A></H1>
-<H2><A NAME=1_1>1.1 Identification</A></H2>
+<H1 ALIGN=RIGHT><A NAME=1>Preface</A></H1>
 This software users manual describes how to use the Common UNIX 
 Printing System (&quot;CUPS&quot;) Version 1.0.0. 
-<H2><A NAME=1_2>1.2 Document Overview</A></H2>
+<H2><A NAME=1_1>System Overview</A></H2>
+ The Common UNIX Printing System provides a portable printing layer for 
+ UNIX&reg; operating systems. It has been developed by Easy Software 
+ Products to promote a standard printing solution for all UNIX vendors 
+ and users. CUPS provides the System V and Berkeley command-line 
+interfaces. 
+<P>CUPS uses the Internet Printing Protocol (IETF-IPP) as the basis for 
+managing print jobs and queues. The Line Printer Daemon (LPD, RFC1179), 
+Server Message Block (SMB), and AppSocket protocols are also supported 
+with reduced functionality. </P>
+<P>CUPS adds network printer browsing and PostScript Printer 
+Description (&quot;PPD&quot;)-based printing options to support real world 
+applications under UNIX. </P>
+<P>CUPS also includes a customized version of GNU GhostScript 
+(currently based off GNU GhostScript 4.03) and an image file RIP that 
+can be used to support non-PostScript printers. </P>
+<H2><A NAME=1_2>Document Overview</A></H2>
 <P>This software users manual is organized into the following sections:</P>
 <UL>
-<LI>1 - Scope</LI>
-<LI>2 - References</LI>
-<LI>3 - Printing System Overview</LI>
-<LI>4 - Using the Printing System</LI>
-<LI>A - Glossary</LI>
+<LI>1 - Printing System Overview</LI>
+<LI>2 - Using the Printing System</LI>
+<LI>3 - Standard Printer Options</LI>
+<LI>4 - Checking the Status Via the Web</LI>
 </UL>
-<H1><A NAME=2>2 Printing System Overview</A></H1>
-<P>
-<H1><A NAME=3>3 Using the Printing System</A></H1>
-<H2><A NAME=3_1>3.1 Choosing a Printer</A></H2>
-<H2><A NAME=3_2>3.2 Setting Printer Options</A></H2>
-<H2><A NAME=3_3>3.3 Submitting Files for Printing</A></H2>
-<H2><A NAME=3_4>3.4 Checking the Printer Status</A></H2>
+<H1 ALIGN=RIGHT><A NAME=2>1 - Printing System Overview</A></H1>
+<P>This chapter provides an overview of how the Common UNIX Printing 
+System works. </P>
+<H2><A NAME=2_1>The Printing Problem</A></H2>
+<P>For years <I>the printing problem</I> has plagued UNIX&reg;. Unlike 
+Microsoft&reg; Windows&reg; or MacOS, UNIX has no standard interface or system 
+in place for supporting printers. Among the solutions previously 
+available, the Berkeley and System V printing systems are the most 
+prevalent. </P>
+<P>These printing systems support line printers (text only) or 
+PostScript printers (text and graphics), and with some coaxing they can 
+be made to support a full range of printers and file formats. However, 
+because each varient of the UNIX operating system uses a different 
+printing system than the next, developing printer drivers for a wide 
+range of printers is extremely difficult. That combined with the 
+limited volume of customers for each UNIX varient has forced most 
+printer vendors to give up supporting UNIX entirely. </P>
+<P>The Common UNIX Printing System, or CUPS, is designed to eliminate <I>
+the printing problem</I>. One common printing system can be used by all 
+UNIX varients to support the printing needs of users. Printer vendors 
+can use its modular filter interface to develop a single driver program 
+that supports a wide range of file formats with little or no effort. 
+ Since CUPS provides both the System V and Berkeley printing commands, 
+users (and applications) can reap the benefits of this new technology 
+with no changes. </P>
+<H2><A NAME=2_2>The Technology</A></H2>
+<P>CUPS is based upon an emerging Internet standard called the Internet 
+Printing Protocol, or IPP. IPP has been embraced by dozens of printer 
+and printer server manufacturers, and will be supported by the next 
+Microsoft Windows operating system. </P>
+<P>IPP defines a standard protocol for printing as well as managing 
+print jobs and printer options like media size, resolution, and so 
+forth. Like all IP-based protocols, IPP can be used locally or over the 
+Internet to printers hundreds or thousands of miles away. Unlike other 
+protocols, however, IPP also supports access control, authentication, 
+and encryption, making it a much more secure printing solution than 
+older ones. </P>
+<P>IPP is layered on top of the Hyper-Text Transport Protocol, or HTTP, 
+which is the basis of web servers on the Internet. This allows the user 
+to view documentation and status information on a printer or server 
+using their web browser. </P>
+<P>CUPS provides a complete IPP/1.0-based printing system that provides 
+Basic authentication and domain or IP-based access control. Digest 
+authentication and TLS encryption will be available in future versions 
+of CUPS. </P>
+<H2><A NAME=2_3>Filters</A></H2>
+<P>Filters allow a user or application to print many types of files 
+without extra effort. Print jobs sent to a CUPS server are filtered 
+before sending them to a printer. Some filters convert job files to 
+different formats that the printer can understand. Others perform page 
+selection and ordering tasks. <I>Backend</I> filters perform the most 
+important task of all - they send the filtered print data to the 
+printer. </P>
+<P>CUPS provides filters for printing many types of image files, 
+HP-GL/2 files, PDF files, and text files. CUPS also supplies PostScript 
+and image file Raster Image Processors, or RIPs, that convert 
+PostScript or image files into bitmaps that can be sent to a raster 
+printer. </P>
+<P>CUPS provides backends for printing over parallel and serial ports, 
+and over the network via the JetDirect (AppSocket), Server Message 
+Block, and Line Printer Daemon protocols. </P>
+<H2><A NAME=2_4>Printer Drivers</A></H2>
+<P>Printer drivers in CUPS consist of one of more filters specific to a 
+printer. CUPS includes a sample printer driver for Hewlett-Packard 
+LaserJet and DeskJet printers. While this driver does not generate 
+optimal output for different printer models, it does demonstrate how 
+you can write your own printer drivers and incorporate them into CUPS. </P>
+<H1 ALIGN=RIGHT><A NAME=3>2 - Using the Printing System</A></H1>
+<P>This chapter shows you how to submit, query, and cancel print jobs 
+to different printers. </P>
+<H2><A NAME=3_1>Submitting Files for Printing</A></H2>
+<P>CUPS provides both the System V (<CODE>lp</CODE>) and Berkeley (<CODE>
+lpr</CODE>) printing commands. To print a file to the default printer 
+on the system (or your only printer if you have only one) you just need 
+to type: </P>
+<UL>
+<PRE>
+% lp filename ENTER
+</PRE>
+</UL>
+<P>or: </P>
+<UL>
+<PRE>
+% lpr filename ENTER
+</PRE>
+</UL>
+<P>CUPS understands many different types of files directly, including 
+PostScript and image files. This allows you to print from inside your 
+applications or at the command-line, whichever is most convenient! </P>
+<H2><A NAME=3_2>Choosing a Printer</A></H2>
+<P>Many systems will have more than one printer available to the user. 
+These printers can be attached to the local system via a parallel or 
+serial port, or available over the network. </P>
+<P>To see a list of available printers, use the <CODE>lpstat</CODE>
+ command: </P>
+<UL>
+<PRE>
+% lpstat -p -d ENTER
+</PRE>
+</UL>
+<P>The &quot;-p&quot; option specifies that you want to see a list of printers, 
+and the &quot;-d&quot; option reports the current system default printer or 
+class. </P>
+<P>To print to a specific printer, use the &quot;-d&quot; option to the <CODE>lp</CODE>
+ command: </P>
+<UL>
+<PRE>
+% lp -d printer filename ENTER
+</PRE>
+</UL>
+<P>or the &quot;-P&quot; option to the <CODE>lpr</CODE> command: </P>
+<UL>
+<PRE>
+% lpr -P printer filename ENTER
+</PRE>
+</UL>
+<H2><A NAME=3_3>Setting Printer Options</A></H2>
+<P>For many types of files, the default printer options may be 
+sufficient for your needs. However, there may be times when you need to 
+change the options for a particular file you are printing. </P>
+<P>The <CODE>lp</CODE> command allows you to pass printer options using 
+the &quot;-o&quot; option: </P>
+<UL>
+<PRE>
+% lp -o landscape -o scaling=75 -o media=A4 filename.jpg
+</PRE>
+</UL>
+<P>The <CODE>lpr</CODE> command has no command-line option for printer 
+options. </P>
+<P>The available printer options vary depending on the printer. The 
+standard options are described in <A HREF=#4>Chapter 3</A>. </P>
+<H2><A NAME=3_4>Printing Multiple Copies</A></H2>
+<P>Both the <CODE>lp</CODE> and <CODE>lpr</CODE> commands have options 
+for printing more than one copy of a file: </P>
+<UL>
+<PRE>
+% lp -n num-copies filename ENTER
+% lpr -#num-copies filename ENTER
+</PRE>
+</UL>
+<P>Copies are normally <I>not</I> collated for you. To get collated 
+copies use the <CODE>lp</CODE> command with the &quot;-o Collate=True&quot; 
+option: </P>
+<UL>
+<PRE>
+% lp -n num-copies -o Collate=True filename ENTER
+</PRE>
+</UL>
+<H2><A NAME=3_5>Checking the Printer Status from the Command-Line</A></H2>
+<P>The <CODE>lpstat</CODE> command can be used to check for jobs that 
+you have submitted for printing: </P>
+<UL>
+<PRE>
+% lpstat ENTER
+Printer-1 johndoe 4427776
+Printer-2 johndoe 15786
+Printer-3 johndoe 372842
+</PRE>
+</UL>
+<P>The jobs are listed in the order they will be printed. To see which 
+files and printers are active, use the &quot;-p&quot; option: </P>
+<UL>
+<PRE>
+% lpstat -p ENTER
+printer DeskJet now printing DeskJet-1.
+</PRE>
+</UL>
+<P>Or to show the jobs and the printers, use the &quot;-o&quot; and &quot;-p&quot; options: </P>
+<UL>
+<PRE>
+% lpstat -o -p ENTER
+Printer-1 johndoe 4427776
+Printer-2 johndoe 15786
+Printer-3 johndoe 372842
+printer DeskJet now printing DeskJet-1.
+</PRE>
+</UL>
+<H2><A NAME=3_6>Checking the Printer Status from the Web</A></H2>
+<P>Since CUPS uses the Internet Printing Protocol, it is also a 
+full-featured web server. To use your web browser to monitor the 
+printers on your system, open the URL &quot;<A HREF=http://localhost:631>
+http://localhost:631</A>&quot;. From there you can view the status of 
+classes, jobs, and printers with the click of a button! </P>
+<H2><A NAME=3_7>Canceling a Print Job</A></H2>
+<P>The <CODE>cancel</CODE> command cancels a print job: </P>
+<UL>
+<PRE>
+% cancel job-id ENTER
+</PRE>
+</UL>
+<P>The <I>job-id</I> is a number that was reported to you by the <CODE>
+lp</CODE> or <CODE>lpstat</CODE> commands. </P>
+<H1 ALIGN=RIGHT><A NAME=4>3 - Standard Printer Options</A></H1>
+<P>This chapter describes the standard printer options that are 
+available when printing with the <CODE>lp</CODE> command. </P>
+<H2><A NAME=4_1>General Options</A></H2>
+<P>The following options apply when printing all types of files. </P>
+<H3><A NAME=4_1_1>Selecting the Media Size</A></H3>
+<P>The &quot;-o media=size&quot; option sets the media size: </P>
+<UL>
+<PRE>
+% lp -o media=Letter filename ENTER
+</PRE>
+</UL>
+<P>The available media sizes depend on the printer, but most support at 
+least the following sizes (case is significant): </P>
+<UL>
+<LI><CODE>Letter</CODE> - US Letter (8.5x11 inches, or 216x279mm) </LI>
+<LI><CODE>Legal</CODE> - US Legal (8.5x14 inches, or 216x356mm) </LI>
+<LI><CODE>A4</CODE> - ISO A4 (8.27x11.69 inches, or 210x297mm) </LI>
+<LI><CODE>COM10</CODE> - US #10 Envelope (9.5x4.125 inches, or 
+ 241x105mm) </LI>
+<LI><CODE>DL</CODE> - ISO DL Envelope (8.66x4.33 inches, or 220x110mm) </LI>
+</UL>
+<H3><A NAME=4_1_2>Setting the Orientation</A></H3>
+<P>The &quot;-o landscape&quot; option will rotate the page 90 degrees to print 
+in landscape orientation: </P>
+<UL>
+<PRE>
+% lp -o landscape filename ENTER
+</PRE>
+</UL>
+<H3><A NAME=4_1_3>Printing On Both Sides of the Paper</A></H3>
+<P>The &quot;-o sides=two-sided-short&quot; and &quot;-o sides=two-sided-long&quot; options 
+will enable duplexing on the printer (if the printer supports it.) The 
+&quot;two-sided-short&quot; option is suitable for landscape pages, while the 
+&quot;two-sided-long&quot; option is suitable for portrait pages: </P>
+<UL>
+<PRE>
+% lp -o sides=two-sided-short filename ENTER
+% lp -o sides=two-sided-long filename ENTER
+</PRE>
+</UL>
+<H3><A NAME=4_1_4>Selecting a Range of Pages</A></H3>
+<P>The &quot;-o page-range=pages&quot; option selects a range of pages for 
+printing: </P>
+<UL>
+<PRE>
+% lp -o page-range=1 filename ENTER
+% lp -o page-range=1-4 filename ENTER
+% lp -o page-range=1-4,7,9-12 filename ENTER
+</PRE>
+</UL>
+<P>As shown above, the <I>pages</I> value can be a single page, a range 
+of pages, or a collection of page numbers and ranges separated by 
+commas. The pages will always be printed in ascending order, regardless 
+of the order of the pages in the &quot;page-range&quot; option. </P>
+<P>To select the even or odd pages, use the &quot;-o page-set=set&quot; option: </P>
+<UL>
+<PRE>
+% lp -o page-set=odd filename ENTER
+% lp -o page-set=even filename ENTER
+</PRE>
+</UL>
+<H3><A NAME=4_1_5>Setting the Brightness</A></H3>
+<P>You can control the overall brightness of the printed output using 
+the &quot;-o brightness=percent&quot; option: </P>
+<UL>
+<PRE>
+% lp -o brightness=120 filename ENTER
+</PRE>
+</UL>
+<P>Values greater than 100 will lighten the print, while values less 
+than 100 will darken it. </P>
+<H3><A NAME=4_1_6>Setting the Gamma Correction</A></H3>
+<P>You can control the overall gamma correction of the printed output 
+using the &quot;-o gamma=value&quot; option: </P>
+<UL>
+<PRE>
+% lp -o gamma=1700 filename ENTER
+</PRE>
+</UL>
+<P>Values greater than 1000 will lighten the print, while values less 
+than 1000 will darken it. </P>
+<H2><A NAME=4_2>Text Options</A></H2>
+<P>The following options apply when printing text files. </P>
+<H3><A NAME=4_2_1>Setting the Number of Characters Per Inch</A></H3>
+<P>The &quot;-o cpi=value&quot; option sets the number of characters per inch: </P>
+<UL>
+<PRE>
+% lp -o cpi=12 filename ENTER
+</PRE>
+</UL>
+<H3><A NAME=4_2_2>Setting the Number of Lines Per Inch</A></H3>
+<P>The &quot;-o lpi=value&quot; option sets the number of lines per inch: </P>
+<UL>
+<PRE>
+% lp -o lpi=8 filename ENTER
+</PRE>
+</UL>
+<H3><A NAME=4_2_3>Setting the Number of Columns</A></H3>
+<P>The &quot;-o columns=value&quot; option sets the number of text columns: </P>
+<UL>
+<PRE>
+% lp -o columns=2 filename ENTER
+</PRE>
+</UL>
+<H3><A NAME=4_2_4>Setting the Page Margins</A></H3>
+<P>Normally the page margins are set to the hard limits of the printer. 
+To adjust the page margins use the &quot;-o page-left=value&quot;, &quot;-o 
+page-right=value&quot;, &quot;-o page-top=value&quot;, and &quot;-o page-bottom=value&quot; 
+options: </P>
+<UL>
+<PRE>
+% lp -o page-left=value filename ENTER
+% lp -o page-right=value filename ENTER
+% lp -o page-top=value filename ENTER
+% lp -o page-bottom=value filename ENTER
+</PRE>
+</UL>
+<P>The <I>value</I> argument is the margin in points; each point is 
+1/72 inch or 0.35mm. </P>
+<H3><A NAME=4_2_5>Pretty Printing</A></H3>
+<P>The &quot;-o prettyprint&quot; option puts a header at the top of each page 
+with the page number, job title (usually the filename), and the date. 
+Also, C and C++ keywords are highlighted, and comment lines are 
+italicized: </P>
+<UL>
+<PRE>
+% lp -o prettyprint filename ENTER
+</PRE>
+</UL>
+<H2><A NAME=4_3>Image Options</A></H2>
+<P>The following options apply when printing image files. </P>
+<H3><A NAME=4_3_1>Scaling the Image</A></H3>
+<P>The &quot;-o scaling=percent&quot; and &quot;-o ppi=value&quot; options change the size 
+of a printed image: </P>
+<UL>
+<PRE>
+% lp -o scaling=percent filename ENTER
+% lp -o ppi=value filename ENTER
+</PRE>
+</UL>
+<P>The scaling <I>percent</I> is a number from 1 to 800 specifying the 
+size in relation to the page (<I>not</I> the image.) A scaling of 100 
+percent will fill the page as completely as the image aspect ratio 
+allows. A scaling of 200 percent will print on up to 4 pages. </P>
+<P>The ppi <I>value</I> is a number from 1 to 1200 specifying the 
+resolution of the image in pixels per inch. An image that is 3000x2400 
+pixels will print 10x8 inches at 300 pixels per inch, for example. If 
+the specified resolution makes the image larger than the page, multiple 
+pages will be printed to satisfy the request. </P>
+<H3><A NAME=4_3_2>Adjusting the Hue (Tint) of an Image</A></H3>
+<P>The &quot;-o hue=value&quot; option will adjust the hue of the printed image, 
+much like the tint control on your television: </P>
+<UL>
+<PRE>
+% lp -o hue=value filename ENTER
+</PRE>
+</UL>
+<P>The <I>value</I> argument is a number from -360 to 360 and 
+represents the color hue rotation. The following table summarizes the 
+change you'll see with different colors: 
+<CENTER>
+<TABLE BORDER=1 WIDTH=50%>
+<TR><TH>Original</TH><TH>hue=-45</TH><TH>hue=45</TH></TR>
+<TR><TD>Red</TD><TD>Purple</TD><TD>Yellow-orange</TD></TR>
+<TR><TD>Green</TD><TD>Yellow-green</TD><TD>Blue-green</TD></TR>
+<TR><TD>Yellow</TD><TD>Orange</TD><TD>Green-yellow</TD></TR>
+<TR><TD>Blue</TD><TD>Sky-blue</TD><TD>Purple</TD></TR>
+<TR><TD>Magenta</TD><TD>Indigo</TD><TD>Crimson</TD></TR>
+<TR><TD>Cyan</TD><TD>Blue-green</TD><TD>Light-navy-blue</TD></TR>
+</TABLE>
+</CENTER>
+</P>
+<H3><A NAME=4_3_3>Adjusting the Saturation (Color) of an Image</A></H3>
+<P>The &quot;-o saturation=percent&quot; option adjusts the saturation of the 
+colors in an image, much like the color knob on your television: </P>
+<UL>
+<PRE>
+% lp -o saturation=percent filename ENTER
+</PRE>
+</UL>
+<P>The <I>percent</I> argument specifies the color saturation from 0 to 
+200. A color saturation of 0 produces a black-and-white print, while a 
+value of 200 will make the colors extremely intense. </P>
 </BODY>
 </HTML>
@@ -8,38 +8,507 @@
 </HEAD>
 <BODY>

-<H1>Scope</H1>
-
-<H2>Identification</H2>
+<H1 ALIGN=RIGHT>Preface</H1>

 This software users manual describes how to use the Common UNIX Printing
 System ("CUPS") Version 1.0.0.

+<H2>System Overview</H2>
+
+The Common UNIX Printing System provides a portable printing layer for 
+UNIX&reg; operating systems. It has been developed by Easy Software 
+Products to promote a standard printing solution for all UNIX vendors 
+and users. CUPS provides the System V and Berkeley command-line interfaces.
+
+<P>CUPS uses the Internet Printing Protocol (IETF-IPP) as the basis
+for managing print jobs and queues. The Line Printer Daemon (LPD,
+RFC1179), Server Message Block (SMB), and AppSocket protocols are also
+supported with reduced functionality.
+
+<P>CUPS adds network printer browsing and PostScript Printer
+Description (&quot;PPD&quot;)-based printing options to support real
+world applications under UNIX.
+
+<P>CUPS also includes a customized version of GNU GhostScript
+(currently based off GNU GhostScript 4.03) and an image file RIP that
+can be used to support non-PostScript printers.
+
 <H2>Document Overview</H2>

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

 <UL>
-	<LI>1 - Scope</LI>
-	<LI>2 - References</LI>
-	<LI>3 - Printing System Overview</LI>
-	<LI>4 - Using the Printing System</LI>
-	<LI>A - Glossary</LI>
+	<LI>1 - Printing System Overview</LI>
+	<LI>2 - Using the Printing System</LI>
+	<LI>3 - Standard Printer Options</LI>
+	<LI>4 - Checking the Status Via the Web</LI>
 </UL>

-<H1>Printing System Overview</H1>
+<H1 ALIGN=RIGHT>1 - Printing System Overview</H1>

-<P></P>
+<P>This chapter provides an overview of how the Common UNIX Printing System
+works.

-<H1>Using the Printing System</H1>
+<H2>The Printing Problem</H2>

-<H2>Choosing a Printer</H2>
+<P>For years <I>the printing problem</I> has plagued UNIX&reg;. Unlike
+Microsoft&reg; Windows&reg; or MacOS, UNIX has no standard interface or
+system in place for supporting printers. Among the solutions previously
+available, the Berkeley and System V printing systems are the most
+prevalent.

-<H2>Setting Printer Options</H2>
+<P>These printing systems support line printers (text only) or
+PostScript printers (text and graphics), and with some coaxing they can
+be made to support a full range of printers and file formats. However,
+because each varient of the UNIX operating system uses a different
+printing system than the next, developing printer drivers for a wide
+range of printers is extremely difficult. That combined with the
+limited volume of customers for each UNIX varient has forced most
+printer vendors to give up supporting UNIX entirely.
+
+<P>The Common UNIX Printing System, or CUPS, is designed to eliminate
+<I>the printing problem</I>. One common printing system can be used by
+all UNIX varients to support the printing needs of users. Printer
+vendors can use its modular filter interface to develop a single driver
+program that supports a wide range of file formats with little or no
+effort.  Since CUPS provides both the System V and Berkeley printing
+commands, users (and applications) can reap the benefits of this new
+technology with no changes.
+
+<H2>The Technology</H2>
+
+<P>CUPS is based upon an emerging Internet standard called the Internet
+Printing Protocol, or IPP. IPP has been embraced by dozens of printer
+and printer server manufacturers, and will be supported by the next
+Microsoft Windows operating system.
+
+<P>IPP defines a standard protocol for printing as well as managing print
+jobs and printer options like media size, resolution, and so forth. Like all
+IP-based protocols, IPP can be used locally or over the Internet to printers
+hundreds or thousands of miles away. Unlike other protocols, however, IPP
+also supports access control, authentication, and encryption, making it a
+much more secure printing solution than older ones.
+
+<P>IPP is layered on top of the Hyper-Text Transport Protocol, or HTTP,
+which is the basis of web servers on the Internet. This allows the user to
+view documentation and status information on a printer or server using their
+web browser.
+
+<P>CUPS provides a complete IPP/1.0-based printing system that provides Basic
+authentication and domain or IP-based access control. Digest authentication
+and TLS encryption will be available in future versions of CUPS.
+
+<H2>Filters</H2>
+
+<P>Filters allow a user or application to print many types of files
+without extra effort. Print jobs sent to a CUPS server are filtered
+before sending them to a printer. Some filters convert job files to
+different formats that the printer can understand. Others perform page
+selection and ordering tasks. <I>Backend</I> filters perform the most
+important task of all - they send the filtered print data to the
+printer.
+
+<P>CUPS provides filters for printing many types of image files,
+HP-GL/2 files, PDF files, and text files. CUPS also supplies
+PostScript and image file Raster Image Processors, or RIPs, that
+convert PostScript or image files into bitmaps that can be sent to a
+raster printer.
+
+<P>CUPS provides backends for printing over parallel and serial ports,
+and over the network via the JetDirect (AppSocket), Server Message
+Block, and Line Printer Daemon protocols.
+
+<H2>Printer Drivers</H2>
+
+<P>Printer drivers in CUPS consist of one of more filters specific to a
+printer. CUPS includes a sample printer driver for Hewlett-Packard
+LaserJet and DeskJet printers. While this driver does not generate
+optimal output for different printer models, it does demonstrate how
+you can write your own printer drivers and incorporate them into CUPS.
+
+<H1 ALIGN=RIGHT>2 - Using the Printing System</H1>
+
+<P>This chapter shows you how to submit, query, and cancel print jobs to
+different printers.

 <H2>Submitting Files for Printing</H2>

-<H2>Checking the Printer Status</H2>
+<P>CUPS provides both the System V (<CODE>lp</CODE>) and Berkeley
+(<CODE>lpr</CODE>) printing commands. To print a file to the default printer
+on the system (or your only printer if you have only one) you just need to
+type:
+
+<UL><PRE>
+% lp filename ENTER
+</PRE></UL>
+
+<P>or:
+
+<UL><PRE>
+% lpr filename ENTER
+</PRE></UL>
+
+<P>CUPS understands many different types of files directly, including PostScript
+and image files. This allows you to print from inside your applications or at
+the command-line, whichever is most convenient!
+
+<H2>Choosing a Printer</H2>
+
+<P>Many systems will have more than one printer available to the user. These
+printers can be attached to the local system via a parallel or serial port,
+or available over the network.
+
+<P>To see a list of available printers, use the <CODE>lpstat</CODE> command:
+
+<UL><PRE>
+% lpstat -p -d ENTER
+</PRE></UL>
+
+<P>The "-p" option specifies that you want to see a list of printers, and the
+"-d" option reports the current system default printer or class.
+
+<P>To print to a specific printer, use the "-d" option to the <CODE>lp</CODE>
+command:
+
+<UL><PRE>
+% lp -d printer filename ENTER
+</PRE></UL>
+
+<P>or the "-P" option to the <CODE>lpr</CODE> command:
+
+<UL><PRE>
+% lpr -P printer filename ENTER
+</PRE></UL>
+
+<H2>Setting Printer Options</H2>
+
+<P>For many types of files, the default printer options may be sufficient for
+your needs. However, there may be times when you need to change the options
+for a particular file you are printing.
+
+<P>The <CODE>lp</CODE> command allows you to pass printer options using the
+"-o" option:
+
+<UL><PRE>
+% lp -o landscape -o scaling=75 -o media=A4 filename.jpg
+</PRE></UL>
+
+<P>The <CODE>lpr</CODE> command has no command-line option for printer options.
+
+<P>The available printer options vary depending on the printer. The standard
+options are described in <A HREF="#4">Chapter 3</A>.
+
+<H2>Printing Multiple Copies</H2>
+
+<P>Both the <CODE>lp</CODE> and <CODE>lpr</CODE> commands have options for
+printing more than one copy of a file:
+
+<UL><PRE>
+% lp -n num-copies filename ENTER
+% lpr -#num-copies filename ENTER
+</PRE></UL>
+
+<P>Copies are normally <I>not</I> collated for you. To get collated copies
+use the <CODE>lp</CODE> command with the "-o Collate=True" option:
+
+<UL><PRE>
+% lp -n num-copies -o Collate=True filename ENTER
+</PRE></UL>
+
+<H2>Checking the Printer Status from the Command-Line</H2>
+
+<P>The <CODE>lpstat</CODE> command can be used to check for jobs that you
+have submitted for printing:
+
+<UL><PRE>
+% lpstat ENTER
+Printer-1 johndoe 4427776
+Printer-2 johndoe 15786
+Printer-3 johndoe 372842
+</PRE></UL>
+
+<P>The jobs are listed in the order they will be printed. To see which files
+and printers are active, use the "-p" option:
+
+<UL><PRE>
+% lpstat -p ENTER
+printer DeskJet now printing DeskJet-1.
+</PRE></UL>
+
+<P>Or to show the jobs and the printers, use the "-o" and "-p" options:
+
+<UL><PRE>
+% lpstat -o -p ENTER
+Printer-1 johndoe 4427776
+Printer-2 johndoe 15786
+Printer-3 johndoe 372842
+printer DeskJet now printing DeskJet-1.
+</PRE></UL>
+
+<H2>Checking the Printer Status from the Web</H2>
+
+<P>Since CUPS uses the Internet Printing Protocol, it is also a
+full-featured web server. To use your web browser to monitor the
+printers on your system, open the URL
+"<A HREF="http://localhost:631">http://localhost:631</A>". From there
+you can view the status of classes, jobs, and printers with the click
+of a button!
+
+<H2>Canceling a Print Job</H2>
+
+<P>The <CODE>cancel</CODE> command cancels a print job:
+
+<UL><PRE>
+% cancel job-id ENTER
+</PRE></UL>
+
+<P>The <I>job-id</I> is a number that was reported to you by the
+<CODE>lp</CODE> or <CODE>lpstat</CODE> commands.
+
+<H1 ALIGN=RIGHT>3 - Standard Printer Options</H1>
+
+<P>This chapter describes the standard printer options that are available
+when printing with the <CODE>lp</CODE> command.
+
+<H2>General Options</H2>
+
+<P>The following options apply when printing all types of files.
+
+<H3>Selecting the Media Size</H3>
+
+<P>The "-o media=size" option sets the media size:
+
+<UL><PRE>
+% lp -o media=Letter filename ENTER
+</PRE></UL>
+
+<P>The available media sizes depend on the printer, but most support at
+least the following sizes (case is significant):
+
+<UL>
+
+	<LI><CODE>Letter</CODE> - US Letter (8.5x11 inches, or 216x279mm)
+
+	<LI><CODE>Legal</CODE> - US Legal (8.5x14 inches, or 216x356mm)
+
+	<LI><CODE>A4</CODE> - ISO A4 (8.27x11.69 inches, or 210x297mm)
+
+	<LI><CODE>COM10</CODE> - US #10 Envelope (9.5x4.125 inches, or
+	241x105mm)
+
+	<LI><CODE>DL</CODE> - ISO DL Envelope (8.66x4.33 inches, or 220x110mm)
+
+</UL>
+
+<H3>Setting the Orientation</H3>
+
+<P>The "-o landscape" option will rotate the page 90 degrees to print in
+landscape orientation:
+
+<UL><PRE>
+% lp -o landscape filename ENTER
+</PRE></UL>
+
+<H3>Printing On Both Sides of the Paper</H3>
+
+<P>The "-o sides=two-sided-short" and "-o sides=two-sided-long" options will
+enable duplexing on the printer (if the printer supports it.) The "two-sided-short"
+option is suitable for landscape pages, while the "two-sided-long" option is
+suitable for portrait pages:
+
+<UL><PRE>
+% lp -o sides=two-sided-short filename ENTER
+% lp -o sides=two-sided-long filename ENTER
+</PRE></UL>
+
+<H3>Selecting a Range of Pages</H3>
+
+<P>The "-o page-range=pages" option selects a range of pages for printing:
+
+<UL><PRE>
+% lp -o page-range=1 filename ENTER
+% lp -o page-range=1-4 filename ENTER
+% lp -o page-range=1-4,7,9-12 filename ENTER
+</PRE></UL>
+
+<P>As shown above, the <I>pages</I> value can be a single page, a range of
+pages, or a collection of page numbers and ranges separated by commas. The
+pages will always be printed in ascending order, regardless of the order of
+the pages in the "page-range" option.
+
+<P>To select the even or odd pages, use the "-o page-set=set" option:
+
+<UL><PRE>
+% lp -o page-set=odd filename ENTER
+% lp -o page-set=even filename ENTER
+</PRE></UL>
+
+<H3>Setting the Brightness</H3>
+
+<P>You can control the overall brightness of the printed output using the
+"-o brightness=percent" option:
+
+<UL><PRE>
+% lp -o brightness=120 filename ENTER
+</PRE></UL>
+
+<P>Values greater than 100 will lighten the print, while values less than
+100 will darken it.
+
+<H3>Setting the Gamma Correction</H3>
+
+<P>You can control the overall gamma correction of the printed output
+using the "-o gamma=value" option:
+
+<UL><PRE>
+% lp -o gamma=1700 filename ENTER
+</PRE></UL>
+
+<P>Values greater than 1000 will lighten the print, while values less
+than 1000 will darken it.
+
+<H2>Text Options</H2>
+
+<P>The following options apply when printing text files.
+
+<H3>Setting the Number of Characters Per Inch</H3>
+
+<P>The "-o cpi=value" option sets the number of characters per inch:
+
+<UL><PRE>
+% lp -o cpi=12 filename ENTER
+</PRE></UL>
+
+<H3>Setting the Number of Lines Per Inch</H3>
+
+<P>The "-o lpi=value" option sets the number of lines per inch:
+
+<UL><PRE>
+% lp -o lpi=8 filename ENTER
+</PRE></UL>
+
+<H3>Setting the Number of Columns</H3>
+
+<P>The "-o columns=value" option sets the number of text columns:
+
+<UL><PRE>
+% lp -o columns=2 filename ENTER
+</PRE></UL>
+
+<H3>Setting the Page Margins</H3>
+
+<P>Normally the page margins are set to the hard limits of the printer. To
+adjust the page margins use the "-o page-left=value", "-o page-right=value",
+"-o page-top=value", and "-o page-bottom=value" options:
+
+<UL><PRE>
+% lp -o page-left=value filename ENTER
+% lp -o page-right=value filename ENTER
+% lp -o page-top=value filename ENTER
+% lp -o page-bottom=value filename ENTER
+</PRE></UL>
+
+<P>The <I>value</I> argument is the margin in points; each point is 1/72 inch
+or 0.35mm.
+
+<H3>Pretty Printing</H3>
+
+<P>The "-o prettyprint" option puts a header at the top of each page with the
+page number, job title (usually the filename), and the date. Also, C and C++
+keywords are highlighted, and comment lines are italicized:
+
+<UL><PRE>
+% lp -o prettyprint filename ENTER
+</PRE></UL>
+
+<H2>Image Options</H2>
+
+<P>The following options apply when printing image files.
+
+<H3>Scaling the Image</H3>
+
+<P>The "-o scaling=percent" and "-o ppi=value" options change the size of a
+printed image:
+
+<UL><PRE>
+% lp -o scaling=percent filename ENTER
+% lp -o ppi=value filename ENTER
+</PRE></UL>
+
+<P>The scaling <I>percent</I> is a number from 1 to 800 specifying the size
+in relation to the page (<I>not</I> the image.) A scaling of 100 percent will
+fill the page as completely as the image aspect ratio allows. A scaling of
+200 percent will print on up to 4 pages.
+
+<P>The ppi <I>value</I> is a number from 1 to 1200 specifying the resolution
+of the image in pixels per inch. An image that is 3000x2400 pixels will print
+10x8 inches at 300 pixels per inch, for example. If the specified resolution
+makes the image larger than the page, multiple pages will be printed to
+satisfy the request.
+
+<H3>Adjusting the Hue (Tint) of an Image</H3>
+
+<P>The "-o hue=value" option will adjust the hue of the printed image, much
+like the tint control on your television:
+
+<UL><PRE>
+% lp -o hue=value filename ENTER
+</PRE></UL>
+
+<P>The <I>value</I> argument is a number from -360 to 360 and represents the
+color hue rotation. The following table summarizes the change you'll see with
+different colors:
+
+<CENTER><TABLE WIDTH="50%" BORDER="1">
+<TR>
+	<TH>Original</TH>
+	<TH>hue=-45</TH>
+	<TH>hue=45</TH>
+</TR>
+<TR>
+	<TD>Red</TD>
+	<TD>Purple</TD>
+	<TD>Yellow-orange</TD>
+</TR>
+<TR>
+	<TD>Green</TD>
+	<TD>Yellow-green</TD>
+	<TD>Blue-green</TD>
+</TR>
+<TR>
+	<TD>Yellow</TD>
+	<TD>Orange</TD>
+	<TD>Green-yellow</TD>
+</TR>
+<TR>
+	<TD>Blue</TD>
+	<TD>Sky-blue</TD>
+	<TD>Purple</TD>
+</TR>
+<TR>
+	<TD>Magenta</TD>
+	<TD>Indigo</TD>
+	<TD>Crimson</TD>
+</TR>
+<TR>
+	<TD>Cyan</TD>
+	<TD>Blue-green</TD>
+	<TD>Light-navy-blue</TD>
+</TR>
+</TABLE></CENTER>
+
+<H3>Adjusting the Saturation (Color) of an Image</H3>
+
+<P>The "-o saturation=percent" option adjusts the saturation of the colors in
+an image, much like the color knob on your television:
+
+<UL><PRE>
+% lp -o saturation=percent filename ENTER
+</PRE></UL>
+
+<P>The <I>percent</I> argument specifies the color saturation from 0 to 200.
+A color saturation of 0 produces a black-and-white print, while a value of 200
+will make the colors extremely intense.

 </BODY>
 </HTML>
@@ -53,6 +53,9 @@ with reduced functionality. </P>
 <P>CUPS adds network printer browsing and PostScript Printer 
 Description (&quot;PPD&quot;)-based printing options to support real world 
 applications under UNIX. </P>
+<P>CUPS also includes a customized version of GNU GhostScript 
+(currently based off GNU GhostScript 4.03) and an image file RIP that 
+can be used to support non-PostScript printers. </P>
 <H2><A NAME=1_3>1.3 Document Overview</A></H2>
 <P>This Something Something Something document is organized into the 
 following sections:</P>
@@ -30,6 +30,10 @@ supported with reduced functionality.
 Description (&quot;PPD&quot;)-based printing options to support real
 world applications under UNIX.

+<P>CUPS also includes a customized version of GNU GhostScript
+(currently based off GNU GhostScript 4.03) and an image file RIP that
+can be used to support non-PostScript printers.
+
 <H2>Document Overview</H2>

 <P>This Something Something Something document is organized into the following
@@ -24,7 +24,8 @@

 include ../Makedefs

-TARGETS	=	hpgltops texttops pstops imagetops imagetoraster
+TARGETS	=	hpgltops texttops pstops imagetops imagetoraster \
+		rastertohp

 HPGLOBJS =	hpgl-attr.o hpgl-config.o hpgl-main.o hpgl-prolog.o \
 		hpgl-char.o hpgl-input.o hpgl-polygon.o hpgl-vector.o
@@ -32,7 +33,7 @@ IMAGEOBJS =	image-colorspace.o image-photocd.o image-sgilib.o \
 		image-tiff.o image-gif.o image-png.o image-sgi.o image-zoom.o \
 		image-jpeg.o image-pnm.o image-sun.o image.o
 OBJS	=	$(HPGLOBJS) $(IMAGEOBJS) imagetops.o imagetoraster.o \
-		common.o pstops.o texttops.o textcommon.o
+		common.o pstops.o rastertohp.o texttops.o textcommon.o

 #
 # Make all targets...
@@ -97,6 +98,14 @@ pstops:	pstops.o common.o ../Makedefs ../cups/libcups.a
 	$(CC) $(LDFLAGS) -o $@ pstops.o common.o $(LIBS)
 pstops.o:	common.h

+#
+# rastertohp
+#
+
+rastertohp:	rastertohp.o ../Makedefs ../cups/libcups.a
+	$(CC) $(LDFLAGS) -o $@ rastertohp.o $(LIBS)
+rastertohp.o:	../cups/raster.h
+
 #
 # texttops
 #
@@ -110,6 +110,8 @@ main(int  argc,		/* I - Number of command-line arguments */
  g    = 1.0;
  b    = 1.0;

+  Copies = atoi(argv[4]);
+
  options     = NULL;
  num_options = cupsParseOptions(argv[5], 0, &options);

@@ -118,9 +120,6 @@ main(int  argc,		/* I - Number of command-line arguments */
  ppdMarkDefaults(ppd);
  cupsMarkOptions(ppd, num_options, options);

-  if ((val = cupsGetOption("copies", num_options, options)) != NULL)
-    Copies = atoi(val);
-
  if ((val = cupsGetOption("multiple-document-handling", num_options, options)) != NULL)
  {
   /*
@@ -245,12 +244,16 @@ main(int  argc,		/* I - Number of command-line arguments */

  puts("%!");

+  if (ppd != NULL && ppd->patches != NULL)
+    puts(ppd->patches);
+
  ppdEmit(ppd, stdout, PPD_ORDER_DOCUMENT);
  ppdEmit(ppd, stdout, PPD_ORDER_ANY);
  ppdEmit(ppd, stdout, PPD_ORDER_PROLOG);

  if (g != 1.0 || b != 1.0)
-    printf("{ neg 1 add %.3f exp neg 1 add %.3f mul } bind settransfer\n", g, b);
+    printf("{ neg 1 add dup 0 lt { pop 1 } { %.3f exp neg 1 add } "
+           "ifelse %.3f mul } bind settransfer\n", g, b);

  if (Copies > 1 && !slowcollate)
  {
@@ -114,7 +114,7 @@ int	Floyd4x4[4][4] =
 ib_t	OnPixels[256],	/* On-pixel LUT */
 	OffPixels[256];	/* Off-pixel LUT */
 int	Planes[] =	/* Number of planes for each colorspace */
-	{ 1, 3, 4, 1, 3, 3, 4, 4, 4, 6 };
+	{ 1, 3, 4, 1, 3, 3, 4, 4, 4, 6, 4, 4, 1, 1, 1 };


 /*
@@ -214,6 +214,8 @@ main(int  argc,		/* I - Number of command-line arguments */
  g    = 1.0;
  b    = 1.0;

+  Copies = atoi(argv[4]);
+
  options     = NULL;
  num_options = cupsParseOptions(argv[5], 0, &options);

@@ -222,9 +224,6 @@ main(int  argc,		/* I - Number of command-line arguments */
  ppdMarkDefaults(ppd);
  cupsMarkOptions(ppd, num_options, options);

-  if ((val = cupsGetOption("copies", num_options, options)) != NULL)
-    Copies = atoi(val);
-
  if ((val = cupsGetOption("multiple-document-handling", num_options, options)) != NULL)
  {
   /*
@@ -325,6 +324,9 @@ main(int  argc,		/* I - Number of command-line arguments */
 	break;

    case CUPS_CSPACE_K :
+    case CUPS_CSPACE_WHITE :
+    case CUPS_CSPACE_GOLD :
+    case CUPS_CSPACE_SILVER :
        primary   = IMAGE_BLACK;
 	secondary = IMAGE_BLACK;
        header.cupsBitsPerPixel = header.cupsBitsPerColor;
@@ -713,6 +715,9 @@ main(int  argc,		/* I - Number of command-line arguments */
 		              yerr0, yerr1, r0, r1);
 		  break;
 	      case CUPS_CSPACE_K :
+	      case CUPS_CSPACE_WHITE :
+	      case CUPS_CSPACE_GOLD :
+	      case CUPS_CSPACE_SILVER :
 	          format_K(&header, row, y, plane, z->xsize, z->ysize,
 		           yerr0, yerr1, r0, r1);
 		  break;
@@ -729,6 +734,8 @@ main(int  argc,		/* I - Number of command-line arguments */
 		              yerr0, yerr1, r0, r1);
 		  break;
 	      case CUPS_CSPACE_YMCK :
+	      case CUPS_CSPACE_GMCK :
+	      case CUPS_CSPACE_GMCS :
 	          format_YMCK(&header, row, y, plane, z->xsize, z->ysize,
 		              yerr0, yerr1, r0, r1);
 		  break;
@@ -129,6 +129,8 @@ main(int  argc,			/* I - Number of command-line arguments */
  g = 1.0;
  b = 1.0;

+  Copies = atoi(argv[4]);
+
  ppd = ppdOpenFile(getenv("PPD"));

  options     = NULL;
@@ -145,9 +147,6 @@ main(int  argc,			/* I - Number of command-line arguments */
  if ((val = cupsGetOption("page-set", num_options, options)) != NULL)
    PageSet = val;

-  if ((val = cupsGetOption("copies", num_options, options)) != NULL)
-    Copies = atoi(val);
-
  if ((val = cupsGetOption("multiple-document-handling", num_options, options)) != NULL)
  {
   /*
@@ -242,6 +241,9 @@ main(int  argc,			/* I - Number of command-line arguments */

  puts(line);

+  if (ppd != NULL && ppd->patches != NULL)
+    puts(ppd->patches);
+
  ppdEmit(ppd, stdout, PPD_ORDER_DOCUMENT);
  ppdEmit(ppd, stdout, PPD_ORDER_ANY);
  ppdEmit(ppd, stdout, PPD_ORDER_PROLOG);
@@ -253,7 +255,8 @@ main(int  argc,			/* I - Number of command-line arguments */
         "end");

  if (g != 1.0 || b != 1.0)
-    printf("{ neg 1 add %.3f exp neg 1 add %.3f mul } bind settransfer\n", g, b);
+    printf("{ neg 1 add dup 0 lt { pop 1 } { %.3f exp neg 1 add } "
+           "ifelse %.3f mul } bind settransfer\n", g, b);

  if (Copies > 1 && (!Collate || !slowcollate))
    printf("/#copies %d def\n", Copies);
@@ -298,6 +301,9 @@ main(int  argc,			/* I - Number of command-line arguments */

          if (!sloworder)
 	  {
+	    if (ppd == NULL || ppd->num_filters == 0)
+	      fprintf(stderr, "PAGE: %d %d\n", NumPages, Copies);
+
 	    ppdEmit(ppd, stdout, PPD_ORDER_PAGE);
 	    start_nup(NumPages - 1);
 	  }
@@ -334,6 +340,9 @@ main(int  argc,			/* I - Number of command-line arguments */

 	  for (number = 0; number < NumPages; number ++)
 	  {
+	    if (ppd == NULL || ppd->num_filters == 0)
+	      fprintf(stderr, "PAGE: %d 1\n", number + 1);
+
 	    ppdEmit(ppd, stdout, PPD_ORDER_PAGE);
 	    start_nup(number);
 	    copy_bytes(temp, Pages[number + 1] - Pages[number]);
@@ -345,13 +354,14 @@ main(int  argc,			/* I - Number of command-line arguments */
      }
      else
      {
-        if (!slowcollate)
-	  Copies = 1;
-
-        while (Copies > 0)
+        do
 	{
 	  for (number = NumPages - 1; number >= 0; number --)
 	  {
+	    if (ppd == NULL || ppd->num_filters == 0)
+	      fprintf(stderr, "PAGE: %d %d\n", NumPages - number,
+	              slowcollate ? 1 : Copies);
+
 	    ppdEmit(ppd, stdout, PPD_ORDER_PAGE);
 	    start_nup(NumPages - 1 - number);
 	    fseek(temp, Pages[number], SEEK_SET);
@@ -361,6 +371,7 @@ main(int  argc,			/* I - Number of command-line arguments */

 	  Copies --;
 	}
+	while (Copies > 0 || !slowcollate);
      }
    }
  }
@@ -370,6 +381,9 @@ main(int  argc,			/* I - Number of command-line arguments */
    * No DSC comments - write any page commands and then the rest of the file...
    */

+    if (ppd == NULL || ppd->num_filters == 0)
+      fprintf(stderr, "PAGE: 1 %d\n", slowcollate ? 1 : Copies);
+
    ppdEmit(ppd, stdout, PPD_ORDER_PAGE);

    while (psgets(line, sizeof(line), fp) != NULL)
@@ -387,6 +401,9 @@ main(int  argc,			/* I - Number of command-line arguments */
    {
      while (Copies > 1)
      {
+	if (ppd == NULL || ppd->num_filters == 0)
+	  fputs("PAGE: 1 1\n", stderr);
+
        ppdEmit(ppd, stdout, PPD_ORDER_PAGE);
 	rewind(temp);
 	copy_bytes(temp, 0);
@@ -0,0 +1,493 @@
+/*
+ * "$Id$"
+ *
+ *   Hewlett-Packard Page Control Language and Raster Transfer Language
+ *   filter for ESP Print.
+ *
+ *   Copyright 1993-1999 by Easy Software Products
+ *
+ *   These coded instructions, statements, and computer programs contain
+ *   unpublished proprietary information of Easy Software Products, and
+ *   are protected by Federal copyright law. They may not be disclosed
+ *   to third parties or copied or duplicated in any form, in whole or
+ *   in part, without the prior written consent of Easy Software Products.
+ *
+ * Contents:
+ *
+ */
+
+/*
+ * Include necessary headers...
+ */
+
+#include <cups/cups.h>
+#include <cups/raster.h>
+#include <cups/string.h>
+#include <stdlib.h>
+#include <unistd.h>
+#include <fcntl.h>
+
+
+/*
+ * Globals...
+ */
+
+unsigned char	*Planes[4],		/* Output buffers */
+		*CompBuffer;		/* Compression buffer */
+int		NumPlanes,		/* Number of color planes */
+		Feed;			/* Number of lines to skip */
+
+
+/*
+ * Prototypes...
+ */
+
+void	Setup(void);
+void	StartPage(cups_page_header_t *header);
+void	EndPage(cups_page_header_t *header);
+void	Shutdown(void);
+
+void	CompressData(unsigned char *line, int length, int plane, int type);
+void	OutputLine(cups_page_header_t *header);
+
+
+/*
+ * 'Setup()' - Prepare the printer for printing.
+ */
+
+void
+Setup(void)
+{
+ /*
+  * Send a PCL reset sequence.
+  */
+
+  putchar(0x1b);
+  putchar('E');
+}
+
+
+/*
+ * 'StartPage()' - Start a page of graphics.
+ */
+
+void
+StartPage(cups_page_header_t *header)	/* I - Page header */
+{
+  int	plane;				/* Looping var */
+
+
+ /*
+  * Set the media type, position, and size...
+  */
+
+  printf("\033&l6D\033&k12H");			/* Set 6 LPI, 10 CPI */
+  printf("\033&l%.2fP",				/* Set page length */
+         header->PageSize[1] / 12.0);
+  printf("\033&l%dX", header->NumCopies);	/* Set number copies */
+  if (header->MediaPosition)
+    printf("\033&l%dH", header->MediaPosition);	/* Set media position */
+  if (header->cupsMediaType)
+    printf("\033&l%dM",				/* Set media type */
+           header->cupsMediaType);
+
+ /*
+  * Set graphics mode...
+  */
+
+  if (header->cupsColorSpace == CUPS_CSPACE_KCMY)
+  {
+    NumPlanes = 4;
+    printf("\033*r-4U");			/* Set KCMY graphics */
+  }
+  else
+    NumPlanes = 1;
+
+  printf("\033*t%dR", header->HWResolution[0]);	/* Set resolution */
+  printf("\033*r%dS", header->cupsWidth);	/* Set width */
+  printf("\033*r%dT", header->cupsHeight);	/* Set height */
+  printf("\033&a0H\033&a0V");			/* Set top-of-page */
+  printf("\033*r1A");				/* Start graphics */
+
+  if (header->cupsCompression)
+    printf("\033*b%dM",				/* Set compression */
+           header->cupsCompression);
+
+  Feed = 0;					/* No blank lines yet */
+
+ /*
+  * Allocate memory for a line of graphics...
+  */
+
+  Planes[0] = malloc(header->cupsBytesPerLine);
+  for (plane = 1; plane < NumPlanes; plane ++)
+    Planes[plane] = Planes[0] + plane * header->cupsBytesPerLine / NumPlanes;
+
+  if (header->cupsCompression)
+    CompBuffer = malloc(header->cupsBytesPerLine * 2);
+}
+
+
+/*
+ * 'EndPage()' - Finish a page of graphics.
+ */
+
+void
+EndPage(cups_page_header_t *header)	/* I - Page header */
+{
+ /*
+  * Eject the current page...
+  */
+
+  if (NumPlanes > 1)
+  {
+     printf("\033*rC");			/* End color GFX */
+     printf("\033&l0H");		/* Eject current page */
+  }
+  else
+  {
+     printf("\033*r0B");		/* End GFX */
+     printf("\014");			/* Eject currnet page */
+  }
+
+ /*
+  * Free memory...
+  */
+
+  free(Planes[0]);
+
+  if (header->cupsCompression)
+    free(CompBuffer);
+}
+
+
+/*
+ * 'Shutdown()' - Shutdown the printer.
+ */
+
+void
+Shutdown(void)
+{
+ /*
+  * Send a PCL reset sequence.
+  */
+
+  putchar(0x1b);
+  putchar('E');
+}
+
+
+/*
+ * 'CompressData()' - Compress a line of graphics.
+ */
+
+void
+CompressData(unsigned char *line,	/* I - Data to compress */
+             int           length,	/* I - Number of bytes */
+	     int           plane,	/* I - Color plane */
+	     int           type)	/* I - Type of compression */
+{
+  unsigned char	*line_ptr,		/* Current byte pointer */
+        	*line_end,		/* End-of-line byte pointer */
+        	*comp_ptr,		/* Pointer into compression buffer */
+        	*start;			/* Start of compression sequence */
+  int           count;			/* Count of bytes for output */
+
+
+  switch (type)
+  {
+    case 0 :
+       /*
+	* Do no compression...
+	*/
+
+	line_ptr = line;
+	line_end = line + length;
+	break;
+
+    case 1 :
+       /*
+        * Do run-length encoding...
+        */
+
+	line_end = line + length;
+	for (line_ptr = line, comp_ptr = CompBuffer;
+	     line_ptr < line_end;
+	     comp_ptr += 2, line_ptr += count)
+	{
+	  for (count = 1;
+               (line_ptr + count) < line_end &&
+	           line_ptr[0] == line_ptr[count] &&
+        	   count < 256;
+               count ++);
+
+	  comp_ptr[0] = count - 1;
+	  comp_ptr[1] = line_ptr[0];
+	}
+
+        line_ptr = CompBuffer;
+        line_end = comp_ptr;
+	break;
+
+    case 2 :
+       /*
+        * Do TIFF pack-bits encoding...
+        */
+
+	line_ptr = line;
+	line_end = line + length;
+	comp_ptr = CompBuffer;
+
+	while (line_ptr < line_end)
+	{
+	  if ((line_ptr + 1) >= line_end)
+	  {
+	   /*
+	    * Single byte on the end...
+	    */
+
+	    *comp_ptr++ = 0x00;
+	    *comp_ptr++ = *line_ptr++;
+	  }
+	  else if (line_ptr[0] == line_ptr[1])
+	  {
+	   /*
+	    * Repeated sequence...
+	    */
+
+	    line_ptr ++;
+	    count = 2;
+
+	    while (line_ptr < (line_end - 1) &&
+        	   line_ptr[0] == line_ptr[1] &&
+        	   count < 127)
+	    {
+              line_ptr ++;
+              count ++;
+	    }
+
+	    *comp_ptr++ = 257 - count;
+	    *comp_ptr++ = *line_ptr++;
+	  }
+	  else
+	  {
+	   /*
+	    * Non-repeated sequence...
+	    */
+
+	    start    = line_ptr;
+	    line_ptr ++;
+	    count    = 1;
+
+	    while (line_ptr < (line_end - 1) &&
+        	   line_ptr[0] != line_ptr[1] &&
+        	   count < 127)
+	    {
+              line_ptr ++;
+              count ++;
+	    }
+
+	    *comp_ptr++ = count - 1;
+
+	    memcpy(comp_ptr, start, count);
+	    comp_ptr += count;
+	  }
+	}
+
+        line_ptr = CompBuffer;
+        line_end = comp_ptr;
+	break;
+  }
+
+ /*
+  * Set the length of the data and write a raster plane...
+  */
+
+  printf("\033*b%d%c", line_end - line_ptr, plane);
+  fwrite(line_ptr, line_end - line_ptr, 1, stdout);
+}
+
+
+/*
+ * 'OutputLine()' - Output a line of graphics.
+ */
+
+void
+OutputLine(cups_page_header_t *header)	/* I - Page header */
+{
+  int	plane;	/* Current plane */
+
+
+ /*
+  * Output whitespace as needed...
+  */
+
+  if (Feed > 0)
+  {
+    printf("\033*b%dY", Feed);
+    Feed = 0;
+  }
+
+ /*
+  * Write bitmap data as needed...
+  */
+
+  for (plane = 0; plane < NumPlanes; plane ++)
+    CompressData(Planes[plane], header->cupsBytesPerLine / NumPlanes,
+		 plane < (NumPlanes - 1) ? 'V' : 'W',
+		 header->cupsCompression);
+}
+
+
+/*
+ * 'main()' - Main entry and processing of driver.
+ */
+
+int			/* O - Exit status */
+main(int  argc,		/* I - Number of command-line arguments */
+     char *argv[])	/* I - Command-line arguments */
+{
+  int			fd;	/* File descriptor */
+  cups_raster_t		*ras;	/* Raster stream for printing */
+  cups_page_header_t	header;	/* Page header from file */
+  int			page;	/* Current page */
+  int			y;	/* Current line */
+
+
+ /*
+  * Check for valid arguments...
+  */
+
+  if (argc < 6 || argc > 7)
+  {
+   /*
+    * We don't have the correct number of arguments; write an error message
+    * and then sleep for 1 second to give the scheduler a chance to read
+    * the message.
+    */
+
+    fputs("ERROR: rastertopcl job-id user title copies options [file]\n", stderr);
+    sleep(1);
+    return (1);
+  }
+
+ /*
+  * Open the page stream...
+  */
+
+  if (argc == 7)
+  {
+    if ((fd = open(argv[6], O_RDONLY)) == -1)
+    {
+      perror("ERROR: Unable to open raster file - ");
+      sleep(1);
+      return (1);
+    }
+  }
+  else
+    fd = 0;
+
+  ras = cupsRasterOpen(fd, CUPS_RASTER_READ);
+
+ /*
+  * Initialize the print device...
+  */
+
+  Setup();
+
+ /*
+  * Process pages as needed...
+  */
+
+  page = 0;
+
+  while (cupsRasterReadHeader(ras, &header))
+  {
+   /*
+    * Write a status message with the page number and number of copies.
+    */
+
+    page ++;
+
+    fprintf(stderr, "PAGE: %d %d\n", page, header.NumCopies);
+
+   /*
+    * Start the page...
+    */
+
+    StartPage(&header);
+
+   /*
+    * Loop for each line on the page...
+    */
+
+    for (y = 0; y < header.cupsHeight; y ++)
+    {
+     /*
+      * Let the user know how far we have progressed...
+      */
+
+      if ((y & 127) == 0)
+        fprintf(stderr, "INFO: Printing page %d, %d%% complete...\n", page,
+	        100 * y / header.cupsHeight);
+
+     /*
+      * Read a line of graphics...
+      */
+
+      if (cupsRasterReadPixels(ras, Planes[0], header.cupsBytesPerLine) < 1)
+        break;
+
+     /*
+      * See if the line is blank; if not, write it to the printer...
+      */
+
+      if (Planes[0][0] ||
+          memcmp(Planes[0], Planes[0] + 1, header.cupsBytesPerLine - 1))
+        OutputLine(&header);
+      else
+        Feed ++;
+    }
+
+   /*
+    * Eject the page...
+    */
+
+    EndPage(&header);
+  }
+
+ /*
+  * Shutdown the printer...
+  */
+
+  Shutdown();
+
+ /*
+  * Close the raster stream...
+  */
+
+  cupsRasterClose(ras);
+  if (fd != 0)
+    close(fd);
+
+ /*
+  * If no pages were printed, send an error message...
+  */
+
+  if (page == 0)
+    fputs("ERROR: No pages found!\n", stderr);
+  else
+    fputs("INFO: Ready to print.\n", stderr);
+
+ /*
+  * Sleep for 1 second and return...
+  */
+
+  sleep(1);
+  return (page == 0);
+}
+
+
+/*
+ * End of "$Id$".
+ */
@@ -432,7 +432,7 @@ TextMain(char *name,		/* I - Name of filter */

 	      attr &= ~ATTR_BOLD;
 	    }
-	    else if (!isalpha(ch) && keyptr > keyword)
+	    else if (!(isalnum(ch) || ch == '_') && keyptr > keyword)
 	    {
 	     /*
 	      * Look for a keyword...
@@ -458,7 +458,7 @@ TextMain(char *name,		/* I - Name of filter */
 		}
 	      }
 	    }
-	    else if (isalpha(ch) && !ccomment && !cstring)
+	    else if ((isalnum(ch) || ch == '_') && !ccomment && !cstring)
 	    {
 	     /*
 	      * Add characters to the current keyword (if they'll fit).
@@ -0,0 +1,68 @@
+#
+# "$Id$"
+#
+#   Fonts makefile for the Common UNIX Printing System (CUPS).
+#
+#   Copyright 1993-1999 by Easy Software Products.
+#
+#   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-3111 USA
+#
+#       Voice: (301) 373-9603
+#       EMail: cups-info@cups.org
+#         WWW: http://www.cups.org
+#
+
+include ../Makedefs
+
+#
+# Font files...
+#
+
+FONTS	=	AvantGarde-Book AvantGarde-BookOblique AvantGarde-Demi \
+		AvantGarde-DemiOblique Bookman-Demi Bookman-DemiItalic \
+		Bookman-Light Bookman-LightItalic Courier Courier-Bold \
+		Courier-BoldOblique Courier-Oblique Helvetica \
+		Helvetica-Bold Helvetica-BoldOblique Helvetica-Narrow \
+		Helvetica-Narrow-Bold Helvetica-Narrow-BoldOblique \
+		Helvetica-Narrow-Oblique Helvetica-Oblique \
+		NewCenturySchlbk-Bold NewCenturySchlbk-BoldItalic \
+		NewCenturySchlbk-Italic NewCenturySchlbk-Roman \
+		Palatino-Bold Palatino-BoldItalic Palatino-Italic \
+		Palatino-Roman Symbol Times-Bold Times-BoldItalic \
+		Times-Italic Times-Roman Utopia-Bold Utopia-BoldItalic \
+		Utopia-Italic Utopia-Regular ZapfChancery-MediumItalic \
+		ZapfDingbats
+
+#
+# Make everything...
+#
+
+all:
+
+#
+# Clean all config and object files...
+#
+
+clean:
+
+#
+# Install files...
+#
+
+install:
+	-$(MKDIR) $(DATADIR)/fonts
+	$(CP) $(FONTS) $(DATADIR)/fonts
+
+#
+# End of "$Id$".
+#
--- a/Mostrar Mais
+++ b/Mostrar Mais