exiftool_vendored 9.99.0 → 10.01.0

data/bin/{Image-ExifTool-9.99 → Image-ExifTool-10.01}/html/exiftool_pod.html

@@ -416,10 +416,13 @@ 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 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 (eg. <code>-0All:all</code>).</p>
+used as a group name, then the specified tag(s) are written to the same
+family 1 group they had in the source file (ie. the same specific location,
+like ExifIFD or XMP-dc).  For example, the common operation of copying all
+writable tags to the same specific locations in the output <em>FILE</em> is
+achieved by adding <code>-all:all</code>.  A different family may be specified by
+adding a leading family number to the group name (eg. <code>-0all:all</code> preserves
+the same general location, like EXIF or XMP).</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
@@ -874,7 +877,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.99 --
+    -- Generated by ExifTool 10.01 --
     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
@@ -900,8 +903,9 @@ underline:</p>
 <pre>
     exiftool -p '${make;tr/ /_/;s/__+/_/g}' image.jpg</pre>
 <p>A default expression of <code>tr(/\\?*:|&quot;&lt;&gt;\0)()d</code> is assumed if the
-expression is empty, which removes the characters / \ ? * : | &lt; &gt;
-and null from the printed value.</p>
+expression is empty.  This removes the characters / \ ? * : | &lt; &gt;
+and null from the printed value.  (These characters are illegal in Windows
+file names, so this feature is useful if tag values are used in file names.)</p>
 </dd>
 <dt><strong><a name="php" class="item"><strong>-php</strong></a></strong></dt>
 
@@ -931,8 +935,8 @@ or up to 3 <strong>-s</strong> options for even shorter formats:</p>
 <dt><strong><a name="s" class="item"><strong>-S</strong> (<strong>-veryShort</strong>)</a></strong></dt>
 
 <dd>
-<p>Very short format.  The same as <strong>-s2</strong> (or two <strong>-s</strong> options).  Tag names
-are printed instead of descriptions, and no extra spaces are added to
+<p>Very short format.  The same as <strong>-s2</strong> or two <strong>-s</strong> options.  Tag names are
+printed instead of descriptions, and no extra spaces are added to
 column-align values.</p>
 </dd>
 <dt><strong><strong>-sep</strong> <em>STR</em> (<strong>-separator</strong>)</strong></dt>
@@ -1143,19 +1147,20 @@ one type of file.  Use <strong>--Wext</strong> to write all but the specified ty
 <strong>-b</strong>, <strong>-D</strong>, <strong>-H</strong>, <strong>-l</strong>, <strong>-s</strong>, <strong>-sep</strong>, <strong>-struct</strong> and <strong>-t</strong> may be used
 in combination with <strong>-X</strong> to affect the output, but note that the tag ID
 (<strong>-D</strong>, <strong>-H</strong> and <strong>-t</strong>), binary data (<strong>-b</strong>) and structured output
