lazyset - Lazy evaluation
+The lazyset package provides a mechanism for deferring execution +of code until a specific variable or any index of an array is referenced.
+Arrange for the code specified as commandPrefix to be executed when +the variable whose name is specified by variableName is read for +the first time. +If the optional argument -array boolean is specified as true, +then the variable specified as variableName is treated as an +array and attempting to read any index of the array causes that +index to be set by the commandPrefix as they are read. +If the optional argument -appendArgs boolean is specified as +false, then the variable name and subnames are not appended to the +commandPrefix before it is evaluated. If the argument +-appendArgs boolean is not specified or is specified as true +then 1 or 2 additional arguments are appended to the commandPrefix. +If -array boolean is specified as true, then 2 arguments are +appended corresponding to the name of the variable and the index, +otherwise 1 argument is appended containing the name of variable. +The commandPrefix code is run in the same scope as the variable +is read.
+ ::lazyset::variable page {apply {{name} {
+ package require http
+ set token [http::geturl http://www.tcl.tk/]
+ set data [http::data $token]
+ return $data
+ }}}
+ puts $page
+
+
+ ::lazyset::variable -array true page {apply {{name index} {
+ package require http
+ set token [http::geturl $index]
+ set data [http::data $token]
+ return $data
+ }}}
+ puts $page(http://www.tcl.tk/)
+
+
+ ::lazyset::variable -appendArgs false simple {
+ return -level 0 42
+ }
+ puts $simple
+
+Roy Keene
+This document, and the package it describes, will undoubtedly contain +bugs and other problems. +Please report such in the category utility of the +Tcllib Trackers. +Please also report any ideas for enhancements you may have for either +package and/or documentation.
+When proposing code changes, please provide unified diffs, +i.e the output of diff -u.
+Note further that attachments are strongly preferred over +inlined patches. Attachments can be made by going to the Edit +form of the ticket immediately after its creation, and then using the +left-most button in the secondary navigation bar.
+Utility
+Copyright © 2018 Roy Keene
+] -(Un)suppresses the output of messages having the specified +
(Un)suppresses the output of messages having the specified level. Unique abbreviations for the level are allowed here too.
] -(Un)suppresses the output of messages having the specified level or +
(Un)suppresses the output of messages having the specified level or one of lesser priority. Unique abbreviations for the level are allowed here too.
Asks the package whether the specified level is currently suppressed. Unique abbreviations of level names are allowed.
polygon - like a polyline, but the implicit assumption is that the polyline is closed (if the first and last points do not coincide, the missing segment is automatically added).
point set - again a list of an even number of coordinates, but the points are regarded without any ordering.
circle - a list of thtee numbers, the first two are the coordinates of the +
circle - a list of three numbers, the first two are the coordinates of the centre and the third is the radius.
The package defines the following public procedures:
@@ -584,12 +584,12 @@Circle that may or may not be intersected
Determine the points at which the given two circles intersect. There can be zero, one or two points. (If the two circles touch the circle or are very close, -then one point is returned. An arbitrary margin of 1.0e-10 times the radius of -the first circle is used to determine this situation.)
+then one point is returned. An arbitrary margin of 1.0e-10 times the mean of the radii of +the two circles is used to determine this situation.)First circle
Second circle
math::trig - Trigonometric anf hyperbolic functions
+The math::trig package defines a set of trigonomic and hyperbolic functions +and their inverses. In addition it defines versions of the trigonomic functions +that take arguments in degrees instead of radians.
+For easy use these functions may be imported into the tcl::mathfunc namespace, +so that they can be used directly in the expr command.
+The functions radian_reduced and degree_reduced return a reduced angle, in +respectively radians and degrees, in the intervals [0, 2pi) and [0, 360):
+Return the equivalent angle in the interval [0, 2pi).
+Angle (in radians)
Return the equivalent angle in the interval [0, 360).
+Angle (in degrees)
The following trigonomic functions are defined in addition to the ones defined +in the expr command:
+Calculate the cosecant of the angle (1/cos(angle))
+Angle (in radians)
Calculate the secant of the angle (1/sin(angle))
+Angle (in radians)
Calculate the cotangent of the angle (1/tan(angle))
+Angle (in radians)
For these functions also the inverses are defined:
+Calculate the arc cosecant of the value
+Value of the argument
Calculate the arc secant of the value
+Value of the argument
Calculate the arc cotangent of the value
+Value of the argument
The following hyperbolic and inverse hyperbolic functions are defined:
+Calculate the hyperbolic cosecant of the value (1/sinh(value))
+Value of the argument
Calculate the hyperbolic secant of the value (1/cosh(value))
+Value of the argument
Calculate the hyperbolic cotangent of the value (1/tanh(value))
+Value of the argument
Calculate the arc hyperbolic sine of the value
+Value of the argument
Calculate the arc hyperbolic cosine of the value
+Value of the argument
Calculate the arc hyperbolic tangent of the value
+Value of the argument
Calculate the arc hyperbolic cosecant of the value
+Value of the argument
Calculate the arc hyperbolic secant of the value
+Value of the argument
Calculate the arc hyperbolic cotangent of the value
+Value of the argument
The following versions of the common trigonometric functions and their +inverses are defined:
+Calculate the sine of the angle (in degrees)
+Angle (in degrees)
Calculate the cosine of the angle (in degrees)
+Angle (in radians)
Calculate the cotangent of the angle (in degrees)
+Angle (in degrees)
Calculate the cosecant of the angle (in degrees)
+Angle (in degrees)
Calculate the secant of the angle (in degrees)
+Angle (in degrees)
Calculate the cotangent of the angle (in degrees)
+Angle (in degrees)
This document, and the package it describes, will undoubtedly contain +bugs and other problems. +Please report such in the category math :: trig of the +Tcllib Trackers. +Please also report any ideas for enhancements you may have for either +package and/or documentation.
+When proposing code changes, please provide unified diffs, +i.e the output of diff -u.
+Note further that attachments are strongly preferred over +inlined patches. Attachments can be made by going to the Edit +form of the ticket immediately after its creation, and then using the +left-most button in the secondary navigation bar.
+Mathematics
+Copyright © 2018 Arjen Markus
+namespacex - Namespace utility commands
This package provides a number of utility commands for working with -namespaces.
+namespaces. +The commands fall into four categories: +Hook commands provide and manipulate a chain of commands which +replaces the single regular namespace unknown handler.
An import command provides the ability to import any command +from another namespace.
Information commands allow querying of variables and child +namespaces.
State commands provide a means to serialize variable values in +a namespace.
Adds the cmdprefix to the chain of unknown command handlers that +are invoked when the namespace would otherwise invoke its +unknown handler. +If namespace is not specified, then cmdprefix is added to +the chain of handlers for the namespace of the caller.
+The chain of cmdprefix are executed in reverse order of +addition, i.e. the most recently added cmdprefix is +executed first. +When executed, cmdprefix has additional arguments appended to it +as would any namespace unknown handler.
Adds an anonymous procedure to the chain of namespace unknown handlers +for the namespace.
+If namespace is not specified, then the handler is added +to the chain of handlers for the namespace of the caller.
+The arguments and body are specified as for the +core proc command.
Adds a guarded action to the chain of namespace unknown handlers for +the namespace.
+If namespace is not specified, then the handler is added +to the chain of handlers for the namespace of the caller.
+The guardcmdprefix is executed first. If it returns a +value that can be interpreted as false, then the next unknown hander +in the chain is executed. Otherwise, actioncmdprefix is executed +and the return value of the handler is the value returned by +actioncmdprefix.
+When executed, both guardcmdprefix and +actioncmdprefix have the same additional arguments appended as +for any namespace unknown handler.
This command returns a list containing the names of all child -namespaces in the specified namespace and its children. The -names are all fully qualified.
This command returns a list containing the names of all variables in -the specified namespace and its children. The names are all -relative to namespace, and not fully qualified.
This command returns a list containing the names of all variables in -the specified namespace.
This command returns a dictionary holding the names and values of all -variables in the specified namespace and its child namespaces.
-Note that the names are all relative to namespace, -and not fully qualified.
This command takes a dictionary holding the names and values for a set -of variables and replaces the current state of the specified -namespace and its child namespaces with this state. -The result of the command is the empty string.
This command unsets all variables in the specified namespace and -its child namespaces. -The result of the command is the empty string.
This command is available to namespace hooks to execute the next hook +in the chain of handlers for the namespace.
Imports the command cmdname from the fromns namespace into +the namespace of the caller. +The cmdname command is imported even if the fromns did not +originally export the command.
+If newname is specified, then the imported command will +be known by that name. Otherwise, the command retains is original name +as given by cmdname.
+Additional pairs of cmdname / newname arguments may +also be specified.
Returns a list containing the names of all child namespaces in the +specified namespace and its children. The names are all fully +qualified.
Returns a list containing the names of all variables in the specified +namespace and its children. The names are all given relative to +namespace, and not fully qualified.
Returns the absolute name of namespace, which is resolved +relative to the namespace of the caller, with all unneeded colon +characters removed.
Returns a list containing the names of all variables in +the specified namespace. +If the pattern argument is specified, then only variables +matching pattern are returned. Matching is determined using the +same rules as for string match.
Returns a dictionary holding the names and values of all variables in +the specified namespace and its child namespaces.
+Note that the names are all relative to namespace, and +not fully qualified.
Takes a dictionary holding the names and values for a set of variables +and replaces the current state of the specified namespace and +its child namespaces with this state. +The result of the command is the empty string.
Unsets all variables in the specified namespace and its child +namespaces. +The result of the command is the empty string.
Each item in namespaces must be the absolute normalized name of +a child namespace of namespace prefix. +Returns the corresponding list of relative names of child namespaces.
This document, and the package it describes, will undoubtedly contain +bugs and other problems. +Please report such in the category namespacex of the +Tcllib Trackers. +Please also report any ideas for enhancements you may have for either +package and/or documentation.
+When proposing code changes, please provide unified diffs, +i.e the output of diff -u.
+Note further that attachments are strongly preferred over +inlined patches. Attachments can be made by going to the Edit +form of the ticket immediately after its creation, and then using the +left-most button in the secondary navigation bar.
extended namespace, info, namespace unknown, namespace utilities, state (de)serialization, unknown hooking, utilities
In this form the command returns a dictionary of all supported options, and their current values. The list of supported options and their meaning can be found in section OPTIONS.
In this form the command is an alias for -"::nameserv::cget -option]". +"::nameserv::cget -option". The list of supported options and their meaning can be found in section OPTIONS.
In this form the command is used to configure one or more of the supported options. At least one option has to be specified, and each Index: embedded/www/tcllib/files/modules/nns/nns_server.html ================================================================== --- embedded/www/tcllib/files/modules/nns/nns_server.html +++ embedded/www/tcllib/files/modules/nns/nns_server.html @@ -176,11 +176,11 @@
In this form the command returns a dictionary of all supported options, and their current values. The list of supported options and their meaning can be found in section OPTIONS.
In this form the command is an alias for -"::nameserv::server::cget -option]". +"::nameserv::server::cget -option". The list of supported options and their meaning can be found in section OPTIONS.
In this form the command is used to configure one or more of the supported options. At least one option has to be specified, and each Index: embedded/www/tcllib/files/modules/png/png.html ================================================================== --- embedded/www/tcllib/files/modules/png/png.html +++ embedded/www/tcllib/files/modules/png/png.html @@ -1,5 +1,6 @@ +
lazyset - Lazy evaluation
+The lazyset package provides a mechanism for deferring execution +of code until a specific variable or any index of an array is referenced.
+Arrange for the code specified as commandPrefix to be executed when +the variable whose name is specified by variableName is read for +the first time. +If the optional argument -array boolean is specified as true, +then the variable specified as variableName is treated as an +array and attempting to read any index of the array causes that +index to be set by the commandPrefix as they are read. +If the optional argument -appendArgs boolean is specified as +false, then the variable name and subnames are not appended to the +commandPrefix before it is evaluated. If the argument +-appendArgs boolean is not specified or is specified as true +then 1 or 2 additional arguments are appended to the commandPrefix. +If -array boolean is specified as true, then 2 arguments are +appended corresponding to the name of the variable and the index, +otherwise 1 argument is appended containing the name of variable. +The commandPrefix code is run in the same scope as the variable +is read.
+ ::lazyset::variable page {apply {{name} {
+ package require http
+ set token [http::geturl http://www.tcl.tk/]
+ set data [http::data $token]
+ return $data
+ }}}
+ puts $page
+
+
+ ::lazyset::variable -array true page {apply {{name index} {
+ package require http
+ set token [http::geturl $index]
+ set data [http::data $token]
+ return $data
+ }}}
+ puts $page(http://www.tcl.tk/)
+
+
+ ::lazyset::variable -appendArgs false simple {
+ return -level 0 42
+ }
+ puts $simple
+
+Roy Keene
+This document, and the package it describes, will undoubtedly contain +bugs and other problems. +Please report such in the category utility of the +Tcllib Trackers. +Please also report any ideas for enhancements you may have for either +package and/or documentation.
+When proposing code changes, please provide unified diffs, +i.e the output of diff -u.
+Note further that attachments are strongly preferred over +inlined patches. Attachments can be made by going to the Edit +form of the ticket immediately after its creation, and then using the +left-most button in the secondary navigation bar.
+Utility
+Copyright © 2018 Roy Keene
+