libjpeg/patches/libjpeg-6b-crop-man.patch

# DP: Manpage update for jpegtran -crop

diff -urNad /home/bill/debian/libjpeg/libjpeg6b-6b/jpegtran.1 libjpeg6b-6b/jpegtran.1
--- /home/bill/debian/libjpeg/libjpeg6b-6b/jpegtran.1	2003-09-22 18:46:08.000000000 +0200
+++ libjpeg6b-6b/jpegtran.1	2003-09-22 18:49:06.000000000 +0200
@@ -131,6 +131,40 @@
 .B \-rot 180 -trim
 trims both edges.
 .PP
+If you are only interested by perfect transformation, add the
+.B \-perfect
+switch:
+.TP
+.B \-perfect
+Fails with an error if the transformation is not perfect. For example
+you may want to do
+.TP
+.B (jpegtran \-rot 90 -perfect foo.jpg || djpeg foo.jpg| pnmflip \-r90 | cjpeg)
+to do a perfect rotation if available or an approximated one if
+not.
+.PP
+We also offer a lossless-crop option, which discards data outside a given
+image region but losslessly preserves what is inside.  Like the rotate and
+flip transforms, lossless crop is restricted by the JPEG format: the upper
+left corner of the selected region must fall on an iMCU boundary.  If this
+does not hold for the given crop parameters, we silently move the upper left
+corner up and/or left to make it so, simultaneously increasing the region
+dimensions to keep the lower right crop corner unchanged.  (Thus, the
+output image covers at least the requested region, but may cover more.)
+
+Note: 
+.B \-perfect
+and
+.B lossless-crop
+are enhancements from http://sylvana.net/jpegcrop/ that may not be available on
+non-Debian systems.
+
+The image can be losslessly cropped by giving the switch:
+.TP
+.B \-crop WxH+X+Y
+Crop to a rectangular subarea of width W, height H starting at point X,Y.
+.PP
+.PP
 Another not-strictly-lossless transformation switch is:
 .TP
 .B \-grayscale
@@ -231,7 +265,9 @@
 .PP
 The transform options can't transform odd-size images perfectly.  Use
 .B \-trim
-if you don't like the results without it.
+or
+.B \-perfect
+if you don't like the results.
 .PP
 The entire image is read into memory and then written out again, even in
 cases where this isn't really necessary.  Expect swapping on large images,
1	# DP: Manpage update for jpegtran -crop
2
3	diff -urNad /home/bill/debian/libjpeg/libjpeg6b-6b/jpegtran.1 libjpeg6b-6b/jpegtran.1
4	--- /home/bill/debian/libjpeg/libjpeg6b-6b/jpegtran.1 2003-09-22 18:46:08.000000000 +0200
5	+++ libjpeg6b-6b/jpegtran.1 2003-09-22 18:49:06.000000000 +0200
6	@@ -131,6 +131,40 @@
7	.B \-rot 180 -trim
8	trims both edges.
9	.PP
10	+If you are only interested by perfect transformation, add the
11	+.B \-perfect
12	+switch:
13	+.TP
14	+.B \-perfect
15	+Fails with an error if the transformation is not perfect. For example
16	+you may want to do
17	+.TP
18	+.B (jpegtran \-rot 90 -perfect foo.jpg \|\| djpeg foo.jpg\| pnmflip \-r90 \| cjpeg)
19	+to do a perfect rotation if available or an approximated one if
20	+not.
21	+.PP
22	+We also offer a lossless-crop option, which discards data outside a given
23	+image region but losslessly preserves what is inside. Like the rotate and
24	+flip transforms, lossless crop is restricted by the JPEG format: the upper
25	+left corner of the selected region must fall on an iMCU boundary. If this
26	+does not hold for the given crop parameters, we silently move the upper left
27	+corner up and/or left to make it so, simultaneously increasing the region
28	+dimensions to keep the lower right crop corner unchanged. (Thus, the
29	+output image covers at least the requested region, but may cover more.)
30	+
31	+Note:
32	+.B \-perfect
33	+and
34	+.B lossless-crop
35	+are enhancements from http://sylvana.net/jpegcrop/ that may not be available on
36	+non-Debian systems.
37	+
38	+The image can be losslessly cropped by giving the switch:
39	+.TP
40	+.B \-crop WxH+X+Y
41	+Crop to a rectangular subarea of width W, height H starting at point X,Y.
42	+.PP
43	+.PP
44	Another not-strictly-lossless transformation switch is:
45	.TP
46	.B \-grayscale
47	@@ -231,7 +265,9 @@
48	.PP
49	The transform options can't transform odd-size images perfectly. Use
50	.B \-trim
51	-if you don't like the results without it.
52	+or
53	+.B \-perfect
54	+if you don't like the results.
55	.PP
56	The entire image is read into memory and then written out again, even in
57	cases where this isn't really necessary. Expect swapping on large images,