-(<strong>-struct</strong>) options are not effective for the short output (<strong>-s</strong>). 
-Another restriction of <strong>-s</strong> is that only one tag with a given group and
-name may appear in the output.  Note that the tag ID options (<strong>-D</strong>, <strong>-H</strong>
-and <strong>-t</strong>) will produce non-standard RDF/XML unless the <strong>-l</strong> option is also
-used.  By default, list-type tags with multiple values are formatted as an
-RDF Bag, but they are combined into a single string when <strong>-s</strong> or <strong>-sep</strong> is
-used.  Using <strong>-L</strong> changes the XML encoding from &quot;UTF-8&quot; to &quot;windows-1252&quot;. 
-Other <strong>-charset</strong> settings change the encoding only if there is a
-corresponding standard XML character set.  The <strong>-b</strong> option causes binary
-data values to be written, encoded in base64 if necessary.  The <strong>-t</strong> option
-adds tag table information to the output (table <code>name</code>, decimal tag <code>id</code>,
-and <code>index</code> for cases where multiple conditional tags exist with the same
-ID).</p>
+(<strong>-struct</strong>) options are not effective for the short output (<strong>-s</strong>). Another
+restriction of <strong>-s</strong> is that only one tag with a given group and name may
+appear in the output.  Note that the tag ID options (<strong>-D</strong>, <strong>-H</strong> and <strong>-t</strong>)
+will produce non-standard RDF/XML unless the <strong>-l</strong> option is also used.</p>
+<p>By default, <strong>-X</strong> outputs flattened tags, so <strong>-struct</strong> should be added if
+required to preserve XMP structures.  List-type tags with multiple values
+are formatted as an RDF Bag, but they are combined into a single string when
+<strong>-s</strong> or <strong>-sep</strong> is used.  Using <strong>-L</strong> changes the XML encoding from &quot;UTF-8&quot;
+to &quot;windows-1252&quot;.  Other <strong>-charset</strong> settings change the encoding only if
+there is a corresponding standard XML character set.  The <strong>-b</strong> option
+causes binary data values to be written, encoded in base64 if necessary. 
+The <strong>-t</strong> option adds tag table information to the output (table <code>name</code>,
+decimal tag <code>id</code>, and <code>index</code> for cases where multiple conditional tags
+exist with the same ID).</p>
 <p>Note: This output is NOT the same as XMP because it uses
 dynamically-generated property names corresponding to the ExifTool tag
 names, and not the standard XMP properties.  To write XMP instead, use the
@@ -1469,9 +1474,9 @@ for EXIF this is the individual IFD (the family 1 group).</p>
 <p>When reading, causes information to be extracted from .gz and .bz2
 compressed images.  (Only one image per archive.  Requires gzip and bzip2 to
 be installed on the system.)  When writing, causes compressed information to
-be written if supported by the image format.  (eg. The PNG format supports
-compressed text.)  This option also disables the recommended padding in
-embedded XMP, saving 2424 bytes when writing XMP in a file.</p>
+be written if supported by the metadata format.  (eg. PNG supports
+compressed textual metadata.)  This option also disables the recommended
+padding in embedded XMP, saving 2424 bytes when writing XMP in a file.</p>
 </dd>
 </dl>
 <p>
@@ -1725,6 +1730,10 @@ processing related preview images or sidecar files.  See the <strong>-w</strong>
 for a description of the <em>FMT</em> syntax.  Note that file name <em>FMT</em> strings
 for all options are based on the original <em>FILE</em> specified from the command
 line, not the name of the source file specified by <strong>-srcfile</strong>.</p>
+<p>For example, to copy metadata from NEF files to the corresponding JPG
+previews in a directory where other JPG images may exist:</p>
+<pre>
+    exiftool -ext nef -tagsfromfile @ -srcfile %d%f.jpg dir</pre>
 <p>If than one <strong>-srcfile</strong> option is specified, the files are tested in order
 and the first existing source file is processed.  If none of the source
 files already exist, then exiftool uses the first <strong>-srcfile</strong> specified.</p>

data/bin/{Image-ExifTool-9.99 → Image-ExifTool-10.01}/html/faq.html

@@ -581,6 +581,10 @@ specified (<code>-L</code> or <code>-charset latin</code>); otherwise an iTXt
 chunk is used and the text is converted from the specified character set and
 stored as UTF&#8209;8.</blockquote>
 
+<blockquote><b>JPEG Comment</b>: The encoding for the JPEG Comment (COM segment)
+is not specified, so ExifTool reads/writes this text without
+conversion.</blockquote>
+
 <blockquote><b>ID3</b>: The ID3v1 specification officially supports only ISO
 8859&#8209;1 encoding (a subset of Windows Latin1), although some applications
 may incorrectly use other character sets.  By default ExifTool converts ID3v1
@@ -1524,7 +1528,7 @@ importing.</blockquote>
 for more details.</blockquote>
 
 <hr>
-<i>Last revised May 11, 2015</i>
+<i>Last revised Sept 1, 2015</i>
 <p class='lf'><a href="index.html">&lt;-- Back to ExifTool home page</a></p>
 </body>
 </html>

data/bin/{Image-ExifTool-9.99 → Image-ExifTool-10.01}/html/history.html

