Merge changes from CUPS 1.4svn-r7582.

git-svn-id: svn+ssh://src.apple.com/svn/cups/easysw/current@768 a1ca3aef-8c08-0410-bb20-df032aa958be
author: msweet <msweet@a1ca3aef-8c08-0410-bb20-df032aa958be> 2008-05-16 03:15:15 +0000
committer: msweet <msweet@a1ca3aef-8c08-0410-bb20-df032aa958be> 2008-05-16 03:15:15 +0000
commit: 01ce6322ca3809ac0260c8ef28abbc8255f6e34f (patch)
tree: b65c4278e38f0a6f1aac239f3654636d51d0889b /doc
parent: 3c8c76971a30d42417c0152f83bf8786185442e4 (diff)
6 files changed, 359 insertions, 85 deletions
diff --git a/doc/help/ref-cupsd-conf.html.in b/doc/help/ref-cupsd-conf.html.in
index 07ba7ad51..46ad1027b 100644
--- a/doc/help/ref-cupsd-conf.html.in
+++ b/doc/help/ref-cupsd-conf.html.in
@@ -2134,6 +2134,48 @@ default page log file is <VAR>@CUPS_LOGDIR@/page_log</VAR>.</P>
 information to the system log instead of a plain file.</P>
 
 
+<H2 CLASS="title"><A NAME="PageLogFormat">PageLogFormat</A></H2>
+
+<H3>Examples</H3>
+
+<PRE CLASS="command">
+PageLogFormat %p %j %u %T %P %C %{job-billing} %{job-originating-host-name} %{job-name} %{media} %{sides}
+PageLogFormat PAGE %p %j %u %P %C %{job-billing} %{job-originating-host-name}
+</PRE>
+
+<H3>Description</H3>
+
+<P>The <CODE>PageLogFormat</CODE> directive sets the format of lines
+that are logged to the page log file. Sequences beginning with percent (%)
+characters are replaced with the corresponding information, while all other
+characters are copied literally. The following percent sequences are
+recognized:</P>
+
+<UL>
+
+	<LI><CODE>%%</CODE>: Inserts a single percent character.</LI>
+
+	<LI><CODE>%{name}</CODE>: Inserts the value of the specified IPP
+	attribute.</LI>
+
+	<LI><CODE>%C</CODE>: Inserts the number of copies for the current page.</LI>
+
+	<LI><CODE>%P</CODE>: Inserts the current page number.</LI>
+
+	<LI><CODE>%T</CODE>: Inserts the current date and time in common log
+	format.</LI>
+
+	<LI><CODE>%j</CODE>: Inserts the job ID.</LI>
+
+	<LI><CODE>%p</CODE>: Inserts the printer name.</LI>
+
+	<LI><CODE>%u</CODE>: Inserts the username.</LI>
+
+</UL>
+
+<P>The default is "%p %j %u %T %P %C %{job-billing} %{job-originating-host-name} %{job-name} %{media} %{sides}".</P>
+
+
 <H2 CLASS="title"><SPAN CLASS="info">CUPS 1.2</SPAN><A NAME="PassEnv">PassEnv</A></H2>
 
 <H3>Examples</H3>
diff --git a/doc/help/ref-page_log.html b/doc/help/ref-page_log.html
index f57180f7e..fa2bd1dc1 100644
--- a/doc/help/ref-page_log.html
+++ b/doc/help/ref-page_log.html
@@ -6,20 +6,23 @@
 <BODY>
 
 <P>The <VAR>page_log</VAR> file lists each page that is sent to a
-printer. Each line contains the following information:</P>
+printer. By default, each line contains the following information:</P>
 
 <P CLASS="command">
 
-printer user job-id date-time page-number num-copies job-billing<BR>
+printer user job-id date-time page-number num-copies job-billing job-originating-host-name job-name media sides<BR>
 
 <BR>
 
