Upgrading to exiftool v12.70

bin/Changes

@@ -4,24 +4,74 @@ ExifTool Version History
 
 RSS feed: https://exiftool.org/rss.xml
 
-Note: The most recent production release is Version 12.60. (Other versions are
+Note: The most recent production release is Version 12.70. (Other versions are
 considered development releases, and are not uploaded to MetaCPAN.)
 
+Nov. 19, 2023 - Version 12.70 (production release)
+
+  - This marks the 20th anniversary of the initial ExifTool release!
+  - Added ability to read/delete C2PA CAI JUMBF metadata from TIFF-based images
+    (eg. DNG), QuickTime-based files (eg. MP4) and WebP images, and read JUMBF
+    from other RIFF-based files (eg. WAV, AVI), GIF images and ID3v2 metadata
+  - Added read/write support for JPH images
+  - Added ability to read Leica Q3 maker notes
+  - Added ability to recognize and write FujiFilm M-RAW RAF images (multiple raw
+    images in a single file) and the ability to read preview-less RAF images
+  - Added support for reading a number of obscure Microsoft EXIF tags
+  - Added a few new Sony lenses and support for the ILCE-9M3 (thanks Jos Roost)
+  - Added a couple of new Panasonic Leica lenses
+  - Added a couple of new Canon RF lenses (thanks Norbert Wasser)
+  - Added a number of new CPUType values for ELF executables
+  - Added some new Olympus CameraType values
+  - Decode a few more ID3v2.2 tags (github #142)
+  - Decode a few new Canon G5X Mark II tags (thanks Martin B.)
+  - Decode WB_RGGBLevels for a few more Nikon cameras
+  - Extract information from FujiFilm M-RAW header
+  - Improved decoding of a few Nikon Z tags (thanks Warren Hatch)
+  - Marked misspelt XMP-drone-dji:GPSLongtitude tag to Avoid when writing
+  - Changed RIFF MaxDataRate conversion to use SI prefixes by default
+  - Fixed decoding of unknown ColorBalance information for some Nikon models
+  - Fixed an incorrect Nikon Z LensID
+  - API Changes:
+      - Added ByteUnit option
+
+Oct. 26, 2023 - Version 12.69
+
+  - Added support for DNG version 1.7.0.0
+  - Added a new XMP-GCamera tag
+  - Added a number of new Nikon Z lenses (thanks Warren Hatch and Stefan)
+  - Added a number of new XMP-crs tags
+  - Extract XML metadata from some Hasselblad images
+  - Tweaked -fast2 option to read metadata from inside mdat atom of HEIC images
+  - Patched FFF reader to be more tolerant of the mess made by incompetent
+    Hasselblad programmers (wrong IFD count for some values)
+  - Patched WebP reader to be more tolerant of the mess made by incompetent
+    Google programmers (EXIF with wrong header and XMP with wrong ID)
+  - Fixed writing of MakerNotes as a block to CR3 images (now properly stored in
+    the CMT3 chunk instead of the ExifIFD) and added ability to delete them from
+    the ExifIFD of CR3 images
+  - Fixed problem which could cause runtime error when copying MakerNotes from a
+    file that contains multiple maker note blocks
+  - Fixed problem which could cause "use of uninitialized variable" warnings
+    when reading images from some Nikon cameras
+  - Fixed List type for new XMP-photomech:CreatorIdentity tag
+
 Oct. 16, 2023 - Version 12.68
 
   - Added preliminary read support for XISF images
-  - Added the ability to delete JUMBF metadata from PNG images
+  - Added the ability to delete CAI JUMBF metadata from PNG images
   - Added support for writing Canon burst-roll CR3 images
-  - Added a new Nikon Z9 SubjectDetection value, and improved Zf support
+  - Added a new Nikon Z9 SubjectDetection value, and improved Zf support (thanks
+    Warren Hatch)
   - Added a couple of new PentaxModelID values
   - Added a few couple of new tag values for the Pentax K-3 Mark III Monochrome (github #226)
-  - Added a support for a new XMP-photomech tag
+  - Added a new XMP-photomech tag
+  - Added a new QuickTime ItemList tag
   - Added a new Nikon LensID
   - Added a new Canon LensType
-  - Added a new QuickTime ItemList tag
   - Support decimal values for FujiFilm ShadowTone and HighlightTone tags
   - Decode some new Sony tags (thanks Jos Roost)
-  - Decode ShutterCount for Canon EOS R6 (thanks gamin)
+  - Decode ShutterCount for Canon EOS R6 (thanks Martin B.)
   - Decode QuickTime VideoFullRangeFlag
   - Decode JPGCompression for the Nikon D3S
   - Enhanced -geotag feature to allow writing QuickTime:GPSCoordinates
@@ -176,8 +226,6 @@ Apr. 5, 2023 - Version 12.60 (production release)
   - Fixed problem where setting the Geotime value didn't work when using an
     advanced-formatting expression containing a greater-than symbol (>)
 
-History of older versions (back to Nov. 19, 2003 - Version 1.00) -->
-
 Mar. 28, 2023 - Version 12.59
 
   - COMPATIBILITY WARNING: Changed the calculated ImageDataMD5 for JPEG images
@@ -307,7 +355,7 @@ Dec. 6, 2022 - Version 12.52
 Nov. 21, 2022 - Version 12.51
 
   - Added a new Olympus LensType (thanks Herb)
-  - Extract C2PA JUMBF metadata from PNG images and extract C2PA Salt values
+  - Extract C2PA CAI JUMBF metadata from PNG images and extract C2PA Salt values
   - Decode NikonSettings for Z9 firmware 3.0 (thanks Warren Hatch)
   - Decode additional camm metadata from Insta360 Pro2 MP4 videos
   - Improved Verbose output when writing Composite tags to add a "+" sign to
@@ -690,8 +738,8 @@ Oct. 16, 2021 - Version 12.33
 
 Sept. 30, 2021 - Version 12.32
 
-  - Added support for CBOR-format metadata in JUMBF (note that JUMBF support is
-    still experimental)
+  - Added support for CBOR-format metadata in CAI JUMBF (note that JUMBF support
+    is still experimental)
   - Added a new Nikon LensID
   - Added a new Pentax LensType
   - Decode timed GPS for two more dashcam formats
@@ -750,7 +798,7 @@ July 9, 2021 - Version 12.29
   - Improved a QuickTime "File format error" message to be more meaningful, and
     made it a minor error
   - Changed PNG writer to add EXIF before IDAT
-  - Some changes the way JUMBF metadata is handled
+  - Some changes the way CAI JUMBF metadata is handled
   - Patched to read timed GPS from a different type of INSV videos
   - Patched a security issue
   - Fixed problem where ExifTool could hang when processing mebx timed metadata
@@ -826,16 +874,16 @@ Apr. 13, 2021 - Version 12.24
   - Decode a few new Panasonic and FujiFilm tags (thanks LibRaw and Greybeard)
   - Updated acdsee.config in distribution (thanks StarGeek)
   - Recognize AutoCAD DXF files
-  - More work on experimental JUMBF read support
+  - More work on experimental CAI JUMBF read support
   - More work on experimental JPEG XL read/write support
   - Patched security vulnerability in DjVu reader
 
 Apr. 1, 2021 - Version 12.23
 
   - Added support for Olympus ORI files
   - Added experimental read/write support for JPEG XL images
-  - Added experimental read support for JUMBF metadata in JPEG and Jpeg2000
-    images
+  - Added experimental read support for CAI (Content Authenticity Initiative)
+    JUMBF-format metadata in JPEG and Jpeg2000 images
   - Added built-in support for parsing GPS track from Denver ACG-8050 videos
     with the -ee option
   - Added a some new Sony lenses (thanks Jos Roost and LibRaw)

bin/META.json

@@ -50,5 +50,5 @@
       }
    },
    "release_status" : "stable",
-   "version" : "12.68"
+   "version" : "12.70"
 }

