exiftool_vendored 9.37.0 → 9.41.0

data/bin/{Image-ExifTool-9.37 → Image-ExifTool-9.41}/html/TagNames/index.html

@@ -79,6 +79,7 @@ The tables listed below give the names of all tags recognized by ExifTool.
 <a href='PNG.html'>PNG</a><br>
 <a href='MNG.html'>MNG</a><br>
 <a href='DjVu.html'>DjVu</a><br>
+<a href='DPX.html'>DPX</a><br>
 <a href='OpenEXR.html'>OpenEXR</a><br>
 <a href='MIFF.html'>MIFF</a><br>
 <a href='PGF.html'>PGF</a><br>
@@ -89,8 +90,8 @@ The tables listed below give the names of all tags recognized by ExifTool.
 <a href='PostScript.html'>PostScript</a><br>
 <a href='ID3.html'>ID3</a><br>
 <a href='ITC.html'>ITC</a><br>
-<a href='Ogg.html'>Ogg</a><br>
-<a href='Vorbis.html'>Vorbis</a></td><td width='16%'>
+<a href='Ogg.html'>Ogg</a></td><td width='16%'>
+<a href='Vorbis.html'>Vorbis</a><br>
 <a href='FLAC.html'>FLAC</a><br>
 <a href='Theora.html'>Theora</a><br>
 <a href='APE.html'>APE</a><br>
@@ -100,6 +101,7 @@ The tables listed below give the names of all tags recognized by ExifTool.
 <a href='H264.html'>H264</a><br>
 <a href='QuickTime.html'>QuickTime</a><br>
 <a href='PLIST.html'>PLIST</a><br>
+<a href='Samsung.html'>Samsung</a><br>
 <a href='Matroska.html'>Matroska</a><br>
 <a href='MXF.html'>MXF</a><br>
 <a href='DV.html'>DV</a><br>
@@ -107,9 +109,9 @@ The tables listed below give the names of all tags recognized by ExifTool.
 <a href='Real.html'>Real</a><br>
 <a href='RIFF.html'>RIFF</a><br>
 <a href='AIFF.html'>AIFF</a><br>
-<a href='ASF.html'>ASF</a><br>
+<a href='ASF.html'>ASF</a></td><td width='16%'>
 <a href='DICOM.html'>DICOM</a><br>
-<a href='HTML.html'>HTML</a></td><td width='16%'>
+<a href='HTML.html'>HTML</a><br>
 <a href='Torrent.html'>Torrent</a><br>
 <a href='EXE.html'>EXE</a><br>
 <a href='LNK.html'>LNK</a><br>
@@ -189,7 +191,7 @@ question.
 </p>
 <hr>
 (This document generated automatically by Image::ExifTool::BuildTagLookup)
-<br><i>Last revised Sep 13, 2013</i>
+<br><i>Last revised Oct 28, 2013</i>
 <p class=lf><a href='../index.html'>&lt;-- Back to ExifTool home page</a></p>
 </body>
 </html>

data/bin/{Image-ExifTool-9.37 → Image-ExifTool-9.41}/html/ancient_history.html

@@ -13,6 +13,207 @@
 <p><b>Note:</b> This page gives the history of older exiftool versions.  See
 <a href="history.html">history.html</a> for the recent history.</p>
 
