exiftool_vendored 9.53.0 → 9.58.0

data/bin/{Image-ExifTool-9.53 → Image-ExifTool-9.58}/html/install.html

@@ -71,13 +71,19 @@ extensions are hidden on your system)</span></li>
 <p>You can now run exiftool by typing "<code>exiftool</code>" at the command
 prompt.  (To get to the command prompt, select "Run..." from the Windows "Start"
 menu, then type "<code>cmd</code>" and press Return.)</p>
-<p class=lt>(Note: Occasionally users have reported that exiftool gives
-errors when running this version for this first time.  It is possible this may
-happen if a file gets corrupted during the download/installation process.  In
-this case, follow the Uninstalling instructions below then re-install exiftool. 
-Be sure that you have sufficient disk space in your TEMP directory for exiftool
-to unpack about 12 MB of temporary files -- these are the Perl libraries used
-by the exiftool application which are unpacked the first time exiftool is run.)</p>
+<p><b>Notes:</b>
+<ol type='a'>
+<li>In Windows 7, running exiftool requires administrator privileges.  If
+necessary, this may be enabled by right clicking on exiftool, then selecting
+<b>"Run this program as administrator"</b> from the Compatibility settings.</li>
+<li>Occasionally users have reported that exiftool gives errors when running
+this version for this first time.  It is possible this may happen if a file gets
+corrupted during the download/installation process.  In this case, follow the
+Uninstalling instructions below then re-install exiftool. Be sure that you have
+sufficient disk space in your TEMP directory for exiftool to unpack about 12 MB
+of temporary files -- these are the Perl libraries used by the exiftool
+application which are unpacked the first time exiftool is run.</li>
+</ol></p>
 <p><b>Uninstalling:</b></p>
 <ol type='i'>
 <li>Drag "<code>exiftool(-k).exe</code>" (or "<code>C:\WINDOWS\exiftool.exe</code>")

data/bin/{Image-ExifTool-9.53 → Image-ExifTool-9.58}/html/metafiles.html

