~ubuntu-branches/ubuntu/intrepid/libjpeg6b/intrepid

« back to all changes in this revision

Viewing changes to debian/patches/204_jpegtran_man.dpatch

  • Committer: Bazaar Package Importer
  • Author(s): Bill Allombert
  • Date: 2007-08-16 22:59:21 UTC
  • Revision ID: james.westby@ubuntu.com-20070816225921-vk7fsapj4mxi5v9f
Tags: 6b-14
* The "Lino" release.
* exifautotran:
  - fix typo in manpage. closes: #376371, thanks Reuben Thomas.
  - preserve file mode. closes: #383379, thanks Vincent Arkesteijn.
* debian/control, debian/rules, debian/compat:
  + switch to debhelper v5
  + add libjpeg-dbg debugging package.
* debian/rules: remove - before "make clean" rules.
* Add patch 204_jpegtran_man to improve readability of manpage.
  closes: #437453. Thanks Jorgen Grahn.
* jpegexiforient.1: Apply patch from Jorgen Grahn to improve formatting.
  closes: #437446.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
#! /bin/sh /usr/share/dpatch/dpatch-run
 
2
## 204_jpegtran_man.dpatch by Jorgen Grahn <grahn+debian@snipabacken.dyndns.org>
 
3
##
 
4
## All lines beginning with `## DP:' are a description of the patch.
 
5
## DP: improves readability of jpegtran man page
 
6
 
 
7
@DPATCH@
 
8
diff -urNad libjpeg6b-6b~/jpegtran.1 libjpeg6b-6b/jpegtran.1
 
9
--- libjpeg6b-6b~/jpegtran.1    2007-08-16 22:55:43.000000000 +0200
 
10
+++ libjpeg6b-6b/jpegtran.1     2007-08-16 22:55:50.000000000 +0200
 
11
@@ -91,12 +91,12 @@
 
12
 .TP
 
13
 .B \-transverse
 
14
 Transverse transpose (across UR-to-LL axis).
 
15
-.PP
 
16
+.IP
 
17
 The transpose transformation has no restrictions regarding image dimensions.
 
18
 The other transformations operate rather oddly if the image dimensions are not
 
19
 a multiple of the iMCU size (usually 8 or 16 pixels), because they can only
 
20
 transform complete blocks of DCT coefficient data in the desired way.
 
21
-.PP
 
22
+.IP
 
23
 .BR jpegtran 's
 
24
 default behavior when transforming an odd-size image is designed
 
25
 to preserve exact reversibility and mathematical consistency of the
 
26
@@ -108,7 +108,7 @@
 
27
 of transpose and flip operations; for consistency, their actions on edge
 
28
 pixels are defined to be the same as the end result of the corresponding
 
29
 transpose-and-flip sequence.
 
30
-.PP
 
31
+.IP
 
32
 For practical use, you may prefer to discard any untransformable edge pixels
 
33
 rather than having a strange-looking strip along the right and/or bottom edges
 
34
 of a transformed image.  To do this, add the
 
35
@@ -117,7 +117,7 @@
 
36
 .TP
 
37
 .B \-trim
 
38
 Drop non-transformable edge blocks.
 
39
-.PP
 
40
+.IP
 
41
 Obviously, a transformation with
 
42
 .B \-trim
 
43
 is not reversible, so strictly speaking
 
44
@@ -130,7 +130,7 @@
 
45
 followed by
 
46
 .B \-rot 180 -trim
 
47
 trims both edges.
 
48
-.PP
 
49
+.IP
 
50
 If you are only interested by perfect transformation, add the
 
51
 .B \-perfect
 
52
 switch:
 
53
@@ -138,8 +138,9 @@
 
54
 .B \-perfect
 
55
 Fails with an error if the transformation is not perfect. For example
 
56
 you may want to do
 
57
-.TP
 
58
+.IP
 
59
 .B (jpegtran \-rot 90 -perfect foo.jpg || djpeg foo.jpg| pnmflip \-r90 | cjpeg)
 
60
+.IP
 
61
 to do a perfect rotation if available or an approximated one if
 
62
 not.
 
63
 .PP
 
64
@@ -151,25 +152,24 @@
 
65
 corner up and/or left to make it so, simultaneously increasing the region
 
66
 dimensions to keep the lower right crop corner unchanged.  (Thus, the
 
67
 output image covers at least the requested region, but may cover more.)
 
68
-
 
69
+.IP
 
70
 Note: 
 
71
 .B \-perfect
 
72
 and
 
73
 .B lossless-crop
 
74
 are enhancements from http://sylvana.net/jpegcrop/ that may not be available on
 
75
 non-Debian systems.
 
76
-
 
77
+.PP
 
78
 The image can be losslessly cropped by giving the switch:
 
79
 .TP
 
80
 .B \-crop WxH+X+Y
 
81
 Crop to a rectangular subarea of width W, height H starting at point X,Y.
 
82
 .PP
 
83
-.PP
 
84
 Another not-strictly-lossless transformation switch is:
 
85
 .TP
 
86
 .B \-grayscale
 
87
 Force grayscale output.
 
88
-.PP
 
89
+.IP
 
90
 This option discards the chrominance channels if the input image is YCbCr
 
91
 (ie, a standard color JPEG), resulting in a grayscale JPEG file.  The
 
92
 luminance channel is preserved exactly, so this is a better method of reducing
 
93
@@ -193,9 +193,11 @@
 
94
 .TP
 
95
 .B \-copy all
 
96
 Copy all extra markers.  This setting preserves miscellaneous markers
 
97
-found in the source file, such as JFIF thumbnails and Photoshop settings.
 
98
+found in the source file, such as
 
99
+Exif data,
 
100
+JFIF thumbnails and Photoshop settings.
 
101
 In some files these extra markers can be sizable.
 
102
-.PP
 
103
+.IP
 
104
 The default behavior is
 
105
 .BR "\-copy comments" .
 
106
 (Note: in IJG releases v6 and v6a,