Exiv2
*****

This is Exiv2, a C++ library and a command line utility to read and
write Exif and Iptc image metadata.

The homepage of Exiv2 is: 

    http://home.arcor.de/ahuggel/exiv2/index.html

See doc/ChangeLog for a description of recent changes to Exiv2.

Point your browser to doc/index.html for the complete Exiv2 API
documentation and metadata tags.


Building and Installing
=======================

To build Exiv2 on UNIX-like systems (e.g., GNU/Linux, Mac OS X, MinGW),
use the included GNU configure script. Run the following commands from 
the top directory (containing this file) to configure, build and 
install the library and utility:

    $ ./configure
    $ make
    $ make install

The default install locations are /usr/local/lib for the library,
/usr/local/bin for the exiv2 utility and /usr/local/include/exiv2 for
the header files. Use the --prefix=directory option of the configure 
script to change this default. Run ./configure --help to see a list
of all options.

To build Exiv2 with MSVC 7.1, use the solution file msvc/exiv2.sln.


Troubleshooting
===============

If you have problems building Exiv2 on UNIX-like systems, check the
generated config/config.mk and config/config.h files. You should *not*
need to modify any Makefile directly, in particular not src/Makefile!


Uninstalling
============

    $ make uninstall


Reporting bugs
==============

If you have any suggestions or bug reports, please send electronic mail 
to the Exiv2 mailing list via

    http://home.arcor.de/ahuggel/exiv2/support.html

or submit bug reports directly to the bug tracking system at

    http://dev.robotbattle.com/bugs/main_page.php


Development
===========

On UNIX-like systems, application developers can use the script
exiv2-config in their build commands to obtain the correct compile and
link time flags for the Exiv2 library.

If you downloaded Exiv2 directly from the subversion repository, and
you want to build it using the GNU configure script, then you need to
have GNU Autoconf installed on your system and create the configure
script as the first step:

    $ make config

Then run the usual ./configure; make; make install commands.

To generate the documentation (make doc), you will further need
python, doxygen, graphviz and xsltproc.

Exiv2 uses GNU Libtool in order to build shared libraries on a variety
of systems. While this is very nice for making usable binaries, it can
be a pain when trying to debug a program. For that reason, compilation
of shared libraries can be turned off by specifying the
--disable-shared option to the configure script.


License
=======

Copyright (C) 2004, 2005, 2006 Andreas Huggel <ahuggel@gmx.net>

Exiv2 is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, 5th Floor, Boston, MA 02110-1301 USA.