-DeskJet root 2 [20/May/1999:19:21:05 +0000] 1 1 acme-123<BR>
+DeskJet root 2 [20/May/1999:19:21:05 +0000] 1 1 acme-123 localhost myjob letter one-sided<BR>
 
-DeskJet root 2 [20/May/1999:19:21:05 +0000] 2 1 acme-123<BR>
+DeskJet root 2 [20/May/1999:19:21:05 +0000] 2 1 acme-123 localhost myjob letter one-sided<BR>
 
 </P>
 
+<p>The <a href="ref-cupsd_conf.html#PageLogFormat"><code>PageLogFormat</code></a>
+directive can be used to change this information.</p>
+
 <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
@@ -49,5 +52,23 @@ printers that cannot produce copies on their own, the
 <CODE>Create-Job</CODE> or <CODE>Print-Job</CODE> requests or "-"
 if none was provided.
 
+<P>The <I>job-originating-host-name</I> field contains the hostname or IP
+address of the client that printed the job.</P>
+
+<P>The <I>job-name</I> field contains a copy of the
+<CODE>job-name</CODE> attribute provided with the IPP
+<CODE>Create-Job</CODE> or <CODE>Print-Job</CODE> requests or "-"
+if none was provided.
+
+<P>The <I>media</I> field contains a copy of the
+<CODE>media</CODE> attribute provided with the IPP
+<CODE>Create-Job</CODE> or <CODE>Print-Job</CODE> requests or "-"
+if none was provided.
+
+<P>The <I>sides</I> field contains a copy of the
+<CODE>sides</CODE> attribute provided with the IPP
+<CODE>Create-Job</CODE> or <CODE>Print-Job</CODE> requests or "-"
+if none was provided.
+
 </BODY>
 </HTML>
diff --git a/doc/help/spec-command.html b/doc/help/spec-command.html
index 8847203d2..7abb3adea 100644
--- a/doc/help/spec-command.html
+++ b/doc/help/spec-command.html
@@ -13,6 +13,7 @@
   CUPS command file format specification for the Common UNIX Printing
   System (CUPS).
 
+  Copyright 2007-2008 by Apple Inc.
   Copyright 1997-2006 by Easy Software Products.
 
   These coded instructions, statements, and computer programs are the
@@ -47,6 +48,23 @@ can determine if a printer supports printing of CUPS command
 files by checking the <code>printer-type</code> attribute for the
 <code>CUPS_PRINTER_COMMANDS</code> capability bit.</p>
 
+<p>In addition, the PPD file for a printer can contain a
+<code>cupsCommands</code> keyword that provides a list of supported
+commands separated by spaces, for example:</p>
+
+<pre class='command'>
+*cupsCommand: "AutoConfigure Clean PrintSelfTestPage ReportLevels"
+</pre>
+
+<p>If no <code>cupsCommands</code> keyword is provided, the command filter
+must support <a href='#AutoConfigure'><code>AutoConfigure</code></a>,
+<a href='#Clean'><code>Clean</code></a>,
+<a href='#PrintSelfTestPage'><code>PrintSelfTestPage</code></a>,
+and <a href='#ReportLevels'><code>ReportLevels</code></a>. The scheduler also
+provides the <code>printer-commands</code> attribute containing the list of
+supported commands.</p>
+
+
 <h2 class='title'><a name='SYNTAX'>File Syntax</a></h2>
 
 <p>CUPS command files are ASCII text files.  The first line of a
@@ -63,25 +81,57 @@ Comments begin with the # character, e.g.:</p>
 # This is a comment
 </pre>
 