@@ -11,17 +11,48 @@
 
 <p>RSS feed: <a href="http://owl.phy.queensu.ca/~phil/exiftool/rss.xml">http://owl.phy.queensu.ca/~phil/exiftool/rss.xml</a></p>
 
-<p><b>Note:</b> The most recent production release is <a href="Image-ExifTool-9.90.tar.gz">Version 9.90</a>. (Other versions are
+<p><b>Note:</b> The most recent production release is <a href="Image-ExifTool-10.00.tar.gz">Version 10.00</a>. (Other versions are
 considered development releases, and are not uploaded to <a href="http://search.cpan.org/dist/Image-ExifTool/">CPAN</a>.)</p>
 
 <!-- Use line width of 80 -->
 <!-- *********************************************************************** -->
 
+<a name='v10.01'><b>Sept. 3, 2015 - Version 10.01</b></a>
+<ul>
+<li>Added a new Olympus CameraType
+<li>Added a new Canon LensType (thanks Norbert Wasser)
+<li>Decode a new Pentax tag
+<li>Leica programmers should all be ashamed of the complete shambles of metadata
+    they have created
+<li>Minor change to the name of a Sigma lens for Canon
+<li>Improved recognition of Pentax lens adapter
+<li>Implemented NoPDFList for -b option of Windows version too
+<li>Renamed a few Sony tags and improved decoding of others (thanks Jos Roost)
+<li>Renamed a few Pentax tags
+<li>Fixed problem importing structured information from -X option output
+<li>Fixed round-off errors in value and typo in name of CanonVRD:GammaWhitePoint
+<li>Fixed test failures if Encode, POSIX or Time::Local modules are missing
+</ul>
+
+<a name='v10.00'><b>Aug. 18, 2015 - Version 10.00</b></a> <span class=grn>(production release)</span>
+<ul>
+<li>Added a few new CanonModelID's
+<li>Added a few new Nikon LensID's (thanks Jaap Voets and Robert Rottmerhusen)
+<li>Added a new Canon LensType (thanks Jos Roost)
+<li>Decode a number of new Sony tags (thanks Jos Roost)
+<li>Decode a couple more RIFF tags and extract Unknown RIFF tags
+<li>Changed -b option to avoid splitting PDF List-type tag values
+<li>API Changes:
+    <ul>
+    <li>Added NoPDFList option
+    </ul>
+</ul>
+
 <a name='v9.99'><b>July 23, 2015 - Version 9.99</b></a>
 <ul>
 <li>Added support for the Leica Q (Typ 116) maker notes
 <li>Added two new SonyModelID's (thanks Jos Roost for one)
-<li>Added a new Sony LensType2 value (thanks Jos Roost)
+<li>Added two new Sony LensType2 values (thanks Jos Roost)
 <li>Added a new Pentax LensType
 <li>Extract a number of new File System tags when SystemTags API option is set
 <li>Decode a new FujiFilm tag (thanks TonyB)
@@ -385,101 +416,6 @@ considered development releases, and are not uploaded to <a href="http://search.
     -overwrite_original_in_place is used
 </ul>
 
-<a name='v9.75'><b>Nov. 2, 2014 - Version 9.75</b></a>
-<ul>
-<li>Added support for FLIR version 101 metadata
-<li>Added a new Olympus LensType (thanks Niels Kristian Bech Jensen)
-<li>Added a new Pentax LensType (thanks Louis Granboulan)
-<li>Added a new Samsung LensType
-<li>Decode a few more Nikon D4S tags (thanks Warren Hatch)
-<li>Decode a few more Sony tags (thanks Jos Roost)
-<li>Decode a new FujiFilm tag
-<li>Improved formula for calculating Sony:FocusDistance2 (thanks Jos Roost)
-<li>Changed XMP parsing to impose standard namespace prefixes, thus avoiding
-    (some) problems reading the ugly XMP generated by Microsoft products
-<li>Fixed decoding of Nikon FileInfo tags for recent DSLR models
-</ul>
-
-<a name='v9.74'><b>Oct. 15, 2014 - Version 9.74</b></a>
-<ul>
-<li>Added a number of new QuickTime GenreID values (thanks Fran&ccedil;ois Bonzon)
-<li>Added support for some newer Sony cameras (thanks Jos Roost)
-<li>Decode more Nikon D4S custom settings (thanks Warren Hatch)
-<li>Improved lens identification logic for XMP metadata (thanks Jos Roost)
-<li>Fixed typo in Condition for a few D3 NikonCustom tags
-<li>Fixed bug which could cause a "Use of uninitialized value $val" runtime
-    error when reading XML
-</ul>
-
-<a name='v9.73'><b>Oct. 13, 2014 - Version 9.73</b></a>
-<ul>
-<li>Added a new CanonModelID (thanks LibRaw and Niels Kristian Bech Jensen)
-<li>Added a few new Canon and Sony lenses (thanks Jos Roost)
-<li>Delete unknown PNG TextualData tags when deleting all PNG tags
-<li>Decode AF points for Canon PowerShot G1X Mark II
-<li>Decode a number of Pentax, Olympus, Panasonic and Sony tags (thanks LibRaw)
-<li>Decode a few more Nikon NCTG tags in MOV videos (thanks Stuart Bennett)
-<li>Decode Nikon D4S custom settings (thanks Warren Hatch)
-<li>Decode some makernote tags in Sony Xperia Z3 images
-<li>Make PhotoshopThumbnail and PhotoshopBGRThumbnail writable (but "unsafe")
-<li>Changed order of operations so flattened tags always take precedence over
-    structured tags when writing a mix of both types of tags
-<li>Fixed potential bug decoding some Nikon 1 AF points
-</ul>
-
-<a name='v9.72'><b>Sept. 26, 2014 - Version 9.72</b></a>
-<ul>
-<li>Added a few new Pentax ISO values
-<li>Added a new CanonModelID and SonyModelID (thanks LibRaw)
-<li>Added a new Canon LensType
-<li>Decode AF points for some newer Nikon 1 cameras (thanks Chris Reimold for
-    his help, and Graham Woolf for the samples)
-<li>Improved verbose output for recently decoded Samsung trailer
-<li>Fixed Samsung trailer writer to properly update offsets in the QDIO block
-</ul>
-
-<a name='v9.71'><b>Sept. 20, 2014 - Version 9.71</b></a>
-<ul>
-<li>Added a couple of mew CanonModelID's (thanks LibRaw)
-<li>Added a couple of new Nikon LensID's (thanks Robert Rottmerhusen and LibRaw)
-<li>Added minor warning when deleting all PDF metadata (because it isn't really
-    deleted)
-<li>Added a new Samsung LensType
-<li>Added a new Sony/Minolta LensType (thanks Marcus Holland-Moritz)
-<li>Decode "Sound &amp; Shot" trailer written by some Samsung Galaxy models
-<li>Decode a number of new Sony tags including FocusDistance2 (thanks Jos Roost)
-<li>Decode a number of new Canon and Kodak tags (thanks LibRaw)
-<li>Decode a new EXIF tag
-<li>Decode a few new CanonCustom tags
-<li>Recognize the JPE file extension
-<li>Fixed swapped CanonCustom AEMicroadjustment/FEMicroadjustment tag names
-<li>Fixed bug in -listItem option which sometimes prevented it from working
-<li>Fixed interference by -sep option when writing structured tags
-<li>API Changes:
-    <ul>
-    <li>Added ListItem option
-    </ul>
-</ul>
-
-<a name='v9.70'><b>Sept. 3, 2014 - Version 9.70</b></a> <span class=grn>(production release)</span>
-<ul>
-<li>Added read support for Pentax 645Z makernotes in MOV videos
-<li>Added a new Canon LensType (thanks Norbert Wasser)
-<li>Added a new SonyModelID (thanks LibRaw)
-<li>Added a new Pentax LensType (thanks Dominique Schrekling)
-<li>Added a new PentaxModelID
-<li>Added a new Olympus CameraType (thanks LibRaw)
-<li>Decode a number of new Sony tags and values (thanks Jos Roost)
-<li>Decode a new Panasonic tag
-<li>Decode another QuickTime tag
-<li>Updated Nikon ISOExpansion values for new models (thanks LibRaw)
-<li>Improved verbose dump for LFP images
-<li>Patched to repair incorrect list types in XMP structures when writing
-<li>Patched to avoid MPEG Layer 3 check for files with a "MUS" extension
-<li>Fixed incorrect behaviour of -addTagsFromFile when adding list items from
-    multiple variable-named source files
-</ul>
-
 <a name='ancient' href="ancient_history.html"><b>History of older versions</b> (back to 1.00) --></a><br><br>
 
 <hr>

data/bin/{Image-ExifTool-9.99 → Image-ExifTool-10.01}/html/idiosyncracies.html

@@ -121,6 +121,10 @@ PreviewImage.</li>
 <li>Tag 0x0302 has an invalid offset (0xffffffff).</li>
 </ul>
 
+<p>OK, I give up on Leica.  The new Leica S (Typ 007) stores the preview image
+in the JPG file using a completely nonsensical technique, as well as various
+other stupid blunders.  [To Leica: Try looking at the MPF specification.]</p>
+
 <p><a name="Minolta"><b>Minolta:</b></a> An obvious bug in the firmware of the Z2 writes an incorrect
 offset for the 'MinoltaCameraSettings2' information -- it writes the offset of
 the offset itself instead of the offset of the value (hahaha!).  Other
@@ -260,7 +264,7 @@ WB2000] [2013-07-25: Add the NX2000 to this list]</i>)</p>
 
 <hr>
 <i>Created Mar. 25, 2005</i>
