docs(xml): add help texts in XMLs (#8961)

Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>

docs/src/details/widgets/spangroup.rst

@@ -108,6 +108,8 @@ to set text alignment.
 Modes
 -----
 
+**DEPRECATED**, set the width to ``LV_SIZE_CONTENT`` or fixed value to control expanding/wrapping.
+
 A Spangroup can be set to one the following modes:
 
 - :cpp:enumerator:`LV_SPAN_MODE_FIXED` Fixes its size.

src/others/xml/parsers/lv_xml_chart_parser.c

@@ -174,6 +174,7 @@ static lv_chart_type_t chart_type_to_enum(const char * txt)
     if(lv_streq("none", txt)) return LV_CHART_TYPE_NONE;
     if(lv_streq("line", txt)) return LV_CHART_TYPE_LINE;
     if(lv_streq("bar", txt)) return LV_CHART_TYPE_BAR;
+    if(lv_streq("stacked", txt)) return LV_CHART_TYPE_STACKED;
     if(lv_streq("scatter", txt)) return LV_CHART_TYPE_SCATTER;
 
     LV_LOG_WARN("%s is an unknown value for chart's chart_type", txt);

src/others/xml/parsers/lv_xml_keyboard_parser.c

@@ -57,6 +57,7 @@ void lv_xml_keyboard_apply(lv_xml_parser_state_t * state, const char ** attrs)
 
         //        if(lv_streq("textarea", name)) lv_keyboard_set_mode(item, lv_obj_get_child_by_name());
         if(lv_streq("mode", name)) lv_keyboard_set_mode(item, mode_text_to_enum_value(value));
+        if(lv_streq("popovers", name)) lv_keyboard_set_popovers(item, lv_xml_to_bool(value));
     }
 }
 

src/widgets/arc/lv_arc.h