-<p>The printer commands are described below. Printer commands are
-case-insensitive, so "PRINTSELFTESTPAGE", "printselftestpage",
-and "PrintSelfTestPage" are equivalent. Commands that accept
-arguments have their arguments on the same line separated by
-whitespace.</p>
+<p>Commands are any sequence of letters, numbers, and punctuation characters
+optionally followed by parameters separated by whitespace, e.g.:</p>
+
+<pre class='command'>
+Clean all
+PrintSelfTestPage
+</pre>
+
+<p>Command names are case-insensitive, so "PRINTSELFTESTPAGE",
+"printselftestpage", and "PrintSelfTestPage" are equivalent. Vendor-specific
+commands should use a domain name prefix, e.g.:</p>
+
+<pre class='command'>
+com.vendor.foo
+com.vendor.bar param param2 ... paramN
+</pre>
+
+
+<h2 class='title'><a name='COMMANDS'>Standard Commands</a></h2>
 
-<h2 class='title'><a name='COMMANDS'>Commands</a></h2>
+<p>The following are the standard commands supported by the format. The only
+required command is
+<a href='#PrintSelfTestPage'><code>PrintSelfTestPage</code></a>.</p>
 
-<h3>Clean</h3>
 
-<p class='summary'>Clean colorname</p>
+<h3><a name='AutoConfigure'>AutoConfigure</a></h3>
 
-<p>Does a standard print head cleaning.  If a printer does not
-support cleaning of individual colors or cartridges, then all
-print heads are cleaned. Command filters MUST support the "all"
-colorname. Other standard color names include "black", "color",
-"photo", "cyan", "magenta", "yellow", "light-cyan",
-"light-magenta", "light-black", "light-gray", and
-"dark-gray".</p>
+<p class='summary'>AutoConfigure</p>
+
+<p>The <code>AutoConfigure</code> command updates the printer's PPD file
+and driver state information to reflect the current configuration of the
+printer. There are no arguments for this command.</p>
+
+<p>Example:</p>
+
+<pre class='command'>
+#CUPS-COMMAND
+AutoConfigure
+</pre>
+
+
+<h3><a name='Clean'>Clean</a></h3>
+
+<p class='summary'>Clean <i>colorname</i></p>
+
+<p>The <code>Clean</code> command performs a standard print head cleaning. The
+"colorname" parameter specifies which color or head to clean. If a printer does
+not support cleaning of individual colors or cartridges, then all colors are
+cleaned. Command filters MUST support the "all" colorname. Other standard color
+names include "black", "color", "photo", "cyan", "magenta", "yellow",
+"light-cyan", "light-magenta", "light-black", "light-gray", and "dark-gray".</p>
 
 <p>Example:</p>
 
@@ -90,12 +140,30 @@ colorname. Other standard color names include "black", "color",
 Clean all
 </pre>
 
-<h3>PrintSelfTestPage</h3>
+
+<h3><a name='PrintAlignmentPage'>PrintAlignmentPage</a></h3>
+
+<p class='summary'>PrintAlignmentPage pass</p>
+
+<p>The <code>PrintAlignmentPage</code> command prints a head alignment page on
+the printer. The "pass" parameter provides a pass number from 1 to N. The number
+of passes is device-dependent.</p>
+
+<p>Example:</p>
+
+<pre class='command'>
+#CUPS-COMMAND
+PrintAlignmentPage 1
+</pre>
+
+
+<h3><a name='PrintSelfTestPage'>PrintSelfTestPage</a></h3>
 
 <p class='summary'>PrintSelfTestPage</p>
 
-<p>Print a self-test page on the printer. Typically this page
-shows if all jets on a print head are functioning properly.</p>
+<p>The <code>PrintSelfTestPage</code> command prints a self-test page on the
+printer. Typically this page shows whether all jets on a print head are
+functioning and that the print feed mechanisms are working properly.</p>
 
 <p>Example:</p>
 
@@ -104,5 +172,38 @@ shows if all jets on a print head are functioning properly.</p>
 PrintSelfTestPage
 </pre>
 