+<a name='v9.24'><b>Mar. 23, 2013 - Version 9.24</b></a>
+<ul>
+<li>Added ability to overwrite plus append output files (-w+!)
+<li>Added support for Sigma X3F version 3.0 images
+<li>Added a few new values for some Pentax tags
+<li>Added a few new CanonModelID's
+<li>Decode Nikon D5100 and D5200 custom settings plus a few other Nikon tags
+<li>Allow the value for missing tags extracted with the -f option to be
+    configured via the API MissingTagValue setting (default is still "-")
+<li>Improved decoding of Sony LensSpec (again, thanks Jos Roost)
+<li>Fixed bug reading QuickTime extended-size atoms
+</ul>
+
+<a name='v9.23'><b>Mar. 10, 2013 - Version 9.23</b></a>
+<ul>
+<li>Added -W (-tagOut) and -Wext (-tagOutExt) options to allow multiple tags
+    to be extracted to separate output files from a single source file
+<li>Added append feature to -w (-w+)
+<li>Added ability to extract SoundFile from Ricoh RMETA
+<li>Added more SonyModelID and Sony LensType values and improved Sony LensType
+    decoding (thanks Jos Roost)
+<li>Added a new Olympus LensType (thanks Niels Kristian Bech Jensen)
+<li>Added another Pentax LensType
+<li>Decode more Nikon flash information (thanks Alyda Gilmore for the samples)
+<li>Decode Pentax Kelvin white balance tags (thanks Klaus Homeister)
+<li>Extract PDF embedded image color space
+<li>Improved Spanish translations (thanks Emilio Sancha)
+<li>More patches to avoid "APP1 segment too large" errors when copying all tags
+    from some RAW images
+</ul>
+
+<a name='v9.22'><b>Mar. 2, 2013 - Version 9.22</b></a>
+<ul>
+<li>Fixed problem extracting metadata from encrypted embedded JPEG images in PDF
+    files and added the ability to extract JPEG 2000 information too
+</ul>
+
+<a name='v9.21'><b>Mar. 2, 2013 - Version 9.21</b></a>
+<ul>
+<li>Added ability to extract embedded images and their metadata from PDF files
+<li>Added read support for binary-format PLIST files
+<li>Added support for Sigma DP3 Merrill maker notes
+<li>Added a few new Sigma LensType values
+<li>Added a new FujiFilm PictureMode value
+<li>Decode a number of new Pentax tags (thanks Klaus Homeister)
+<li>Decode more Sony tags (thanks Jos Roost)
+<li>Decode some new Nikon D800 tags (thanks Alyda Gilmore for the samples)
+<li>Decode a number of new tags in 3GP videos
+<li>Decode Pentax CameraType
+<li>Made a few more DNG tags writable (but protected)
+<li>Fixed problem reading XREF table of some PDF files
+<li>API Changes:
+    <ul>
+    <li>The CombineInfo() routine is now deprecated because it is likely that
+        nobody ever used it.  If anyone actually uses this, please let me know
+    </ul>
+</li>
+</ul>
+
+<a name='v9.20'><b>Feb. 20, 2013 - Version 9.20</b></a>
+<ul>
+<li>NOTICE: This release fixes a problem in the 9.19 Windows version that could
+    cause ExifTool to crash when writing metadata to some files  (it seems that
+    one of the files in the 9.19 Windows package was corrupted)
+<li>Added a new PentaxModelID
+<li>Added write support for a few Getty Images XMP tags
+<li>Decode Sony AFAreaModeSetting (thanks Jos Roost)
+</ul>
+
+<a name='v9.19'><b>Feb. 20, 2013 - Version 9.19</b></a>
+<ul>
+<li>Added read support for Phase One IIQ maker notes
+<li>Added a couple of new Minolta Teleconverter values
+<li>Patched problem which could result in runtime warning when extracting
+    information from a file with an incorrectly formatted PreviewImage pointer
+<li>Improved handling of unknown maker notes when writing to reduce the chance
+    of corruption (fixes problem of corrupted SilverFast maker notes)
+<li>Fixed bug in HtmlDump where unused bytes at end of MakerNotes were not shown
+    if they came at the end of a TIFF-format file
+</ul>
+
+<a name='v9.18'><b>Feb. 16, 2013 - Version 9.18</b></a>
+<ul>
+<li>Decode more AF information for Sony SLT models (thanks Andy Johnson for the
+    samples)
+<li>Recognize CameraInfo and ColorData information from newer Canon 1DX firmware
+<li>Organized support files in full Perl distribution into separate directories
+<li>Improved German and Spanish translations (thanks Herbert Kauer and Emilio
+    Sancha)
+<li>Fixed inconsistency where a priority tag could be hidden by a same-named tag
+    in the same group when using the -j or -X option combined with -g or -G
+<li>Fixed problem in standard tests that could cause ExifTool test 25 to fail
+</ul>
+
+<a name='v9.17'><b>Feb. 9, 2013 - Version 9.17</b></a>
+<ul>
+<li>Added PLIST and MODD to the list of supported file extensions
+<li>Added track name to UserData tags within QuickTime tracks
+<li>Added a new Pentax LensType (thanks Pietu Pohjalainen)
+<li>Added a new Canon LensType
+<li>Decode binary data in PLIST and MODD files
+<li>Decode new Canon 1DX CustomFunctions
+<li>Issue a minor warning and ignore duplicate PDF Info dictionaries unless the
+    -m option is used
+<li>Improved date/time parsing when writing to allow single-digit fields
+<li>Improved decoding/naming of a few Sony tags (thanks Jos Roost)
+<li>Improved German translations (thanks Herbert Kauer)
+<li>Changed a few PLIST tag names
+<li>Fixed decoding of Olympus CameraType for some models
+<li>Fixed problem calculating AvgBitrate for some video files
+<li>Fixed problem writing Canon:LensSerialNumber
+</ul>
+
+<a name='v9.16'><b>Feb. 2, 2013 - Version 9.16</b></a>
+<ul>
+<li>Added support for DarwinCore XMP tags
+<li>Added support for CinemaDNG tags
+<li>Added basic support for parsing XML PLIST information, and use this to
+    extract tags from QuickTime iTunesInfo Data
+<li>Added a new Pentax lens (thanks Niels Kristian Bech Jensen)
+<li>Added some new Sony E-mount lenses (thanks Jos Roost)
+<li>Added a new NEFBitDepth value (thanks Jos Roost)
+<li>Added a new CanonModelID
+<li>Decode a few more Sony tags (thanks Jos Roost)
+<li>Improved decoding of QuickTime iTunesInfo tags
+<li>Improved Spanish translations (thanks Emilio Sancha)
+<li>Improved handling of errors in Perl expression of new formatting feature
+<li>Improved -p option to also handle structures
+<li>Changed a number of Sigma lens names for Olympus to conform with official
+    Sigma model names (thanks Niels Kristian Bech Jensen)
+<li>Moved the MWG XMP tags documentation to the MWG page
+<li>Patched to allow reading GPX track logs with no version number
+<li>Fixed problem reading an ID3 POPM frame with a missing counter
+<li>Fixed bug which could cause "uninitialized value" runtime warning when
+    reading Nikon maker notes with an empty RetouchHistory
+<li>API Changes:
+    <ul>
+    <li>Compatibility Notice: The MWG Composite tags are no longer automatically
+        loaded just by using the MWG module.  Image::ExifTool::MWG::Load() must
+        now be called explicitly to load these tags
+    </ul>
+</ul>
+
+<a name='v9.15'><b>Jan. 27, 2013 - Version 9.15</b></a>
+<ul>
+<li>Added advanced formatting feature to -p and -tagsFromFile options
+<li>Added -echo3 and -echo4 options
+<li>Added a few more Olympus LensType values, removed one, changed some lens
+    names for consistency (all thanks Niels Kristian Bech Jensen), and use
+    hexadecimal instead of decimal for numerical LensType values
+<li>Added a number of new Sony E-mount lenses
+<li>Added a new Tamron lens for Sony (thanks Marcin Krol)
+<li>Trim trailing spaces from Panasonic LensType strings
+<li>Fixed bug which could cause "Can't call method GetMarkerPointers" runtime
+    warning when writing certain types of corrupted images
+<li>Fixed problem copying PrevewImage from some corrupted files
+<li>Fixed problem identifying a Sigma lens for Nikon at some focal lengths 
+<li>API Changes:
+    <ul>
+    <li>Added AddUserDefinedTags() method
+    <li>Added formatting feature for tag values in SetNewValuesFromFile()
+    </ul>
+</ul>
+
+<a name='v9.14'><b>Jan. 18, 2013 - Version 9.14</b></a>
+<ul>
+<li>Added -wm (-writeMode) option to provide control over tag write/create mode
+<li>Added ability to use wildcards in target tag names when writing
+<li>Added ability to read/write Jpeg2000 XML tag as a block
+<li>Added ability to delete MPF segment (with -MPF:All=)
+<li>Added a number of new Olympus lenses (thanks Niels Kristian Bech Jensen)
+<li>Added a new Nikon LensID (thanks Robert Rottmerhusen)
+<li>Added a number of new Pentax LensType's (thanks Alan Robinson for one)
+<li>Added a few new CanonModelID's and Canon LensType's
+<li>Decode ID3v2 POPM and OWNE frames
+<li>Decode new Canon 6D CustomFunctions
+<li>Improved calculation of ScaleFactor35efl for Canon cameras
+<li>Changed priority of PDF Info tags so tags from most recent Info dictionary
+    take precedence (to partially accomodate the questionable Acrobat Pro
+    incremental update technique)
+<li>Changed some verbose warnings when attempting to write "unsafe" tags
+<li>Changed behaviour so that "unsafe" tags are not copied for any tag specified
+    using a wildcard (previously this was the behaviour for a tag name of 'all'
+    or '*', but not names like 'gps*')
+<li>Fixed bug where a Composite tag could sometimes not be generated when the
+    -struct option was used if the tag was derived from an XMP List-type tag
+<li>Fixed problem conditionally deleting GIF Comment and MIE tags
+<li>Fixed decoding of RawImageWidth/Height from FujiFilm X-E1 RAF images
+<li>API Changes:
+    <ul>
+    <li>Added WriteMode option
+    </ul>
+</ul>
+
+<a name='v9.13'><b>Jan. 10, 2013 - Version 9.13</b></a> <span class=grn>(production release)</span>
+<ul>
+<li>Added basic validation of ExifVersion and FlashpixVersion tags when writing
+<li>Fixed problem where MPF PreviewImage was lost when editing metadata in JPEG
+    images from the Nikon D4, D600 or D800
+</ul>
+
 <a name='v9.12'><b>Jan. 2, 2013 - Version 9.12</b></a> <span class=grn>(production release)</span>
 <ul>
 <li>Fixed problem introduced in 9.10 preserving file modification date/time when

