- updated.

[packages/dcraw.git] / dcraw.1

diff --git a/dcraw.1 b/dcraw.1
index 218735ab59142d6efbb4905741439276ebc2a4c8..015393792dc1b9761640e1532ec48079e7f2373f 100644 (file)
--- a/dcraw.1
+++ b/dcraw.1
@@ -9,7 +9,7 @@
 .\" dcoffin a cybercom o net
 .\" http://www.cybercom.net/~dcoffin
 .\"
-.TH dcraw 1 "April 28, 2005"
+.TH dcraw 1 "August 30, 2005"
 .LO 1
 .SH NAME
 dcraw - convert raw digital photos to PPM format
@@ -23,21 +23,31 @@ converts raw digital photos to
 format.
 .SH OPTIONS
 .TP
+.B -v
+Print verbose messages.  The default is to print only warnings
+and errors.
+.TP
+.B -z
+Change the access and modification times of a JPEG or raw file to
+when the photo was taken, assuming that the camera clock was set
+to Universal Time.
+.TP
 .B -i
 Identify files but don't decode them.
 Exit status is 0 if
 .B dcraw
 can decode the last file, 1 if it can't.
 .TP
+.B ""
+.B dcraw
+cannot decode JPEG files!!
+.TP
 .B -c
 Write binary image data to standard output.
 By default,
 .B dcraw
 creates files with a ".ppm" extension.
 .TP
-.B -v
-Print verbose messages.  Default is to print only warnings and errors.
-.TP
 .B -d
 Show the raw data as a grayscale image with no interpolation.
 Good for photographing black-and-white documents.
@@ -52,10 +62,8 @@ each 2x2 block of sensors to one pixel.  Much faster than
 .BR -q .
 .TP
 .B -f
-Interpolate RGB as four colors.  This causes a slight loss
-of detail, so use
-.B -f
-only if you see false 2x2 mesh patterns in blue sky.
+Interpolate RGB as four colors.  This blurs the image a little,
+but it eliminates false 2x2 mesh patterns.
 .TP
 .B -a
 Automatic color balance.  The default is to use a fixed
@@ -74,6 +82,9 @@ blue channels by these values.  Both default to 1.0.
 .B -b brightness
 Change the output brightness.  Default is 1.0.
 .TP
+.B -k black
+Change the black point.  Default depends on the camera.
+.TP
 .B -n
 By default,
 .B dcraw
@@ -87,12 +98,21 @@ Write raw camera colors to the output file.  By default,
 .B dcraw
 converts to sRGB colorspace.
 .TP
+.B -j
+For Fuji\ Super\ CCD cameras, show the image tilted 45 degrees
+so that each output pixel corresponds to one raw pixel.
+.TP
 .B -s
-For cameras based on the Fuji Super CCD SR, use the secondary
-sensors, in effect underexposing the image by four stops to
-reveal detail in the highlights.  For all other cameras,
+For Fuji\ Super\ CCD\ SR cameras, use the secondary sensors, in
+effect underexposing the image by four stops to reveal detail
+in the highlights.
+.TP
+.B ""
+For all other cameras,
+.B -j
+and
 .B -s
-is silently ignored.
+are silently ignored.
 .TP
 .B -t [0-7]
 Flip the output image.  The most common flips are 5
@@ -117,7 +137,12 @@ Same image as
 .BR -4 ,
 written in Adobe PhotoShop format.  File extension is ".psd".
 .SH "SEE ALSO"
-ppm(5), ppm2tiff(1), pnmtotiff(1), pnmtopng(1), gphoto2(1).
+.BR ppm (5),
+.BR ppm2tiff (1),
+.BR pnmtotiff (1),
+.BR pnmtopng (1),
+.BR gphoto2 (1),
+.BR djpeg (1)
 .SH BUGS
 The
 .B -w
@@ -125,7 +150,7 @@ option does not work with many cameras.
 .P
 No attempt is made to save camera settings or thumbnail images.
 .P
-Author stubbornly refuses to add more output formats.
+The author stubbornly refuses to add more output formats.
 .P
 Don't expect
 .B dcraw