docs: Add detailed text styling information

Summary:
More detailed descriptions for each attribute.
Relationship between attributes.
Default values.
Links to direct API methods for the corresponding property.
General text overhaul and formatting.

Test Plan: Builds and passes tests. Generate docgen or DocFX documentation and enjoy your new Text styling descriptions!

Reviewers: ali.alzyod

Reviewed By: ali.alzyod

Subscribers: AbdullehGhujeh, cedric, #reviewers, #committers, woohyun, bu5hm4n

Tags: #efl

Differential Revision: https://phab.enlightenment.org/D10873

1 files changed, 44 insertions, 44 deletions

diff --git a/src/lib/efl/interfaces/efl_text_font.eo b/src/lib/efl/interfaces/efl_text_font.eo
index 836835c2a6..dce81a7e10 100644
--- a/src/lib/efl/interfaces/efl_text_font.eo
+++ b/src/lib/efl/interfaces/efl_text_font.eo
@@ -1,53 +1,53 @@
 import efl_gfx_types;
 enum @beta Efl.Text_Font_Weight {
-   [[Type of font weight]]
-   normal, [[Normal font weight]]
-   thin, [[Thin font weight]]
-   ultralight, [[Ultralight font weight]]
-   extralight, [[Extralight font weight]]
-   light, [[Light font weight]]
-   book, [[Book font weight]]
-   medium, [[Medium font weight]]
-   semibold, [[Semibold font weight]]
-   bold, [[Bold font weight]]
-   ultrabold, [[Ultrabold font weight]]
-   extrabold, [[Extrabold font weight]]
-   black, [[Black font weight]]
-   extrablack, [[Extrablack font weight]]
+   [[Type of font weight.]]
+   normal, [[Normal font weight.]]
+   thin, [[Thin font weight.]]
+   ultralight, [[Ultralight font weight.]]
+   extralight, [[Extralight font weight.]]
+   light, [[Light font weight.]]
+   book, [[Book font weight.]]
+   medium, [[Medium font weight.]]
+   semibold, [[Semibold font weight.]]
+   bold, [[Bold font weight.]]
+   ultrabold, [[Ultrabold font weight.]]
+   extrabold, [[Extrabold font weight.]]
+   black, [[Black font weight.]]
+   extrablack, [[Extrablack font weight.]]
 }
 
 enum @beta Efl.Text_Font_Width {
-   [[Type of font width]]
-   normal, [[Normal font width]]
-   ultracondensed, [[Ultracondensed font width]]
-   extracondensed, [[Extracondensed font width]]
-   condensed, [[Condensed font width]]
-   semicondensed, [[Semicondensed font width]]
-   semiexpanded, [[Semiexpanded font width]]
-   expanded, [[Expanded font width]]
-   extraexpanded, [[Extraexpanded font width]]
-   ultraexpanded, [[Ultraexpanded font width]]
+   [[Type of font width.]]
+   normal, [[Normal font width.]]
+   ultracondensed, [[Ultracondensed font width.]]
+   extracondensed, [[Extracondensed font width.]]
+   condensed, [[Condensed font width.]]
+   semicondensed, [[Semicondensed font width.]]
+   semiexpanded, [[Semiexpanded font width.]]
+   expanded, [[Expanded font width.]]
+   extraexpanded, [[Extraexpanded font width.]]
+   ultraexpanded, [[Ultraexpanded font width.]]
 }
 
 enum @beta Efl.Text_Font_Slant {
-    [[Type of font slant]]
-    normal, [[Normal font slant]]
-    oblique, [[Oblique font slant]]
-    italic, [[Italic font slant]]
+    [[Type of font slant.]]
+    normal, [[Normal font slant.]]
+    oblique, [[Oblique font slant.]]
+    italic, [[Italic font slant.]]
 }
 
 /* FIXME: It needs to support "normal" option for non-color bitmap font.
    For supporting "normal" option, S/W glyph drawing engine should be updated.
  */
 enum @beta Efl.Text_Font_Bitmap_Scalable {
-   [[Scalable of bitmap fonts
+   [[Scalable of bitmap fonts.
    ]]
    none = 0,         [[Disable scalable feature for bitmap fonts.]]
    color = (1 << 0), [[Enable scalable feature for color bitmap fonts.]]
 }
 
 interface @beta Efl.Text_Font {
-   [[Font settings of the text
+   [[Font settings for text.
    ]]
    c_prefix: efl_text;
    methods {
@@ -105,42 +105,42 @@ interface @beta Efl.Text_Font {
       }
 
       @property font_fallbacks {
-         [[Comma-separated list of font fallbacks
+         [[Comma-separated list of font fallbacks.
 
            Will be used in case the primary font isn't available.
          ]]
          values {
-            font_fallbacks: string; [[Font name fallbacks]]
+            font_fallbacks: string; [[List of fallback font names.]]
          }
       }
 
       @property font_weight {
          [[Type of weight of the displayed font
 
-           Default is @Efl.Text_Font_Weight.normal\.
+           Default is @Efl.Text_Font_Weight.normal.
          ]]
          values {
-            font_weight: Efl.Text_Font_Weight; [[Font weight]]
+            font_weight: Efl.Text_Font_Weight; [[Font weight.]]
          }
       }
 
       @property font_slant {
-         [[Type of slant of the displayed font
+         [[Type of slant of the displayed font.
 
-           Default is @Efl.Text_Font_Slant.normal\.
+           Default is @Efl.Text_Font_Slant.normal.
          ]]
          values {
-            style: Efl.Text_Font_Slant; [[Font slant]]
+            style: Efl.Text_Font_Slant; [[Font slant.]]
          }
       }
 
       @property font_width {
-         [[Type of width of the displayed font
+         [[Type of width of the displayed font.
 
-           Default is @Efl.Text_Font_Width.normal\.
+           Default is @Efl.Text_Font_Width.normal.
          ]]
          values {
-            width: Efl.Text_Font_Width; [[Font width]]
+            width: Efl.Text_Font_Width; [[Font width.]]
          }
       }
 
@@ -153,19 +153,19 @@ interface @beta Efl.Text_Font {
            "auto" to use the system locale, or "none".
          ]]
          values {
-            lang: string; [[Language]]
+            lang: string; [[Language code.]]
          }
       }
 
       @property font_bitmap_scalable {
            [[The bitmap fonts have fixed size glyphs for several available sizes.
              Basically, it is not scalable. But, it needs to be scalable for some use cases.
-             (ex. colorful emoji fonts)
+             (e.g. colorful emoji fonts)
 
-             Default is @Efl.Text_Font_Bitmap_Scalable.none\.
+             Default is @Efl.Text_Font_Bitmap_Scalable.none.
            ]]
            values {
-              scalable: Efl.Text_Font_Bitmap_Scalable; [[Scalable]]
+              scalable: Efl.Text_Font_Bitmap_Scalable; [[Scalable.]]
            }
       }
    }