diff --git a/lib/gears/color.lua b/lib/gears/color.lua
index c85709251..87a20ca78 100644
--- a/lib/gears/color.lua
+++ b/lib/gears/color.lua
@@ -333,7 +333,7 @@ function color.recolor_image(image, new_color)
 end
 
 --- Get a valid color for Pango markup
--- @param color The color.
+-- @param check_color The color to check.
 -- @tparam string fallback The color to return if the first is invalid. (default: black)
 -- @treturn string color if it is valid, else fallback.
 function color.ensure_pango_color(check_color, fallback)
diff --git a/objects/client.c b/objects/client.c
index 3adfe3ac8..5ef575bf5 100644
--- a/objects/client.c
+++ b/objects/client.c
@@ -387,11 +387,11 @@
  *
  * **Signal:**
  *
- *  * *property::icon*
+ *  * *property::icon\_sizes*
  *
  * @property icon_sizes
  * @tparam table sizes
- * @see `get_icon`
+ * @see get_icon
  */
 
 /**