.\" 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
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.
.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
.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
.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
.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
.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