exiftool_vendored 9.53.0 → 9.58.0

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    ZDNhYjBhZDI5ZmJlNTcxNzUwMzUyMDhlYTM1MTNmZjNiNzk3Mzk4OQ==
+    OTUyYjIxODBmNDA1NWQ4MWIxYTQzODkyMWYwMDIzZDNkYThiZmM2OQ==
   data.tar.gz: !binary |-
-    MWY5ZWU2NDBmNWVkYzcxZDE3MjIyMTBkYmFkYzM1MDYwYTE3ZGQ4Mw==
+    NzI2Y2RmMzQzZTJlYmYwODJhZmQ1MzA1OGFlZmJiMGU0ZjUxM2EwYQ==
 SHA512:
   metadata.gz: !binary |-
-    MzQ3MGI2ODFhMTc3ZGFmMjk2MGY4Mzk5YTc4MDczZmY5YjhiNDgwN2IzYTky
-    ZDdiNzZhY2JlMWVhYWRlMjk3NjgzYjE3N2ExNDk4N2RhMzM3NDNiMWRjYmQ2
-    NDEzZjZiNDM5OGNhZTMyYzMxOWJiOTM0YzFjZjMyOTYzY2I1NmQ=
+    MWRhOWI2ZmU1N2I2MGQ2NGE4OGU4YTZkMDYzZmMxZjcyZGZhZDkyZDFmNGJj
+    M2VjYWM5ZWFiNDM5MDgxMzA3NDNjNDlmMWQ0NjJkNmU1MjhmOTVmNGM0MTcy
+    YTdjM2I5YWFiOWI4NTJlYzRmYzVlMmJlNzk4MDU5Yjc1N2NiMjQ=
   data.tar.gz: !binary |-
-    OTA1MmYzZGEwYzkzZGI1Yzk1NGI4ZGNiYTQ5ODBjMWU3MDk0Yjg3MDFhZjFh
-    ZDdmYTJiYjZhODQ3Yzk2YjhhZjBlNDI4YTA5NTMxNjE0MWUwNGY4NWE5NGIy
-    ZmVlNWUyNDI5NDkwYTc4NWE3ZGY4N2MxODAzMGZmZDI0MTM1ZmQ=
+    ZjNhM2RlYTJmMGQyMjIyZjExOGMxNmExNzgzNjEwZGJlMjAwZTZkODUwMTNk
+    YzA2ZDFiOTU5MDFiMGUzMjYwZDU2NjE5ZjhjNzA3NDAzY2I5NmYxOTdiYWU4
+    NWUyYTg5N2JiYzY1NWEyZjI3NzNiMmYwYjlhMmI0YzFlMDZiMTQ=

data/bin/{Image-ExifTool-9.53 → Image-ExifTool-9.58}/Changes

@@ -7,6 +7,81 @@ RSS feed: http://owl.phy.queensu.ca/~phil/exiftool/rss.xml
 Note: The most recent production release is Version 9.53. (Other versions are
 considered development releases, and are not uploaded to CPAN.)
 
