procedure
                        :gauge          name

Creates a gauge widget within the current panel frame for the TCL interpreter.
A gauge widget is a frame window containing three label windows and a scale
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.  :gauge   GG) 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.
A gauge widget is not interactive.
The path names generated have the root framename.panelname.gauge-
name and the items label, min, max and scale.
The :gauge procedure may also be used directly within a frame window (i.e. before any panel
window has been created).


The :gauge procedure may have a number of arguments however none of
these is mandatory.

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

                        :y                      number
        number is the y-co-ordinate within the current panel of the gauge
widget in pixels
        e.g.    :y 200
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 gauge widget in pixels.
        e.g.    :w 200
The default action is to allow the geometry manager to determine the size of the widget.

                        :h                      number
        number is the height of the gauge widget in pixels.
        e.g.    :h 24
The default value is 1 character height.

                        :value                  value
        value is the initial value of the gauge scale and determines the position
of the divider.
The default value is 0.

                        :min                    value
        value is the minimum value of the gauge scale.

                        :max                    value
        value is the maximum value of the gauge scale.

                        :valuex         value
        value is the position of the right hand edge of the label window with
relation to the left hand edge of the scale widget. It is thus the space available
to write the label string which is right justified within the label window. 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
gauge widget.
The default is the name of the gauge widget.

                        :gauge-width    value
        value is the width of the gauge widget in pixels.
The default value is 80.

                        :gauge-height   value
        value is the length of the gauge widget in pixels.
The default value is 1/10 of the gauge width.

                        :max-tick-label string
        string is a text string to be used for the label at the right hand end of
the gauge.
By default the label shows the maximum value of the gauge scale.

                        :min-tick-label string
        string is a text string to be used for the label at the left hand end of the
gauge.
By default the label shows the minimum value of the gauge scale.

See also common procedure arguments defined later in this document.