Skip to content

Commit 69eb6c0

Browse files
michaelrsweetmichaelrsweet
committed
Update man pages.
1 parent 1eb5789 commit 69eb6c0

5 files changed

Lines changed: 189 additions & 174 deletions

File tree

‎doc/ippeveprinter.html‎

Lines changed: 28 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,9 @@
77
font-size: 16pt;
88
margin: 54pt 36pt;
99
}
10+
.center {
11+
text-align: center;
12+
}
1013
code, kbd, pre, tt {
1114
font-family: monospace;
1215
}
@@ -60,8 +63,8 @@
6063
border-bottom: none;
6164
}
6265
--></style>
63-
<meta name="creator" content="mantohtml v2022.1005">
64-
<title>Documentation</title>
66+
<meta name="creator" content="mantohtml v2.0.2">
67+
<title>ippeveprinter(1)</title>
6568
</head>
6669
<body>
6770
<h1 id="ippeveprinter-1">ippeveprinter(1)</h1>
@@ -154,7 +157,7 @@ <h2 id="ippeveprinter-1.options">Options</h2>
154157
</p>
155158
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--pam-service </strong><em>service</em><br>
156159
Set the PAM service name.
157-
The default service is "cups".
160+
The default service is &quot;cups&quot;.
158161
</p>
159162
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--version</strong><br>
160163
Show the CUPS version.
@@ -169,18 +172,18 @@ <h2 id="ippeveprinter-1.options">Options</h2>
169172
</p>
170173
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-D </strong><em>device-uri</em><br>
171174
Set the device URI for print output.
172-
The URI can be a filename, directory, or a network socket URI of the form "socket://ADDRESS[:PORT]" (where the default port number is 9100).
175+
The URI can be a filename, directory, or a network socket URI of the form &quot;socket://ADDRESS[:PORT]&quot; (where the default port number is 9100).
173176
When specifying a directory,
174177
<strong>ippeveprinter</strong>
175178
will create an output file using the job ID and name.
176179
</p>
177180
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-F </strong><em>output-type/subtype[,...]</em><br>
178181
Specifies the output MIME media type.
179-
The default is "application/postscript" when the <strong>-P</strong> option is specified.
182+
The default is &quot;application/postscript&quot; when the <strong>-P</strong> option is specified.
180183
</p>
181184
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-M </strong><em>manufacturer</em><br>
182185
Set the manufacturer of the printer.
183-
The default is "Example".
186+
The default is &quot;Example&quot;.
184187
</p>
185188
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-V 1.1</strong><br>
186189
</p>
@@ -213,7 +216,7 @@ <h2 id="ippeveprinter-1.options">Options</h2>
213216
</p>
214217
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-m </strong><em>model</em><br>
215218
Specifies the model name of the printer.
216-
The default is "Printer".
219+
The default is &quot;Printer&quot;.
217220
</p>
218221
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-n </strong><em>hostname</em><br>
219222
Specifies the hostname that is reported by the server.
@@ -232,12 +235,12 @@ <h2 id="ippeveprinter-1.options">Options</h2>
232235
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-r </strong><em>subtype[,subtype]</em><br>
233236
Specifies the DNS-SD subtype(s) to advertise.
234237
Separate multiple subtypes with a comma.
235-
The default is "_print".
238+
The default is &quot;_print&quot;.
236239
</p>
237240
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-s </strong><em>speed[,color-speed]</em><br>
238241
Specifies the printer speed in pages per minute.
239242
If two numbers are specified and the second number is greater than zero, the server will report support for color printing.
240-
The default is "10,0".
243+
The default is &quot;10,0&quot;.
241244
</p>
242245
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-v[vvv]</strong><br>
243246
Be (very) verbose when logging activity to standard error.
@@ -257,17 +260,17 @@ <h2 id="ippeveprinter-1.conforming-to">Conforming To</h2>
257260
</p>
258261
<h2 id="ippeveprinter-1.environment">Environment</h2>
259262
<p><strong>ippeveprinter</strong>
260-
adds environment variables starting with "IPP_" for all IPP Job attributes in the print request.
261-
For example, when executing a command for an IPP Job containing the "media" Job Template attribute, the "IPP_MEDIA" environment variable will be set to the value of that attribute.
263+
adds environment variables starting with &quot;IPP_&quot; for all IPP Job attributes in the print request.
264+
For example, when executing a command for an IPP Job containing the &quot;media&quot; Job Template attribute, the &quot;IPP_MEDIA&quot; environment variable will be set to the value of that attribute.
262265
</p>
263-
<p>In addition, all IPP "xxx-default" and "pwg-xxx" Printer Description attributes are added to the environment.
264-
For example, the "IPP_MEDIA_DEFAULT" environment variable will be set to the default value for the "media" Job Template attribute.
266+
<p>In addition, all IPP &quot;xxx-default&quot; and &quot;pwg-xxx&quot; Printer Description attributes are added to the environment.
267+
For example, the &quot;IPP_MEDIA_DEFAULT&quot; environment variable will be set to the default value for the &quot;media&quot; Job Template attribute.
265268
</p>
266269
<p>Enumerated values are converted to their keyword equivalents.
267-
For example, a "print-quality" Job Template attribute with a enum value of 3 will become the "IPP_PRINT_QUALITY" environment variable with a value of "draft".
268-
This string conversion only happens for standard Job Template attributes, currently "finishings", "orientation-requested", and "print-quality".
270+
For example, a &quot;print-quality&quot; Job Template attribute with a enum value of 3 will become the &quot;IPP_PRINT_QUALITY&quot; environment variable with a value of &quot;draft&quot;.
271+
This string conversion only happens for standard Job Template attributes, currently &quot;finishings&quot;, &quot;orientation-requested&quot;, and &quot;print-quality&quot;.
269272
</p>
270-
<p>Finally, the "CONTENT_TYPE" environment variable contains the MIME media type of the document being printed, the "DEVICE_URI" environment variable contains the device URI as specified with the "-D" option, the "OUTPUT_FORMAT" environment variable contains the output MIME media type, and the "PPD" environment variable contains the PPD filename as specified with the "-P" option.
273+
<p>Finally, the &quot;CONTENT_TYPE&quot; environment variable contains the MIME media type of the document being printed, the &quot;DEVICE_URI&quot; environment variable contains the device URI as specified with the &quot;-D&quot; option, the &quot;OUTPUT_FORMAT&quot; environment variable contains the output MIME media type, and the &quot;PPD&quot; environment variable contains the PPD filename as specified with the &quot;-P&quot; option.
271274
</p>
272275
<h2 id="ippeveprinter-1.command-output">Command Output</h2>
273276
<p>Unless they communicate directly with a printer, print commands send printer-ready data to the standard output.
@@ -278,48 +281,48 @@ <h2 id="ippeveprinter-1.command-output">Command Output</h2>
278281
</p>
279282
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ATTR: </strong><em>attribute=value[ attribute=value]</em><br>
280283
Sets the named attribute(s) to the given values.
281-
Currently only the "job-impressions" and "job-impressions-completed" Job Status attributes and the "marker-xxx", "printer-alert", "printer-alert-description", "printer-supply", and "printer-supply-description" Printer Status attributes can be set.
284+
Currently only the &quot;job-impressions&quot; and &quot;job-impressions-completed&quot; Job Status attributes and the &quot;marker-xxx&quot;, &quot;printer-alert&quot;, &quot;printer-alert-description&quot;, &quot;printer-supply&quot;, and &quot;printer-supply-description&quot; Printer Status attributes can be set.
282285
</p>
283286
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>DEBUG: </strong><em>Debugging message</em><br>
284287
Logs a debugging message if at least two -v's have been specified.
285288
</p>
286289
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ERROR: </strong><em>Error message</em><br>
287-
Logs an error message and copies the message to the "job-state-message" attribute.
290+
Logs an error message and copies the message to the &quot;job-state-message&quot; attribute.
288291
</p>
289292
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>INFO: </strong><em>Informational message</em><br>
290-
Logs an informational/progress message if -v has been specified and copies the message to the "job-state-message" attribute unless an error has been reported.
293+
Logs an informational/progress message if -v has been specified and copies the message to the &quot;job-state-message&quot; attribute unless an error has been reported.
291294
</p>
292295
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>STATE: </strong><em>keyword[,keyword,...]</em><br>
293-
Sets the printer's "printer-state-reasons" attribute to the listed keywords.
296+
Sets the printer's &quot;printer-state-reasons&quot; attribute to the listed keywords.
294297
</p>
295298
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>STATE: -</strong><em>keyword[,keyword,...]</em><br>
296-
Removes the listed keywords from the printer's "printer-state-reasons" attribute.
299+
Removes the listed keywords from the printer's &quot;printer-state-reasons&quot; attribute.
297300
</p>
298301
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>STATE: +</strong><em>keyword[,keyword,...]</em><br>
299-
Adds the listed keywords to the printer's "printer-state-reasons" attribute.
302+
Adds the listed keywords to the printer's &quot;printer-state-reasons&quot; attribute.
300303
</p>
301304
<h2 id="ippeveprinter-1.examples">Examples</h2>
302305
<p>Run
303306
<strong>ippeveprinter</strong>
304307
with a service name of My Cool Printer:
305308
</p>
306309
<pre>
307-
ippeveprinter "My Cool Printer"
310+
ippeveprinter &quot;My Cool Printer&quot;
308311
</pre>
309312
<p>Run the
310313
<strong>file</strong>(1)
311314

