docs(style API): add API documentation to style_api_gen.py (#9637)

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

src/core/lv_obj_style_gen.c

@@ -1,5 +1,6 @@
-
 /*
+ * @file
+ *
  **********************************************************************
  *                            DO NOT EDIT
  * This file is automatically generated by "style_api_gen.py"
@@ -954,7 +955,7 @@ void lv_obj_set_style_flex_grow(lv_obj_t * obj, uint8_t value, lv_style_selector
     };
     lv_obj_set_local_style_prop(obj, LV_STYLE_FLEX_GROW, v, selector);
 }
-#endif /*LV_USE_FLEX*/
+#endif /* LV_USE_FLEX */
 
 #if LV_USE_GRID
 
@@ -1037,5 +1038,5 @@ void lv_obj_set_style_grid_cell_row_span(lv_obj_t * obj, int32_t value, lv_style
     };
     lv_obj_set_local_style_prop(obj, LV_STYLE_GRID_CELL_ROW_SPAN, v, selector);
 }
-#endif /*LV_USE_GRID*/
+#endif /* LV_USE_GRID */
 

src/misc/lv_style.h

@@ -584,12 +584,23 @@ uint8_t lv_style_prop_lookup_flags(lv_style_prop_t prop);
 
 #include "lv_style_gen.h"
 
+/**
+ * Set `style`s width and height.
+ * @param  style   pointer to style to be modified
+ * @param  width   width in pixels
+ * @param  height  height in pixels
+ */
 static inline void lv_style_set_size(lv_style_t * style, int32_t width, int32_t height)
 {
     lv_style_set_width(style, width);
     lv_style_set_height(style, height);
 }
 
+/**
+ * Set all 4 of `style`s padding values.
+ * @param  style   pointer to style to be modified
+ * @param  value   padding dimension in pixels
+ */
 static inline void lv_style_set_pad_all(lv_style_t * style, int32_t value)
 {
     lv_style_set_pad_left(style, value);
@@ -598,36 +609,66 @@ static inline void lv_style_set_pad_all(lv_style_t * style, int32_t value)
     lv_style_set_pad_bottom(style, value);
 }
 
+/**
+ * Set `style`s left and right padding values.
+ * @param  style   pointer to style to be modified
+ * @param  value   padding dimension in pixels
+ */
 static inline void lv_style_set_pad_hor(lv_style_t * style, int32_t value)
 {
     lv_style_set_pad_left(style, value);
     lv_style_set_pad_right(style, value);
 }
 
+/**
+ * Set `style`s top and bottom padding values.
+ * @param  style   pointer to style to be modified
+ * @param  value   padding dimension in pixels
+ */
 static inline void lv_style_set_pad_ver(lv_style_t * style, int32_t value)
 {
     lv_style_set_pad_top(style, value);
     lv_style_set_pad_bottom(style, value);
 }
 
+/**
+ * Set `style`s row and column padding gaps (applies only to Grid and Flex layouts).
+ * @param  style   pointer to style to be modified
+ * @param  value   gap dimension in pixels
+ */
 static inline void lv_style_set_pad_gap(lv_style_t * style, int32_t value)
 {
     lv_style_set_pad_row(style, value);
     lv_style_set_pad_column(style, value);
 }
 
+/**
+ * Set `style`s left and right margin values.
+ * @param  style   pointer to style to be modified
+ * @param  value   margin dimension in pixels
+ */
 static inline void lv_style_set_margin_hor(lv_style_t * style, int32_t value)
 {
     lv_style_set_margin_left(style, value);
     lv_style_set_margin_right(style, value);
 }
 
+/**
+ * Set `style`s top and bottom margin values.
+ * @param  style   pointer to style to be modified
+ * @param  value   margin dimension in pixels
+ */
 static inline void lv_style_set_margin_ver(lv_style_t * style, int32_t value)
 {
     lv_style_set_margin_top(style, value);
     lv_style_set_margin_bottom(style, value);
 }
 
+/**
+ * Set all 4 of `style`s margin values.
+ * @param  style   pointer to style to be modified
+ * @param  value   margin dimension in pixels
+ */
 static inline void lv_style_set_margin_all(lv_style_t * style, int32_t value)
 {
     lv_style_set_margin_left(style, value);
@@ -636,6 +677,16 @@ static inline void lv_style_set_margin_all(lv_style_t * style, int32_t value)
     lv_style_set_margin_bottom(style, value);
 }
 
+/**
+ * Set `style`s X and Y transform scale values.
+ * @param  style   pointer to style to be modified
+ * @param  value   scale factor.  Example values:
+ *                     - 256 or LV_SCALE_NONE:  no zoom
+ *                     - <256:  scale down
+ *                     - >256:  scale up
+ *                     - 128:  half size
+ *                     - 512:  double size
+ */
 static inline void lv_style_set_transform_scale(lv_style_t * style, int32_t value)
 {
     lv_style_set_transform_scale_x(style, value);

src/misc/lv_style_gen.c

@@ -1,5 +1,6 @@
-
 /*
+ * @file
+ *
  **********************************************************************
  *                            DO NOT EDIT
  * This file is automatically generated by "style_api_gen.py"
@@ -954,7 +955,7 @@ void lv_style_set_flex_grow(lv_style_t * style, uint8_t value)
     };
     lv_style_set_prop(style, LV_STYLE_FLEX_GROW, v);
 }
-#endif /*LV_USE_FLEX*/
+#endif /* LV_USE_FLEX */
 
 #if LV_USE_GRID
 
@@ -1037,5 +1038,5 @@ void lv_style_set_grid_cell_row_span(lv_style_t * style, int32_t value)
     };
     lv_style_set_prop(style, LV_STYLE_GRID_CELL_ROW_SPAN, v);
 }
-#endif /*LV_USE_GRID*/
+#endif /* LV_USE_GRID */