Index: doc/next.man
===================================================================
diff -u
--- doc/next.man	(revision 0)
+++ doc/next.man	(revision 2d52e841337e89ec624790846ca562d8f2deb0c4)
@@ -0,0 +1,60 @@
+[comment {-*- tcl -*- nx::next manpage}]
+[manpage_begin nx::next n 2.0b6]
+
+[copyright {2014 Stefan Sobernig <stefan.sobernig@wu.ac.at>, Gustaf Neumann <gustaf.neumann@wu.ac.at>}]
+[titledesc {Skip to the next most specific method implementation}]
+
+[description] 
+
+[list_begin definitions]
+
+[call [cmd "next"] [opt [arg arguments]]]
+
+This command is invoked inside a method body to call the next most
+specific method implementation in the list of available methods. This
+list of available methods is specific to the current method-call
+context. This context is set by the usage context of [cmd nx::next]
+(method combination vs. method interception; see below). The optional
+[arg "arguments"] are the argument values to be passed into the next
+most specific method implementation. If omitted, the arguments of the
+current method call are automatically forwarded. To call the next most
+specific method implementation without arguments (or to suppress
+argument forwarding), [arg "arguments"] must be set to an empty
+string. To pass an empty string as a (single) argument value, protect
+it as a list. The result of a call to [cmd nx::next] is the result of
+the next most specific method implementation.
+
+If there are no more further applicable methods, the result of [cmd nx::next] will
+depend on its usage context: method combination or
+method interception. If [cmd nx::next] is used in a method body for
+method combination, the result will be an empty string. If [cmd nx::next] is
+used in the body of a filter method for method interception, the
+result will be an error.
+
+[para] 
+
+When executing a method call, the NX dispatch mechanism computes a
+list of applicable method implementations for the method name
+requested from a given object receiving the call; in support of method
+combination and method interception.
+
+[para]
+
+For [emph "method combination"], the computed list contains any object-local
+method implementation and any method implementations inherited by the
+object from the classes in its precedence list. Examples are
+overloading method implementations in the class hierarchy of the
+object, as well as from mixin classes of the object. For [emph "method interception"],
+the computed list contains the applicable filter methods, again
+ordered by their definition order according to the precedence list of the called
+object.
+
+[para]
+
+To retrieve the next most specific method implementation to be invoked
+by [cmd nx::current] from the internally computed list, if any, use
+[cmd "nx::current"].
+
+[list_end]
+
+[manpage_end]