+
+<h3><a name='ReportLevels'>ReportLevels</a></h3>
+
+<p class='summary'>ReportLevels</p>
+
+<p>The <code>ReportLevels</code> command queries the supply levels on a printer
+and reports "marker-colors", "marker-levels", "marker-names", and
+"marker-types" attributes using "ATTR:" messages sent to the scheduler.</p>
+
+<p>Example:</p>
+
+<pre class='command'>
+#CUPS-COMMAND
+ReportLevels
+</pre>
+
+
+<h3><a name='SetAlignment'>SetAlignment</a></h3>
+
+<p class='summary'>SetAlignment pass value ... valueN</p>
+
+<p>The <code>SetAlignment</code> command sets print head alignment values. The
+"pass" parameter is a number from 1 to N. All parameters are
+device-dependent.</p>
+
+<p>Example:</p>
+
+<pre class='command'>
+#CUPS-COMMAND
+SetAlignment 1 14
+</pre>
+
+
 </body>
 </html>
diff --git a/doc/help/spec-ipp.html b/doc/help/spec-ipp.html
index e5d0f3762..344ba67af 100644
--- a/doc/help/spec-ipp.html
+++ b/doc/help/spec-ipp.html
@@ -2574,6 +2574,12 @@ to this printer. The default port monitor is "none".
 
 <p>The port-monitor-supported attribute specifies the available port monitors.
 
+<h4><a name="printer-commands">printer-commands (1setOf Type3 keyword)</a><span class='info'>CUPS 1.4</span></h4>
+
+<p>The printer-commands attribute specifies the commands that are supported
+by the CUPS command file filter. The keyword "none" indicates that no commands
+are supported.</p>
+
 <h4><a name="printer-dns-sd-name">printer-dns-sd-name (name(MAX) | noValue)</a><span class='info'>CUPS 1.4</span></h4>
 
 <p>The printer-dns-sd-name attribute specifies the registered DNS-SD service
diff --git a/doc/help/spec-ppd.html b/doc/help/spec-ppd.html
index dc73164e0..435393a9f 100644
--- a/doc/help/spec-ppd.html
+++ b/doc/help/spec-ppd.html
@@ -164,7 +164,7 @@ and resources permit.</p>
 
 </blockquote>
 
-<h3><a name='cupsColorProfile'>cupsColorProfile</a></h3>
+<h3><span class='info'>Deprecated</span><a name='cupsColorProfile'>cupsColorProfile</a></h3>
 
 <p class='summary'>*cupsColorProfile Resolution/MediaType: "density
 gamma m00 m01 m02 m10 m11 m12 m20 m21 m22"</p>
@@ -208,6 +208,7 @@ function is applied <i>after</i> the CMY transformation:</p>
 *cupsColorProfile -/-: "0.9 2.0 1.0 0.0 -0.2 -0.4 1.0 0.0 -0.2 0.0 1.0"
 </pre>
 
+
 <h3><span class='info'>Mac OS X 10.3/CUPS 1.2</span><a name='cupsICCProfile'>cupsICCProfile</a></h3>
 
 <p class='summary'>*cupsICCProfile
@@ -1048,6 +1049,22 @@ will be ignored.</p>
 <p>Also see the related <a href='#APDuplexRequiresFlippedMargin'><tt>APDuplexRequiresFlippedMargin</tt></a>
 attribute.</p>
 
+<h3><span class='info'>CUPS 1.4</span><a name='cupsCommands'>cupsCommands</a></h3>
+
+<p class='summary'>*cupsCommands: "name name2 ... nameN"</p>
+
+<p>This string attribute specifies the commands that are supported by the
+CUPS command file filter for this device. The command names are separated
+by whitespace.</p>
+
+<p>Example:</p>
+
+<pre class='command'>
+<em>*% Specify the list of commands we support</em> 
+*cupsCommands: "AutoConfigure Clean PrintSelfTestPage ReportLevels com.vendor.foo"
+</pre>
+
+
 <h3><span class='info'>CUPS 1.3</span><a name='cupsEvenDuplex'>cupsEvenDuplex</a></h3>
 
 <p class='summary'>*cupsEvenDuplex: boolean</p>
