Index: wrjpgcom.1 |
diff --git a/wrjpgcom.1 b/wrjpgcom.1 |
new file mode 100644 |
index 0000000000000000000000000000000000000000..d419a99993695c7f19091f270e6a197da36e73c9 |
--- /dev/null |
+++ b/wrjpgcom.1 |
@@ -0,0 +1,103 @@ |
+.TH WRJPGCOM 1 "15 June 1995" |
+.SH NAME |
+wrjpgcom \- insert text comments into a JPEG file |
+.SH SYNOPSIS |
+.B wrjpgcom |
+[ |
+.B \-replace |
+] |
+[ |
+.BI \-comment " text" |
+] |
+[ |
+.BI \-cfile " name" |
+] |
+[ |
+.I filename |
+] |
+.LP |
+.SH DESCRIPTION |
+.LP |
+.B wrjpgcom |
+reads the named JPEG/JFIF file, or the standard input if no file is named, |
+and generates a new JPEG/JFIF file on standard output. A comment block is |
+added to the file. |
+.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. |
+.PP |
+.B wrjpgcom |
+adds a COM block, containing text you provide, to a JPEG file. |
+Ordinarily, the COM block is added after any existing COM blocks; but you |
+can delete the old COM blocks if you wish. |
+.SH OPTIONS |
+Switch names may be abbreviated, and are not case sensitive. |
+.TP |
+.B \-replace |
+Delete any existing COM blocks from the file. |
+.TP |
+.BI \-comment " text" |
+Supply text for new COM block on command line. |
+.TP |
+.BI \-cfile " name" |
+Read text for new COM block from named file. |
+.PP |
+If you have only one line of comment text to add, you can provide it on the |
+command line with |
+.BR \-comment . |
+The comment text must be surrounded with quotes so that it is treated as a |
+single argument. Longer comments can be read from a text file. |
+.PP |
+If you give neither |
+.B \-comment |
+nor |
+.BR \-cfile , |
+then |
+.B wrjpgcom |
+will read the comment text from standard input. (In this case an input image |
+file name MUST be supplied, so that the source JPEG file comes from somewhere |
+else.) You can enter multiple lines, up to 64KB worth. Type an end-of-file |
+indicator (usually control-D) to terminate the comment text entry. |
+.PP |
+.B wrjpgcom |
+will not add a COM block if the provided comment string is empty. Therefore |
+\fB\-replace \-comment ""\fR can be used to delete all COM blocks from a file. |
+.SH EXAMPLES |
+.LP |
+Add a short comment to in.jpg, producing out.jpg: |
+.IP |
+.B wrjpgcom \-c |
+\fI"View of my back yard" in.jpg |
+.B > |
+.I out.jpg |
+.PP |
+Attach a long comment previously stored in comment.txt: |
+.IP |
+.B wrjpgcom |
+.I in.jpg |
+.B < |
+.I comment.txt |
+.B > |
+.I out.jpg |
+.PP |
+or equivalently |
+.IP |
+.B wrjpgcom |
+.B -cfile |
+.I comment.txt |
+.B < |
+.I in.jpg |
+.B > |
+.I out.jpg |
+.SH SEE ALSO |
+.BR cjpeg (1), |
+.BR djpeg (1), |
+.BR jpegtran (1), |
+.BR rdjpgcom (1) |
+.SH AUTHOR |
+Independent JPEG Group |