1mtcl ?-qn? ?-f? 4m22mscript24m1m? | ?-c 4m22mcommand24m1m? ?4m22margs24m?

       The  1mtcl  22mstarts  the  interactive  TclX command interpreter.  The TclX
       shell provides an environment for writing, debugging and executing  Tcl
       scripts.  The functionality of the TclX shell can be easily obtained by
       any application that includes TclX.

       The 1mtcl 22mcommand, issued without any arguments, invokes  an  interactive
       Tcl  shell,  allowing the user to interact directly with Tcl, executing
       any Tcl commands at will and viewing their results.

       If 4mscript24m is specified, then the script is  executed  non-interactively
       with  any  additional arguments, 4margs24m, being supplied in the global Tcl
       variable `1margv22m'.  If 4mcommand24m is supplied, then this command  (or  semi-
       colon-separated series of commands) is executed, with `1margv22m' containing
       any 4margs24m.

       The TclX shell is intended as an environment for Tcl  program  develop-
       ment and execution.  While it is not a full-featured interactive shell,
       it provides a comfortable environment for the  interactive  development
       of Tcl code.

       The  following  command line flags are recognized by the Tcl shell com-
       mand line parser:

       1m-q     22mQuick initialization flag.  The Tcl initiaization  file  is  not
              evaluated  and the 1mauto_path 22mvariable is not set.  Tcl auto-load
              libraries will not be available.

       1m-n     22mNo procedure call stack dump.  The procedure call stack will not
              be displayed when an error occurs, only the error message.  Use-
              ful in the #! line of already debugged scripts.

       1m-f     22mTakes the next argument as a script for Tcl  to  source,  rather
              than  entering interactive mode.  The 1m-f 22mflag is optional.  Nor-
              mally the first argument that does not start with a `-' is taken
              as  the  script  to execute unless the `-c' option is specified.
              Any following arguments are passed to the script via 1margv22m,  thus
              any other Tcl shell command-line flags must precede this option.

       1m-c     22mTake the next argument as a Tcl command to execute.  It may con-
              tain  series of commands to execute, separated by `;'.  Any fol-
              lowing arguments are passed in 1margv22m, thus, as with 1m-f22m, any other
              Tcl shell flags must precede this option.

       1m--     22mMark  the  end  of the arguments to the Tcl shell. All arguments
              following this are passed in the Tcl  variable  1margv22m.   This  is
              useful  to  pass  arguments  without attempting to execute a Tcl
              script.

       The result string returned by a command executed  from  the  Tcl  shell
       command  line is normally echoed back to the user.  If an error occurs,
       then the string result is displayed, along with the error message.  The
       error message will be preceded by the string ``Error:''.

       The  1mset  22mcommand is a special case.  If the command is called to set a
       variable (i.e. with two arguments), then the result will not be echoed.
       If  only one argument, the name of a variable, is supplied to 1mset22m, then
       the result will be echoed.

       If an unknown Tcl command is entered from the command  line,  then  the
       Unix  command path, specified in the environment variable 1mPATH22m, will be
       searched for a command of the same name.  If the command is  found,  it
       will  be  executed with any arguments remaining on the Tcl command line
       being passed as arguments to the command.  This feature is provided  to
       enhance the interactive environment for developing Tcl scripts.

       Automatic  execution  of programs in this manner is only supported from
       the command line, not in script files or in procedures, to reduce  con-
       fusion  and  mistakes while programming in Tcl.  Scripts should use the
       Tcl 1mexec 22mor 1msystem 22mcommands to run Unix commands.