@@ -1613,6 +1630,8 @@ the device.</p>
 
 	<li>Added <tt>cupsMarkerName</tt> attribute.</li>
 
+	<li>Added <tt>cupsCommands</tt> attribute.</li>
+
 </ul>
 
 
diff --git a/doc/help/whatsnew.html b/doc/help/whatsnew.html
index d490f706a..7a6ed2745 100644
--- a/doc/help/whatsnew.html
+++ b/doc/help/whatsnew.html
@@ -1,127 +1,212 @@
 <HTML>
 <!-- SECTION: Getting Started -->
 <HEAD>
-	<TITLE>What's New in CUPS 1.3</TITLE>
+	<TITLE>What's New in CUPS 1.4</TITLE>
 </HEAD>
 <BODY>
 
-<P>CUPS 1.3 adds over 30 changes and new features to CUPS 1.2.x.
-This page provides a high-level outline of these changes. If you
-have never used CUPS before, read the <A
-HREF="overview.html">"Overview of CUPS"</A> document instead.</P>
+<P>CUPS 1.4 adds over ?? changes and new features to CUPS 1.3.x. This page provides a high-level outline of these changes. If you have never used CUPS before, read the <A HREF="overview.html">"Overview of CUPS"</A> document instead.</P>
 
-<H2 CLASS="title"><A NAME="CHANGES">Changes in CUPS 1.3</A></H2>
+<H2 CLASS="title"><A NAME="COMMANDS">Commands</A></H2>
 
-<DL CLASS="category">
+<OL START="1">
 
-	<DT>Networking</DT>
-	<DD><OL START="1">
+	<LI><EM>lppasswd;</EM> the lppasswd program is no longer installed setuid by default.</LI>
 
-		<LI><EM>Kerberos;</EM> CUPS now supports Kerberos authentication</LI>
+	<LI><EM>cupsfilter;</EM> the cupsfilter program now supports filtering of already-queued print job files.</LI>
 
-		<LI><EM>Mac OS X Authorization Services;</EM> CUPS now supports the Authorization Services framework, providing role-based access control in addition to the tradition UNIX model</LI>
+	<LI><EM>;</EM> </LI>
 
-		<LI><EM>Peer Credentials;</EM> CUPS now supports authentication using peer credentials provided over UNiX domain sockets</LI>
+	<LI><EM>;</EM> </LI>
 
-		<LI><EM>SNMP Support;</EM> SNMP lookups are no longer performed by default, and IPP is no longer used for discovered printers</LI>
+	<LI><EM>;</EM> </LI>
 
-		<LI><EM>LPD Support;</EM> The LPD backend now supports a faster streaming mode that does not require a temporary file</LI>
+</OL>
 
-	</OL></DD>
 
+<H2 CLASS="title"><A NAME="WEBIF">Web Interface</A></H2>
 
-	<DT>Browsing</DT>
-	<DD><OL START="6">
+<OL START="1">
 
-		<LI><EM>CUPS Browsing;</EM> The default configuration now shows shared printers from any address (not just <tt>@LOCAL</tt>)</LI>
+	<LI><EM>Look-n-feel;</EM> the web interface has been given a new look with a new CUPS logo.</LI>
 
-		<LI><EM>DNS-SD (Bonjour/Zeroconf) Support;</EM> CUPS
-		now supports printer sharing via DNS service discovery</LI>
+	<LI><EM>Security;</EM> the web interface has been updated to require authentication for printing of test pages and RSS subscription operations.</LI>
 
-		<LI><EM>LDAP w/SSL;</EM> CUPS now supports encrypted LDAP sessions</LI>
+	<LI><EM>Printer sharing;</EM> the "share printer" and "unshare printer" buttons are now only shown when printer sharing is enabled in the scheduler.</LI>
 
-	</OL></DD>
+	<LI><EM>Printer configuration;</EM> improvements have been made to the add and modify printer pages.</LI>
 
