Index: TODO
===================================================================
diff -u -N -rdf69a2729a1b835c38c170cb7439240089b86c6e -r2488a3699c78579fb1f4f1b4f2a8366946287fe5
--- TODO	(.../TODO)	(revision df69a2729a1b835c38c170cb7439240089b86c6e)
+++ TODO	(.../TODO)	(revision 2488a3699c78579fb1f4f1b4f2a8366946287fe5)
@@ -5329,9 +5329,10 @@
 - adapt mixinof.test to the additional information
 - transform mixinof.test to newer style regression test with automated object deletion
 
+- updated migration guide and tutorial to reflect recent changes
+
 ========================================================================
 TODO:
-- update migration guide/tutorial
 
 - should we change "/obj/ info lookup syntax /methodName/" to return obj and method as well?
   (similar to "info method syntax /methodName/")
Index: doc/next-migration.html
===================================================================
diff -u -N -r3fe3b9ed6500be19a27cbd4a0dd212a47b142194 -r2488a3699c78579fb1f4f1b4f2a8366946287fe5
--- doc/next-migration.html	(.../next-migration.html)	(revision 3fe3b9ed6500be19a27cbd4a0dd212a47b142194)
+++ doc/next-migration.html	(.../next-migration.html)	(revision 2488a3699c78579fb1f4f1b4f2a8366946287fe5)
@@ -1027,7 +1027,7 @@
 <tfoot>
 <tr>
 <td align="left" valign="top"><p class="table">Total</p></td>
-<td align="right" valign="top"><p class="table">46</p></td>
+<td align="right" valign="top"><p class="table">45</p></td>
 <td align="right" valign="top"><p class="table">124</p></td>
 </tr>
 </tfoot>
@@ -1044,7 +1044,7 @@
 </tr>
 <tr>
 <td align="left" valign="top"><p class="table">Info-methods for Objects</p></td>
-<td align="right" valign="top"><p class="table">12</p></td>
+<td align="right" valign="top"><p class="table">11</p></td>
 <td align="right" valign="top"><p class="table">25</p></td>
 </tr>
 <tr>
@@ -3272,8 +3272,9 @@
 </tbody>
 </table>
 </div>
-<div class="paragraph"><p>The configure parameters provided by a class for the initialization of
-instances can be introspected via <code>/cls/ info configure parameters</code>
+<div class="paragraph"><p>The parameters provided by a class for the initialization of
+instances can be introspected via querying the parameters
+of the method create: <code>/cls/ info lookup parameters create</code>
 (see <a href="#info_configure_parameter">[info_configure_parameter]</a>).</p></div>
 </div>
 <div class="sect3">
@@ -4644,11 +4645,11 @@
 </div>
 <div class="sect3">
 <h4 id="info_configure_parameter">2.6.7. List Configure Parameters</h4>
-<div class="paragraph"><p>Obtain information, how newly created object can be configured. The
-configuration of objects is performed in many languages over arguments
-to the constructors. NX has - what we think - a superiour approach for
-configuration via configure parameters. The configure parameter are
-defined by NX application programs usually via <code>property</code>.</p></div>
+<div class="paragraph"><p>The way, how newly created objects can be configured is determined in NX
+via properties. The configuration happens during creation via the
+methods <code>create</code> or <code>new</code> or during runtime via <code>configure</code>. These
+methods have therefore virtual argument lists, depending on the object
+or class on which they are applied.</p></div>
 <div class="tableblock">
 <table rules="all"
 width="100%"