data/bin/{Image-ExifTool-9.37 → Image-ExifTool-9.41}/html/data_members.html

@@ -46,12 +46,18 @@ value.</p>
 <tr><td>CUR_LANG</td><td>Hash reference for localized language lookup corresponding
     to current 'Lang' options setting.</td></tr>
 
+<tr><td>CUR_WRITE_GROUP</td><td>Current family 1 group while writing.  Currently
+    used only when writing QuickTime tracks.</td></tr>
+
 <tr><td>DEL_GROUP</td><td>Hash of groups to delete.  Value is 1 to delete group
     completely, or 2 if tags were added back after deleting the group.  May
     have a leading "-" if excluded from a delete.</td></tr>
 
 <tr><td>DEL_PREVIEW</td><td>Flag to delete preview from after JPEG EOI</td></tr>
 
+<tr><td>DemoteErrors</td><td>Errors are demoted to warnings and this count is
+    incremented if non-zero to begin with</td></tr>
+
 <tr><td>DIR_COUNT</td><td>Hash reference for counters of various types of directorys (ICC, IPTC,...)</td></tr>
 
 <tr><td>DIR_NAME</td><td>Name of directory currently being processed</td></tr>
@@ -157,6 +163,9 @@ value.</p>
     accumulate lists as usual, or 0 to accumulate lists in TAG_EXTRA "NoList" element (and
     set a TAG_EXTRA "NoListDel" flag for tags that wouldn't have been created).</td></tr>
 
+<tr><td>NO_STRUCT</td><td>Set if structures shouldn't be restored for this metadata.  Used
+    to avoid restoring structures for non-XMP (ie. XML) information.</td></tr>
+
 <tr><td>NO_UNKNOWN</td><td>Don't generate unknown tags automatically even if Unknown option is set</td></tr>
 
 <tr><td>NUM_FOUND</td><td>Number of tags found</td></tr>

data/bin/{Image-ExifTool-9.37 → Image-ExifTool-9.41}/html/exiftool_pod.html

@@ -104,38 +104,38 @@ supported by ExifTool (r = read, w = write, c = create):</p>
 <pre>
   File Types
   ------------+-------------+-------------+-------------+------------
-  3FR   r     | EPS   r/w   | M2TS  r     | PAGES r     | RWZ   r
-  3G2   r     | ERF   r/w   | M4A/V r     | PBM   r/w   | RM    r
-  3GP   r     | EXE   r     | MEF   r/w   | PCD   r     | SO    r
-  ACR   r     | EXIF  r/w/c | MIE   r/w/c | PDF   r/w   | SR2   r/w
-  AFM   r     | EXR   r     | MIFF  r     | PEF   r/w   | SRF   r
-  AI    r/w   | F4A/V r     | MKA   r     | PFA   r     | SRW   r/w
-  AIFF  r     | FFF   r/w   | MKS   r     | PFB   r     | SVG   r
-  APE   r     | FLA   r     | MKV   r     | PFM   r     | SWF   r
-  ARW   r/w   | FLAC  r     | MNG   r/w   | PGF   r     | THM   r/w
-  ASF   r     | FLV   r     | MODD  r     | PGM   r/w   | TIFF  r/w
-  AVI   r     | FPF   r     | MOS   r/w   | PLIST r     | TORRENT r
-  BMP   r     | FPX   r     | MOV   r     | PICT  r     | TTC   r
-  BTF   r     | GIF   r/w   | MP3   r     | PMP   r     | TTF   r
-  CHM   r     | GZ    r     | MP4   r     | PNG   r/w   | VRD   r/w/c
-  COS   r     | HDP   r/w   | MPC   r     | PPM   r/w   | VSD   r
-  CR2   r/w   | HDR   r     | MPG   r     | PPT   r     | WAV   r
-  CRW   r/w   | HTML  r     | MPO   r/w   | PPTX  r     | WDP   r/w
-  CS1   r/w   | ICC   r/w/c | MQV   r     | PS    r/w   | WEBP  r
-  DCM   r     | IDML  r     | MRW   r/w   | PSB   r/w   | WEBM  r
-  DCP   r/w   | IIQ   r/w   | MXF   r     | PSD   r/w   | WMA   r
-  DCR   r     | IND   r/w   | NEF   r/w   | PSP   r     | WMV   r
-  DFONT r     | INX   r     | NRW   r/w   | QTIF  r     | WV    r
-  DIVX  r     | ITC   r     | NUMBERS r   | RA    r     | X3F   r/w
-  DJVU  r     | J2C   r     | ODP   r     | RAF   r/w   | XCF   r
-  DLL   r     | JNG   r/w   | ODS   r     | RAM   r     | XLS   r
-  DNG   r/w   | JP2   r/w   | ODT   r     | RAR   r     | XLSX  r
-  DOC   r     | JPEG  r/w   | OFR   r     | RAW   r/w   | XMP   r/w/c
-  DOCX  r     | K25   r     | OGG   r     | RIFF  r     | ZIP   r
+  3FR   r     | EIP   r     | LNK   r     | PAC   r     | RWL   r/w
+  3G2   r/w   | EPS   r/w   | M2TS  r     | PAGES r     | RWZ   r
+  3GP   r/w   | ERF   r/w   | M4A/V r/w   | PBM   r/w   | RM    r
+  ACR   r     | EXE   r     | MEF   r/w   | PCD   r     | SO    r
+  AFM   r     | EXIF  r/w/c | MIE   r/w/c | PDF   r/w   | SR2   r/w
+  AI    r/w   | EXR   r     | MIFF  r     | PEF   r/w   | SRF   r
+  AIFF  r     | F4A/V r/w   | MKA   r     | PFA   r     | SRW   r/w
+  APE   r     | FFF   r/w   | MKS   r     | PFB   r     | SVG   r
+  ARW   r/w   | FLA   r     | MKV   r     | PFM   r     | SWF   r
+  ASF   r     | FLAC  r     | MNG   r/w   | PGF   r     | THM   r/w
+  AVI   r     | FLV   r     | MODD  r     | PGM   r/w   | TIFF  r/w
+  BMP   r     | FPF   r     | MOS   r/w   | PLIST r     | TORRENT r
+  BTF   r     | FPX   r     | MOV   r/w   | PICT  r     | TTC   r
+  CHM   r     | GIF   r/w   | MP3   r     | PMP   r     | TTF   r
+  COS   r     | GZ    r     | MP4   r/w   | PNG   r/w   | VRD   r/w/c
+  CR2   r/w   | HDP   r/w   | MPC   r     | PPM   r/w   | VSD   r
+  CRW   r/w   | HDR   r     | MPG   r     | PPT   r     | WAV   r
+  CS1   r/w   | HTML  r     | MPO   r/w   | PPTX  r     | WDP   r/w
+  DCM   r     | ICC   r/w/c | MQV   r/w   | PS    r/w   | WEBP  r
+  DCP   r/w   | IDML  r     | MRW   r/w   | PSB   r/w   | WEBM  r
+  DCR   r     | IIQ   r/w   | MXF   r     | PSD   r/w   | WMA   r
+  DFONT r     | IND   r/w   | NEF   r/w   | PSP   r     | WMV   r
+  DIVX  r     | INX   r     | NRW   r/w   | QTIF  r/w   | WV    r
+  DJVU  r     | ITC   r     | NUMBERS r   | RA    r     | X3F   r/w
+  DLL   r     | J2C   r     | ODP   r     | RAF   r/w   | XCF   r
+  DNG   r/w   | JNG   r/w   | ODS   r     | RAM   r     | XLS   r
+  DOC   r     | JP2   r/w   | ODT   r     | RAR   r     | XLSX  r
+  DOCX  r     | JPEG  r/w   | OFR   r     | RAW   r/w   | XMP   r/w/c
+  DPX   r     | K25   r     | OGG   r     | RIFF  r     | ZIP   r
   DV    r     | KDC   r     | OGV   r     | RSRC  r     |
-  DVB   r     | KEY   r     | ORF   r/w   | RTF   r     |
-  DYLIB r     | LA    r     | OTF   r     | RW2   r/w   |
-  EIP   r     | LNK   r     | PAC   r     | RWL   r/w   |</pre>
+  DVB   r/w   | KEY   r     | ORF   r/w   | RTF   r     |
+  DYLIB r     | LA    r     | OTF   r     | RW2   r/w   |</pre>
 <pre>
   Meta Information
   ----------------------+----------------------+---------------------
@@ -161,10 +161,10 @@ supported by ExifTool (r = read, w = write, c = create):</p>
 names), except for single-character options when the corresponding
 upper-case option exists.  Many single-character options have equivalent
 long-name versions (shown in brackets), and some options have inverses which