bin/META.yml

@@ -31,4 +31,4 @@ recommends:
   Time::HiRes: 0
 requires:
   perl: 5.004
-version: 12.68
+version: 12.70

bin/README

@@ -108,8 +108,8 @@ your home directory, then you would type the following commands in a
 terminal window to extract and run ExifTool:
 
   cd ~/Desktop
-  gzip -dc Image-ExifTool-12.68.tar.gz | tar -xf -
-  cd Image-ExifTool-12.68
+  gzip -dc Image-ExifTool-12.70.tar.gz | tar -xf -
+  cd Image-ExifTool-12.70
   ./exiftool t/images/ExifTool.jpg
 
 Note:  These commands extract meta information from one of the test images. 

bin/exiftool

@@ -11,7 +11,7 @@ use strict;
 use warnings;
 require 5.004;
 
-my $version = '12.68';
+my $version = '12.70';
 
 # add our 'lib' directory to the include list BEFORE 'use Image::ExifTool'
 my $exePath;
@@ -4738,7 +4738,7 @@ L<Input-output text formatting|/Input-output text formatting>
   -n          (--printConv)        No print conversion
   -p FMTFILE  (-printFormat)       Print output in specified format
   -php                             Export tags as a PHP Array
-  -s[NUM]     (-short)             Short output format
+  -s[NUM]     (-short)             Short output format (-s for tag names)
   -S          (-veryShort)         Very short output format
   -sep STR    (-separator)         Set separator string for list items
   -sort                            Sort output alphabetically
