Index: doc/filter.man.inc
===================================================================
diff -u -re5ad7edaed3418723ed31bda80c8639df6b44a7e -r496978cf0b0f707fb82cd16eba99b2e44497e9ed
--- doc/filter.man.inc	(.../filter.man.inc)	(revision e5ad7edaed3418723ed31bda80c8639df6b44a7e)
+++ doc/filter.man.inc	(.../filter.man.inc)	(revision 496978cf0b0f707fb82cd16eba99b2e44497e9ed)
@@ -2,54 +2,69 @@
 
 [keywords "method filter"]
 
-[call [arg [vset CMD]] [const [vset MODIFIER]] [method filter] [arg submethod] [opt "[arg arg] ..."]]
+[call [arg [vset CMD]] [const [vset MODIFIER]] [method filters] [arg submethod] [opt "[arg arg] ..."]]
 
 Accesses and modifies the list of methods which are registered as
 [term "filter"]s with [arg obj] using a specific setter or getter 
 [arg submethod]:
 
 [list_begin definitions]
-[def "[arg [vset CMD]] [const [vset MODIFIER]] [method {filter set}] [arg filterSpecList]"]
 
-[arg filterSpecList] takes a list of [term "filter"] specs, with each spec being itself either a
-one-element or a two-element list: [arg methodName] ?-guard [arg guardExpr]?. [arg methodName] identifies
-an existing method of [arg [vset CMD]] which becomes
-registered as a filter. If having three elements, the third
-element [arg guardExpr] will be stored as a guard expression of the
-[term "filter"]. This guard expression must be a valid Tcl expression
-(see [cmd expr]). [arg expr] is evaluated when [arg [vset CMD]] receives a message to determine whether the
-filter should intercept the message. Guard expressions
-allow for realizing context-dependent or conditional filter
-composition.
-
-[def "[arg [vset CMD]] [const [vset MODIFIER]] [method {filter get}]"]
-Returns the current list of methods registered as [term "filter"]s.
-
-[def "[arg [vset CMD]] [const [vset MODIFIER]] [method {filter add}] [arg spec] [opt [arg index]]"]
+[def "[arg [vset CMD]] [const [vset MODIFIER]] [method {filters add}] [arg spec] [opt [arg index]]"]
 Inserts a single [term "filter"] into the current list of [term "filter"]s of [arg [vset CMD]]. Using [arg index], a position in the existing list of [term "filter"]s for inserting the new [term "filter"] can be set. If
 omitted, [arg index] defaults to the list head (0).
 
-[def "[arg [vset CMD]] [const [vset MODIFIER]] [method {filter delete}] [option -nocomplain] [arg specPattern]"]
+[def "[arg [vset CMD]] [const [vset MODIFIER]] [method {filters clear}]"]
+Removes all [term "filter"]s from [arg [vset CMD]] and returns the list of removed [term "filter"]s. Clearing
+is equivalent to passing an empty list for [arg filterSpecList] to
+[const [vset SCOPE]] [method {filter set}].
+
+[def "[arg [vset CMD]] [const [vset MODIFIER]] [method {filters get}]"]
+Returns the list of current [term "filter specification"]s registered for [vset CMD].
+
+[def "[arg [vset CMD]] [const [vset MODIFIER]] [method {filters delete}] [option -nocomplain] [arg specPattern]"]
 Removes a single [term "filter"] from the current list of [term "filter"]s of
 [arg [vset CMD]] whose spec matches [arg specPattern]. [arg specPattern] can
-contain special matching chars (see [cmd "string match"]). [const [vset SCOPE]] [method "filter delete"] will
+contain special matching chars (see [cmd "string match"]). [const [vset SCOPE]] [method "filters delete"] will
 throw an error if there is no matching [term "filter"], unless
 [option -nocomplain] is set.
 
-[def "[arg [vset CMD]] [const [vset MODIFIER]] [method {filter clear}]"]
-Removes all [term "filter"]s from [arg [vset CMD]] and returns the list of removed [term "filter"]s. Clearing is equivalent
-to passing an empty list for [arg filterSpecList] to [const [vset SCOPE]] [method {filter set}].
+[def "[arg [vset CMD]] [const [vset MODIFIER]] [method {filters guard}] [arg methodName] [opt [arg expr]]"]
 
-[def "[arg [vset CMD]] [const [vset MODIFIER]] [method {filter guard}] [arg methodName] [arg expr]"]
-
-Registers a guard expression [arg expr] with a filter [arg methodName]
-in a separate step, once the filter was set or added using [const [vset MODIFIER]] [method {filter set}] or
-[const [vset MODIFIER]] [method {filter add}]. [arg expr] must be a valid Tcl expression (see
+If [arg expr] is specified, registers a guard expression [arg expr] with a filter [arg methodName]. This requires that the filter [arg methodName] has been previously set using [const [vset MODIFIER]] [method {filters set}] or added using
+[const [vset MODIFIER]] [method {filters add}]. [arg expr] must be a valid Tcl expression (see
 [cmd expr]). An empty string for [arg expr] will clear the currently registered
 guard expression for filter [arg methodName].
 
+[para]
+
+If [arg expr] is omitted, returns the guard expression set on the
+[term "filter"] [arg methodName] defined for [arg [vset CMD]]. If none
+is available, an empty string will be returned.
+
+[def "[arg [vset CMD]] [const [vset MODIFIER]] [method "filters methods"] [opt [arg pattern]]"]
+
+If [arg pattern] is omitted, returns all filter names which are
+defined by [arg obj]. By specifying [arg pattern], the returned
+filters can be limited to those whose names match [arg patterns] (see
+[cmd "string match"]).
+
+[def "[arg [vset CMD]] [const [vset MODIFIER]] [method {filters set}] [arg filterSpecList]"]
+
+[arg filterSpecList] takes a list of [term "filter"] specs, with each spec being itself either a
+one-element or a two-element list: [arg methodName] ?-guard [arg guardExpr]?. [arg methodName] identifies
+an existing method of [arg [vset CMD]] which becomes
+registered as a filter. If having three elements, the third
+element [arg guardExpr] will be stored as a guard expression of the
+[term "filter"]. This guard expression must be a valid Tcl expression
+(see [cmd expr]). [arg expr] is evaluated when [arg [vset CMD]] receives a message to determine whether the
+filter should intercept the message. Guard expressions
+allow for realizing context-dependent or conditional filter
+composition.
+
+
 [list_end]
 Every [arg methodName] in a [arg spec] must resolve to an existing method in
 the scope of the [vset SCOPE]. To
 access and to manipulate the list of [term "filter"]s of [arg [vset CMD]], 
-[method cget]|[method configure] [option -[vset MODIFIER]-filter] can also be used.
+[method cget]|[method configure] [option -[join [list {*}[vset MODIFIER] filters] -]] can also be used.