Sync documentation in Elementary.h
authorMike McCormack <mj.mccormack@samsung.com>
Fri, 4 Nov 2011 00:11:18 +0000 (09:11 +0900)
committerMike McCormack <mj.mccormack@samsung.com>
Fri, 4 Nov 2011 00:11:18 +0000 (09:11 +0900)
src/lib/Elementary.h.in

index cf1fb33..8a0a23a 100644 (file)
@@ -912,7 +912,7 @@ extern "C" {
    EAPI Eina_Bool    elm_policy_set(unsigned int policy, int value);
 
    /**
-    * Gets the policy value set for given policy identifier.
+    * Gets the policy value for given policy identifier.
     *
     * @param policy policy identifier, as in #Elm_Policy.
     * @return The currently set policy value, for that
@@ -923,6 +923,27 @@ extern "C" {
    EAPI int          elm_policy_get(unsigned int policy);
 
    /**
+    * Change the language of the current application
+    *
+    * The @p lang passed must be the full name of the locale to use, for
+    * example "en_US.utf8" or "es_ES@euro".
+    *
+    * Changing language with this function will make Elementary run through
+    * all its widgets, translating strings set with
+    * elm_object_domain_translatable_text_part_set(). This way, an entire
+    * UI can have its language changed without having to restart the program.
+    *
+    * For more complex cases, like having formatted strings that need
+    * translation, widgets will also emit a "language,changed" signal that
+    * the user can listen to to manually translate the text.
+    *
+    * @param lang Language to set, must be the full name of the locale
+    *
+    * @ingroup General
+    */
+   EAPI void         elm_language_set(const char *lang);
+
+   /**
     * Set a label of an object
     *
     * @param obj The Elementary object
@@ -1022,7 +1043,7 @@ extern "C" {
     *
     * @ingroup General
     */
-   EAPI Evas_Object *elm_object_item_content_part_get(const Elm_Object_Item *it, const char *item);
+   EAPI Evas_Object *elm_object_item_content_part_get(const Elm_Object_Item *it, const char *part);
 
 #define elm_object_item_content_get(it) elm_object_item_content_part_get((it), NULL)
 
@@ -1041,7 +1062,7 @@ extern "C" {
 #define elm_object_item_content_unset(it, content) elm_object_item_content_part_unset((it), (content))
 
    /**
-    * Set a label of an objec itemt
+    * Set a label of an object item
     *
     * @param it The Elementary object item
     * @param part The text part name to set (NULL for the default label)
@@ -1056,7 +1077,7 @@ extern "C" {
 #define elm_object_item_text_set(it, label) elm_object_item_text_part_set((it), NULL, (label))
 
    /**
-    * Get a label of an object
+    * Get a label of an object item
     *
     * @param it The Elementary object item
     * @param part The text part name to get (NULL for the default label)
@@ -1068,6 +1089,8 @@ extern "C" {
     */
    EAPI const char *elm_object_item_text_part_get(const Elm_Object_Item *it, const char *part);
 
+#define elm_object_item_text_get(it) elm_object_item_text_part_get((it), NULL)
+
    /**
     * Set the text to read out when in accessibility mode
     *
@@ -1088,9 +1111,6 @@ extern "C" {
     */
    EAPI void elm_object_item_access_info_set(Elm_Object_Item *it, const char *txt);
 
-
-#define elm_object_item_text_get(it) elm_object_item_text_part_get((it), NULL)
-
    /**
     * Get the data associated with an object item
     * @param it The object item
@@ -1127,28 +1147,250 @@ extern "C" {
     * @}
     */
 
+   /**
+    * @defgroup Caches Caches
+    *
+    * These are functions which let one fine-tune some cache values for
+    * Elementary applications, thus allowing for performance adjustments.
+    *
+    * @{
+    */
+
+   /**
+    * @brief Flush all caches.
+    *
+    * Frees all data that was in cache and is not currently being used to reduce
+    * memory usage. This frees Edje's, Evas' and Eet's cache. This is equivalent
+    * to calling all of the following functions:
+    * @li edje_file_cache_flush()
+    * @li edje_collection_cache_flush()
+    * @li eet_clearcache()
+    * @li evas_image_cache_flush()
+    * @li evas_font_cache_flush()
+    * @li evas_render_dump()
+    * @note Evas caches are flushed for every canvas associated with a window.
+    *
+    * @ingroup Caches
+    */
    EAPI void         elm_all_flush(void);
+
+   /**
+    * Get the configured cache flush interval time
+    *
+    * This gets the globally configured cache flush interval time, in
+    * ticks
+    *
+    * @return The cache flush interval time
+    * @ingroup Caches
+    *
+    * @see elm_all_flush()
+    */
    EAPI int          elm_cache_flush_interval_get(void);
+
+   /**
+    * Set the configured cache flush interval time
+    *
+    * This sets the globally configured cache flush interval time, in ticks
+    *
+    * @param size The cache flush interval time
+    * @ingroup Caches
+    *
+    * @see elm_all_flush()
+    */
    EAPI void         elm_cache_flush_interval_set(int size);
+
+   /**
+    * Set the configured cache flush interval time for all applications on the
+    * display
+    *
+    * This sets the globally configured cache flush interval time -- in ticks
+    * -- for all applications on the display.
+    *
+    * @param size The cache flush interval time
+    * @ingroup Caches
+    */
    EAPI void         elm_cache_flush_interval_all_set(int size);
+
+   /**
+    * Get the configured cache flush enabled state
+    *
+    * This gets the globally configured cache flush state - if it is enabled
+    * or not. When cache flushing is enabled, elementary will regularly
+    * (see elm_cache_flush_interval_get() ) flush caches and dump data out of
+    * memory and allow usage to re-seed caches and data in memory where it
+    * can do so. An idle application will thus minimise its memory usage as
+    * data will be freed from memory and not be re-loaded as it is idle and
+    * not rendering or doing anything graphically right now.
+    *
+    * @return The cache flush state
+    * @ingroup Caches
+    *
+    * @see elm_all_flush()
+    */
    EAPI Eina_Bool    elm_cache_flush_enabled_get(void);
+
+   /**
+    * Set the configured cache flush enabled state
+    *
+    * This sets the globally configured cache flush enabled state.
+    *
+    * @param size The cache flush enabled state
+    * @ingroup Caches
+    *
+    * @see elm_all_flush()
+    */
    EAPI void         elm_cache_flush_enabled_set(Eina_Bool enabled);
+
+   /**
+    * Set the configured cache flush enabled state for all applications on the
+    * display
+    *
+    * This sets the globally configured cache flush enabled state for all
+    * applications on the display.
+    *
+    * @param size The cache flush enabled state
+    * @ingroup Caches
+    */
    EAPI void         elm_cache_flush_enabled_all_set(Eina_Bool enabled);
+
+   /**
+    * Get the configured font cache size
+    *
+    * This gets the globally configured font cache size, in bytes.
+    *
+    * @return The font cache size
+    * @ingroup Caches
+    */
    EAPI int          elm_font_cache_get(void);
+
+   /**
+    * Set the configured font cache size
+    *
+    * This sets the globally configured font cache size, in bytes
+    *
+    * @param size The font cache size
+    * @ingroup Caches
+    */
    EAPI void         elm_font_cache_set(int size);
+
+   /**
+    * Set the configured font cache size for all applications on the
+    * display
+    *
+    * This sets the globally configured font cache size -- in bytes
+    * -- for all applications on the display.
+    *
+    * @param size The font cache size
+    * @ingroup Caches
+    */
    EAPI void         elm_font_cache_all_set(int size);
+
+   /**
+    * Get the configured image cache size
+    *
+    * This gets the globally configured image cache size, in bytes
+    *
+    * @return The image cache size
+    * @ingroup Caches
+    */
    EAPI int          elm_image_cache_get(void);
+
+   /**
+    * Set the configured image cache size
+    *
+    * This sets the globally configured image cache size, in bytes
+    *
+    * @param size The image cache size
+    * @ingroup Caches
+    */
    EAPI void         elm_image_cache_set(int size);
+
+   /**
+    * Set the configured image cache size for all applications on the
+    * display
+    *
+    * This sets the globally configured image cache size -- in bytes
+    * -- for all applications on the display.
+    *
+    * @param size The image cache size
+    * @ingroup Caches
+    */
    EAPI void         elm_image_cache_all_set(int size);
+
+   /**
+    * Get the configured edje file cache size.
+    *
+    * This gets the globally configured edje file cache size, in number
+    * of files.
+    *
+    * @return The edje file cache size
+    * @ingroup Caches
+    */
    EAPI int          elm_edje_file_cache_get(void);
+
+   /**
+    * Set the configured edje file cache size
+    *
+    * This sets the globally configured edje file cache size, in number
+    * of files.
+    *
+    * @param size The edje file cache size
+    * @ingroup Caches
+    */
    EAPI void         elm_edje_file_cache_set(int size);
+
+   /**
+    * Set the configured edje file cache size for all applications on the
+    * display
+    *
+    * This sets the globally configured edje file cache size -- in number
+    * of files -- for all applications on the display.
+    *
+    * @param size The edje file cache size
+    * @ingroup Caches
+    */
    EAPI void         elm_edje_file_cache_all_set(int size);
+
+   /**
+    * Get the configured edje collections (groups) cache size.
+    *
+    * This gets the globally configured edje collections cache size, in
+    * number of collections.
+    *
+    * @return The edje collections cache size
+    * @ingroup Caches
+    */
    EAPI int          elm_edje_collection_cache_get(void);
+
+   /**
+    * Set the configured edje collections (groups) cache size
+    *
+    * This sets the globally configured edje collections cache size, in
+    * number of collections.
+    *
+    * @param size The edje collections cache size
+    * @ingroup Caches
+    */
    EAPI void         elm_edje_collection_cache_set(int size);
+
+   /**
+    * Set the configured edje collections (groups) cache size for all
+    * applications on the display
+    *
+    * This sets the globally configured edje collections cache size -- in
+    * number of collections -- for all applications on the display.
+    *
+    * @param size The edje collections cache size
+    * @ingroup Caches
+    */
    EAPI void         elm_edje_collection_cache_all_set(int size);
 
    /**
-    * @defgroup Scaling Selective Widget Scaling
+    * @}
+    */
+
+   /**
+    * @defgroup Scaling Widget Scaling
     *
     * Different widgets can be scaled independently. These functions
     * allow you to manipulate this scaling on a per-widget basis. The