


     wwwwiiiisssshhhh((((1111))))                     TTTTkkkk ((((4444....1111))))                      wwwwiiiisssshhhh((((1111))))



     _________________________________________________________________

     NNNNAAAAMMMMEEEE
          wish - Simple windowing shell

     SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
          wwwwiiiisssshhhh ?_f_i_l_e_N_a_m_e _a_r_g _a_r_g ...?

     OOOOPPPPTTTTIIIIOOOONNNNSSSS
          ----ccccoooolllloooorrrrmmmmaaaapppp nnnneeeewwww                                                      ||
                              Specifies that the window should have a   |
                              new private colormap instead of using     |
                              the default colormap for the screen.

          ----ddddiiiissssppppllllaaaayyyy _d_i_s_p_l_a_y    Display (and screen) on which to display
                              window.

          ----ggggeeeeoooommmmeeeettttrrrryyyy _g_e_o_m_e_t_r_y  Initial geometry to use for window.  If
                              this option is specified, its value is
                              stored in the ggggeeeeoooommmmeeeettttrrrryyyy global variable
                              of the application's Tcl interpreter.

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

          ----ssssyyyynnnncccc               Execute all X server commands
                              synchronously, so that errors are
                              reported immediately.  This will result
                              in much slower execution, but it is
                              useful for debugging.

          ----vvvviiiissssuuuuaaaallll _v_i_s_u_a_l                                                     ||
                              Specifies the visual to use for the       |
                              window.  _V_i_s_u_a_l may have any of the       |
                              forms supported by the TTTTkkkk____GGGGeeeettttVVVViiiissssuuuuaaaallll       |
                              procedure.                                |

          --------                                                                 ||
                              Pass all remaining arguments through to   |
                              the script's aaaarrrrggggvvvv variable without        |
                              interpreting them.  This provides a       |
                              mechanism for passing arguments such as   |
                              ----nnnnaaaammmmeeee to a script instead of having wwwwiiiisssshhhh  |
                              interpret them.
     _________________________________________________________________


     DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
          WWWWiiiisssshhhh is a simple program consisting of the Tcl command
          language, the Tk toolkit, and a main program that reads
          commands from standard input or from a file.  It creates a



     Page 1                                          (printed 6/23/96)






     wwwwiiiisssshhhh((((1111))))                     TTTTkkkk ((((4444....1111))))                      wwwwiiiisssshhhh((((1111))))



          main window and then processes Tcl commands.  If wwwwiiiisssshhhh 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 ....wwwwiiiisssshhhhrrrrcccc    |
          in the home directory of the user, wwwwiiiisssshhhh evaluates the file    |
          as a Tcl script just before reading the first command from    |
          standard input.                                               |

          If wwwwiiiisssshhhh is invoked with an initial _f_i_l_e_N_a_m_e argument, then    |
          _f_i_l_e_N_a_m_e is treated as the name of a script file.  WWWWiiiisssshhhh will  |
          evaluate the script in _f_i_l_e_N_a_m_e (which presumably 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 evaluation of ....wwwwiiiisssshhhhrrrrcccc  |
          in this case, but the script file can always ssssoooouuuurrrrcccceeee it if     |
          desired.


     OOOOPPPPTTTTIIIIOOOONNNNSSSS
          WWWWiiiisssshhhh automatically processes all of the command-line options
          described in the OOOOPPPPTTTTIIIIOOOONNNNSSSS summary above.  Any other command-
          line arguments besides these are passed through to the
          application using the aaaarrrrggggcccc and aaaarrrrggggvvvv variables described
          later.


     AAAAPPPPPPPPLLLLIIIICCCCAAAATTTTIIIIOOOONNNN NNNNAAAAMMMMEEEE AAAANNNNDDDD CCCCLLLLAAAASSSSSSSS
          The name of the application, which is used for purposes such  |
          as sssseeeennnndddd commands, is taken from the ----nnnnaaaammmmeeee option, if it is    |
          specified;  otherwise it is taken from _f_i_l_e_N_a_m_e, if it is     |
          specified, or from the command name by which wwwwiiiisssshhhh 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 RRRREEEESSSSOOOOUUUURRRRCCCCEEEE____MMMMAAAANNNNAAAAGGGGEEEERRRR property   |
          or .Xdefaults file, is the same as its name except that the   |
          first letter is capitalized.


     VVVVAAAARRRRIIIIAAAABBBBLLLLEEEESSSS
          WWWWiiiisssshhhh sets the following Tcl variables:

          aaaarrrrggggcccc           Contains a count of the number of _a_r_g
                         arguments (0 if none), not including the
                         options described above.

          aaaarrrrggggvvvv           Contains a Tcl list whose elements are the
                         _a_r_g arguments that follow a -------- option or       |



     Page 2                                          (printed 6/23/96)






     wwwwiiiisssshhhh((((1111))))                     TTTTkkkk ((((4444....1111))))                      wwwwiiiisssshhhh((((1111))))



                         don't match any of the options described in    |
                         OPTIONS above, in order, or an empty string
                         if there are no such arguments.

          aaaarrrrggggvvvv0000          Contains _f_i_l_e_N_a_m_e if it was specified.
                         Otherwise, contains the name by which wwwwiiiisssshhhh
                         was invoked.

          ggggeeeeoooommmmeeeettttrrrryyyy       If the ----ggggeeeeoooommmmeeeettttrrrryyyy option is specified, wwwwiiiisssshhhh     |
                         copies its value into this variable.  If the   |
                         variable still exists after _f_i_l_e_N_a_m_e has been  |
                         evaluated, wwwwiiiisssshhhh uses the value of the          |
                         variable in a wwwwmmmm ggggeeeeoooommmmeeeettttrrrryyyy command to set the   |
                         main window's geometry.

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


     SSSSCCCCRRRRIIIIPPPPTTTT FFFFIIIILLLLEEEESSSS
          If you create a Tcl script in a file whose first line is
               ####!!!!////uuuussssrrrr////llllooooccccaaaallll////bbbbiiiinnnn////wwwwiiiisssshhhh
          then you can invoke the script file directly from your shell
          if you mark it as executable.  This assumes that wwwwiiiisssshhhh 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 characters in length, so be sure
          that the wwwwiiiisssshhhh executable can be accessed with a short file
          name.

          An even better approach is to start your script files with
          the following three lines:                                    |
               ####!!!!////bbbbiiiinnnn////sssshhhh                                                |
               #### tttthhhheeee nnnneeeexxxxtttt lllliiiinnnneeee rrrreeeessssttttaaaarrrrttttssss uuuussssiiiinnnngggg wwwwiiiisssshhhh \\\\                    |
               eeeexxxxeeeecccc wwwwiiiisssshhhh """"$$$$0000"""" """"$$$$@@@@""""                                      |
          This approach has three advantages over the approach in the   |
          previous paragraph.  First, the location of the wwwwiiiisssshhhh binary   |
          doesn't have to be hard-wired into the script:  it can be     |
          anywhere in your shell search path.  Second, it gets around   |
          the 30-character file name limit in the previous approach.    |
          Third, this approach will work even if wwwwiiiisssshhhh is itself a       |
          shell script (this is done on some systems in order to        |
          handle multiple architectures or operating systems:  the      |
          wwwwiiiisssshhhh script selects one of several binaries to run).  The     |
          three lines cause both sssshhhh and wwwwiiiisssshhhh to process the script,     |
          but the eeeexxxxeeeecccc is only executed by sssshhhh.  sssshhhh processes the        |
          script first;  it treats the second line as a comment and     |
          executes the third line.  The eeeexxxxeeeecccc statement cause the shell  |



     Page 3                                          (printed 6/23/96)






     wwwwiiiisssshhhh((((1111))))                     TTTTkkkk ((((4444....1111))))                      wwwwiiiisssshhhh((((1111))))



          to stop processing and instead to start up wwwwiiiisssshhhh to reprocess  |
          the entire script.  When wwwwiiiisssshhhh starts up, it treats all three  |
          lines as comments, since the backslash at the end of the      |
          second line causes the third line to be treated as part of    |
          the comment on the second line.


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


     KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
          shell, toolkit


































     Page 4                                          (printed 6/23/96)



