[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=2e428d8

The following commit has been merged in the master branch:
commit 2e428d8a49a148372cde34d50a335b03a4cc9440
Author: Andreas Huggel <ahuggel at gmx.net>
Date:   Sun Oct 31 05:17:47 2004 +0000

    Updated doc
---
 src/types.hpp | 31 +++++++++++++++++++++++++------
 1 file changed, 25 insertions(+), 6 deletions(-)

diff --git a/src/types.hpp b/src/types.hpp
index 0490f82..0f1b219 100644
--- a/src/types.hpp
+++ b/src/types.hpp
@@ -134,12 +134,18 @@ namespace Exiv2 {
         //! Assignment operator
         DataBuf& operator=(const DataBuf&);
     public:
+        //! @name Creators
+        //@{
         //! Default constructor
         DataBuf() : size_(0), pData_(0) {}
         //! Constructor with an initial buffer size 
         DataBuf(long size) : size_(size), pData_(new byte[size]) {}
         //! Destructor, deletes the allocated buffer
         ~DataBuf() { delete[] pData_; }
+        //@}
+
+        //! @name Manipulators
+        //@{
         //! Allocate a data buffer of the given size
         void alloc(long size);
         /*!
@@ -147,6 +153,9 @@ namespace Exiv2 {
                  value, resets pData_ and size_ to 0.
          */
         byte* release();
+        //@}
+
+        // DATA
         //! The current size of the buffer
         long size_; 
         //! Pointer to the buffer, 0 if none has been allocated
@@ -154,10 +163,10 @@ namespace Exiv2 {
     }; // class DataBuf
 
     /*!
-      @brief Utility class that closes a file stream pointer upon destruction. 
-           Its primary use is to be a stack variable in functions that need
-           to ensure files get closed. Useful when functions return errors
-           from many locations.
+      @brief Utility class that closes a file stream pointer upon destruction.
+             Its primary use is to be a stack variable in functions that need to
+             ensure files get closed. Useful when functions return errors from
+             many locations.
      */
     class FileCloser {
         // Not implemented
@@ -166,13 +175,23 @@ namespace Exiv2 {
         //! Assignment operator
         FileCloser& operator=(const FileCloser&);
     public:
+        //! @name Creators
+        //@{
         //! Default constructor
         FileCloser() : fp_(0) {}
-        //! Constructor with an initial buffer size 
+        //! Constructor, takes a file stream pointer 
         FileCloser(FILE *fp) : fp_(fp) {}
-        //! Destructor, deletes the allocated buffer
+        //! Destructor, closes the file
         ~FileCloser() { close(); }
+        //@}
+
+        //! @name Manipulators
+        //@{
+        //! Close the file
         void close() { if (fp_) fclose(fp_); fp_ = 0; }
+        //@}
+
+        // DATA
         //! The file stream pointer
         FILE *fp_; 
     }; // class FileCloser

-- 
exiv2 packaging