-are invoked with a leading double-dash.  Note that multiple single-character
-options may NOT be combined into one argument because this would be
-interpreted as a tag name.  Contrary to standard practice, options may
-appear after source file names on the exiftool command line.</p>
+are invoked with a leading double-dash.  Unrecognized options are
+interpreted as tag names (for this reason, multiple single-character options
+may NOT be combined into one argument).  Contrary to standard practice,
+options may appear after source file names on the exiftool command line.</p>
 <p>
 </p>
 <h2><a name="option_summary">Option Summary</a></h2>
@@ -255,6 +255,7 @@ appear after source file names on the exiftool command line.</p>
   -ver                             Print exiftool version number</pre>
 <p><a href="#advanced_options">Advanced options</a></p>
 <pre>
+  -api OPT[=VAL]                   Set ExifTool API option
   -common_args                     Define common arguments
   -config CFGFILE                  Specify configuration file name
   -echo[NUM] TEXT                  Echo text to stdout or stderr
@@ -308,9 +309,10 @@ tags from being copied (when redirecting to another tag, it is the source
 tag that should be excluded), or to exclude groups from being deleted when
 deleting all information (ie. <code>-all= --exif:all</code> deletes all but EXIF
 information).  But note that this will not exclude individual tags from a
-group delete.  Instead, individual tags may be recovered using the
-<strong>-tagsFromFile</strong> option (ie. <code>-all= -tagsfromfile @ -artist</code>). Wildcards
-are permitted as described above for <strong>-TAG</strong>.</p>
+group delete (unless a family 2 group is specified, see note 4 below). 
+Instead, individual tags may be recovered using the <strong>-tagsFromFile</strong> option
+(ie. <code>-all= -tagsfromfile @ -artist</code>). Wildcards are permitted as described
+above for <strong>-TAG</strong>.</p>
 </dd>
 <dt><strong><a name="tag_value" class="item"><strong>-</strong><em>TAG</em>[+-]<strong>=</strong>[<em>VALUE</em>]</a></strong></dt>
 
