tclsh(1)                       Tcl Applications                       tclsh(1)

______________________________________________________________________________

<?><?><?> (NAME)
       tclsh - <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> Tcl

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       tclsh ?-encoding name? ?fileName arg arg ...?
______________________________________________________________________________

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?> tclsh <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?> Tcl <?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> Tcl <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?>
       <?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?>.  <?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> exit <?><?><?><?><?><?><?><?>
       <?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> (EOF) <?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?> .tclshrc (<?><?> tclshrc.tcl <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>) <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> tclsh <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> Tcl <?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> (SCRIPT FILES)
       <?><?><?> tclsh <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>. <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> (<?><?>
       <?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?>).  <?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> tclsh <?><?><?><?><?><?><?> Tcl <?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> tclsh <?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?> "\032" ("\u001a"<?> control-Z).
       <?><?><?><?> <?><?><?><?>.  <?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> tclsh <?><?><?> <?><?> <?><?> <?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> (<?><?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?>) <?><?><?><?><?><?><?><?>. <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?> "\032"<?>
       "\x1A"<?> <?><?> "\u001a"<?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> format <?><?> binary
       <?><?><?><?><?> <?><?><?>.  <?><?><?><?><?><?> <?><?> <?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> tclsh
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> .tclshrc <?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?> <?><?><?><?><?> source <?><?><?><?><?><?><?><?> <?><?><?>.

       <?><?><?> <?><?> <?><?><?><?><?><?><?> Tcl <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?> <?><?><?><?>:

              #!/usr/local/bin/tclsh

       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?>.  <?><?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?> tclsh <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> /usr/local/bin <?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?>.
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
       <?><?> #! <?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> tclsh
       <?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?>.

       <?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?> <?><?><?>
       <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?> <?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?>:

              #!/bin/sh
              # the next line restarts using tclsh \
              exec tclsh "$0" ${1+"$@"}

       <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>. <?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> tclsh <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> (hard-
       wired) <?><?><?><?> <?><?><?><?> <?><?><?>: <?><?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?>. <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?> tclsh <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?> (<?><?><?> <?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>: <?><?><?><?><?><?><?> tclsh
       <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>).
       <?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?> sh <?> tclsh <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> exec <?><?><?><?> <?><?><?><?> sh
       <?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?><?> sh
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?> <?><?> <?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?><?> exec <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?> <?><?> <?><?><?> <?><?> tclsh <?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?>.
       <?><?><?><?><?><?> <?><?> tclsh <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?>.

       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?> tclsh <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?><?>.
       <?><?><?> <?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> Tcl <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> Tcl <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (VARIABLES)
       tclsh <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> Tcl <?><?><?><?><?>
       <?><?><?><?><?><?><?> (<?><?><?><?><?> env <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> PATH <?><?>
       <?><?> Tcl <?><?><?><?><?> <?><?><?><?><?><?>)<?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> Tcl <?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>:

       argc           <?><?><?><?> <?><?><?><?><?>
                      <?><?><?><?><?><?><?><?><?><?><?> arg <?><?><?> (<?><?>
                      <?><?><?><?> <?><?><?> <?><?><?><?> <?>)<?> <?><?><?><?>
                      <?><?><?><?><?><?> <?><?><?> <?><?><?><?>
                      <?><?><?><?><?><?><?>.

       argv           <?><?><?><?> <?><?> <?><?><?><?> Tcl <?><?><?> <?><?>
                      <?><?><?><?><?> <?><?> <?><?><?><?>
                      <?><?><?><?><?><?><?><?><?><?><?> arg <?><?>
                      <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
                      <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
                      <?><?><?> <?><?><?><?><?><?><?> arg <?><?><?><?>
                      <?><?><?><?><?><?> <?><?><?><?>.

       argv0          <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
                      <?><?><?><?> fileName <?><?><?>.  <?><?> <?><?><?>
                      <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
                      <?><?><?> <?><?> tclsh <?><?> <?><?>
                      <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?>.

       tcl_interactive
                      <?><?><?> tclsh <?><?> <?><?><?><?> <?><?><?><?><?><?>
                      <?><?><?><?> <?><?><?> (<?><?><?> fileName <?><?><?><?>
                      <?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?>
                      <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
                      <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>)
                      <?><?><?><?> <?><?> <?> <?><?> <?><?><?> <?><?><?>
                      <?><?><?><?> <?><?><?><?> <?> <?><?><?>.

<?><?><?><?><?><?><?><?> (PROMPTS)
       <?><?><?><?><?><?> <?><?> tclsh <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> "% ".  <?><?><?><?>
       <?><?><?><?><?><?>.  <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> tcl_prompt1 <?> tcl_prompt2
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>. <?><?><?>
       <?><?><?><?><?> tcl_prompt1 <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       Tcl <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       tclsh <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> tcl_prompt1 <?><?>
       <?><?><?><?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?><?> tcl_prompt2 <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?> tcl_prompt2 <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (STANDARD CHANNELS)
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       Tcl_StandardChannels <?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       auto_path(n), encoding(n), env(n), fconfigure(n)

<?><?><?><?><?><?><?><?><?><?><?> (KEYWORDS)
       application, argument, interpreter, prompt, script file, shell

Tcl                                                                   tclsh(1)