rjhead 0.2.88

data/ext/gpsinfo.c

@@ -0,0 +1,217 @@
+//--------------------------------------------------------------------------
+// Parsing of GPS info from exif header.
+//
+// Matthias Wandel,  Dec 1999 - Dec 2002 
+//--------------------------------------------------------------------------
+#include "jhead.h"
+
+#define MAX_GPS_TAG 0x1e
+
+
+#define TAG_GPS_LAT_REF    1
+#define TAG_GPS_LAT        2
+#define TAG_GPS_LONG_REF   3
+#define TAG_GPS_LONG       4
+#define TAG_GPS_ALT_REF    5
+#define TAG_GPS_ALT        6
+
+
+static const char * GpsTags[MAX_GPS_TAG+1]= {
+    "VersionID       ",//0x00  
+    "LatitudeRef     ",//0x01  
+    "Latitude        ",//0x02  
+    "LongitudeRef    ",//0x03  
+    "Longitude       ",//0x04  
+    "AltitudeRef     ",//0x05  
+    "Altitude        ",//0x06  
+    "TimeStamp       ",//0x07  
+    "Satellites      ",//0x08  
+    "Status          ",//0x09  
+    "MeasureMode     ",//0x0A  
+    "DOP             ",//0x0B  
+    "SpeedRef        ",//0x0C  
+    "Speed           ",//0x0D  
+    "TrackRef        ",//0x0E  
+    "Track           ",//0x0F  
+    "ImgDirectionRef ",//0x10  
+    "ImgDirection    ",//0x11  
+    "MapDatum        ",//0x12  
+    "DestLatitudeRef ",//0x13  
+    "DestLatitude    ",//0x14  
+    "DestLongitudeRef",//0x15  
+    "DestLongitude   ",//0x16  
+    "DestBearingRef  ",//0x17  
+    "DestBearing     ",//0x18  
+    "DestDistanceRef ",//0x19  
+    "DestDistance    ",//0x1A  
+    "ProcessingMethod",//0x1B  
+    "AreaInformation ",//0x1C  
+    "DateStamp       ",//0x1D  
+    "Differential    ",//0x1E
+};
+
+//--------------------------------------------------------------------------
+// Process GPS info directory
+//--------------------------------------------------------------------------
+void ProcessGpsInfo(unsigned char * DirStart, int ByteCountUnused, unsigned char * OffsetBase, unsigned ExifLength)
+{
+    int de;
+    unsigned a;
+    int NumDirEntries;
+
+    NumDirEntries = Get16u(DirStart);
+    #define DIR_ENTRY_ADDR(Start, Entry) (Start+2+12*(Entry))
+
+    if (ShowTags){
+        printf("(dir has %d entries)\n",NumDirEntries);
+    }
+
+    ImageInfo.GpsInfoPresent = TRUE;
+    strcpy(ImageInfo.GpsLat, "? ?");
+    strcpy(ImageInfo.GpsLong, "? ?");
+    ImageInfo.GpsAlt[0] = 0; 
+
+    for (de=0;de<NumDirEntries;de++){
+        unsigned Tag, Format, Components;
+        unsigned char * ValuePtr;
+        int ComponentSize;
+        unsigned ByteCount;
+        unsigned char * DirEntry;
+        DirEntry = DIR_ENTRY_ADDR(DirStart, de);
+
+        if (DirEntry+12 > OffsetBase+ExifLength){
+            ErrNonfatal("GPS info directory goes past end of exif",0,0);
+            return;
+        }
+
+        Tag = Get16u(DirEntry);
+        Format = Get16u(DirEntry+2);
+        Components = Get32u(DirEntry+4);
+
+        if ((Format-1) >= NUM_FORMATS) {
+            // (-1) catches illegal zero case as unsigned underflows to positive large.
+            ErrNonfatal("Illegal number format %d for Exif gps tag %04x", Format, Tag);
+            continue;
+        }
+
+        ComponentSize = BytesPerFormat[Format];
+        ByteCount = Components * ComponentSize;
+
+        if (ByteCount > 4){
+            unsigned OffsetVal;
+            OffsetVal = Get32u(DirEntry+8);
+            // If its bigger than 4 bytes, the dir entry contains an offset.
+            if (OffsetVal+ByteCount > ExifLength){
+                // Bogus pointer offset and / or bytecount value
+                ErrNonfatal("Illegal value pointer for Exif gps tag %04x", Tag,0);
+                continue;
+            }
+            ValuePtr = OffsetBase+OffsetVal;
+        }else{
+            // 4 bytes or less and value is in the dir entry itself
+            ValuePtr = DirEntry+8;
+        }
+
+        switch(Tag){
+            char FmtString[21];
+            char TempString[50];
+            double Values[3];
+
+            case TAG_GPS_LAT_REF:
+                ImageInfo.GpsLat[0] = ValuePtr[0];
+                break;
+
+            case TAG_GPS_LONG_REF:
+                ImageInfo.GpsLong[0] = ValuePtr[0];
+                break;
+
+            case TAG_GPS_LAT:
+            case TAG_GPS_LONG:
+                if (Format != FMT_URATIONAL){
+                    ErrNonfatal("Inappropriate format (%d) for Exif GPS coordinates!", Format, 0);
+                }
+                strcpy(FmtString, "%0.0fd %0.0fm %0.0fs");
+                for (a=0;a<3;a++){
+                    int den, digits;
+
+                    den = Get32s(ValuePtr+4+a*ComponentSize);
+                    digits = 0;
+                    while (den > 1 && digits <= 6){
+                        den = den / 10;
+                        digits += 1;
+                    }
+                    if (digits > 6) digits = 6;
+                    FmtString[1+a*7] = (char)('2'+digits+(digits ? 1 : 0));
+                    FmtString[3+a*7] = (char)('0'+digits);
+
+                    Values[a] = ConvertAnyFormat(ValuePtr+a*ComponentSize, Format);
+                }
+
+                sprintf(TempString, FmtString, Values[0], Values[1], Values[2]);
+
+                if (Tag == TAG_GPS_LAT){
+                    strncpy(ImageInfo.GpsLat+2, TempString, 29);
+                }else{
+                    strncpy(ImageInfo.GpsLong+2, TempString, 29);
+                }
+                break;
+
+            case TAG_GPS_ALT_REF:
+                ImageInfo.GpsAlt[0] = (char)(ValuePtr[0] ? '-' : ' ');
+                break;
+
+            case TAG_GPS_ALT:
+                sprintf(ImageInfo.GpsAlt + 1, "%.2fm", 
+                    ConvertAnyFormat(ValuePtr, Format));
+                break;
+        }
+
+        if (ShowTags){
+            // Show tag value.
+            if (Tag < MAX_GPS_TAG){
+                printf("        GPS%s =", GpsTags[Tag]);
+            }else{
+                // Show unknown tag
+                printf("        Illegal GPS tag %04x=", Tag);
+            }
+
+            switch(Format){
+                case FMT_UNDEFINED:
+                    // Undefined is typically an ascii string.
+
+                case FMT_STRING:
+                    // String arrays printed without function call (different from int arrays)
+                    {
+                        printf("\"");
+                        for (a=0;a<ByteCount;a++){
+                            int ZeroSkipped = 0;
+                            if (ValuePtr[a] >= 32){
+                                if (ZeroSkipped){
+                                    printf("?");
+                                    ZeroSkipped = 0;
+                                }
+                                putchar(ValuePtr[a]);
+                            }else{
+                                if (ValuePtr[a] == 0){
+                                    ZeroSkipped = 1;
+                                }
+                            }
+                        }
+                        printf("\"\n");
+                    }
+                    break;
+
+                default:
+                    // Handle arrays of numbers later (will there ever be?)
+                    for (a=0;;){
+                        PrintFormatNumber(ValuePtr+a*ComponentSize, Format, ByteCount);
+                        if (++a >= Components) break;
+                        printf(", ");
+                    }
+                    printf("\n");
+            }
+        }
+    }
+}
+
+   

