NAME

       tixwish  -  Windowing shell for interpreting Tix commands.


SYNOPSIS

       tixwish ?fileName arg arg ...?


OPTIONS

       -display display    Display (and screen) on which to  dis­
                           play window.

       -geometry geometry  Initial  geometry  to  use for window.
                           If this option is specified, its value
                           is stored in the geometry global vari­
                           able of the application's  Tcl  inter­
                           preter.

       -name name          Use  name as the title to be displayed
                           in the window, and as the name of  the
                           interpreter for send commands.

       -sync               Execute  all  X  server  commands syn­
                           chronously,   so   that   errors   are
                           reported immediately. This will result
                           in much slower execution,  but  it  is
                           useful for debugging.
_________________________________________________________________


DESCRIPTION

       Note:   the  use of the tixwish program is deprecated. You
       should use the standard wish program from  Tk  and  access
       Tix via the "package require Tix" command.

       Tixwish  is a simple program consisting of the Tcl command
       language, the Tk toolkit, the Tix library, and a main pro­
       gram  that  reads  commands  from standard input or from a
       file.  It creates a main window  and  then  processes  Tcl
       commands.   If  tixwish  is  invoked with no arguments, or
       with a first argument that  starts  with  ``-'',  then  it
       reads  Tcl commands interactively from standard input.  It
       will continue processing commands until all  windows  have
       been  deleted  or until end-of-file is reached on standard
       input.  If there exists a  file  .tixwishrc  in  the  home
       directory of the user, tixwish evaluates the file as a Tcl
       script just before reading the first command from standard
       input.

       If  tixwish  is invoked with an initial fileName argument,
       then fileName is treated as the name  of  a  script  file.
       Tixwish  will  evaluate the script in fileName (which pre­
       sumably creates a user interface), then it will respond to
       events until all windows have been deleted.  Commands will
       not be read from standard input.  There  is  no  automatic

       can always source it if desired.


OPTIONS

       Tixwish automatically processes all  of  the  command-line
       options described in the OPTIONS summary above.  Any other
       command-line arguments besides these are passed through to
       the   application   using  the  argc  and  argv  variables
       described later.


APPLICATION NAME AND CLASS

       The name of the application, which is  used  for  purposes |
       such  as send commands, is taken from the -name option, if |
       it is specified;  otherwise it is taken from fileName,  if |
       it is specified, or from the command name by which tixwish |
       was invoked.  In the last two cases, if the name  contains |
       a ``/'' character, then only the characters after the last |
       slash are used as the application name.                    |

       The class of the application, which is used  for  purposes |
       such  as  specifying options with a RESOURCE_MANAGER prop­ |
       erty or .Xdefaults file, is the same as  its  name  except |
       that the first letter is capitalized.


VARIABLES

       Tixwish sets the following Tcl variables:

       argc           Contains a count of the number of arg argu­
                      ments  (0  if  none),  not  including   the
                      options described above.

       argv           Contains  a Tcl list whose elements are the
                      arg arguments (not  including  the  options
                      described  above),  in  order,  or an empty
                      string if there are no arg arguments.

       argv0          Contains  fileName  if  it  was  specified.
                      Otherwise,   contains  the  name  by  which
                      tixwish was invoked.

       geometry       If  the  -geometry  option  is   specified,
                      tixwish  copies  its  value into this vari­
                      able.  If the variable still  exists  after
                      fileName  has  been evaluated, tixwish uses
                      the value of the variable in a wm  geometry
                      command  to set the main window's geometry.

       tcl_interactive
                      Contains 1 if tixwish is  reading  commands
                      interactively  (fileName  was not specified
                      and  standard  input  is  a   terminal-like
                      device), 0 otherwise.

       Tixwish  makes use of several X Resources to determine the
       Toolkit Options for the Tix  library.  These  X  resources
       must  be  set  using  RESOURCE_MANAGER properties or .Xde­
       faults  files  before  tixwish   starts   running.   These
       resources  must  be associated with the main window of the
       tixwish application.  These options include:

       Name:          tixScheme
       Class:         TixScheme

              Specifies the color  scheme  to  use  for  the  Tix
              application.  Currently only these schemes are sup­
              ported: Blue, Gray, SGIGray, TixGray, and TK.

       Name:          tixFontSet
       Class:         TixFontSet

              Specifies the FontSet to use for the  Tix  applica­
              tion.  A  FontSet  designates  the fonts to use for
              different types of widgets.  Currently  only  these
              FontSets are supported: 12Point, 14Point and TK.

       For  example,  you  may  put these two lines in your .Xde­
       faults file
           *tixwish.tixScheme: Gray
           *tixwish.tixFontSet: 12Point


SCRIPT FILES

       If you create a Tcl script in a file whose first line is
                     #!/usr/local/bin/tixwish
       then you can invoke the script  file  directly  from  your
       shell  if  you  mark  it as executable.  This assumes that
       tixwish has been installed  in  the  default  location  in
       /usr/local/bin;  if  it's  installed  somewhere  else then
       you'll have to modify the above line to match.  Many  UNIX
       systems  do not allow the #! line to exceed about 30 char­
       acters in length, so be sure that the  tixwish  executable
       can be accessed with a short file name.


PROMPTS

       When  tixwish is invoked interactively it normally prompts
       for each command with ``% ''.  You can change  the  prompt
       by  setting the variables tcl_prompt1 and tcl_prompt2.  If
       variable tcl_prompt1 exists then it must consist of a  Tcl
       script  to output a prompt; instead of outputting a prompt
       tixwish will evaluate  the  script  in  tcl_prompt1.   The
       variable  tcl_prompt2 is used in a similar way when a new­
       line is typed but the current command isn't yet  complete;
       if  tcl_prompt2  isn't  set  then  no prompt is output for
       incomplete commands.

       shell, wish, Tk, toolkit


Man(1) output converted with man2html