chore: fix some comment issue (#4715)

src/core/lv_refr.h

@@ -57,7 +57,7 @@ void lv_refr_now(lv_display_t * disp);
 
 /**
  * Redrawn on object an all its children using the passed draw context
- * @param draw_ctx  pointer to an initialized draw context
+ * @param layer pointer to a layer where to draw.
  * @param obj   the start object from the redraw should start
  */
 void lv_obj_redraw(lv_layer_t * layer, lv_obj_t * obj);

src/draw/lv_draw_image.h

@@ -69,14 +69,18 @@ void lv_draw_image_dsc_init(lv_draw_image_dsc_t * dsc);
 
 /**
  * Draw an image
- * @param draw_ctx      pointer to the current draw context
+ * @param layer         pointer to a layer
  * @param dsc           pointer to an initialized `lv_draw_image_dsc_t` variable
  * @param coords        the coordinates of the image
- * @param src           pointer to a lv_color_t array which contains the pixels of the image
  */
 void lv_draw_image(struct _lv_layer_t * layer, const lv_draw_image_dsc_t * dsc, const lv_area_t * coords);
 
-
+/**
+ * Draw a layer on an other layer
+ * @param layer         pointer to a layer
+ * @param dsc           pointer to an initialized `lv_draw_image_dsc_t` variable
+ * @param coords        the coordinates of the layer
+ */
 void lv_draw_layer(struct _lv_layer_t * layer, const lv_draw_image_dsc_t * dsc, const lv_area_t * coords);
 
 /**

src/draw/lv_draw_label.h

@@ -107,16 +107,22 @@ void lv_draw_letter_dsc_init(lv_draw_glyph_dsc_t * dsc);
 
 /**
  * Write a text
- * @param draw_ctx      pointer to the current draw context
+ * @param layer         pointer to a layer
  * @param dsc           pointer to draw descriptor
  * @param coords        coordinates of the label
- * @param txt           `\0` terminated text to write
- * @param hint          pointer to a `lv_draw_label_hint_t` variable.
  * It is managed by the draw to speed up the drawing of very long texts (thousands of lines).
  */
 LV_ATTRIBUTE_FAST_MEM void lv_draw_label(lv_layer_t * layer, const lv_draw_label_dsc_t * dsc,
                                          const lv_area_t * coords);
 
+/**
+ * Write a text
+ * @param layer          pointer to a layer
+ * @param dsc            pointer to draw descriptor
+ * @param point          position of the label
+ * @param unicode_letter the letter to draw
+ * It is managed by the draw to speed up the drawing of very long texts (thousands of lines).
+ */
 LV_ATTRIBUTE_FAST_MEM void lv_draw_letter(lv_layer_t * layer, lv_draw_label_dsc_t * dsc,
                                           const lv_point_t * point, uint32_t unicode_letter);
 

src/draw/lv_draw_line.h

@@ -51,10 +51,8 @@ LV_ATTRIBUTE_FAST_MEM void lv_draw_line_dsc_init(lv_draw_line_dsc_t * dsc);
 
 /**
  * Draw a line
- * @param draw_ctx      pointer to the current draw context
+ * @param layer         pointer to a layer
  * @param dsc           pointer to an initialized `lv_draw_line_dsc_t` variable
- * @param point1        first point of the line
- * @param point2        second point of the line
  */
 void lv_draw_line(struct _lv_layer_t * layer, const lv_draw_line_dsc_t * dsc);
 

src/draw/lv_draw_rect.h

@@ -136,7 +136,7 @@ void lv_draw_bg_image_dsc_init(lv_draw_bg_image_dsc_t * dsc);
 
 /**
  * Draw a rectangle
- * @param draw_ctx      pointer to the current draw context
+ * @param layer         pointer to a layer
  * @param dsc           pointer to an initialized `lv_draw_rect_dsc_t` variable
  * @param coords        the coordinates of the rectangle
  */

src/draw/lv_image_buf.h

@@ -112,7 +112,8 @@ void lv_image_buf_free(lv_image_dsc_t * dsc);
  * @param w width of the rectangle to transform
  * @param h height of the rectangle to transform
  * @param angle angle of rotation
- * @param zoom zoom, (256 no zoom)
+ * @param zoom_x zoom in x direction, (256 no zoom)
+ * @param zoom_y zoom in y direction, (256 no zoom)
  * @param pivot x,y pivot coordinates of rotation
  */
 void _lv_image_buf_get_transformed_area(lv_area_t * res, lv_coord_t w, lv_coord_t h, lv_coord_t angle, uint16_t zoom_x,

src/draw/sw/lv_draw_sw_triangle.c

@@ -179,10 +179,8 @@ void lv_draw_sw_triangle(lv_draw_unit_t * draw_unit, const lv_draw_triangle_dsc_
     }
 
 #else
-    LV_UNUSED(points);
-    LV_UNUSED(point_cnt);
-    LV_UNUSED(draw_ctx);
-    LV_UNUSED(draw_dsc);
+    LV_UNUSED(draw_unit);
+    LV_UNUSED(dsc);
     LV_LOG_WARN("Can't draw triangles with LV_DRAW_SW_COMPLEX == 0");
 #endif /*LV_DRAW_SW_COMPLEX*/
 }