exiftool_vendored 13.19.0 → 13.22.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 19b270f0ce5b43c0bc65a0cf0f71fdea7426079ce467cb9e79a42ae9a5909c12
-  data.tar.gz: d989e4609455211361660c40fdec7c81ac3809d35030fd08ee0406fcf220be1e
+  metadata.gz: ad918781e3d8bd85a5482713e9f0007a5c6a49baf150bc89899989a38d2976b4
+  data.tar.gz: 6c73a902a729e31ca68eb9cfb10162cc9cb58e4f5530a8383c791bd00f358f93
 SHA512:
-  metadata.gz: c4f5c17319320481c245bf7009a86055da882a2374fb4e5c4f59b5ac31b82dba1f094e54adc442759fe3758ceeeab2e1d8f75b73efbdff57e1214ef871b8d12e
-  data.tar.gz: c657963e15956834d70bde5bf04c64446e1361a5e170eaef59a1d42b54acaeef54428654dd96c2d18ffef7548752fcd757e345d6a130076684f70ec1095eb033
+  metadata.gz: 7140b651487bbf72d3977a7af1dff81162a4e11de366121a9fcfffd6ef767df7c91e5e84c4f184ee2f0691fd014f90bdf1ed24bb71262d9b2b10225e3ae59374
+  data.tar.gz: 607ce339d770ac81eb2bea3d1cf1a2029c3916bd717ebc300c20807ad7c443218c34ede0769f3329dea40fba4abdd1fedf6e7e18ae367c5fa6901a790f6048fd

data/bin/Changes

@@ -7,6 +7,41 @@ RSS feed: https://exiftool.org/rss.xml
 Note: The most recent production release is Version 13.10. (Other versions are
 considered development releases, and are not uploaded to MetaCPAN.)
 
+Mar. 1, 2025 - Version 13.22
+
+  - Improvements and additions to the new plot feature
+  - Decode a few more DJI timed metadata tags
+  - Extract GainMapImage from PNG images
+  - Reverted WebP FileType change of version 13.20
+  - Set $^W in the exiftool application to re-enable global warnings (they have
+    been disabled since version 12.92 due to the shebang change)
+  - Fixed possible incorrect IFD number in "No size tag" warning
+  - Fixed "File is empty" error when using -plot with -w to write the output
+    file into the same directory as the input files
+
+Feb. 20, 2025 - Version 13.21
+
+  - Patched issue that could result in runtime warning for some video files
+  - Fixed a bug with the new -plot option that could generate a compiler error
+
+Feb. 20, 2025 - Version 13.20
+
+  - Added new -plot option for generating SVG-format plots from tag values
+  - Added a new Olympus CameraType
+  - Added a new Nikon Z LensID (thanks Warren Hatch)
+  - Overhauled decoding of Nikon AF tags (thanks Warren Hatch)
+  - Decode timed GPS from yet another model dashcam
+  - Decode more information from AAE files
+  - Decode more tags from DJI videos
+  - Updated Windows launcher (thanks Oliver Betz)
+  - Enhanced -w option to be available for use with the -csv output
+  - Attempted to patch a problem writing some PDF files
+  - Fail if a required module is missing when attempting to write a formatted
+    date/time value instead of falling back to write as unformatted
+  - Minor change to WebP lossless FileType text
+  - API Changes:
+      - Added Plot option
+
 Feb. 10, 2025 - Version 13.19
 
   - Added read/write support for PDF and XMP-pdfx SourceModified
@@ -14,11 +49,11 @@ Feb. 10, 2025 - Version 13.19
   - Decode timed GPS from Rexing V1-4k dashcam
   - Decode more information from AAE files
   - Made a new icon for the Windows EXE application
-  - Changed family 3 groups for ICO files so the first icon is in the Doc1
-    instead of the Main group
   - Improved handling of ICC_Profile in HEIC images:
       - Profiles for sub-images are extracted as sub-documents
       - Allow only the profile of the main image to be written