@@ -4687,40 +4688,36 @@
 .nx-placeholder {color: #AF663F; font-weight: normal; font-style: italic;}
 .nx-variable    {color: #AF663F; font-weight: normal; font-style: normal;}
 </style>
-<pre class='nx'><span class='nx-comment'># Return configure parameter(s), the parameters
-</span><span class='nx-comment'># provided by a class for its instances; these
-</span><span class='nx-comment'># parameters define, how objects of this
+<pre class='nx'><span class='nx-comment'># Return the parameters applicable to
+</span><span class='nx-comment'># the create method of a certain class.
 </span><span class='nx-comment'># class can be configured. A pattern can
 </span><span class='nx-comment'># be used to filter the results.
 </span>
-<span class='nx-placeholder'>/cls/</span> <span class='nx-keyword'>info</span> <span class='nx-keyword'>configure</span> parameters <span class='nx-placeholder'>?pattern?</span>
+<span class='nx-placeholder'>/cls/</span> <span class='nx-keyword'>info</span> <span class='nx-keyword'>lookup</span> parameters <span class='nx-keyword'>create</span> ?<span class='nx-placeholder'>/pattern/</span>?
 
-<span class='nx-comment'># Return in the Tcl parameter syntax
+<span class='nx-comment'># Return in the result in documentation syntax
 </span>
-<span class='nx-placeholder'>/cls/</span> <span class='nx-keyword'>info</span> <span class='nx-keyword'>configure</span> syntax
+<span class='nx-placeholder'>/cls/</span> <span class='nx-keyword'>info</span> <span class='nx-keyword'>lookup</span> syntax <span class='nx-keyword'>create</span> ?<span class='nx-placeholder'>/pattern/</span>?
 
-<span class='nx-comment'># "info lookup configure parameters" returns
+<span class='nx-comment'># "info lookup parameters configure" returns
 </span><span class='nx-comment'># parameters available for configuring the
 </span><span class='nx-comment'># current object  (might contain object
 </span><span class='nx-comment'># specific information)
 </span>
-<span class='nx-placeholder'>/obj/</span> <span class='nx-keyword'>info</span> <span class='nx-keyword'>lookup</span> <span class='nx-keyword'>configure</span> parameters <span class='nx-placeholder'>?pattern?</span>
+<span class='nx-placeholder'>/obj/</span> <span class='nx-keyword'>info</span> <span class='nx-keyword'>lookup</span> parameters <span class='nx-keyword'>configure</span> <span class='nx-placeholder'>?pattern?</span>
 
-
 <span class='nx-comment'># "info lookup configure syntax" returns syntax of
 </span><span class='nx-comment'># a call to configure in the Tcl parameter syntax
 </span>
-<span class='nx-placeholder'>/obj/</span> <span class='nx-keyword'>info</span> <span class='nx-keyword'>lookup</span> <span class='nx-keyword'>configure</span> syntax
-<span class='nx-comment'># short form
-</span><span class='nx-placeholder'>/obj/</span> <span class='nx-keyword'>info</span> <span class='nx-keyword'>configure</span>
+<span class='nx-placeholder'>/obj/</span> <span class='nx-keyword'>info</span> <span class='nx-keyword'>lookup</span> syntax <span class='nx-keyword'>configure</span>
 
 <span class='nx-comment'># Obtain information from a parameter
-</span><span class='nx-comment'># (as e.g. returned from "info configure
-</span><span class='nx-comment'># parameters").
+</span><span class='nx-comment'># (as e.g. returned from "info lookup
+</span><span class='nx-comment'># parameters configure").
 </span>
-nsf::parameter::get name <span class='nx-placeholder'>/parameter/</span>
-nsf::parameter::get syntax <span class='nx-placeholder'>/parameter/</span>
-nsf::parameter::get type <span class='nx-placeholder'>/parameter/</span></pre></div></div></div></td>
+nsf::parameter::info name <span class='nx-placeholder'>/parameter/</span>
+nsf::parameter::info syntax <span class='nx-placeholder'>/parameter/</span>
+nsf::parameter::info type <span class='nx-placeholder'>/parameter/</span></pre></div></div></div></td>
 </tr>
 </tbody>
 </table>
@@ -5220,7 +5217,8 @@
 <pre class='nx'><span class='nx-comment'># List objects, where /cls/ is a
 </span><span class='nx-comment'># per-object mixin
 </span>
-<span class='nx-placeholder'>/cls/</span> <span class='nx-keyword'>info</span> mixinof -scope <span class='nx-keyword'>object</span> <span class='nx-placeholder'>?-closure?</span> <span class='nx-placeholder'>?pattern?</span></pre></div></div></div></td>
+<span class='nx-placeholder'>/cls/</span> <span class='nx-keyword'>info</span> mixinof -scope <span class='nx-keyword'>object</span> <span class='nx-placeholder'>?-closure?</span> \
+   <span class='nx-placeholder'>?pattern?</span></pre></div></div></div></td>
 </tr>
 <tr>
 <td align="left" valign="middle"><div><div class="listingblock">
@@ -5248,7 +5246,8 @@
 </style>
 <pre class='nx'><span class='nx-comment'># List classes, where /cls/ is a per-class mixin
 </span>
-<span class='nx-placeholder'>/cls/</span> <span class='nx-keyword'>info</span> mixinof -scope <span class='nx-keyword'>class</span> <span class='nx-placeholder'>?-closure?</span> <span class='nx-placeholder'>?pattern?</span></pre></div></div></div></td>
+<span class='nx-placeholder'>/cls/</span> <span class='nx-keyword'>info</span> mixinof -scope <span class='nx-keyword'>class</span> <span class='nx-placeholder'>?-closure?</span> \
+   <span class='nx-placeholder'>?pattern?</span></pre></div></div></div></td>
 </tr>
 <tr>
 <td align="left" valign="middle"><div><div class="listingblock">
@@ -5277,7 +5276,8 @@
 <pre class='nx'><span class='nx-comment'># List objects and classes, where /cls/ is
 </span><span class='nx-comment'># either a per-object or a per-class mixin
 </span>
-<span class='nx-placeholder'>/cls/</span> <span class='nx-keyword'>info</span> mixinof -scope all <span class='nx-placeholder'>?-closure?</span> <span class='nx-placeholder'>?pattern?</span></pre></div></div>
+<span class='nx-placeholder'>/cls/</span> <span class='nx-keyword'>info</span> mixinof -scope all <span class='nx-placeholder'>?-closure?</span> \
+   <span class='nx-placeholder'>?pattern?</span></pre></div></div>
 <div class="listingblock">
 <div class="content"><style type='text/css'>
 .nx             {color: #000000; font-weight: normal; font-style: normal; padding-left: 10px}
@@ -6358,7 +6358,7 @@
 <div id="footer">
 <div id="footer-text">
 Version 2.0b5<br />
-Last updated 2014-05-29 17:15:16 CEST
+Last updated 2014-06-01 17:28:33 CEST
 </div>
 </div>
 </body>
Index: doc/next-migration.txt
===================================================================
diff -u -N -r729b49eb1dcb08183a0ed41588416a923271811a -r2488a3699c78579fb1f4f1b4f2a8366946287fe5
--- doc/next-migration.txt	(.../next-migration.txt)	(revision 729b49eb1dcb08183a0ed41588416a923271811a)
+++ doc/next-migration.txt	(.../next-migration.txt)	(revision 2488a3699c78579fb1f4f1b4f2a8366946287fe5)
@@ -184,9 +184,9 @@
 ||NX|XOTcl
 |Methods for Objects           |14|  51
 |Methods for Classes           |  9|  24
-|Info-methods for Objects  |12|  25
+|Info-methods for Objects  |11|  25
 |Info-methods for Classes  |11|  24
-|Total                                  | 46|124
+|Total                                  | 45|124
 |======================
 
 This comparison list compares mostly XOTcl 1 with NX, some features
@@ -1515,8 +1515,9 @@
 ----------------
 |======================
 
-The configure parameters provided by a class for the initialization of
-instances can be introspected via +/cls/ info configure parameters+ 
+The parameters provided by a class for the initialization of
+instances can be introspected via querying the parameters
+of the method create: +/cls/ info lookup parameters create+ 
 (see <<info_configure_parameter>>).
 
 ==== Delete Variable Handlers
@@ -2190,11 +2191,11 @@
 
 [[info_configure_parameter]]
 ==== List Configure Parameters
-Obtain information, how newly created object can be configured. The
-configuration of objects is performed in many languages over arguments
-to the constructors. NX has - what we think - a superiour approach for
-configuration via configure parameters. The configure parameter are
-defined by NX application programs usually via +property+.
+The way, how newly created objects can be configured is determined in NX
+via properties. The configuration happens during creation via the
+methods +create+ or +new+ or during runtime via +configure+. These
+methods have therefore virtual argument lists, depending on the object
+or class on which they are applied.
 
 [options="header",cols="asciidoc,asciidoc",frame="none",valign="middle"]
 |======================
@@ -2206,36 +2207,32 @@
 ----------------
 |[source,tcl]
 ----------------
-# Return configure parameter(s), the parameters
-# provided by a class for its instances; these
-# parameters define, how objects of this
+# Return the parameters applicable to 
+# the create method of a certain class.
 # class can be configured. A pattern can
 # be used to filter the results.
 
-/cls/ info configure parameters ?pattern?
+/cls/ info lookup parameters create ?/pattern/?
 
-# Return in the Tcl parameter syntax
+# Return in the result in documentation syntax
 
-/cls/ info configure syntax
+/cls/ info lookup syntax create ?/pattern/?
 
-# "info lookup configure parameters" returns 
+# "info lookup parameters configure" returns 
 # parameters available for configuring the 
 # current object  (might contain object 
 # specific information)
 
-/obj/ info lookup configure parameters ?pattern?
+/obj/ info lookup parameters configure ?pattern?
 
-
 # "info lookup configure syntax" returns syntax of 
 # a call to configure in the Tcl parameter syntax
 
-/obj/ info lookup configure syntax
-# short form
-/obj/ info configure
+/obj/ info lookup syntax configure
 
 # Obtain information from a parameter 
-# (as e.g. returned from "info configure
-# parameters").
+# (as e.g. returned from "info lookup 
+# parameters configure").
 
 nsf::parameter::info name /parameter/
 nsf::parameter::info syntax /parameter/
@@ -2487,7 +2484,8 @@
 # List objects, where /cls/ is a 
 # per-object mixin
 
-/cls/ info mixinof -scope object ?-closure? ?pattern?
+/cls/ info mixinof -scope object ?-closure? \
+   ?pattern?
 ----------------
 |[source,tcl]
 ----------------
@@ -2497,7 +2495,8 @@
 ----------------
 # List classes, where /cls/ is a per-class mixin
 
-/cls/ info mixinof -scope class ?-closure? ?pattern?
+/cls/ info mixinof -scope class ?-closure? \
+   ?pattern?
 ----------------
 |[source,tcl]
 ----------------
@@ -2508,7 +2507,8 @@
 # List objects and classes, where /cls/ is
 # either a per-object or a per-class mixin
 
-/cls/ info mixinof -scope all ?-closure? ?pattern?
+/cls/ info mixinof -scope all ?-closure? \
+   ?pattern?
 ----------------
 [source,tcl]
 ----------------
Index: doc/next-tutorial/next-tutorial.html
===================================================================
diff -u -N -r3fe3b9ed6500be19a27cbd4a0dd212a47b142194 -r2488a3699c78579fb1f4f1b4f2a8366946287fe5
--- doc/next-tutorial/next-tutorial.html	(.../next-tutorial.html)	(revision 3fe3b9ed6500be19a27cbd4a0dd212a47b142194)
+++ doc/next-tutorial/next-tutorial.html	(.../next-tutorial.html)	(revision 2488a3699c78579fb1f4f1b4f2a8366946287fe5)
@@ -3780,29 +3780,27 @@
  14
 </pre></td><td class='nx-body'><pre class='nx'>Configure parameters <span class='nx-keyword'>for</span> Person p1:
    Command:
-      p1 <span class='nx-keyword'>info</span> <span class='nx-keyword'>configure</span>
+      p1 <span class='nx-keyword'>info</span> <span class='nx-keyword'>lookup</span> syntax <span class='nx-keyword'>configure</span>
    Result:
       -name <span class='nx-placeholder'>/value/</span> ?-birthday <span class='nx-placeholder'>/value/</span>? ?-object-mixin /mixinreg .../<span class='nx-placeholder'>?
       ?</span>-class /<span class='nx-keyword'>class</span>/? ?-object-filter /filterreg .../? ?/__initblock/?
 
 Configure parameter <span class='nx-keyword'>for</span> Student s1:
    Command:
-      s1 <span class='nx-keyword'>info</span> <span class='nx-keyword'>configure</span>
+      s1 <span class='nx-keyword'>info</span> <span class='nx-keyword'>lookup</span> syntax <span class='nx-keyword'>configure</span>
    Result:
       ?-oncampus <span class='nx-placeholder'>/boolean/</span>? -matnr <span class='nx-placeholder'>/value/</span> -name <span class='nx-placeholder'>/value/</span>
       ?-birthday <span class='nx-placeholder'>/value/</span>? ?-object-mixin /mixinreg .../? ?-class /<span class='nx-keyword'>class</span>/<span class='nx-placeholder'>?
       ?</span>-object-filter /filterreg .../? ?/__initblock/?</pre></td></tr></table></div></div>
-<div class="literalblock">
-<div class="content">
-<pre><code>+p1 info configure+
-+Person info configure syntax+</code></pre>
-</div></div>
-<div class="paragraph"><p>The actual values can be obtained via introspection
-from an object via
-<code>p1 info lookup configure parameters</code> on an actual object
+<div class="paragraph"><p>The given paramter show, how (a) objects can be configured
+at runtime or (b) how new instances can be configured
+at creation time via the <code>new</code> or <code>create</code> methods.
+Introspection can be used to obtain the configuration
+parameters from an object via
+<code>p1 info lookup parameters configure</code>
 (returning the configure parameters currently applicable for
-<code>configure</code> or <code>cget</code> or on a class
-<code>Person info configure syntax</code> on a class
+<code>configure</code> or <code>cget</code>) or from a class
+<code>Person info lookup parameters create</code> on a class
 (returning the configure parameters applicable when an object
 of this class is created)</p></div>
 <div class="paragraph"><p>The listed configure parameter types <code>mixinreg</code> and
@@ -3859,13 +3857,11 @@
   7
 </pre></td><td class='nx-body'><pre class='nx'>Configure parameter <span class='nx-keyword'>for</span> <span class='nx-keyword'>class</span> <span class='nx-keyword'>nx::Class</span>
    Command:
-      <span class='nx-keyword'>nx::Class</span> <span class='nx-keyword'>info</span> <span class='nx-keyword'>configure</span>
+      <span class='nx-keyword'>nx::Class</span> <span class='nx-keyword'>info</span> <span class='nx-keyword'>lookup</span> syntax <span class='nx-keyword'>configure</span>
    Result:
       ?-superclass /<span class='nx-keyword'>class</span> .../? ?-mixin /mixinreg .../<span class='nx-placeholder'>?
       ?</span>-filter /filterreg .../? ?-object-mixin /mixinreg .../<span class='nx-placeholder'>?
       ?</span>-class /<span class='nx-keyword'>class</span>/? ?-object-filter /filterreg .../? ?/__initblock/?</pre></td></tr></table></div></div>
-<div class="paragraph"><p>The actual values can be obtained via introspection via
-<code>nx::Class info configure</code></p></div>
 </div>
 <div class="sect3">
 <h4 id="_user_defined_parameter_types">4.3.3. User defined Parameter Types</h4>
@@ -4160,7 +4156,7 @@
 <div id="footer">
 <div id="footer-text">
 Version 2.0b5<br />
-Last updated 2014-05-29 21:02:50 CEST
+Last updated 2014-06-01 17:23:28 CEST
 </div>
 </div>
 </body>
Index: doc/next-tutorial/next-tutorial.txt
===================================================================
diff -u -N -r3fe3b9ed6500be19a27cbd4a0dd212a47b142194 -r2488a3699c78579fb1f4f1b4f2a8366946287fe5
--- doc/next-tutorial/next-tutorial.txt	(.../next-tutorial.txt)	(revision 3fe3b9ed6500be19a27cbd4a0dd212a47b142194)
+++ doc/next-tutorial/next-tutorial.txt	(.../next-tutorial.txt)	(revision 2488a3699c78579fb1f4f1b4f2a8366946287fe5)
@@ -2175,29 +2175,29 @@
 --------------------------------------------------
 Configure parameters for Person p1: 
    Command:   
-      p1 info configure
+      p1 info lookup syntax configure
    Result: 
       -name /value/ ?-birthday /value/? ?-object-mixin /mixinreg .../? 
       ?-class /class/? ?-object-filter /filterreg .../? ?/__initblock/?
 
 Configure parameter for Student s1:
    Command:   
-      s1 info configure
+      s1 info lookup syntax configure
    Result: 
       ?-oncampus /boolean/? -matnr /value/ -name /value/ 
       ?-birthday /value/? ?-object-mixin /mixinreg .../? ?-class /class/?
       ?-object-filter /filterreg .../? ?/__initblock/?
 --------------------------------------------------
 
-  +p1 info configure+
-  +Person info configure syntax+
-
-The actual values can be obtained via introspection 
-from an object via 
-+p1 info lookup configure parameters+ on an actual object
+The given paramter show, how (a) objects can be configured 
+at runtime or (b) how new instances can be configured 
+at creation time via the +new+ or +create+ methods.
+Introspection can be used to obtain the configuration
+parameters from an object via
++p1 info lookup parameters configure+ 
 (returning the configure parameters currently applicable for
-+configure+ or +cget+ or on a class
-+Person info configure syntax+ on a class 
++configure+ or +cget+) or from a class
++Person info lookup parameters create+ on a class 
 (returning the configure parameters applicable when an object
 of this class is created)
 
@@ -2245,16 +2245,13 @@
 --------------------------------------------------
 Configure parameter for class nx::Class
    Command:   
-      nx::Class info configure
+      nx::Class info lookup syntax configure
    Result: 
       ?-superclass /class .../? ?-mixin /mixinreg .../? 
       ?-filter /filterreg .../? ?-object-mixin /mixinreg .../? 
       ?-class /class/? ?-object-filter /filterreg .../? ?/__initblock/?
 --------------------------------------------------
 
-The actual values can be obtained via introspection via
-+nx::Class info configure+
-
 ==== User defined Parameter Types
 
 More detailed definition of the configure parameter types comes here.