Index: doc/next-migration.html =================================================================== diff -u -r3fbf51ba5a40e2c77c9ecafb6fef70e51733b91a -r1beeb594c1cd9e222b6e1f419e9a6f5ec0713249 --- doc/next-migration.html (.../next-migration.html) (revision 3fbf51ba5a40e2c77c9ecafb6fef70e51733b91a) +++ doc/next-migration.html (.../next-migration.html) (revision 1beeb594c1cd9e222b6e1f419e9a6f5ec0713249) @@ -2140,8 +2140,8 @@ provide a generalized and highly orthogonal parameter handling with various kinds of value constraints (also called value checker). We divide the parameters into Object Parameters (parameters used for -initializing objects and classes, specified in XOTcl via the method -parameter) and Method Parameters (parameters passed to +initializing objects and classes, specified in XOTcl primarily via the +method parameter) and Method Parameters (parameters passed to methods). The Next Scripting Framework provide a unified, C-implemented infrastructure to handle both, object and method parameters.

@@ -2161,10 +2161,14 @@

based on the same mechanisms.

2.4.1. Object Parameters

-

Object parameters are supported in XOTcl via the method -parameter. Since the term "parameter" is underspecified, NX uses the -term "attribute". To define multiple attributes in a short form, NX -provides the method attributes.

+

Object parameters are used for specifying, how objects should be +initialized (what parameters can be passed in for initialization, what +default values are provided, etc.). Object parameters are supported +in XOTcl primarily via the method parameter, which is used to define +multiple parameters via a list of parameter specifications. Since the +term "parameter" is underspecified, NX uses the term "attribute". To +define multiple attributes in a short form, NX provides the method +attributes.

+

The Object parameters provided by a class for the initialization of +instances can be introspected via /cls/ info parameter (see +[info_parameter]).

2.4.2. Method Parameters

-

The method parameters specifications in XOTcl 1 were limited and -allowed only value constraints for non positional arguments.

+

Method paramters are used to sepcify the interface of a single method +(what kind of values may be passed to a method, what default values +are provided etc.). The method parameters specifications in XOTcl 1 +were limited and allowed only value constraints for non positional +arguments.

NX and XOTcl 2 provide value constraints for all kind of method parameters. While XOTcl 1 required non-positional arguments to be listed in front of positional arguments, this limitation is lifted in XOTcl 2.

@@ -4562,7 +4572,7 @@
-

2.6.10. List Object parameters

+

2.6.10. List Object parameters

# Return the full parameter specs /cls/info parameter spec ?name? +# Return the slot object(s) +/cls/info parameter slot ?name? + # Return in the Tcl parameter syntax /cls/info parameter syntax ?name? @@ -6308,7 +6321,7 @@