Index: doc/forward.man.inc
===================================================================
diff -u -r7944f1c82b2b3f6379fcfa4cf3914df136b6cec9 -r74410faa4683cf47d67e7aade09c132f6bf1f87d
--- doc/forward.man.inc	(.../forward.man.inc)	(revision 7944f1c82b2b3f6379fcfa4cf3914df136b6cec9)
+++ doc/forward.man.inc	(.../forward.man.inc)	(revision 74410faa4683cf47d67e7aade09c132f6bf1f87d)
@@ -4,7 +4,7 @@
 [keywords "forward method"]
 [keywords "debugging level"]
 
-[call [arg [vset CMD]] [opt "[method public] | [method protected] | [method private]"] [method "[vset MODIFIER] forward"] [arg methodName] [opt "[option -prefix] [arg prefixName]"] [opt "[option -frame] [const object]"] [opt "[option -returns] [arg valueChecker]"] [opt [option -verbose]] [opt [arg target]] [opt "[arg arg] ..."]]
+[call [arg [vset CMD]] [opt "[method public] | [method protected] | [method private]"] [method "[vset MODIFIER] forward"] [opt [option -debug]] [opt [option -deprecated]] [arg methodName] [opt "[option -prefix] [arg prefixName]"] [opt "[option -frame] [const object]"] [opt "[option -returns] [arg valueChecker]"] [opt [option -verbose]] [opt [arg target]] [opt "[arg arg] ..."]]
 
 Define a [term "forward method"] for the given [vset SCOPE]. The
 definition of a [term "forward method"] registers a predefined, but
@@ -35,7 +35,10 @@
 object variables.
 
 [para]
+To express deprecation of the [term "forward method"] [arg methodName], set the [option "-deprecated"] flag. Deprecated methods remain usable from client code, but their usage will be signaled to the developer and/or can be tracked using [cmd ::nsf::deprecated]. To register [arg methodName] with the debugger, set the [option "-debug"] flag. Entering and exiting a method flagged for debugging can be recorded using [cmd ::nsf::log].
 
+[para]
+
 The list of forwarder arguments [arg arg] can contain as its elements
 a mix of literal values and placeholders. Placeholders are prefixed
 with a percent symbol (%) and substituted for concrete values upon