data/ext/iptc.c

@@ -0,0 +1,205 @@
+//--------------------------------------------------------------------------
+//  Process IPTC data and XMP data.
+//--------------------------------------------------------------------------
+#include "jhead.h"
+
+// IPTC entry types known to Jhead (there's many more defined)
+#define IPTC_RECORD_VERSION         0x00
+#define IPTC_SUPLEMENTAL_CATEGORIES 0x14
+#define IPTC_KEYWORDS               0x19
+#define IPTC_CAPTION                0x78
+#define IPTC_AUTHOR                 0x7A
+#define IPTC_HEADLINE               0x69
+#define IPTC_SPECIAL_INSTRUCTIONS   0x28
+#define IPTC_CATEGORY               0x0F
+#define IPTC_BYLINE                 0x50
+#define IPTC_BYLINE_TITLE           0x55
+#define IPTC_CREDIT                 0x6E
+#define IPTC_SOURCE                 0x73
+#define IPTC_COPYRIGHT_NOTICE       0x74
+#define IPTC_OBJECT_NAME            0x05
+#define IPTC_CITY                   0x5A
+#define IPTC_STATE                  0x5F
+#define IPTC_COUNTRY                0x65
+#define IPTC_TRANSMISSION_REFERENCE 0x67
+#define IPTC_DATE                   0x37
+#define IPTC_COPYRIGHT              0x0A
+#define IPTC_COUNTRY_CODE           0x64
+#define IPTC_REFERENCE_SERVICE      0x2D
+#define IPTC_TIME_CREATED           0x3C
+#define IPTC_SUB_LOCATION           0x5C
+#define IPTC_IMAGE_TYPE             0x82
+
+//--------------------------------------------------------------------------
+//  Process and display IPTC marker.
+//
+//  IPTC block consists of:
+//      - Marker:               1 byte      (0xED)
+//      - Block length:         2 bytes
+//      - IPTC Signature:       14 bytes    ("Photoshop 3.0\0")
+//      - 8BIM Signature        4 bytes     ("8BIM")
+//      - IPTC Block start      2 bytes     (0x04, 0x04)
+//      - IPTC Header length    1 byte
+//      - IPTC header           Header is padded to even length, counting the length byte
+//      - Length                4 bytes
+//      - IPTC Data which consists of a number of entries, each of which has the following format:
+//              - Signature     2 bytes     (0x1C02)
+//              - Entry type    1 byte      (for defined entry types, see #defines above)
+//              - entry length  2 bytes
+//              - entry data    'entry length' bytes
+//
+//--------------------------------------------------------------------------
+void show_IPTC (unsigned char* Data, unsigned int itemlen)
+{
+    const char IptcSig1[] = "Photoshop 3.0";
+    const char IptcSig2[] = "8BIM";
+    const char IptcSig3[] = {0x04, 0x04};
+
+    unsigned char * pos    = Data + sizeof(short);   // position data pointer after length field
+    unsigned char * maxpos = Data+itemlen;
+    char  headerLen = 0;
+
+    if (itemlen < 25) goto corrupt;
+
+    // Check IPTC signatures
+    if (memcmp(pos, IptcSig1, sizeof(IptcSig1)-1) != 0) goto badsig;
+    pos += sizeof(IptcSig1);      // move data pointer to the next field
+
+    if (memcmp(pos, IptcSig2, sizeof(IptcSig2)-1) != 0) goto badsig;
+    pos += sizeof(IptcSig2)-1;          // move data pointer to the next field
+
+    if (memcmp(pos, IptcSig3, sizeof(IptcSig3)) != 0){
+badsig:
+        if (ShowTags){
+            ErrNonfatal("IPTC type signature mismatch\n",0,0);
+        }
+        return;
+    }
+    pos += sizeof(IptcSig3);          // move data pointer to the next field
+
+    if (pos >= maxpos) goto corrupt;
+
+    // IPTC section found
+
+    // Skip header
+    headerLen = *pos++;                     // get header length and move data pointer to the next field
+    pos += headerLen + 1 - (headerLen % 2); // move data pointer to the next field (Header is padded to even length, counting the length byte)
+
+    if (pos+4 >= maxpos) goto corrupt;
+
+    // Get length (from motorola format)
+    //length = (*pos << 24) | (*(pos+1) << 16) | (*(pos+2) << 8) | *(pos+3);
+
+    pos += 4;                    // move data pointer to the next field
+
+    printf("======= IPTC data: =======\n");
+
+    // Now read IPTC data
+    while (pos < (Data + itemlen-5)) {
+        short  signature;
+        unsigned char   type = 0;
+        short  length = 0;
+        char * description = NULL;
+
+        if (pos+5 > maxpos) goto corrupt;
+
+        signature = (*pos << 8) + (*(pos+1));
+        pos += 2;
+
+        if (signature != 0x1C02){
+            break;
+        }
+
+        type    = *pos++;
+        length  = (*pos << 8) + (*(pos+1));
+        pos    += 2;                          // Skip tag length
+
+        if (pos+length > maxpos) goto corrupt;
+        // Process tag here
+        switch (type) {
+            case IPTC_RECORD_VERSION:
+                printf("Record vers.  : %d\n", (*pos << 8) + (*(pos+1)));
+                break;
+
+            case IPTC_SUPLEMENTAL_CATEGORIES:  description = "SuplementalCategories"; break;
+            case IPTC_KEYWORDS:                description = "Keywords"; break;
+            case IPTC_CAPTION:                 description = "Caption"; break;
+            case IPTC_AUTHOR:                  description = "Author"; break;
+            case IPTC_HEADLINE:                description = "Headline"; break;
+            case IPTC_SPECIAL_INSTRUCTIONS:    description = "Spec. Instr."; break;
+            case IPTC_CATEGORY:                description = "Category"; break;
+            case IPTC_BYLINE:                  description = "Byline"; break;
+            case IPTC_BYLINE_TITLE:            description = "Byline Title"; break;
+            case IPTC_CREDIT:                  description = "Credit"; break;
+            case IPTC_SOURCE:                  description = "Source"; break;
+            case IPTC_COPYRIGHT_NOTICE:        description = "(C)Notice"; break;
+            case IPTC_OBJECT_NAME:             description = "Object Name"; break;
+            case IPTC_CITY:                    description = "City"; break;
+            case IPTC_STATE:                   description = "State"; break;
+            case IPTC_COUNTRY:                 description = "Country"; break;
+            case IPTC_TRANSMISSION_REFERENCE:  description = "OriginalTransmissionReference"; break;
+            case IPTC_DATE:                    description = "DateCreated"; break;
+            case IPTC_COPYRIGHT:               description = "(C)Flag"; break;
+            case IPTC_REFERENCE_SERVICE:       description = "Country Code"; break;
+            case IPTC_COUNTRY_CODE:            description = "Ref. Service"; break;
+            case IPTC_TIME_CREATED:            description = "Time Created"; break;
+            case IPTC_SUB_LOCATION:            description = "Sub Location"; break;
+            case IPTC_IMAGE_TYPE:              description = "Image type"; break;
+
+            default:
+                if (ShowTags){
+                    printf("Unrecognised IPTC tag: %d\n", type );
+                }
+            break;
+        }
+        if (description != NULL) {
+            char TempBuf[32];
+            memset(TempBuf, 0, sizeof(TempBuf));
+            memset(TempBuf, ' ', 14);
+            memcpy(TempBuf, description, strlen(description));
+            strcat(TempBuf, ":"); 
+            printf("%s %*.*s\n", TempBuf, length, length, pos);
+        }
+        pos += length;
+    }
+    return;
+corrupt:
+    ErrNonfatal("Pointer corruption in IPTC\n",0,0);
+}
+
+
+
+//--------------------------------------------------------------------------
+// Dump contents of XMP section
+//--------------------------------------------------------------------------
+void ShowXmp(Section_t XmpSection)
+{
+    unsigned char * Data;
+    char OutLine[101];
+    int OutLineChars;
+    int NonBlank;
+    unsigned a;
+    NonBlank = 0;
+    Data = XmpSection.Data;
+    OutLineChars = 0;
+
+
+    for (a=0;a<XmpSection.Size;a++){
+        if (Data[a] >= 32 && Data[a] < 128){
+            OutLine[OutLineChars++] = Data[a];
+            if (Data[a] != ' ') NonBlank |= 1;
+        }else{
+            if (Data[a] != '\n'){
+                OutLine[OutLineChars++] = '?';
+            }
+        }
+        if (Data[a] == '\n' || OutLineChars >= 100){
+            OutLine[OutLineChars] = 0;
+            if (NonBlank){
+                puts(OutLine);
+            }
+            NonBlank = (NonBlank & 1) << 1;
+            OutLineChars = 0;
+        }
+    }
+}

