[libexif-cvs] libexif/libexif exif-byte-order.h, 1.5, 1.6 exif-data.h, 1.23, 1.24

[Dan F. <dfa...@us...>]

Update of /cvsroot/libexif/libexif/libexif
In directory ddv4jf1.ch3.sourceforge.com:/tmp/cvs-serv4516/libexif

Modified Files:
	exif-byte-order.h exif-data.h 
Log Message:
Added some more Doxygen comments.


Index: exif-byte-order.h
===================================================================
RCS file: /cvsroot/libexif/libexif/libexif/exif-byte-order.h,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -p -d -r1.5 -r1.6
--- exif-byte-order.h	17 Feb 2008 18:31:55 -0000	1.5
+++ exif-byte-order.h	14 Apr 2009 06:00:15 -0000	1.6
@@ -25,11 +25,18 @@
 extern "C" {
 #endif /* __cplusplus */
 
+/*! Which byte order to use */
 typedef enum {
+	/*! Big-endian byte order */
 	EXIF_BYTE_ORDER_MOTOROLA,
+	/*! Little-endian byte order */
 	EXIF_BYTE_ORDER_INTEL
 } ExifByteOrder;
 
+/*! Return a short, localized, textual name for the given byte order.
+ * \param[in] order byte order
+ * \return localized textual name of the byte order
+ */
 const char *exif_byte_order_get_name (ExifByteOrder order);
 
 #ifdef __cplusplus

Index: exif-data.h
===================================================================
RCS file: /cvsroot/libexif/libexif/libexif/exif-data.h,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -p -d -r1.23 -r1.24
--- exif-data.h	13 Jan 2009 01:48:39 -0000	1.23
+++ exif-data.h	14 Apr 2009 06:00:15 -0000	1.24
@@ -57,12 +57,19 @@ struct _ExifData
 	ExifDataPrivate *priv;
 };
 
-/*! Allocate a new, empty #ExifData.
+/*! Allocate a new #ExifData. The #ExifData contains an empty
+ * #ExifContent for each IFD and the default set of options.
  *
  * \return allocated #ExifData, or NULL on error
  */
 ExifData *exif_data_new           (void);
 
+/*! Allocate a new #ExifData using the given memory allocator.
+ * The #ExifData contains an empty #ExifContent for each IFD and the default
+ * set of options.
+ *
+ * \return allocated #ExifData, or NULL on error
+ */
 ExifData *exif_data_new_mem       (ExifMem *);
 
 /*! Allocate a new #ExifData and load EXIF data from a JPEG file.
@@ -85,6 +92,8 @@ ExifData *exif_data_new_from_data (const
 /*! Load the #ExifData structure from the raw JPEG or EXIF data in the given
  * memory buffer. If the EXIF data contains a recognized MakerNote, it is
  * loaded and stored as well for later retrieval by #exif_data_get_mnote_data.
+ * If the EXIF_DATA_OPTION_FOLLOW_SPECIFICATION has been set on this #ExifData,
+ * then the tags are fixed after loading.
  *
  * \param[in,out] data EXIF data
  * \param[in] d pointer to raw JPEG or EXIF data