i don't know if some API were added, but ifso, add @since 1.1 in the doxy 
doc

Vincent


On Thu, 18 Aug 2011, Enlightenment SVN wrote:

> Log:
> efreet: Add doc
>
> Author:       englebass
> Date:         2011-08-18 23:44:27 -0700 (Thu, 18 Aug 2011)
> New Revision: 62579
> Trac:         http://trac.enlightenment.org/e/changeset/62579
>
> Modified:
>  trunk/efreet/src/lib/efreet_desktop.h trunk/efreet/src/lib/efreet_icon.h
>
> Modified: trunk/efreet/src/lib/efreet_desktop.h
> ===================================================================
> --- trunk/efreet/src/lib/efreet_desktop.h     2011-08-19 06:44:16 UTC (rev 
> 62578)
> +++ trunk/efreet/src/lib/efreet_desktop.h     2011-08-19 06:44:27 UTC (rev 
> 62579)
> @@ -122,6 +122,11 @@
>  *
>  * By using efreet_desktop_get the Efreet_Desktop will be saved in an internal
>  * cache for quicker loading.
> + *
> + * Users of this command should listen to EFREET_EVENT_DESKTOP_CACHE_UPDATE
> + * event, if the application is to keep the reference. When the event fires
> + * the Efreet_Desktop struct should be invalidated and reloaded from a new
> + * cache file.
>  */
> EAPI Efreet_Desktop   *efreet_desktop_get(const char *file);
>
> @@ -145,6 +150,11 @@
>  * on failure
>  * @brief Gets a reference to an Efreet_Desktop structure representing the
>  * contents of @a file or NULL if @a file is not a valid .desktop file.
> + *
> + * Users of this command should listen to EFREET_EVENT_DESKTOP_CACHE_UPDATE
> + * event, if the application is to keep the reference. When the event fires
> + * the Efreet_Desktop struct should be invalidated and reloaded from a new
> + * cache file.
>  */
> EAPI Efreet_Desktop   *efreet_desktop_new(const char *file);
>
>
> Modified: trunk/efreet/src/lib/efreet_icon.h
> ===================================================================
> --- trunk/efreet/src/lib/efreet_icon.h        2011-08-19 06:44:16 UTC (rev 
> 62578)
> +++ trunk/efreet/src/lib/efreet_icon.h        2011-08-19 06:44:27 UTC (rev 
> 62579)
> @@ -213,6 +213,9 @@
>  * the list.
>  * @note This function will search the given theme for all icons before 
> falling
>  * back. This is useful when searching for mimetype icons.
> + *
> + * There is no guarantee for how long the pointer to the path will be valid.
> + * If the pointer is to be kept, the user must create a copy of the path.
>  */
> EAPI const char        *efreet_icon_list_find(const char *theme_name,
>                                                 Eina_List *icons,
> @@ -224,6 +227,9 @@
>  * @param size; The icon size to look for
>  * @return Returns the path to the given icon or NULL if none found
>  * @brief Retrives the path to the given icon.
> + *
> + * There is no guarantee for how long the pointer to the path will be valid.
> + * If the pointer is to be kept, the user must create a copy of the path.
>  */
> EAPI const char        *efreet_icon_path_find(const char *theme_name,
>                                                 const char *icon,
>
>
> ------------------------------------------------------------------------------
> Get a FREE DOWNLOAD! and learn more about uberSVN rich system,
> user administration capabilities and model configuration. Take
> the hassle out of deploying and managing Subversion and the
> tools developers use with it. http://p.sf.net/sfu/wandisco-d2d-2
> _______________________________________________
> enlightenment-svn mailing list
> enlightenment-...@lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/enlightenment-svn
>
>

------------------------------------------------------------------------------
EMC VNX: the world's simplest storage, starting under $10K
The only unified storage solution that offers unified management 
Up to 160% more powerful than alternatives and 25% more efficient. 
Guaranteed. http://p.sf.net/sfu/emc-vnx-dev2dev
_______________________________________________
enlightenment-devel mailing list
enlightenment-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/enlightenment-devel

Reply via email to