+	<LI><EM>;</EM> </LI>
 
-	<DT>Web Interface</DT>
-	<DD><OL START="9">
+	<LI><EM>;</EM> </LI>
 
-		<LI><EM>Internet Printer Sharing;</EM> You can now share printers over the Internet via the basic server settings</LI>
+	<LI><EM>;</EM> </LI>
 
-		<LI><EM>Improved On-Line Help;</EM> Searching the on-line help now shows results for all text, not just headings and links</LI>
+	<LI><EM>;</EM> </LI>
 
-		<LI><EM>Printer Setup;</EM> The available printer list is now only show when requested and the <VAR>Add This Printer</VAR> button now allows you to change the default name, location, and description</LI>
+</OL>
 
-		<LI><EM>Printer Configuration;</EM> Raw printers and classes can now be configured using the <var>Set Printer Options</var> button</LI>
 
-	</OL></DD>
+<H2 CLASS="title"><A NAME="NETWORKING">Networking</A></H2>
 
+<OL START="1">
 
-	<DT>IPP Support</DT>
-	<DD><OL START="13"></EM></LI>
+	<LI><EM>Bonjour (DNS-SD) printing support;</EM> a new mdns backend provides Bonjour-based printer discovery and the ipp, lpd, and socket backends now support Bonjour address resolution.</LI>
 
-		<LI><EM>Job Printer Attributes;</EM> CUPS now provides <tt>job-printer-state-message</tt> and <tt>job-printer-state-reasons</tt> attributes containing copies of the corresponding printer attributes to provide important history information with each job</LI>
+	<LI><EM>Bonjour (DNS-SD) perforance tuning;</EM> the scheduler now only uses a single file descriptor for printer sharing. It previously used one per printer.</LI>
 
-		<LI><EM>PPD Operations and Attributes;</EM> The new CUPS_GET_PPD operation allows you to retrieve PPD files from the scheduler; also, CUPS_GET_PPDS now reports more information and supports more value filters</LI>
+	<LI><EM>Bonjour (DNS-SD) web interface registry;</EM> when remote access is enabled, the scheduler registers the web interface for easier access</LI>
 
-		<LI><EM>Printer Defaults;</EM> The <tt>document-forma-default</tt>, <tt>notify-events-default</tt>, and <tt>notify-lease-duration-default</tt> attributes can be set for each printer and class</LI>
+	<LI><EM>SNMP-based monitoring;</EM> the ipp, lpd, and socket backends now report supply levels and printer status using SNMP queries.</LI>
 
-		<LI><EM>PWG Printer Alert Support;</EM> CUPS now supports the <tt>printer-alert</tt> and <tt>printer-alert-description</tt> attributes</LI>
+	<LI><EM>SNMP port monitor MIB;</EM> the ipp, lpd, snmp, and socket now support the PWG port monitor MIB</LI>
 
-		<LI><EM>Server-Side Options;</EM> Server-side default options can now be retrieved using the "printer-defaults" group keyword</LI>
+	<LI><EM>;</EM> </LI>
 
-	</OL></DD>
+	<LI><EM>;</EM> </LI>
 
+</OL>
 
-	<DT>Scheduler</DT>
-	<DD><OL START="18">
 
-		<LI><EM>Client Support;</EM> The scheduler now uses <tt>poll()</tt>, <tt>epoll()</tt>, or <var>/dev/kqueue</var> on platforms that provide them to support large numbers of clients</LI>
+<H2 CLASS="title"><A NAME="IPP">IPP Support</A></H2>
 
-		<LI><EM>"Default" Authentication;</EM> You can now specify an <tt>AuthType</tt> of <tt>Default</tt> in locations and policies, which maps to the <tt>DefaultAuthType</tt> value</LI>
+<OL START="1"></EM></LI>
 
