Add a MUSL build on Travis.

[platform/upstream/libexif.git] / libexif / exif-entry.h

diff --git a/libexif/exif-entry.h b/libexif/exif-entry.h
index 34d1e93..1dcdc73 100644 (file)
--- a/libexif/exif-entry.h
+++ b/libexif/exif-entry.h
@@ -16,8 +16,8 @@
  *
  * You should have received a copy of the GNU Lesser General Public
  * License along with this library; if not, write to the
- * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- * Boston, MA 02111-1307, USA.
+ * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA  02110-1301  USA.
  */
 
 #ifndef __EXIF_ENTRY_H__
@@ -61,7 +61,7 @@ struct _ExifEntry {
         unsigned int size;
 
        /*! #ExifContent containing this entry. 
-        * \see #exif_entry_get_ifd */
+        * \see exif_entry_get_ifd */
        ExifContent *parent;
 
        /*! Internal data to be used by libexif itself */
@@ -130,7 +130,7 @@ void        exif_entry_initialize (ExifEntry *e, ExifTag tag);
  * valid. This may involve, for example, converting an EXIF_FORMAT_LONG into a
  * EXIF_FORMAT_SHORT. If the tag is unknown, its value is untouched.
  *
- * \note Unfortunately, some conversions are to a type with a more resticted
+ * \note Unfortunately, some conversions are to a type with a more restricted
  * range, which could have the side effect that the converted data becomes
  * invalid. This is unlikely as the range of each tag in the standard is
  * designed to encompass all likely data.
@@ -142,11 +142,18 @@ void        exif_entry_fix        (ExifEntry *entry);
 
 /* For your convenience */
 
-/*! Return a textual representation of the value of the EXIF entry.
+/*! Return a localized textual representation of the value of the EXIF entry.
+ * This is meant for display to the user. The format of each tag is subject
+ * to change between locales and in newer versions of libexif.  Users who
+ * require the tag data in an unambiguous form should access the data members
+ * of the #ExifEntry structure directly.
  *
  * \warning The character set of the returned string may be in
  *          the encoding of the current locale or the native encoding
  *          of the camera.
+ * \bug     The EXIF_TAG_XP_* tags are currently always returned in UTF-8,
+ *          regardless of locale, and code points above U+FFFF are not
+ *          supported.
  *
  * \param[in] entry EXIF entry
  * \param[out] val buffer in which to store value