From 4aeb30cc5427defecae5c4435a8656504cfdcc8e Mon Sep 17 00:00:00 2001 From: raster Date: Tue, 6 Mar 2012 12:24:20 +0000 Subject: [PATCH] address the XXX for elm entry with some docs - but its otherwise not going to be addressed i think. git-svn-id: svn+ssh://svn.enlightenment.org/var/svn/e/trunk/elementary@68819 7cbeb6ba-43b4-40fd-8cce-4c39aea84d33 --- src/lib/elm_entry.h | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/src/lib/elm_entry.h b/src/lib/elm_entry.h index 81b296b..e74c36c 100644 --- a/src/lib/elm_entry.h +++ b/src/lib/elm_entry.h @@ -253,8 +253,6 @@ typedef enum ELM_TEXT_FORMAT_MARKUP_UTF8 /**< Markup UTF8 type */ } Elm_Text_Format; -/* XXX: Filter_Limit_Size and Filter_Accept_Set are awful in my pov. The API looks bad. */ - /** * @enum _Elm_Wrap_Type * @typedef Elm_Wrap_Type @@ -1365,7 +1363,9 @@ struct _Elm_Entry_Filter_Limit_Size * it as data when setting the filter. In it, it's possible to set limits * by character count or bytes (any of them is disabled if 0), and both can * be set at the same time. In that case, it first checks for characters, - * then bytes. + * then bytes. The #Elm_Entry_Filter_Limit_Size structure must be alive and + * valid for as long as the entyr is alive AND the elm_entry_filter_limit_size + * filter is set. * * The function will cut the inserted text in order to allow only the first * number of characters that are still allowed. The cut is made in @@ -1401,7 +1401,8 @@ struct _Elm_Entry_Filter_Accept_Set * Add this filter to an entry to restrict the set of accepted characters * based on the sets in the provided #Elm_Entry_Filter_Accept_Set. * This structure contains both accepted and rejected sets, but they are - * mutually exclusive. + * mutually exclusive. This structure must be available for as long as + * the entry is alive AND the elm_entry_filter_accept_set is being used. * * The @c accepted set takes preference, so if it is set, the filter will * only work based on the accepted characters, ignoring anything in the -- 2.7.4