diff --git a/docs/common/cursor_c.ldoc b/docs/common/cursor_c.ldoc
index 55ac684c..019d342f 100644
--- a/docs/common/cursor_c.ldoc
+++ b/docs/common/cursor_c.ldoc
@@ -1,30 +1,30 @@
- *
num_glyphs
+ *
num\_glyphs
*
arrow
- *
based_arrow_down
- *
based_arrow_up
+ *
based\_arrow\_down
+ *
based\_arrow\_up
*
boat
*
bogosity
- *
bottom_left_corner
- *
bottom_right_corner
- *
bottom_side
- *
bottom_tee
- *
box_spiral
- *
center_ptr
+ *
bottom\_left\_corner
+ *
bottom\_right\_corner
+ *
bottom\_side
+ *
bottom\_tee
+ *
box\_spiral
+ *
center\_ptr
*
circle
*
clock
- *
coffee_mug
+ *
coffee\_mug
*
cross
*
crosshair
- *
cross_reverse
+ *
cross\_reverse
*
cursor
- *
diamond_cross
+ *
diamond\_cross
*
dotbox
*
dot
- *
double_arrow
- *
draft_large
- *
draft_small
- *
draped_box
+ *
double\_arrow
+ *
draft\_large
+ *
draft\_small
+ *
draped\_box
*
exchange
*
fleur
*
gobbler
@@ -33,32 +33,32 @@
*
hand
*
heart
*
icon
- *
iron_cross
+ *
iron\_cross
*
leftbutton
- *
left_ptr
- *
left_side
- *
left_tee
- *
ll_angle
- *
lr_angle
+ *
left\_ptr
+ *
left\_side
+ *
left\_tee
+ *
ll\_angle
+ *
lr\_angle
*
man
*
middlebutton
*
mouse
*
pencil
*
pirate
*
plus
- *
question_arrow
+ *
question\_arrow
*
rightbutton
- *
right_ptr
- *
right_side
- *
right_tee
- *
rtl_logo
+ *
right\_ptr
+ *
right\_side
+ *
right\_tee
+ *
rtl\_logo
*
sailboat
- *
sb_down_arrow
- *
sb_h_double_arrow
- *
sb_left_arrow
- *
sb_right_arrow
- *
sb_up_arrow
- *
sb_v_double_arrow
+ *
sb\_down\_arrow
+ *
sb\_h\_double\_arrow
+ *
sb\_left\_arrow
+ *
sb\_right\_arrow
+ *
sb\_up\_arrow
+ *
sb\_v\_double\_arrow
*
shuttle
*
sizing
*
spider
@@ -66,15 +66,15 @@
*
star
*
target
*
tcross
- *
top_left_arrow
- *
top_left_corner
- *
top_right_corner
- *
top_side
- *
top_tee
+ *
top\_left\_arrow
+ *
top\_left\_corner
+ *
top\_right\_corner
+ *
top\_side
+ *
top\_tee
*
trek
- *
ul_angle
+ *
ul\_angle
*
umbrella
- *
ur_angle
+ *
ur\_angle
*
watch
*
xterm
*
diff --git a/docs/common/rule.ldoc b/docs/common/rule.ldoc
index 357b27fc..403cc633 100644
--- a/docs/common/rule.ldoc
+++ b/docs/common/rule.ldoc
@@ -4,15 +4,17 @@
--
-- @rulecomponent properties
-- @param table
--- @see callbacks
+-- @see callback
--TODO add ^
-- @DOC_text_gears_matcher_properties_EXAMPLE@
---- A list of callback function to call *after* the properties have been apploed.
--- @rulecomponent callbacks
--- @param table
--- @see properties
+--- A callback function to call *after* the `properties` have been applied.
+--
+-- The callback is called with the current client as first argument.
+--
+-- @rulecomponent callback
+-- @param function
--- A table whose content will be compared to the target object current properties.
--
diff --git a/docs/ldoc.css b/docs/ldoc.css
index f73a9e09..9857bcfb 100644
--- a/docs/ldoc.css
+++ b/docs/ldoc.css
@@ -47,7 +47,11 @@ p.name {
font-family: monospace;
}
-kbd, p code, ol code {
+kbd,
+p code,
+ol code,
+ul code,
+dd > code {
background-color: #eaedf587;
padding-left: 3px;
padding-right: 3px;
diff --git a/docs/ldoc.ltp b/docs/ldoc.ltp
index f7c9b3db..2c518e30 100644
--- a/docs/ldoc.ltp
+++ b/docs/ldoc.ltp
@@ -395,7 +395,7 @@
# if def == true then
(optional)
# elseif def then
- (default $(def))
+ (default $(def)
)
# end
# if item:readonly(p) then
readonly
@@ -535,7 +535,6 @@