procedure
                        :text           name

Creates a text widget within the current panel frame for the TCL interpreter. A
text widget is a frame window containing a label window and an entry window.
name is used to generate the path name of the windows to be created. It
should have the format of a widget name  (e.g.  :text   TXT) and should be
unique within this interpreter. The name will be lower-cased (using the string
tolower command) in order to generate the path name used to create the
windows.
When the return key is pressed while the keyboard focus is on the entry
window then ,if available, the TCL script supplied using the :command
parameter will be executed. If this is not available the TCL command
click  FRAME “ ” TEXT text-string
will be executed where FRAME and TEXT are widget names and text-string
is the information entered in the entry window.
The path names generated have the root framename.panelname.textname
and the items label and entry.
The :text procedure may also be used directly within a frame window (i.e. before any panel
window has been created).

Normally it is necessary when typing information into the entry window to press the return key
in order to generate an event and cause the procedure linked to the entry to be executed.
Often users fail to do this and so a binding is made to the mouse focus and the contents of the
entry window are checked whenever the mouse focus leaves the entry window. If  information
is found to have been typed into the entry window which has not been seen by a return key
event then an action is taken as is the return key had been pressed.

The :text procedure may have a number of arguments however none of
these is manditory.

        arguments
                        :x                      number
        number is the x-co-ordinate within the current panel of the text widget
in pixels
        e.g.    :x 40

                        :y                      number
        number is the y-co-ordinate within the current panel of the text widget
in pixels
        e.g.    :y 20
The :x and :y parameters may be omitted in which case the packer geometry manager will be
used and the position of the window will be determined by the contents of the master (panel)
window. If however the :x and :y parameters are supplied then the placer geometry manager
will be used to position the window within the master (panel) window.
Warning:        Note that it is not possible to mix use of the packer and placer geometry
managers within the same window. Thus all windows within a panel must request or imply that
the same geometry manager is used.


                        :w                      number
        number is the width of the text entry window in characters and is also
used to calculate the width of the text widget..
        e.g.    :w   20

                        :h                      number
        number is the height of the text widget in pixels.
        e.g.    :h   20
The :w and/or :h parameters may be omitted in which case the size of the text widget will be
determined by its contents. If however the :w and :h parameters are supplied then these will
be used to configure the text window. Normally :h will not be supplied.

                        :valuex         value
        value is the position of the left hand edge of the entry window with
relation to the left hand edge of the text widget. It is thus the space available
to write the label string but also allows alignment of the entry windows of
several text widgets. The value may be expressed in units of pixels or
characters.
        e.g.    :valuex 100    (pixels);        :valuex 15c    (characters)

                        :label                  string
        string is a text string to be written into the label component of the text
widget.
The default is the name of the button widget.

                        :value                  string
        string is a text string to be written initially into the entry component of
the text widget.
The default is a null string.

                        :shifters               T|F
        If the option T is supplied then small buttons are placed at each end of
the entry widget which can be used to scroll the contents of the entry right or
left in the case when the width of the contents of the entry is greater than the
physical width of the entry widget.
The default is that these buttons are not drawn.

                        :read-only              T|F
        This is an alias for :deaf supplied for compatibility with existing scripts.

                        :size                   S|N|L
        Specifies the size of the font to be used for characters in the label and
entry windows. Options available are small (S); normal (N) and large (L).
The default is that size N (normal) is used.

                        :command                string
        string is any TCL command or commands to be executed when the
keyboard return key is pressed.
If a command is supplied and executed in this manner then the click procedure is not
invoked.

See also common procedure arguments defined later in this document.