Index: doc/variable.man.inc
===================================================================
diff -u -r7944f1c82b2b3f6379fcfa4cf3914df136b6cec9 -r8f64a468d8bb53f2ba317c8c738c2d3a24243980
--- doc/variable.man.inc	(.../variable.man.inc)	(revision 7944f1c82b2b3f6379fcfa4cf3914df136b6cec9)
+++ doc/variable.man.inc	(.../variable.man.inc)	(revision 8f64a468d8bb53f2ba317c8c738c2d3a24243980)
@@ -50,10 +50,12 @@
 [list_begin definitions]
 [def "[arg obj] [arg variableName] [method add] [arg element] [opt [arg index]]"]
 Adding [arg element] to the managed list value, at the list position given by [arg index] (by default: 0).
-[def "[arg obj] [arg variableName] [method delete] [arg elementPattern]"]
-Removing one or multiple elements from the managed list value which
-match [arg elementPattern]. [arg elementPattern] can contain matching
-characters (see [cmd "string match"]).
+[def "[arg obj] [arg variableName] [method delete] [opt [option -nocomplain]] [arg elementPattern]"]
+Removing the first occurrence of an element from the managed list
+value which matches [arg elementPattern]. [arg elementPattern] can
+contain matching characters (see [cmd "string match"]). An error will
+be thrown if there is no match, unless [option -nocomplain] is set.
+
 [list_end]
 
 [para]
@@ -70,6 +72,15 @@
 
 [para]
 
+The [option -trace] option causes certain slot methods to be executed whenever [const get], [const set], or [const default] operations are invoked on the [term variable]:
+[list_begin itemized]
+[item] [const set]: [arg slot] [const value=set] [arg obj] [arg variableName] [arg value]
+[item] [const get]: [arg slot] [const value=get] [arg obj] [arg variableName]
+[item] [const default]: [arg slot] [const value=default] [arg obj] [arg variableName]
+[list_end]
+
+[para]
+
 A [term variable] becomes implemented by a [term "slot object"] under any of the following conditions:
 [list_begin itemized]
 [item] [option -configurable] equals [const true].