[Libosinfo] [libosinfo PATCH 20/20] Add "Since: 1.6.0" to the documentation

Fabiano Fidêncio fidencio at redhat.com
Mon Jul 15 13:01:58 UTC 2019


Let's add the "Since: ..." information as part of the function's
documentation. It helps developers reading our docs to easily figure out
when a function has been introduced.

Together with this change, documentation has been added to the functions
missing them.

Signed-off-by: Fabiano Fidêncio <fidencio at redhat.com>
---
 osinfo/osinfo_db.c    |  2 ++
 osinfo/osinfo_media.c | 10 +++++++++-
 osinfo/osinfo_media.h |  1 +
 3 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/osinfo/osinfo_db.c b/osinfo/osinfo_db.c
index a2fc8bc..b5cdb71 100644
--- a/osinfo/osinfo_db.c
+++ b/osinfo/osinfo_db.c
@@ -980,6 +980,8 @@ static void fill_tree(OsinfoDb *db, OsinfoTree *tree,
  * properties will be set.
  *
  * Returns: TRUE if @tree was found in @db, FALSE otherwise
+ *
+ * Since: 1.6.0
  */
 gboolean osinfo_db_identify_tree(OsinfoDb *db,
                                  OsinfoTree *tree)
diff --git a/osinfo/osinfo_media.c b/osinfo/osinfo_media.c
index ad21b78..cf624d2 100644
--- a/osinfo/osinfo_media.c
+++ b/osinfo/osinfo_media.c
@@ -777,6 +777,8 @@ OsinfoMedia *osinfo_media_create_from_location(const gchar *location,
  * NOTE: Currently this only works for ISO images/devices.
  *
  * Returns: (transfer full): a new #OsinfoMedia , or NULL on error
+ *
+ * Since: 1.6.0
  */
 OsinfoMedia *osinfo_media_create_from_location_with_flags(const gchar *location,
                                                           GCancellable *cancellable,
@@ -1349,6 +1351,8 @@ void osinfo_media_create_from_location_async(const gchar *location,
  * #osinfo_media_create_from_location_async.
  *
  * Returns: (transfer full): a new #OsinfoMedia , or NULL on error
+ *
+ * Since: 1.6.0
  */
 OsinfoMedia *osinfo_media_create_from_location_finish(GAsyncResult *res,
                                                       GError **error)
@@ -1365,7 +1369,9 @@ OsinfoMedia *osinfo_media_create_from_location_finish(GAsyncResult *res,
  * @flags: An #OsinfoMediaDetectFlag, or 0.
  * @user_data: The user data to pass to @callback, or %NULL
  *
- * Asynchronous variant of #osinfo_media_create_from_location.
+ * Asynchronous variant of #osinfo_media_create_from_location_with_flags.
+ *
+ * Since: 1.6.0
  */
 void osinfo_media_create_from_location_with_flags_async(const gchar *location,
                                                         gint priority,
@@ -1833,6 +1839,8 @@ OsinfoInstallScriptList *osinfo_media_get_install_script_list(OsinfoMedia *media
  * @media: and #OsinfoMedia instance
  *
  * Returns: #TRUE if the @media is bootable. #FALSE otherwise.
+ *
+ * Since: 1.6.0
  */
 gboolean osinfo_media_is_bootable(OsinfoMedia *media)
 {
diff --git a/osinfo/osinfo_media.h b/osinfo/osinfo_media.h
index fda5243..8eeb0e2 100644
--- a/osinfo/osinfo_media.h
+++ b/osinfo/osinfo_media.h
@@ -60,6 +60,7 @@ typedef enum {
 
 /**
  * OsinfoMediaDetectFlags
+ * Since: 1.6.0
  * OSINFO_MEDIA_DETECT_REQUIRE_BOOTABLE: Requires a media to be bootable.
  *
  * Flags used for detecting a media.
-- 
2.21.0




More information about the Libosinfo mailing list