/usr/share/cups/doc-root/help/spec-banner.html is in cups-server-common 1.7.2-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- SECTION: Specifications -->
<head>
<title>CUPS Banner File Format</title>
<meta name='keywords' content='job-sheets'>
<link rel='stylesheet' type='text/css' href='../cups-printable.css'>
</head>
<body>
<!--
"$Id$"
Banner file format specification for CUPS.
Copyright 2008-2011 by Apple Inc.
These coded instructions, statements, and computer programs are the
property of Apple Inc. 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
file is missing or damaged, see the license at "http://www.cups.org/".
-->
<H1 CLASS="title">CUPS Banner File Format</H1>
<h2 class='title'><a name='INTRODUCTION'>Introduction</a></h2>
<p>This specification describes the CUPS banner file format
(application/vnd.cups-banner) which is used to generate print job cover pages
and the CUPS test page. The format itself consists of a header followed by
lines of UTF-8 text containing comments or keywords and values:</p>
<pre class='command'>
#CUPS-BANNER
# What to show on the cover page
Show job-id job-name job-originating-user-name time-at-creation
# The header and footer text
Header Cover Page
Footer Cover Page
# Arbitrary "notice" text
Notice All work and no play makes Johnny a dull boy.
Notice All work and no play makes Johnny a dull boy.
Notice All work and no play makes Johnny a dull boy.
Notice All work and no play makes Johnny a dull boy.
# Images to place below the rest
Image /usr/share/doc/cups/images/cups-icon.png
Image /usr/share/doc/cups/images/smiley.jpg
</pre>
<h2 class='title'><a name='KEYWORDS'>Standard Keywords</a></h2>
<h3><a name='Footer'>Footer</a></h3>
<p class='summary'>
Footer text for footer
</p>
<p>The <code>Footer</code> key defines the text that is centered at the bottom
of the page. Only one <code>Footer</code> key can be specified.</p>
<h3><a name='Header'>Header</a></h3>
<p class='summary'>
Header text for Header
</p>
<p>The <code>Header</code> key defines the text that is centered at the top
of the page. Only one <code>Header</code> key can be specified.</p>
<h3><a name='Image'>Image</a></h3>
<p class='summary'>
Image /path/to/image/filename<br>
Image relative/path/in/DocumentRoot/filename
</p>
<p>The <code>Image</code> key defines images that are centered above the footer
text. Multiple images are centered as a group from left to right. Images are
scaled as needed to fit on the page with a nominal size of 1"/25cm.</p>
<h3><a name='Notice'>Notice</a></h3>
<p class='summary'>
Notice Text to display below the job information.<br>
Notice More text to display below the job information.
</p>
<p>The <code>Notice</code> key defines lines of text that are centered below
the job information.</p>
<h3><a name='Show'>Show</a></h3>
<p class='summary'>
Show <em>value value ... value</em>
</p>
<p>The <code>Show</code> key lists the job information that is shown. The
following values are supported:</p>
<ul>
<li><code>imageable-area</code>: The imageable area of the current
page size</li>
<li><code>job-billing</code>: Billing information for the job</li>
<li><code>job-id</code>: The job ID</li>
<li><code>job-name</code>: The title of the job</li>
<li><code>job-originating-host-name</code>: The computer that printed
the job</li>
<li><code>job-originating-user-name</code>: The user that printed the
job</li>
<li><code>job-uuid</code>: The job UUID</li>
<li><code>options</code>: The options that were provided with the
job</li>
<li><code>paper-name</code>: The name of the paper size used</li>
<li><code>paper-size</code>: The dimensions of the paper size used.</li>
<li><code>printer-driver-name</code>: The printer driver used</li>
<li><code>printer-driver-version</code>: The driver version</li>
<li><code>printer-info</code>: The printer description</li>
<li><code>printer-location</code>: The location of the printer</li>
<li><code>printer-make-and-model</code>: The make and model strings
reported by the printer driver</li>
<li><code>printer-name</code>: The printer used</li>
<li><code>time-at-creation</code>: When the job was submitted</li>
<li><code>time-at-processing</code>: The current date and time</li>
</ul>
</body>
</html>
|