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