-		<LI><EM>Larger Numbers of Clients;</EM> The scheduler now uses poll(), epoll(), or /dev/kqueue instead of select() when possible</LI>
+	<LI><EM>CUPS-Get-Document operation;</EM> the scheduler now supports a "get document" operation to download files from a print job.</LI>
 
-		<LI><EM>New cupsctl Command;</EM> The new cupsctl command allows you to perform basic server configuration from the command-line</LI>
+	<LI><EM>;</EM> </LI>
 
-	</OL></DD>
+	<LI><EM>;</EM> </LI>
 
+	<LI><EM>;</EM> </LI>
 
-	<DT>Printer Drivers</DT>
-	<DD><OL START="22">
+	<LI><EM>;</EM> </LI>
 
-		<LI><EM>cupstestppd Improvements;</EM> The test utility now provides more extensive tests and options</LI>
+	<LI><EM>;</EM> </LI>
 
-		<LI><EM>Label Printer Driver;</EM> Added support for the Intellibar label printers</LI>
+</OL>
 
-		<LI><EM>Localized Printer Drivers;</EM> The CUPS sample drivers are now localized in several languages</LI>
 
-		<LI><EM>PJL Support;</EM> New <tt>cupsPJLCharset</tt> attribute controls character set for PJL strings</LI>
+<H2 CLASS="title"><A NAME="SCHEDULER">Scheduler</A></H2>
 
-		<LI><EM>Pre-Filter Support;</EM> Drivers can now register format-specific filters to pre-screen print jobs</LI>
+<OL START="1">
 
-		<LI><EM>Side-Channel API;</EM> This new API provides out-of-band control of devices</LI>
+	<LI><EM>Performance tuning;</EM> the scheduler now coalesces  configuration and state file changes to reduce the amount of disk activity.</LI>
 
-	</OL></DD>
+	<LI><EM>Configuration files;</EM> the default cupsd.conf file now provides an "authenticated" policy for easy authenticated sharing of printers.</LI>
 
+	<LI><EM>Seatbelt support;</EM> the scheduler now runs child processes using restrictive policies on Mac OS X for improved security and job isolation.</LI>
 
-	<DT>CUPS API</DT>
-	<DD><OL START="28">
+	<LI><EM>PAM support;</EM> the scheduler now sets more PAM attributes to better support third-party authentication schemes.</LI>
 
-		<LI><EM>Administration API;</EM> New <tt>cupsAdminGetServerSettings()</tt> and <tt>cupsAdminSetServerSettings()</tt> functions</LI>
+	<LI><EM>Test option;</EM> the scheduler now supports a test mode via the "-t" option.</LI>
 
-		<LI><EM>Array API;</EM> New <tt>cupsArrayGetIndex()</tt>, <tt>cupsArrayGetInsert()</tt>, and <tt>cupsArrayNew2()</tt> functions</LI>
+	<LI><EM>Page logging;</EM> the scheduler now supports a <code>PageLogFormat</code> directive to control the format of the page_log file.</LI>
 
-		<LI><EM>Destination API;</EM> New <tt>cupsRemoveDest()</tt> and <tt>cupsSetDefaultDest()</tt> functions</LI>
+	<LI><EM>;</EM> </LI>
 
-		<LI><EM>HTTP API;</EM> The <tt>http_t</tt> structure is now completely private</LI>
+	<LI><EM>;</EM> </LI>
 
-		<LI><EM>PPD API;</EM> New <tt>ppdLocalizeIPPReason()</tt>function and greatly improved <tt>ppdConflicts()</tt> performance</LI>
+	<LI><EM>;</EM> </LI>
 
-	</OL></DD>
+	<LI><EM>;</EM> </LI>
 