312315
command whenever a job is sent to the server:
313316
</p>
314317
<pre>
315-
ippeveprinter -c /usr/bin/file "My Cool Printer"
318+
ippeveprinter -c /usr/bin/file &quot;My Cool Printer&quot;
316319
</pre>
317320
<h2 id="ippeveprinter-1.see-also">See Also</h2>
318321
<p><strong>ippevepcl</strong>(1),
319322

320323
<strong>ippeveps</strong>(1),
321324

322-
<strong>ipptransform</strong>(1),
325+
<a href="ipptransform.html"><strong>ipptransform</strong>(1),</a>
323326

324327
PWG Internet Printing Protocol Workgroup (<a href="http://www.pwg.org/ipp">http://www.pwg.org/ipp</a>)
325328
</p>

‎doc/ippfind.html‎

Lines changed: 22 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,9 @@
77
font-size: 16pt;
88
margin: 54pt 36pt;
99
}
10+
.center {
11+
text-align: center;
12+
}
1013
code, kbd, pre, tt {
1114
font-family: monospace;
1215
}
@@ -60,8 +63,8 @@
6063
border-bottom: none;
6164
}
6265
--></style>
63-
<meta name="creator" content="mantohtml v2022.1005">
64-
<title>Documentation</title>
66+
<meta name="creator" content="mantohtml v2.0.2">
67+
<title>ippfind(1)</title>
6568
</head>
6669
<body>
6770
<h1 id="ippfind-1">ippfind(1)</h1>
@@ -139,7 +142,7 @@ <h3 id="ippfind-1.description.expressions">Expressions</h3>
139142
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-l</strong><br>
140143
</p>
141144
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--ls</strong><br>
142-
Lists attributes returned by Get-Printer-Attributes for IPP printers and traditional <em>find</em> "-ls" output for HTTP URLs.
145+
Lists attributes returned by Get-Printer-Attributes for IPP printers and traditional <em>find</em> &quot;-ls&quot; output for HTTP URLs.
143146
The result is true if the URI is accessible, false otherwise.
144147
</p>
145148
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--local</strong><br>
@@ -205,7 +208,7 @@ <h3 id="ippfind-1.description.expressions">Expressions</h3>
205208
</p>
206209
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--exec </strong><em>utility </em>[ <em>argument </em>... ] <strong>;</strong><br>
207210
Executes the specified program if the current result is true.
208-
"{foo}" arguments are replaced with the corresponding value - see SUBSTITUTIONS below.
211+
&quot;{foo}&quot; arguments are replaced with the corresponding value - see SUBSTITUTIONS below.
209212
</p>
210213
<p>Expressions may also contain modifiers:
211214
</p>
@@ -226,30 +229,30 @@ <h3 id="ippfind-1.description.expressions">Expressions</h3>
226229
Logical OR of expressions.
227230
</p>
228231
<h3 id="ippfind-1.description.substitutions">Substitutions</h3>
229-
<p>The substitutions for "{foo}" in <em>-e</em> and <em>--exec</em> are:
232+
<p>The substitutions for &quot;{foo}&quot; in <em>-e</em> and <em>--exec</em> are:
230233
</p>
231234
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>{service_domain}</strong><br>
232-
Domain name, e.g., "example.com.", "local.", etc.
235+
Domain name, e.g., &quot;example.com.&quot;, &quot;local.&quot;, etc.
233236
</p>
234237
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>{service_hostname}</strong><br>
235-
Fully-qualified domain name, e.g., "printer.example.com.", "printer.local.", etc.
238+
Fully-qualified domain name, e.g., &quot;printer.example.com.&quot;, &quot;printer.local.&quot;, etc.
236239
</p>
237240
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>{service_name}</strong><br>
238-
Service instance name, e.g., "My Fine Printer".
241+
Service instance name, e.g., &quot;My Fine Printer&quot;.
239242
</p>
240243
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>{service_port}</strong><br>
241244
Port number for server, typically 631 for IPP and 80 for HTTP.
242245
</p>
243246
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>{service_regtype}</strong><br>
244-
DNS-SD registration type, e.g., "_ipp._tcp", "_http._tcp", etc.
247+
DNS-SD registration type, e.g., &quot;_ipp._tcp&quot;, &quot;_http._tcp&quot;, etc.
245248
</p>
246249
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>{service_scheme}</strong><br>
247-
URI scheme for DNS-SD registration type, e.g., "ipp", "http", etc.
250+
URI scheme for DNS-SD registration type, e.g., &quot;ipp&quot;, &quot;http&quot;, etc.
248251
</p>
249252
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>{}</strong><br>
250253
</p>
251254
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>{service_uri}</strong><br>
252-
URI for service, e.g., "ipp://printer.local./ipp/print", "<a href="http://printer.local./&quot;">http://printer.local./&quot;</a>, etc.
255+
URI for service, e.g., &quot;ipp://printer.local./ipp/print&quot;, &quot;<a href="http://printer.local./&quot;">http://printer.local./&quot;</a>, etc.
253256
</p>
254257
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>{txt_</strong><em>key</em><strong>}</strong><br>
255258
Value of TXT record <em>key</em> (lowercase).
@@ -276,7 +279,7 @@ <h2 id="ippfind-1.options">Options</h2>
276279
</p>
277280
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-V </strong><em>version</em><br>
278281
Specifies the IPP version when listing.
279-
Supported values are "1.1", "2.0", "2.1", and "2.2".
282+
Supported values are &quot;1.1&quot;, &quot;2.0&quot;, &quot;2.1&quot;, and &quot;2.2&quot;.
280283
</p>
281284
<h2 id="ippfind-1.exit-status">Exit Status</h2>
282285
<p><strong>ippfind</strong> returns 0 if the result for all processed expressions is true, 1 if the result of any processed expression is false, 2 if browsing or any query or resolution failed, 3 if an undefined option or invalid expression was specified, and 4 if it ran out of memory.
@@ -285,25 +288,25 @@ <h2 id="ippfind-1.environment">Environment</h2>
285288
<p>When executing a program, <strong>ippfind</strong> sets the following environment variables for the matching service registration:
286289
</p>
287290
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>IPPFIND_SERVICE_DOMAIN</strong><br>
288-
Domain name, e.g., "example.com.", "local.", etc.
291+
Domain name, e.g., &quot;example.com.&quot;, &quot;local.&quot;, etc.
289292
</p>
290293
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>IPPFIND_SERVICE_HOSTNAME</strong><br>
291-
Fully-qualified domain name, e.g., "printer.example.com.", "printer.local.", etc.
294+
Fully-qualified domain name, e.g., &quot;printer.example.com.&quot;, &quot;printer.local.&quot;, etc.
292295
</p>
293296
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>IPPFIND_SERVICE_NAME</strong><br>
294-
Service instance name, e.g., "My Fine Printer".
297+
Service instance name, e.g., &quot;My Fine Printer&quot;.
295298
</p>
296299
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>IPPFIND_SERVICE_PORT</strong><br>
297300
Port number for server, typically 631 for IPP and 80 for HTTP.
298301
</p>
299302
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>IPPFIND_SERVICE_REGTYPE</strong><br>
300-
DNS-SD registration type, e.g., "_ipp._tcp", "_http._tcp", etc.
303+
DNS-SD registration type, e.g., &quot;_ipp._tcp&quot;, &quot;_http._tcp&quot;, etc.
301304
</p>
302305
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>IPPFIND_SERVICE_SCHEME</strong><br>
303-
URI scheme for DNS-SD registration type, e.g., "ipp", "http", etc.
306+
URI scheme for DNS-SD registration type, e.g., &quot;ipp&quot;, &quot;http&quot;, etc.
304307
</p>
305308
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>IPPFIND_SERVICE_URI</strong><br>
306-
URI for service, e.g., "ipp://printer.local./ipp/print", "<a href="http://printer.local./&quot;">http://printer.local./&quot;</a>, etc.
309+
URI for service, e.g., &quot;ipp://printer.local./ipp/print&quot;, &quot;<a href="http://printer.local./&quot;">http://printer.local./&quot;</a>, etc.
307310
</p>
308311
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>IPPFIND_TXT_</strong><em>KEY</em><br>
309312
Values of TXT record <em>KEY</em> (uppercase).
@@ -322,7 +325,7 @@ <h2 id="ippfind-1.examples">Examples</h2>
322325
-f onepage-letter.ps '{}' print-job.test \;
323326
</pre>
324327
<h2 id="ippfind-1.see-also">See Also</h2>
325-
<p><strong>ipptool</strong>(1)
328+
<a href="ipptool.html"><p><strong>ipptool</strong>(1)</a>
326329

327330
</p>
328331
<h2 id="ippfind-1.copyright">Copyright</h2>

0 commit comments

Comments
 (0)