--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">
+<HTML>
+<HEAD>
+<TITLE>CUPS Translation Guide</TITLE>
+<META NAME="author" CONTENT="Easy Software Products">
+<META NAME="copyright" CONTENT="Copyright 2001-2002, All Rights Reserved">
+<META NAME="docnumber" CONTENT="CUPS-TRANS-1.2">
+<META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=iso-8859-1">
+<STYLE TYPE="text/css"><!--
+BODY { font-family: serif }
+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 }
+SUB { font-size: smaller }
+SUP { font-size: smaller }
+PRE { font-family: monospace }
+--></STYLE>
+</HEAD>
+<BODY>
+<CENTER><A HREF="#CONTENTS"><IMG SRC="images/cups-large.gif" BORDER="0" WIDTH="431" HEIGHT="511"><BR>
+<H1>CUPS Translation Guide</H1></A><BR>
+CUPS-TRANS-1.2<BR>
+Easy Software Products<BR>
+Copyright 2001-2002, All Rights Reserved<BR>
+</CENTER>
+<HR>
+<H1 ALIGN="CENTER"><A NAME="CONTENTS">Table of Contents</A></H1>
+<BR>
+<BR><B><A HREF="#1">1 Scope</A></B>
+<UL>
+<LI><A HREF="#1_1">1.1 Identification</A></LI>
+<LI><A HREF="#1_2">1.2 System Overview</A></LI>
+<LI><A HREF="#1_3">1.3 Document Overview</A></LI>
+</UL>
+<B><A HREF="#2">2 References</A></B>
+<UL>
+<LI><A HREF="#2_1">2.1 CUPS Documentation</A></LI>
+<LI><A HREF="#2_2">2.2 Other Documents</A></LI>
+</UL>
+<B><A HREF="#3">3 Character Sets</A></B>
+<BR>
+<BR><B><A HREF="#4">4 Message Catalogs</A></B>
+<BR>
+<BR><B><A HREF="#5">5 Web Interfaces</A></B>
+<UL>
+<LI><A HREF="#5_1">5.1 Template Files</A></LI>
+<UL>
+<LI><A HREF="#5_1_1">5.1.1 Inserting Attributes and Values</A></LI>
+<LI><A HREF="#5_1_2">5.1.2 Array Substitutions</A></LI>
+<LI><A HREF="#5_1_3">5.1.3 Conditional Tests</A></LI>
+<LI><A HREF="#5_1_4">5.1.4 Template File List</A></LI>
+</UL>
+<LI><A HREF="#5_2">5.2 CGI Programs</A></LI>
+<UL>
+<LI><A HREF="#5_2_1">5.2.1 admin.cgi</A></LI>
+<LI><A HREF="#5_2_2">5.2.2 classes.cgi</A></LI>
+<LI><A HREF="#5_2_3">5.2.3 jobs.cgi</A></LI>
+<LI><A HREF="#5_2_4">5.2.4 printers.cgi</A></LI>
+</UL>
+</UL>
+<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>
+</UL>
+<HR>
+<H1><A NAME="1">1 Scope</A></H1>
+<H2><A NAME="1_1">1.1 Identification</A></H2>
+<P>This translation guide provides instructions for creating
+ translations of the CUPS message catalogs and web pages for the Common
+ UNIX Printing System ("CUPS") Version 1.2 software.</P>
+<H2><A NAME="1_2">1.2 System Overview</A></H2>
+<P>CUPS provides a portable printing layer for UNIX®-based operating
+ systems. It has been developed by<A HREF="http://www.easysw.com"> Easy
+ Software Products</A> to promote a standard printing solution for all
+ UNIX vendors and users. CUPS provides the System V and Berkeley
+ command-line interfaces.</P>
+<P>CUPS uses the Internet Printing Protocol ("IPP") as the basis for
+ managing print jobs and queues. The Line Printer Daemon ("LPD") Server
+ Message Block ("SMB"), and AppSocket (a.k.a. JetDirect) protocols are
+ also supported with reduced functionality. CUPS adds network printer
+ browsing and PostScript Printer Description ("PPD") based printing
+ options to support real-world printing under UNIX.</P>
+<P>CUPS also includes a customized version of GNU Ghostscript (currently
+ based off GNU Ghostscript 5.50) and an image file RIP that are used to
+ support non-PostScript printers. Sample drivers for HP and EPSON
+ printers are included that use these filters.</P>
+<H2><A NAME="1_3">1.3 Document Overview</A></H2>
+<P>This translation guide is organized into the following sections:</P>
+<UL>
+<LI>1 - Scope</LI>
+<LI>2 - References</LI>
+<LI>3 - Character Sets</LI>
+<LI>4 - Message Catalogs</LI>
+<LI>5 - Web Interfaces</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>
+<P>The following CUPS documentation is referenced by this document:</P>
+<UL>
+<LI>CUPS-CMP-1.2: CUPS Configuration Management Plan</LI>
+<LI>CUPS-IDD-1.2: CUPS System Interface Design Description</LI>
+<LI>CUPS-IPP-1.2: CUPS Implementation of IPP</LI>
+<LI>CUPS-SAM-1.2.x: CUPS Software Administrators Manual</LI>
+<LI>CUPS-SDD-1.2: CUPS Software Design Description</LI>
+<LI>CUPS-SPM-1.2.x: CUPS Software Programming Manual</LI>
+<LI>CUPS-SSR-1.2: CUPS Software Security Report</LI>
+<LI>CUPS-STP-1.2: CUPS Software Test Plan</LI>
+<LI>CUPS-SUM-1.2.x: CUPS Software Users Manual</LI>
+<LI>CUPS-SVD-1.2: CUPS Software Version Description</LI>
+</UL>
+<H2><A NAME="2_2">2.2 Other Documents</A></H2>
+<P>The following non-CUPS documents are referenced by this document:</P>
+<UL>
+<LI><A HREF="http://partners.adobe.com/asn/developer/PDFS/TN/5003.PPD_Spec_v4.3.pdf">
+Adobe PostScript Printer Description File Format Specification, Version
+ 4.3.</A></LI>
+<LI><A HREF="http://partners.adobe.com/asn/developer/PDFS/TN/PLRM.pdf">
+Adobe PostScript Language Reference, Third Edition.</A></LI>
+<LI>IPP: Job and Printer Set Operations</LI>
+<LI>IPP/1.1: Encoding and Transport</LI>
+<LI>IPP/1.1: Implementers Guide</LI>
+<LI>IPP/1.1: Model and Semantics</LI>
+<LI><A HREF="http://www.ietf.org/rfc/rfc1179.txt">RFC 1179, Line Printer
+ Daemon Protocol</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>
+<LI><A HREF="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616, Hypertext
+ Transfer Protocol -- HTTP/1.1</A></LI>
+<LI><A HREF="http://www.ietf.org/rfc/rfc2617.txt">RFC 2617, HTTP
+ Authentication: Basic and Digest Access</A> Authentication</LI>
+</UL>
+<H1><A NAME="3">3 Character Sets</A></H1>
+<P>CUPS uses character set files to define the mapping of local
+ character sets to Unicode code points, as well as the fonts that should
+ be used for different ranges of characters.</P>
+<P>CUPS includes files for common 8-bit encodings as well as UTF-8 for
+ Unicode text. The format of these files is described in the CUPS
+ Interface Design Description (IDD) document. Current character sets are
+ enumerated in the CUPS API, so in order to add a new character set you
+ must patch the CUPS source as well as provide a new charset file.</P>
+<P>CUPS 1.2 supports the following character sets:</P>
+<UL>
+<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-10</LI>
+<LI>iso-8859-13</LI>
+<LI>iso-8859-14</LI>
+<LI>iso-8859-15</LI>
+<LI>koi8-r</LI>
+<LI>koi8-u</LI>
+<LI>us-ascii</LI>
+<LI>utf-8</LI>
+<LI>windows-874</LI>
+<LI>windows-1250</LI>
+<LI>windows-1251</LI>
+<LI>windows-1252</LI>
+<LI>windows-1253</LI>
+<LI>windows-1254</LI>
+<LI>windows-1255</LI>
+<LI>windows-1256</LI>
+<LI>windows-1257</LI>
+<LI>windows-1258</LI>
+</UL>
+<H1><A NAME="4">4 Message Catalogs</A></H1>
+<P>CUPS message catalogs are text files that identify the default
+ character set for the locale and a list of localized message strings
+ for the CUPS software. The format of the message catalog files is
+ described in the CUPS IDD.</P>
+<P>Message catalogs are named<VAR> cups_ll</VAR>,<VAR> cups_ll_CC</VAR>,
+ or<VAR> cups_ll_CC.charset</VAR>, where "ll" is the standard 2-letter
+ abbreviation for the language, "CC" is the standard 2-letter
+ abbreviation for the country, and "charset" is the charset name which
+ may differ from the list above.</P>
+<P>Each message catalog file is stored in a subdirectory named<VAR> ll</VAR>
+,<VAR> ll_CC</VAR>, or<VAR> ll_CC.charset</VAR> to match the trailing
+ portion of the message catalog filename.</P>
+<P>When translating a new message catalog, copy the<VAR> cups_C</VAR>
+ message catalog file to a new subdirectory; to translate the message
+ catalog to Canadian French, you would type the following commands:</P>
+<UL>
+<PRE>
+<KBD>cd locale <I>ENTER</I></KBD>
+<KBD>mkdir fr_CA <I>ENTER</I></KBD>
+<KBD>cp C/cups_C fr_CA/cups_fr_CA <I>ENTER</I></KBD>
+</PRE>
+</UL>
+<P>Alternatively, you could copy the existing<VAR> cups_fr</VAR> message
+ catalog and then make any changes necessary.</P>
+<P>Once you have make your copy of the file, edit it using your favorite
+ text editor to translate the text to the desired language. Be sure to
+ preserve any numbers starting in the first column, as they indicate a
+ new message number - you'll see this for the HTTP status messages.</P>
+<P>Finally, add your locale to the list of locales in the makefile and
+ run the following command to install it:</P>
+<UL>
+<PRE>
+<KBD>make install <I>ENTER</I></KBD>
+</PRE>
+</UL>
+<H1><A NAME="5">5 Web Interfaces</A></H1>
+<P>The CUPS scheduler provides a web interface that can be used to do
+ many common printing and administration tasks. The built-in web server
+ supports localization of web pages through the use of subdirectories
+ for each locale, e.g. "fr" for French, "de" for German, "fr_ca" for
+ French in Canada, and so forth.</P>
+<H2><A NAME="5_1">5.1 Template Files</A></H2>
+<P>Template files are HTML files with special formatting characters in
+ them that allow substition of variables and arrays. The CUPS CGI
+ programs (<CODE>admin.cgi</CODE>, <CODE>classes.cgi</CODE>, <CODE>
+jobs.cgi</CODE>, and <CODE>printers.cgi</CODE>) use these template file
+ to provide dynamic content for the web interface. Template files are
+ installed in the<VAR> /usr/share/cups/templates</VAR> directory by
+ default.</P>
+<P>Translated versions of the template files should be installed in the
+ appropriate subdirectories under<VAR> /usr/share/cups/templates</VAR>.
+ For example, Canadian French template files should be stored in the<VAR>
+ /usr/share/cups/templates/fr_CA</VAR> directory.</P>
+<H3><A NAME="5_1_1">5.1.1 Inserting Attributes and Values</A></H3>
+<P>Template files consist of HTML with variable substitutions for named
+ inside curley braces "{name}". Variable names are generally the IPP
+ attribute names with the hyphen ("-") replaced by the underscore ("_")
+ character. For example, the <TT>job-printer-uri</TT> attribute is
+ renamed to <TT>job_printer_uri</TT>.</P>
+<P>Curley braces ("{" and "}") to indicate substitutions, and the
+ backslash ("\") character for quoting. To insert any of these special
+ characters as-is you need to use the HTML <CODE>&name;</CODE> mechanism
+ or prefix each special character with the backslash ("\".)</P>
+<P>You substitute the value of a variable using <CODE>{NAME}</CODE> in
+ your template file. If the variable is undefined then the <CODE>{NAME}</CODE>
+ string is output as-is.</P>
+<P>To substitute an empty string if the variable is undefined, use <CODE>
+{?NAME}</CODE> instead.</P>
+<H3><A NAME="5_1_2">5.1.2 Array Substitutions</A></H3>
+<P>The number of array elements can be inserted using <CODE>{#NAME}</CODE>
+. If the array is undefined then 0 is output. The current array element
+ (starting at 1) is inserted with <CODE>{#}</CODE>.</P>
+<P>Arrays are handled using <CODE>{[NAME]</CODE> at the beginning of a
+ section and <CODE>}</CODE> at the end. The information between the
+ closing bracket ("]") and closing brace ("}") is repeated for as many
+ elements as are in the named array. For example, the following template
+ will display a list of each job in the <CODE>job_id</CODE> array:</P>
+<UL>
+<PRE>
+<TABLE>
+<TR>
+ <TH>Job ID</TH>
+ <TH>Destination</TH>
+ <TH>Title</TH>
+</TR>
+
+{[job_id]
+<TR>
+ <TD>{?job_id}</TD>
+ <TD>{?job_printer_name}</TD>
+ <TD>{?job_name}</TD>
+</TR>
+}
+</TABLE>
+</PRE>
+</UL>
+<P>Arrays can be nested, however all elements within the curley braces
+ ("{" and "}") are indexed using the innermost array.</P>
+<H3><A NAME="5_1_3">5.1.3 Conditional Tests</A></H3>
+<P>Templates can also test variables against specific values and
+ conditionally include text in the template. The format is:</P>
+<UL>
+<PRE>
+{<I>variable</I>?<I>true</I>:<I>false</I>}
+{<I>variable</I>=<I>value</I>?<I>true</I>:<I>false</I>}
+{<I>variable</I>!<I>value</I>?<I>true</I>:<I>false</I>}
+{<I>variable</I><<I>value</I>?<I>true</I>:<I>false</I>}
+{<I>variable</I>><I>value</I>?<I>true</I>:<I>false</I>}
+</PRE>
+</UL>
+<P>where<VAR> true</VAR> is the text that is included if the condition
+ is true and<VAR> false</VAR> is the text that is included if the
+ condition is false. A value of <CODE>#</CODE> is replaced with the
+ current element number (starting at 1.)</P>
+<P>The character after the variable name specifies the condition to
+ test:
+<CENTER>
+<TABLE BORDER="1">
+<TR><TH WIDTH="5%">Char</TH><TH WIDTH="50%">Condition</TH></TR>
+<TR><TD>?</TD><TD>True if<VAR> variable</VAR> exists.</TD></TR>
+<TR><TD>=</TD><TD>True if<VAR> variable</VAR> is equal to<VAR> value</VAR>
+.</TD></TR>
+<TR><TD>!</TD><TD>True if<VAR> variable</VAR> is not equal to<VAR> value</VAR>
+.</TD></TR>
+<TR><TD><</TD><TD>True if<VAR> variable</VAR> is less than<VAR> value</VAR>
+.</TD></TR>
+<TR><TD>></TD><TD>True if<VAR> variable</VAR> is greater than<VAR> value</VAR>
+.</TD></TR>
+</TABLE>
+</CENTER>
+</P>
+<H3><A NAME="5_1_4">5.1.4 Template File List</A></H3>
+<P>The following template files are used by the web interface:</P>
+<DL>
+<DT>add-class.tmpl</DT>
+<DD>This is the initial form that is shown to add a new printer class.</DD>
+<DT>add-printer.tmpl</DT>
+<DD>This is the initial form that is shown to add a new printer.</DD>
+<DT>admin-op.tmpl</DT>
+<DD>This is the template that is used to display an error message when
+ the admin interface sees an undefined operation name.</DD>
+<DT>admin.tmpl</DT>
+<DD>This is the template that shows the initial menu of operations (add
+ a class, manage classes, etc.)</DD>
+<DT>choose-device.tmpl</DT>
+<DD>This is the form that shows the list of available devices.</DD>
+<DT>choose-make.tmpl</DT>
+<DD>This is the form that shows the list of available manufacturers.</DD>
+<DT>choose-members.tmpl</DT>
+<DD>This is the form that shows the list of available printers that can
+ be added to a class.</DD>
+<DT>choose-model.tmpl</DT>
+<DD>This is the form that shows the list of available printer
+ models/drivers.</DD>
+<DT>choose-serial.tmpl</DT>
+<DD>This is the form that allows the user to choose a serial port and
+ any options.</DD>
+<DT>choose-uri.tmpl</DT>
+<DD>This is the form that allows the user to enter a device URI for
+ network printers.</DD>
+<DT>class-added.tmpl</DT>
+<DD>This template shows the "class added" message.</DD>
+<DT>class-confirm.tmpl</DT>
+<DD>This is the template used to confirm the deletion of a class.</DD>
+<DT>class-deleted.tmpl</DT>
+<DD>This template shows the "class deleted" message.</DD>
+<DT>classes.tmpl</DT>
+<DD>This template shows one or more printer classes.</DD>
+<DT>class-modified.tmpl</DT>
+<DD>This template shows the "class modified" message.</DD>
+<DT>config-printer.tmpl</DT>
+<DD>This template starts the printer configuration form.</DD>
+<DT>config-printer2.tmpl</DT>
+<DD>This template ends the printer configuration form.</DD>
+<DT>error.tmpl</DT>
+<DD>This template displays a generic error message.</DD>
+<DT>header.tmpl</DT>
+<DD>This template is used as the standard header on all dynamic content.</DD>
+<DT>job-cancel.tmpl</DT>
+<DD>This template shows "job cancelled".</DD>
+<DT>job-hold.tmpl</DT>
+<DD>This template shows "job held".</DD>
+<DT>job-op.tmpl</DT>
+<DD>This is the template that is used to display an error message when
+ the job interface sees an undefined operation name.</DD>
+<DT>job-release.tmpl</DT>
+<DD>This template shows "job released".</DD>
+<DT>job-restart.tmpl</DT>
+<DD>This template shows "job restarted".</DD>
+<DT>jobs.tmpl</DT>
+<DD>This template is used to list the print jobs on a server, class, or
+ printer.</DD>
+<DT>modify-class.tmpl</DT>
+<DD>This template is used as the first form when modifying a class.</DD>
+<DT>modify-printer.tmpl</DT>
+<DD>This template is used as the first form when modifying a printer.</DD>
+<DT>option-boolean.tmpl</DT>
+<DD>This template is used to select a boolean PPD option.</DD>
+<DT>option-header.tmpl</DT>
+<DD>This template is used to start a PPD option group.</DD>
+<DT>option-pickmany.tmpl</DT>
+<DD>This template is used to select a multi-valued PPD option.</DD>
+<DT>option-pickone.tmpl</DT>
+<DD>This template is used to select a single-valued PPD option.</DD>
+<DT>option-trailer.tmpl</DT>
+<DD>This template is used to end a PPD option group.</DD>
+<DT>printer-accept.tmpl</DT>
+<DD>This template shows "printer now accepting jobs".</DD>
+<DT>printer-added.tmpl</DT>
+<DD>This template shows "printer added".</DD>
+<DT>printer-configured.tmpl</DT>
+<DD>This template shows "printer configured".</DD>
+<DT>printer-confirm.tmpl</DT>
+<DD>This template asks the user to confirm the deletion of a printer.</DD>
+<DT>printer-deleted.tmpl</DT>
+<DD>This template shows "printer deleted".</DD>
+<DT>printer-modified.tmpl</DT>
+<DD>This template shows "printer modified".</DD>
+<DT>printer-purge.tmpl</DT>
+<DD>This template shows "printer has been purged of all jobs".</DD>
+<DT>printer-reject.tmpl</DT>
+<DD>This template shows "printer now rejecting jobs".</DD>
+<DT>printer-start.tmpl</DT>
+<DD>This template shows "printer started".</DD>
+<DT>printers.tmpl</DT>
+<DD>This template is used to list information on one or more printers.</DD>
+<DT>printer-stop.tmpl</DT>
+<DD>This template shows "printer stopped".</DD>
+<DT>test-page.tmpl</DT>
+<DD>This template shows "test page printed".</DD>
+<DT>trailer.tmpl</DT>
+<DD>This template is used as the standard trailer on all dynamic
+ content.</DD>
+</DL>
+<H2><A NAME="5_2">5.2 CGI Programs</A></H2>
+<P>CUPS uses four CGI programs to manage the dynamic web interfaces:</P>
+<UL>
+<LI><CODE>admin.cgi</CODE></LI>
+<LI><CODE>classes.cgi</CODE></LI>
+<LI><CODE>jobs.cgi</CODE></LI>
+<LI><CODE>printers.cgi</CODE></LI>
+</UL>
+<H3><A NAME="5_2_1">5.2.1 admin.cgi</A></H3>
+<P>The <CODE>admin.cgi</CODE> program handles all of the printer and
+ class administration functions and is run for all direct accesses to
+ the<VAR> /admin</VAR> resource. For most operations it uses the <CODE>
+PRINTER_NAME</CODE> and <CODE>OP</CODE> form variables to specify the
+ action requested.</P>
+<P>The following <CODE>OP</CODE> values are supported:</P>
+<DL>
+<DT>accept-jobs</DT>
+<DD>Accepts jobs on the named destination.</DD>
+<DT>add-class</DT>
+<DD>Adds a new printer class. This operation also adds several other
+ form variables:
+<DL>
+<DT>MEMBER_URIS</DT>
+<DD>Sets the members of the class. Multiple <CODE>MEMBER_URIS</CODE>
+ values can be provided.</DD>
+<DT>PRINTER_INFO</DT>
+<DD>Sets the printer-info attribute for the printer class, which is
+ usually the printer description.</DD>
+<DT>PRINTER_LOCATION</DT>
+<DD>Sets the printer-location attribute for the printer class.</DD>
+</DL>
+</DD>
+<DT>add-printer</DT>
+<DD>Adds a new printer. This operation also adds several other form
+ variables:
+<DL>
+<DT>BAUDRATE</DT>
+<DD>Sets the baud rate for serial devices.</DD>
+<DT>BITS</DT>
+<DD>Sets the number of data bits for serial devices.</DD>
+<DT>DEVICE_URI</DT>
+<DD>Sets the device URI for the printer.</DD>
+<DT>FLOW</DT>
+<DD>Sets the flow control for serial devices.</DD>
+<DT>PARITY</DT>
+<DD>Sets the parity checking for serial devices.</DD>
+<DT>PPD_NAME</DT>
+<DD>Sets the driver name for the printer ("raw" for a raw queue.)</DD>
+<DT>PRINTER_INFO</DT>
+<DD>Sets the printer-info attribute for the printer, which is usually
+ the printer description.</DD>
+<DT>PRINTER_LOCATION</DT>
+<DD>Sets the printer-location attribute for the printer.</DD>
+</DL>
+</DD>
+<DT>config-printer</DT>
+<DD>Configures an existing printer. This operation uses form variables
+ of the same name as the options in the printer's PPD file.</DD>
+<DT>delete-class</DT>
+<DD>Deletes a printer class. The form variable <CODE>CONFIRM</CODE> may
+ be set to any value to bypass the confirmation page.</DD>
+<DT>delete-printer</DT>
+<DD>Deletes a printer. The form variable <CODE>CONFIRM</CODE> may be set
+ to any value to bypass the confirmation page.</DD>
+<DT>modify-class</DT>
+<DD>Modifies a printer class. See the add-class operation for a list of
+ form variables.</DD>
+<DT>modify-printer</DT>
+<DD>Modifies a printer. See the add-printer operation for a list of form
+ variables.</DD>
+<DT>purge-jobs</DT>
+<DD>Purges all jobs on the named destination.</DD>
+<DT>reject-jobs</DT>
+<DD>Rejects new jobs on the named destination.</DD>
+<DT>start-printer</DT>
+<DD>Starts the named destination.</DD>
+<DT>stop-printer</DT>
+<DD>Stops the named destination.</DD>
+</DL>
+<H3><A NAME="5_2_2">5.2.2 classes.cgi</A></H3>
+<P>The <CODE>classes.cgi</CODE> program is responsible for listing class
+ information, including jobs destined for that class. It is for all
+ direct accesses to the<VAR> /classes</VAR> resource and supports the
+ optional form variables <CODE>OP</CODE> and <CODE>WHICH_JOBS</CODE>. If
+ no form variables are supplied then the CGI lists all or a specific
+ class and the active jobs on each class.</P>
+<P>The following <CODE>WHICH_JOBS</CODE> values are supported:</P>
+<DL>
+<DT>completed</DT>
+<DD>Show only the completed jobs.</DD>
+<DT>not-completed</DT>
+<DD>Show only the active jobs.</DD>
+</DL>
+<P>The following <CODE>OP</CODE> values are supported:</P>
+<DL>
+<DT>print-test-page</DT>
+<DD>Print a PostScript test page.</DD>
+</DL>
+<H3><A NAME="5_2_3">5.2.3 jobs.cgi</A></H3>
+<P>The <CODE>jobs.cgi</CODE> program handles all of the job functions
+ and is run for all direct accesses to the<VAR> /jobs</VAR> resource.
+ For most operations it uses the <CODE>JOB_ID</CODE>, <CODE>OP</CODE>,
+ and <CODE>WHICH_JOBS</CODE> form variables to specify the action
+ requested.</P>
+<P>The following <CODE>WHICH_JOBS</CODE> values are supported:</P>
+<DL>
+<DT>completed</DT>
+<DD>Show only the completed jobs.</DD>
+<DT>not-completed</DT>
+<DD>Show only the active jobs.</DD>
+</DL>
+<P>The following <CODE>OP</CODE> values are supported:</P>
+<DL>
+<DT>job-cancel</DT>
+<DD>Cancels a job.</DD>
+<DT>job-hold</DT>
+<DD>Holds a job indefinitely.</DD>
+<DT>job-release</DT>
+<DD>Releases a job for printing.</DD>
+<DT>job-restart</DT>
+<DD>Restarts a stopped, cancelled, completed, or aborted print job.</DD>
+</DL>
+<H3><A NAME="5_2_4">5.2.4 printers.cgi</A></H3>
+<P>The <CODE>printers.cgi</CODE> program is responsible for listing
+ printer information, including jobs destined for that printer. It is
+ for all direct accesses to the<VAR> /printers</VAR> resource and
+ supports the optional form variables <CODE>OP</CODE> and <CODE>
+WHICH_JOBS</CODE>. If no form variables are supplied then the CGI lists
+ all or a specific printer and the active jobs on each printer.</P>
+<P>The following <CODE>WHICH_JOBS</CODE> values are supported:</P>
+<DL>
+<DT>completed</DT>
+<DD>Show only the completed jobs.</DD>
+<DT>not-completed</DT>
+<DD>Show only the active jobs.</DD>
+</DL>
+<P>The following <CODE>OP</CODE> values are supported:</P>
+<DL>
+<DT>print-test-page</DT>
+<DD>Print a PostScript test page.</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>
+<DT>C</DT>
+<DD>A computer language.</DD>
+<DT>parallel</DT>
+<DD>Sending or receiving data more than 1 bit at a time.</DD>
+<DT>pipe</DT>
+<DD>A one-way communications channel between two programs.</DD>
+<DT>serial</DT>
+<DD>Sending or receiving data 1 bit at a time.</DD>
+<DT>socket</DT>
+<DD>A two-way network communications channel.</DD>
+</DL>
+<H2><A NAME="6_2">A.2 Acronyms</A></H2>
+<DL>
+<DT>ASCII</DT>
+<DD>American Standard Code for Information Interchange</DD>
+<DT>CUPS</DT>
+<DD>Common UNIX Printing System</DD>
+<DT>ESC/P</DT>
+<DD>EPSON Standard Code for Printers</DD>
+<DT>FTP</DT>
+<DD>File Transfer Protocol</DD>
+<DT>HP-GL</DT>
+<DD>Hewlett-Packard Graphics Language</DD>
+<DT>HP-PCL</DT>
+<DD>Hewlett-Packard Page Control Language</DD>
+<DT>HP-PJL</DT>
+<DD>Hewlett-Packard Printer Job Language</DD>
+<DT>IETF</DT>
+<DD>Internet Engineering Task Force</DD>
+<DT>IPP</DT>
+<DD>Internet Printing Protocol</DD>
+<DT>ISO</DT>
+<DD>International Standards Organization</DD>
+<DT>LPD</DT>
+<DD>Line Printer Daemon</DD>
+<DT>MIME</DT>
+<DD>Multimedia Internet Mail Exchange</DD>
+<DT>PPD</DT>
+<DD>PostScript Printer Description</DD>
+<DT>SMB</DT>
+<DD>Server Message Block</DD>
+<DT>TFTP</DT>
+<DD>Trivial File Transfer Protocol</DD>
+</DL>
+</BODY>
+</HTML>
projects / thirdparty / cups.git / blobdiff