-<br><i>Last revised Jul. 21, 2014</i>
+<br><i>Last revised Aug. 25, 2014</i>
 <p class='lf'><a href="index.html">&lt;-- Back to ExifTool home page</a></p>
 </body>
 </html>

data/bin/{Image-ExifTool-9.99 → Image-ExifTool-10.01}/html/index.html

@@ -74,9 +74,9 @@ span.sup        { font-size: 0.8em; font-weight: normal; position: relative; top
 </div>
 
 <blockquote><table class='dl lg'><tr><td><b>
-<a href="Image-ExifTool-9.99.tar.gz">
-Download        Version 9.99</a> (3.8 MB) -
-<a href="history.html">July 23, 2015</a></b></td></tr></table></blockquote>
+<a href="Image-ExifTool-10.01.tar.gz">
+Download        Version 10.01</a> (3.8 MB) -
+<a href="history.html">Sept. 3, 2015</a></b></td></tr></table></blockquote>
 
 <p><b>ExifTool is a platform-independent <a href="ExifTool.html">Perl
 library</a> plus a <a href="exiftool_pod.html">command-line application</a> for
@@ -125,8 +125,8 @@ distribution above.)</i></p>
 
 <blockquote><table class='dl lg'><tr><td><b>
 <a name="alone">Windows Executable:</a>
