/usr/share/doc/qprint-doc/index.html is in qprint-doc 1.1.dfsg.2-2build1.
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 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<title>QPRINT: Encode and Decode Quoted-Printable Files</title>
<style type="text/css">
body {
margin-left: 15%;
margin-right: 10%;
background-color: #FFFFFF;
color: #000000;
}
dt {
margin-top: 1ex;
}
</style>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<meta name="keywords" content="qprint, encode, decode, utility, RFC 1521, MIME" />
<meta name="description" content="qprint: Encode and Decode Quoted-Printable Files" />
<meta name="author" content="John Walker" />
<meta name="robots" content="index" />
<meta name="robots" content="nofollow" />
</head>
<body>
<center>
<h1><img src="qprint.png" width="491" height="181"
alt="qprint: Encode and Decode Quoted-Printable Files" /></h1>
</center>
<hr />
<p>
This page describes, in Unix manual page style,
a program
<a href="#Download">available for downloading</a> from this site
which encodes binary files in the "Quoted-Printable" format used by
MIME-encoded documents such as electronic mail messages with
embedded images and audio files.
</p>
<h3>NAME</h3>
<blockquote>
<b>qprint</b> - encode and decode Quoted-Printable files
</blockquote>
<h3>SYNOPSIS</h3>
<blockquote>
<tt>qprint</tt> [ <tt>-d</tt> / <tt>-e</tt> ]
[ <em>options</em> ] [ <em>infile</em> ] [ <em>outfile</em> ]
</blockquote>
<h3>DESCRIPTION</h3>
<p>
The MIME (Multipurpose Internet Mail Extensions) specification
(<a href="rfc1521.html">RFC 1521</a> and successors)
defines a mechanism for encoding text consisting primarily
of printable ASCII characters, but which may contain characters
(for example, accented letters in the ISO 8859 Latin-1
character set) which cannot be encoded as 7-bit ASCII or
are non-printable characters which may confuse mail transfer
agents.
</p>
<p>
<b>qprint</b>
is a command line utility which encodes and decodes files in this format.
It can be used within a pipeline as an encoding or decoding filter,
and is most commonly used in this manner as part of an automated
mail processing system. With appropriate options, <b>qprint</b>
can encode pure binary files, but it's a poor choice since it may
inflate the size of the file by as much as a factor of three.
The <a href="../base64/"><b>base64</b></a> MIME encoding is a
better choice for such data.
</p>
<h3>OPTIONS</h3>
<dl compact="compact">
<dt><b>-b</b>, <b>--binary</b></dt>
<dd>
Treat the input (when encoding) or output (when decoding) file
as pure binary, and process end of line sequences as binary
data. Encoding and decoding a file with this option preserves
the exact sequence of bytes in the input, but does not perform
the translation of end of line sequences normally performed by
Quoted-Printable encoding.
</dd>
<dt><b>--copyright</b></dt>
<dd>
Print copyright information.
</dd>
<dt><b>-d</b>, <b>--decode</b></dt>
<dd>
Decodes the input, previously created by <b>qprint</b>, to recover the
original input file.
</dd>
<dt><b>-e</b>, <b>--encode</b></dt>
<dd>
Encodes the input into an output text file containing
its Quoted-Printable encoding.
</dd>
<dt><b>-i</b>, <b>--ebcdic</b></dt>
<dd>
Encode ASCII characters for which no equivalent exists in
the EBCDIC character set. This renders files more portable
when transported to EBCDIC systems.
</dd>
<dt><b>-n</b>, <b>--noerrcheck</b></dt>
<dd>
Suppress error checking when decoding. By default, if an
incorrectly encoded escape sequence is encountered, a
warning message is printed. This option suppresses
the warning messages; the only indication that an
improperly encoded file was read will be the program
returning exit status 1 at the end of the input file.
In either case, incorrect escape sequences are discarded.
</dd>
<dt><b>-p</b>, <b>--paranoid</b></dt>
<dd>
Every character in the input file will be encoded as an
escape sequence. You must also specify the <b>-b</b> or
<b>--binary</b> option if you wish end of line sequences
to be escaped as well. This option is a last resort when
there's no other way to transmit the file, but an encoding
explicitly designed for binary data such as
<a href="../base64/">Base64</a> is a much more economical
choice.
</dd>
<dt><b>-u</b>, <b>--help</b></dt>
<dd> Print how to call information and a summary of options.
</dd>
<dt><b>--version</b></dt>
<dd>Print program version information.
</dd>
</dl>
<h3>EXIT STATUS</h3>
<p>
<b>qprint</b> returns status 0 if processing was completed without
errors, 1 if an I/O error occurred or errors were detected in decoding
a file which indicate it is incorrect or incomplete, and 2 if
processing could not be performed at all due, for example, to a
nonexistent input file.
</p>
<h3><a name="files">FILES</a></h3>
<p>
If no <i>infile</i> is specified or <i>infile</i> is a single "-",
<b>qprint</b> reads from standard input; if no <i>outfile</i> is
given, or <i>outfile</i> is a single "-", output is sent to standard
output. The input and output are processed strictly serially;
consequently <b>qprint</b> may be used in pipelines. The program
can process files of any size supported by the system containing text
lines of arbitrary length.
</p>
<h3>BUGS</h3>
<p>
Encoding a file with a large percentage of non-ASCII characters
may dramatically increase its size. This is inherent in the
design of Quoted-Printable encoding.
</p>
<h3>SEE ALSO</h3>
<a href="../base64/"><b>base64</b></a>(1),
<a href="rfc1521.html" target="_blank">RFC 1521</a>
<h2><a name="Download" href="qprint-1.0.tar.gz"><img src="/images/icons/file.gif"
alt="" align="middle" width="40" height="40" border="0" /></a>
<a href="qprint-1.0.tar.gz">Download qprint-1.0.tar.gz</a> (Gzipped TAR archive)</h2>
<p>
The archive contains source code for the utility, a Makefile
for Unix systems, and a ready-to-run executable for 32-bit
Windows platforms. Windows users may also download
<a href="qprint.zip"><b><tt>qprint.zip</tt></b></a>, a
ZIPped archive containing the Windows executable.
</p>
<h3><a href="qprint.pdf">Read <b>qprint</b> source code</a> (requires
<a href="http://www.adobe.com/acrobat/readstep.html" target="_blank">Acrobat Reader</a>)</h3>
<h3>AUTHOR</h3>
<address>
<a href="/">John Walker</a><br />
<a href="/">http://www.fourmilab.ch/</a>
</address>
<blockquote>
This software is in the public domain. Permission to use, copy,
modify, and distribute this software and its documentation for
any purpose and without fee is hereby granted, without any
conditions or restrictions. This software is provided "as is"
without express or implied warranty.
</blockquote>
<p />
<hr />
<p />
<table align="right">
<tr><td align="center">
<form name="feedback" method="post" action="/cgi-bin/FeedbackForm.pl">
<input type="hidden" name="pagetitle" value="<cite>Qprint</cite>" />
<input type="hidden" name="backlink" value="Back to <cite>Qprint</cite>" />
<input type="submit" value=" Send Feedback " />
</form>
</td></tr>
<tr><td align="center">
<a href="http://validator.w3.org/check?uri=referer"
target="FourmilabValidation"><img
src="/images/icons/valid-xhtml10.png"
alt="Valid XHTML 1.0" height="31" width="88"
border="0" /></a>
</td></tr>
</table>
<address>
by <a href="/">John Walker</a><br />
5th March 2001<br />
Version 1.0<br />
The latest version of this program is available from:<br />
<a href="http://www.fourmilab.ch/webtools/qprint/">http://www.fourmilab.ch/webtools/qprint/</a>.
</address>
</body>
</html>
|