exiftool_vendored 11.48.0 → 11.49.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: bbff100dce1adce67cc414b14938a57b47f72195
-  data.tar.gz: 922c1e9187441b8a108ac70af32ddc9be40f108e
+  metadata.gz: c69141b760c60a11aa7d4f8e3f05c79f392db21a
+  data.tar.gz: 12554c7e4ee7d9a5ad9fb81412fd0077040098db
 SHA512:
-  metadata.gz: 652f39d5eddb5ca51f6a4af12656b05d63ee37b5baf90036510a7a0b698b1519278a563a93a74d8bec8a2bd63cfe3e99bcf7061ab457cd5cc0e5c6350e3e7021
-  data.tar.gz: 502fd3fc930c56786257e1210ac74da874986a873b862918bd66984ab1d53e5d98999c0565af9ddad6a0eb77b9814b94a72f1a1afd369cfcad97b38a1bd1291b
+  metadata.gz: 9235968abcf4c684db6037684304e5e3607e47e43cf6afe24eab1bf16114880088015e0385998abe252938cac5023c3a5ef625ee95890c803a2ef7198a8c2b82
+  data.tar.gz: 9cf9cb7cada7d74bf887f41e95b97d8b64d7738ce1ac327d16f361550b15fab29a47fca45b4320b4536db95cdce542eb0bccd878f9fce6aa9825fe585a19b1e9

data/bin/Changes

@@ -7,6 +7,21 @@ RSS feed: http://owl.phy.queensu.ca/~phil/exiftool/rss.xml
 Note: The most recent production release is Version 11.30. (Other versions are
 considered development releases, and are not uploaded to CPAN.)
 
+June 5, 2019 - Version 11.49
+
+  - Added inverse print conversion for one of the QuickTime ItemList Genre tags
+  - Avoid creating a few obscure QuickTime UserData tags when writing
+  - Fixed problem where some QuickTime groups were not being created when
+    writing QuickTime tags without specifying a group
+  - Fixed problem where QuickTime Keys tags could be duplicated when writing an
+    existing alternate-language tag
+  - Fixed problem were QuickTime Keys alternate-language tags would not be
+    written when deleting the corresponding default-language tag in the same
+    command
+  - Fixed some inconsistencies when writing QuickTime tags using the -wm
+    (WriteMode) option
+  - Fixed an incorrect Pentax Sigma LensType value
+
 June 1, 2019 - Version 11.48
 
   - Added write support for Google GCamera and GCreation XMP tags
@@ -36,7 +51,7 @@ May 29, 2019 - Version 11.45
     image if the file had previously been edited by DPP then Exiftool
     (If you have edited any CR3 images with ExifTool that had been previously
     edited by DPP, then re-edit with ExifTool 11.45 or later to restructure the
-    file so DPP doesn't destroy it if used to edit the file later)
+    file so DPP doesn't destroy it if used later to edit the file again)
   - Added ability to create and delete QuickTime Keys tags
   - Added sample config file (mini0806.config) to generate GPS tags from
     subtitle Text in Mini 0806 dashcam videos

data/bin/MANIFEST

@@ -740,6 +740,8 @@ t/QuickTime_10.out
 t/QuickTime_11.out
 t/QuickTime_12.out
 t/QuickTime_13.out
+t/QuickTime_14.out
+t/QuickTime_15.out
 t/QuickTime_2.out
 t/QuickTime_3.out
 t/QuickTime_4.out

data/bin/META.json

@@ -47,5 +47,5 @@
       }
    },
    "release_status" : "stable",
-   "version" : "11.48"
+   "version" : "11.49"
 }

data/bin/META.yml

@@ -28,4 +28,4 @@ recommends:
   Time::HiRes: 0
 requires:
   perl: 5.004
-version: 11.48
+version: 11.49

data/bin/README

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

data/bin/exiftool

@@ -12,7 +12,7 @@
 use strict;
 require 5.004;
 
-my $version = '11.48';
+my $version = '11.49';
 
 # add our 'lib' directory to the include list BEFORE 'use Image::ExifTool'
 my $exeDir;
