diff --git a/src/exiv2.1 b/src/exiv2.1 index fc3677d4..f78c9b3f 100644 --- a/src/exiv2.1 +++ b/src/exiv2.1 @@ -3,7 +3,7 @@ .\" First parameter, NAME, should be all caps .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" other parameters are allowed: see man(7), man(1) -.TH EXIV2 1 "Aug 24, 2016" +.TH EXIV2 1 "Sep 23, 2016" .\" Please adjust this date whenever revising the manpage. .\" .\" Some roff macros, for reference: @@ -177,7 +177,7 @@ lvl d | i | i | w | e debug, info, warning, error mod s | a | t | v | h | i | x | c | p | i | C | R | S | X - summary, all, translated, vanilla, hex iptc, xmp, comment, preview, + summary, all, translated, vanilla, hex, iptc, xmp, comment, preview, ICC Profile, Recursive Structure, Simple Structure, raw XMP tgt a | c | e | i | p | t | x | C | X | XX | - @@ -316,11 +316,11 @@ c : JPEG comment .br p : list available image previews, sorted by preview image size in pixels .br -C : print image ICC Profile (jpg, png, tiff, cr2 only) +C : print image ICC Profile (jpg, png, tiff, webp, cr2 only) .br -R : print image structure recursively (jpg, png, tiff, cr2 only) +R : print image structure recursively (jpg, png, tiff, webp, cr2 only) .br -S : print image structure information (jpg, png, tiff, cr2 only) +S : print image structure information (jpg, png, tiff, webp, cr2 only) .br X : print "raw" XMP (jpg, png, tiff, cr2, webp only) .TP @@ -351,11 +351,11 @@ c : number of components (count) .br s : size in bytes .br -v : plain data value +v : plain data value (vanilla values) .br -V : plain data value AND the word 'set ' at the start of line (for use with exiv2 -m-) +V : plain data value AND the word 'set ' (for use with exiv2 -m-) .br -t : interpreted (translated) data +t : interpreted (translated) human readable data .br h : hexdump of the data .TP @@ -375,6 +375,8 @@ x : XMP packet c : JPEG comment .br C : ICC Profile +.br +I : All IPTC data .TP .B \-i \fItgt\fP Insert target(s) for the 'insert' action. Possible targets are the @@ -531,85 +533,65 @@ is used by default if the value doesn't start with a charset definition. .sp 1 The format for an IPTC \fBDate\fP value is: -.RS +.sp 1 YYYY\-MM\-DD (year, month, day) -.RE +.sp 1 The format for an IPTC \fBTime\fP value is: -.RS +.sp 1 HH:MM:SS (hours, minutes, seconds) -.RE +.sp and may optionally be followed by: -.RS +.sp 1 \-HH:MM or +HH:MM (hours, minutes ahead/behind UTC) -.RE +.sp 1 The format of \fBRational\fP (and \fBSRational\fP) is one of: -.RS -.IP -integer -.IP -integer-numerator/integer-denominator -.IP -Fnumber -.IP -fnumber -.RE +.sp 1 + integer | integer/integer | Fnumber | number +.sp 1 Rational Examples: -.RS +.sp 1 .nf -exiv2 "-Mset Exif.Photo.MaxApertureValue 557429/62500" X.jpg -exiv2 "-Mset Exif.Photo.MaxApertureValue F5.6" X.jpg +$ exiv2 "-Mset Exif.Photo.MaxApertureValue 557429/62500" X.jpg +$ exiv2 "-Mset Exif.Photo.MaxApertureValue F5.6" X.jpg .fi -.RE .sp 1 -The Rational format Fnumber (or fnumber) is for the convenience of setting aperture values. Aperture values +The Rational format Fnumber is for the convenience of setting aperture values. Aperture values are stored in Exif is an \fBAPEX\fP value which can be evaluated by the expression: .sp 1 -.RS .nf apex-value = log(Fnumber) * 2.0 / log(2.0) -Fnumber = exp(apex-value * log(2.0) / 2.0) +number = exp(apex-value * log(2.0) / 2.0) .fi -.RE .sp 1 The Rational format Fnumber is valid for any \fBRational\fP, even when the key is not an Aperture. More information about \fBAPEX\fP value is available from: http://en.wikipedia.org/wiki/APEX_system .sp 1 The format of XMP \fBLangAlt\fP values includes an optional language qualifier: -.RS .nf .B lang="\fIlanguage-code\fP\fI" text\fP .fi -.RE .sp lang="x-default" is used if the value doesn't start with a language qualifier. .sp 1 -.RS .nf - exiv2 -M'set Xmp.dc.title lang="de-DE" Euros' X.jpg - exiv2 -M'set Xmp.dc.title lang="en-GB" Pounds' X.jpg - exiv2 -M'set Xmp.dc.title lang="en-US" In God We Trust' X.jpg - exiv2 -M'set Xmp.dc.title All others pay cash' X.jpg +$ exiv2 -M'set Xmp.dc.title lang="de-DE" Euros' X.jpg +$ exiv2 -M'set Xmp.dc.title lang="en-GB" Pounds' X.jpg +$ exiv2 -M'set Xmp.dc.title lang="en-US" In God We Trust' X.jpg +$ exiv2 -M'set Xmp.dc.title All others pay cash' X.jpg .fi -.RE .sp 1 To remove a language specification, set the value to '' (empty string) -.RS .nf exiv2 -M'set Xmp.dc.title lang="en-US"' X.jpg .fi -.RE To remove all language specifications, delete the key: -.RS .nf -exiv2 -M'del Xmp.dc.title' X.jpg +$ exiv2 -M'del Xmp.dc.title' X.jpg .fi -.RE To register additional XMP namespaces, combine the command with: -.RS .nf \fBreg\fP \fIprefix\fP \fInamespace\fP .fi -.RE .SS Command file format Empty lines and lines starting with \fB#\fP in a command file are ignored (comments). Remaining lines are commands as described above. @@ -668,9 +650,6 @@ requirements of the target format. Some tags copied like this may not make sense in the target image. .SH SEE ALSO .TP -.I man exiv2samples -Information about the sample applications included in the exiv2 code distribution -.TP .I http://www.exiv2.org/sample.html#modify Sample command files. .TP