+  - Changed family 3 groups for ICO files so the first icon is in the Doc1
+    instead of the Main group
   - Updated Sony decoding for ILCE-1M2 (thanks Jos Roost)
 
 Feb. 3, 2025 - Version 13.18

data/bin/MANIFEST

@@ -208,9 +208,16 @@ html/htmldump.html
 html/idiosyncracies.html
 html/index.html
 html/install.html
+html/markers.svg
 html/metafiles.html
 html/mistakes.html
 html/overview.png
+html/plot.html
+html/plot1.svg
+html/plot2.svg
+html/plot3.svg
+html/plot4.svg
+html/plot5.svg
 html/standards.html
 html/struct.html
 html/style.css
@@ -398,6 +405,7 @@ lib/Image/ExifTool/PhaseOne.pm
 lib/Image/ExifTool/PhotoCD.pm
 lib/Image/ExifTool/PhotoMechanic.pm
 lib/Image/ExifTool/Photoshop.pm
+lib/Image/ExifTool/Plot.pm
 lib/Image/ExifTool/PostScript.pm
 lib/Image/ExifTool/PrintIM.pm
 lib/Image/ExifTool/Protobuf.pm

data/bin/META.json

@@ -50,5 +50,5 @@
       }
    },
    "release_status" : "stable",
-   "version" : "13.19"
+   "version" : "13.22"
 }

data/bin/META.yml

@@ -31,4 +31,4 @@ recommends:
   Time::HiRes: '0'
 requires:
   perl: '5.004'
-version: '13.19'
+version: '13.22'

data/bin/README

@@ -109,8 +109,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-13.19.tar.gz | tar -xf -
-  cd Image-ExifTool-13.19
+  gzip -dc Image-ExifTool-13.22.tar.gz | tar -xf -
+  cd Image-ExifTool-13.22
   ./exiftool t/images/ExifTool.jpg
 
 Note:  These commands extract meta information from one of the test images. 

data/bin/exiftool

@@ -11,7 +11,9 @@ use strict;
 use warnings;
 require 5.004;
 
-my $version = '13.19';
+my $version = '13.22';
+
+$^W = 1;    # enable global warnings
 
 # add our 'lib' directory to the include list BEFORE 'use Image::ExifTool'
 my $exePath;
@@ -52,7 +54,7 @@ sub EncodeXML($);
 sub FormatXML($$$);
 sub EscapeJSON($;$);
 sub FormatJSON($$$;$);
-sub PrintCSV();
+sub PrintCSV(;$);
 sub AddGroups($$$$);
 sub ConvertBinary($);
 sub IsEqual($$);
@@ -189,6 +191,7 @@ my $outFormat;      # -1=Canon format, 0=same-line, 1=tag names, 2=values only
 my $outOpt;         # output file or directory name
 my $overwriteOrig;  # flag to overwrite original file (1=overwrite, 2=in place)
 my $pause;          # pause before returning
+my $plot;           # flag for plot output format
 my $preserveTime;   # flag to preserve times of updated files (2=preserve FileCreateDate only)
 my $progress;       # flag to calculate total files to process (0=calculate but don't display)
 my $progressCount;  # count of files processed
@@ -216,6 +219,7 @@ my $structOpt;      # output structured XMP information (JSON and XML output onl
 my $tabFormat;      # non-zero for tab output format
 my $tagOut;         # flag for separate text output file for each tag
 my $textOut;        # extension for text output file (or undef for no output)
+my $textOut2;       # complete file name for single text output file
 my $textOverwrite;  # flag to overwrite existing text output file (2=append, 3=over+append)
 my $tmpFile;        # temporary file to delete on exit
 my $tmpText;        # temporary text file
@@ -459,8 +463,8 @@ undef %filterExt;
 undef %ignore;
 undef %outComma;
 undef %outTrailer;
-undef %printFmt;
 undef %preserveTime;