-<a href="exiftool-9.99.zip">
-         exiftool-9.99.zip</a> (3.8 MB)</b></td></tr></table></blockquote>
+<a href="exiftool-10.01.zip">
+         exiftool-10.01.zip</a> (3.8 MB)</b></td></tr></table></blockquote>
 
 <p><b>The stand-alone Windows executable</b> does not require Perl. Just
 download and un-zip the archive then double-click on
@@ -137,8 +137,8 @@ of Windows (including Windows 7).</p>
 
 <blockquote><table class='dl lg'><tr><td><b>
 Mac OS X Package:
-<a href="ExifTool-9.99.dmg">
-         ExifTool-9.99.dmg</a> (2.5 MB)</b></td></tr></table></blockquote>
+<a href="ExifTool-10.01.dmg">
+         ExifTool-10.01.dmg</a> (2.5 MB)</b></td></tr></table></blockquote>
 
 <p><b>The OS X package</b> installs the ExifTool command-line application and
 libraries in /usr/bin. After installing, type "<code>exiftool</code>" in a
@@ -148,7 +148,7 @@ Terminal window to run exiftool and read the application documentation.</p>
 installing ExifTool on Windows, Mac OS X and Unix systems.</p>
 
 <p><i>(<a href="http://owl.phy.queensu.ca/~phil/exiftool/checksums.txt">click here
-for the SHA1 and MD1 checksums to verify these distribution packages</a>.)</i></p>
+for the SHA1 and MD5 checksums to verify these distribution packages</a>.)</i></p>
 
 <h2><a name="features">Features</a></h2>
 <ul>

