exiftool manpage not complete

[gregoa]

exiftool manpage not complete

[StarGeekSpaceNerd]

Phil is currently away until next week at least, but I will say this.

These are only four tags out of the 26,990 different metadata tags that Exiftool can currently read, many thousands of which are writable. Exiftool documentation tells how to use exiftool. It's not there to document all of these thousands of different pieces of metadata. For that, we must refer to the various standards, such as the IPTC Photo Metadata Standard, the EXIF standard, the EXIF for XMP standard, etc, etc. That's doesn't even cover tags that are proprietary to the varies camera models a.k.a. MakerNotes, to specific programs such as ACDSee or DigiKam, or many other extremely obscure schemas. Even Victoria's Secret, the lingerie company, has their own schema that they put in their images.

The Exiftool Forums tend to be very casual and try to be helpful. We don't tell people to do a search first or RTFM. Metadata is an absolute hellscape and many people don't even know what terms they should be searching for.

So it is quite unlikely that Phil will add an exception in the documentation for these four tags. The documentation is extensive as it is.

[boardhead]

Thanks for this. It is true that the documentation doesn't provide an example of how to write known GPS coordinates to a file, but as StarGeek says, there are too many possible tags to have examples of how to write them all.

However, I will add a note in the -geotag examples section to make it clear that this is for geotagging from log files, and that geotagging with known coordinates is done by writing the GPS tags directly.

• Phil

[gregoa]

Thanks Phil!

[gregoa]

So, I guess, that's

-ExifTool implements geotagging via 3 special tags: Geotag (which for
-convenience is also implemented as an exiftool option), Geosync and Geotime.
-The examples below highlight some geotagging features.  See
-L<https://exiftool.org/geotag.html> for additional documentation.
+ExifTool implements geotagging from GPS log files via 3 special tags: Geotag
+(which for convenience is also implemented as an exiftool option), Geosync
+and Geotime. The examples below highlight some geotagging features.  See
+L<https://exiftool.org/geotag.html> for additional documentation.  (Note
+that geotagging from known GPS coordinates is done by writing the
+L<GPS tags|Image::ExifTool::TagNames/GPS Tags> directly rather than using
+the B<-geotag> option.)

in 12.66 or 12.67 which is not mentioned in Changes?

[boardhead]

Hi Greg, Correct. Documentation changes don't appear in the version history. - Phil

…

On Sep 28, 2023, at 7:45 PM, gregor herrmann ***@***.***> wrote: So, I guess, that's -ExifTool implements geotagging via 3 special tags: Geotag (which for -convenience is also implemented as an exiftool option), Geosync and Geotime. -The examples below highlight some geotagging features. See -L<https://exiftool.org/geotag.html> for additional documentation. +ExifTool implements geotagging from GPS log files via 3 special tags: Geotag +(which for convenience is also implemented as an exiftool option), Geosync +and Geotime. The examples below highlight some geotagging features. See +L<https://exiftool.org/geotag.html> for additional documentation. (Note +that geotagging from known GPS coordinates is done by writing the +L<GPS tags|Image::ExifTool::TagNames/GPS Tags> directly rather than using +the B<-geotag> option.) in 12.66 or 12.67 which is not mentioned in Changes? — Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you commented.