[Libosinfo] [libosinfo 2/2] Small improvements to API doc
Fabiano Fidêncio
fabiano at fidencio.org
Wed Dec 19 10:23:07 UTC 2012
On Wed, Dec 19, 2012 at 8:14 AM, Christophe Fergeau <cfergeau at redhat.com> wrote:
> Improve the (short) description of the OsinfoInstallConfigParam and
> OsinfoInstallScript classes.
ACK!
> ---
> osinfo/osinfo_install_config_param.c | 8 +++++---
> osinfo/osinfo_install_script.c | 11 ++++++-----
> 2 files changed, 11 insertions(+), 8 deletions(-)
>
> diff --git a/osinfo/osinfo_install_config_param.c b/osinfo/osinfo_install_config_param.c
> index 7876d20..98d0ab1 100644
> --- a/osinfo/osinfo_install_config_param.c
> +++ b/osinfo/osinfo_install_config_param.c
> @@ -34,11 +34,13 @@ G_DEFINE_TYPE (OsinfoInstallConfigParam, osinfo_install_config_param, OSINFO_TYP
> /**
> * SECTION:osinfo_install_config_param
> * @short_description: OS install configuration parameters (and its policies)
> - * @see_also: #OsinfoInstallScript, #OsinfoInstallSciptConfig
> + * @see_also: #OsinfoInstallScript, #OsinfoInstallConfig
> *
> - * #OsinfoInstallConfigParam is an entity for representing all parameters that
> + * #OsinfoInstallConfigParam is an entity for describing all parameters that
> * can be set in an automated installation. It is used to help applications to
> - * generate an automated installation script
> + * generate an automated installation script. The actual parameter values
> + * for an #OsinfoInstallScript must be set using an #OsinfoInstallConfig
> + * object.
> */
>
> enum {
> diff --git a/osinfo/osinfo_install_script.c b/osinfo/osinfo_install_script.c
> index 2229843..df37957 100644
> --- a/osinfo/osinfo_install_script.c
> +++ b/osinfo/osinfo_install_script.c
> @@ -38,12 +38,13 @@ G_DEFINE_TYPE (OsinfoInstallScript, osinfo_install_script, OSINFO_TYPE_ENTITY);
>
> /**
> * SECTION:osinfo_install_script
> - * @short_description: OS install scripturation
> - * @see_also: #OsinfoInstallScript
> + * @short_description: OS install script generation
> + * @see_also: #OsinfoInstallConfig
> *
> - * #OsinfoInstallScript is an object for representing OS
> - * install scripturation data. It is used to generate an
> - * automated installation script
> + * #OsinfoInstallScript is an object used to generate an
> + * automated installation script for an OS. The OS
> + * configuration data (language, keyboard, timezone, ...)
> + * comes from an #OsinfoInstallConfig object.
> */
>
> struct _OsinfoInstallScriptPrivate
> --
> 1.8.0.2
>
> _______________________________________________
> Libosinfo mailing list
> Libosinfo at redhat.com
> https://www.redhat.com/mailman/listinfo/libosinfo
--
Fabiano Fidêncio
More information about the Libosinfo
mailing list