]> git.ipfire.org Git - thirdparty/cups.git/blobdiff - doc/help/spec-ipp.html
Merge changes from CUPS 1.4svn-r8162.
[thirdparty/cups.git] / doc / help / spec-ipp.html
index 442a752efce3669bb5f9443d0fb484ada88d9367..70db037656a8129a7b35fe828b59d36d169a5343 100644 (file)
@@ -1576,7 +1576,15 @@ CUPS-Get-Devices request:
 
        <dd>The client OPTIONALLY supplies a set of scheme names that the
        requestor does not want to discover. If the client omits this attribute,
-       the server responds with devices of all schemes.
+       the server responds with devices of all schemes specified by
+       the "include-schemes" attribute.
+
+       <dt>"include-schemes" (1setOf name) :<span class='info'>CUPS 1.4</span>
+
+       <dd>The client OPTIONALLY supplies a set of scheme names that the
+       requestor wants to discover. If the client omits this attribute,
+       the server responds with devices of all schemes except those specified
+       by the "exclude-schemes" attribute.
 
        <dt>"limit" (integer (1:MAX)):
 
@@ -1647,6 +1655,20 @@ CUPS-Get-PPDs request:
        attributes as described in section 3.1.4.1 of the IPP Model and
        Semantics document.
 
+       <dt>"exclude-schemes" (1setOf name) :<span class='info'>CUPS 1.4</span>
+
+       <dd>The client OPTIONALLY supplies a set of scheme names that the
+       requestor does not want to list. If the client omits this attribute,
+       the server responds with PPDs of all schemes specified by the
+       "include-schemes" attribute.
+
+       <dt>"include-schemes" (1setOf name) :<span class='info'>CUPS 1.4</span>
+
+       <dd>The client OPTIONALLY supplies a set of scheme names that the
+       requestor wants to list. If the client omits this attribute, the server
+       responds with PPDs of all schemes except those specified by the
+       "exclude-schemes" attribute.
+
        <dt>"limit" (integer (1:MAX)):
 
        <dd>The client OPTIONALLY supplies this attribute limiting the number of PPDs that are returned.
@@ -2146,7 +2168,13 @@ supported. The default value is 10.
 <p>The document-count attribute specifies the number of documents that
 are present in the job.
 
-<h4><a name="fitplot">fitplot (boolean)</a></h4>
+<h4><a name="fit-to-page">fit-to-page (boolean)</a><span class="info">CUPS 1.4</span></h4>
+
+<p>The fit-to-page attribute specifies whether to scale documents to fit on the
+selected media (fit-to-page=true) or use the physical size specified in the
+document (fit-to-page=false). The default value is false.
+
+<h4><a name="fitplot">fitplot (boolean)</a><span class="info">Deprecated</span></h4>
 
 <p>The fitplot attribute specifies whether to scale HP-GL/2 plot files to
 fit on the selected media (fitplot=true) or use the physical scale specified
@@ -2510,38 +2538,50 @@ the system.
 <p>The job-sheets-supported attribute specifies the available banner files.
 There will always be at least one banner file available called "none".
 
-<h4><a name="marker-change-time">marker-change-time (integer)</a></h4>
+<h4><a name="marker-change-time">marker-change-time (integer)</a><span class='info'>CUPS 1.3</span></h4>
 
 <p>The marker-change-time attribute specifies the printer-up-time value when
 the last change to the marker-colors, marker-levels, marker-message,
 marker-names, or marker-types attributes was made.</p>
 
-<h4><a name="marker-colors">marker-colors (1setof name(MAX))</a></h4>
+<h4><a name="marker-colors">marker-colors (1setof name(MAX))</a><span class='info'>CUPS 1.3</span></h4>
 
 <p>The marker-colors attribute specifies the color(s) for each supply in the
 printer. It is only available when the driver provides supply levels. The
 color is either "none" or one or more hex-encoded sRGB colors of the form
 "#RRGGBB".</p>
 
-<h4><a name="marker-levels">marker-levels (1setof integer(-1:100))</a></h4>
+<h4><a name="marker-high-levels">marker-high-levels (1setof integer(0:100))</a><span class='info'>CUPS 1.4</span></h4>
+
+<p>The marker-high-levels attribute specifies the supply levels that indicate
+a near-full condition. A value of 100 should be used for supplies that are
+consumed/emptied, e.g. ink cartridges.</p>
+
+<h4><a name="marker-levels">marker-levels (1setof integer(-1:100))</a><span class='info'>CUPS 1.3</span></h4>
 
 <p>The marker-levels attribute specifies the current supply levels for the
 printer. It is only available when the driver provides supply levels. A
 value of -1 indicates the level is unknown, while values from 0 to 100
 indicate the corresponding percentage.</p>
 
-<h4><a name="marker-message">marker-message (text(MAX))</a></h4>
+<h4><a name="marker-low-levels">marker-low-levels (1setof integer(0:100))</a><span class='info'>CUPS 1.4</span></h4>
+
+<p>The marker-low-levels attribute specifies the supply levels that indicate
+a near-empty condition. A value of 0 should be used for supplies that are
+filled, e.g. waste ink tanks.</p>
+
+<h4><a name="marker-message">marker-message (text(MAX))</a><span class='info'>CUPS 1.4</span></h4>
 
 <p>The marker-message attribute provides a human-readable status message
 for the current supply levels, e.g. "12 pages of ink remaining." It is only
 available when the driver provides supply levels.</p>
 
-<h4><a name="marker-names">marker-names (1setof name(MAX))</a></h4>
+<h4><a name="marker-names">marker-names (1setof name(MAX))</a><span class='info'>CUPS 1.3</span></h4>
 
 <p>The marker-names attribute specifies the name(s) for each supply in the
 printer. It is only available when the driver provides supply levels.</p>
 
-<h4><a name="marker-types">marker-types (1setof type3 keyword)</a></h4>
+<h4><a name="marker-types">marker-types (1setof type3 keyword)</a><span class='info'>CUPS 1.3</span></h4>
 
 <p>The marker-types attribute specifies the type(s) of each supply in the
 printer. It is only available when the driver provides supply levels. The