@@ -5119,7 +5119,7 @@ with this command:
 
 produces output like this:
 
-    -- Generated by ExifTool 11.48 --
+    -- Generated by ExifTool 11.49 --
     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

data/bin/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 %fileTypeLookup);
 
-$VERSION = '11.48';
+$VERSION = '11.49';
 $RELEASE = '';
 @ISA = qw(Exporter);
 %EXPORT_TAGS = (

data/bin/lib/Image/ExifTool.pod

@@ -979,7 +979,9 @@ list below.  Default is 'wcg'.
 
 The level of the group differs for different types of metadata. For XMP or
 IPTC this is the full XMP/IPTC block (the family 0 group), but for EXIF this
-is the individual IFD (the family 1 group).
+is the individual IFD (the family 1 group).  The 'w' and 'c' modes are
+tested only when L</SetNewValue> is called, but the 'g' mode is also tested
+in L</WriteInfo>.
 
 =item XAttrTags
 
@@ -1175,8 +1177,8 @@ called with a source file name.
 The following ExifTool options are effective in the call to L</WriteInfo>:
 
 ByteOrder, Charset, CharsetEXIF, CharsetFileName, CharsetIPTC, Compact,
-Compress, FixBase, IgnoreMinorErrors, Password, PNGEarlyXMP, Verbose and
-XMPShorthand.
+Compress, FixBase, IgnoreMinorErrors, Password, PNGEarlyXMP,
+QuickTimeHandler, Verbose, WriteMode and XMPShorthand.
 
 =head2 GetTagList
 

data/bin/lib/Image/ExifTool/BuildTagLookup.pm

@@ -34,7 +34,7 @@ use Image::ExifTool::Nikon;
 use Image::ExifTool::Validate;
 use Image::ExifTool::MacOS;
 
-$VERSION = '3.22';
+$VERSION = '3.23';
 @ISA = qw(Exporter);
 
 sub NumbersFirst($$);
@@ -193,11 +193,11 @@ of values written, or the number of characters in a fixed-length string
 A plus sign (C<+>) after an entry in the B<Writable> column indicates a
 I<List> tag which supports multiple values and allows individual values to
 be added and deleted.  A slash (C</>) indicates a tag that ExifTool will
-I<Avoid> when writing.  These tags are not created when writing if another
-same-named tag may be created instead.  To write these tags, the group
+I<Avoid> when writing.  These will be edited but not created if another
+same-named tag may be created instead.  To create these tags, the group
 should be specified.  A tilde (C<~>) indicates a tag this is writable only
 when the print conversion is disabled (by setting PrintConv to 0, using the
--n option, or suffixing the tag name with a C<#> character).  An exclamation
+-n option, or suffixing the tag name with a C<#> character). An exclamation
 point (C<!>) indicates a tag that is considered I<Unsafe> to write under
 normal circumstances.  These tags are not written unless specified
 explicitly (ie. not when wildcards or "all" are used), and care should be
@@ -404,6 +404,50 @@ number added for non-standard IPTC ("IPTC2", "IPTC3", etc), but when writing
 only "IPTC" may be specified as the group.  To keep the IPTC consistent,
 ExifTool updates tags in all existing IPTC locations, but will create a new
 IPTC group only in the standard location.
+},
+    QuickTime => q{
+The QuickTime format is used for many different types of audio, video and
+image files (most notably, MOV/MP4 videos and HEIC/CR3 images).  Exiftool
+extracts standard meta information and a variety of audio, video and image
+parameters, as well as proprietary information written by many camera
+models.  Tags with a question mark after their name are not extracted unless
+the Unknown option is set.
+
+When writing, ExifTool creates both QuickTime and XMP tags by default, but
+the group may be specified to write one or the other separately.  If no
+location is specified, newly created QuickTime tags are added in the
+L<ItemList|Image::ExifTool::TagNames/QuickTime ItemList Tags> location if
+possible, otherwise in
+L<UserData|Image::ExifTool::TagNames/QuickTime UserData Tags>, and
+finally in L<Keys|Image::ExifTool::TagNames/QuickTime Keys Tags>,
+but this order may be changed by setting the PREFERRED level of the
+appropriate table in the config file (see
+L<example.config|../config.html#PREF> in the full distribution for
+an example).  ExifTool currently writes only top-level metadata in
+QuickTime-based files; it extracts other track-specific and timed
+metadata, but can not yet edit tags in these locations (with the
+exception of track-level date/time tags).
+
+Alternate language tags may be accessed for ItemList and Keys tags by adding
+a 3-character ISO 639-2 language code and an optional ISO 3166-1 alpha 2
+country code to the tag name (eg. "ItemList:Artist-deu" or
+"ItemList::Artist-deu-DE").  Most UserData tags support a language code, but
+without a country code.  If no language code is specified when writing,
+alternate languages for the tag are deleted.  Use the "und" language code to
+write the default language without deleting alternate languages.  Note that
+"eng" is treated as a default language when reading, but not when writing.
+
+According to the specification, many QuickTime date/time tags should be
+stored as UTC.  Unfortunately, digital cameras often store local time values
+instead (presumably because they don't know the time zone).  For this
+reason, by default ExifTool does not assume a time zone for these values.
+However, if the QuickTimeUTC API option is set, then ExifTool will assume
+these values are properly stored as UTC, and will convert them to local time
+when extracting.
+
+See
+L<https://developer.apple.com/library/archive/documentation/QuickTime/QTFF/>
+for the official specification.
 },
     Photoshop => q{
 Photoshop tags are found in PSD and PSB files, as well as inside embedded

data/bin/lib/Image/ExifTool/ID3.pm

@@ -16,7 +16,7 @@ use strict;
 use vars qw($VERSION);
 use Image::ExifTool qw(:DataAccess :Utils);
 
-$VERSION = '1.52';
+$VERSION = '1.53';
 
 sub ProcessID3v2($$$);
 sub ProcessPrivate($$$);
@@ -969,6 +969,15 @@ sub PrintGenre($)
     return $val;
 }
 
+#------------------------------------------------------------------------------
+# Get Genre ID
+# Inputs: 0) Genre name
+# Returns: genre ID number, or undef
+sub GetGenreID($)
+{
+    return Image::ExifTool::ReverseLookup(shift, \%genre);
+}
+
 #------------------------------------------------------------------------------
 # Decode ID3 string
 # Inputs: 0) ExifTool object reference

data/bin/lib/Image/ExifTool/MWG.pm

@@ -116,7 +116,7 @@ my $mwgLoaded;  # flag set if we alreaded Load()ed the MWG tags
     DateTimeOriginal => {
         Description => 'Date/Time Original',
         Groups => { 2 => 'Time' },
-        Notes => '"creation date of the intellectual content being shown" - MWG',
+        Notes => '"specifies when a photo was taken" - MWG',
         Writable => 1,
         Shift => 0, # don't shift this tag
         Desire => {
@@ -158,7 +158,7 @@ my $mwgLoaded;  # flag set if we alreaded Load()ed the MWG tags
     },
     CreateDate => {
         Groups => { 2 => 'Time' },
-        Notes => '"creation date of the digital representation" - MWG',
+        Notes => '"specifies when an image was digitized" - MWG',
         Writable => 1,
         Shift => 0, # don't shift this tag
         Desire => {
@@ -196,7 +196,7 @@ my $mwgLoaded;  # flag set if we alreaded Load()ed the MWG tags
     },
     ModifyDate => {
         Groups => { 2 => 'Time' },
-        Notes => '"modification date of the digital image file" - MWG',
+        Notes => '"specifies when a file was modified by the user" - MWG',
         Writable => 1,
         Shift => 0, # don't shift this tag
         Desire => {

data/bin/lib/Image/ExifTool/Pentax.pm

@@ -58,7 +58,7 @@ use Image::ExifTool::Exif;
 use Image::ExifTool::GPS;
 use Image::ExifTool::HP;
 
-$VERSION = '3.27';
+$VERSION = '3.28';
 
 sub CryptShutterCount($$);
 sub PrintFilter($$$);
@@ -304,7 +304,7 @@ sub DecodeAFPoints($$$$;$);
     '7 243' => 'smc PENTAX-DA 70mm F2.4 Limited', #PH
     '7 244' => 'smc PENTAX-DA 21mm F3.2 AL Limited', #16
     '8 0' => 'Sigma 50-150mm F2.8 II APO EX DC HSM', #forum2997
-    '8 3' => 'Sigma AF 18-125mm F3.5-5.6 DC', #29 (and F3.8-5.6, ref forum10167)
+    '8 3' => 'Sigma 18-125mm F3.8-5.6 DC HSM', #forum10167
     '8 4' => 'Sigma 50mm F1.4 EX DG HSM', #Artur private communication
     '8 7' => 'Sigma 24-70mm F2.8 IF EX DG HSM', #Exiv2
     '8 8' => 'Sigma 18-250mm F3.5-6.3 DC OS HSM', #27

data/bin/lib/Image/ExifTool/QuickTime.pm

@@ -42,7 +42,7 @@ use Image::ExifTool qw(:DataAccess :Utils);
 use Image::ExifTool::Exif;
 use Image::ExifTool::GPS;
 
-$VERSION = '2.31';
+$VERSION = '2.32';
 
 sub ProcessMOV($$;$);
 sub ProcessKeys($$$);
@@ -241,7 +241,6 @@ my %unknownInfo = (
 my %langText = (
     Notes => 'used in 3gp videos',
     IText => 6,
-    Preferred => 0,
     Avoid => 1,
 );
 
@@ -418,45 +417,6 @@ my %eeBox = (
     PROCESS_PROC => \&ProcessMOV,
     WRITE_PROC => \&WriteQuickTime, # (only needs to be defined for directories to process when writing)
     GROUPS => { 2 => 'Video' },
-    NOTES => q{
-        The QuickTime format is used for many different types of audio, video and
-        image files (most notably, MOV/MP4 videos and HEIC/CR3 images).  Exiftool
-        extracts standard meta information and a variety of audio, video and image
-        parameters, as well as proprietary information written by many camera
-        models.  Tags with a question mark after their name are not extracted unless
-        the Unknown option is set.
-
-        When writing, ExifTool creates both QuickTime and XMP tags by default, but
-        the group may be specified to write one or the other separately.  If no
-        location is specified, newly created QuickTime tags are added in the
-        ItemList location if possible, otherwise in UserData, and finally in Keys,
-        but this order may be changed by setting the PREFERRED level of the
-        appropriate table in the config file (see L<example.config|../config.html#PREF> in the full
-        distribution for an example).  ExifTool currently writes only top-level
-        metadata in QuickTime-based files; it extracts other track-specific and
-        timed metadata, but can not yet edit tags in these locations.
-
-        Alternate language tags may be accessed for ItemList and Keys tags by adding
-        a 3-character ISO 639-2 language code and an optional ISO 3166-1 alpha 2
-        country code to the tag name (eg. "ItemList:Artist-deu" or
-        "ItemList::Artist-deu-DE").  UserData tags support only a language code
-        (without a country code).  If no language code is specified when writing,
-        alternate languages for the tag are deleted.  Use the "und" language code to
-        write the default language without deleting alternate languages.  Note that
-        "eng" is treated as a default language when reading, but not when writing.
-
-        According to the specification, many QuickTime date/time tags should be
-        stored as UTC.  Unfortunately, digital cameras often store local time values
-        instead (presumably because they don't know the time zone).  For this
-        reason, by default ExifTool does not assume a time zone for these values.
-        However, if the QuickTimeUTC API option is set, then ExifTool will assume
-        these values are properly stored as UTC, and will convert them to local time
-        when extracting.
-
-        See
-        L<https://developer.apple.com/library/archive/documentation/QuickTime/QTFF/>
-        for the official specification.
-    },
     meta => { # 'meta' is found here in my Sony ILCE-7S MP4 sample - PH
         Name => 'Meta',
         SubDirectory => {
@@ -1367,6 +1327,12 @@ my %eeBox = (
         text.  Alternate language tags are accessed by adding a dash followed by a
         3-character ISO 639-2 language code to the tag name.  ExifTool will extract
         any multi-language user data tags found, even if they aren't in this table.
+        Note when creating new tags,
+        L<ItemList Tags|Image::ExifTool::TagNames/QuickTime ItemList Tags> are
+        preferred over these, so to create the tag when a same-named ItemList tag
+        exists, either "UserData" must be specified (eg. C<-UserData:Artist=Monet>
+        on the command line), or the PREFERRED level must be changed via the config
+        file.
     },
     "\xa9cpy" => { Name => 'Copyright',  Groups => { 2 => 'Author' } },
     "\xa9day" => {
@@ -1433,7 +1399,7 @@ my %eeBox = (
     "\xa9swr" => 'SoftwareVersion', #12
     "\xa9too" => 'Encoder', #PH (NC)
     "\xa9trk" => 'Track', #PH (NC)
-    "\xa9wrt" => { Name => 'Composer', Preferred => 0, Avoid => 1 }, # ("\xa9com" is preferred in UserData)
+    "\xa9wrt" => { Name => 'Composer', Avoid => 1 }, # ("\xa9com" is preferred in UserData)
     "\xa9xyz" => { #PH (iPhone 3GS)
         Name => 'GPSCoordinates',
         Groups => { 2 => 'Location' },
@@ -1457,7 +1423,12 @@ my %eeBox = (
     "\xa9dji" => { Name => 'UserData_dji', Format => 'undef', Binary => 1, Unknown => 1, Hidden => 1 },
     "\xa9res" => { Name => 'UserData_res', Format => 'undef', Binary => 1, Unknown => 1, Hidden => 1 },
     "\xa9uid" => { Name => 'UserData_uid', Format => 'undef', Binary => 1, Unknown => 1, Hidden => 1 },
-    "\xa9mdl" => { Name => 'Model',        Format => 'string', Preferred => 0, Notes => 'non-standard-format DJI tag' },
+    "\xa9mdl" => {
+        Name => 'Model',
+        Notes => 'non-standard-format DJI tag',
+        Format => 'string',
+        Avoid => 1,
+    },
     # end DJI tags
     name => 'Name',
     WLOC => {
@@ -1508,13 +1479,14 @@ my %eeBox = (
     # the following are 3gp tags, references:
     # http://atomicparsley.sourceforge.net
     # http://www.3gpp.org/ftp/tsg_sa/WG4_CODEC/TSGS4_25/Docs/
-    cprt => { Name => 'Copyright',  %langText, Groups => { 2 => 'Author' }, Preferred => 0 },
-    auth => { Name => 'Author',     %langText, Preferred => 0, Groups => { 2 => 'Author' } },
-    titl => { Name => 'Title',      %langText, Preferred => 0 },
+    # (note that all %langText tags are Avoid => 1)
+    cprt => { Name => 'Copyright',  %langText, Groups => { 2 => 'Author' } },
+    auth => { Name => 'Author',     %langText, Groups => { 2 => 'Author' } },
+    titl => { Name => 'Title',      %langText },
     dscp => { Name => 'Description',%langText },
     perf => { Name => 'Performer',  %langText },
-    gnre => { Name => 'Genre',      %langText, Preferred => 0 },
-    albm => { Name => 'Album',      %langText, Preferred => 0 },
+    gnre => { Name => 'Genre',      %langText },
+    albm => { Name => 'Album',      %langText },
     coll => { Name => 'CollectionName', %langText }, #17
     rtng => {
         Name => 'Rating',
@@ -1629,7 +1601,7 @@ my %eeBox = (
     cmnm => { # (NC)
         Name => 'Model',
         Description => 'Camera Model Name',
-        Preferred => 0,
+        Avoid => 1,
         Format => 'string', # (necessary to remove the trailing NULL)
     },
     date => { # (NC)
@@ -1653,14 +1625,14 @@ my %eeBox = (
     },
     manu => { # (SX280)
         Name => 'Make',
-        Preferred => 0,
+        Avoid => 1,
         # (with Canon there are 6 unknown bytes before the model: "\0\0\0\0\x15\xc7")
         RawConv => '$val=~s/^\0{4}..//s; $val=~s/\0.*//; $val',
     },
     modl => { # (Samsung GT-S8530, Canon SX280)
         Name => 'Model',
         Description => 'Camera Model Name',
-        Preferred => 0,
+        Avoid => 1,
         # (with Canon there are 6 unknown bytes before the model: "\0\0\0\0\x15\xc7")
         RawConv => '$val=~s/^\0{4}..//s; $val=~s/\0.*//; $val',
     },
@@ -1812,7 +1784,7 @@ my %eeBox = (
     CNMN => {
         Name => 'Model', #PH (EOS 550D)
         Description => 'Camera Model Name',
-        Preferred => 0,
+        Avoid => 1,
         Format => 'string', # (necessary to remove the trailing NULL)
     },
     CNFV => { Name => 'FirmwareVersion', Format => 'string' }, #PH (EOS 550D)
@@ -1858,7 +1830,7 @@ my %eeBox = (
     },
     # ---- GoPro ---- (ref PH)
     GoPr => 'GoProType', # (Hero3+)
-    FIRM => 'FirmwareVersion', # (Hero4)
+    FIRM => { Name => 'FirmwareVersion', Avoid => 1 }, # (Hero4)
     LENS => 'LensSerialNumber', # (Hero4)
     CAME => { # (Hero4)
         Name => 'SerialNumberHash',
@@ -1889,10 +1861,10 @@ my %eeBox = (
         Name => 'KodakDcMD',
         SubDirectory => { TagTable => 'Image::ExifTool::Kodak::DcMD' },
     },
-    SNum => { Name => 'SerialNumber', Groups => { 2 => 'Camera' } },
-    ptch => { Name => 'Pitch', Format => 'rational64s', Preferred => 0 }, # Units??
-    _yaw => { Name => 'Yaw',   Format => 'rational64s', Preferred => 0 }, # Units??
-    roll => { Name => 'Roll',  Format => 'rational64s', Preferred => 0 }, # Units??
+    SNum => { Name => 'SerialNumber', Avoid => 1, Groups => { 2 => 'Camera' } },
+    ptch => { Name => 'Pitch', Format => 'rational64s', Avoid => 1 }, # Units??
+    _yaw => { Name => 'Yaw',   Format => 'rational64s', Avoid => 1 }, # Units??
+    roll => { Name => 'Roll',  Format => 'rational64s', Avoid => 1 }, # Units??
     _cx_ => { Name => 'CX',    Format => 'rational64s', Unknown => 1 },
     _cy_ => { Name => 'CY',    Format => 'rational64s', Unknown => 1 },
     rads => { Name => 'Rads',  Format => 'rational64s', Unknown => 1 },
@@ -2641,10 +2613,9 @@ my %eeBox = (
     WRITE_GROUP => 'ItemList',
     LANG_INFO => \&GetLangInfo,
     NOTES => q{
-        As well as these tags, the "mdta" handler uses numerical tag ID's which are
-        added dynamically to this table after processing the Meta Keys information.
-        Tags in this table support alternate languages which are accessed by adding
-        a 3-character ISO 639-2 language code and an optional ISO 3166-1 alpha 2
+        This is the preferred location for creating new QuickTime tags.  Tags in
+        this table support alternate languages which are accessed by adding a
+        3-character ISO 639-2 language code and an optional ISO 3166-1 alpha 2
         country code to the tag name (eg. "ItemList:Title-fra" or
         "ItemList::Title-fra-FR").
     },
@@ -2654,9 +2625,9 @@ my %eeBox = (
     #  from being created when a same-named tag already exists in the table)
     "\xa9ART" => 'Artist',
     "\xa9alb" => 'Album',
-    "\xa9aut" => { Name => 'Author', Preferred => 0, Groups => { 2 => 'Author' } }, #forum10091 ('auth' is preferred)
+    "\xa9aut" => { Name => 'Author', Avoid => 1, Groups => { 2 => 'Author' } }, #forum10091 ('auth' is preferred)
     "\xa9cmt" => 'Comment',
-    "\xa9com" => { Name => 'Composer', Preferred => 0 }, # ("\xa9wrt" is preferred in ItemList)
+    "\xa9com" => { Name => 'Composer', Avoid => 1, }, # ("\xa9wrt" is preferred in ItemList)
     "\xa9day" => {
         Name => 'ContentCreateDate',
         Groups => { 2 => 'Time' },
@@ -2731,7 +2702,7 @@ my %eeBox = (
             1 => 'AOL',
         },
     },
-    albm => { Name => 'Album', Preferred => 0 }, #(ffmpeg source)
+    albm => { Name => 'Album', Avoid => 1 }, #(ffmpeg source)
     apID => 'AppleStoreAccount',
     atID => { #10 (or TV series)
         Name => 'AlbumTitleID',
@@ -2744,16 +2715,21 @@ my %eeBox = (
         Format => 'int32u',
     },
     cprt => { Name => 'Copyright', Groups => { 2 => 'Author' } },
-    dscp => { Name => 'Description', Preferred => 0 },
-    desc => { Name => 'Description', Preferred => 0 }, #7
+    dscp => { Name => 'Description', Avoid => 1 },
+    desc => { Name => 'Description', Avoid => 1 }, #7
     gnre => { #10
         Name => 'Genre',
-        Preferred => 0,
+        Avoid => 1,
         PrintConv => q{
             return $val unless $val =~ /^\d+$/;
             require Image::ExifTool::ID3;
             Image::ExifTool::ID3::PrintGenre($val - 1); # note the "- 1"
         },
+        PrintConvInv => q{
+            require Image::ExifTool::ID3;
+            my $id = Image::ExifTool::ID3::GetGenreID($val);
+            return defined $id ? $id : $val;
+        },
     },
     egid => 'EpisodeGlobalUniqueID', #7
     geID => { #10
@@ -5134,7 +5110,7 @@ my %eeBox = (
             50000092 => 'Audiobooks|Erotica',
         },
     },
-    grup => { Name => 'Grouping', Preferred => 0 }, #10
+    grup => { Name => 'Grouping', Avoid => 1 }, #10
     hdvd => { #10
         Name => 'HDVideo',
         PrintConv => { 0 => 'No', 1 => 'Yes' },
@@ -5347,7 +5323,7 @@ my %eeBox = (
         },
     },
     rate => 'RatingPercent', #PH
-    titl => { Name => 'Title', Preferred => 0 },
+    titl => { Name => 'Title', Avoid => 1 },
     tven => 'TVEpisodeID', #7
     tves => { #7/10
         Name => 'TVEpisode',
@@ -5388,7 +5364,7 @@ my %eeBox = (
     },
 
     # atoms observed in AAX audiobooks (ref PH)
-    "\xa9cpy" => { Name => 'Copyright', Preferred => 0, Groups => { 2 => 'Author' } },
+    "\xa9cpy" => { Name => 'Copyright', Avoid => 1, Groups => { 2 => 'Author' } },
     "\xa9pub" => 'Publisher',
     "\xa9nrt" => 'Narrator',
     '@pti' => 'ParentTitle', # (guess -- same as "\xa9nam")
@@ -5443,9 +5419,18 @@ my %eeBox = (
     LANG_INFO => \&GetLangInfo,
     FORMAT => 'string',
     NOTES => q{
-        This directory contains a list of key names which are used to decode
-        ItemList tags written by the "mdta" handler.  The prefix of
-        "com.apple.quicktime." has been removed from all TagID's below.
+        This directory contains a list of key names which are used to decode tags
+        written by the "mdta" handler.  The prefix of "com.apple.quicktime." has
+        been removed from all TagID's below.  These tags support alternate languages
+        in the same way as the
+        L<ItemList Tags|Image::ExifTool::TagNames/QuickTime ItemList Tags>.  Note
+        that by default,
+        L<ItemList|Image::ExifTool::TagNames/QuickTime ItemList Tags> and
+        L<UserData|Image::ExifTool::TagNames/QuickTime UserData Tags> tags are
+        preferred when writing, so to create a tag when a same-named tag exists in
+        either of these tables, either the "Keys" location must be specified (eg.
+        C<-Keys:Author=Phil> on the command line), or the PREFERRED level must be
+        changed via the config file.
     },
     version     => 'Version',
     album       => 'Album',