Tcl Source Code

Hex Artifact Content
Login
Bounty program for improvements to Tcl and certain Tcl packages.
Tcl 2019 Conference, Houston/TX, US, Nov 4-8
Send your abstracts to [email protected]
or submit via the online form by Sep 9.

Artifact 53b2daaa544718a7d5463d1ee5c840b27a3e3fb5:


0000: 27 5c 22 0a 27 5c 22 20 43 6f 70 79 72 69 67 68  '\".'\" Copyrigh
0010: 74 20 28 63 29 20 31 39 39 33 20 54 68 65 20 52  t (c) 1993 The R
0020: 65 67 65 6e 74 73 20 6f 66 20 74 68 65 20 55 6e  egents of the Un
0030: 69 76 65 72 73 69 74 79 20 6f 66 20 43 61 6c 69  iversity of Cali
0040: 66 6f 72 6e 69 61 2e 0a 27 5c 22 20 43 6f 70 79  fornia..'\" Copy
0050: 72 69 67 68 74 20 28 63 29 20 31 39 39 34 2d 31  right (c) 1994-1
0060: 39 39 36 20 53 75 6e 20 4d 69 63 72 6f 73 79 73  996 Sun Microsys
0070: 74 65 6d 73 2c 20 49 6e 63 2e 0a 27 5c 22 0a 27  tems, Inc..'\".'
0080: 5c 22 20 53 65 65 20 74 68 65 20 66 69 6c 65 20  \" See the file 
0090: 22 6c 69 63 65 6e 73 65 2e 74 65 72 6d 73 22 20  "license.terms" 
00a0: 66 6f 72 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20  for information 
00b0: 6f 6e 20 75 73 61 67 65 20 61 6e 64 20 72 65 64  on usage and red
00c0: 69 73 74 72 69 62 75 74 69 6f 6e 0a 27 5c 22 20  istribution.'\" 
00d0: 6f 66 20 74 68 69 73 20 66 69 6c 65 2c 20 61 6e  of this file, an
00e0: 64 20 66 6f 72 20 61 20 44 49 53 43 4c 41 49 4d  d for a DISCLAIM
00f0: 45 52 20 4f 46 20 41 4c 4c 20 57 41 52 52 41 4e  ER OF ALL WARRAN
0100: 54 49 45 53 2e 0a 27 5c 22 20 0a 27 5c 22 20 52  TIES..'\" .'\" R
0110: 43 53 3a 20 40 28 23 29 20 24 49 64 3a 20 54 63  CS: @(#) $Id: Tc
0120: 6c 2e 6e 2c 76 20 31 2e 31 38 20 32 30 30 37 2f  l.n,v 1.18 2007/
0130: 31 32 2f 31 33 20 31 35 3a 32 32 3a 33 32 20 64  12/13 15:22:32 d
0140: 67 70 20 45 78 70 20 24 0a 27 5c 22 0a 2e 73 6f  gp Exp $.'\"..so
0150: 20 6d 61 6e 2e 6d 61 63 72 6f 73 0a 2e 54 48 20   man.macros..TH 
0160: 54 63 6c 20 6e 20 22 38 2e 35 22 20 54 63 6c 20  Tcl n "8.5" Tcl 
0170: 22 54 63 6c 20 42 75 69 6c 74 2d 49 6e 20 43 6f  "Tcl Built-In Co
0180: 6d 6d 61 6e 64 73 22 0a 2e 42 53 0a 2e 53 48 20  mmands"..BS..SH 
0190: 4e 41 4d 45 0a 54 63 6c 20 5c 2d 20 54 6f 6f 6c  NAME.Tcl \- Tool
01a0: 20 43 6f 6d 6d 61 6e 64 20 4c 61 6e 67 75 61 67   Command Languag
01b0: 65 0a 2e 53 48 20 53 59 4e 4f 50 53 49 53 0a 53  e..SH SYNOPSIS.S
01c0: 75 6d 6d 61 72 79 20 6f 66 20 54 63 6c 20 6c 61  ummary of Tcl la
01d0: 6e 67 75 61 67 65 20 73 79 6e 74 61 78 2e 0a 2e  nguage syntax...
01e0: 42 45 0a 2e 53 48 20 44 45 53 43 52 49 50 54 49  BE..SH DESCRIPTI
01f0: 4f 4e 0a 2e 50 50 0a 54 68 65 20 66 6f 6c 6c 6f  ON..PP.The follo
0200: 77 69 6e 67 20 72 75 6c 65 73 20 64 65 66 69 6e  wing rules defin
0210: 65 20 74 68 65 20 73 79 6e 74 61 78 20 61 6e 64  e the syntax and
0220: 20 73 65 6d 61 6e 74 69 63 73 20 6f 66 20 74 68   semantics of th
0230: 65 20 54 63 6c 20 6c 61 6e 67 75 61 67 65 3a 0a  e Tcl language:.
0240: 2e 49 50 20 22 5b 31 5d 20 5c 66 42 43 6f 6d 6d  .IP "[1] \fBComm
0250: 61 6e 64 73 2e 5c 66 52 22 0a 41 20 54 63 6c 20  ands.\fR".A Tcl 
0260: 73 63 72 69 70 74 20 69 73 20 61 20 73 74 72 69  script is a stri
0270: 6e 67 20 63 6f 6e 74 61 69 6e 69 6e 67 20 6f 6e  ng containing on
0280: 65 20 6f 72 20 6d 6f 72 65 20 63 6f 6d 6d 61 6e  e or more comman
0290: 64 73 2e 0a 53 65 6d 69 2d 63 6f 6c 6f 6e 73 20  ds..Semi-colons 
02a0: 61 6e 64 20 6e 65 77 6c 69 6e 65 73 20 61 72 65  and newlines are
02b0: 20 63 6f 6d 6d 61 6e 64 20 73 65 70 61 72 61 74   command separat
02c0: 6f 72 73 20 75 6e 6c 65 73 73 20 71 75 6f 74 65  ors unless quote
02d0: 64 20 61 73 0a 64 65 73 63 72 69 62 65 64 20 62  d as.described b
02e0: 65 6c 6f 77 2e 0a 43 6c 6f 73 65 20 62 72 61 63  elow..Close brac
02f0: 6b 65 74 73 20 61 72 65 20 63 6f 6d 6d 61 6e 64  kets are command
0300: 20 74 65 72 6d 69 6e 61 74 6f 72 73 20 64 75 72   terminators dur
0310: 69 6e 67 20 63 6f 6d 6d 61 6e 64 20 73 75 62 73  ing command subs
0320: 74 69 74 75 74 69 6f 6e 0a 28 73 65 65 20 62 65  titution.(see be
0330: 6c 6f 77 29 20 75 6e 6c 65 73 73 20 71 75 6f 74  low) unless quot
0340: 65 64 2e 0a 2e 49 50 20 22 5b 32 5d 20 5c 66 42  ed...IP "[2] \fB
0350: 45 76 61 6c 75 61 74 69 6f 6e 2e 5c 66 52 22 0a  Evaluation.\fR".
0360: 41 20 63 6f 6d 6d 61 6e 64 20 69 73 20 65 76 61  A command is eva
0370: 6c 75 61 74 65 64 20 69 6e 20 74 77 6f 20 73 74  luated in two st
0380: 65 70 73 2e 0a 46 69 72 73 74 2c 20 74 68 65 20  eps..First, the 
0390: 54 63 6c 20 69 6e 74 65 72 70 72 65 74 65 72 20  Tcl interpreter 
03a0: 62 72 65 61 6b 73 20 74 68 65 20 63 6f 6d 6d 61  breaks the comma
03b0: 6e 64 20 69 6e 74 6f 20 5c 66 49 77 6f 72 64 73  nd into \fIwords
03c0: 5c 66 52 0a 61 6e 64 20 70 65 72 66 6f 72 6d 73  \fR.and performs
03d0: 20 73 75 62 73 74 69 74 75 74 69 6f 6e 73 20 61   substitutions a
03e0: 73 20 64 65 73 63 72 69 62 65 64 20 62 65 6c 6f  s described belo
03f0: 77 2e 0a 54 68 65 73 65 20 73 75 62 73 74 69 74  w..These substit
0400: 75 74 69 6f 6e 73 20 61 72 65 20 70 65 72 66 6f  utions are perfo
0410: 72 6d 65 64 20 69 6e 20 74 68 65 20 73 61 6d 65  rmed in the same
0420: 20 77 61 79 20 66 6f 72 20 61 6c 6c 0a 63 6f 6d   way for all.com
0430: 6d 61 6e 64 73 2e 0a 54 68 65 20 66 69 72 73 74  mands..The first
0440: 20 77 6f 72 64 20 69 73 20 75 73 65 64 20 74 6f   word is used to
0450: 20 6c 6f 63 61 74 65 20 61 20 63 6f 6d 6d 61 6e   locate a comman
0460: 64 20 70 72 6f 63 65 64 75 72 65 20 74 6f 0a 63  d procedure to.c
0470: 61 72 72 79 20 6f 75 74 20 74 68 65 20 63 6f 6d  arry out the com
0480: 6d 61 6e 64 2c 20 74 68 65 6e 20 61 6c 6c 20 6f  mand, then all o
0490: 66 20 74 68 65 20 77 6f 72 64 73 20 6f 66 20 74  f the words of t
04a0: 68 65 20 63 6f 6d 6d 61 6e 64 20 61 72 65 0a 70  he command are.p
04b0: 61 73 73 65 64 20 74 6f 20 74 68 65 20 63 6f 6d  assed to the com
04c0: 6d 61 6e 64 20 70 72 6f 63 65 64 75 72 65 2e 0a  mand procedure..
04d0: 54 68 65 20 63 6f 6d 6d 61 6e 64 20 70 72 6f 63  The command proc
04e0: 65 64 75 72 65 20 69 73 20 66 72 65 65 20 74 6f  edure is free to
04f0: 20 69 6e 74 65 72 70 72 65 74 20 65 61 63 68 20   interpret each 
0500: 6f 66 20 69 74 73 20 77 6f 72 64 73 0a 69 6e 20  of its words.in 
0510: 61 6e 79 20 77 61 79 20 69 74 20 6c 69 6b 65 73  any way it likes
0520: 2c 20 73 75 63 68 20 61 73 20 61 6e 20 69 6e 74  , such as an int
0530: 65 67 65 72 2c 20 76 61 72 69 61 62 6c 65 20 6e  eger, variable n
0540: 61 6d 65 2c 20 6c 69 73 74 2c 0a 6f 72 20 54 63  ame, list,.or Tc
0550: 6c 20 73 63 72 69 70 74 2e 0a 44 69 66 66 65 72  l script..Differ
0560: 65 6e 74 20 63 6f 6d 6d 61 6e 64 73 20 69 6e 74  ent commands int
0570: 65 72 70 72 65 74 20 74 68 65 69 72 20 77 6f 72  erpret their wor
0580: 64 73 20 64 69 66 66 65 72 65 6e 74 6c 79 2e 0a  ds differently..
0590: 2e 49 50 20 22 5b 33 5d 20 5c 66 42 57 6f 72 64  .IP "[3] \fBWord
05a0: 73 2e 5c 66 52 22 0a 57 6f 72 64 73 20 6f 66 20  s.\fR".Words of 
05b0: 61 20 63 6f 6d 6d 61 6e 64 20 61 72 65 20 73 65  a command are se
05c0: 70 61 72 61 74 65 64 20 62 79 20 77 68 69 74 65  parated by white
05d0: 20 73 70 61 63 65 20 28 65 78 63 65 70 74 20 66   space (except f
05e0: 6f 72 0a 6e 65 77 6c 69 6e 65 73 2c 20 77 68 69  or.newlines, whi
05f0: 63 68 20 61 72 65 20 63 6f 6d 6d 61 6e 64 20 73  ch are command s
0600: 65 70 61 72 61 74 6f 72 73 29 2e 0a 2e 49 50 20  eparators)...IP 
0610: 22 5b 34 5d 20 5c 66 42 44 6f 75 62 6c 65 20 71  "[4] \fBDouble q
0620: 75 6f 74 65 73 2e 5c 66 52 22 0a 49 66 20 74 68  uotes.\fR".If th
0630: 65 20 66 69 72 73 74 20 63 68 61 72 61 63 74 65  e first characte
0640: 72 20 6f 66 20 61 20 77 6f 72 64 20 69 73 20 64  r of a word is d
0650: 6f 75 62 6c 65 2d 71 75 6f 74 65 0a 2e 50 51 20  ouble-quote..PQ 
0660: 5c 4e 27 33 34 27 0a 74 68 65 6e 20 74 68 65 20  \N'34'.then the 
0670: 77 6f 72 64 20 69 73 20 74 65 72 6d 69 6e 61 74  word is terminat
0680: 65 64 20 62 79 20 74 68 65 20 6e 65 78 74 20 64  ed by the next d
0690: 6f 75 62 6c 65 2d 71 75 6f 74 65 20 63 68 61 72  ouble-quote char
06a0: 61 63 74 65 72 2e 0a 49 66 20 73 65 6d 69 2d 63  acter..If semi-c
06b0: 6f 6c 6f 6e 73 2c 20 63 6c 6f 73 65 20 62 72 61  olons, close bra
06c0: 63 6b 65 74 73 2c 20 6f 72 20 77 68 69 74 65 20  ckets, or white 
06d0: 73 70 61 63 65 20 63 68 61 72 61 63 74 65 72 73  space characters
06e0: 0a 28 69 6e 63 6c 75 64 69 6e 67 20 6e 65 77 6c  .(including newl
06f0: 69 6e 65 73 29 20 61 70 70 65 61 72 20 62 65 74  ines) appear bet
0700: 77 65 65 6e 20 74 68 65 20 71 75 6f 74 65 73 20  ween the quotes 
0710: 74 68 65 6e 20 74 68 65 79 20 61 72 65 20 74 72  then they are tr
0720: 65 61 74 65 64 0a 61 73 20 6f 72 64 69 6e 61 72  eated.as ordinar
0730: 79 20 63 68 61 72 61 63 74 65 72 73 20 61 6e 64  y characters and
0740: 20 69 6e 63 6c 75 64 65 64 20 69 6e 20 74 68 65   included in the
0750: 20 77 6f 72 64 2e 0a 43 6f 6d 6d 61 6e 64 20 73   word..Command s
0760: 75 62 73 74 69 74 75 74 69 6f 6e 2c 20 76 61 72  ubstitution, var
0770: 69 61 62 6c 65 20 73 75 62 73 74 69 74 75 74 69  iable substituti
0780: 6f 6e 2c 20 61 6e 64 20 62 61 63 6b 73 6c 61 73  on, and backslas
0790: 68 20 73 75 62 73 74 69 74 75 74 69 6f 6e 0a 61  h substitution.a
07a0: 72 65 20 70 65 72 66 6f 72 6d 65 64 20 6f 6e 20  re performed on 
07b0: 74 68 65 20 63 68 61 72 61 63 74 65 72 73 20 62  the characters b
07c0: 65 74 77 65 65 6e 20 74 68 65 20 71 75 6f 74 65  etween the quote
07d0: 73 20 61 73 20 64 65 73 63 72 69 62 65 64 20 62  s as described b
07e0: 65 6c 6f 77 2e 0a 54 68 65 20 64 6f 75 62 6c 65  elow..The double
07f0: 2d 71 75 6f 74 65 73 20 61 72 65 20 6e 6f 74 20  -quotes are not 
0800: 72 65 74 61 69 6e 65 64 20 61 73 20 70 61 72 74  retained as part
0810: 20 6f 66 20 74 68 65 20 77 6f 72 64 2e 0a 2e 56   of the word...V
0820: 53 20 38 2e 35 20 62 72 0a 2e 49 50 20 22 5b 35  S 8.5 br..IP "[5
0830: 5d 20 5c 66 42 41 72 67 75 6d 65 6e 74 20 65 78  ] \fBArgument ex
0840: 70 61 6e 73 69 6f 6e 2e 5c 66 52 22 0a 49 66 20  pansion.\fR".If 
0850: 61 20 77 6f 72 64 20 73 74 61 72 74 73 20 77 69  a word starts wi
0860: 74 68 20 74 68 65 20 73 74 72 69 6e 67 0a 2e 51  th the string..Q
0870: 57 20 7b 2a 7d 0a 66 6f 6c 6c 6f 77 65 64 20 62  W {*}.followed b
0880: 79 20 61 20 6e 6f 6e 2d 77 68 69 74 65 73 70 61  y a non-whitespa
0890: 63 65 20 63 68 61 72 61 63 74 65 72 2c 20 74 68  ce character, th
08a0: 65 6e 20 74 68 65 20 6c 65 61 64 69 6e 67 0a 2e  en the leading..
08b0: 51 57 20 7b 2a 7d 0a 69 73 20 72 65 6d 6f 76 65  QW {*}.is remove
08c0: 64 0a 61 6e 64 20 74 68 65 20 72 65 73 74 20 6f  d.and the rest o
08d0: 66 20 74 68 65 20 77 6f 72 64 20 69 73 20 70 61  f the word is pa
08e0: 72 73 65 64 20 61 6e 64 20 73 75 62 73 74 69 74  rsed and substit
08f0: 75 74 65 64 20 61 73 20 61 6e 79 20 6f 74 68 65  uted as any othe
0900: 72 0a 77 6f 72 64 2e 20 41 66 74 65 72 20 73 75  r.word. After su
0910: 62 73 74 69 74 75 74 69 6f 6e 2c 20 74 68 65 20  bstitution, the 
0920: 77 6f 72 64 20 69 73 20 70 61 72 73 65 64 20 61  word is parsed a
0930: 67 61 69 6e 20 77 69 74 68 6f 75 74 0a 73 75 62  gain without.sub
0940: 73 74 69 74 75 74 69 6f 6e 73 2c 20 61 6e 64 20  stitutions, and 
0950: 69 74 73 20 77 6f 72 64 73 20 61 72 65 20 61 64  its words are ad
0960: 64 65 64 20 74 6f 20 74 68 65 20 63 6f 6d 6d 61  ded to the comma
0970: 6e 64 20 62 65 69 6e 67 0a 73 75 62 73 74 69 74  nd being.substit
0980: 75 74 65 64 2e 20 46 6f 72 20 69 6e 73 74 61 6e  uted. For instan
0990: 63 65 2c 0a 2e 51 57 20 22 63 6d 64 20 61 20 7b  ce,..QW "cmd a {
09a0: 2a 7d 7b 62 20 63 7d 20 64 20 7b 2a 7d 7b 65 20  *}{b c} d {*}{e 
09b0: 66 7d 22 0a 69 73 20 65 71 75 69 76 61 6c 65 6e  f}".is equivalen
09c0: 74 20 74 6f 0a 2e 51 57 20 22 63 6d 64 20 61 20  t to..QW "cmd a 
09d0: 62 20 63 20 64 20 65 20 66 22 20 2e 0a 2e 56 45  b c d e f" ...VE
09e0: 20 38 2e 35 0a 2e 49 50 20 22 5b 36 5d 20 5c 66   8.5..IP "[6] \f
09f0: 42 42 72 61 63 65 73 2e 5c 66 52 22 0a 49 66 20  BBraces.\fR".If 
0a00: 74 68 65 20 66 69 72 73 74 20 63 68 61 72 61 63  the first charac
0a10: 74 65 72 20 6f 66 20 61 20 77 6f 72 64 20 69 73  ter of a word is
0a20: 20 61 6e 20 6f 70 65 6e 20 62 72 61 63 65 0a 2e   an open brace..
0a30: 50 51 20 7b 0a 61 6e 64 20 72 75 6c 65 20 5b 35  PQ {.and rule [5
0a40: 5d 20 64 6f 65 73 20 6e 6f 74 20 61 70 70 6c 79  ] does not apply
0a50: 2c 20 74 68 65 6e 0a 74 68 65 20 77 6f 72 64 20  , then.the word 
0a60: 69 73 20 74 65 72 6d 69 6e 61 74 65 64 20 62 79  is terminated by
0a70: 20 74 68 65 20 6d 61 74 63 68 69 6e 67 20 63 6c   the matching cl
0a80: 6f 73 65 20 62 72 61 63 65 0a 2e 50 51 20 7d 20  ose brace..PQ } 
0a90: 22 22 20 2e 0a 42 72 61 63 65 73 20 6e 65 73 74  "" ..Braces nest
0aa0: 20 77 69 74 68 69 6e 20 74 68 65 20 77 6f 72 64   within the word
0ab0: 3a 20 66 6f 72 20 65 61 63 68 20 61 64 64 69 74  : for each addit
0ac0: 69 6f 6e 61 6c 20 6f 70 65 6e 0a 62 72 61 63 65  ional open.brace
0ad0: 20 74 68 65 72 65 20 6d 75 73 74 20 62 65 20 61   there must be a
0ae0: 6e 20 61 64 64 69 74 69 6f 6e 61 6c 20 63 6c 6f  n additional clo
0af0: 73 65 20 62 72 61 63 65 20 28 68 6f 77 65 76 65  se brace (howeve
0b00: 72 2c 0a 69 66 20 61 6e 20 6f 70 65 6e 20 62 72  r,.if an open br
0b10: 61 63 65 20 6f 72 20 63 6c 6f 73 65 20 62 72 61  ace or close bra
0b20: 63 65 20 77 69 74 68 69 6e 20 74 68 65 20 77 6f  ce within the wo
0b30: 72 64 20 69 73 0a 71 75 6f 74 65 64 20 77 69 74  rd is.quoted wit
0b40: 68 20 61 20 62 61 63 6b 73 6c 61 73 68 20 74 68  h a backslash th
0b50: 65 6e 20 69 74 20 69 73 20 6e 6f 74 20 63 6f 75  en it is not cou
0b60: 6e 74 65 64 20 69 6e 20 6c 6f 63 61 74 69 6e 67  nted in locating
0b70: 20 74 68 65 0a 6d 61 74 63 68 69 6e 67 20 63 6c   the.matching cl
0b80: 6f 73 65 20 62 72 61 63 65 29 2e 0a 4e 6f 20 73  ose brace)..No s
0b90: 75 62 73 74 69 74 75 74 69 6f 6e 73 20 61 72 65  ubstitutions are
0ba0: 20 70 65 72 66 6f 72 6d 65 64 20 6f 6e 20 74 68   performed on th
0bb0: 65 20 63 68 61 72 61 63 74 65 72 73 20 62 65 74  e characters bet
0bc0: 77 65 65 6e 20 74 68 65 0a 62 72 61 63 65 73 20  ween the.braces 
0bd0: 65 78 63 65 70 74 20 66 6f 72 20 62 61 63 6b 73  except for backs
0be0: 6c 61 73 68 2d 6e 65 77 6c 69 6e 65 20 73 75 62  lash-newline sub
0bf0: 73 74 69 74 75 74 69 6f 6e 73 20 64 65 73 63 72  stitutions descr
0c00: 69 62 65 64 0a 62 65 6c 6f 77 2c 20 6e 6f 72 20  ibed.below, nor 
0c10: 64 6f 20 73 65 6d 69 2d 63 6f 6c 6f 6e 73 2c 20  do semi-colons, 
0c20: 6e 65 77 6c 69 6e 65 73 2c 20 63 6c 6f 73 65 20  newlines, close 
0c30: 62 72 61 63 6b 65 74 73 2c 0a 6f 72 20 77 68 69  brackets,.or whi
0c40: 74 65 20 73 70 61 63 65 20 72 65 63 65 69 76 65  te space receive
0c50: 20 61 6e 79 20 73 70 65 63 69 61 6c 20 69 6e 74   any special int
0c60: 65 72 70 72 65 74 61 74 69 6f 6e 2e 0a 54 68 65  erpretation..The
0c70: 20 77 6f 72 64 20 77 69 6c 6c 20 63 6f 6e 73 69   word will consi
0c80: 73 74 20 6f 66 20 65 78 61 63 74 6c 79 20 74 68  st of exactly th
0c90: 65 20 63 68 61 72 61 63 74 65 72 73 20 62 65 74  e characters bet
0ca0: 77 65 65 6e 20 74 68 65 0a 6f 75 74 65 72 20 62  ween the.outer b
0cb0: 72 61 63 65 73 2c 20 6e 6f 74 20 69 6e 63 6c 75  races, not inclu
0cc0: 64 69 6e 67 20 74 68 65 20 62 72 61 63 65 73 20  ding the braces 
0cd0: 74 68 65 6d 73 65 6c 76 65 73 2e 0a 2e 49 50 20  themselves...IP 
0ce0: 22 5b 37 5d 20 5c 66 42 43 6f 6d 6d 61 6e 64 20  "[7] \fBCommand 
0cf0: 73 75 62 73 74 69 74 75 74 69 6f 6e 2e 5c 66 52  substitution.\fR
0d00: 22 0a 49 66 20 61 20 77 6f 72 64 20 63 6f 6e 74  ".If a word cont
0d10: 61 69 6e 73 20 61 6e 20 6f 70 65 6e 20 62 72 61  ains an open bra
0d20: 63 6b 65 74 0a 2e 50 51 20 5b 0a 74 68 65 6e 20  cket..PQ [.then 
0d30: 54 63 6c 20 70 65 72 66 6f 72 6d 73 20 5c 66 49  Tcl performs \fI
0d40: 63 6f 6d 6d 61 6e 64 20 73 75 62 73 74 69 74 75  command substitu
0d50: 74 69 6f 6e 5c 66 52 2e 0a 54 6f 20 64 6f 20 74  tion\fR..To do t
0d60: 68 69 73 20 69 74 20 69 6e 76 6f 6b 65 73 20 74  his it invokes t
0d70: 68 65 20 54 63 6c 20 69 6e 74 65 72 70 72 65 74  he Tcl interpret
0d80: 65 72 20 72 65 63 75 72 73 69 76 65 6c 79 20 74  er recursively t
0d90: 6f 20 70 72 6f 63 65 73 73 0a 74 68 65 20 63 68  o process.the ch
0da0: 61 72 61 63 74 65 72 73 20 66 6f 6c 6c 6f 77 69  aracters followi
0db0: 6e 67 20 74 68 65 20 6f 70 65 6e 20 62 72 61 63  ng the open brac
0dc0: 6b 65 74 20 61 73 20 61 20 54 63 6c 20 73 63 72  ket as a Tcl scr
0dd0: 69 70 74 2e 0a 54 68 65 20 73 63 72 69 70 74 20  ipt..The script 
0de0: 6d 61 79 20 63 6f 6e 74 61 69 6e 20 61 6e 79 20  may contain any 
0df0: 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6d 6d 61 6e  number of comman
0e00: 64 73 20 61 6e 64 20 6d 75 73 74 20 62 65 20 74  ds and must be t
0e10: 65 72 6d 69 6e 61 74 65 64 0a 62 79 20 61 20 63  erminated.by a c
0e20: 6c 6f 73 65 20 62 72 61 63 6b 65 74 0a 2e 50 51  lose bracket..PQ
0e30: 20 5d 20 22 22 20 2e 0a 54 68 65 20 72 65 73 75   ] "" ..The resu
0e40: 6c 74 20 6f 66 20 74 68 65 20 73 63 72 69 70 74  lt of the script
0e50: 20 28 69 2e 65 2e 20 74 68 65 20 72 65 73 75 6c   (i.e. the resul
0e60: 74 20 6f 66 20 69 74 73 20 6c 61 73 74 20 63 6f  t of its last co
0e70: 6d 6d 61 6e 64 29 20 69 73 0a 73 75 62 73 74 69  mmand) is.substi
0e80: 74 75 74 65 64 20 69 6e 74 6f 20 74 68 65 20 77  tuted into the w
0e90: 6f 72 64 20 69 6e 20 70 6c 61 63 65 20 6f 66 20  ord in place of 
0ea0: 74 68 65 20 62 72 61 63 6b 65 74 73 20 61 6e 64  the brackets and
0eb0: 20 61 6c 6c 20 6f 66 20 74 68 65 0a 63 68 61 72   all of the.char
0ec0: 61 63 74 65 72 73 20 62 65 74 77 65 65 6e 20 74  acters between t
0ed0: 68 65 6d 2e 0a 54 68 65 72 65 20 6d 61 79 20 62  hem..There may b
0ee0: 65 20 61 6e 79 20 6e 75 6d 62 65 72 20 6f 66 20  e any number of 
0ef0: 63 6f 6d 6d 61 6e 64 20 73 75 62 73 74 69 74 75  command substitu
0f00: 74 69 6f 6e 73 20 69 6e 20 61 20 73 69 6e 67 6c  tions in a singl
0f10: 65 20 77 6f 72 64 2e 0a 43 6f 6d 6d 61 6e 64 20  e word..Command 
0f20: 73 75 62 73 74 69 74 75 74 69 6f 6e 20 69 73 20  substitution is 
0f30: 6e 6f 74 20 70 65 72 66 6f 72 6d 65 64 20 6f 6e  not performed on
0f40: 20 77 6f 72 64 73 20 65 6e 63 6c 6f 73 65 64 20   words enclosed 
0f50: 69 6e 20 62 72 61 63 65 73 2e 0a 2e 49 50 20 22  in braces...IP "
0f60: 5b 38 5d 20 5c 66 42 56 61 72 69 61 62 6c 65 20  [8] \fBVariable 
0f70: 73 75 62 73 74 69 74 75 74 69 6f 6e 2e 5c 66 52  substitution.\fR
0f80: 22 0a 49 66 20 61 20 77 6f 72 64 20 63 6f 6e 74  ".If a word cont
0f90: 61 69 6e 73 20 61 20 64 6f 6c 6c 61 72 2d 73 69  ains a dollar-si
0fa0: 67 6e 0a 2e 50 51 20 24 0a 66 6f 6c 6c 6f 77 65  gn..PQ $.followe
0fb0: 64 20 62 79 20 6f 6e 65 20 6f 66 20 74 68 65 20  d by one of the 
0fc0: 66 6f 72 6d 73 0a 64 65 73 63 72 69 62 65 64 20  forms.described 
0fd0: 62 65 6c 6f 77 2c 20 74 68 65 6e 20 54 63 6c 20  below, then Tcl 
0fe0: 70 65 72 66 6f 72 6d 73 20 5c 66 49 76 61 72 69  performs \fIvari
0ff0: 61 62 6c 65 0a 73 75 62 73 74 69 74 75 74 69 6f  able.substitutio
1000: 6e 5c 66 52 3a 20 20 74 68 65 20 64 6f 6c 6c 61  n\fR:  the dolla
1010: 72 2d 73 69 67 6e 20 61 6e 64 20 74 68 65 20 66  r-sign and the f
1020: 6f 6c 6c 6f 77 69 6e 67 20 63 68 61 72 61 63 74  ollowing charact
1030: 65 72 73 20 61 72 65 0a 72 65 70 6c 61 63 65 64  ers are.replaced
1040: 20 69 6e 20 74 68 65 20 77 6f 72 64 20 62 79 20   in the word by 
1050: 74 68 65 20 76 61 6c 75 65 20 6f 66 20 61 20 76  the value of a v
1060: 61 72 69 61 62 6c 65 2e 0a 56 61 72 69 61 62 6c  ariable..Variabl
1070: 65 20 73 75 62 73 74 69 74 75 74 69 6f 6e 20 6d  e substitution m
1080: 61 79 20 74 61 6b 65 20 61 6e 79 20 6f 66 20 74  ay take any of t
1090: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 66 6f 72  he following for
10a0: 6d 73 3a 0a 2e 52 53 0a 2e 54 50 20 31 35 0a 5c  ms:..RS..TP 15.\
10b0: 66 42 24 5c 66 49 6e 61 6d 65 5c 66 52 0a 5c 66  fB$\fIname\fR.\f
10c0: 49 4e 61 6d 65 5c 66 52 20 69 73 20 74 68 65 20  IName\fR is the 
10d0: 6e 61 6d 65 20 6f 66 20 61 20 73 63 61 6c 61 72  name of a scalar
10e0: 20 76 61 72 69 61 62 6c 65 3b 20 20 74 68 65 20   variable;  the 
10f0: 6e 61 6d 65 20 69 73 20 61 20 73 65 71 75 65 6e  name is a sequen
1100: 63 65 0a 6f 66 20 6f 6e 65 20 6f 72 20 6d 6f 72  ce.of one or mor
1110: 65 20 63 68 61 72 61 63 74 65 72 73 20 74 68 61  e characters tha
1120: 74 20 61 72 65 20 61 20 6c 65 74 74 65 72 2c 20  t are a letter, 
1130: 64 69 67 69 74 2c 20 75 6e 64 65 72 73 63 6f 72  digit, underscor
1140: 65 2c 0a 6f 72 20 6e 61 6d 65 73 70 61 63 65 20  e,.or namespace 
1150: 73 65 70 61 72 61 74 6f 72 73 20 28 74 77 6f 20  separators (two 
1160: 6f 72 20 6d 6f 72 65 20 63 6f 6c 6f 6e 73 29 2e  or more colons).
1170: 0a 2e 54 50 20 31 35 0a 5c 66 42 24 5c 66 49 6e  ..TP 15.\fB$\fIn
1180: 61 6d 65 5c 66 42 28 5c 66 49 69 6e 64 65 78 5c  ame\fB(\fIindex\
1190: 66 42 29 5c 66 52 0a 5c 66 49 4e 61 6d 65 5c 66  fB)\fR.\fIName\f
11a0: 52 20 67 69 76 65 73 20 74 68 65 20 6e 61 6d 65  R gives the name
11b0: 20 6f 66 20 61 6e 20 61 72 72 61 79 20 76 61 72   of an array var
11c0: 69 61 62 6c 65 20 61 6e 64 20 5c 66 49 69 6e 64  iable and \fIind
11d0: 65 78 5c 66 52 20 67 69 76 65 73 0a 74 68 65 20  ex\fR gives.the 
11e0: 6e 61 6d 65 20 6f 66 20 61 6e 20 65 6c 65 6d 65  name of an eleme
11f0: 6e 74 20 77 69 74 68 69 6e 20 74 68 61 74 20 61  nt within that a
1200: 72 72 61 79 2e 0a 5c 66 49 4e 61 6d 65 5c 66 52  rray..\fIName\fR
1210: 20 6d 75 73 74 20 63 6f 6e 74 61 69 6e 20 6f 6e   must contain on
1220: 6c 79 20 6c 65 74 74 65 72 73 2c 20 64 69 67 69  ly letters, digi
1230: 74 73 2c 20 75 6e 64 65 72 73 63 6f 72 65 73 2c  ts, underscores,
1240: 20 61 6e 64 0a 6e 61 6d 65 73 70 61 63 65 20 73   and.namespace s
1250: 65 70 61 72 61 74 6f 72 73 2c 20 61 6e 64 20 6d  eparators, and m
1260: 61 79 20 62 65 20 61 6e 20 65 6d 70 74 79 20 73  ay be an empty s
1270: 74 72 69 6e 67 2e 0a 43 6f 6d 6d 61 6e 64 20 73  tring..Command s
1280: 75 62 73 74 69 74 75 74 69 6f 6e 73 2c 20 76 61  ubstitutions, va
1290: 72 69 61 62 6c 65 20 73 75 62 73 74 69 74 75 74  riable substitut
12a0: 69 6f 6e 73 2c 20 61 6e 64 20 62 61 63 6b 73 6c  ions, and backsl
12b0: 61 73 68 0a 73 75 62 73 74 69 74 75 74 69 6f 6e  ash.substitution
12c0: 73 20 61 72 65 20 70 65 72 66 6f 72 6d 65 64 20  s are performed 
12d0: 6f 6e 20 74 68 65 20 63 68 61 72 61 63 74 65 72  on the character
12e0: 73 20 6f 66 20 5c 66 49 69 6e 64 65 78 5c 66 52  s of \fIindex\fR
12f0: 2e 0a 2e 54 50 20 31 35 0a 5c 66 42 24 7b 5c 66  ...TP 15.\fB${\f
1300: 49 6e 61 6d 65 5c 66 42 7d 5c 66 52 0a 5c 66 49  Iname\fB}\fR.\fI
1310: 4e 61 6d 65 5c 66 52 20 69 73 20 74 68 65 20 6e  Name\fR is the n
1320: 61 6d 65 20 6f 66 20 61 20 73 63 61 6c 61 72 20  ame of a scalar 
1330: 76 61 72 69 61 62 6c 65 2e 20 20 49 74 20 6d 61  variable.  It ma
1340: 79 20 63 6f 6e 74 61 69 6e 20 61 6e 79 0a 63 68  y contain any.ch
1350: 61 72 61 63 74 65 72 73 20 77 68 61 74 73 6f 65  aracters whatsoe
1360: 76 65 72 20 65 78 63 65 70 74 20 66 6f 72 20 63  ver except for c
1370: 6c 6f 73 65 20 62 72 61 63 65 73 2e 0a 2e 4c 50  lose braces...LP
1380: 0a 54 68 65 72 65 20 6d 61 79 20 62 65 20 61 6e  .There may be an
1390: 79 20 6e 75 6d 62 65 72 20 6f 66 20 76 61 72 69  y number of vari
13a0: 61 62 6c 65 20 73 75 62 73 74 69 74 75 74 69 6f  able substitutio
13b0: 6e 73 20 69 6e 20 61 20 73 69 6e 67 6c 65 20 77  ns in a single w
13c0: 6f 72 64 2e 0a 56 61 72 69 61 62 6c 65 20 73 75  ord..Variable su
13d0: 62 73 74 69 74 75 74 69 6f 6e 20 69 73 20 6e 6f  bstitution is no
13e0: 74 20 70 65 72 66 6f 72 6d 65 64 20 6f 6e 20 77  t performed on w
13f0: 6f 72 64 73 20 65 6e 63 6c 6f 73 65 64 20 69 6e  ords enclosed in
1400: 20 62 72 61 63 65 73 2e 0a 2e 52 45 0a 2e 49 50   braces...RE..IP
1410: 20 22 5b 39 5d 20 5c 66 42 42 61 63 6b 73 6c 61   "[9] \fBBacksla
1420: 73 68 20 73 75 62 73 74 69 74 75 74 69 6f 6e 2e  sh substitution.
1430: 5c 66 52 22 0a 49 66 20 61 20 62 61 63 6b 73 6c  \fR".If a backsl
1440: 61 73 68 0a 2e 50 51 20 5c 65 0a 61 70 70 65 61  ash..PQ \e.appea
1450: 72 73 20 77 69 74 68 69 6e 20 61 20 77 6f 72 64  rs within a word
1460: 20 74 68 65 6e 20 5c 66 49 62 61 63 6b 73 6c 61   then \fIbacksla
1470: 73 68 20 73 75 62 73 74 69 74 75 74 69 6f 6e 5c  sh substitution\
1480: 66 52 20 6f 63 63 75 72 73 2e 0a 49 6e 20 61 6c  fR occurs..In al
1490: 6c 20 63 61 73 65 73 20 62 75 74 20 74 68 6f 73  l cases but thos
14a0: 65 20 64 65 73 63 72 69 62 65 64 20 62 65 6c 6f  e described belo
14b0: 77 20 74 68 65 20 62 61 63 6b 73 6c 61 73 68 20  w the backslash 
14c0: 69 73 20 64 72 6f 70 70 65 64 20 61 6e 64 0a 74  is dropped and.t
14d0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 68 61  he following cha
14e0: 72 61 63 74 65 72 20 69 73 20 74 72 65 61 74 65  racter is treate
14f0: 64 20 61 73 20 61 6e 20 6f 72 64 69 6e 61 72 79  d as an ordinary
1500: 0a 63 68 61 72 61 63 74 65 72 20 61 6e 64 20 69  .character and i
1510: 6e 63 6c 75 64 65 64 20 69 6e 20 74 68 65 20 77  ncluded in the w
1520: 6f 72 64 2e 0a 54 68 69 73 20 61 6c 6c 6f 77 73  ord..This allows
1530: 20 63 68 61 72 61 63 74 65 72 73 20 73 75 63 68   characters such
1540: 20 61 73 20 64 6f 75 62 6c 65 20 71 75 6f 74 65   as double quote
1550: 73 2c 20 63 6c 6f 73 65 20 62 72 61 63 6b 65 74  s, close bracket
1560: 73 2c 0a 61 6e 64 20 64 6f 6c 6c 61 72 20 73 69  s,.and dollar si
1570: 67 6e 73 20 74 6f 20 62 65 20 69 6e 63 6c 75 64  gns to be includ
1580: 65 64 20 69 6e 20 77 6f 72 64 73 20 77 69 74 68  ed in words with
1590: 6f 75 74 20 74 72 69 67 67 65 72 69 6e 67 0a 73  out triggering.s
15a0: 70 65 63 69 61 6c 20 70 72 6f 63 65 73 73 69 6e  pecial processin
15b0: 67 2e 0a 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  g..The following
15c0: 20 74 61 62 6c 65 20 6c 69 73 74 73 20 74 68 65   table lists the
15d0: 20 62 61 63 6b 73 6c 61 73 68 20 73 65 71 75 65   backslash seque
15e0: 6e 63 65 73 20 74 68 61 74 20 61 72 65 0a 68 61  nces that are.ha
15f0: 6e 64 6c 65 64 20 73 70 65 63 69 61 6c 6c 79 2c  ndled specially,
1600: 20 61 6c 6f 6e 67 20 77 69 74 68 20 74 68 65 20   along with the 
1610: 76 61 6c 75 65 20 74 68 61 74 20 72 65 70 6c 61  value that repla
1620: 63 65 73 20 65 61 63 68 20 73 65 71 75 65 6e 63  ces each sequenc
1630: 65 2e 0a 2e 52 53 0a 2e 54 50 20 37 0a 5c 65 5c  e...RS..TP 7.\e\
1640: 66 42 61 5c 66 52 0a 41 75 64 69 62 6c 65 20 61  fBa\fR.Audible a
1650: 6c 65 72 74 20 28 62 65 6c 6c 29 20 28 30 78 37  lert (bell) (0x7
1660: 29 2e 0a 2e 54 50 20 37 0a 5c 65 5c 66 42 62 5c  )...TP 7.\e\fBb\
1670: 66 52 0a 42 61 63 6b 73 70 61 63 65 20 28 30 78  fR.Backspace (0x
1680: 38 29 2e 0a 2e 54 50 20 37 0a 5c 65 5c 66 42 66  8)...TP 7.\e\fBf
1690: 5c 66 52 0a 46 6f 72 6d 20 66 65 65 64 20 28 30  \fR.Form feed (0
16a0: 78 63 29 2e 0a 2e 54 50 20 37 0a 5c 65 5c 66 42  xc)...TP 7.\e\fB
16b0: 6e 5c 66 52 0a 4e 65 77 6c 69 6e 65 20 28 30 78  n\fR.Newline (0x
16c0: 61 29 2e 0a 2e 54 50 20 37 0a 5c 65 5c 66 42 72  a)...TP 7.\e\fBr
16d0: 5c 66 52 0a 43 61 72 72 69 61 67 65 2d 72 65 74  \fR.Carriage-ret
16e0: 75 72 6e 20 28 30 78 64 29 2e 0a 2e 54 50 20 37  urn (0xd)...TP 7
16f0: 0a 5c 65 5c 66 42 74 5c 66 52 0a 54 61 62 20 28  .\e\fBt\fR.Tab (
1700: 30 78 39 29 2e 0a 2e 54 50 20 37 0a 5c 65 5c 66  0x9)...TP 7.\e\f
1710: 42 76 5c 66 52 0a 56 65 72 74 69 63 61 6c 20 74  Bv\fR.Vertical t
1720: 61 62 20 28 30 78 62 29 2e 0a 2e 54 50 20 37 0a  ab (0xb)...TP 7.
1730: 5c 65 5c 66 42 3c 6e 65 77 6c 69 6e 65 3e 5c 66  \e\fB<newline>\f
1740: 49 77 68 69 74 65 53 70 61 63 65 5c 66 52 0a 2e  IwhiteSpace\fR..
1750: 0a 41 20 73 69 6e 67 6c 65 20 73 70 61 63 65 20  .A single space 
1760: 63 68 61 72 61 63 74 65 72 20 72 65 70 6c 61 63  character replac
1770: 65 73 20 74 68 65 20 62 61 63 6b 73 6c 61 73 68  es the backslash
1780: 2c 20 6e 65 77 6c 69 6e 65 2c 20 61 6e 64 20 61  , newline, and a
1790: 6c 6c 20 73 70 61 63 65 73 0a 61 6e 64 20 74 61  ll spaces.and ta
17a0: 62 73 20 61 66 74 65 72 20 74 68 65 20 6e 65 77  bs after the new
17b0: 6c 69 6e 65 2e 20 20 54 68 69 73 20 62 61 63 6b  line.  This back
17c0: 73 6c 61 73 68 20 73 65 71 75 65 6e 63 65 20 69  slash sequence i
17d0: 73 20 75 6e 69 71 75 65 20 69 6e 20 74 68 61 74  s unique in that
17e0: 20 69 74 0a 69 73 20 72 65 70 6c 61 63 65 64 20   it.is replaced 
17f0: 69 6e 20 61 20 73 65 70 61 72 61 74 65 20 70 72  in a separate pr
1800: 65 2d 70 61 73 73 20 62 65 66 6f 72 65 20 74 68  e-pass before th
1810: 65 20 63 6f 6d 6d 61 6e 64 20 69 73 20 61 63 74  e command is act
1820: 75 61 6c 6c 79 20 70 61 72 73 65 64 2e 0a 54 68  ually parsed..Th
1830: 69 73 20 6d 65 61 6e 73 20 74 68 61 74 20 69 74  is means that it
1840: 20 77 69 6c 6c 20 62 65 20 72 65 70 6c 61 63 65   will be replace
1850: 64 20 65 76 65 6e 20 77 68 65 6e 20 69 74 20 6f  d even when it o
1860: 63 63 75 72 73 20 62 65 74 77 65 65 6e 20 62 72  ccurs between br
1870: 61 63 65 73 2c 0a 61 6e 64 20 74 68 65 20 72 65  aces,.and the re
1880: 73 75 6c 74 69 6e 67 20 73 70 61 63 65 20 77 69  sulting space wi
1890: 6c 6c 20 62 65 20 74 72 65 61 74 65 64 20 61 73  ll be treated as
18a0: 20 61 20 77 6f 72 64 20 73 65 70 61 72 61 74 6f   a word separato
18b0: 72 20 69 66 20 69 74 20 69 73 20 6e 6f 74 0a 69  r if it is not.i
18c0: 6e 20 62 72 61 63 65 73 20 6f 72 20 71 75 6f 74  n braces or quot
18d0: 65 73 2e 0a 2e 54 50 20 37 0a 5c 65 5c 65 0a 42  es...TP 7.\e\e.B
18e0: 61 63 6b 73 6c 61 73 68 0a 2e 50 51 20 5c 65 20  ackslash..PQ \e 
18f0: 22 22 20 2e 0a 2e 54 50 20 37 0a 5c 65 5c 66 49  "" ...TP 7.\e\fI
1900: 6f 6f 6f 5c 66 52 20 0a 2e 0a 54 68 65 20 64 69  ooo\fR ...The di
1910: 67 69 74 73 20 5c 66 49 6f 6f 6f 5c 66 52 20 28  gits \fIooo\fR (
1920: 6f 6e 65 2c 20 74 77 6f 2c 20 6f 72 20 74 68 72  one, two, or thr
1930: 65 65 20 6f 66 20 74 68 65 6d 29 20 67 69 76 65  ee of them) give
1940: 20 61 6e 20 65 69 67 68 74 2d 62 69 74 20 6f 63   an eight-bit oc
1950: 74 61 6c 20 0a 76 61 6c 75 65 20 66 6f 72 20 74  tal .value for t
1960: 68 65 20 55 6e 69 63 6f 64 65 20 63 68 61 72 61  he Unicode chara
1970: 63 74 65 72 20 74 68 61 74 20 77 69 6c 6c 20 62  cter that will b
1980: 65 20 69 6e 73 65 72 74 65 64 2e 20 20 54 68 65  e inserted.  The
1990: 20 75 70 70 65 72 20 62 69 74 73 20 6f 66 20 74   upper bits of t
19a0: 68 65 0a 55 6e 69 63 6f 64 65 20 63 68 61 72 61  he.Unicode chara
19b0: 63 74 65 72 20 77 69 6c 6c 20 62 65 20 30 2e 0a  cter will be 0..
19c0: 2e 54 50 20 37 0a 5c 65 5c 66 42 78 5c 66 49 68  .TP 7.\e\fBx\fIh
19d0: 68 5c 66 52 20 0a 2e 0a 54 68 65 20 68 65 78 61  h\fR ...The hexa
19e0: 64 65 63 69 6d 61 6c 20 64 69 67 69 74 73 20 5c  decimal digits \
19f0: 66 49 68 68 5c 66 52 20 67 69 76 65 20 61 6e 20  fIhh\fR give an 
1a00: 65 69 67 68 74 2d 62 69 74 20 68 65 78 61 64 65  eight-bit hexade
1a10: 63 69 6d 61 6c 20 76 61 6c 75 65 20 66 6f 72 20  cimal value for 
1a20: 74 68 65 0a 55 6e 69 63 6f 64 65 20 63 68 61 72  the.Unicode char
1a30: 61 63 74 65 72 20 74 68 61 74 20 77 69 6c 6c 20  acter that will 
1a40: 62 65 20 69 6e 73 65 72 74 65 64 2e 20 20 41 6e  be inserted.  An
1a50: 79 20 6e 75 6d 62 65 72 20 6f 66 20 68 65 78 61  y number of hexa
1a60: 64 65 63 69 6d 61 6c 20 64 69 67 69 74 73 0a 6d  decimal digits.m
1a70: 61 79 20 62 65 20 70 72 65 73 65 6e 74 3b 20 68  ay be present; h
1a80: 6f 77 65 76 65 72 2c 20 61 6c 6c 20 62 75 74 20  owever, all but 
1a90: 74 68 65 20 6c 61 73 74 20 74 77 6f 20 61 72 65  the last two are
1aa0: 20 69 67 6e 6f 72 65 64 20 28 74 68 65 20 72 65   ignored (the re
1ab0: 73 75 6c 74 20 69 73 0a 61 6c 77 61 79 73 20 61  sult is.always a
1ac0: 20 6f 6e 65 2d 62 79 74 65 20 71 75 61 6e 74 69   one-byte quanti
1ad0: 74 79 29 2e 20 20 54 68 65 20 75 70 70 65 72 20  ty).  The upper 
1ae0: 62 69 74 73 20 6f 66 20 74 68 65 20 55 6e 69 63  bits of the Unic
1af0: 6f 64 65 20 63 68 61 72 61 63 74 65 72 20 77 69  ode character wi
1b00: 6c 6c 0a 62 65 20 30 2e 0a 2e 54 50 20 37 0a 5c  ll.be 0...TP 7.\
1b10: 65 5c 66 42 75 5c 66 49 68 68 68 68 5c 66 52 20  e\fBu\fIhhhh\fR 
1b20: 0a 2e 0a 54 68 65 20 68 65 78 61 64 65 63 69 6d  ...The hexadecim
1b30: 61 6c 20 64 69 67 69 74 73 20 5c 66 49 68 68 68  al digits \fIhhh
1b40: 68 5c 66 52 20 28 6f 6e 65 2c 20 74 77 6f 2c 20  h\fR (one, two, 
1b50: 74 68 72 65 65 2c 20 6f 72 20 66 6f 75 72 20 6f  three, or four o
1b60: 66 20 74 68 65 6d 29 20 67 69 76 65 20 61 0a 73  f them) give a.s
1b70: 69 78 74 65 65 6e 2d 62 69 74 20 68 65 78 61 64  ixteen-bit hexad
1b80: 65 63 69 6d 61 6c 20 76 61 6c 75 65 20 66 6f 72  ecimal value for
1b90: 20 74 68 65 20 55 6e 69 63 6f 64 65 20 63 68 61   the Unicode cha
1ba0: 72 61 63 74 65 72 20 74 68 61 74 20 77 69 6c 6c  racter that will
1bb0: 20 62 65 0a 69 6e 73 65 72 74 65 64 2e 0a 2e 4c   be.inserted...L
1bc0: 50 0a 42 61 63 6b 73 6c 61 73 68 20 73 75 62 73  P.Backslash subs
1bd0: 74 69 74 75 74 69 6f 6e 20 69 73 20 6e 6f 74 20  titution is not 
1be0: 70 65 72 66 6f 72 6d 65 64 20 6f 6e 20 77 6f 72  performed on wor
1bf0: 64 73 20 65 6e 63 6c 6f 73 65 64 20 69 6e 20 62  ds enclosed in b
1c00: 72 61 63 65 73 2c 0a 65 78 63 65 70 74 20 66 6f  races,.except fo
1c10: 72 20 62 61 63 6b 73 6c 61 73 68 2d 6e 65 77 6c  r backslash-newl
1c20: 69 6e 65 20 61 73 20 64 65 73 63 72 69 62 65 64  ine as described
1c30: 20 61 62 6f 76 65 2e 0a 2e 52 45 0a 2e 49 50 20   above...RE..IP 
1c40: 22 5b 31 30 5d 20 5c 66 42 43 6f 6d 6d 65 6e 74  "[10] \fBComment
1c50: 73 2e 5c 66 52 22 0a 49 66 20 61 20 68 61 73 68  s.\fR".If a hash
1c60: 20 63 68 61 72 61 63 74 65 72 0a 2e 50 51 20 23   character..PQ #
1c70: 0a 61 70 70 65 61 72 73 20 61 74 20 61 20 70 6f  .appears at a po
1c80: 69 6e 74 20 77 68 65 72 65 20 54 63 6c 20 69 73  int where Tcl is
1c90: 0a 65 78 70 65 63 74 69 6e 67 20 74 68 65 20 66  .expecting the f
1ca0: 69 72 73 74 20 63 68 61 72 61 63 74 65 72 20 6f  irst character o
1cb0: 66 20 74 68 65 20 66 69 72 73 74 20 77 6f 72 64  f the first word
1cc0: 20 6f 66 20 61 20 63 6f 6d 6d 61 6e 64 2c 0a 74   of a command,.t
1cd0: 68 65 6e 20 74 68 65 20 68 61 73 68 20 63 68 61  hen the hash cha
1ce0: 72 61 63 74 65 72 20 61 6e 64 20 74 68 65 20 63  racter and the c
1cf0: 68 61 72 61 63 74 65 72 73 20 74 68 61 74 20 66  haracters that f
1d00: 6f 6c 6c 6f 77 20 69 74 2c 20 75 70 0a 74 68 72  ollow it, up.thr
1d10: 6f 75 67 68 20 74 68 65 20 6e 65 78 74 20 6e 65  ough the next ne
1d20: 77 6c 69 6e 65 2c 20 61 72 65 20 74 72 65 61 74  wline, are treat
1d30: 65 64 20 61 73 20 61 20 63 6f 6d 6d 65 6e 74 20  ed as a comment 
1d40: 61 6e 64 20 69 67 6e 6f 72 65 64 2e 0a 54 68 65  and ignored..The
1d50: 20 63 6f 6d 6d 65 6e 74 20 63 68 61 72 61 63 74   comment charact
1d60: 65 72 20 6f 6e 6c 79 20 68 61 73 20 73 69 67 6e  er only has sign
1d70: 69 66 69 63 61 6e 63 65 20 77 68 65 6e 20 69 74  ificance when it
1d80: 20 61 70 70 65 61 72 73 0a 61 74 20 74 68 65 20   appears.at the 
1d90: 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 61 20 63  beginning of a c
1da0: 6f 6d 6d 61 6e 64 2e 0a 2e 49 50 20 22 5b 31 31  ommand...IP "[11
1db0: 5d 20 5c 66 42 4f 72 64 65 72 20 6f 66 20 73 75  ] \fBOrder of su
1dc0: 62 73 74 69 74 75 74 69 6f 6e 2e 5c 66 52 22 0a  bstitution.\fR".
1dd0: 45 61 63 68 20 63 68 61 72 61 63 74 65 72 20 69  Each character i
1de0: 73 20 70 72 6f 63 65 73 73 65 64 20 65 78 61 63  s processed exac
1df0: 74 6c 79 20 6f 6e 63 65 20 62 79 20 74 68 65 20  tly once by the 
1e00: 54 63 6c 20 69 6e 74 65 72 70 72 65 74 65 72 0a  Tcl interpreter.
1e10: 61 73 20 70 61 72 74 20 6f 66 20 63 72 65 61 74  as part of creat
1e20: 69 6e 67 20 74 68 65 20 77 6f 72 64 73 20 6f 66  ing the words of
1e30: 20 61 20 63 6f 6d 6d 61 6e 64 2e 0a 46 6f 72 20   a command..For 
1e40: 65 78 61 6d 70 6c 65 2c 20 69 66 20 76 61 72 69  example, if vari
1e50: 61 62 6c 65 20 73 75 62 73 74 69 74 75 74 69 6f  able substitutio
1e60: 6e 20 6f 63 63 75 72 73 20 74 68 65 6e 20 6e 6f  n occurs then no
1e70: 20 66 75 72 74 68 65 72 0a 73 75 62 73 74 69 74   further.substit
1e80: 75 74 69 6f 6e 73 20 61 72 65 20 70 65 72 66 6f  utions are perfo
1e90: 72 6d 65 64 20 6f 6e 20 74 68 65 20 76 61 6c 75  rmed on the valu
1ea0: 65 20 6f 66 20 74 68 65 20 76 61 72 69 61 62 6c  e of the variabl
1eb0: 65 3b 20 20 74 68 65 0a 76 61 6c 75 65 20 69 73  e;  the.value is
1ec0: 20 69 6e 73 65 72 74 65 64 20 69 6e 74 6f 20 74   inserted into t
1ed0: 68 65 20 77 6f 72 64 20 76 65 72 62 61 74 69 6d  he word verbatim
1ee0: 2e 0a 49 66 20 63 6f 6d 6d 61 6e 64 20 73 75 62  ..If command sub
1ef0: 73 74 69 74 75 74 69 6f 6e 20 6f 63 63 75 72 73  stitution occurs
1f00: 20 74 68 65 6e 20 74 68 65 20 6e 65 73 74 65 64   then the nested
1f10: 20 63 6f 6d 6d 61 6e 64 20 69 73 0a 70 72 6f 63   command is.proc
1f20: 65 73 73 65 64 20 65 6e 74 69 72 65 6c 79 20 62  essed entirely b
1f30: 79 20 74 68 65 20 72 65 63 75 72 73 69 76 65 20  y the recursive 
1f40: 63 61 6c 6c 20 74 6f 20 74 68 65 20 54 63 6c 20  call to the Tcl 
1f50: 69 6e 74 65 72 70 72 65 74 65 72 3b 0a 6e 6f 20  interpreter;.no 
1f60: 73 75 62 73 74 69 74 75 74 69 6f 6e 73 20 61 72  substitutions ar
1f70: 65 20 70 65 72 66 6f 72 6d 65 64 20 62 65 66 6f  e performed befo
1f80: 72 65 20 6d 61 6b 69 6e 67 20 74 68 65 20 72 65  re making the re
1f90: 63 75 72 73 69 76 65 0a 63 61 6c 6c 20 61 6e 64  cursive.call and
1fa0: 20 6e 6f 20 61 64 64 69 74 69 6f 6e 61 6c 20 73   no additional s
1fb0: 75 62 73 74 69 74 75 74 69 6f 6e 73 20 61 72 65  ubstitutions are
1fc0: 20 70 65 72 66 6f 72 6d 65 64 20 6f 6e 20 74 68   performed on th
1fd0: 65 20 72 65 73 75 6c 74 0a 6f 66 20 74 68 65 20  e result.of the 
1fe0: 6e 65 73 74 65 64 20 73 63 72 69 70 74 2e 0a 2e  nested script...
1ff0: 52 53 0a 2e 4c 50 0a 53 75 62 73 74 69 74 75 74  RS..LP.Substitut
2000: 69 6f 6e 73 20 74 61 6b 65 20 70 6c 61 63 65 20  ions take place 
2010: 66 72 6f 6d 20 6c 65 66 74 20 74 6f 20 72 69 67  from left to rig
2020: 68 74 2c 20 61 6e 64 20 65 61 63 68 20 73 75 62  ht, and each sub
2030: 73 74 69 74 75 74 69 6f 6e 20 69 73 0a 65 76 61  stitution is.eva
2040: 6c 75 61 74 65 64 20 63 6f 6d 70 6c 65 74 65 6c  luated completel
2050: 79 20 62 65 66 6f 72 65 20 61 74 74 65 6d 70 74  y before attempt
2060: 69 6e 67 20 74 6f 20 65 76 61 6c 75 61 74 65 20  ing to evaluate 
2070: 74 68 65 20 6e 65 78 74 2e 20 20 54 68 75 73 2c  the next.  Thus,
2080: 20 61 0a 73 65 71 75 65 6e 63 65 20 6c 69 6b 65   a.sequence like
2090: 0a 2e 43 53 0a 73 65 74 20 79 20 5b 73 65 74 20  ..CS.set y [set 
20a0: 78 20 30 5d 5b 69 6e 63 72 20 78 5d 5b 69 6e 63  x 0][incr x][inc
20b0: 72 20 78 5d 0a 2e 43 45 0a 77 69 6c 6c 20 61 6c  r x]..CE.will al
20c0: 77 61 79 73 20 73 65 74 20 74 68 65 20 76 61 72  ways set the var
20d0: 69 61 62 6c 65 20 5c 66 49 79 5c 66 52 20 74 6f  iable \fIy\fR to
20e0: 20 74 68 65 20 76 61 6c 75 65 2c 20 5c 66 49 30   the value, \fI0
20f0: 31 32 5c 66 52 2e 0a 2e 52 45 0a 2e 49 50 20 22  12\fR...RE..IP "
2100: 5b 31 32 5d 20 5c 66 42 53 75 62 73 74 69 74 75  [12] \fBSubstitu
2110: 74 69 6f 6e 20 61 6e 64 20 77 6f 72 64 20 62 6f  tion and word bo
2120: 75 6e 64 61 72 69 65 73 2e 5c 66 52 22 0a 53 75  undaries.\fR".Su
2130: 62 73 74 69 74 75 74 69 6f 6e 73 20 64 6f 20 6e  bstitutions do n
2140: 6f 74 20 61 66 66 65 63 74 20 74 68 65 20 77 6f  ot affect the wo
2150: 72 64 20 62 6f 75 6e 64 61 72 69 65 73 20 6f 66  rd boundaries of
2160: 20 61 20 63 6f 6d 6d 61 6e 64 2c 0a 65 78 63 65   a command,.exce
2170: 70 74 20 66 6f 72 20 61 72 67 75 6d 65 6e 74 20  pt for argument 
2180: 65 78 70 61 6e 73 69 6f 6e 20 61 73 20 73 70 65  expansion as spe
2190: 63 69 66 69 65 64 20 69 6e 20 72 75 6c 65 20 5b  cified in rule [
21a0: 35 5d 2e 0a 46 6f 72 20 65 78 61 6d 70 6c 65 2c  5]..For example,
21b0: 20 64 75 72 69 6e 67 20 76 61 72 69 61 62 6c 65   during variable
21c0: 20 73 75 62 73 74 69 74 75 74 69 6f 6e 20 74 68   substitution th
21d0: 65 20 65 6e 74 69 72 65 20 76 61 6c 75 65 20 6f  e entire value o
21e0: 66 0a 74 68 65 20 76 61 72 69 61 62 6c 65 20 62  f.the variable b
21f0: 65 63 6f 6d 65 73 20 70 61 72 74 20 6f 66 20 61  ecomes part of a
2200: 20 73 69 6e 67 6c 65 20 77 6f 72 64 2c 20 65 76   single word, ev
2210: 65 6e 20 69 66 20 74 68 65 20 76 61 72 69 61 62  en if the variab
2220: 6c 65 27 73 0a 76 61 6c 75 65 20 63 6f 6e 74 61  le's.value conta
2230: 69 6e 73 20 73 70 61 63 65 73 2e 0a              ins spaces..