Added some more Doxygen comments.

diff --git a/libexif/exif-byte-order.h b/libexif/exif-byte-order.h
index a7c98c9..489a05c 100644 (file)
--- a/libexif/exif-byte-order.h
+++ b/libexif/exif-byte-order.h
@@ -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

diff --git a/libexif/exif-data.h b/libexif/exif-data.h
index 50830f0..1832651 100644 (file)
--- a/libexif/exif-data.h
+++ b/libexif/exif-data.h
@@ -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 unsigned char *data,
 /*! 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