data/bin/{Image-ExifTool-9.99 → Image-ExifTool-10.01}/html/install.html

@@ -51,10 +51,10 @@ documentation or some other files of the full distribution.</p>
 <h3>Stand-Alone Executable</h3>
 <ol>
 <li><b>Download</b> the <b>Windows Executable</b> from the <a href="index.html">ExifTool home page</a>.
-<br><span class=lt>(The file you download will have a name like "<code>exiftool-#.##.zip</code>".)</span></li>
+<br><span class=lt>(The file you download will have a name like "<code>exiftool-##.##.zip</code>".)</span></li>
 <li><b>Extract "<code>exiftool(-k).exe</code>"</b> from the
 "<code>.zip</code>" file, and place it <b>on your Desktop</b>.
-<br><span class=lt>(Double-click on "<code>exiftool-#.##.zip</code>" to open
+<br><span class=lt>(Double-click on "<code>exiftool-##.##.zip</code>" to open
 the archive, then drag "<code>exiftool(-k).exe</code>" to your Desktop.)</span></li>
 </ol>
 <p>You can now double-click on "<code>exiftool(-k).exe</code>" to read the
@@ -100,7 +100,7 @@ can be downloaded from
 <a href="http://www.activestate.com/activeperl/">activeperl.com</a>.)</p>
 <ol>
 <li><b>Download</b> the <b>Image-ExifTool distribution</b> from the <a href="index.html">ExifTool home page</a>
-<br><span class=lt>(The file you download will have a name like "<code>Image-ExifTool-#.##.tar.gz</code>".)</span></li>
+<br><span class=lt>(The file you download will have a name like "<code>Image-ExifTool-##.##.tar.gz</code>".)</span></li>
 <li><b>Extract the ExifTool files</b> from the archive.
 <br><span class=lt>(The archive is a gzipped tar file, and can be opened with
 various Windows utilities, including WinZip.)</span></li>
@@ -142,7 +142,7 @@ in the OS X package.  Both versions run natively on PPC and Intel Macs.</p>
 <h3>OS X Package</h3>
 <ol>
 <li><b>Download</b> the <b>ExifTool OS X Package</b> from the <a href="index.html">ExifTool home page</a>.
-<br><span class=lt>(The file you download will have a name like "<code>ExifTool-#.##.dmg</code>".)</span></li>
+<br><span class=lt>(The file you download will have a name like "<code>ExifTool-##.##.dmg</code>".)</span></li>
 <li><b>Install</b> as a normal <b>OS X package</b>.
 <br><span class=lt>(Open the disk image, double-click on the install package, and follow the instructions.)
 </span></li>
@@ -153,15 +153,15 @@ in the OS X package.  Both versions run natively on PPC and Intel Macs.</p>
 <ol>
 <li><b>Download</b> the <b>Image-ExifTool distribution</b> from the <a href="index.html">ExifTool home page</a>
 to your Desktop.
-<br><span class=lt>(The file you download will have a name like "<code>Image-ExifTool-#.##.tar.gz</code>".)</span></li>
+<br><span class=lt>(The file you download will have a name like "<code>Image-ExifTool-##.##.tar.gz</code>".)</span></li>
 <li><b>Launch</b> the <b>Terminal</b> application from the Utilities folder in your Applications folder.</li>
 <li>In the Terminal window, <b>type the following</b>:
 <pre class='code'>    cd ~/Desktop
-    tar -xzf Image-ExifTool-#.##.tar.gz
-    cd Image-ExifTool-#.##
+    tar -xzf Image-ExifTool-##.##.tar.gz
+    cd Image-ExifTool-##.##
     sudo cp -r exiftool lib /usr/local/bin
 </pre>
