[SCM] exiv2 packaging branch, master, updated. debian/0.25-3.1-3734-gdcbc29a
Maximiliano Curia
maxy at moszumanska.debian.org
Thu Jul 13 17:37:18 UTC 2017
Gitweb-URL: http://git.debian.org/?p=pkg-kde/kde-extras/exiv2.git;a=commitdiff;h=58e8f30
The following commit has been merged in the master branch:
commit 58e8f30110790a89bd4356c5928a416c8473c3ff
Author: Andreas Huggel <ahuggel at gmx.net>
Date: Fri Nov 18 15:35:42 2005 +0000
Added man page (based on Peter KELEMEN's Debian man page)
---
src/Makefile | 6 ++
src/exiv2.1 | 262 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
2 files changed, 268 insertions(+)
diff --git a/src/Makefile b/src/Makefile
index 15cdc51..879d245 100644
--- a/src/Makefile
+++ b/src/Makefile
@@ -217,6 +217,9 @@ install-lib: lib install-header
install: $(EXIV2BIN) install-lib
$(INSTALL_DIRS) $(DESTDIR)$(bindir)
@$(LIBTOOL) --mode=install $(INSTALL_PROGRAM) $(EXIV2EXE) $(DESTDIR)$(bindir)/$(EXIV2EXE)
+ $(INSTALL_DIRS) $(DESTDIR)$(mandir)
+ $(INSTALL_DIRS) $(DESTDIR)$(man1dir)
+ $(INSTALL_DATA) exiv2.1 $(DESTDIR)$(man1dir)/exiv2.1
uninstall-header:
@list='$(HDR)'; for p in $$list; do \
@@ -232,6 +235,9 @@ uninstall-lib: uninstall-header
-rmdir $(DESTDIR)$(libdir)
uninstall: uninstall-lib
+ $(RM) $(DESTDIR)$(man1dir)/exiv2.1
+ -rmdir $(DESTDIR)$(man1dir)
+ -rmdir $(DESTDIR)$(mandir)
@$(LIBTOOL) --mode=uninstall $(RM) $(DESTDIR)$(bindir)/$(EXIV2EXE)
-rmdir $(DESTDIR)$(bindir)
diff --git a/src/exiv2.1 b/src/exiv2.1
new file mode 100644
index 0000000..2021584
--- /dev/null
+++ b/src/exiv2.1
@@ -0,0 +1,262 @@
+.\" Hey, EMACS: -*- nroff -*-
+.\" @(#) $Id$
+.\" 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 "November 13th, 2005"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh disable hyphenation
+.\" .hy enable hyphenation
+.\" .ad l left justify
+.\" .ad b justify to both left and right margins
+.\" .nf disable filling
+.\" .fi enable filling
+.\" .br insert line break
+.\" .sp <n> insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.SH NAME
+exiv2 \- EXIF/IPTC metadata manipulation tool
+.SH SYNOPSIS
+.B exiv2
+[
Ioptions
P] [
Iaction
P]
Ifile
P ...
+.br
+.SH DESCRIPTION
+.PP
+.\" TeX users may be more comfortable with the
B<whatever>
P and
+.\"
I<whatever>
P escape sequences to invode bold face and italics,
+.\" respectively.
+.B exiv2
+is a program to read and write EXIF/IPTC
+metadata. Supported image formats are JPEG, Canon CRW (read only) and
+Canon THM.
+.SH ACTIONS
+The
Iaction
P argument is only required if there are no
+
Ioptions
P or if it is not clear which action is implied.
+.TP
+.B pr | print
+Print image metadata. This is the default action.
+.TP
+.B ex | extract
+Extract metadata to *.exv and thumbnail image files.
+.TP
+.B in | insert
+Insert metadata from corresponding *.exv files.
+Use option
B\-S
P
I.suf
P to change the suffix of the input files.
+.TP
+.B rm | delete
+Delete image metadata from the files.
+.TP
+.B ad | adjust
+Adjust EXIF timestamps by the given time. This action requires the option
+
B\-a
P
Itime
P.
+.TP
+.B mo | modify
+Apply commands to modify (add, set, delete) the EXIF/IPTC metadata of image
+files. Requires option
B\-m
P or
B\-M
P.
+.TP
+.B mv | rename
+Rename files according to the EXIF create timestamp. The filename format
+can be set with
B\-r
P
Ifmt
P.
+.SH OPTIONS
+.TP
+.B \-h
+Display help and exit.
+.TP
+.B \-V
+Show the program version and exit.
+.TP
+.B \-v
+Be verbose during the program run.
+.TP
+.B \-f
+Do not prompt before overwriting existing files (force overwrite).
+.TP
+.B \-F
+Do not prompt before renaming existing files (Force rename).
+.TP
+.B \-a
Itime
P
+Time adjustment in the format [\-]HH[:MM[:SS]]. This option is only
+used with the 'adjust' action. Examples: 1 adds one hour, 1:01
+adds one hour and one minute, \-0:00:30 subtracts 30 seconds.
+.TP
+.B \-p
Imode
P
+Print mode for the 'print' action. Possible modes are:
+.br
+s : print a summary of the EXIF metadata (the default)
+.br
+t : interpreted (translated) EXIF data
+.br
+v : plain EXIF data values
+.br
+h : hexdump of the EXIF data
+.br
+i : IPTC data values
+.br
+c : JPEG comment
+.TP
+.B \-d
Itgt
P
+Delete target(s) for the 'delete' action. Possible targets are:
+.br
+a : all supported metadata (the default)
+.br
+e : EXIF section
+.br
+t : EXIF thumbnail only
+.br
+i : IPTC data
+.br
+c : JPEG comment
+.TP
+.B \-i
Itgt
P
+Insert target(s) for the 'insert' action. Possible targets are the same as
+those for the
B\-d
P option. Only JPEG thumbnails can be inserted, they
+need to be named
Ifile
P\-thumb.jpg.
+.TP
+.B \-e
Itgt
P
+Extract target(s) for the 'extract' action. Possible targets the same as
+those for the
B\-d
P option.
+.TP
+.B \-r
Ifmt
P
+Filename format for the 'rename' action. The format string follows
+
Bstrftime
P(3). Default filename format is %Y%m%d_%H%M%S.
+.TP
+.B \-m
Ifile
P
+Command file for the modify action.
+.TP
+.B \-M
Icmd
P
+Command line for the modify action. The format for the commands is the same
+as that of the lines of a command file.
+.TP
+.B \-l
Idir
P
+Location (directory) for files to be inserted or extracted.
+.TP
+.B \-S
I.suf
P
+Use suffix
I.suf
P for source files for insert command.
+.SH COMMANDS
+Commands for the 'modify' action can be read from a command file, e.g.,
+.sp 1
+.nf
+ exiv2 \-m cmd.txt image.jpg
+.fi
+.sp 1
+or given on the command line, as in
+.sp 1
+.nf
+ exiv2 \-M"add Iptc.Application2.Credit String Mr. Smith" image.jpg
+.fi
+.sp 1
+Note the quotes. Multiple
B\-m
P and
B\-M
P options can be combined.
+.sp 1
+When writing EXIF/IPTC metadata,
+.B exiv2
+enforces only a correct
+metadata structure. It is possible to write tags with types and values
+different from those specified in the standards, duplicate EXIF tags,
+undefined tags, or incomplete metadata. While
+.B exiv2
+is able to read
+all metadata that it can write, other programs may have difficulties
+with images that contain non standard\-conforming metadata.
+.SS Command format
+The format of a command is
+.sp 1
+.nf
+
Bset | add | del
P
Ikey
P [[
Itype
P]
Ivalue
P]
+.fi
+.TP
+.B set
+Set the
Ivalue
P of an existing tag with a matching
Ikey
P or
+add the tag.
+.TP
+.B add
+Add a tag (unless
Ikey
P is a non\-repeatable IPTC key; nothing
+prevents you from adding duplicate EXIF tags).
+.TP
+.B del
+Delete a tag (requires only a
Ikey
P).
+.TP
+.I key
+Exiv2 EXIF or IPTC key.
+.TP
+.I type
+.B Byte | Ascii | Short | Long | Rational | Undefined | SShort | SLong | SRational | Comment
+for EXIF keys, and
+.br
+.B String | Date | Time | Short | Undefined
+for IPTC keys.
+.sp 1
+A default
Itype
P is used if none is explicitely given. The default
+is determined based on
Ikey
P.
+.TP
+.I value
+The remaining text on the line is the value. It can optionally be
+enclosed in double quotes ("
Ivalue
P").
+.sp 1
+The format of EXIF
BComment
P values includes an optional charset
+specification at the beginning:
+.sp 1
+.B [charset=Ascii|Jis|Unicode|Undefined ]
Icomment
P
+.sp 1
+.B Undefined
+is used by default if the value doesn't start with a charset
+definition.
+.sp 1
+The format for IPTC
BDate
P values is YYYY\-MM\-DD (year, month, day)
+that for IPTC
BTime
P values is HH:MM:SS+|\-HH:MM, where HH:MM:SS
+refers to local hour, minute and seconds and +|\-HH:MM refers to hours
+and minutes ahead or behind Universal Coordinated Time (+|\- means
+either a + or a \- sign is required).
+.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.
+.SH EXAMPLES
+.TP
+exiv2 *.jpg
+Prints a summary of the EXIF information for all JPEG files in the directory.
+.TP
+exiv2 -pi image.jpg
+Prints the IPTC metadata of the image.
+.TP
+exiv2 rename image.jpg
+Renames image.jpg (taken on 13\-Nov\-05 at 22:58:31) to 20051113_225831.jpg
+.TP
+exiv2 ex img1.jpg img2.jpg
+Extracts metadata from the two files into files img1.exv and img2.exv.
+.TP
+exiv2 \-et img1.jpg img2.jpg
+Extracts the EXIF thumbnails from the two files into img1\-thumb.jpg
+and img2\-thumb.jpg.
+.TP
+exiv2 \-it img1.jpg img2.jpg
+Inserts (copies) metadata from img1.exv to img1.jpg and from img2.exv
+to img2.jpg.
+.TP
+.nf
+exiv2 \-M"set Exif.Photo.UserComment charset=Ascii New EXIF comment" image.jpg
+.fi
+Sets the EXIF comment to an ASCII string.
+.TP
+.nf
+exiv2 \-M"set Exif.GPSInfo.GPSLatitude 4/1 15/1 33/1" \
+\-M"set Exif.GPSInfo.GPSLatitudeRef N" image.jpg
+.fi
+Sets the latitude to 4 degrees, 15 minutes and 33 seconds north. The
+EXIF standard stipulates that the GPSLatitude tag consists of three
+Rational numbers for the degrees, minutes and seconds of the latitude
+and GPSLatitudeRef contains either 'N' or 'S' for north or south
+latitude respectively.
+.SH SEE ALSO
+.TP
+.I http://home.arcor.de/ahuggel/exiv2/sample.html#modify
+Sample command file.
+.TP
+.I http://home.arcor.de/ahuggel/exiv2/metadata.html
+Taglists with
Ikey
P and default
Itype
P values.
+.SH AUTHOR
+.B exiv2
+was written by Andreas HUGGEL <ahuggel at gmx.net>.
+.PP
+This manual page was originally written by KELEMEN Peter <fuji at debian.org>,
+for the Debian project.
--
exiv2 packaging
More information about the pkg-kde-commits
mailing list