[SCM] exiv2 packaging branch, master, updated. debian/0.25-3.1-3734-gdcbc29a
Maximiliano Curia
maxy at moszumanska.debian.org
Thu Jul 13 17:47:02 UTC 2017
Gitweb-URL: http://git.debian.org/?p=pkg-kde/kde-extras/exiv2.git;a=commitdiff;h=e46907c
The following commit has been merged in the master branch:
commit e46907cb1bff5e13730121e93c2687d9afbf26a3
Author: Robin Mills <robin at clanmills.com>
Date: Fri Sep 23 10:25:57 2016 +0000
Man page review for v0.26
---
src/exiv2.1 | 79 +++++++++++++++++++++++--------------------------------------
1 file changed, 29 insertions(+), 50 deletions(-)
diff --git a/src/exiv2.1 b/src/exiv2.1
index fc3677d..f78c9b3 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
Itgt
P
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
BDate
P value is:
-.RS
+.sp 1
YYYY\-MM\-DD (year, month, day)
-.RE
+.sp 1
The format for an IPTC
BTime
P 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
BRational
P (and
BSRational
P) 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
BAPEX
P 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
BRational
P, even when the key is not an Aperture.
More information about
BAPEX
P value is available from: http://en.wikipedia.org/wiki/APEX_system
.sp 1
The format of XMP
BLangAlt
P values includes an optional language qualifier:
-.RS
.nf
.B lang="
Ilanguage-code
P
I" text
P
.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
Breg
P
Iprefix
P
Inamespace
P
.fi
-.RE
.SS Command file format
Empty lines and lines starting with
B#
P 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
--
exiv2 packaging
More information about the pkg-kde-commits
mailing list