elm_genlist.h: added 'full' style documentation.

- 'full' style is so useful, it needs to have a documentation.
- Do not use @ for 'since' in this case. That will cause line break and looks ugly.
- reminded by ccxwrk.

diff --git a/src/lib/elm_genlist.h b/src/lib/elm_genlist.h
index 60f0af619fb19e5c883dfb18a64db49a3a93cbd3..95a1aee9b15af2b9eb297d8b3d643c2583047b86 100644 (file)
--- a/src/lib/elm_genlist.h
+++ b/src/lib/elm_genlist.h
@@ -108,9 +108,17 @@
  * @image html img/widget/genlist/preview-03.png
  * @image latex img/widget/genlist/preview-03.eps
  *
- * - one_icon - Only 1 icon (left) @since 1.7
- * - end_icon - Only 1 icon (at end/right) @since 1.7
- * - no_icon - No icon (at end/right) @since 1.7
+ * - one_icon - Only 1 icon (left) (since 1.7)
+ * - end_icon - Only 1 icon (at end/right) (since 1.7)
+ * - no_icon - No icon (at end/right) (since 1.7)
+ * - full - Only 1 icon, elm.swallow.content,  which consumes whole area of
+ * genlist itemj (since 1.7)
+ *
+ * If one wants to use more icons and texts than are offered in theme, there
+ * are two solutions. One is to use 'full' style that has one big swallow part.
+ * You can swallow anything there. The other solution is to customize genlist
+ * item style in application side by using elm_theme_extension_add() and its
+ * own edc. Please refer @ref theme_example_01 for that.
  *
  * @section Genlist_Items Structure of items
  *