@@ -4951,7 +4951,7 @@ while C<-all:all=> deletes entire blocks.
 application segments which are not associated with another deletable group. 
 For example, specifying C<-APP14:All=> will NOT delete the APP14 "Adobe"
 segment because this is accomplished with C<-Adobe:All>.  But note that
-these unnamed APP segments may not be excluded with C<--APPxx:all>) when
+these unnamed APP segments may not be excluded with C<--APPxx:all> when
 deleting all information.
 
 6) When shifting a value, the shift is applied to the original value of the
@@ -5582,7 +5582,7 @@ with this command:
 
 produces output like this:
 
-    -- Generated by ExifTool 12.68 --
+    -- Generated by ExifTool 12.70 --
     File: a.jpg - 2003:10:31 15:44:19
     (f/5.6, 1/60s, ISO 100)
     File: b.jpg - 2006:05:23 11:57:38
@@ -6593,15 +6593,15 @@ option no longer suppresses the output "{readyNUM}" message.
 
 Read tags from an alternate source file.  Among other things, this allows
 tags from different files to be compared and combined using the B<-if> and
-B<-p> options.  Tags from alternate files are accessed via the corresponding
-family 8 group name (eg. C<File1:TAG> for the B<-file1> option, C<File2:TAG>
-for B<-file2>, etc).  I<ALTFILE> may contain filename formatting codes like
-the B<-w> option (%d, %f, etc), and/or tag names with a leading C<$> symbol
-to access tags from the source file in the same way as the B<-p> option (so
-any other dollar symbol in the file name must be doubled, eg.
-C<money$$.jpg>).  For example, assuming that the OriginalFileName tag has
-been set in the edited file, a command to copy Rights from the original file
-could look like this:
+B<-p> options.  I<NUM> is any string of digits.  Tags from alternate files
+are accessed via the corresponding family 8 group name (eg. C<File1:TAG> for
+the B<-file1> option, C<File2:TAG> for B<-file2>, etc).  I<ALTFILE> may
+contain filename formatting codes like the B<-w> option (%d, %f, etc),
+and/or tag names with a leading C<$> symbol to access tags from the source
+file in the same way as the B<-p> option (so any other dollar symbol in the
+file name must be doubled, eg. C<money$$.jpg>).  For example, assuming that
+the OriginalFileName tag has been set in the edited file, a command to copy
+Rights from the original file could look like this:
 
     exiftool -file1 '$originalfilename' '-rights<file1:rights' edited.jpg