-where "<code>#.##</code>" is the version number of the ExifTool you downloaded.
+where "<code>##.##</code>" is the version number of the ExifTool you downloaded.
 <br><span class=lt>(Note: The last step above will require you to enter your
 password.)</span></li>
 </ol>
@@ -175,7 +175,7 @@ your Perl version. If both sets of libraries exist, /usr/local/bin/lib takes
 precedence for exiftool, but /Library/Perl/#.#.# is the default for any other
 Perl scripts.</li>
 <li>In OS X 10.8 or later, you may see this message when you try to open the install package:
-<blockquote class=red>"ExifTool-#.##.pkg" can't be opened because it is from an
+<blockquote class=red>"ExifTool-##.##.pkg" can't be opened because it is from an
 unidentified developer.</blockquote> The solution is to set "Allow applications downloaded
 from" to "Anywhere" in the General "Security &amp; Privacy" System Preferences.
 (<a href="http://news.softpedia.com/news/Fix-OS-X-Error-Application-Can-t-Be-Opened-Because-it-Is-from-an-Unidentified-Developer-407375.shtml">Read
@@ -199,13 +199,13 @@ have the wrong "<code>lib</code>" folder.</li>
 
 <ol>
 <li><b>Download</b> the <b>Image-ExifTool distribution</b> from the <a href="index.html">ExifTool home page</a>
-<br><span class=lt>(The file you download will have a name like "<code>Image-ExifTool-#.##.tar.gz</code>".)</span></li>
+<br><span class=lt>(The file you download will have a name like "<code>Image-ExifTool-##.##.tar.gz</code>".)</span></li>
 <li><b>Unpack the distribution</b> and <b>make it your current directory</b> by typing:
 <pre class='code'>    cd <i>&lt;your download directory&gt;</i>
-    gzip -dc Image-ExifTool-#.##.tar.gz | tar -xf -
-    cd Image-ExifTool-#.##
+    gzip -dc Image-ExifTool-##.##.tar.gz | tar -xf -
+    cd Image-ExifTool-##.##
 </pre>
-where "<code>#.##</code>" is the version number of the ExifTool you downloaded.
+where "<code>##.##</code>" is the version number of the ExifTool you downloaded.
 <br><span class=lt>(At this point you may run exiftool by typing
 "<code>exiftool <i>&lt;image file name&gt;</i></code>".)</span></li>
 <li><b>Test and install ExifTool</b> by typing:

data/bin/{Image-ExifTool-9.99 → Image-ExifTool-10.01}/html/metafiles.html

@@ -206,11 +206,21 @@ XML files as it can with other metadata files.  Below are example commands
 demonstrating the use of exiftool XML files.</p>
 
 <p>Create an exiftool XML sidecar file:</p>
-<pre>exiftool a.jpg -X > a.xml</pre>
+<pre>exiftool -X a.jpg > a.xml</pre>
 
 <p>Restore original meta information from exiftool XML file:</p>
 <pre>exiftool -tagsfromfile a.xml -all:all a.jpg</pre>
 
+<p>The <code>-X</code> option also supports extracting binary data when
+<code>-b</code> is added.  For example, the above command may be modified to
+also store the binary MakerNotes block like this:</p>
+<pre>exiftool -X -b -makernotes -all a.jpg > a.xml</pre>
+<p>Note that we needed to add <code>-makernotes</code> because it isn't
+extracted as a block unless requested, and since we specified a tag to extract
+we also needed to add <code>-all</code> to continue extracting other tags as
+well.  Restoring the original metadata from this file is the same as in the
+previous example.</p>
+
 <h4>Via the API</h4>
 
 <p>There is no way to automatically produce a sidecar exiftool XML file via the
@@ -306,7 +316,7 @@ read, write and create support for this format.</p>
 
 <hr>
 <i>Created Nov 12, 2008</i><br>
-<i>Last revised Feb 22, 2014</i>
+<i>Last revised Jul 27, 2015</i>
 <p class='lf'><a href="index.html">&lt;-- Back to ExifTool home page</a></p>
 </body>
 </html>