[virt-tools-list] [PATCH 4/4] Document even more arguments
Michal Privoznik
mprivozn at redhat.com
Fri Dec 7 13:22:15 UTC 2012
These files were still missing function arguments description:
* osinfo/osinfo_install_script.c
* osinfo/osinfo_os.c
---
osinfo/osinfo_install_script.c | 14 ++++++++++++++
osinfo/osinfo_os.c | 1 +
2 files changed, 15 insertions(+), 0 deletions(-)
diff --git a/osinfo/osinfo_install_script.c b/osinfo/osinfo_install_script.c
index b891aaf..9d5abf4 100644
--- a/osinfo/osinfo_install_script.c
+++ b/osinfo/osinfo_install_script.c
@@ -296,6 +296,8 @@ GList *osinfo_install_script_get_config_param_list(const OsinfoInstallScript *sc
/**
* osinfo_install_script_get_config_param:
+ * @script: the install script
+ * @name: name of the parameter
*
* Get a config param from the config param's list
*
@@ -337,6 +339,9 @@ OsinfoInstallScript *osinfo_install_script_new(const gchar *id)
/**
* osinfo_install_script_new_data:
+ * @id: a unique identifier
+ * @profile: the profile of script
+ * @templateData: style sheet data
*
* Construct a new install script from stylesheet data
*
@@ -356,6 +361,9 @@ OsinfoInstallScript *osinfo_install_script_new_data(const gchar *id,
/**
* osinfo_install_script_new_uri:
+ * @id: a unique identifier
+ * @profile: the profile of script
+ * @templateUri: style sheet URI
*
* Construct a new install script from a stylesheet URI
*
@@ -393,6 +401,7 @@ const gchar *osinfo_install_script_get_profile(OsinfoInstallScript *script)
/**
* osinfo_install_script_get_product_key_format:
+ * @script: the install script
*
* If this function returns a non-NULL string, it means that the @script
* requires you to specify product registration key through #OsinfoInstallConfig
@@ -444,6 +453,7 @@ const gchar *osinfo_install_script_get_output_prefix(OsinfoInstallScript *script
/**
* osinfo_install_script_get_expected_filename:
+ * @script: the install script
*
* Some operating systems (as Windows) expect that script filename has
* particular name to work.
@@ -458,6 +468,7 @@ const gchar *osinfo_install_script_get_expected_filename(OsinfoInstallScript *sc
/**
* osinfo_install_script_get_output_filename:
+ * @script: the install script
*
* Some operating systems are able to use any script filename, allowing the
* application to set the filename as desired. libosinfo provides this
@@ -488,6 +499,7 @@ osinfo_install_script_set_avatar_format(OsinfoInstallScript *script,
/**
* osinfo_install_script_get_avatar_format
+ * @script: the install script
*
* Some install scripts have restrictions on the format of the user avatar. Use
* this method to retrieve those restrictions in the form of an
@@ -1057,6 +1069,8 @@ void osinfo_install_script_generate_output_async(OsinfoInstallScript *script,
* @config: the install script config
* @output_dir: the directory where file containing the output script
* will be written
+ * @cancellable: (allow-none): a #GCancellable, or %NULL
+ * @error: The location where to store any error, or %NULL
*
* Creates a install script written in a file
*
diff --git a/osinfo/osinfo_os.c b/osinfo/osinfo_os.c
index b91c4d9..89b941f 100644
--- a/osinfo/osinfo_os.c
+++ b/osinfo/osinfo_os.c
@@ -559,6 +559,7 @@ OsinfoInstallScript *osinfo_os_find_install_script(OsinfoOs *os, const gchar *pr
/**
* osinfo_os_get_install_script_list:
+ * @os: an operating system
*
* Returns: (transfer full): a list of the install scripts for the specified os
*/
--
1.7.8.6
More information about the virt-tools-list
mailing list