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@xxxxxxxxxx>
---
osinfo/osinfo_avatar_format.c | 2 ++
osinfo/osinfo_install_config.c | 45 ++++++++++++++++++++++++++++
osinfo/osinfo_install_config_param.c | 11 +++++++
osinfo/osinfo_install_script.c | 8 +++++
osinfo/osinfo_loader.c | 22 +++++++++++++-
osinfo/osinfo_product.c | 40 +++++++++++++++++++++++++
6 files changed, 127 insertions(+), 1 deletion(-)
diff --git a/osinfo/osinfo_avatar_format.c b/osinfo/osinfo_avatar_format.c
index ade4d09..3580e81 100644
--- a/osinfo/osinfo_avatar_format.c
+++ b/osinfo/osinfo_avatar_format.c
@@ -175,6 +175,8 @@ osinfo_avatar_format_init(OsinfoAvatarFormat *avatar)
*
* Returns: (transfer full): the necessary information to create an avatar for
* an user
+ *
+ * Since: 0.2.8
*/
OsinfoAvatarFormat *
osinfo_avatar_format_new(void)
diff --git a/osinfo/osinfo_install_config.c b/osinfo/osinfo_install_config.c
index 2bd5e4b..3d072d9 100644
--- a/osinfo/osinfo_install_config.c
+++ b/osinfo/osinfo_install_config.c
@@ -135,6 +135,15 @@ void osinfo_install_config_set_hardware_arch(OsinfoInstallConfig *config,
}
+/**
+ * osinfo_install_config_get_hardware_arch:
+ * @config: the install config
+ *
+ * Returns: The value of #OSINFO_INSTALL_CONFIG_PROP_HARDWARE_ARCH parameter,
+ * or NULL.
+ *
+ * Since: 0.2.8
+ */
const gchar *osinfo_install_config_get_hardware_arch(OsinfoInstallConfig *config)
{
return osinfo_entity_get_param_value(OSINFO_ENTITY(config),
@@ -476,6 +485,15 @@ void osinfo_install_config_set_reg_login(OsinfoInstallConfig *config,
name);
}
+/**
+ * osinfo_install_config_get_reg_login:
+ * @config: the install config
+ *
+ * Returns: The value of #OSINFO_INSTALL_CONFIG_PROP_REG_LOGIN paramater,
+ * or NULL.
+ *
+ * Since: 0.2.8
+ */
const gchar *osinfo_install_config_get_reg_login(OsinfoInstallConfig *config)
{
return osinfo_entity_get_param_value(OSINFO_ENTITY(config),
@@ -500,6 +518,15 @@ void osinfo_install_config_set_reg_password(OsinfoInstallConfig *config,
password);
}
+/**
+ * osinfo_install_config_get_reg_password:
+ * @config: the install config
+ *
+ * Returns: The value of #OSINFO_INSTALL_CONFIG_PROP_REG_PASSWORD paramater,
+ * or NULL.
+ *
+ * Since: 0.2.8
+ */
const gchar *osinfo_install_config_get_reg_password(OsinfoInstallConfig *config)
{
return osinfo_entity_get_param_value(OSINFO_ENTITY(config),
@@ -524,6 +551,15 @@ void osinfo_install_config_set_reg_product_key(OsinfoInstallConfig *config,
key);
}
+/**
+ * osinfo_install_config_get_reg_product_key:
+ * @config: the install config
+ *
+ * Returns: The value of #OSINFO_INSTALL_CONFIG_PROP_REG_PRODUCTKEY paramater,
+ * or NULL.
+ *
+ * Since: 0.2.8
+ */
const gchar *osinfo_install_config_get_reg_product_key(OsinfoInstallConfig *config)
{
return osinfo_entity_get_param_value(OSINFO_ENTITY(config),
@@ -554,6 +590,15 @@ void osinfo_install_config_set_hostname(OsinfoInstallConfig *config,
hostname);
}
+/**
+ * osinfo_install_config_get_hostname:
+ * @config: the install config
+ *
+ * Returns: The value of #OSINFO_INSTALL_CONFIG_PROP_HOSTNAME parameter,
+ * or NULL.
+ *
+ * Since: 0.2.8
+ */
const gchar *osinfo_install_config_get_hostname(OsinfoInstallConfig *config)
{
return osinfo_entity_get_param_value(OSINFO_ENTITY(config),
diff --git a/osinfo/osinfo_install_config_param.c b/osinfo/osinfo_install_config_param.c
index ab854b3..13fa088 100644
--- a/osinfo/osinfo_install_config_param.c
+++ b/osinfo/osinfo_install_config_param.c
@@ -277,6 +277,15 @@ gboolean osinfo_install_config_param_is_optional(OsinfoInstallConfigParam *confi
OSINFO_INSTALL_CONFIG_PARAM_POLICY_OPTIONAL);
}
+/**
+ * osinfo_install_config_get_value_map:
+ * @config_param: the configuration parameter
+ *
+ * Returns: (transfer none): The data map used to transform values set for this
+ * parameter to OS-specific values, or NULL.
+ *
+ * Since: 0.2.8
+ */
OsinfoDatamap *osinfo_install_config_param_get_value_map(OsinfoInstallConfigParam *config_param)
{
return config_param->priv->value_map;
@@ -291,6 +300,8 @@ OsinfoDatamap *osinfo_install_config_param_get_value_map(OsinfoInstallConfigPara
* After a call to osinfo_install_config_param_set_value_map(), @datamap will
* be used to transform values set for this parameter to OS-specific
* values. A NULL @datamap will disable transformations.
+ *
+ * Since: 0.2.8
*/
void osinfo_install_config_param_set_value_map(OsinfoInstallConfigParam *config_param, OsinfoDatamap *datamap)
{
diff --git a/osinfo/osinfo_install_script.c b/osinfo/osinfo_install_script.c
index d9a0ee7..173e9c6 100644
--- a/osinfo/osinfo_install_script.c
+++ b/osinfo/osinfo_install_script.c
@@ -581,6 +581,14 @@ void osinfo_install_script_set_output_prefix(OsinfoInstallScript *script,
NULL);
}
+/**
+ * osinfo_install_script_get_output_prefix:
+ * @script: the install script
+ *
+ * Returns: the prefix of the file generated
+ *
+ * Since: 0.2.8
+ */
const gchar *osinfo_install_script_get_output_prefix(OsinfoInstallScript *script)
{
return script->priv->output_prefix;
diff --git a/osinfo/osinfo_loader.c b/osinfo/osinfo_loader.c
index 7735357..6d1c801 100644
--- a/osinfo/osinfo_loader.c
+++ b/osinfo/osinfo_loader.c
@@ -2603,7 +2603,9 @@ void osinfo_loader_process_default_path(OsinfoLoader *loader, GError **err)
* @loader: the loader object
* @err: (out): filled with error information upon failure
*
- * Loads data from the default paths.
+ * Loads data from the system path.
+ *
+ * Since: 0.2.8
*/
void osinfo_loader_process_system_path(OsinfoLoader *loader,
GError **err)
@@ -2621,6 +2623,15 @@ void osinfo_loader_process_system_path(OsinfoLoader *loader,
g_object_unref(dirs[2]);
}
+/**
+ * osinfo_loader_process_local_path:
+ * @loader: the loader object
+ * @err: (out): filled with error information upen failures
+ *
+ * Loads data from the local path.
+ *
+ * Since: 0.2.8
+ */
void osinfo_loader_process_local_path(OsinfoLoader *loader, GError **err)
{
GFile *dirs[] = {
@@ -2632,6 +2643,15 @@ void osinfo_loader_process_local_path(OsinfoLoader *loader, GError **err)
g_object_unref(dirs[0]);
}
+/**
+ * osinfo_loader_process_user_path:
+ * @loader: the loader object
+ * @err: (out): filled with error information upen failures
+ *
+ * Loads data from user path.
+ *
+ * Since: 0.2.8
+ */
void osinfo_loader_process_user_path(OsinfoLoader *loader, GError **err)
{
GFile *dirs[] = {
diff --git a/osinfo/osinfo_product.c b/osinfo/osinfo_product.c
index a598312..dbb7402 100644
--- a/osinfo/osinfo_product.c
+++ b/osinfo/osinfo_product.c
@@ -315,16 +315,38 @@ const gchar *osinfo_product_get_name(OsinfoProduct *prod)
return osinfo_entity_get_param_value(OSINFO_ENTITY(prod), OSINFO_PRODUCT_PROP_NAME);
}
+/**
+ * osinfo_product_get_codename:
+ * @product: an product
+ *
+ * Returns: The product's codename, or NULL.
+ */
const gchar *osinfo_product_get_codename(OsinfoProduct *prod)
{
return osinfo_entity_get_param_value(OSINFO_ENTITY(prod), OSINFO_PRODUCT_PROP_CODENAME);
}
+/**
+ * osinfo_product_get_release_date_string:
+ * @product: an product
+ *
+ * Returns: A string representing the product's release date, or NULL.
+ *
+ * Since: 0.2.8
+ */
const gchar *osinfo_product_get_release_date_string(OsinfoProduct *prod)
{
return osinfo_entity_get_param_value(OSINFO_ENTITY(prod), OSINFO_PRODUCT_PROP_RELEASE_DATE);
}
+/**
+ * osinfo_product_get_eol_date_string:
+ * @product: an product
+ *
+ * Returns: A string representing the product's EOL date, or NULL.
+ *
+ * Since: 0.2.8
+ */
const gchar *osinfo_product_get_eol_date_string(OsinfoProduct *prod)
{
return osinfo_entity_get_param_value(OSINFO_ENTITY(prod), OSINFO_PRODUCT_PROP_EOL_DATE);
@@ -344,6 +366,15 @@ static GDate *date_from_string(const gchar *str)
return g_date_new_dmy(d, m, y);
}
+/**
+ * osinfo_product_get_release_date:
+ * @product: an product
+ *
+ * Returns: (transfer full): A #GDate representing the product's release date,
+ * or NULL.
+ *
+ * Since: 0.2.8
+ */
GDate *osinfo_product_get_release_date(OsinfoProduct *prod)
{
const gchar *str = osinfo_product_get_release_date_string(prod);
@@ -354,6 +385,15 @@ GDate *osinfo_product_get_release_date(OsinfoProduct *prod)
}
+/**
+ * osinfo_product_get_eol_date:
+ * @product: an product
+ *
+ * Returns: (transfer full): A #GDate representing the product's EOL date,
+ * or NULL.
+ *
+ * Since: 0.2.8
+ */
GDate *osinfo_product_get_eol_date(OsinfoProduct *prod)
{
const gchar *str = osinfo_product_get_eol_date_string(prod);
--
2.21.0
_______________________________________________
Libosinfo mailing list
Libosinfo@xxxxxxxxxx
https://www.redhat.com/mailman/listinfo/libosinfo