@@ -27,10 +27,14 @@ extern "C" {
 /**********************
  *      TYPEDEFS
  **********************/
+
+/**
+ * In which direction the indicator should grow.
+ */
 typedef enum {
-    LV_ARC_MODE_NORMAL,
-    LV_ARC_MODE_SYMMETRICAL,
-    LV_ARC_MODE_REVERSE
+    LV_ARC_MODE_NORMAL,      /**< Clock-wise */
+    LV_ARC_MODE_SYMMETRICAL, /**< Left/right from the midpoint */
+    LV_ARC_MODE_REVERSE      /**< Counterclock-wise */
 } lv_arc_mode_t;
 
 LV_ATTRIBUTE_EXTERN_DATA extern const lv_obj_class_t lv_arc_class;
@@ -106,7 +110,7 @@ void lv_arc_set_bg_angles(lv_obj_t * obj, lv_value_precise_t start, lv_value_pre
 void lv_arc_set_rotation(lv_obj_t * obj, int32_t rotation);
 
 /**
- * Set the type of arc.
+ * Set in which direction the indicator should grow.
  * @param obj       pointer to arc object
  * @param type      arc's mode
  */

src/widgets/image/lv_image.c

@@ -295,7 +295,7 @@ void lv_image_set_rotation(lv_obj_t * obj, int32_t angle)
     LV_ASSERT_OBJ(obj, MY_CLASS);
 
     lv_image_t * img = (lv_image_t *)obj;
-    if(img->align > LV_IMAGE_ALIGN_AUTO_TRANSFORM) {
+    if(img->align > _LV_IMAGE_ALIGN_AUTO_TRANSFORM) {
         angle = 0;
     }
     else {
@@ -340,7 +340,7 @@ void lv_image_set_pivot(lv_obj_t * obj, int32_t x, int32_t y)
     LV_ASSERT_OBJ(obj, MY_CLASS);
 
     lv_image_t * img = (lv_image_t *)obj;
-    if(img->align > LV_IMAGE_ALIGN_AUTO_TRANSFORM) {
+    if(img->align > _LV_IMAGE_ALIGN_AUTO_TRANSFORM) {
         x = 0;
         y = 0;
     }
@@ -401,7 +401,7 @@ void lv_image_set_scale(lv_obj_t * obj, uint32_t zoom)
     lv_image_t * img = (lv_image_t *)obj;
 
     /*If scale is set internally, do no overwrite it*/
-    if(img->align > LV_IMAGE_ALIGN_AUTO_TRANSFORM) return;
+    if(img->align > _LV_IMAGE_ALIGN_AUTO_TRANSFORM) return;
 
     if(zoom == img->scale_x && zoom == img->scale_y) return;
 
@@ -417,7 +417,7 @@ void lv_image_set_scale_x(lv_obj_t * obj, uint32_t zoom)
     lv_image_t * img = (lv_image_t *)obj;
 
     /*If scale is set internally, do no overwrite it*/
-    if(img->align > LV_IMAGE_ALIGN_AUTO_TRANSFORM) return;
+    if(img->align > _LV_IMAGE_ALIGN_AUTO_TRANSFORM) return;
 
     if(zoom == img->scale_x) return;
 
@@ -433,7 +433,7 @@ void lv_image_set_scale_y(lv_obj_t * obj, uint32_t zoom)
     lv_image_t * img = (lv_image_t *)obj;
 
     /*If scale is set internally, do no overwrite it*/
-    if(img->align > LV_IMAGE_ALIGN_AUTO_TRANSFORM) return;
+    if(img->align > _LV_IMAGE_ALIGN_AUTO_TRANSFORM) return;
 
     if(zoom == img->scale_y) return;
 
@@ -898,7 +898,7 @@ static void draw_image(lv_event_t * e)
             draw_dsc.clip_radius = lv_obj_get_style_radius(obj, LV_PART_MAIN);
 
             lv_area_t coords;
-            if(img->align < LV_IMAGE_ALIGN_AUTO_TRANSFORM) {
+            if(img->align < _LV_IMAGE_ALIGN_AUTO_TRANSFORM) {
                 lv_area_align(&obj->coords, &draw_dsc.image_area, img->align, img->offset.x, img->offset.y);
                 coords = draw_dsc.image_area;
             }
@@ -941,7 +941,7 @@ static void draw_image(lv_event_t * e)
             const bool needs_inner_alignment = img->align > LV_IMAGE_ALIGN_TOP_LEFT
                                                && !image_area_is_same_as_coords;
             const bool has_offset = img->offset.x || img->offset.y;
-            const bool inner_alignment_is_transforming = img->align >= LV_IMAGE_ALIGN_AUTO_TRANSFORM;
+            const bool inner_alignment_is_transforming = img->align >= _LV_IMAGE_ALIGN_AUTO_TRANSFORM;
             if((needs_inner_alignment || has_offset) && !inner_alignment_is_transforming) {
                 lv_point_t text_size;
 

src/widgets/image/lv_image.h

@@ -51,11 +51,11 @@ typedef enum {
     LV_IMAGE_ALIGN_LEFT_MID,
     LV_IMAGE_ALIGN_RIGHT_MID,
     LV_IMAGE_ALIGN_CENTER,
-    LV_IMAGE_ALIGN_AUTO_TRANSFORM,
-    LV_IMAGE_ALIGN_STRETCH, /* Set X and Y scale to fill the Widget's area. */
-    LV_IMAGE_ALIGN_TILE,    /* Tile image to fill Widget's area. Offset is applied to shift the tiling. */
-    LV_IMAGE_ALIGN_CONTAIN, /* The image keeps its aspect ratio, but is resized to the maximum size that fits within the Widget's area. */
-    LV_IMAGE_ALIGN_COVER,   /* The image keeps its aspect ratio and fills the Widget's area. */
+    _LV_IMAGE_ALIGN_AUTO_TRANSFORM, /**< Marks the start of modes that transform the image*/
+    LV_IMAGE_ALIGN_STRETCH, /**< Set X and Y scale to fill the Widget's area. */
+    LV_IMAGE_ALIGN_TILE,    /**< Tile image to fill Widget's area. Offset is applied to shift the tiling. */
+    LV_IMAGE_ALIGN_CONTAIN, /**< The image keeps its aspect ratio, but is resized to the maximum size that fits within the Widget's area. */
+    LV_IMAGE_ALIGN_COVER,   /**< The image keeps its aspect ratio and fills the Widget's area. */
 } lv_image_align_t;
 
 #if LV_USE_OBJ_PROPERTY

xmls/lv_animimg.xml

@@ -1,12 +1,13 @@
 <!--
 Example
-<lv_animinmg src="img1 img2" duration="300" repeat_count="3"/>
+<lv_animimg src="img1 img2" duration="300" repeat_count="3"/>
 -->
+
 <widget>
-	<api>
-	    <const name="infinite" help="Repeat the animation infinite times"/>
-	    <prop name="src" type="image_src[count]"  help="Image sources" />
-	    <prop name="duration" type="int" help="Length of the animation in milliseconds"/>
-	    <prop name="repeat_count"  type="int"/>
-	</api>
+    <api>
+        <const name="infinite" help="Repeat the animation infinitely"/>
+        <prop name="src" type="image_src[count]" help="Set the image sources, separated by spaces"/>
+        <prop name="duration" type="int" help="Set how long one animation cycle runs (ms)"/>
+        <prop name="repeat_count" type="int" help="Set how many times the animation repeats"/>
+    </api>
 </widget>

xmls/lv_arc.xml

@@ -1,25 +1,27 @@
 <!--
 Example
-<lv_arc mode="reverse" angles="100° 200°" bg_angles="30° 150° range="40 100" value="60"/>
+<lv_arc mode="reverse" bg_start_angle="30" bg_end_ange="150"
+                       min_value="40" max_value="120"
+                       value="60"/>
 -->
 
 <widget>
-	<api>
-	    <enumdef name="lv_arc_mode" help="the mode">
-	        <enum name="normal" help="normal"/>
-	        <enum name="symmetrical" help="sym"/>
-	        <enum name="reverse" help="reverse"/>
-	    </enumdef>
+    <api>
+        <enumdef name="lv_arc_mode" help="How the arc’s indicator grows">
+            <enum name="normal" help="Make the indicator grow clockwise"/>
+            <enum name="symmetrical" help="Make the indicator grow symmetrically left and right from the midpoint"/>
+            <enum name="reverse" help="Make the indicator grow counterclockwise"/>
+        </enumdef>
 
-	    <prop name="start_angle" type="int" help="Start angles of the indicator"/>
-	    <prop name="end_angle" type="int" help="End angles of the indicator"/>
-	    <prop name="bg_start_angle" type="int" help="Start angles of the background"/>
-	    <prop name="bg_end_angle" type="int" help="End angles of the background"/>
-		<prop name="rotation" type="int" help="Rotation angle of the whole arc"/>
-	    <prop name="min_value" type="int"/>
-	    <prop name="max_value" type="int"/>
-	    <prop name="value" type="int" help="The current value"/>
-	    <prop name="mode" type="enum:lv_arc_mode" help="The mode"/>
-	    <prop name="bind_value" type="subject" help="Connect a subject to the arc's value"/>
-	</api>
+        <prop name="start_angle" type="int" help="Set the start angle of the indicator"/>
+        <prop name="end_angle" type="int" help="Set the end angle of the indicator"/>
+        <prop name="bg_start_angle" type="int" help="Set the start angle of the background arc"/>
+        <prop name="bg_end_angle" type="int" help="Set the end angle of the background arc"/>
+        <prop name="rotation" type="int" help="Rotate the whole arc by a given angle"/>
+        <prop name="min_value" type="int" help="Set the minimum value of the arc"/>
+        <prop name="max_value" type="int" help="Set the maximum value of the arc"/>
+        <prop name="value" type="int" help="Set the current value of the arc (between minimum and maximum)"/>
+        <prop name="mode" type="enum:lv_arc_mode" help="Select how the indicator grows"/>
+        <prop name="bind_value" type="subject" help="Bind the arc’s value to a subject"/>
+    </api>
 </widget>

xmls/lv_bar.xml

@@ -4,36 +4,34 @@ Example
 -->
 
 <widget>
-	<api>
-		<enumdef name="lv_bar_mode" help="the mode">
-			<enum name="normal" help="normal"/>
-			<enum name="symmetrical" help="sym"/>
-			<enum name="range" help="range"/>
-		</enumdef>
+    <api>
+        <enumdef name="lv_bar_mode" help="How the bar grows with values">
+            <enum name="normal" help="Make the bar grow from minimum toward maximum"/>
+            <enum name="symmetrical" help="Make the bar grow symmetrically from the midpoint"/>
+            <enum name="range" help="Make the bar show values between start and end points"/>
+        </enumdef>
 
-		<enumdef name="lv_bar_orientation" help="">
-			<enum name="auto" help=""/>
-			<enum name="horizontal" help=""/>
-			<enum name="vertical" help=""/>
-		</enumdef>
+        <enumdef name="lv_bar_orientation" help="How the bar is oriented">
+            <enum name="auto" help="Choose orientation automatically based on widget size"/>
+            <enum name="horizontal" help="Make the bar fill left to right"/>
+            <enum name="vertical" help="Make the bar fill bottom to top"/>
+        </enumdef>
 
-	    <prop name="min_value" type="int"/>
-	    <prop name="max_value" type="int"/>
+        <prop name="min_value" type="int" help="Set the minimum value of the bar"/>
+        <prop name="max_value" type="int" help="Set the maximum value of the bar"/>
 
-	    <prop name="value" help="The current value">
-	    	<param name ="value" type="int" help="The current value"/>
-	    	<param name ="animated" type="bool" help="Set the value with animation" default="false"/>
-	   	</prop>
+        <prop name="value" help="Set the current value of the bar">
+            <param name="value" type="int" help="The bar’s current value"/>
+            <param name="animated" type="bool" default="false" help="Animate the bar when changing its value. Reference as `value-animated`"/>
+        </prop>
 
-	    <prop name="start_value" help="The current left value in case of range mode">
-	    	<param name ="start_value" type="int" help="The current value"/>
-	    	<param name ="animated" type="bool" help="Set the value with animation" default="false"/>
-	   	</prop>
+        <prop name="start_value" help="Set the start value in range mode">
+            <param name="start_value" type="int" help="The left/start value of the bar in range mode"/>
+            <param name="animated" type="bool" default="false" help="Animate the bar when changing its start value. Reference as `start_value-animated`"/>
+        </prop>
 
-	    <prop name="mode" type="enum:lv_bar_mode"/>
-
-	    <prop name="orientation" type="enum:lv_bar_orientation"/>
-
-        <prop name="bind_value" type="subject" />
-	</api>
-</widget>
+        <prop name="mode" type="enum:lv_bar_mode" help="Select how the bar grows"/>
+        <prop name="orientation" type="enum:lv_bar_orientation" help="Select the bar’s orientation"/>
+        <prop name="bind_value" type="subject" help="Bind the bar’s value to a subject"/>
+    </api>
+</widget>

xmls/lv_buttonmatrix.xml

@@ -4,43 +4,41 @@ Example
 -->
 
 <widget>
-	<api>
-		<enumdef name="lv_buttonmatrix_ctrl" multi="true" help="control flags for the buttons">
-			<enum name="none"      help="No special control"/>
-			<enum name="width_1"   help="Relative width is 1 in its row"/>
-			<enum name="width_2"   help="Relative width is 2 in its row"/>
-			<enum name="width_3"   help="Relative width is 3 in its row"/>
-			<enum name="width_4"   help="Relative width is 4 in its row"/>
-			<enum name="width_5"   help="Relative width is 5 in its row"/>
-			<enum name="width_6"   help="Relative width is 6 in its row"/>
-			<enum name="width_7"   help="Relative width is 7 in its row"/>
-			<enum name="width_8"   help="Relative width is 8 in its row"/>
-			<enum name="width_9"   help="Relative width is 9 in its row"/>
-			<enum name="width_10"   help="Relative width is 10 in its row"/>
-			<enum name="width_11"   help="Relative width is 11 in its row"/>
-			<enum name="width_12"   help="Relative width is 12 in its row"/>
-			<enum name="width_13"   help="Relative width is 13 in its row"/>
-			<enum name="width_14"   help="Relative width is 14 in its row"/>
-			<enum name="width_15"   help="Relative width is 15 in its row"/>
-			<enum name="hidden"      help="Button hidden"/>
-			<enum name="no_repeat"   help="Do not repeat press this button."/>
-			<enum name="disabled"    help="Disable this button."/>
-			<enum name="checkable"   help="The button can be toggled."/>
-			<enum name="checked"     help="Button is currently toggled (e.g. checked)."/>
-			<enum name="click_trig"  help="1: Send LV_EVENT_VALUE_CHANGE on CLICK, 0: Send LV_EVENT_VALUE_CHANGE on PRESS"/>
-			<enum name="popover"     help="Show a popover when pressing this key"/>
-			<enum name="recolor"     help="Enable text recoloring with `#color`"/>
-			<enum name="reserved_1"  help="Reserved for later use"/>
-			<enum name="reserved_2"  help="Reserved for later use"/>
-			<enum name="custom_1"    help="Custom free to use flag"/>
-			<enum name="custom_2"    help="Custom free to use flag"/>
-		</enumdef>
+    <api>
+        <enumdef name="lv_buttonmatrix_ctrl" multi="true" help="Control flags you can apply to individual buttons">
+            <enum name="none"      help="Make the button use the default state with no special control"/>
+            <enum name="width_1"   help="Make the button take 1 unit of relative width in its row"/>
+            <enum name="width_2"   help="Make the button take 2 units of relative width in its row"/>
+            <enum name="width_3"   help="Make the button take 3 units of relative width in its row"/>
+            <enum name="width_4"   help="Make the button take 4 units of relative width in its row"/>
+            <enum name="width_5"   help="Make the button take 5 units of relative width in its row"/>
+            <enum name="width_6"   help="Make the button take 6 units of relative width in its row"/>
+            <enum name="width_7"   help="Make the button take 7 units of relative width in its row"/>
+            <enum name="width_8"   help="Make the button take 8 units of relative width in its row"/>
+            <enum name="width_9"   help="Make the button take 9 units of relative width in its row"/>
+            <enum name="width_10"  help="Make the button take 10 units of relative width in its row"/>
+            <enum name="width_11"  help="Make the button take 11 units of relative width in its row"/>
+            <enum name="width_12"  help="Make the button take 12 units of relative width in its row"/>
+            <enum name="width_13"  help="Make the button take 13 units of relative width in its row"/>
+            <enum name="width_14"  help="Make the button take 14 units of relative width in its row"/>
+            <enum name="width_15"  help="Make the button take 15 units of relative width in its row"/>
+            <enum name="hidden"      help="Make the button hidden"/>
+            <enum name="no_repeat"   help="Disable long-press repeat on the button"/>
+            <enum name="disabled"    help="Make the button disabled (not clickable)"/>
+            <enum name="checkable"   help="Make the button toggleable when clicked"/>
+            <enum name="checked"     help="Keep the button in the toggled (checked) state"/>
+            <enum name="click_trig"  help="Trigger LV_EVENT_VALUE_CHANGED on CLICK instead of PRESS"/>
+            <enum name="popover"     help="Show a popover when pressing the button"/>
+            <enum name="recolor"     help="Enable text recoloring with inline #color codes"/>
+            <enum name="reserved_1"  help="Reserved flag for future use"/>
+            <enum name="reserved_2"  help="Reserved flag for future use"/>
+            <enum name="custom_1"    help="Custom flag free to use by the user"/>
+            <enum name="custom_2"    help="Custom flag free to use by the user"/>
+        </enumdef>
 
-	    <prop name="map"  type="string[NULL]" help=""/>
-	    <prop name="ctrl_map" type="enum:lv_buttonmatrix_ctrl[]+" help=""/>
-	    <prop name="one_checked" type="bool" help=""/>
-	    <prop name="selected_button" type="int" help=""/>
-
-
-	</api>
-</widget>
+        <prop name="map" type="string[NULL]" help="Set the layout map of the button matrix using text strings and `\n` for line breaks (e.g. 'a' 'b' 'c')"/>
+        <prop name="ctrl_map" type="enum:lv_buttonmatrix_ctrl[]+" help="Set the control flags for each button in the map"/>
+        <prop name="one_checked" type="bool" help="Force exactly one button to stay checked at all times"/>
+        <prop name="selected_button" type="int" help="Select a button by index (new lines do not count)"/>
+    </api>
+</widget>

xmls/lv_calendar.xml

@@ -4,17 +4,15 @@ Example
 -->
 
 <widget>
-	<api>
-	    <prop name="today_year" type="int"/>
-	    <prop name="today_month" type="int"/>
-	    <prop name="today_day" type="int"/>
+    <api>
+        <prop name="today_year" type="int" help="Mark today’s year in the calendar"/>
+        <prop name="today_month" type="int" help="Mark today’s month in the calendar"/>
+        <prop name="today_day" type="int" help="Mark today’s day in the calendar"/>
 
-	    <prop name="shown_month" type="int"/>
-	    <prop name="shown_day" tyepe="int"/>
+        <prop name="shown_year" type="int" help="Show this year in the calendar"/>
+        <prop name="shown_month" type="int" help="Show this month in the calendar"/>
 
-		<element name="header_arrow" access="add" help=""/>
-		<element name="header_dropdown" access="add" help="">
-			<prop name="year_list" type="string"/>
-		</element>
-	</api>
-</widget>
+        <element name="header_arrow" access="add" help="Add arrow buttons for navigating months"/>
+        <element name="header_dropdown" access="add" help="Add a dropdown for selecting months or years"/>
+    </api>
+</widget>

xmls/lv_chart.xml

@@ -1,57 +1,57 @@
 <!--
 <lv_chart type="bar" point_count="30">
-	<lv_chart-series color="0xff0000" axis="primary_y" values="10, 20, 10, 33"/>
-	<lv_chart-series color="0x00ff00" axis="secondary_y" values="1, 5, 4 8"/>
-	<lv_chart-cursor color="0x0000ff" dir="right" pos="30, 70"/>
-	<lv_chart-axis name="primary_y" range="10, 40"/>
+    <lv_chart-series color="0xff0000" axis="primary_y" values="10, 20, 10, 33"/>
+    <lv_chart-series color="0x00ff00" axis="secondary_y" values="1, 5, 4 8"/>
+    <lv_chart-cursor color="0x0000ff" dir="right" pos="30, 70"/>
+    <lv_chart-axis name="primary_y" range="10, 40"/>
 </lv_chart>
  -->
 
 <widget>
-	<api>
-	    <enumdef name="lv_chart_type" help="Type of the chart">
-	        <enum name="none"/>
-	        <enum name="line"/>
-	        <enum name="bar"/>
-	        <enum name="scatter"/>
-	    </enumdef>
+    <api>
+        <enumdef name="lv_chart_type" help="How the chart draws its data series">
+            <enum name="none" help="Draw nothing"/>
+            <enum name="line" help="Draw data points as connected lines"/>
+            <enum name="bar" help="Draw data points as bars"/>
+            <enum name="stacked" help="Draw series as stacked bars on top of each other"/>
+            <enum name="scatter" help="Draw data points as unconnected dots"/>
+        </enumdef>
 
-	    <enumdef name="lv_chart_update_mode" help="The update mode">
-	        <enum name="shift"/>
-	        <enum name="circular"/>
-	    </enumdef>
+        <enumdef name="lv_chart_update_mode" help="How the chart handles new data points">
+            <enum name="shift" help="Shift old data to the left when new points are added"/>
+            <enum name="circular" help="Overwrite the oldest data in a circular buffer style"/>
+        </enumdef>
 
-	    <enumdef name="lv_chart_axis" help="The axis">
-	        <enum name="primary_x"/>
-	        <enum name="primary_y"/>
-	        <enum name="secondary_x"/>
-	        <enum name="secondary_y"/>
-	    </enumdef>
+        <enumdef name="lv_chart_axis" help="Which axis a series belongs to">
+            <enum name="primary_x" help="Use the primary X axis"/>
+            <enum name="primary_y" help="Use the primary Y axis"/>
+            <enum name="secondary_x" help="Use the secondary X axis"/>
+            <enum name="secondary_y" help="Use the secondary Y axis"/>
+        </enumdef>
 
-	    <prop name="type" type="enum:lv_chart_type" help=""/>
+        <prop name="type" type="enum:lv_chart_type" help="Choose how the chart should draw its data"/>
+        <prop name="point_count" type="int" help="Set how many data points each series stores"/>
+        <prop name="update_mode" type="enum:lv_chart_update_mode" help="Choose how the chart updates when adding new points"/>
+        <prop name="hor_div_line_count" type="int" help="Show this many horizontal division lines"/>
+        <prop name="ver_div_line_count" type="int" help="Show this many vertical division lines"/>
 
-	    <prop name="point_count" type="int" help=""/>
-	    <prop name="update_mode" type="enum:lv_chart_update_mode" help=""/>
-	    <prop name="hor_div_line_count" type="int" help="number of horizontal division lines"/>
-	    <prop name="ver_div_line_count" type="int" help="number of vertical division lines"/>
+        <element name="series" type="lv_chart_series" access="add" help="Add a data series to the chart">
+            <arg name="color" type="color" help="Set the color of the series"/>
+            <arg name="axis" type="enum:lv_chart_axis+" default="primary_y" help="Choose which axis the series belongs to"/>
+            <prop name="values" type="int[count]" help="Provide the data values of the series"/>
+        </element>
 
-	    <element name="series" type="lv_chart_series" access="add">
-	        <arg name="color" type="color" help=""/>
-	        <arg name="axis" type="enum:lv_chart_axis+" default="primary_y" help="The axis"/>
-	    	<prop name="values"  type="int[count]" help="set values from an array"/>
-	    </element>
+        <element name="cursor" type="lv_chart_cursor" access="add" help="Add a cursor indicator to the chart">
+            <arg name="color" type="color" arg="true" help="Set the color of the cursor"/>
+            <arg name="dir" type="enum:lv_dir" arg="true" help="Choose the direction of the cursor"/>
+            <prop name="pos_x" type="int" help="Set the X position of the cursor"/>
+            <prop name="pos_y" type="int" help="Set the Y position of the cursor"/>
+        </element>
 
-	    <element name="cursor" type="lv_chart_cursor" access="add">
-	        <arg name="color" type="color" arg="true"/>
-	        <arg name="dir" type="enum:lv_dir" arg="true"/>
-	    	<prop name="pos_x" type="int" help="x position of the cursor"/>
-            <prop name="pos_y" type="int" help="y position of the cursor"/>
-	    </element>
-
-	    <element name="axis" access="set">
-	    	<arg name="axis" type="enum:lv_chart_axis"/>
-	    	<prop name="min_value" type="int"/>
-	    	<prop name="max_value" type="int"/>
-	    </element>
-	</api>
-</widget>
+        <element name="axis" access="set" help="Configure the range of a chart axis">
+            <arg name="axis" type="enum:lv_chart_axis" help="Choose which axis to configure"/>
+            <prop name="min_value" type="int" help="Set the minimum value of the axis"/>
+            <prop name="max_value" type="int" help="Set the maximum value of the axis"/>
+        </element>
+    </api>
+</widget>

xmls/lv_checkbox.xml

@@ -4,7 +4,7 @@ Example
 -->
 
 <widget>
-	<api>
-	    <prop name="text" type="string" help="The text of the checkbox"/>
-	</api>
-</widget>
+    <api>
+        <prop name="text" type="string" help="The label text shown next to the checkbox"/>
+    </api>
+</widget>

xmls/lv_dropdown.xml

@@ -1,21 +1,18 @@
 <!--
 Example
 <lv_dropdown options="option1\noption2" dir="left">
-	<lv_dropdown-list style="red"/>
+    <lv_dropdown-list style="red"/>
 </lv_dropdown>
 -->
 
 <widget>
-	<api>
-	    <prop name="text" type="string" help="Show it instead of the selected options"/>
-	    <prop name="options" type="string" help="The options as a \n separated string"/>
-	    <prop name="selected" help="The index of the selected option">
-	    	<param name="selected" type="int" help="The index of the selected option"/>
-	    	<param name="anim" type="bool" help="Move to the option with animation" default="false"/>
-	    </prop>
-	    <prop name="symbol" type="string" help="The symbol, usually a caret"/>
-	    <prop name="bind_value" type="subject" help=""/>
+    <api>
+        <prop name="text" type="string" help="Set text displayed instead of the selected option label"/>
+        <prop name="options" type="string" help="Set options as a newline (`\n`) separated string"/>
+        <prop name="selected" type="int" help="Select an option by index (0-based)"/>
+        <prop name="symbol" type="string" help="Set a symbol shown next to the dropdown"/>
+        <prop name="bind_value" type="subject" help="Bind the selected option index to a subject"/>
 
-	    <element name="list" access="get" type="lv_obj" help=""/>
-	</api>
+        <element name="list" access="get" type="lv_obj" help="The dropdown list object for styling or customization"/>
+    </api>
 </widget>

xmls/lv_image.xml

@@ -4,31 +4,31 @@ Example
 -->
 
 <widget>
-	<api>
-		<enumdef name="lv_image_align" help="">
+    <api>
+        <enumdef name="lv_image_align" help="How the image is placed inside its container">
+            <enum name="default" help="Align top-left (same as top_left)"/>
+            <enum name="top_left" help="Align to top-left"/>
+            <enum name="top_mid" help="Align to top-center"/>
+            <enum name="top_right" help="Align to top-right"/>
+            <enum name="bottom_left" help="Align to bottom-left"/>
+            <enum name="bottom_mid" help="Align to bottom-center"/>
+            <enum name="bottom_right" help="Align to bottom-right"/>
+            <enum name="left_mid" help="Align to left-center"/>
+            <enum name="right_mid" help="Align to right-center"/>
+            <enum name="center" help="Align to center"/>
+            <enum name="stretch" help="Stretch to fill the widget"/>
+            <enum name="tile" help="Tile to fill the widget"/>
+            <enum name="contain" help="Scale to fit inside while keeping aspect ratio"/>
+            <enum name="cover" help="Scale to fully cover while keeping aspect ratio"/>
+        </enumdef>
 
-		    <enum name="default" help=""/>
-		    <enum name="top_left" help=""/>
-		    <enum name="top_mid" help=""/>
-		    <enum name="top_right" help=""/>
-		    <enum name="bottom_left" help=""/>
-		    <enum name="bottom_mid" help=""/>
-		    <enum name="bottom_right" help=""/>
-		    <enum name="left_mid" help=""/>
-		    <enum name="right_mid" help=""/>
-		    <enum name="center" help=""/>
-		    <enum name="auto_transform" help=""/>
-		    <enum name="stretch" help=""/>
-		    <enum name="tile" help=""/>
-		</enumdef>
-
-	    <prop name="src" type="image" help=""/>
-	    <prop name="inner_align" type="enum:lv_image_align" help=""/>
-	    <prop name="rotation" type="int" help=""/>
-	    <prop name="scale_x" type="int" help=""/>
-	    <prop name="scale_y" type="int" help=""/>
-    	<prop name="pivot_x" type="int" help=""/>
-    	<prop name="pivot_y" type="int" help=""/>
-        <prop name="bind_src" type="subject" />
-	</api>
-</widget>
+        <prop name="src" type="image" help="Set the image source (file, symbol, or variable)"/>
+        <prop name="inner_align" type="enum:lv_image_align" help="Align and scale the image inside"/>
+        <prop name="rotation" type="int" help="Rotate the image (degrees)"/>
+        <prop name="scale_x" type="int" help="Scale horizontally (100 = original)"/>
+        <prop name="scale_y" type="int" help="Scale vertically (100 = original)"/>
+        <prop name="pivot_x" type="int|%" help="Set the pivot X for rotation/scaling"/>
+        <prop name="pivot_y" type="int|%" help="Set the pivot Y for rotation/scaling"/>
+        <prop name="bind_src" type="subject" help="Bind the image source to a subject"/>
+    </api>
+</widget>

xmls/lv_keyboard.xml

@@ -1,22 +1,23 @@
 <!--
 Example
-<lv_keyboard mode="text_upper"/>
+<lv_keyboard mode="text_upper" popover="true"/>
 -->
 
 <widget>
-	<api>
-	    <enumdef name="lv_keyboard_mode" help="">
-	        <enum name="text_upper"/>
-	        <enum name="text_lower"/>
-	        <enum name="text_arabic"/>
-	        <enum name="special"/>
-	        <enum name="number"/>
-	        <enum name="user_1"/>
-	        <enum name="user_2"/>
-	        <enum name="user_3"/>
-	        <enum name="user_4"/>
-	    </enumdef>
+    <api>
+        <enumdef name="lv_keyboard_mode" help="Keyboard layout modes">
+            <enum name="text_upper" help="Show uppercase letters"/>
+            <enum name="text_lower" help="Show lowercase letters"/>
+            <enum name="text_arabic" help="Show Arabic characters"/>
+            <enum name="special" help="Show special characters and symbols"/>
+            <enum name="number" help="Show numeric keys"/>
+            <enum name="user_1" help="User-defined layout 1"/>
+            <enum name="user_2" help="User-defined layout 2"/>
+            <enum name="user_3" help="User-defined layout 3"/>
+            <enum name="user_4" help="User-defined layout 4"/>
+        </enumdef>
 
-	    <prop name="mode" type="enum:lv_keyboard_mode" help=""/>
-	</api>
-</widget>
+        <prop name="mode" type="enum:lv_keyboard_mode" help="Set the keyboard layout"/>
+        <prop name="popover" type="bool" help="Show enlarged key previews on press"/>
+    </api>
+</widget>

xmls/lv_label.xml

@@ -4,21 +4,22 @@ Example
 -->
 
 <widget>
-	<api>
-	    <enumdef name="lv_label_long_mode">
-	        <enum name="wrap" help=""/>
-	        <enum name="scroll" help=""/>
-	        <enum name="scroll_circular" help=""/>
-	        <enum name="clip" help=""/>
-	        <enum name="dots" help=""/>
-	    </enumdef>
+    <api>
+        <enumdef name="lv_label_long_mode" help="How to handle text that doesn’t fit">
+            <enum name="wrap" help="Wrap to next line"/>
+            <enum name="scroll" help="Scroll horizontally"/>
+            <enum name="scroll_circular" help="Scroll continuously in a loop"/>
+            <enum name="clip" help="Clip at the boundary"/>
+            <enum name="dots" help="Show dots (…) at the end"/>
+        </enumdef>
 
-	    <prop name="text"  type="string" />
-	    <prop name="translation_tag"  type="string" />
-	    <prop name="long_mode" type="enum:lv_label_long_mode" />
-	    <prop name="bind_text">
-	    	<param name="bind_text" type="subject" />
-	    	<param name="fmt" type="string" default="NULL"/>
-	   	</prop>
-	</api>
+        <prop name="text" type="string" help="Set label text"/>
+        <prop name="translation_tag" type="string" help="Set translation tag"/>
+        <prop name="long_mode" type="enum:lv_label_long_mode" help="Choose overflow mode"/>
+
+        <prop name="bind_text" help="Bind text to a subject">
+            <param name="bind_text" type="subject" help="Subject that provides text"/>
+            <param name="fmt" type="string" default="NULL" help="Format string for bound text (printf style)"/>
+        </prop>
+    </api>
 </widget>

xmls/lv_qrcode.xml

@@ -5,10 +5,10 @@ Example
 
 <widget>
     <api>
-        <prop name="size" type="int" help="QR canvas edge length in px (use this instead of width/height)"/>
-        <prop name="dark_color" type="color" help="Foreground color for QR modules"/>
-        <prop name="light_color" type="color" help="Background color"/>
-        <prop name="data" type="string" help="UTF-8 payload encoded into the QR code. Must be called as last property"/>
-        <prop name="quiet_zone" type="bool" help="Add quiet zone (border) around the QR code"/>
+        <prop name="size" type="int" help="Set the QR code size in pixels (instead of width/height)"/>
+        <prop name="dark_color" type="color" help="Set the foreground color"/>
+        <prop name="light_color" type="color" help="Set the background color"/>
+        <prop name="data" type="string" help="Set the encoded UTF-8 data"/>
+        <prop name="quiet_zone" type="bool" help="Add margin around the QR code"/>
     </api>
 </widget>

xmls/lv_roller.xml

@@ -4,22 +4,23 @@ Example
  -->
 
 <widget>
-	<api>
-	    <enumdef name="lv_roller_mode">
-	        <enum name="normal" help=""/>
-	        <enum name="infinite" help=""/>
-	    </enumdef>
-	    <prop name="options">
-	    	<param name="options" type="string"/>
-	    	<param name="mode" type="enum:lv_roller_mode" default="normal"/>
-	    </prop>
+    <api>
+        <enumdef name="lv_roller_mode" help="How the roller scrolls">
+            <enum name="normal" help="Stop at first and last option"/>
+            <enum name="infinite" help="Scroll endlessly in a loop"/>
+        </enumdef>
 
-	    <prop name="selected" help="">
-	    	<param name="selected" type="int"/>
-	    	<param name="animated" type="bool" default="false"/>
-	    </prop>
+        <prop name="options" help="Set the roller options">
+            <param name="options" type="string" help="Options as a newline (`\n`) separated string"/>
+            <param name="mode" type="enum:lv_roller_mode" default="normal" help="Set the roller mode (reference as `options-mode`)"/>
+        </prop>
 
-	    <prop name="visible_row_count" type="int" help=""/>
-	    <prop name="bind_value" type="subject" help=""/>
-	</api>
-</widget>
+        <prop name="selected" help="Set the selected option">
+            <param name="selected" type="int" help="Index of the selected option (0-based)"/>
+            <param name="animated" type="bool" default="false" help="Animate the selection (reference as `selected-animated`)"/>
+        </prop>
+
+        <prop name="visible_row_count" type="int" help="Show this many rows at once"/>
+        <prop name="bind_value" type="subject" help="Bind the selected option to a subject"/>
+    </api>
+</widget>

xmls/lv_scale.xml

@@ -1,40 +1,40 @@
 <!--
 <lv_scale total_tick_count="30">
-	<lv_scale-section column="2" range="30 40" style_indicator="scale_style"/>
+    <lv_scale-section column="2" range="30 40" style_indicator="scale_style"/>
 </lv_scale>
 -->
 
 <widget>
-	<api>
-	    <enumdef name="lv_scale_mode" help="">
-	        <enum name="horizontal_top" help=""/>
-	        <enum name="horizontal_bottom" help=""/>
-	        <enum name="vertical_left" help=""/>
-	        <enum name="vertical_right" help=""/>
-	        <enum name="round_inner" help=""/>
-	        <enum name="round_outer" help=""/>
-	    </enumdef>
+    <api>
+        <enumdef name="lv_scale_mode" help="How the scale is drawn">
+            <enum name="horizontal_top" help="Ticks on top"/>
+            <enum name="horizontal_bottom" help="Ticks on bottom"/>
+            <enum name="vertical_left" help="Ticks on left"/>
+            <enum name="vertical_right" help="Ticks on right"/>
+            <enum name="round_inner" help="Circular, ticks inside"/>
+            <enum name="round_outer" help="Circular, ticks outside"/>
+        </enumdef>
 
-	    <prop name="mode" type="enum:lv_scale_mode" help=""/>
-	    <prop name="total_tick_count" type="int" help=""/>
-	    <prop name="major_tick_every" type="int" help=""/>
-	    <prop name="label_show" type="bool" help=""/>
-	    <prop name="min_value" type="int" help=""/>
-	    <prop name="max_value" type="int" help=""/>
-	    <prop name="angle_range" type="deg" help=""/>
-	    <prop name="rotation" type="deg" help=""/>
-	    <prop name="text_src" type="string[NULL]" help=""/>
-	    <prop name="post_draw" type="bool" help=""/>
-	    <prop name="draw_ticks_on_top" type="bool" help=""/>
+        <prop name="mode" type="enum:lv_scale_mode" help="Set the scale mode"/>
+        <prop name="total_tick_count" type="int" help="Set number of ticks"/>
+        <prop name="major_tick_every" type="int" help="Set frequency of major ticks"/>
+        <prop name="label_show" type="bool" help="Show or hide labels"/>
+        <prop name="min_value" type="int" help="Set minimum value"/>
+        <prop name="max_value" type="int" help="Set maximum value"/>
+        <prop name="angle_range" type="deg" help="Set angular range (degrees)"/>
+        <prop name="rotation" type="deg" help="Rotate the scale (degrees)"/>
+        <prop name="text_src" type="string[NULL]" help="Set custom labels from text"/>
+        <prop name="post_draw" type="bool" help="Enable post-draw events"/>
+        <prop name="draw_ticks_on_top" type="bool" help="Draw ticks above other content"/>
 
-	    <element name="section" type="lv_scale_section" access="add">
-	    	<prop name="min_value" type="int" help=""/>
-	    	<prop name="max_value" type="int" help=""/>
-	    	<prop name="style_main" type="style" help=""/>
-	    	<prop name="style_indicator" type="style" help=""/>
-	    	<prop name="style_items" type="style" help=""/>
-            <prop name="bind_min_value" type="subject" help="Connect a subject to the section's min value"/>
-            <prop name="bind_max_value" type="subject" help="Connect a subject to the section's max value"/>
-	    </element>
-	</api>
+        <element name="section" type="lv_scale_section" access="add" help="Add a styled section">
+            <prop name="min_value" type="int" help="Set section min"/>
+            <prop name="max_value" type="int" help="Set section max"/>
+            <prop name="style_main" type="style" help="Set main line style"/>
+            <prop name="style_indicator" type="style" help="Set major line and text style"/>
+            <prop name="style_items" type="style" help="Set minor ticks' style"/>
+            <prop name="bind_min_value" type="subject" help="Bind section min to subject"/>
+            <prop name="bind_max_value" type="subject" help="Bind section max to subject"/>
+        </element>
+    </api>
 </widget>

xmls/lv_slider.xml

@@ -4,28 +4,27 @@ Example
  -->
 
 <widget>
-	<api>
-	    <enumdef name="lv_slider_mode">
-	        <enum name="normal" help="Normal left to right slider"/>
-	        <enum name="range" help="Two knobs with to set a range"/>
-	        <enum name="symmetrical" help="The indicaror is grwing from zero"/>
-	    </enumdef>
+    <api>
+        <enumdef name="lv_slider_mode" help="How the slider behaves">
+            <enum name="normal" help="One knob, grows left to right"/>
+            <enum name="range" help="Two knobs, select a range"/>
+            <enum name="symmetrical" help="Indicator grows from zero"/>
+        </enumdef>
 
-        <prop name="min_value" type="int"/>
-        <prop name="max_value" type="int"/>
+        <prop name="min_value" type="int" help="Set minimum value"/>
+        <prop name="max_value" type="int" help="Set maximum value"/>
 
-	    <prop name="value">
-	    	<param name="value" type="int"/>
-	    	<param name="anim" type="bool" default="false"/>
-	    </prop>
+        <prop name="value" help="Set current value">
+            <param name="value" type="int" help="Current value"/>
+            <param name="anim" type="bool" default="false" help="Animate update (reference as `value-anim`)"/>
+        </prop>
 
-	    <prop name="start_value">
-	    	<param name="start_value" type="int"/>
-	    	<param name="anim" type="bool" default="false"/>
-	    </prop>
+        <prop name="start_value" help="Set start value in range mode">
+            <param name="start_value" type="int" help="Start value"/>
+            <param name="anim" type="bool" default="false" help="Animate update (reference as `start_value-anim`)"/>
+        </prop>
 
-	    <prop name="mode" type="enum:lv_slider_mode"/>
-
-	    <prop name="bind_value" type="subject" />
-	</api>
-</widget>
+        <prop name="mode" type="enum:lv_slider_mode" help="Set slider mode"/>
+        <prop name="bind_value" type="subject" help="Bind value to subject"/>
+    </api>
+</widget>

xmls/lv_spangroup.xml

@@ -1,6 +1,6 @@
 <!--
 Example
-<lv_spangroup mode="fixed">
+<lv_spangroup width="300" height="content">
     <lv_spangroup-span text="hello " style="red"/>
     <lv_spangroup-span text="world" style="blue"/>
 </lv_spangroup>
@@ -8,28 +8,22 @@ Example
 
 <widget>
     <api>
-        <enumdef name="lv_span_overflow">
-            <enum name="clip" help=""/>
-            <enum name="ellipses" help=""/>
+        <enumdef name="lv_span_overflow" help="How to handle overflowing text">
+            <enum name="clip" help="Clip at boundary"/>
+            <enum name="ellipsis" help="Replace overflowing words with ..."/>
         </enumdef>
 
-        <enumdef name="lv_span_mode">
-            <enum name="fixed" help=""/>
-            <enum name="expand" help=""/>
-            <enum name="break" help=""/>
-        </enumdef>
+        <prop name="overflow" type="enum:lv_span_overflow" help="Set overflow mode"/>
+        <prop name="max_lines" type="int" help="Set max lines"/>
+        <prop name="indent" type="int" help="Set first line indent (px)"/>
 
-        <prop name="overflow" type="enum:lv_span_overflow" help=""/>
-        <prop name="max_lines" type="int" help=""/>
-        <prop name="indent" type="int" help=""/>
-
-        <element name="span" type="lv_span" access="add">
-            <prop name="text" type="string" help=""/>
-            <prop name="style" type="style" help=""/>
-            <prop name="bind_text" help="">
-                <param name="bind_text" type="subject"/>
-                <param name="fmt" type="string" default="NULL"/>
+        <element name="span" type="lv_span" access="add" help="Add a styled text span">
+            <prop name="text" type="string" help="Set span text"/>
+            <prop name="style" type="style" help="Set span style"/>
+            <prop name="bind_text" help="Bind text to a subject">
+                <param name="bind_text" type="subject" help="Subject that provides text"/>
+                <param name="fmt" type="string" default="NULL" help="Format string (printf style)"/>
             </prop>
         </element>
     </api>
-</widget>
+</widget>

xmls/lv_switch.xml

@@ -5,12 +5,12 @@ Example
 
 <widget>
     <api>
-        <enumdef name="lv_switch_orientation" help="">
-            <enum name="auto" help=""/>
-            <enum name="horizontal" help=""/>
-            <enum name="vertical" help=""/>
+        <enumdef name="lv_switch_orientation" help="Switch orientation">
+            <enum name="auto" help="Choose based on widget size"/>
+            <enum name="horizontal" help="Horizontal switch"/>
+            <enum name="vertical" help="Vertical switch"/>
         </enumdef>
 
-        <prop name="orientation" type="enum:lv_switch_orientation"/>
+        <prop name="orientation" type="enum:lv_switch_orientation" help="Set switch orientation"/>
     </api>
-</widget>
+</widget>

xmls/lv_table.xml

@@ -1,35 +1,35 @@
 <!--
 <lv_table column_count="4">
-	<lv_table-column column="2" width="30px"/>
-	<lv_table-cell row="2" column="1" value="hello" ctrl="text_crop merge_right"/>
-	<lv_table-cell row="3" column="0" value="world"/>
+    <lv_table-column column="2" width="30px"/>
+    <lv_table-cell row="2" column="1" value="hello" ctrl="text_crop merge_right"/>
+    <lv_table-cell row="3" column="0" value="world"/>
 </lv_table>
 -->
 
 <widget>
-	<api>
-	    <enumdef name="lv_table_cell_ctrl" help="Type of the chart">
-	        <enum name="merge_right"/>
-	        <enum name="text_crop"/>
-	        <enum name="custom_1"/>
-	        <enum name="custom_2"/>
-	        <enum name="custom_3"/>
-	        <enum name="custom_4"/>
-	    </enumdef>
+    <api>
+        <enumdef name="lv_table_cell_ctrl" help="Cell control flags">
+            <enum name="merge_right" help="Merge with right cell"/>
+            <enum name="text_crop" help="Crop text if too long"/>
+            <enum name="custom_1" help="User flag 1"/>
+            <enum name="custom_2" help="User flag 2"/>
+            <enum name="custom_3" help="User flag 3"/>
+            <enum name="custom_4" help="User flag 4"/>
+        </enumdef>
 
-	    <prop name="row_count" type="int" help=""/>
-	    <prop name="column_count" type="int" help=""/>
+        <prop name="row_count" type="int" help="Set row count"/>
+        <prop name="column_count" type="int" help="Set column count"/>
 
-	    <element name="column" access="set">
-	        <arg name="column" type="int" help=""/>
-	    	<prop name="width" type="px" help="width of the column"/>
-	    </element>
+        <element name="column" access="set" help="Configure a table column">
+            <arg name="column" type="int" help="Column index (0-based)"/>
+            <prop name="width" type="px" help="Set column width"/>
+        </element>
 
-	    <element name="cell" access="set">
-	        <arg name="row" type="int" help=""/>
-	        <arg name="column" type="int" help=""/>
-	    	<prop name="value"  type="string"  help=""/>
-	    	<prop name="ctrl" type="enum:lv_table_cell_ctrl+" help=""/>
-	    </element>
-	</api>
+        <element name="cell" access="set" help="Configure a table cell">
+            <arg name="row" type="int" help="Row index (0-based)"/>
+            <arg name="column" type="int" help="Column index (0-based)"/>
+            <prop name="value" type="string" help="Set cell text"/>
+            <prop name="ctrl" type="enum:lv_table_cell_ctrl+" help="Set cell flags"/>
+        </element>
+    </api>
 </widget>

xmls/lv_tabview.xml

@@ -1,24 +1,25 @@
 <!--
 Example
 <lv_tabview active="3">
-	<lv_tabview-tab text="First">
-		<lv_button/>
-	</lv_tabview-tab/>
+    <lv_tabview-tab text="First">
+        <lv_button/>
+    </lv_tabview-tab>
 </lv_tabview>
  -->
 
 <widget>
     <api>
-        <prop name="active" type="int" help="Zero based index of the tab to select"/>
-        <prop name="tab_bar_position" type="enum:lv_dir" help=""/>
-        <element name="tab_bar" type="lv_obj" access="get">
-        </element>
-        <element name="tab" type="lv_obj" access="add">
-            <arg name="text" type="string"/>
-        </element>
-        <element name="tab_button" type="lv_obj" access="get">
-            <arg name="index" type="int"/>
+        <prop name="active" type="int" help="Set active tab index (0-based)"/>
+        <prop name="tab_bar_position" type="enum:lv_dir" help="Set tab bar position (top, bottom, left, right)"/>
+
+        <element name="tab_bar" type="lv_obj" access="get" help="Get the tab bar object"/>
+
+        <element name="tab" type="lv_obj" access="add" help="Add a tab with content">
+            <arg name="text" type="string" help="Set tab button text"/>
         </element>
 
+        <element name="tab_button" type="lv_obj" access="get" help="Get a specific tab button">
+            <arg name="index" type="int" help="Tab index (0-based)"/>
+        </element>
     </api>
-</widget>
+</widget>

xmls/lv_textarea.xml

@@ -4,13 +4,13 @@ Example
 -->
 
 <widget>
-	<api>
-	    <prop name="text" type="string" help=""/>
-	    <prop name="placeholder_text" type="string" help=""/>
-	    <prop name="one_line" type="bool" help=""/>
-	    <prop name="password_mode" type="bool" help=""/>
-	    <prop name="password_show_time" type="int" help=""/>
-	    <prop name="text_selection" type="bool" help=""/>
-	    <prop name="cursor_pos" type="int" help=""/>
-	</api>
-</widget>
+    <api>
+        <prop name="text" type="string" help="Set textarea text"/>
+        <prop name="placeholder_text" type="string" help="Set placeholder text"/>
+        <prop name="one_line" type="bool" help="Enable single-line mode"/>
+        <prop name="password_mode" type="bool" help="Enable password masking"/>
+        <prop name="password_show_time" type="int" help="Set delay to show typed chars (ms)"/>
+        <prop name="text_selection" type="bool" help="Enable text selection"/>
+        <prop name="cursor_pos" type="int" help="Set cursor position (0-based)"/>
+    </api>
+</widget>