@@ -23,6 +23,7 @@ p.c         { margin: 1em 2em 1em 2.2em; color: #666 }
 <br><a href="#xml">ExifTool XML Files</a>
 <br><a href="#exif">EXIF Files</a>
 <br><a href="#mie">MIE Files</a>
+<br><a href="#exv">EXV Files</a>
 </div>
 
 <h1 class=up>Metadata Sidecar Files</h1>
@@ -31,8 +32,8 @@ p.c         { margin: 1em 2em 1em 2.2em; color: #666 }
 file. These are the only files that exiftool can create from scratch.  A common
 example of this is the XMP "sidecar" file (which is discussed in the next
 section in some detail).  Other supported metadata file types are EXIF, MIE,
-ICC and VRD.  As well, ExifTool supports XML-format output, which can also be
-used to generate metadata sidecar files.</p>
+EXV, ICC and VRD.  As well, ExifTool supports XML-format output, which can also
+be used to generate metadata sidecar files.</p>
 
 <hr>
 <a name="xmp"></a>
@@ -294,9 +295,18 @@ individually with a command more like this</p>
 the <code>-z</code> option (provided Compress::Zlib is installed on your system),
 which may be useful if disk space is at a premium.</p>
 
+<hr>
+<a name="exv"></a>
+<h3>EXV Files</h3>
+
+<p>EXV files are used by <a href="http://exiv2.org/">Exiv2</a>, and are
+basically a JPEG file without the image data, so they may be used as a metadata
+file to contain any information supported by the JPEG format.  ExifTool has full
+read, write and create support for this format.</p>
+
 <hr>
 <i>Created Nov 12, 2008</i><br>
-<i>Last revised Jan 29, 2014</i>
+<i>Last revised Feb 22, 2014</i>
 <p class='lf'><a href="index.html">&lt;-- Back to ExifTool home page</a></p>
 </body>
 </html>

data/bin/{Image-ExifTool-9.53 → Image-ExifTool-9.58}/html/under.html

@@ -120,7 +120,8 @@ which have helped to influence the overall development:</p>
 </ol>
 
 <hr>
-<i>Last revised Dec 24, 2013</i>
+<i>Created Jun. 24, 2009</i><br>
+<i>Last revised Dec. 24, 2013</i>
 <p class='lf'><a href="index.html">&lt;-- Back to ExifTool home page</a></p>
 </body>
 </html>

data/bin/{Image-ExifTool-9.53 → Image-ExifTool-9.58}/lib/Image/ExifTool.pm

@@ -27,7 +27,7 @@ use vars qw($VERSION $RELEASE @ISA @EXPORT_OK %EXPORT_TAGS $AUTOLOAD @fileTypes
             %mimeType $swapBytes $swapWords $currentByteOrder %unpackStd
             %jpegMarker %specialTags);
 
-$VERSION = '9.53';
+$VERSION = '9.58';
 $RELEASE = '';
 @ISA = qw(Exporter);
 %EXPORT_TAGS = (
@@ -67,7 +67,7 @@ sub SaveNewValues($);
 sub RestoreNewValues($);
 sub WriteInfo($$;$$);
 sub SetFileModifyDate($$;$$);
-sub SetFileName($$;$);
+sub SetFileName($$;$$);
 sub GetAllTags(;$);
 sub GetWritableTags(;$);
 sub GetAllGroups($);
@@ -130,7 +130,7 @@ sub ReadValue($$$$$;$);
     QuickTime QuickTime::ImageFile Matroska MXF DV Flash Flash::FLV Real::Media
     Real::Audio Real::Metafile RIFF AIFF ASF DICOM MIE HTML XMP::SVG Torrent EXE
     EXE::PEVersion EXE::PEString EXE::MachO EXE::PEF EXE::ELF EXE::CHM LNK Font
-    RSRC Rawzor ZIP ZIP::GZIP ZIP::RAR RTF OOXML iWork FLIR::FPF
+    RSRC Rawzor ZIP ZIP::GZIP ZIP::RAR RTF OOXML iWork FLIR::AFF FLIR::FPF
 );
 
 # alphabetical list of current Lang modules
@@ -288,8 +288,8 @@ my %fileTypeLookup = (
     JPC  =>  'J2C',
     JPF  =>  'JP2',
     # JP4? - looks like a JPEG but the image data is different
-    JPEG =>  'JPG',
-    JPG  => ['JPEG', 'Joint Photographic Experts Group'],
+    JPEG => ['JPEG', 'Joint Photographic Experts Group'],
+    JPG =>   'JPEG',
     JPM  => ['JP2',  'JPEG 2000 compound image'],
     JPX  => ['JP2',  'JPEG 2000 with extensions'],
     JXR  => ['TIFF', 'JPEG XR'],
@@ -325,7 +325,7 @@ my %fileTypeLookup = (
     MPO  => ['JPEG', 'Extended Multi-Picture format'],
     MQV  => ['MOV',  'Sony Mobile Quicktime Video'],
     MRW  => ['MRW',  'Minolta RAW format'],
-    MTS  => ['M2TS', 'MPEG-2 Transport Stream'],
+    MTS  =>  'M2TS',
     MXF  => ['MXF',  'Material Exchange Format'],
   # NDPI => ['TIFF', 'Hamamatsu NanoZoomer Digital Pathology Image'],
     NEF  => ['TIFF', 'Nikon (RAW) Electronic Format'],
@@ -389,7 +389,7 @@ my %fileTypeLookup = (
     PSPSHAPE => 'PSP',
     PSPTUBE  => 'PSP',
     QIF  =>  'QTIF',
-    QT   => ['MOV',  'QuickTime movie'],
+    QT   =>  'MOV',
     QTI  =>  'QTIF',
     QTIF => ['QTIF', 'QuickTime Image File'],
     RA   => ['Real', 'Real Audio'],
@@ -408,6 +408,7 @@ my %fileTypeLookup = (
     RW2  => ['TIFF', 'Panasonic RAW 2'],
     RWL  => ['TIFF', 'Leica RAW'],
     RWZ  => ['RWZ',  'Rawzor compressed image'],
+    SEQ  => ['FLIR', 'FLIR image Sequence'],
     SO   => ['EXE',  'Shared Object file'],
     SR2  => ['TIFF', 'Sony RAW Format 2'],
     SRF  => ['TIFF', 'Sony RAW Format'],
@@ -527,7 +528,6 @@ my %fileDescription = (
     LNK  => 'application/octet-stream',
     M2T  => 'video/mpeg',
     M2TS => 'video/m2ts',
-    M4P  => 'audio/m4p',
     MEF  => 'image/x-mamiya-mef',
     MIE  => 'application/x-mie',
     MIFF => 'application/x-magick-image',
@@ -707,7 +707,7 @@ my %moduleName = (
     EXR  => '\x76\x2f\x31\x01',
     EXV  => '\xff\x01Exiv2',
     FLAC => '(fLaC|ID3)',
-    FLIR => 'FFF\0',
+    FLIR => '[AF]FF\0',
     FLV  => 'FLV\x01',
     Font => '((\0\x01\0\0|OTTO|true|typ1)[\0\x01]|ttcf\0[\x01\x02]\0\0|\0[\x01\x02]|' .
             '(.{6})?%!(PS-(AdobeFont-|Bitstream )|FontType1-)|Start(Comp|Master)?FontMetrics)',
@@ -716,7 +716,7 @@ my %moduleName = (
     GIF  => 'GIF8[79]a',
     GZIP => '\x1f\x8b\x08',
     HDR  => '#\?(RADIANCE|RGBE)\x0a',
-    HTML => '\s*(?i)<(!DOCTYPE\s+HTML|HTML|\?xml)', # (case insensitive)
+    HTML => '(\xef\xbb\xbf)?\s*(?i)<(!DOCTYPE\s+HTML|HTML|\?xml)', # (case insensitive)
     ICC  => '.{12}(scnr|mntr|prtr|link|spac|abst|nmcl|nkpf)(XYZ |Lab |Luv |YCbr|Yxy |RGB |GRAY|HSV |HLS |CMYK|CMY |[2-9A-F]CLR){2}',
     IND  => '\x06\x06\xed\xf5\xd8\x1d\x46\xe5\xbd\x31\xef\xe7\xfe\x74\xb7\x1d',
     ITC  => '.{4}itch',
@@ -1021,6 +1021,20 @@ sub DummyWriteProc { return 1; }
             return $str;
         },
     },
+    HardLink => {
+        Writable => 1,
+        WriteOnly => 1,
+        Protected => 1,
+        Notes => q{
+            this write-only tag is used to create a hard link to the file.  If the file
+            is edited, copied, renamed or moved in the same operation as writing
+            HardLink, then the link is made to the updated file.  Note that subsequent
+            editing of either the linked file or the original by the exiftool
+            application will break the link unless the -overwrite_original_in_place
+            option is used
+        },
+        ValueConvInv => '$val=~tr/\\\\/\//; $val',
+    },
     MIMEType    => { Notes => 'the MIME type of the source file' },
     ImageWidth  => { },
     ImageHeight => { },
@@ -3352,7 +3366,7 @@ sub DoAutoLoad(@)
         $file .= 'r.pl';
     }
     # attempt to load the package
-    eval "require '$file'" or die "Error while attempting to call $autoload\n$@\n";
+    eval { require $file } or die "Error while attempting to call $autoload\n$@\n";
     unless (defined &$autoload) {
         my @caller = caller(0);
         # reproduce Perl's standard 'undefined subroutine' message:
@@ -5187,8 +5201,9 @@ sub ProcessJPEG($$)
                 # extract the MPF information (it is in standard TIFF format)
                 my $tagTablePtr = GetTagTable('Image::ExifTool::MPF::Main');
                 $self->ProcessTIFF(\%dirInfo, $tagTablePtr);
-            } elsif ($$segDataPt =~ /^(|QVGA\0|BGTH)\xff\xd8\xff\xdb/) {
-                # Samsung="", BenQ DC C1220="QVGA\0", Digilife DDC-690="BGTH"
+            } elsif ($$segDataPt =~ /^(|QVGA\0|BGTH)\xff\xd8\xff[\xdb\xe0\xe1]/) {
+                # Samsung/GE/GoPro="", BenQ DC C1220/Pentacon/Polaroid="QVGA\0",
+                # Digilife DDC-690/Rollei="BGTH"
                 $dumpType = 'Preview Image';
                 $preview = substr($$segDataPt, length($1));
             } elsif ($preview) {
@@ -5266,6 +5281,8 @@ sub ProcessJPEG($$)
             }
         } elsif ($marker == 0xe5) {         # APP5 (Ricoh "RMETA")
             if ($$segDataPt =~ /^RMETA\0/) {
+                # (NOTE: apparently these may span multiple segments, but I haven't seen
+                # a sample like this, so multi-segment support hasn't yet been implemented)
                 $dumpType = 'Ricoh RMETA';
                 DirStart(\%dirInfo, 6, 6);
                 my $tagTablePtr = GetTagTable('Image::ExifTool::Ricoh::RMETA');
@@ -6205,7 +6222,7 @@ sub AddTagToTable($$;$$)
 #------------------------------------------------------------------------------
 # Handle simple extraction of new tag information
 # Inputs: 0) ExifTool object ref, 1) tag table reference, 2) tagID, 3) value,
-#         4-N) parameters hash: Index, DataPt, DataPos, Start, Size, Parent,
+#         4-N) parameters hash: Index, DataPt, DataPos, Base, Start, Size, Parent,
 #              TagInfo, ProcessProc, RAF
 # Returns: tag key or undef if tag not found
 # Notes: if value is not defined, it is extracted from DataPt using TagInfo
@@ -6214,7 +6231,7 @@ sub HandleTag($$$$;%)
 {
     my ($self, $tagTablePtr, $tag, $val, %parms) = @_;
     my $verbose = $$self{OPTIONS}{Verbose};
-    my $tagInfo = $parms{TagInfo} || $self->GetTagInfo($tagTablePtr, $tag, \$val);
+    my $tagInfo = $parms{TagInfo} || $self->GetTagInfo($tagTablePtr, $tag, \$val, $parms{Format}, $parms{Count});
     my $dataPt = $parms{DataPt};
     my ($subdir, $format, $count, $size, $noTagInfo, $rational);
 
@@ -6515,7 +6532,16 @@ sub SetFileType($;$$)
     my ($self, $fileType, $mimeType) = @_;
     unless ($$self{VALUE}{FileType} and not $$self{DOC_NUM}) {
         my $baseType = $$self{FILE_TYPE};
+        my $ext = $$self{FILE_EXT};
         $fileType or $fileType = $baseType;
+        # handle sub-types which are identified by extension
+        if (defined $ext and $ext ne $fileType and not $$self{DOC_NUM}) {
+            my ($f,$e) = @fileTypeLookup{$fileType,$ext};
+            if (ref $f eq 'ARRAY' and ref $e eq 'ARRAY' and $$f[0] eq $$e[0]) {
+                # make sure $fileType was a root type and not another sub-type
+                $fileType = $ext if $$f[0] eq $fileType or not $fileTypeLookup{$$f[0]};
+            }
+        }
         $mimeType or $mimeType = $mimeType{$fileType};
         # use base file type if necessary (except if 'TIFF', which is a special case)
         $mimeType = $mimeType{$baseType} unless $mimeType or $baseType eq 'TIFF';
@@ -6877,7 +6903,9 @@ sub ProcessBinaryData($$$)
                 DirLen   => $len - $start,
                 Base     => $subdirBase,
             );
+            delete $$self{NO_UNKNOWN};
             $self->ProcessDirectory(\%subdirInfo, $subTablePtr, $$subdir{ProcessProc});
+            $$self{NO_UNKNOWN} = 1 if $unknown < 2;
             next;
         }
         if ($$tagInfo{IsOffset} and $$tagInfo{IsOffset} ne '3') {
@@ -6922,7 +6950,7 @@ until ($Image::ExifTool::noConfig) {
         length $file or last;   # filename of "" disables configuration
         -r $file or warn("Config file not found\n"), last;
     }
-    eval "require '$file'"; # load the config file
+    eval { require $file }; # load the config file
     # print warning (minus "Compilation failed" part)
     $@ and $_=$@, s/Compilation failed.*//s, warn $_;
     last;
@@ -6938,7 +6966,7 @@ if (%Image::ExifTool::UserDefined::FileTypes) {
     foreach (sort keys %Image::ExifTool::UserDefined::FileTypes) {
         my $fileInfo = $Image::ExifTool::UserDefined::FileTypes{$_};
         my $type = uc $_;
-        ref $fileInfo eq 'HASH' or $fileTypeLookup{$type} = $type, next;
+        ref $fileInfo eq 'HASH' or $fileTypeLookup{$type} = $fileInfo, next;
         if ($$fileInfo{BaseType}) {
             if ($$fileInfo{Description}) {
                 $fileTypeLookup{$type} = [ $$fileInfo{BaseType}, $$fileInfo{Description} ];

data/bin/{Image-ExifTool-9.53 → Image-ExifTool-9.58}/lib/Image/ExifTool.pod

@@ -56,46 +56,47 @@ Image::ExifTool - Read and write meta information
 Reads and writes meta information in a wide variety of files, including the
 maker notes 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.
+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):
 
   File Types
   ------------+-------------+-------------+-------------+------------
-  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/w   | KEY   r     | ORF   r/w   | RTF   r     |
-  DYLIB r     | LA    r     | OTF   r     | RW2   r/w   |
+  3FR   r     | EIP   r     | LA    r     | OTF   r     | RW2   r/w
+  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     | 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
   ----------------------+----------------------+---------------------
@@ -977,13 +978,16 @@ file type is required unless the type can be determined from the extension
 of the destination file name.
 
 If a destination file name is given, the specified file must not exist
-because an existing destination file will not be overwritten.  The
-destination file name may be undefined to overwrite the original file (make
-sure you have backups!).  In this case, if a source file name is provided, a
-temporary file is created and renamed to replace the source file if no
-errors occurred while writing.  Otherwise, if a source file reference or
-scalar reference is used, the image is first written to memory then copied
-back to replace the original if there were no errors.
+because an existing destination file will not be overwritten.  Any new
+values for FileName, Directory or HardLink are ignored when a destination
+file name is specified.
+
+The destination file name may be undefined to overwrite the original file
+(make sure you have backups!).  In this case, if a source file name is
+provided, a temporary file is created and renamed to replace the source file
+if no errors occurred while writing.  Otherwise, if a source file reference
+or scalar reference is used, the image is first written to memory then
+copied back to replace the original if there were no errors.
 
 On Mac OS systems, the file resource fork is preserved if this routine is
 called with a source file name.
@@ -1622,8 +1626,9 @@ systems only, and requires Win32API::File::Time to be installed.
 
 =head2 SetFileName
 
-Set the file name and directory.  If not specified, the new file name is
-derived from the new values of the FileName and Directory tags.  If the
+Set the file name and directory, or create a hard link.  If not specified,
+the new file name is derived from the new values of the FileName and
+Directory tags, or from the HardLink tag if creating a link.  If the
 FileName tag contains a '/', then the file is renamed into a new directory.
 If FileName ends with '/', then it is taken as a directory name and the file
 is moved into the new directory.  The new value for the Directory tag takes
@@ -1642,6 +1647,8 @@ precedence over any directory specified in FileName.
 
 2) [optional] New file name
 
+3) [optional] 'Link' to create a hard link instead of renaming the file
+
 =item Return Value:
 
 1 if the file name or directory was changed, 0 if nothing was done, or -1 if
@@ -2002,12 +2009,12 @@ Torrent, Vorbis, XML, XMP, ZIP
 
 =item Family 1 (Specific Location):
 
-AC3, AFCP, AIFF, APE, ASF, AVI1, Adobe, AdobeCM, AdobeDNG, CIFF, Canon,
-CanonCustom, CanonRaw, CanonVRD, Casio, Chapter#, Composite, DICOM, DNG, DV,
-DjVu, DjVu-Meta, Ducky, EPPIM, EXE, EXIF, ExifIFD, ExifTool, FLAC, File,
-Flash, FlashPix, FLIR, Font, FotoStation, FujiFilm, FujiIFD, GE, GIF, GIMP,
-GPS, GeoTiff, GlobParamIFD, GraphConv, H264, HP, HTML, HTML-dc, HTML-ncc,
-HTML-office, HTML-prod, HTML-vw96, HTTP-equiv, ICC-chrm, ICC-clrt,
+AC3, AFCP, AIFF, APE, ASF, AVI1, Adobe, AdobeCM, AdobeDNG, Apple, CIFF,
+Canon, CanonCustom, CanonRaw, CanonVRD, Casio, Chapter#, Composite, DICOM,
+DNG, DV, DjVu, DjVu-Meta, Ducky, EPPIM, EXE, EXIF, ExifIFD, ExifTool, FLAC,
+FLIR, File, Flash, FlashPix, Font, FotoStation, FujiFilm, FujiIFD, GE, GIF,
+GIMP, GPS, GeoTiff, GlobParamIFD, GraphConv, H264, HP, HTC, HTML, HTML-dc,
+HTML-ncc, HTML-office, HTML-prod, HTML-vw96, HTTP-equiv, ICC-chrm, ICC-clrt,
 ICC-header, ICC-meas, ICC-meta, ICC-view, ICC_Profile, ICC_Profile#, ID3,
 ID3v1, ID3v1_Enh, ID3v2_2, ID3v2_3, ID3v2_4, IFD0, IFD1, IPTC, IPTC#, ITC,
 InteropIFD, JFIF, JPEG, JPEG-HDR, JVC, Jpeg2000, KDC_IFD, Kodak,
@@ -2018,7 +2025,7 @@ MIE-MakerNotes, MIE-Meta, MIE-Orient, MIE-Preview, MIE-Thumbnail, MIE-UTM,
 MIE-Unknown, MIE-Video, MIFF, MNG, MPC, MPEG, MPF0, MPImage, MXF,
 MakerNotes, MakerUnknown, Matroska, MediaJukebox, MetaIFD, Microsoft,
 Minolta, MinoltaRaw, NITF, Nikon, NikonCapture, NikonCustom, NikonScan,
-Ocad, Ogg, Olympus, OpenEXR, PDF, PICT, PLIST, PNG, PSP, Panasonic,
+Nintendo, Ocad, Ogg, Olympus, OpenEXR, PDF, PICT, PNG, PSP, Panasonic,
 PanasonicRaw, Pentax, PhaseOne, PhotoCD, PhotoMechanic, Photoshop,
 PictureInfo, PostScript, PreviewIFD, PrintIM, ProfileIFD, Qualcomm,
 QuickTime, RAF, RAF2, RIFF, RMETA, RSRC, RTF, Radiance, Rawzor, Real,
@@ -2028,12 +2035,13 @@ Sanyo, Scalado, Sigma, SigmaRaw, Sony, SonyIDC, Stim, SubIFD, System,
 Theora, Torrent, Track#, Version0, Vorbis, XML, XMP, XMP-DICOM, XMP-GPano,
 XMP-MP, XMP-MP1, XMP-PixelLive, XMP-aas, XMP-acdsee, XMP-album,
 XMP-apple-fi, XMP-aux, XMP-cc, XMP-cell, XMP-crs, XMP-dc, XMP-dex,
-XMP-digiKam, XMP-dwc, XMP-exif, XMP-expressionmedia, XMP-extensis, XMP-fpv,
-XMP-ics, XMP-iptcCore, XMP-iptcExt, XMP-lr, XMP-mediapro, XMP-microsoft,
-XMP-mwg-coll, XMP-mwg-kw, XMP-mwg-rs, XMP-pdf, XMP-pdfx, XMP-photomech,
-XMP-photoshop, XMP-plus, XMP-prism, XMP-prl, XMP-pur, XMP-rdf, XMP-swf,
-XMP-tiff, XMP-x, XMP-xmp, XMP-xmpBJ, XMP-xmpDM, XMP-xmpMM, XMP-xmpNote,
-XMP-xmpPLUS, XMP-xmpRights, XMP-xmpTPg, ZIP
+XMP-digiKam, XMP-dwc, XMP-exif, XMP-exifEX, XMP-expressionmedia,
+XMP-extensis, XMP-fpv, XMP-getty, XMP-ics, XMP-iptcCore, XMP-iptcExt,
+XMP-lr, XMP-mediapro, XMP-microsoft, XMP-mwg-coll, XMP-mwg-kw, XMP-mwg-rs,
+XMP-pdf, XMP-pdfx, XMP-photomech, XMP-photoshop, XMP-plus, XMP-prism,
+XMP-prl, XMP-pur, XMP-rdf, XMP-swf, XMP-tiff, XMP-x, XMP-xmp, XMP-xmpBJ,
+XMP-xmpDM, XMP-xmpMM, XMP-xmpNote, XMP-xmpPLUS, XMP-xmpRights, XMP-xmpTPg,
+ZIP
 
 =item Family 2 (Category):