@@ -322,23 +324,24 @@ add or remove existing entries from a list, or to shift date/time values
 <code>+=</code> may also be used to increment numerical values, and <code>-=</code> may be used
 to conditionally delete or replace a tag (see <a href="#writing_examples">WRITING EXAMPLES</a> for
 examples).</p>
-<p><em>TAG</em> may contain a leading family 0 or 1 group name separated by a colon.
-If no group name is specified, the tag is created in the preferred group,
-and updated in any other location where a same-named tag already exists. 
-The preferred group is the first group in the following list where <em>TAG</em> is
-valid: 1) EXIF, 2) IPTC, 3) XMP.</p>
+<p><em>TAG</em> may contain one or more leading family 0, 1 or 2 group names,
+prefixed by optional family numbers, and separated colons.  If no group name
+is specified, the tag is created in the preferred group, and updated in any
+other location where a same-named tag already exists.  The preferred group
+is the first group in the following list where <em>TAG</em> is valid: 1) EXIF, 2)
+IPTC, 3) XMP.</p>
 <p>The wildcards <code>*</code> and <code>?</code> may be used in tag names to assign the same
 value to multiple tags.  When specified with wildcards, &quot;unsafe&quot; tags are
 not written.  A tag name of <code>All</code> is eqivalent to <code>*</code> (except that it
 doesn't require quoting, while arguments with wildcards do on systems with
 shell globbing), and is often used when deleting all metadata (ie. <code>-All=</code>)