+undef %printFmt;
 undef %seqFileDir;
 undef %setTags;
 undef %setTagsList;
@@ -1176,6 +1180,7 @@ for (;;) {
     }
     /^overwrite_original$/i and $overwriteOrig = 1, next;
     /^overwrite_original_in_place$/i and $overwriteOrig = 2, next;
+    /^plot$/i and require Image::ExifTool::Plot and $plot = Image::ExifTool::Plot->new, next;
     if (/^p(-?)$/ or /^printformat(-?)$/i) {
         my $fmt = shift;
         if ($pass) {
@@ -1466,15 +1471,10 @@ if (not @files and not $outOpt and not @newValues) {
 # print help
 unless ((@tags and not $outOpt) or @files or @newValues or $geoOnly) {
     if ($doGlob and $doGlob == 2) {
-        Warn "No matching files\n";
-        $rtnVal = 1;
-        next;
-    }
-    if ($outOpt) {
-        Warn "Nothing to write\n";
-        $rtnVal = 1;
+        Error "No matching files\n";
         next;
     }
+    $outOpt and Error("Nothing to write\n"), next;
     unless ($helped) {
         # catch warnings if we have problems running perldoc
         local $SIG{'__WARN__'} = sub { $evalWarning = $_[0] };
@@ -1499,38 +1499,34 @@ unless ((@tags and not $outOpt) or @files or @newValues or $geoOnly) {
 if (defined $deleteOrig and (@newValues or @tags)) {
     if (not @newValues) {
         my $verb = $deleteOrig ? 'deleting' : 'restoring from';
-        Warn "Can't specify tags when $verb originals\n";
+        Error "Can't specify tags when $verb originals\n";
     } elsif ($deleteOrig) {
-        Warn "Can't use -delete_original when writing.\n";
-        Warn "Maybe you meant -overwrite_original ?\n";
+        Error "Can't use -delete_original when writing.\n";
+        Error "Maybe you meant -overwrite_original ?\n";
     } else {
-        Warn "It makes no sense to use -restore_original when writing\n";
+        Error "It makes no sense to use -restore_original when writing\n";
     }
-    $rtnVal = 1;
     next;
 }
 
 if ($overwriteOrig > 1 and $outOpt) {
-    Warn "Can't overwrite in place when -o option is used\n";
-    $rtnVal = 1;
+    Error "Can't overwrite in place when -o option is used\n";
     next;
 }
 
-if (($tagOut or defined $diff) and ($csv or $json or %printFmt or $tabFormat or $xml or
+if (($tagOut or defined $diff) and ($csv or $json or %printFmt or $tabFormat or $xml or $plot or
     ($verbose and $html)))
 {
     my $opt = $tagOut ? '-W' : '-diff';
-    Warn "Sorry, $opt may not be combined with -csv, -htmlDump, -j, -p, -t or -X\n";
-    $rtnVal = 1;
+    Error "Sorry, $opt may not be combined with -csv, -htmlDump, -j, -p, -t or -X\n";
     next;
 }
 
 if ($csv and $csv eq 'CSV' and not $isWriting) {
     $json = 0;    # (not compatible)
     if ($textOut) {
-        Warn "Sorry, -w may not be combined with -csv\n";
-        $rtnVal = 1;
-        next;
+        $textOut2 = $textOut;
+        undef $textOut;
     }
     if ($binaryOutput) {
         $binaryOutput = 0;
@@ -1542,6 +1538,32 @@ if ($csv and $csv eq 'CSV' and not $isWriting) {
     }
     require Image::ExifTool::XMP if $setCharset;
 }
+if ($plot and $textOut) {
+    $textOut2 = $textOut;
+    undef $textOut;
+}
+if ($textOut2) {
+    if ($textOverwrite > 1) {
+        Error "Can not append to multi-file output format\n";
+        undef $textOut2;
+        next;
+    }
+    if (not $textOverwrite and $mt->Exists($textOut2, 1)) {
+        Error "Output file $textOut2 already exists\n";
+        undef $textOut2;
+        next;
+    }
+    # make sure we can write the output text file before processing all input files
+    CreateDirectory($textOut2);  # create directory if necessary
+    if ($mt->Open(\*OUTFILE, $textOut2, '>')) {
+        close(\*OUTFILE);
+        unlink($textOut2);  # (this was just a test)
+    } else {
+        Error("Error creating $textOut2\n");
+        undef $textOut2;
+        next;
+    }
+}
 
 if ($escapeHTML or $json) {
     # must be UTF8 for HTML conversion and JSON output
@@ -1555,7 +1577,7 @@ if ($escapeHTML or $json) {
 # set sort option
 if ($sortOpt) {
     # (note that -csv sorts alphabetically by default anyway if more than 1 file)
-    my $sort = ($outFormat > 0 or $xml or $json or $csv) ? 'Tag' : 'Descr';
+    my $sort = ($outFormat > 0 or $xml or $json or $csv or $plot) ? 'Tag' : 'Descr';
     $mt->Options(Sort => $sort, Sort2 => $sort);
 }
 
@@ -1566,7 +1588,11 @@ if ($mt->Options('Struct') and not $structOpt) {
 }
 
 # set up for RDF/XML, JSON and PHP output formats
-if ($xml) {
+if ($plot) {
+    undef $joinLists;
+    $mt->Options(List => 1);
+    $plot->Settings($mt->Options('Plot'));
+} elsif ($xml) {
     require Image::ExifTool::XMP;   # for EscapeXML()
     my $charset = $mt->Options('Charset');
     # standard XML encoding names for supported Charset settings
@@ -1638,11 +1664,10 @@ if (Image::ExifTool::IsPC()) {
 unless (@files) {
     unless ($outOpt) {
         if ($doGlob and $doGlob == 2) {
-            Warn "No matching files\n";
+            Error "No matching files\n";
         } else {
-            Warn "No file specified\n";
+            Error "No file specified\n";
         }
-        $rtnVal = 1;
         next;
     }
     push @files, '';    # create file from nothing
@@ -1705,8 +1730,7 @@ if (@newValues) {
                 next;   # set tags from dynamic file later
             }
             unless ($mt->Exists($newVal) or $newVal eq '-') {
-                Warn "File '${newVal}' does not exist for -tagsFromFile option\n";
-                $rtnVal = 1;
+                Error "File '${newVal}' does not exist for -tagsFromFile option\n";
                 next Command;
             }
             my $setTags = $setTags{$newVal};
@@ -1770,19 +1794,20 @@ if (@newValues) {
         }
     }
     unless ($isWriting or $outOpt or @tags) {
-        Warn "Nothing to do.\n";
-        $rtnVal = 1;
+        Error "Nothing to do.\n";
         next;
     }
 } elsif (grep /^(\*:)?\*$/, @exclude) {
-    Warn "All tags excluded -- nothing to do.\n";
-    $rtnVal = 1;
+    Error "All tags excluded -- nothing to do.\n";
     next;
 }
 if ($isWriting) {
     if (defined $diff) {
         Error "Can't use -diff option when writing tags\n";
         next;
+    } elsif ($plot) {
+        Error "Can't use -plot option when writing tags\n";
+        next;
     } elsif (@tags and not $outOpt and not $csv) {
         my ($tg, $s) = @tags > 1 ? ("$tags[0] ...", 's') : ($tags[0], '');
         Warn "Ignored superfluous tag name$s or invalid option$s: -$tg\n";
@@ -1931,9 +1956,6 @@ ProcessFiles($mt);
 
 Error "No file with specified extension\n" if $filtered and not $validFile;
 
-# print CSV information if necessary
-PrintCSV() if $csv and not $isWriting;
-
 # print folder/file trailer if necessary
 if ($textOut) {
     foreach (keys %outTrailer) {
@@ -1949,6 +1971,37 @@ if ($textOut) {
 } else {
     print $sectTrailer if $sectTrailer;
     print $fileTrailer if $fileTrailer and not $fileHeader;
+    # print CSV or SVG output file if necessary
+    my ($fp, $err);
+    if ($textOut2) {
+        if ($mt->Open(\*OUTFILE, $textOut2, '>')) {
+            $fp = \*OUTFILE;
+        } else {
+            Error("Error creating $textOut2\n");
+            $err = 1;
+        }
+    }
+    unless ($err) {
+        PrintCSV($fp) if $csv and not $isWriting;
+        # print SVG plot
+        if ($plot) {
+            $plot->Draw($fp || \*STDOUT);
+            if ($$plot{Error}) {
+                Error("Error: $$plot{Error}\n");
+                $err = 1;
+            } elsif ($$plot{Warn}) {
+                Warn("Warning: $$plot{Warn}\n");
+            }
+        }
+    }
+    if ($fp) {
+        close($fp) or $err = 1;
+        if ($err) {
+            $mt->Unlink($textOut2);
+        } else {
+            $created{$textOut2} = 1;
+        }
+    }
 }
 
 my $totWr = $countGoodWr + $countBadWr + $countSameWr + $countCopyWr +
@@ -1993,7 +2046,7 @@ if (defined $deleteOrig) {
     # print summary
     my $tot = $count + $countBad;
     if ($countDir or $totWr or $countFailed or $tot > 1 or $textOut or %countLink) {
-        my $o = (($html or $json or $xml or %printFmt or $csv) and not $textOut) ? \*STDERR : $vout;
+        my $o = (($html or $json or $xml or %printFmt or $csv or $plot) and not $textOut) ? \*STDERR : $vout;
         printf($o "%5d directories scanned\n", $countDir) if $countDir;
         printf($o "%5d directories created\n", $countNewDir) if $countNewDir;
         printf($o "%5d files failed condition\n", $countFailed) if $countFailed;
@@ -2005,7 +2058,7 @@ if (defined $deleteOrig) {
         printf($o "%5d files weren't created due to errors\n", $countBadCr) if $countBadCr;
         printf($o "%5d image files read\n", $count) if ($tot+$countFailed)>1 or ($countDir and not $totWr);
         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 created\n", scalar(keys %created)) if $textOut or $textOut2;
         printf($o "%5d output files appended\n", scalar(keys %appended)) if %appended;
         printf($o "%5d hard links created\n", $countLink{Hard} || 0) if $countLink{Hard} or $countLink{BadHard};
         printf($o "%5d hard links could not be created\n", $countLink{BadHard}) if $countLink{BadHard};
@@ -2210,7 +2263,7 @@ sub GetImageInfo($$)
 
     my $lineCount = 0;
     my ($fp, $outfile, $append);
-    if ($textOut and ($verbose or $et->Options('PrintCSV')) and not ($tagOut or defined $diff)) {
+    if ($textOut and ($verbose or $et->Options('PrintCSV')) and not ($tagOut or defined $diff or $plot)) {
         ($fp, $outfile, $append) = OpenOutputFile($orig);
         $fp or EFile($file), ++$countBad, return;
         # delete file if we exit prematurely (unless appending)
@@ -2250,7 +2303,7 @@ sub GetImageInfo($$)
     }
     # print file/progress message
     my $o;
-    unless ($binaryOutput or $textOut or %printFmt or $html > 1 or $csv) {
+    unless ($binaryOutput or $textOut or %printFmt or $html > 1 or $csv or $plot) {
         if ($html) {
             require Image::ExifTool::HTML;
             my $f = Image::ExifTool::HTML::EscapeHTML($file);
@@ -2353,7 +2406,7 @@ sub GetImageInfo($$)
     unless (defined $outfile or $tagOut) {
         ($fp, $outfile, $append) = OpenOutputFile($orig);
         $fp or EFile($file), ++$countBad, return;
-        $tmpText = $outfile unless $append;
+        $tmpText = $outfile if defined $outfile and not $append;
     }
 
     # print differences if requested
@@ -2464,9 +2517,8 @@ T2:         foreach $t2 (@tags2) {
             $done2{$tag2} = 1 if defined $tag2;
         }
         print $fp "(no metadata differences)\n" unless $wasDiff;
-        undef $tmpText;
         if (defined $outfile) {
-            ++$created{$outfile};
+            $created{$outfile} = 1;
             close($fp);
             undef $tmpText;
         }
@@ -2541,6 +2593,17 @@ T2:         foreach $t2 (@tags2) {
         delete $printFmt{HEAD} unless defined $outfile; # print header only once per output file
         my $errs = $et->GetInfo('Warning', 'Error');
         PrintErrors($et, $errs, $file) and EFile($file);
+    } elsif ($plot) {
+        # add points from this file to the plot
+        my $tagExtra = $$et{TAG_EXTRA};
+        my ($tag, %docNum);
+        foreach $tag (keys %$info) {
+            next unless $$tagExtra{$tag} and $$tagExtra{$tag}{G3};
+            $docNum{$tag} = $1 if $$tagExtra{$tag}{G3} =~ /(\d+)/;
+        }
+        $$plot{DocNum} = \%docNum;
+        $$plot{EE} = 1 if $et->Options('ExtractEmbedded');
+        $plot->AddPoints($info, \@foundTags);
     } elsif (not $disableOutput) {
         my ($tag, $line, %noDups, %csvInfo, $bra, $ket, $sep, $quote);
         if ($fp) {
@@ -3773,8 +3836,10 @@ sub FormatCSV($)
 
 #------------------------------------------------------------------------------
 # Print accumulated CSV information
-sub PrintCSV()
+# Inputs: 0) file ref
+sub PrintCSV(;$)
 {
+    my $fp = shift || \*STDOUT;
     my ($file, $lcTag, @tags);
 
     @csvTags or @csvTags = sort keys %csvTags;
@@ -3782,7 +3847,7 @@ sub PrintCSV()
     foreach $lcTag (@csvTags) {
         push @tags, FormatCSV($csvTags{$lcTag}) if $csvTags{$lcTag};
     }
-    print join($csvDelim, 'SourceFile', @tags), "\n";
+    print $fp join($csvDelim, 'SourceFile', @tags), "\n";
     my $empty = defined($forcePrint) ? $forcePrint : '';
     foreach $file (@csvFiles) {
         my @vals = (FormatCSV($file)); # start with full file name
@@ -3793,7 +3858,7 @@ sub PrintCSV()
             defined $val or push(@vals,$empty), next;
             push @vals, FormatCSV($val);
         }
-        print join($csvDelim, @vals), "\n";
+        print $fp join($csvDelim, @vals), "\n";
     }
 }
 
@@ -4127,9 +4192,8 @@ sub ProcessFiles($;$)
                 $filtered = 1;
                 Progress($vout, "-------- $file (wrong extension)") if $verbose;
             } else {
-                Warn "Error: File not found - $file\n";
+                Error "Error: File not found - $file\n";
                 FileNotFound($file);
-                $rtnVal = 1;
             }
         } else {
             $validFile = 1;
@@ -5102,6 +5166,7 @@ L<Input-output text formatting|/Input-output text formatting>
   -n          (--printConv)        No print conversion
   -p[-] STR   (-printFormat)       Print output in specified format
   -php                             Export tags as a PHP Array
+  -plot                            Output tags as SVG plot file
   -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
@@ -5680,14 +5745,16 @@ option may be used to split them back into separate items when importing.
 Special feature:  B<-csv>+=I<CSVFILE> may be used to add items to existing
 lists.  This affects only list-type tags.  Also applies to the B<-j> option.
 
-Note that this option is fundamentally different than all other output
-format options because it requires information from all input files to be
-buffered in memory before the output is written.  This may result in
-excessive memory usage when processing a very large number of files with a
-single command.  Also, it makes this option incompatible with the B<-w> and
-B<-W> options.  When processing a large number of files, it is recommended
-to either use the JSON (B<-j>) or XML (B<-X>) output format, or use B<-p> to
-generate a fixed-column CSV file instead of using the B<-csv> option.
+Note that this and the B<-plot> options are fundamentally different than all
+other output format options because they require information from all input
+files to be buffered in memory before the output is written.  This may
+result in excessive memory usage when processing a very large number of
+files with a single command.  Also, when used with B<-csv>, the B<-w> option
+changes to specify a complete file name with no filename formatting codes or
+append mode allowed, and B<-W> may not be used.  When processing a large
+number of files, it is recommended to either use the JSON (B<-j>) or XML
+(B<-X>) output format, or use B<-p> to generate a fixed-column CSV file
+instead of using the B<-csv> option.
 
 =item B<-csvDelim> I<STR>
 
@@ -5986,7 +6053,7 @@ with this command:
 
 produces output like this:
 
-    -- Generated by ExifTool 13.19 --
+    -- Generated by ExifTool 13.22 --
     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
@@ -6035,6 +6102,21 @@ showing how this could be used in a PHP script:
     print_r($array);
     ?>
 
+=item B<-plot>
+
+Write output for all specified tags and all input files as a single
+SVG-formatted plot.  When combined with this feature, the B<-w> option
+argument is a complete file name with no format codes and the append feature
+may not be used.  Each tag specified on the command line represents a
+dataset in the plot (or more for array values or if the Split plot setting
+is used).  Non-numerical values are ignored.  Each input file may contribute
+multiple points to a dataset if it contains sub-documents and the B<-ee>
+option is used, or if the tag value is a delimited string of numbers (valid
+delimiters are: space, comma, semicolon, tab and newline).  Line, Scatter
+and Histogram plot types are available.  See the API Plot Option and
+L<https://exiftool.org/plot.html> for more details and information about the
+plot settings.
+
 =item B<-s>[I<NUM>] (B<-short>)
 
 Short output format.  Prints tag names instead of descriptions.  Add I<NUM>
@@ -6172,6 +6254,10 @@ ways to create a single output file from multiple source files:
     # 3. With the -W option (see the -W option below)
     exiftool -W+! out.txt FILE1 FILE2 ...
 
+3) The B<-w> option changes when used with a multi-file output format
+(B<-csv> or B<-plot>).  With these, the argument of B<-w> is a complete file
+name with no formatting codes, and the append feature may not be used.
+
 Advanced features:
 
 A substring of the original file name, directory or extension may be taken
@@ -6460,13 +6546,13 @@ across directory boundaries if multiple input directories are specified.
 =item B<-i> I<DIR> (B<-ignore>)
 
 Ignore specified directory name.  I<DIR> may be either an individual folder
-name, or a full path.  If a full path is specified, it must match the
-Directory tag exactly to be ignored.  Use multiple B<-i> options to ignore
-more than one directory name.  A special I<DIR> value of C<SYMLINKS> (case
-sensitive) may be specified to avoid recursing into directories which are
+name, or a full path, and is case sensitive.  If a full path is specified,
+it must match the Directory tag exactly to be ignored.  Use multiple B<-i>
+options to ignore more than one directory name.  A special I<DIR> value of
+C<SYMLINKS> may be specified to avoid recursing into directories which are
 symbolic links when the B<-r> option is used.  As well, a value of C<HIDDEN>
-(case sensitive) may be used to ignore files with names that start with a
-"." (ie. hidden files on Unix systems) when scanning a directory.
+may be used to ignore files with names that start with a "." (ie. hidden
+files on Unix systems) when scanning a directory.
 
 =item B<-if>[I<NUM>] I<EXPR>