[gexiv2] doc: Various fixes

[Jens Georg <jensgeorg src gnome org>]

commit d1bd551203c655fef9a2972ead1d0f9886a13877
Author: Jens Georg <mail jensge org>
Date:   Thu Nov 19 14:08:38 2020 +0100

    doc: Various fixes

 docs/reference/gexiv2-docs.xml     | 16 +++++++++++++---
 docs/reference/gexiv2-sections.txt | 18 ++++++++++++++++++
 docs/reference/gexiv2.types        |  6 ++++++
 gexiv2/gexiv2-metadata.h           | 12 +++++++++++-
 4 files changed, 48 insertions(+), 4 deletions(-)
---
diff --git a/docs/reference/gexiv2-docs.xml b/docs/reference/gexiv2-docs.xml
index b58f0e3..7facd8f 100644
--- a/docs/reference/gexiv2-docs.xml
+++ b/docs/reference/gexiv2-docs.xml
@@ -31,14 +31,24 @@
     <xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
   </index>
 
-  <index id="api-index-0-10-6" role="0.10.6">
+  <index id="api-index-0-10-6">
     <title>Index of new symbols in 0.10.6</title>
     <xi:include href="xml/api-index-0.10.6.xml"><xi:fallback /></xi:include>
   </index>
 
-  <index id="deprecated-api-index" role="deprecated">
+  <index id="api-index-0-12-1">
+    <title>Index of new symbols in 0.12.1</title>
+    <xi:include href="xml/api-index-0.12.1.xml"><xi:fallback /></xi:include>
+  </index>
+
+  <index id="api-index-0-12-2">
+    <title>Index of new symbols in 0.12.2</title>
+    <xi:include href="xml/api-index-0.12.2.xml"><xi:fallback /></xi:include>
+  </index>
+
+  <index id="api-index-deprecated">
     <title>Index of deprecated API</title>
-    <xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
+    <xi:include href="xml/api-index-deprecated.xml"></xi:include>
   </index>
   <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
 </book>
diff --git a/docs/reference/gexiv2-sections.txt b/docs/reference/gexiv2-sections.txt
index 0021f71..fdea472 100644
--- a/docs/reference/gexiv2-sections.txt
+++ b/docs/reference/gexiv2-sections.txt
@@ -8,6 +8,9 @@ gexiv2_log_get_handler
 gexiv2_log_get_default_handler
 gexiv2_log_set_handler
 gexiv2_log_use_glib_logging
+<SUBSECTION Standard>
+GEXIV2_TYPE_GEXIV2_LOG_LEVEL
+gexiv2_gexiv2_log_level_get_type
 </SECTION>
 
 <SECTION>
@@ -17,6 +20,7 @@ GExiv2Orientation
 GExiv2StructureType
 GExiv2XmpFormatFlags
 GExiv2Metadata
+GExiv2ByteOrder
 gexiv2_metadata_new
 gexiv2_metadata_free
 gexiv2_metadata_open_path
@@ -43,13 +47,17 @@ gexiv2_metadata_get_mime_type
 gexiv2_metadata_get_pixel_width
 gexiv2_metadata_get_pixel_height
 gexiv2_metadata_get_tag_string
+gexiv2_metadata_try_get_tag_string
 gexiv2_metadata_set_tag_string
+gexiv2_metadata_try_set_tag_string
 gexiv2_metadata_set_xmp_tag_struct
 gexiv2_metadata_get_tag_interpreted_string
 gexiv2_metadata_get_tag_long
 gexiv2_metadata_set_tag_long
 gexiv2_metadata_get_tag_multiple
+gexiv2_metadata_try_get_tag_multiple
 gexiv2_metadata_set_tag_multiple
+gexiv2_metadata_try_set_tag_multiple
 gexiv2_metadata_get_tag_raw
 gexiv2_metadata_has_exif
 gexiv2_metadata_clear_exif
@@ -57,6 +65,7 @@ gexiv2_metadata_get_exif_tags
 gexiv2_metadata_get_exif_tag_rational
 gexiv2_metadata_set_exif_tag_rational
 gexiv2_metadata_get_exif_thumbnail
+gexiv2_metadata_get_exif_data
 gexiv2_metadata_set_exif_thumbnail_from_file
 gexiv2_metadata_set_exif_thumbnail_from_buffer
 gexiv2_metadata_erase_exif_thumbnail
@@ -89,6 +98,7 @@ gexiv2_metadata_get_gps_latitude
 gexiv2_metadata_get_gps_altitude
 gexiv2_metadata_get_gps_info
 gexiv2_metadata_set_gps_info
+gexiv2_metadata_update_gps_info
 gexiv2_metadata_delete_gps_info
 gexiv2_metadata_get_preview_properties
 gexiv2_metadata_get_preview_image
@@ -113,6 +123,14 @@ GEXIV2_TYPE_METADATA
 GExiv2MetadataClass
 GExiv2MetadataPrivate
 gexiv2_metadata_get_type
