| Index: rdjpgcom.1
|
| diff --git a/rdjpgcom.1 b/rdjpgcom.1
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..97611df813c3135aa9063f49e5efec04b42719a2
|
| --- /dev/null
|
| +++ b/rdjpgcom.1
|
| @@ -0,0 +1,63 @@
|
| +.TH RDJPGCOM 1 "02 April 2009"
|
| +.SH NAME
|
| +rdjpgcom \- display text comments from a JPEG file
|
| +.SH SYNOPSIS
|
| +.B rdjpgcom
|
| +[
|
| +.B \-raw
|
| +]
|
| +[
|
| +.B \-verbose
|
| +]
|
| +[
|
| +.I filename
|
| +]
|
| +.LP
|
| +.SH DESCRIPTION
|
| +.LP
|
| +.B rdjpgcom
|
| +reads the named JPEG/JFIF file, or the standard input if no file is named,
|
| +and prints any text comments found in the file on the standard output.
|
| +.PP
|
| +The JPEG standard allows "comment" (COM) blocks to occur within a JPEG file.
|
| +Although the standard doesn't actually define what COM blocks are for, they
|
| +are widely used to hold user-supplied text strings. This lets you add
|
| +annotations, titles, index terms, etc to your JPEG files, and later retrieve
|
| +them as text. COM blocks do not interfere with the image stored in the JPEG
|
| +file. The maximum size of a COM block is 64K, but you can have as many of
|
| +them as you like in one JPEG file.
|
| +.SH OPTIONS
|
| +.TP
|
| +.B \-raw
|
| +Normally
|
| +.B rdjpgcom
|
| +escapes non-printable characters in comments, for security reasons.
|
| +This option avoids that.
|
| +.PP
|
| +.B \-verbose
|
| +Causes
|
| +.B rdjpgcom
|
| +to also display the JPEG image dimensions.
|
| +.PP
|
| +Switch names may be abbreviated, and are not case sensitive.
|
| +.SH HINTS
|
| +.B rdjpgcom
|
| +does not depend on the IJG JPEG library. Its source code is intended as an
|
| +illustration of the minimum amount of code required to parse a JPEG file
|
| +header correctly.
|
| +.PP
|
| +In
|
| +.B \-verbose
|
| +mode,
|
| +.B rdjpgcom
|
| +will also attempt to print the contents of any "APP12" markers as text.
|
| +Some digital cameras produce APP12 markers containing useful textual
|
| +information. If you like, you can modify the source code to print
|
| +other APPn marker types as well.
|
| +.SH SEE ALSO
|
| +.BR cjpeg (1),
|
| +.BR djpeg (1),
|
| +.BR jpegtran (1),
|
| +.BR wrjpgcom (1)
|
| +.SH AUTHOR
|
| +Independent JPEG Group
|
|
|