*
* 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__
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 */
/* 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