[SCM] exiv2 packaging branch, master, updated. debian/0.25-3.1-3734-gdcbc29a

[Maximiliano Curia]

Gitweb-URL: http://git.debian.org/?p=pkg-kde/kde-extras/exiv2.git;a=commitdiff;h=54a0d72

The following commit has been merged in the master branch:
commit 54a0d72ddf4ad9abd9b38a6c9235e2f90641b273
Author: Andreas Huggel <ahuggel at gmx.net>
Date:   Sat May 8 07:00:01 2004 +0000

    Doc added
---
 src/exif.hpp | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/src/exif.hpp b/src/exif.hpp
index 735e3bb..bae3e8d 100644
--- a/src/exif.hpp
+++ b/src/exif.hpp
@@ -21,7 +21,7 @@
 /*!
   @file    exif.hpp
   @brief   Encoding and decoding of %Exif data
-  @version $Name:  $ $Revision: 1.38 $
+  @version $Name:  $ $Revision: 1.39 $
   @author  Andreas Huggel (ahu)
            <a href="mailto:ahuggel at gmx.net">ahuggel at gmx.net</a>
   @date    09-Jan-04, ahu: created
@@ -635,7 +635,17 @@ namespace Exif {
         /*!
           @brief Delete the thumbnail from the %Exif data. Removes all related
                  (%Thumbnail.*.*, i.e., IFD1) metadata as well.
-          @return The number of bytes erased from the original %Exif data.
+
+          @return The number of bytes of thumbnail data erased from the original
+                  %Exif data. Note that the original image size may differ from
+                  the size of the image after deleting the thumbnail by more
+                  than this number. This is the case if the %Exif data contains
+                  extra bytes (often at the end of the %Exif block) or gaps and
+                  the thumbnail is not located at the end of the %Exif block so
+                  that non-intrusive writing of a truncated %Exif block is not
+                  possible. Instead it is in this case necessary to write the
+                  %Exif data, without the thumbnail, from the metadata and all
+                  extra bytes and gaps are lost, resulting in a smaller image.
          */
         long eraseThumbnail();
         //@}
@@ -686,6 +696,7 @@ namespace Exif {
           @brief Write the thumbnail image to a file. A filename extension
                  is appended to path according to the image type of the
                  thumbnail, so the path should not include an extension.
+                 This will overwrite an existing file of the same name.
          */
         int writeThumbnail(const std::string& path) const 
             { return pThumbnail_ ? pThumbnail_->write(path) : 0; }

-- 
exiv2 packaging