Index: doc/Object.man =================================================================== diff -u -rc4cb0af2d70fbb925613e396747d365823be5465 -rff595808af58a8baf4d8cd40d71334c5ca22e8cc --- doc/Object.man (.../Object.man) (revision c4cb0af2d70fbb925613e396747d365823be5465) +++ doc/Object.man (.../Object.man) (revision ff595808af58a8baf4d8cd40d71334c5ca22e8cc) @@ -407,29 +407,79 @@ [call [arg obj] [method {info info}]] Lists the available [term "submethod"]s of the [method info] [term "method ensemble"]. -[call [arg obj] [method {info lookup configure parameters}] ...] -[para] Description of [method {info lookup configure parameters}] ... +[call [arg obj] [method "info lookup"] [arg submethod] [opt "[arg arg] ..."]] +A collection of submethods to retrieve all structural features (e.g., +configuration options, [term "slot object"]s) and all behavioral +features (e.g., methods, [term "filter"]s) available for [arg obj], whether provided by [arg obj] itself or by the classes in its current linearisation list. +[list_begin definitions] +[def "[arg obj] [method {info lookup configure parameters}] [opt [arg namePattern]]"] -[call [arg obj] [method {info lookup configure syntax}] ...] -[para] Description of [method {info lookup configure syntax}] ... +Returns all configuration options available for [arg obj] as a list of +method-parameter definitions. They can be used, for example, to +define a custom method refinement for [method configure]. The returned +configuration options can be limited to those whose names match [arg pattern] +(see [cmd "string match"]). +[def "[arg obj] [method {info lookup configure syntax}]"] -[call [arg obj] [method {info lookup filter}] ...] -[para] Description of [method {info lookup filter}] ... +[comment {Why is the no pattern arg for the syntax submethod?}] -[call [arg obj] [method {info lookup method}] ...] -[para] Description of [method {info lookup method}] ... +Returns all configuration options available for [arg obj] as a +concrete-syntax description to be used in human-understandable +messages (e.g., errors or warnings, documentation strings). -[call [arg obj] [method {info lookup methods}] ...] -[para] Description of [method {info lookup methods}] ... +[def "[arg obj] [method "info lookup filter"] [arg name]"] -[call [arg obj] [method {info lookup slots}] ...] -[para] Description of [method {info lookup slots}] ... +[comment { + why is there no lookup filters plus optional pattern, like + methods. singular form should return method handle behind filter ... +}] -[call [arg obj] [method {info lookup variables}] ...] -[para] Description of [method {info lookup variables}] ... +[def "[arg obj] [method "info lookup method"] [arg name]"] +Returns the [term "method handle"] for a method [arg name] if a +so-named method can be invoked on [arg obj]. If there is no method +[arg name], an empty string is returned. + +[def "[arg obj] [method "info lookup methods"] [opt [arg namePattern]]"] + +Returns the names of all methods (including aliases and forwarders) +which can be invoked on [arg obj]. The returned methods can be limited +to those whose names match [arg namePattern] (see [cmd "string match"]). + +[def "[arg obj] [method "info lookup slots"] [opt "[option "-type"] [arg className]"] [opt "[option "-source"] all | application | system"] [opt [arg namePattern]]"] + +Returns the command names of all [term "slot object"]s responsible for +managing properties, variables, and relations of [arg obj]. The +returned [term "slot object"]s can be limited according to any or a +combination of the following criteria: First, [term "slot object"]s +can be filtered based on their command names matching [arg namePattern] (see [cmd "string +match"]). Second, [option "-type"] allows to select +[term "slot object"]s which are instantiated from a subclass [arg className] of [cmd nx::Slot] (default: [cmd nx::Slot]) . Third, [option -source] restricts [term "slot object"]s returned according to their provenance in either the NX [emph system] classes or the [emph application] classes present in the linearisation list of [arg obj] (default: [emph all]). + +[para] + +To extract details of each [term "slot object"], use the [method info] +submethods available for each [term "slot object"]. + +[def "[arg obj] [method "info lookup variables"]"] + +Returns the command names of all [term "slot object"]s responsible for +managing properties and variables of [arg obj], if provided by [arg obj] or the classes in the linearisation list of [arg obj]. + +[para] + +This is equivalent to calling: [arg obj] [method "info lookup slots"] -type ::nx::VariableSlot -source all [opt [arg namePattern]]. + +[para] + +To extract details of each [term "slot object"], use the [method info] +submethods available for each [term "slot object"]. + + +[list_end] + [call [arg obj] [method {info name}]] Returns the unqualified name of an object, i.e., the object name @@ -465,12 +515,6 @@ [call [arg obj] [method {info object method parameters}] ...] [para] Description of [method {info object method parameters}] ... -[call [arg obj] [method {info object method postcondition}] ...] -[para] Description of [method {info object method postcondition}] ... - -[call [arg obj] [method {info object method precondition}] ...] -[para] Description of [method {info object method precondition}] ... - [call [arg obj] [method {info object method registrationhandle}] ...] [para] Description of [method {info object method registrationhandle}] ... @@ -526,7 +570,7 @@ order of the [term linearisation] scheme in [term NX]. By setting the [term switch] [option -intrinsic], only classes which participate in superclass/subclass relationships (i.e., intrinsic classes) are -returned. If a [arg pattern] is provided, only nested classes whose +returned. If a [arg pattern] is provided, only classes whose names match [arg pattern] are returned. The [arg pattern] string can contain special matching characters (see [cmd "string match"]).