-or an entire group (ie. <code>-GROUP:All=</code>).  Note that not all groups are
-deletable, and that the JPEG APP14 &quot;Adobe&quot; group is not removed by default
-with <code>-All=</code> because it may affect the appearance of the image.  Use the
-<strong>-listd</strong> option for a complete list of deletable groups, and see note 3
-below regarding the &quot;APP&quot; groups.  Also, within an image some groups may be
-contained within others, and these groups are removed if the containing
-group is deleted:</p>
+or an entire group (ie. <code>-GROUP:All=</code>, see note 4 below).  Note that not
+all groups are deletable, and that the JPEG APP14 &quot;Adobe&quot; group is not
+removed by default with <code>-All=</code> because it may affect the appearance of the
+image.  Use the <strong>-listd</strong> option for a complete list of deletable groups,
+and see note 5 below regarding the &quot;APP&quot; groups.  Also, within an image some
+groups may be contained within others, and these groups are removed if the
+containing group is deleted:</p>
 <pre>
   JPEG Image:
   - Deleting EXIF or IFD0 also deletes ExifIFD, GlobParamIFD,
@@ -350,9 +353,9 @@ group is deleted:</p>
   - Deleting EXIF only removes ExifIFD which also deletes
     InteropIFD and MakerNotes.</pre>
 <p>Notes:</p>