+GEXIV2_TYPE_GEXIV2_BYTE_ORDER
+GEXIV2_TYPE_GEXIV2_ORIENTATION
+GEXIV2_TYPE_GEXIV2_XMP_FORMAT_FLAGS
+GEXIV2_TYPE_GEXIV2_STRUCTURE_TYPE
+gexiv2_gexiv2_byte_order_get_type
+gexiv2_gexiv2_orientation_get_type
+gexiv2_gexiv2_structure_type_get_type
+gexiv2_gexiv2_xmp_format_flags_get_type
 </SECTION>
 
 <SECTION>
diff --git a/docs/reference/gexiv2.types b/docs/reference/gexiv2.types
index 786c1d4..fd91292 100644
--- a/docs/reference/gexiv2.types
+++ b/docs/reference/gexiv2.types
@@ -1,3 +1,9 @@
 gexiv2_metadata_get_type
 gexiv2_preview_image_get_type
 gexiv2_preview_properties_get_type
+gexiv2_gexiv2_byte_order_get_type
+gexiv2_gexiv2_log_level_get_type
+gexiv2_gexiv2_orientation_get_type
+gexiv2_gexiv2_structure_type_get_type
+gexiv2_gexiv2_xmp_format_flags_get_type
+
diff --git a/gexiv2/gexiv2-metadata.h b/gexiv2/gexiv2-metadata.h
index 5609cf8..9b26f4c 100644
--- a/gexiv2/gexiv2-metadata.h
+++ b/gexiv2/gexiv2-metadata.h
@@ -493,11 +493,13 @@ gint                      gexiv2_metadata_get_pixel_height        (GExiv2Metadata 
*self);
  * gexiv2_metadata_try_get_tag_string:
  * @self: An instance of #GExiv2Metadata
  * @tag: Exiv2 tag name
- * @error: (allow-none): A return location for a #GError or %nullptr
+ * @error: (allow-none): A return location for a #GError or %NULL
  *
  * The Exiv2 Tag Reference can be found at <ulink url="http://exiv2.org/metadata.html";></ulink>
  *
  * Returns: (transfer full) (allow-none): The tag's value as a string
+ *
+ * Since: 0.12.2
  */
 gchar*                 gexiv2_metadata_try_get_tag_string      (GExiv2Metadata *self, const gchar* tag, 
GError **error);
 
@@ -511,6 +513,8 @@ gchar*                      gexiv2_metadata_try_get_tag_string      (GExiv2Metadata 
*self, const gchar*
  * The Exiv2 Tag Reference can be found at <ulink url="http://exiv2.org/metadata.html";></ulink>
  *
  * Returns: TRUE on success
+ *
+ * Since: 0.12.2
  */
 gboolean               gexiv2_metadata_try_set_tag_string      (GExiv2Metadata *self, const gchar* tag, 
const gchar* value, GError **error);
 
@@ -611,6 +615,8 @@ gboolean            gexiv2_metadata_set_tag_long            (GExiv2Metadata *self, const 
gchar* tag,
  *
  * Returns: (transfer full) (allow-none) (array zero-terminated=1): The multiple string values of
  * the tag
+ *
+ * Since: 0.12.2
  */
 gchar**                        gexiv2_metadata_try_get_tag_multiple    (GExiv2Metadata *self, const gchar* 
tag, GError **error);
 
@@ -624,6 +630,8 @@ gchar**                     gexiv2_metadata_try_get_tag_multiple    (GExiv2Metadata 
*self, const gcha
  * The Exiv2 Tag Reference can be found at <ulink url="http://exiv2.org/metadata.html";></ulink>
  *
  * Returns: Boolean success value
+ *
+ * Since: 0.12.2
  */
 gboolean               gexiv2_metadata_try_set_tag_multiple    (GExiv2Metadata *self, const gchar* tag, 
const gchar** values, GError **error);
 
@@ -782,6 +790,7 @@ void                        gexiv2_metadata_erase_exif_thumbnail (GExiv2Metadata *self);
  * @error: (allow-none): A return location for a #GError or %NULL
  *
  * Returns: (transfer full) (allow-none): The content of the EXIF data or %NULL on error
+ *
  * Since: 0.12.2
  */
 GBytes *        gexiv2_metadata_get_exif_data (GExiv2Metadata *self, GExiv2ByteOrder byte_order, GError 
**error);
@@ -1120,6 +1129,7 @@ gboolean          gexiv2_metadata_set_gps_info                            
(GExiv2Metadata *self, gdouble longitu
  * Convenience function to update longitude, latitude and altitude at once.
  *
  * Returns: (skip): Boolean success value.
+ *
  * Since: 0.12.1
  */
 gboolean               gexiv2_metadata_update_gps_info                         (GExiv2Metadata *self, 
gdouble longitude, gdouble latitude, gdouble altitude);