+Apr. 19, 2014 - Version 9.58
+
+  - Added verbose warning and HtmlDump flag for out-of-sequence EXIF tag ID's
+  - Improved decoding of NikonCapture WBAdjLighting (thanks LibRaw)
+  - Improved German translations (thanks Herbert Kauer)
+  - Fixed -v3 to report absolute offsets for RIFF and NikonCapture information
+  - Fixed problem in Windows version which caused ExifTool to exit with an error
+    when importing from a CSV file with a non-existent SourceFile entry
+
+Apr. 12, 2014 - Version 9.57
+
+  - Added a Composite tag to calculate Duration for AIFF files
+  - Added a couple of new Canon lenses
+  - Added a new value for NikonCapture:WBAdjLighting (thanks LibRaw)
+  - Added a new Olympus CameraType (thanks LibRaw)
+  - Decode a couple more Canon tags
+  - Improved French translations (thanks Alphonse Philippe)
+  - Patched to correctly sort out-of-sequence GPS IFD entries
+  - Fixed possible "uninitialized value" runtime error when reading corrupted
+    CanonCustom2 information
+  - Fixed unnecessary warning when writing an image with zero-length maker notes
+  - Fixed incorrect family 2 group for XMP-exif:GPSImgDirectionRef
+
+Apr. 5, 2014 - Version 9.56
+
+  - Added new Canon and Pentax LensType values
+  - Added a couple more Canon ContinuousDrive modes
+  - Added a new Sigma ColorMode
+  - Decode some new QuickTime tags written by the HTC One (M8) in MP4 videos
+  - Decode telemetry information from AR Drone videos
+  - Extract PreviewImage from GoPro JPG files
+  - Improved German translations (thanks Herbert Kauer)
+  - Improved French translations (thanks Alphonse Philippe)
+  - Updated en_ca and en_gb translations
+  - Patched to avoid "excessive count" warning for a 16-bit TransferFunction
+  - Fixed decoding of Canon AEBShotCount for some models
+
+Mar. 29, 2014 - Version 9.55
+
+  - Added new write-only HardLink tag for creating hard links
+  - Added support for Leica S maker notes
+  - Added support for Nintendo maker notes
+  - Added limited read support for FLIR "AFF" SEQ images
+  - Added a new Pentax LensType (thanks Bruce Rusk)
+  - Added two new NEFCompression values (thanks LibRaw)
+  - Added a few new CanonModelID values
+  - Added a new Sony LensType2 (thanks Jos Roost)
+  - Added some unknown Sony tags possibly related to metering (thanks Jos Roost)
+  - Decode orientation information for Ricoh Theta (thanks Paulo Costa)
+  - Decrypt Nikon ColorBalanceUnknown data for -U and -v2+ options
+  - Updated recognition of Metabones Canon adapters on Sony cameras to support
+    new adapter firmware versions
+  - Improved verbose messages when reading GPS track logs
+  - Changed writing of EXIF:Copyright to allow newline conversion to be avoided
+    by disabling print conversion
+  - Fixed an incorrect French translation (thanks Alphonse Philippe)
+  - API Changes:
+      - Fixed problem where Directory tag wasn't written if any "real" tags were
+        changed when calling WriteInfo()
+
+Mar. 1, 2014 - Version 9.54
+
+  - Added a new Pentax LensType
+  - Decode a few more FLIR tags
+  - Generate missing default language tags for alternate-language QuickTime tags
+    without them
+  - Improved identification of some file sub-types based on filename extension
+  - Fixed bug extracting alternate-language QuickTime tags with numerical ID's
+    when processing multiple files in a single command
+  - Fixed potential problem when using some of the recently added options with
+    the -stay_open feature
+  - Fixed problem loading a config file with a single quote in the file name
+  - Fixed problem writing a shortcut tag when the target tag has a group name
+  - Fixed problem recognizing HTML files with a leading UTF-8 BOM
+
 Feb. 22, 2014 - Version 9.53 (production release)
 
   - Added user-defined file types feature

data/bin/{Image-ExifTool-9.53 → Image-ExifTool-9.58}/MANIFEST

@@ -88,6 +88,7 @@ html/TagNames/MinoltaRaw.html
 html/TagNames/Nikon.html
 html/TagNames/NikonCapture.html
 html/TagNames/NikonCustom.html
+html/TagNames/Nintendo.html
 html/TagNames/OOXML.html
 html/TagNames/Ogg.html
 html/TagNames/Olympus.html
@@ -284,6 +285,7 @@ lib/Image/ExifTool/MinoltaRaw.pm
 lib/Image/ExifTool/Nikon.pm
 lib/Image/ExifTool/NikonCapture.pm
 lib/Image/ExifTool/NikonCustom.pm
+lib/Image/ExifTool/Nintendo.pm
 lib/Image/ExifTool/OOXML.pm
 lib/Image/ExifTool/Ogg.pm
 lib/Image/ExifTool/Olympus.pm