+	<LI><EM>;</EM> </LI>
+
+</OL>
+
+
+<H2 CLASS="title"><A NAME="DRIVERS">Printer Drivers</A></H2>
+
+<OL START="1">
+
+	<LI><EM>Dynamic PPD support;</EM> drivers can now set PPD keywords
+	dynamically using <code>PPD:</code> messages.</LI>
+
+	<LI><EM>Generic PostScript command filter;</EM> a new CUPS command file filter for PostScript printers provides auto-configuration, self-test page, and status and supply level reporting functions.</LI>
+
+	<LI><EM>PJL support;</EM> the cupsPJLDisplay PPD attribute controls the PJL commands used to display the current user and job on the printer.</LI>
+
+	<LI><EM>Driver development kit;</EM> the CUPS DDK is now a standard part of CUPS</LI>
+
+	<LI><EM>PPD compiler improvements;</EM> the PPD compiler now supports Mac OS X .strings files for localization and ... </LI>
+
+	<LI><EM>Generic PostScript and PCL drivers;</EM> new generic PostScript and PCL drivers provide improved support for laser printers.</LI>
+
+	<LI><EM>;</EM> </LI>
+
+	<LI><EM>;</EM> </LI>
+
+	<LI><EM>;</EM> </LI>
+
+	<LI><EM>;</EM> </LI>
+
+	<LI><EM>;</EM> </LI>
+
+	<LI><EM>;</EM> </LI>
+
+	<LI><EM>;</EM> </LI>
+
+	<LI><EM>;</EM> </LI>
+
+	<LI><EM>;</EM> </LI>
+
+	<LI><EM>;</EM> </LI>
+
+	<LI><EM>;</EM> </LI>
+
+	<LI><EM>;</EM> </LI>
+
+</OL>
+
+
+<H2 CLASS="title"><A NAME="FILTERS">Print Filters</A></H2>
+
+<OL START="1">
+
+	<LI><EM>Image filters;</EM> the standard image filters now support image files larger than 2GB.</LI>
+
+	<LI><EM>Device discovery;</EM> the cups-deviced helper now runs backends in parallel for faster discovery and streams the results of discovery as the backends provide them.</LI>
+
+	<LI><EM>PDF filter;</EM> the pdftops filter has been replaced with a wrapper program that runs the Xpdf, poppler, or Ghostscript PDF to PostScript utilities.</LI>
+
+	<LI><EM>;</EM> </LI>
+
+	<LI><EM>;</EM> </LI>
+
+	<LI><EM>;</EM> </LI>
+
+	<LI><EM>;</EM> </LI>
+
+</OL>
+
+
+<H2 CLASS="title"><A NAME="CUPSAPI">CUPS API</A></H2>
+
+<OL START="1">
+
+	<LI><EM>Streaming API;</EM> a new streaming request API provides asynchronous job creation and request submission.</LI>
+
+	<LI><EM>Device discovery;</EM> the new <code>cupsGetDevices</code> function streams discovered devices to an application-provided callback function.</LI>
+
+	<LI><EM>PPD support;</EM> two new functions are provided, cupsGetPPD3 and ppdLocalizeMarkerName, to update the local copy of a printers's PPD file and get a localized marker (supply) name, respectively.</LI>
+
+	<LI><EM>;</EM> </LI>
+
+	<LI><EM>;</EM> </LI>
+
+	<LI><EM>;</EM> </LI>
+
+	<LI><EM>;</EM> </LI>
+
+	<LI><EM>;</EM> </LI>
+
+	<LI><EM>;</EM> </LI>
+
+	<LI><EM>;</EM> </LI>
+
+</OL>
 
-</DL>
 
 </BODY>
 </HTML>
author	msweet <msweet@a1ca3aef-8c08-0410-bb20-df032aa958be>	2008-05-16 03:15:15 +0000
committer	msweet <msweet@a1ca3aef-8c08-0410-bb20-df032aa958be>	2008-05-16 03:15:15 +0000
commit	01ce6322ca3809ac0260c8ef28abbc8255f6e34f (patch)
tree	b65c4278e38f0a6f1aac239f3654636d51d0889b /doc
parent	3c8c76971a30d42417c0152f83bf8786185442e4 (diff)