-<p>1) Many tag values may be assigned in a single command.  If two assignments
-affect the same tag, the latter takes precedence (except for list-type tags,
-where both values are written).</p>
+<p>1) <strong>Many tag values may be assigned in a single command</strong>.  If two
+assignments affect the same tag, the latter takes precedence (except for
+list-type tags, where both values are written).</p>
 <p>2) In general, MakerNotes tags are considered &quot;Permanent&quot;, and may be edited
 but not created or deleted individually.  This avoids many potential
 problems including the inevitable compatibility problems with OEM software
@@ -361,7 +364,15 @@ maker notes.</p>
 <p>3) Changes to PDF files are reversible because the original information is
 never actually deleted from the file.  So ExifTool alone may not be used to
 securely edit metadata in PDF files.</p>
-<p>4) The &quot;APP&quot; group names (&quot;APP0&quot; through &quot;APP15&quot;) are used to delete JPEG
+<p>4) Specifying <code>-GROUP:all=</code> deletes the entire group as a block unless a
+family 2 group is specified, in which case the tags are deleted
+individually.  (Since the family 2 categories do not represent physical
+metadata blocks.)  So only in this case may individual tags be excluded from
+the mass delete.  For example, <code>-time:all --Exif:Time:All</code> removes all
+deletable Time tags except those in the EXIF.  This difference also applies
+when deleting all by family 2 group (ie. <code>-2all:all=</code>) which deletes tags
+individually, as opposed to <code>-all:all=</code> which deletes entire blocks.</p>
+<p>5) The &quot;APP&quot; group names (&quot;APP0&quot; through &quot;APP15&quot;) are used to delete JPEG
 application segments which are not associated with another deletable group. 
 For example, specifying <code>-APP14:All=</code> will NOT delete the APP14 &quot;Adobe&quot;
 segment because this is accomplished with <code>-Adobe:All</code>.</p>
@@ -395,10 +406,10 @@ groups.  This allows some information to be automatically transferred to the
 appropriate group when copying between images of different formats. However,
 if a group name is specified for a tag then the information is written only
 to this group (unless redirected to another group, see below).  If <code>All</code> is
-used as a group name, then the information is written to the same family 1
-group in the destination <em>FILE</em>.  In this way, <code>-All:All</code> is used to copy
-all information while preserving the family 1 group (ie. the specific
-location in the metadata) of each tag.</p>
+used as a group name, then each tag is written to the same family 1 group it
+had in the source file (ie. the same specific location in the metadata), but
+a different family may be specified by adding a leading family number to the
+group name (ie. <code>-0All:all</code>).</p>
 <p><em>SRCFILE</em> may be the same as <em>FILE</em> to move information around within a
 single file.  In this case, <code>@</code> may be used to represent the source file
 (ie. <code>-tagsFromFile @</code>), permitting this feature to be used for batch
@@ -602,13 +613,16 @@ examples demonstrate basic use of this option:</p>
 <pre>
     # update metadata for all images in a directory from CSV file
     exiftool -csv=a.csv dir</pre>