data/bin/{Image-ExifTool-9.53 → Image-ExifTool-9.58}/META.yml

@@ -1,6 +1,6 @@
 --- #YAML:1.0
 name:               Image-ExifTool
-version:            9.53
+version:            9.58
 abstract:           Read and write meta information
 author:
     - Phil Harvey (phil@owl.phy.queensu.ca)

data/bin/{Image-ExifTool-9.53 → Image-ExifTool-9.58}/README

@@ -5,9 +5,9 @@ ExifTool is a customizable set of Perl modules plus a full-featured
 application for reading and writing meta information in a wide variety of
 files, including the maker note information of many digital cameras by
 various manufacturers such as Canon, Casio, FLIR, FujiFilm, GE, HP,
-JVC/Victor, Kodak, Leaf, Minolta/Konica-Minolta, Nikon, Olympus/Epson,
-Panasonic/Leica, Pentax/Asahi, Phase One, Reconyx, Ricoh, Samsung, Sanyo,
-Sigma/Foveon and Sony.
+JVC/Victor, Kodak, Leaf, Minolta/Konica-Minolta, Nikon, Nintendo,
+Olympus/Epson, Panasonic/Leica, Pentax/Asahi, Phase One, Reconyx, Ricoh,
+Samsung, Sanyo, Sigma/Foveon and Sony.
 
 Below is a list of file types and meta information formats currently
 supported by ExifTool (r = read, w = write, c = create):

data/bin/{Image-ExifTool-9.53 → Image-ExifTool-9.58}/config_files/ExifTool_config

@@ -231,6 +231,7 @@
                 return $bigImage;
             },
         },
+        # **** ADD ADDITIONAL COMPOSITE TAG DEFINITIONS HERE ****
     },
 );
 
