Updated documentation, bumped version to 0.7

config/configure.ac

@@ -2,7 +2,7 @@
 # Process this file with autoconf to produce a configure script.
 
 AC_PREREQ(2.59)
-AC_INIT(Exiv2, 0.6.2, ahuggel@gmx.net)
+AC_INIT(Exiv2, 0.7, ahuggel@gmx.net)
 AC_CONFIG_SRCDIR([src/exif.cpp])
 AC_CONFIG_HEADER([./config/config.h])
 AC_CONFIG_AUX_DIR([./config])

doc/templates/getting-started.html.in

@@ -13,14 +13,27 @@ __index1__
 <p>The <a href="index.html">Exiv2 library</a> is made up of all
 elements defined in the <a href="namespaceExiv2.html">Exiv2
 namespace</a>. The Action and Util namespaces are only used by the
-Exiv2 command line utility. Thus, to learn about the library, concentrate on
+Exiv2 command line utility. Thus, to learn about the library, focus on
 the members of the Exiv2 namespace.</p>
 
 <h2><a href="classes.html">Classes</a></h2>
 
-<p><a class="el" href="classExiv2_1_1ExifData.html">Exiv2::ExifData</a> 
+<p>The top-level class of the Exiv2 library is 
+<a class="el" href="classExiv2_1_1Image.html">Exiv2::Image</a>
+ 
+(don't let the components diagram below mislead you). Exiv2::Image
+defines the interface to access various image metadata. Derived from
+Exiv2::Image are the implementations of different image formats.
+However, the only image format currently supported is Jpeg. Most
+applications will use
+<a class="el" href="classExiv2_1_1ImageFactory.html">Exiv2::ImageFactory</a> 
+to access images in files or memory, in which case the image format 
+is transparent to them.</p>
+
+<p>Metadata is manipulated through the classes
+<a class="el" href="classExiv2_1_1ExifData.html">Exiv2::ExifData</a> 
 and <a class="el" href="classExiv2_1_1IptcData.html">Exiv2::IptcData</a>
-are the top-level classes of the Exiv2 library. They hold a container
+of the Exiv2 library. They hold a container
 of Exif and Iptc metadata, respectively, and define related methods to
 access and manipulate the metadata. The containers hold objects derived from
 <a class="el" href="classExiv2_1_1Metadatum.html">Exiv2::Metadatum</a>. 

src/doxygen.hpp

@@ -8,38 +8,32 @@
   @date    07-Feb-04, ahu: created
  */
 /*!
-  @mainpage Exif and Iptc metadata manipulation library and tools v0.6.2
+  @mainpage Exif and Iptc metadata manipulation library and tools v0.7
 
   @section overview Exiv2 Overview
+
+  %Exiv2 comprises of a C++ library and a command line utility to access image 
+  metadata. %Exiv2 is free software.
  
-  Exiv2 is a C++ library that provides
+  The %Exiv2 library provides
-  - read and write access to the Exif and Iptc IIM metadata of an image 
+  - full read and write access to the Exif and Iptc metadata of an image through 
-    through %Exiv2 keys and standard C++ iterators 
+    %Exiv2 keys and standard C++ iterators 
-  - Exif MakerNote support:
+  - a smart Iptc implementation that does not effect data that programs like 
-      - MakerNote tags can be accessed just like any other metadata
+    Photoshop store in the same image segment
-      - a sophisticated write algorithm avoids corrupting the MakerNote: 
+  - Exif %MakerNote support:
-         <BR>&nbsp;&nbsp;1) the MakerNote is not re-located if possible, and 
+    - %MakerNote tags can be accessed just like any other Exif metadata
-         <BR>&nbsp;&nbsp;2) MakerNote IFD offsets are re-calculated if the MakerNote
+    - a sophisticated write algorithm avoids corrupting the %MakerNote: 
-                            needs to be moved (for known IFD MakerNotes)
+      <br>&nbsp;&nbsp;1) the %MakerNote is not re-located if possible at all, and 
-      - new camera make/model specific MakerNotes can be added to the library
+      <br>&nbsp;&nbsp;2) %MakerNote %Ifd offsets are re-calculated if the 
-        with minimum effort in OO-fashion (by subclassing MakerNote or IfdMakerNote)
+                         %MakerNote needs to be moved (for known %Ifd %MakerNotes)
+    - new camera make/model specific %MakerNotes can be added to the library with 
+      minimum effort in OO-fashion (by subclassing %MakerNote or %IfdMakerNote)
+  - extract and delete methods for Exif thumbnails (both, Jpeg and Tiff thumbnails)
   - set methods for Exif thumbnails (Jpeg only, Tiff thumbnails can be set from 
     individual tags)
-  - extract and delete methods for Exif thumbnails (both, JPEG and TIFF thumbnails)
+  - complete API documentation (by Doxygen)
-  - Doxygen API documentation
+  - generic lower-level classes to access %Ifd (%Image File Directory) data 
-  - generic lower-level classes to access IFD (Image File Directory) data structures
+    structures
-
-  %Exiv2 is also a command line program to
-  - print the Exif metadata of JPEG images (as summary info, interpreted values, or
-    the plain data for each tag)
-  - print the Iptc metadata of JPEG images
-  - print the Jpeg comment of JPEG images
-  - adjust the Exif timestamp (that's how it all started...)
-  - rename Exif image files according to the Exif timestamp
-  - extract Exif metadata, Iptc metadata and Jpeg comments from image files and 
-    insert it again
-  - extract the thumbnail image embedded in the Exif metadata
-  - delete the thumbnail or the complete Exif metadata from an image
 
   @section getting-started Getting started
 
@@ -62,15 +56,22 @@
   A summary of <A HREF="makernote.html">MakerNote structures</A> with links to 
   publicly available specifications.
 
+  @section supp Support
+
+  <p>There is now a 
+  <a title="Exiv2 forum" href="http://uk.groups.yahoo.com/group/exiv2">Yahoo! group for Exiv2 help and discussions</a>.</p> 
+  <p><a title="Join the Exiv2 forum" href="http://uk.groups.yahoo.com/group/exiv2/join">Join the group</a> to post and receive messages or use <em><a title="Post to the Exiv2 forum" href="http://uk.groups.yahoo.com/group/exiv2/post">exiv2user/password</a></em> to post anonymously. Bug reports can be submitted directly to the 
+<a title="Issue tracker" href="http://dev.robotbattle.com/bugs/main_page.php"
+  onclick="document.images['tracker'].src='http://www.whatcounter.com/dlcount.php?id=ahu&amp;url='+this.href">
+bug tracking system</a>.</p>
+
   @section devel Development
 
   <p>%Exiv2 is maintained in a publicly available subversion repository. 
-  You can see a <a title="Last 50 commits" href="http://dev.robotbattle.com/cmtinfo_svn.php?r=10">
+  There is a <a title="Last 50 commits" href="http://dev.robotbattle.com/cmtinfo_svn.php?r=10">
-  live list with the latest commits</a> to the repository,
+  live list with the latest commits</a> to the repository, and you can 
   <a title="Online source code repository" href="http://dev.robotbattle.com/~cvsuser/cgi-bin/ns_viewcvs.cgi/exiv2/trunk/">
-  browse the source code</a> online, access the 
+  browse the source code</a> online.
-  <a title="Issue tracker" href="http://dev.robotbattle.com/bugs/main_page.php">
-  bug tracking system</a> and report bugs.
   </p>
   <p>To check-out the current source code from the repository, you need a 
   <a title="Get Subversion!"
@@ -80,12 +81,12 @@
   
   @verbatim $ svn checkout svn://dev.robotbattle.com/exiv2/trunk . @endverbatim
 
-  <p>To download the test data and test drivers for version 0.6.2 from
+  <p>To download the test data and test drivers for version 0.7 from
-  the repository, change to your local exiv2-0.6.2 directory and use the
+  the repository, change to your local exiv2-0.7 directory and use the
   following command:
   </p>
   
-  @verbatim $ svn export svn://dev.robotbattle.com/exiv2/tags/0.6.2/test @endverbatim
+  @verbatim $ svn export svn://dev.robotbattle.com/exiv2/tags/0.7/test @endverbatim
 
   <P>If you'd like to contribute code, please <A HREF="mailto:ahuggel@gmx.net">contact me</A>.
 

src/exv_msvc.h

@@ -23,13 +23,13 @@
 #define EXV_PACKAGE_NAME "Exiv2"
 
 /* Define to the full name and version of this package. */
-#define EXV_PACKAGE_STRING "Exiv2 0.6.2"
+#define EXV_PACKAGE_STRING "Exiv2 0.7"
 
 /* Define to the one symbol short name of this package. */
 #define EXV_PACKAGE_TARNAME "exiv2"
 
 /* Define to the version of this package. */
-#define EXV_PACKAGE_VERSION "0.6.2"
+#define EXV_PACKAGE_VERSION "0.7"
 
 /* Define to `int' if <sys/types.h> does not define pid_t. */
 #define pid_t int

test/data/exiv2-test.out

@@ -3,7 +3,7 @@ tmp/
 
 Exiv2 version ------------------------------------------------------------
 ../../src/exiv2
-Exiv2 0.6.2, Copyright (C) 2004, 2005 Andreas Huggel.
+Exiv2 0.7, Copyright (C) 2004, 2005 Andreas Huggel.
 
 This is free software; see the source for copying conditions.  There is NO 
 warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.