From 4ffc6d92c0a360c62d06ac604433c7e9298c8d79 Mon Sep 17 00:00:00 2001 From: Daniel Kolesa Date: Mon, 22 Sep 2014 13:16:57 +0100 Subject: [PATCH] eolian: update docs --- src/lib/eolian/Eolian.h | 23 +++++++++++++---------- 1 file changed, 13 insertions(+), 10 deletions(-) diff --git a/src/lib/eolian/Eolian.h b/src/lib/eolian/Eolian.h index 8197fa3..8e5e997 100644 --- a/src/lib/eolian/Eolian.h +++ b/src/lib/eolian/Eolian.h @@ -728,14 +728,16 @@ EAPI Eolian_Object_Scope eolian_function_scope_get(const Eolian_Function *functi EAPI Eina_Stringshare *eolian_function_name_get(const Eolian_Function *function_id); /* - * @brief Returns the full C name of a function (with prefix). It's here - * because the C API names are deduplicated (prefix of function and suffix - * of prefix merge if applicable) and this helps generators not write the - * same code over and over. + * @brief Returns the full C name of a function (with prefix). * * @param[in] function_id Id of the function * @return the function name * + * It's here because the C API names are deduplicated (prefix of function and + * suffix of prefix merge if applicable) and this helps generators not write + * the same code over and over. + * Also, you're responsible for deleting the stringshare. + * * @ingroup Eolian */ EAPI Eina_Stringshare *eolian_function_full_c_name_get(const Eolian_Function *function_id, const char *prefix); @@ -1541,6 +1543,7 @@ EAPI Eina_Bool eolian_type_is_extern(const Eolian_Type *tp); * alias types. Alias types are turned into C typedefs. * * Keep in mind that if @c name is NULL, the name won't be included. + * Also, you're responsible for deleting the stringshare. * * @see eolian_type_c_type_get * @@ -1557,6 +1560,7 @@ EAPI Eina_Stringshare *eolian_type_c_type_named_get(const Eolian_Type *tp, const * This behaves exactly like eolian_type_c_type_named_get when name is NULL. * Keep in mind that this is not useful for function types as a function * pointer type in C cannot be used without a name. + * Also, you're responsible for deleting the stringshare. * * @see eolian_type_c_type_named_get * @@ -1565,12 +1569,11 @@ EAPI Eina_Stringshare *eolian_type_c_type_named_get(const Eolian_Type *tp, const EAPI Eina_Stringshare *eolian_type_c_type_get(const Eolian_Type *tp); /* - * @brief Get the name of the given type. You have to manually delete - * the stringshare. For regular or complex types, this is for example "int". - * For EOLIAN_TYPE_STRUCT, EOLIAN_TYPE_STRUCT_OPAQUE and EOLIAN_TYPE_ALIAS, - * this is the name of the alias or of the struct. For EOLIAN_TYPE_CLASS, this - * can be "Button". Keep in mind that the name doesn't include namespaces for - * structs and aliases. + * @brief Get the name of the given type. For regular or complex types, this + * is for example "int". For EOLIAN_TYPE_STRUCT, EOLIAN_TYPE_STRUCT_OPAQUE and + * EOLIAN_TYPE_ALIAS, this is the name of the alias or of the struct. For + * EOLIAN_TYPE_CLASS, this can be "Button". Keep in mind that the name doesn't + * include namespaces for structs and aliases. * * @param[in] tp the type. * @return the name. -- 2.7.4