@@ -307,23 +308,24 @@ use Image::ExifTool::MIE;
 
 # User-defined file types to recognize
 %Image::ExifTool::UserDefined::FileTypes = (
-    XXX => { # <-- the extension of the new file type
+    XXX => { # <-- the extension of the new file type (case insensitive)
         # BaseType specifies the format upon which this file is based.
         # If BaseType is defined, then the file will be fully supported,
         # and in this case the Magic pattern should not be defined
         BaseType => 'TIFF',
-        MIMEType => 'image/x-xxx',  # (defaults to 'application/unknown')
+        MIMEType => 'image/x-xxx',
         Description => 'My XXX file type',
     },
     YYY => {
         # without BaseType, the file will be recognized but not supported
         Magic => '0123abcd',    # regular expression to match at start of file
         MIMEType => 'application/test',
-        Description => 'Test imaginary file type',
+        Description => 'My YYY file type',
     },
     ZZZ => {
         # if neither BaseType nor Magic are defined, the file will be
         # recognized by extension only
+        Descripton => 'My ZZZ file type',
     },
 );
 

data/bin/{Image-ExifTool-9.53 → Image-ExifTool-9.58}/exiftool

@@ -12,7 +12,7 @@
 use strict;
 require 5.004;
 
-my $version = '9.53';
+my $version = '9.58';
 
 # add our 'lib' directory to the include list BEFORE 'use Image::ExifTool'
 my $exeDir;
@@ -104,12 +104,14 @@ my $condition;      # conditional processing of files
 my $count;          # count of files scanned
 my $countBad;       # count of files with errors
 my $countBadCr;     # count files not created due to errors
+my $countBadLink;   # count bad links
 my $countBadWr;     # count write errors
 my $countCopyWr;    # count of files copied without being changed
 my $countDir;       # count of directories scanned
 my $countFailed;    # count files that failed condition
 my $countGoodCr;    # count files created OK
 my $countGoodWr;    # count files written OK
+my $countLink;      # count number of links created
 my $countNewDir;    # count of directories created
 my $countSameWr;    # count files written OK but not changed
 my $critical;       # flag for critical operations (disable CTRL-C)
@@ -193,15 +195,17 @@ my %jsonChar = ( '"'=>'"', '\\'=>'\\', "\t"=>'t', "\n"=>'n', "\r"=>'r' );
 my %optArgs = (
     '-tagsfromfile' => 1, '-addtagsfromfile' => 1, '-alltagsfromfile' => 1,
     '-@' => 1,
+    '-api' => 1,
     '-c' => 1, '-coordformat' => 1,
     '-charset' => 0, # (optional arg; OK because arg cannot begin with "-")
     '-config' => 1,
     '-d' => 1, '-dateformat' => 1,
-    '-D' => 0, # nececessary to avoid matching lower-case equivalent
-    '-echo' => 1, '-echo2' => 1,
+    '-D' => 0, # necessary to avoid matching lower-case equivalent
+    '-echo' => 1, '-echo1' => 1, '-echo2' => 1, '-echo3' => 1, '-echo4' => 1,
     '-ext' => 1, '--ext' => 1, '-extension' => 1, '--extension' => 1,
     '-fileorder' => 1,
     '-geotag' => 1,
+    '-globaltimeshift' => 1,
     '-i' => 1, '-ignore' => 1,
     '-if' => 1,
     '-lang' => 0, # (optional arg; cannot begin with "-")
@@ -215,7 +219,11 @@ my %optArgs = (
     '-srcfile' => 1,
     '-stay_open' => 1,
     '-use' => 1,
-    '-w' => 1, '-w!' => 1, '-textout' => 1, '-textout!' => 1,
+    '-w' => 1, '-w!' => 1, '-w+' => 1, '-w+!' => 1, '-w!+' => 1,
+        '-textout' => 1, '-textout!' => 1, '-textout+' => 1, '-textout+!' => 1, '-textout!+' => 1,
+         '-tagout' => 1,  '-tagout!' => 1,  '-tagout+' => 1,  '-tagout+!' => 1,  '-tagout!+' => 1,
+    '-wext' => 1,
+    '-wm' => 1,
     '-x' => 1, '-exclude' => 1,
     '-X' => 0,
 );
@@ -388,12 +396,14 @@ undef $verbose;
 $count = 0;
 $countBad = 0;
 $countBadCr = 0;
+$countBadLink = 0;
 $countBadWr = 0;
 $countCopyWr = 0;
 $countDir = 0;
 $countFailed = 0;
 $countGoodCr = 0;
 $countGoodWr = 0;
+$countLink = 0;
 $countNewDir = 0;
 $countSameWr = 0;
 $csvSaveCount = 0;
@@ -1490,13 +1500,8 @@ if (@dbKeys and require Cwd) {
     undef $evalWarning;
     local $SIG{'__WARN__'} = sub { $evalWarning = $_[0] };
     foreach (@dbKeys) {
-        my $absFile = Cwd::abs_path($_);
-        if (defined $absFile) {
-            $database{$absFile} = $database{$_} unless $database{$absFile};
-        } else {
-            # (may happen on Mac if the filename encoding is incorrect in the database)
-            Warn "Error generating absolute path for $_\n";
-        }
+        my $absFile = eval { Cwd::abs_path($_) };
+        $database{$absFile} = $database{$_} if defined $absFile and not $database{$absFile};
     }
 }
 
@@ -1554,7 +1559,7 @@ if (defined $deleteOrig) {
     my $tot = $count + $countBad;
     my $totWr = $countGoodWr + $countBadWr + $countSameWr + $countCopyWr +
                 $countGoodCr + $countBadCr;
-    if ($countDir or $totWr or $countFailed or $tot > 1 or $textOut) {
+    if ($countDir or $totWr or $countFailed or $tot > 1 or $textOut or $countLink or $countBadLink) {
         my $o = (($html or $json or $xml or %printFmt or $csv) and not $textOut) ? \*STDERR : $vout;
         printf($o "%5d directories scanned\n", $countDir) if $countDir;
         printf($o "%5d directories created\n", $countNewDir) if $countNewDir;
@@ -1569,6 +1574,8 @@ if (defined $deleteOrig) {
         printf($o "%5d files could not be read\n", $countBad) if $countBad;
         printf($o "%5d output files created\n", scalar(keys %created)) if $textOut;
         printf($o "%5d output files appended\n", scalar(keys %appended)) if %appended;
+        printf($o "%5d hard links created\n", $countLink) if $countLink or $countBadLink;
+        printf($o "%5d hard links could not be created\n", $countBadLink) if $countBadLink;
     }
 }
 
@@ -2245,7 +2252,7 @@ TAG:    foreach $tag (@foundTags) {
 sub SetImageInfo($$$)
 {
     my ($et, $file, $orig) = @_;
-    my ($outfile, $restored, $isTemporary, $isStdout, $outType, $tagsFromSrc);
+    my ($outfile, $restored, $isTemporary, $isStdout, $outType, $tagsFromSrc, $hardLink);
     my $infile = $file;    # save infile in case we change it again
 
     undef $tmpFile; # make sure this isn't defined
@@ -2376,8 +2383,8 @@ sub SetImageInfo($$$)
                     unless ($csvInfo) {
                         next if $f eq '*' or not require Cwd;
                         # check absolute path
-                        my $absPath = Cwd::abs_path($f);
-                        next unless defined $absPath and $csvInfo = $database{$absPath};
+                        my $absFile = eval { Cwd::abs_path($f) };
+                        next unless defined $absFile and $csvInfo = $database{$absFile};
                     }
                     $found = 1;
                     $verbose and print $vout "Setting new values from $csv database\n";
@@ -2392,7 +2399,7 @@ sub SetImageInfo($$$)
                 unless ($found) {
                     Warn("No SourceFile '$file' in imported $csv database\n");
                     if (require Cwd) {
-                        my $absFile = Cwd::abs_path($file);
+                        my $absFile = eval { Cwd::abs_path($file) };
                         Warn("(absolute path: '$absFile')\n") if defined $absFile;
                     }
                     return 0;
@@ -2408,6 +2415,10 @@ sub SetImageInfo($$$)
             $binaryStdout = 1;
         }
     } else {
+        # get name of hard link if we are creating one
+        $hardLink = $et->GetNewValues('HardLink');
+        $hardLink = FilenameSPrintf($hardLink, $orig) if defined $hardLink;
+    
         # determine what our output file name should be
         my $newFileName = $et->GetNewValues('FileName');
         my $newDir = $et->GetNewValues('Directory');
@@ -2484,6 +2495,15 @@ sub SetImageInfo($$$)
                 } else {
                     ++$countSameWr;
                 }
+                if (defined $hardLink) {
+                    my $src = (defined $outfile and $r3 > 0) ? $outfile : $file;
+                    $hardLink = NextUnusedFilename($hardLink);
+                    if ($et->SetFileName($src, $hardLink, 'Link') > 0) {
+                        ++$countLink;
+                    } else {
+                        ++$countBadLink;
+                    }
+                }
                 return 1;
             }
             unless (defined $outfile) {
@@ -2503,6 +2523,17 @@ sub SetImageInfo($$$)
     # rewrite the file
     my $success = $et->WriteInfo(Infile($file), $outfile, $outType);
 
+    # create hard link if specified
+    if (defined $hardLink and $success) {
+        my $src = defined $outfile ? $outfile : $file;
+        $hardLink = NextUnusedFilename($hardLink);
+        if ($et->SetFileName($src, $hardLink, 'Link') > 0) {
+            ++$countLink;
+        } else {
+            ++$countBadLink;
+        }
+    }
+
     # get file time if preserving it
     my ($aTime, $mTime, $cTime);
     if ($preserveTime and $success and -e $file) {
@@ -3560,33 +3591,33 @@ supported by ExifTool (r = read, w = write, c = create):
   3G2   r/w   | EPS   r/w   | LNK   r     | PAC   r     | RWL   r/w
   3GP   r/w   | ERF   r/w   | M2TS  r     | PAGES r     | RWZ   r
   ACR   r     | EXE   r     | M4A/V r/w   | PBM   r/w   | RM    r
-  AFM   r     | EXIF  r/w/c | MEF   r/w   | PCD   r     | SO    r
-  AI    r/w   | EXR   r     | MIE   r/w/c | PDF   r/w   | SR2   r/w
-  AIFF  r     | EXV   r/w/c | MIFF  r     | PEF   r/w   | SRF   r
-  APE   r     | F4A/V r/w   | MKA   r     | PFA   r     | SRW   r/w
-  ARW   r/w   | FFF   r/w   | MKS   r     | PFB   r     | SVG   r
-  ASF   r     | FLA   r     | MKV   r     | PFM   r     | SWF   r
-  AVI   r     | FLAC  r     | MNG   r/w   | PGF   r     | THM   r/w
-  BMP   r     | FLV   r     | MODD  r     | PGM   r/w   | TIFF  r/w
-  BTF   r     | FPF   r     | MOS   r/w   | PLIST r     | TORRENT r
-  CHM   r     | FPX   r     | MOV   r/w   | PICT  r     | TTC   r
-  COS   r     | GIF   r/w   | MP3   r     | PMP   r     | TTF   r
-  CR2   r/w   | GZ    r     | MP4   r/w   | PNG   r/w   | VRD   r/w/c
-  CRW   r/w   | HDP   r/w   | MPC   r     | PPM   r/w   | VSD   r
-  CS1   r/w   | HDR   r     | MPG   r     | PPT   r     | WAV   r
-  DCM   r     | HTML  r     | MPO   r/w   | PPTX  r     | WDP   r/w
-  DCP   r/w   | ICC   r/w/c | MQV   r/w   | PS    r/w   | WEBP  r
-  DCR   r     | IDML  r     | MRW   r/w   | PSB   r/w   | WEBM  r
-  DFONT r     | IIQ   r/w   | MXF   r     | PSD   r/w   | WMA   r
-  DIVX  r     | IND   r/w   | NEF   r/w   | PSP   r     | WMV   r
-  DJVU  r     | INX   r     | NRW   r/w   | QTIF  r/w   | WV    r
-  DLL   r     | ITC   r     | NUMBERS r   | RA    r     | X3F   r/w
-  DNG   r/w   | J2C   r     | ODP   r     | RAF   r/w   | XCF   r
-  DOC   r     | JNG   r/w   | ODS   r     | RAM   r     | XLS   r
-  DOCX  r     | JP2   r/w   | ODT   r     | RAR   r     | XLSX  r
-  DPX   r     | JPEG  r/w   | OFR   r     | RAW   r/w   | XMP   r/w/c
-  DV    r     | K25   r     | OGG   r     | RIFF  r     | ZIP   r
-  DVB   r/w   | KDC   r     | OGV   r     | RSRC  r     |
+  AFM   r     | EXIF  r/w/c | MEF   r/w   | PCD   r     | SEQ   r
+  AI    r/w   | EXR   r     | MIE   r/w/c | PDF   r/w   | SO    r
+  AIFF  r     | EXV   r/w/c | MIFF  r     | PEF   r/w   | SR2   r/w
+  APE   r     | F4A/V r/w   | MKA   r     | PFA   r     | SRF   r
+  ARW   r/w   | FFF   r/w   | MKS   r     | PFB   r     | SRW   r/w
+  ASF   r     | FLA   r     | MKV   r     | PFM   r     | SVG   r
+  AVI   r     | FLAC  r     | MNG   r/w   | PGF   r     | SWF   r
+  BMP   r     | FLV   r     | MODD  r     | PGM   r/w   | THM   r/w
+  BTF   r     | FPF   r     | MOS   r/w   | PLIST r     | TIFF  r/w
+  CHM   r     | FPX   r     | MOV   r/w   | PICT  r     | TORRENT r
+  COS   r     | GIF   r/w   | MP3   r     | PMP   r     | TTC   r
+  CR2   r/w   | GZ    r     | MP4   r/w   | PNG   r/w   | TTF   r
+  CRW   r/w   | HDP   r/w   | MPC   r     | PPM   r/w   | VRD   r/w/c
+  CS1   r/w   | HDR   r     | MPG   r     | PPT   r     | VSD   r
+  DCM   r     | HTML  r     | MPO   r/w   | PPTX  r     | WAV   r
+  DCP   r/w   | ICC   r/w/c | MQV   r/w   | PS    r/w   | WDP   r/w
+  DCR   r     | IDML  r     | MRW   r/w   | PSB   r/w   | WEBP  r
+  DFONT r     | IIQ   r/w   | MXF   r     | PSD   r/w   | WEBM  r
+  DIVX  r     | IND   r/w   | NEF   r/w   | PSP   r     | WMA   r
+  DJVU  r     | INX   r     | NRW   r/w   | QTIF  r/w   | WMV   r
+  DLL   r     | ITC   r     | NUMBERS r   | RA    r     | WV    r
+  DNG   r/w   | J2C   r     | ODP   r     | RAF   r/w   | X3F   r/w
+  DOC   r     | JNG   r/w   | ODS   r     | RAM   r     | XCF   r
+  DOCX  r     | JP2   r/w   | ODT   r     | RAR   r     | XLS   r
+  DPX   r     | JPEG  r/w   | OFR   r     | RAW   r/w   | XLSX  r
+  DV    r     | K25   r     | OGG   r     | RIFF  r     | XMP   r/w/c
+  DVB   r/w   | KDC   r     | OGV   r     | RSRC  r     | ZIP   r
   DYLIB r     | KEY   r     | ORF   r/w   | RTF   r     |
 
   Meta Information
@@ -3690,7 +3721,7 @@ L<Processing control|/Processing control>
   -scanForXMP                      Brute force XMP scan
   -u          (-unknown)           Extract unknown tags
   -U          (-unknown2)          Extract unknown binary tags too
-  -wm MODE    (-writeMode)         Set tag write/create mode
+  -wm MODE    (-writeMode)         Set mode for writing/creating tags
   -z          (-zip)               Read/write compressed information
 
 L<Special features|/Special features>
@@ -4091,8 +4122,8 @@ as the exported file.  The first row of the I<CSVFILE> must be the ExifTool
 tag names (with optional group names) for each column of the file, and
 values must be separated by commas.  A special "SourceFile" column specifies
 the files associated with each row of information (a SourceFile of "*" may
-be used to apply the information to all target images).  The following
-examples demonstrate basic use of this option:
+be used to match any source file name).  The following examples demonstrate
+basic use of this option:
 
     # generate CSV file with common tags from all images in a directory
     exiftool -common -csv dir > out.csv
@@ -4116,6 +4147,9 @@ arranged in the same order as the specified tags provided the column
 headings exactly match the specified tag names, otherwise the columns are
 sorted in alphabetical order.
 
+When importing from a CSV file, only files specified on the command line are
+processed.  Any extra entries in the CSV file are ignored.
+
 List-type tags are stored as simple strings in a CSV file, but the B<-sep>
 option may be used to split them back into separate items when importing.
 
@@ -4316,7 +4350,7 @@ with this command:
 
 produces output like this:
 
-    -- Generated by ExifTool 9.53 --
+    -- Generated by ExifTool 9.58 --
     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
@@ -4756,6 +4790,10 @@ the associated NEF:
     exiftool -if EXPR -p '$directory/$filename' -ext nef DIR > nef.txt
     exiftool -@ nef.txt -srcfile %d%f.xmp ...
 
+5) The B<-a> option has no effect on the evaluation of the expression, and
+the values of duplicate tags are accessible only by specifying a group name
+(such as a family 4 instance number, ie. C<$Copy1:TAG>, C<$Copy2:TAG>, etc).
+
 =item B<-m> (B<-ignoreMinorErrors>)
 
 Ignore minor errors and warnings.  This enables writing to files with minor