-<p>Empty values are ignored when importing.  To force a tag to be deleted, use
-the <strong>-f</strong> option and set the value to &quot;-&quot; in the CSV file (or to the
-MissingTagValue if this API option was used).  May be combined with the
-<strong>-g</strong> or <strong>-G</strong> option to add group names to the tags.  If the <strong>-a</strong> option
-is used to allow duplicate tag names, the duplicate tags are only included
-in the CSV output if the column headings are unique.  Adding the <strong>-G4</strong>
-option ensures a unique column heading for each tag.</p>
+<p>Empty values are ignored when importing.  Also, FileName and Directory
+columns are ignored if they exist (ie. ExifTool will not attempt to write
+these tags with a CSV import).  To force a tag to be deleted, use the <strong>-f</strong>
+option and set the value to &quot;-&quot; in the CSV file (or to the MissingTagValue
+if this API option was used).</p>
+<p>When exporting a CSV file, the <strong>-g</strong> or <strong>-G</strong> option to add group names to
+the tag headings.  If the <strong>-a</strong> option is used to allow duplicate tag names,
+the duplicate tags are only included in the CSV output if the column
+headings are unique.  Adding the <strong>-G4</strong> option ensures a unique column
+heading for each tag.</p>
 <p>List-type tags are stored as simple strings in a CSV file, but the <strong>-sep</strong>
 option may be used to split them back into separate items when importing.</p>
 <p>Special feature:  <strong>-csv</strong>+=<em>CSVFILE</em> may be used to add items to existing
@@ -729,8 +743,8 @@ may be suffixed with a <code>#</code> to disable print conversion.</p>
 
 <dd>
 <p>Use long 2-line Canon-style output format.  Adds a description and
-unconverted value to the XML, JSON or PHP output when <strong>-X</strong>, <strong>-j</strong> or
-<strong>-php</strong> is used.</p>
+unconverted value (if it is different from the converted value) to the XML,
+JSON or PHP output when <strong>-X</strong>, <strong>-j</strong> or <strong>-php</strong> is used.</p>
 </dd>
 <dt><strong><a name="l" class="item"><strong>-L</strong> (<strong>-latin</strong>)</a></strong></dt>
 
@@ -814,7 +828,7 @@ are ignored.  For example, this format file:</p>
     exiftool -p test.fmt a.jpg b.jpg</pre>
 <p>produces output like this:</p>
 <pre>
-    -- Generated by ExifTool 9.37 --
+    -- Generated by ExifTool 9.41 --
     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
@@ -1039,7 +1053,7 @@ although %c is only valid for output file names.</p>
 <dd>
 <p>This enhanced version of the <strong>-w</strong> option allows a separate output file to
 be created for each extracted tag.  The differences between <strong>-W</strong> and <strong>-w</strong>
-are listed below:</p>
+are as follows:</p>
 <p>1) With <strong>-W</strong>, a new output file is created for each extracted tag.</p>
 <p>2) <strong>-W</strong> supports three additional format codes:  %t, %g and %s represent
 the tag name, group name, and suggested extension for the output file (based
@@ -1476,8 +1490,8 @@ read/write support for tags as recommended by the Metadata Working Group.
 To save typing, <code>-use MWG</code> is assumed if the <code>MWG</code> group is specified for
 any tag on the command line.  See the
 <a href="TagNames/MWG.html">MWG Tags documentation</a> for more
-details.  (Note that this option is not reversible, and remains in effect
-until the application terminates, even across the <code>-execute</code> option.)</p>
+details.  Note that this option is not reversible, and remains in effect
+until the application terminates, even across the <code>-execute</code> option.</p>
 </dd>
 </dl>
 <p>
@@ -1590,6 +1604,13 @@ drag-and-drop applications.  These options may also be used to improve
 performance in multi-pass processing by reducing the overhead required to
 load exiftool for each invocation.</p>
 <dl>
+<dt><strong><a name="api_opt_val" class="item"><strong>-api</strong> <em>OPT[=VAL]</em></a></strong></dt>
+
+<dd>
+<p>Set ExifTool API option.  <em>OPT</em> is a case-sensitive API option name.  The
+option value is set to 1 if <em>=VAL</em> is omitted.  See <a href="ExifTool.html#options">Image::ExifTool Options</a> for a list of available API options.  This
+overrides API options set via the config file.</p>
+</dd>
 <dt><strong><a name="common_args" class="item"><strong>-common_args</strong></a></strong></dt>
 
 <dd>