wibox.widget.imagebox: Update the property documentation.

lib/wibox/widget/imagebox.lua

@@ -296,15 +296,8 @@ end
 
 --- The image rendered by the `imagebox`.
 --
--- It can can be any of the following:
---
--- * A `string`: Interpreted as a path to an image file
--- * A cairo image surface: Directly used as-is
--- * A librsvg handle object: Directly used as-is
--- * `nil`: Unset the image.
---
 -- @property image
--- @tparam[opt=nil] image image The image to render.
+-- @tparam[opt=nil] image|nil image
 -- @propemits false false
 
 --- Set the `imagebox` image.
@@ -370,7 +363,7 @@ end
 -- @DOC_wibox_widget_imagebox_clip_shape_EXAMPLE@
 --
 -- @property clip_shape
--- @tparam[opt=nil] function|gears.shape clip_shape A `gears.shape` compatible shape function.
+-- @tparam[opt=gears.shape.rectangle] shape clip_shape A `gears.shape` compatible shape function.
 -- @propemits true false
 -- @see gears.shape
 
@@ -456,6 +449,7 @@ end
 --
 -- @property dpi
 -- @tparam[opt=96] number|table dpi
+-- @negativeallowed false
 -- @propemits true false
 -- @see auto_dpi
 
@@ -516,38 +510,30 @@ end
 
 --- Set the horizontal fit policy.
 --
--- Valid values are:
---
---  * `"auto"`: Honor the `resize` variable and preserve the aspect ratio.
---   This is the default behaviour.
---  * `"none"`: Do not resize at all.
---  * `"fit"`: Resize to the widget width.
---
 -- Here is the result for a 22x32 image:
 --
 -- @DOC_wibox_widget_imagebox_horizontal_fit_policy_EXAMPLE@
 --
 -- @property horizontal_fit_policy
 -- @tparam[opt="auto"] string horizontal_fit_policy
+-- @propertyvalue "auto" Honor the `resize` variable and preserve the aspect ratio.
+-- @propertyvalue "none" Do not resize at all.
+-- @propertyvalue "fit" Resize to the widget width.
 -- @propemits true false
 -- @see vertical_fit_policy
 -- @see resize
 
 --- Set the vertical fit policy.
 --
--- Valid values are:
---
---  * `"auto"`: Honor the `resize` varible and preserve the aspect ratio.
---   This is the default behaviour.
---  * `"none"`: Do not resize at all.
---  * `"fit"`: Resize to the widget height.
---
 -- Here is the result for a 32x22 image:
 --
 -- @DOC_wibox_widget_imagebox_vertical_fit_policy_EXAMPLE@
 --
 -- @property vertical_fit_policy
 -- @tparam[opt="auto"] string vertical_fit_policy
+-- @propertyvalue "auto" Honor the `resize` variable and preserve the aspect ratio.
+-- @propertyvalue "none" Do not resize at all.
+-- @propertyvalue "fit" Resize to the widget height.
 -- @propemits true false
 -- @see horizontal_fit_policy
 -- @see resize
@@ -555,32 +541,26 @@ end
 
 --- The vertical alignment.
 --
--- Possible values are:
---
--- * `"top"`
--- * `"center"` (default)
--- * `"bottom"`
---
 -- @DOC_wibox_widget_imagebox_valign_EXAMPLE@
 --
 -- @property valign
 -- @tparam[opt="center"] string valign
+-- @propertyvalue "top"
+-- @propertyvalue "center"
+-- @propertyvalue "bottom"
 -- @propemits true false
 -- @see wibox.container.place
 -- @see halign
 
 --- The horizontal alignment.
 --
--- Possible values are:
---
--- * `"left"`
--- * `"center"` (default)
--- * `"right"`
---
 -- @DOC_wibox_widget_imagebox_halign_EXAMPLE@
 --
 -- @property halign
 -- @tparam[opt="center"] string halign
+-- @propertyvalue "left"
+-- @propertyvalue "center"
+-- @propertyvalue "right"
 -- @propemits true false
 -- @see wibox.container.place
 -- @see valign
@@ -598,6 +578,7 @@ end
 --
 -- @property max_scaling_factor
 -- @tparam[opt=0] number max_scaling_factor Use `0` for "no limit".
+-- @negativeallowed false
 -- @propemits true false
 -- @see valign
 -- @see halign
@@ -629,8 +610,12 @@ end
 -- @DOC_wibox_widget_imagebox_scaling_quality_EXAMPLE@
 --
 -- @property scaling_quality
--- @tparam[op="fast"] string scaling_quality Either `"fast"`, `"good"`, `"best"`,
---   `"nearest"` or `"bilinear"`.
+-- @tparam[opt="good"] string scaling_quality
+-- @propertyvalue "fast" A high-performance filter.
+-- @propertyvalue "good" A reasonable-performance filter.
+-- @propertyvalue "best" The highest-quality available.
+-- @propertyvalue "nearest" Nearest-neighbor filtering (blocky).
+-- @propertyvalue "bilinear" Linear interpolation in two dimensions.
 -- @propemits true false
 -- @see resize
 -- @see horizontal_fit_policy