data/ext/jhead.1

@@ -0,0 +1,409 @@
+.TH JHEAD 1 "06 Nov 2009" "jhead 2.88"
+.SH NAME
+jhead \- Digicam JPEG Exif header manipulation tool
+.SH SYNOPSIS
+.B jhead
+[
+.I options
+]
+[
+.I file\.\.\.
+]
+
+.LP
+.SH DESCRIPTION
+.LP
+.B jhead
+is used to display and manipulate data contained in the Exif header of JPEG
+images from digital cameras.  By default, jhead displays the more useful
+camera settings from the file in a user-friendly format.
+.PP
+.B jhead
+can also be used to manipulate some aspects of the image relating to JPEG and
+Exif headers, such as changing the internal timestamps, removing the thumbnail,
+or transferring Exif headers back into edited images after graphical editors
+deleted the Exif header.
+.B jhead
+can also be used to launch other programs, similar in style to the UNIX
+.B find
+command, but much simpler.
+
+
+.SH GENERAL METADATA OPTIONS
+.TP
+.BI \-\^te \ file
+Transplant Exif header from a JPEG (with Exif header) in
+.I file
+into the image that is manipulated.  This option is
+useful if you like to edit the photos but still want the Exif header on your photos.
+As most photo editing programs will wipe out the Exif header, this option can be used
+to re-copy them back from original copies after editing the photos.
+
+
+This feature has an interesting 'relative path' option for specifying the
+thumbnail name.  Whenever the <name> contains the characters '&i',
+will substitute the original  filename for this name. This allows creating a
+jhead 'relative name' when doing a whole batch  of files. For example, the
+incantation:
+
+.B jhead -te "originals\&i" *.jpg
+
+would transfer the exif header for each .jpg file in the originals directory by
+the same name, Both Win32 and most Unix shells treat the '&' character in a
+special way, so you have to put quotes around that command line option for
+the '&' to even be passed to the program.
+
+.TP
+.B \-dc
+Delete comment field from the JPEG header.  Note that the comment
+is not part of the Exif header.
+.TP
+.B \-de
+Delete the Exif header entirely.  Leaves other metadata sections intact.
+.TP
+.B \-di
+Delete the IPTC section, if present.  Leaves other metadata sections intact.
+.TP
+.B \-dx
+Delete the XMP section, if present.  Leaves other metadata sections intact.
+.TP
+.B \-du
+Delete sections of jpeg that are not Exif, not comment, and otherwise not
+contributing to the image either - such as data that photoshop might leave in the image.
+.TP
+.B \-purejpg
+Delete all JPEG sections that aren't necessary for rendering the image.  Strips any
+metadata that various applications may have left in the image.  A combination of
+the -de -dc and -du options.
+.TP
+.B \-mkexif
+Creates minimal exif header. Exif header contains date/time, and empty thumbnail
+fields only. Date/time set to file time by default. Use with -rgt option if you
+want the exif header to contain a thumbnail. Note that exif header creation is
+very limited at this time, and no other fields can be added to the exif header
+this way.
+.TP
+.B \-ce
+Edit the JPEG header comment field (note, this comment field is outside the Exif structure
+and can be part of Exif and non Exif style JPEG images).
+
+A temporary file containing the comment is created and a text editor is launched to edit
+the file.  The editor is specified in the EDITOR environment variable.  If none is specified
+notepad or vi are used under Windows and Unix respectively.  After the editor exits,
+the data is transferred back into the image, and the temporary file deleted.
+.TP
+.BI \-\^cs \ file
+Save comment section to a
+.I file
+.TP
+.BI \-\^ci \ file
+Replace comment with text from
+.I file
+.TP
+.BI \-\^cl \ string
+Replace comment with specified string from command line
+.IR file
+
+
+
+.SH DATE / TIME MANIPULATION OPTIONS
+
+.TP
+.B \-ft
+Sets the file's system time stamp to what is stored in the Exif header.
+.TP
+.B \-dsft
+Sets the Exif timestamp to the file's timestamp. Requires an Exif header to
+pre-exist. Use -mkexif option to create one if needed.
+.TP
+.BI \-\^n [format_string]
+This option causes files to be renamed and/ or mmoved using the date information from the Exif header
+"DateTimeOriginal" field.
+If the file is not an Exif file, or the DateTimeOriginal does not contain a valid value,
+the file date is used.
+Renaming is by default restricted to files whose names consist largely of digits.
+This effectively restricts renaming to files that have not already been manually renamed, as
+the default sequential names from digital cameras consist largely of digits.
+Use the
+.B -nf
+option to force renaming of all files.
+If the new name contains a '/', this will be interpreted as a new path, and the file will be
+moved accordingly.
+                  
+
+If the
+.I format_string
+is omitted, the file will be renamed to MMDD-HHMMSS.  Note that
+this scheme doesn't include the year (I never have photos from different years together anyway).
+
+If a
+.I format_string
+is provided, it will be passed to the strftime function as the format string.
+In addition, if the format string contains '%f', this will
+substitute the original name of the file (minus extension).  '%i' will substitute a sequence
+number.  Leading zeros can be specified like with printf - i.e. '%04i' pads the number to 4
+digits using leading zeros.
+
+If the name includes '/', this is interpreted as a new path for the file.  
+If the new path does not exist, the path will be created.
+
+If the target name already exists, the name will be appended with "a", "b", "c", etc,
+unless the name ends with a letter, in which case it will be appended with "0", "1", "2", etc.
+
+This feature is especially useful if more than one digital camera was used to take pictures
+of an event.  By renaming them to a scheme according to date, they will automatically
+appear in order of taking in most directory listings and image browsers.  Alternatively,
+if your image browser supports listing by file time, you can use the -ft option to set
+the file time to the time the photo was taken.
+
+Some of the more useful arguments for strftime are:
+
+.BR %H \ Hour\ in\ 24-hour\ format\ (00\ -\ 23)
+.br
+.BR %j \ Day\ of\ year\ as\ decimal\ number\ (001\ -\ 366)
+.br
+.BR %m \ Month\ as\ decimal\ number\ (01\ -\ 12)
+.br
+.BR %M \ Minute\ as\ decimal\ number\ (00\ -\ 59)
+.br
+.BR %S \ Second\ as\ decimal\ number\ (00\ -\ 59)
+.br
+.BR %w \ Weekday\ as\ decimal\ number\ (0\ -\ 6;\ Sunday\ is\ 0)
+.br
+.BR %y \ Year\ without\ century,\ as\ decimal\ number\ (00\ -\ 99)
+.br
+.BR %Y \ Year\ with\ century,\ as\ decimal\ number
+
+Example:
+
+.B jhead -n%Y%m%d-%H%M%S *.jpg
+This will rename files matched by *.jpg in the format YYYYMMDD-HHMMSS
+
+For a full listing of strftime arguments, look up the strftime in them man pages.
+Note that some arguments
+to the strftime function (not listed here) produce strings with characters such as ':' that
+may not be valid as part of a filename on some systems.
+
+.TP
+.B \-nf
+Same as '-n' but renames files regardless of original file name.
+
+
+.TP
+.B \-ta<+|-><timediff>
+Adjust time stored in the Exif header by h:mm backwards or forwards.  Useful when having
+taken pictures with the wrong time set on the camera, such as after travelling across
+time zones, or when daylight savings time has changed.
+
+This option changes all Date/time fields in the exif header, including "DateTimeOriginal" (tag 0x9003)
+and "DateTimeDigitized" (tag 0x9004).
+.TP
+.B \-da<newdate>-<olddate>
+
+Works like -ta, but for specifying large date offsets, to be used when fixing dates from
+cameras where the date was set incorrectly, such as having date and time reset by battery
+removal on some cameras
+
+Because different months and years have different numbers of days in them, a simple offset
+for months, days, years would lead to unexpected results at times.  The time offset is
+thus specified as a difference between two dates, so that jhead can figure out exactly
+how many days the timestamp needs to be adjusted by, including leap years and daylight
+savings time changes.
+The dates are specified as yyyy:mm:dd.  For sub-day adjustments, a time of day can also
+be included, by specifying yyyy:nn:dd/hh:mm or yyyy:mm:dd/hh:mm:ss
+
+Examples:
+
+Year on camera was set to 2005 instead of 2004 for pictures taken in April
+.br
+jhead -da2004:03:01-2005:03:01
+
+Default camera date is 2002:01:01, and date was reset on 2005:05:29 at 11:21 am
+.br
+jhead -da2005:05:29/11:21-2002:01:01
+.TP
+.B \-ts
+Sets the time stored in the Exif header to what is specified on the command line.
+Time must be specified as:
+.I yyyy:mm:dd-hh:mm:ss
+.TP
+.B \-ds
+Sets the date stored in the Exif header to what is specified on the command line.
+Can be used to set date, just year and month, or just year.
+Date is specified as:
+.I yyyy:mm:dd,  yyyy:mm, or yyyy
+
+
+.SH THUMBNAIL MANIPULATION OPTIONS
+
+.TP
+.B \-dt
+Delete thumbnails from the Exif header, but leave the
+interesting parts intact.  This option truncates the thumbnail from the Exif header, provided
+that the thumbnail is the last part of the Exif header (which so far as I know is always the case).
+Exif headers have a built-in thumbnail, which typically
+occupies around 10k of space.  This thumbnail is used by digital cameras.  Windows XP may also
+use this thumbnail if present (but it doesn't need it).  The
+thumbnails are too small to use even full screen on the digicam's LCD.
+I have not encountered any adverse side effects of deleting the thumbnails, even from the
+software provided with my old Olympus digicam.  Use with caution.
+
+.TP
+.BI \-\^st \ file
+Save the integral thumbnail to
+.I file
+The thumbnail lives
+inside the Exif header, and is a very low-res JPEG image.  Note that making
+any changes to a photo, except for with some programs, generally wipes out the Exif header
+and with it the thumbnail.
+
+The thumbnail is too low res to really use for very much.
+
+This feature has an interesting 'relative path' option for specifying the thumbnail name.
+Whenever the name for
+.I file
+contains the characters  '&i',
+.B jhead
+will substitute the original
+filename for this name.  This allows creating a 'relative name' when doing a whole
+batch of files.  For example, the incantation:
+
+.B jhead -st "thumbnails/&i" *.jpg
+
+would create a thumbnail for each .jpg file in the thumbnails directory by the same name,
+(provided that the thumbnails directory exists, of course).
+Both Win32 and UNIX shells treat the '&'character in a special way, so you have to
+put quotes around that command line option for the '&' to even be passed to the program.
+
+If a '-' is specified for the output file, the thumbnail is sent to stdout. (UNIX build only)
+
+.TP
+.B \-rt
+Replace thumbnails from the Exif header.
+This only works if the exif header already contains a thumbnail, and the thumbnail is at the
+end of the header (both always the case if the photo came from a digital camera)
+.TP
+.BI \-\^rgt \ size
+Regenerate exif thumbnail.  'size' specifies maximum height or width of thumbnail.
+Relies on 'mogrify' program (from ImageMagick) to regenerate the thumbnail.
+This only works if the image already contains a thumbnail.
+
+.SH ROTATION OPTIONS
+.TP
+.B \-autorot
+Using the 'Orientation' tag of the Exif header, rotate the image so that it is upright.
+The program
+.B jpegtran
+is used to perform the rotation. This program is present in most
+Linux distributions.  For windows, you need to get a copy of it.  After rotation, the
+orientation tag of the Exif header is set to '1' (normal orientation).  The thumbnail
+is also rotated. Other fields of the Exif header, including
+dimensions are untouched, but the JPEG height/width are adjusted.
+This feature is especially useful with newer Canon cameras, that set the orientation
+tag automatically using a gravity sensor.
+.TP
+.B \-norot
+Clears the rotation field in the Exif header without altering the image.  Useful if
+the images were previously rotated without clearing the Exif rotation tag, as some
+image browsers will auto rotate images when the rotation tag is set.
+Sometimes, thumbnails and rotation  tags can get very out of sync from manipulation
+with various tools.  To reset it all use -norot with -rgt to clear this out.
+
+.SH OUTPUT VERBOSITY CONTROL
+.TP
+.B \-h
+Displays summary of command line options.
+.TP
+.B \-v
+Makes the program even more verbose than it already is.  Like DOS programs, and unlike
+UNIX programs, Jhead gives feedback as to what it is doing, even when nothing goes wrong.
+Windows user that I am, when something doesn't give me feedback for 20 seconds, I assume
+its crashed.
+.TP
+.B \-q
+No output on success, more like Unix programs.
+.TP
+.B \-V
+Print version info and compilation date.
+.B \-exifmap
+Show a map of the bytes in the exif header. Useful when analyzing strange exif headers,
+not of much use to non software developers.
+.TP
+.B \-se
+Suppress error messages relating to corrupt Exif header structure.
+.TP
+.B \-c
+Concise output.  This causes picture info to be summarized on one line instead of several.
+Useful for grep-ing through images, as well as importing into spread sheets (data is space
+delimited with quotes as text qualifier).
+
+.SH FILE MATCHING OPTIONS
+.TP
+.B \-model
+Restricts processing of files to those whose camera model, as indicated by the Exif image
+information, contains the substring specified in the argument after '-model'.
+For example, the following command will list only images that are from an S100 camera:
+
+.B jhead -model S100 *.jpg
+
+.B jhead -model S100 *.jpg
+
+I use this option to restrict my JPEG recompensing to those images that came from my
+Canon S100 digicam, (see the -cmd option).
+.TP
+.B \-exonly
+Skip all files that don't have an Exif header.  Photos straight from a digital camera
+have an Exif header, whereas many photo manipulation tools discard the Exif header.
+.TP
+.B \-cmd
+Executes the specified command on each JPEG file to be processed.
+
+The Exif section of each file is read before running the command, and reinserted
+after the command finishes.
+
+The specified command invoked separately for each JPEG that is processed, even if
+multiple files are specified (explicitly or by wild card).
+
+Example use:
+
+Having a whole directory of photos from my S100, I run the following commands:
+
+.B jhead -cmd "mogrify -quality 80 &i" -model S100 -r *.jpg
+.br
+.B jhead -cmd "jpegtran -progressive &i > &o" -r *.jpg
+
+The first command mogrifies all JPEGs in the tree that indicate that they are from a
+Canon S100 in their Exif header to 80% quality at the same resolution.  This is a 'lossy'
+process, so I only run it on files that are from the Canon, and only run it once.
+The next command then takes a JPEGs and converts them to progressive JPEGs.  The result
+is the same images, with no discernible differences, stored in half the space.  This 
+produces substantial savings on some cameras.
+
+.SH SEE ALSO
+.BR jpegtran (1),
+.BR mogrify (1),
+.BR rdjpgcom (1),
+.BR wrjpgcom (1)
+.SH AUTHOR
+Matthias Wandel
+.SH BUGS
+After jhead runs a program to rotate or resize an image, the image dimensions and thumbnail
+in the Exif header are not adjusted.
+.PP
+Modifying of Exif header data is very limited, as Jhead internally only has a read only
+implementation of the file system contained in the Exif header.  For example, there is no way
+to replace the thumbnail or edit the Exif comment in the Exif header.  There is also no way
+to create minimal exif headers.
+.PP
+Some Canon digital SLR cameras fail to adjust the effective sensor resolution when shooting at less
+than full resolution, causing jhead to incorrectly miscalculate the sensor width and 35mm equivalent
+focal length.  The same can result from resizing photos with Photoshop, which will manipulate
+parts of the exif header.
+This is often reported as a bug in Jhead, but Jhead can't do much about incorrect data.
+.PP
+Send bug reports to mwandel at sentex dot net.
+
+.SH COPYING PERMISSIONS
+Jhead is 'public domain'.  You may freely copy jhead, and reuse part or all of its code
+in free or proprietary programs.   I do however request that you do not post my e-mail
+address in ways that spam robots can harvest it.