Update Configuration file section in manpage

Changes:
+ Fix filename in example
+ Indent command line output
+ Update text
main
postscript-dev 4 years ago
parent f505b01322
commit a33e5424a4
No known key found for this signature in database
GPG Key ID: F3EC02A099292862

@ -810,60 +810,57 @@ the YYYY:MM:DD HH:MM:SS standard.
.ne 40 .ne 40
.SH CONFIGURATION FILE .SH CONFIGURATION FILE
\fBexiv2\fP can read an optional configuration file, which allows \fBexiv2\fP can read an optional configuration file, which allows
additional lens definitions to be added into the output. On Unix based additional lens definitions to be added to translated output. On UNIX based
systems, the file is called \fI.exiv2\fP and on Windows, \fIexiv2.ini\fP. systems, this file is called \fI.exiv2\fP and on Windows, \fIexiv2.ini\fP.
The files are first searched for in the current directory, then the The file is searched for first in the current directory, then in the
home directory. home directory (on UNIX based systems, \fI~/\fP and on Windows, \fI%USERPROFILE%\\\fP).
.sp 1 .sp 1
You can determine the name of the file and where it is searched for, You can determine the name of the file and where it is searched for,
with the command: with the command:
.sp 1 .sp 1
.nf .nf
\fB \& $ exiv2 --verbose --version --grep config_path
$ exiv2 --verbose --version --grep config_path \& exiv2 1.0.0.9
exiv2 1.0.0.9 \& config_path=/Users/rmills/.exiv2
config_path=/Users/rmills/.exiv2\fP
.fi .fi
.sp 1 .sp 1
The file uses the Windows .ini format (see \fIhttps://en.wikipedia.org/wiki/INI_file\fP) The configuration file uses the Windows \fI.ini\fP format (see \fIhttps://en.wikipedia.org/wiki/INI_file\fP)
and has sections for each of the major camera manufactures: Canon, Minolta, and has sections for each of the major camera manufactures: Canon, Minolta,
Nikon, Olympus, Pentax and Sony. The lens definitions replace the text associated Nikon, Olympus, Pentax and Sony. The configuration file definitions override any existing
with a lensID, with the configuration file values overriding any previously values.
defined.
.br .br
.sp 1 .sp 1
e.g. To add a new lens definition, you first obtain the lensID for For example, to add a new lens definition, first obtain the lensID for
your camera with the command: your camera:
.sp 1 .sp 1
.nf .nf
\fB
$ exiv2 -pv --grep lens/i https://clanmills.com/Stonehenge.jpg \& $ curl --silent -O https://clanmills.com/Stonehenge.jpg
0x0083 Nikon3 LensType Byte 1 14 \& $ exiv2 --print v --grep lens/i Stonehenge.jpg
0x0084 Nikon3 Lens Rational 4 180/10 2500/10 35/10 63/10 \& 0x0083 Nikon3 LensType Byte 1 14
0x008b Nikon3 LensFStops Undefined 4 55 1 12 0 \& 0x0084 Nikon3 Lens Rational 4 180/10 2500/10 35/10 63/10
0x000c NikonLd3 LensIDNumber Byte 1 146 \& 0x008b Nikon3 LensFStops Undefined 4 55 1 12 0
0x000d NikonLd3 LensFStops Byte 1 55\fP \& 0x000c NikonLd3 LensIDNumber Byte 1 146
\& 0x000d NikonLd3 LensFStops Byte 1 55
.fi .fi
.sp 1 .sp 1
Then using the 'LensIDNumber' tag's value (i.e. 146), add the Then using the 'LensIDNumber' value (i.e., 146), add the following text to
following text to the appropriate \fI.exiv2\fP or \fIexiv2.ini\fP the configuration file:
file: .sp 1
.nf .nf
\fB \& [nikon]
[nikon] \& 146=Robin's Sigma Lens
146=Robin's Sigma Lens\fP
.fi .fi
.sp 1 .sp 1
The text will now appear when the translated print option is used: The text will now appear when the translated print option is used:
.sp 1 .sp 1
.nf .nf
\fB \& $ exiv2 --print t --grep lens/i Stonehenge.jpg
$ exiv2 -pt --grep lens/i 20150716_153854.jpg \& Exif.Nikon3.LensType Byte 1 D G VR
Exif.Nikon3.LensType Byte 1 D G VR \& Exif.Nikon3.Lens Rational 4 18-250mm F3.5-6.3
Exif.Nikon3.Lens Rational 4 18-250mm F3.5-6.3 \& Exif.Nikon3.LensFStops Undefined 4 4.58333
Exif.Nikon3.LensFStops Undefined 4 4.58333 \& Exif.NikonLd3.LensIDNumber Byte 1 Robin's Sigma Lens
Exif.NikonLd3.LensIDNumber Byte 1 Robin's Sigma Lens \& Exif.NikonLd3.LensFStops Byte 1 F4.6
Exif.NikonLd3.LensFStops Byte 1 F4.6\fP
.fi .fi
.sp 1 .sp 1
.ne 40 .ne 40

Loading…
Cancel
Save