diff -r 48f85579cc4c -r 8e2b68c79fa1 pidgin/gtkconv-theme.h --- a/pidgin/gtkconv-theme.h Wed Jan 29 00:28:08 2014 +0530 +++ b/pidgin/gtkconv-theme.h Wed Jan 29 05:28:33 2014 +0530 @@ -91,9 +91,9 @@ /** * Get the Info.plist hash table from a conversation theme. * - * @param theme The conversation theme + * @theme: The conversation theme * - * @return The hash table. Keys are strings as outlined for message styles, + * Returns: The hash table. Keys are strings as outlined for message styles, * values are GValue*s. This is an internal structure. Take a ref if * necessary, but don't destroy it yourself. */ @@ -102,8 +102,8 @@ /** * Set the Info.plist hash table for a conversation theme. * - * @param theme The conversation theme - * @param info The new hash table. The theme will take ownership of this hash + * @theme: The conversation theme + * @info: The new hash table. The theme will take ownership of this hash * table. Do not use it yourself afterwards with holding a ref. * For key and value specifications, @see pidgin_conversation_theme_get_info. * @@ -113,11 +113,11 @@ /** * Lookup a key in a theme * - * @param theme The conversation theme - * @param key The key to find - * @param specific Whether to search variant-specific keys + * @theme: The conversation theme + * @key: The key to find + * @specific: Whether to search variant-specific keys * - * @return The key information. If @a specific is @c TRUE, then keys are first + * Returns: The key information. If @a specific is @c TRUE, then keys are first * searched by variant, then by general ones. Otherwise, only general * key values are returned. */ @@ -126,10 +126,10 @@ /** * Get the template data from a conversation theme. * - * @param theme The conversation theme - * @param type The type of template data + * @theme: The conversation theme + * @type: The type of template data * - * @return The template data requested. Fallback is made as required by styles. + * Returns: The template data requested. Fallback is made as required by styles. * Subsequent calls to this function will return cached values. */ const char *pidgin_conversation_theme_get_template(PidginConvTheme *theme, PidginConvThemeTemplateType type); @@ -137,8 +137,8 @@ /** * Add an available variant name to a conversation theme. * - * @param theme The conversation theme - * @param variant The name of the variant + * @theme: The conversation theme + * @variant: The name of the variant * * @Note The conversation theme will take ownership of the variant name string. * This function should normally only be called by the theme loader. @@ -148,17 +148,17 @@ /** * Get the currently set variant name for a conversation theme. * - * @param theme The conversation theme + * @theme: The conversation theme * - * @return The current variant name. + * Returns: The current variant name. */ const char *pidgin_conversation_theme_get_variant(PidginConvTheme *theme); /** * Set the variant name for a conversation theme. * - * @param theme The conversation theme - * @param variant The name of the variant + * @theme: The conversation theme + * @variant: The name of the variant * */ void pidgin_conversation_theme_set_variant(PidginConvTheme *theme, const char *variant); @@ -166,9 +166,9 @@ /** * Get a list of available variants for a conversation theme. * - * @param theme The conversation theme + * @theme: The conversation theme * - * @return The list of variants. This GList and the string data are owned by + * Returns: The list of variants. This GList and the string data are owned by * the theme and should not be freed by the caller. */ const GList *pidgin_conversation_theme_get_variants(PidginConvTheme *theme); @@ -176,27 +176,27 @@ /** * Get the path to the template HTML file. * - * @param theme The conversation theme + * @theme: The conversation theme * - * @return The path to the HTML file. + * Returns: The path to the HTML file. */ char *pidgin_conversation_theme_get_template_path(PidginConvTheme *theme); /** * Get the path to the current variant CSS file. * - * @param theme The conversation theme + * @theme: The conversation theme * - * @return The path to the CSS file. + * Returns: The path to the CSS file. */ char *pidgin_conversation_theme_get_css_path(PidginConvTheme *theme); /** * Get (and reference) the array of nick colors * - * @param theme The conversation theme + * @theme: The conversation theme * - * @return Pointer to GArray of nick colors, or NULL if no colors in theme + * Returns: Pointer to GArray of nick colors, or NULL if no colors in theme */ GArray *pidgin_conversation_theme_get_nick_colors(PidginConvTheme *theme);