Hex Artifact Content
Not logged in

Artifact 2b8758d0ac5e1c2e6856e8b3e5c3cd29d77901b3:

File tools/cvs2fossil/lib/rcsparser.tcl part of check-in [8a93ffa9c1] - Fleshed out pass II, added skeleton of rcs archive class, started integration of rcs parser. by aku on 2007-10-06 18:43:01.

0000: 23 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  # --------------
0010: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0020: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0030: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0040: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a  ---------------.
0050: 23 20 54 6f 6f 6c 20 70 61 63 6b 61 67 65 73 2e  # Tool packages.
0060: 20 50 61 72 73 69 6e 67 20 52 43 53 20 66 69 6c   Parsing RCS fil
0070: 65 73 2e 0a 23 0a 23 20 53 6f 6d 65 20 6f 66 20  es..#.# Some of 
0080: 74 68 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20  the information 
0090: 69 6e 20 52 43 53 20 66 69 6c 65 73 20 69 73 20  in RCS files is 
00a0: 73 6b 69 70 70 65 64 20 6f 76 65 72 2c 20 6d 6f  skipped over, mo
00b0: 73 74 0a 23 20 69 6d 70 6f 72 74 61 6e 74 6c 79  st.# importantly
00c0: 20 74 68 65 20 61 63 74 75 61 6c 20 64 65 6c 74   the actual delt
00d0: 61 20 74 65 78 74 73 2e 20 54 68 65 20 75 73 65  a texts. The use
00e0: 72 73 20 6f 66 20 74 68 69 73 20 70 61 72 73 65  rs of this parse
00f0: 72 20 6e 65 65 64 0a 23 20 6f 6e 6c 79 20 74 68  r need.# only th
0100: 65 20 6d 65 74 61 2d 64 61 74 61 20 61 62 6f 75  e meta-data abou
0110: 74 20 77 68 65 6e 20 72 65 76 69 73 69 6f 6e 73  t when revisions
0120: 20 77 65 72 65 20 61 64 64 65 64 2c 20 74 68 65   were added, the
0130: 20 74 72 65 65 0a 23 20 28 62 72 61 6e 63 68 69   tree.# (branchi
0140: 6e 67 29 20 73 74 72 75 63 74 75 72 65 2c 20 63  ng) structure, c
0150: 6f 6d 6d 69 74 20 6d 65 73 73 61 67 65 73 2e 0a  ommit messages..
0160: 23 0a 23 20 54 68 65 20 70 61 72 73 65 72 20 69  #.# The parser i
0170: 73 20 62 61 73 65 64 20 6f 6e 20 52 65 63 75 72  s based on Recur
0180: 73 69 76 65 20 44 65 73 63 65 6e 74 2e 0a 0a 23  sive Descent...#
0190: 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d   ---------------
01a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
01b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
01c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
01d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23  --------------.#
01e0: 20 52 65 71 75 69 72 65 6d 65 6e 74 73 0a 0a 70   Requirements..p
01f0: 61 63 6b 61 67 65 20 72 65 71 75 69 72 65 20 54  ackage require T
0200: 63 6c 20 38 2e 34 0a 70 61 63 6b 61 67 65 20 72  cl 8.4.package r
0210: 65 71 75 69 72 65 20 66 69 6c 65 75 74 69 6c 20  equire fileutil 
0220: 20 20 20 20 20 20 3b 20 23 20 54 63 6c 6c 69 62        ; # Tcllib
0230: 20 28 63 61 74 29 0a 70 61 63 6b 61 67 65 20 72   (cat).package r
0240: 65 71 75 69 72 65 20 76 63 3a 3a 74 6f 6f 6c 73  equire vc::tools
0250: 3a 3a 6c 6f 67 20 3b 20 23 20 55 73 65 72 20 66  ::log ; # User f
0260: 65 65 64 62 61 63 6b 0a 0a 6e 61 6d 65 73 70 61  eedback..namespa
0270: 63 65 20 65 76 61 6c 20 3a 3a 76 63 3a 3a 72 63  ce eval ::vc::rc
0280: 73 3a 3a 70 61 72 73 65 72 20 7b 0a 20 20 20 20  s::parser {.    
0290: 6e 61 6d 65 73 70 61 63 65 20 69 6d 70 6f 72 74  namespace import
02a0: 20 3a 3a 76 63 3a 3a 74 6f 6f 6c 73 3a 3a 6c 6f   ::vc::tools::lo
02b0: 67 0a 20 20 20 20 6c 6f 67 20 72 65 67 69 73 74  g.    log regist
02c0: 65 72 20 72 63 73 0a 7d 0a 0a 23 20 2d 2d 2d 2d  er rcs.}..# ----
02d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
02e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
02f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0300: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0310: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 20 41 50 49 0a  ---------.# API.
0320: 0a 23 20 76 63 3a 3a 72 63 73 3a 3a 70 61 72 73  .# vc::rcs::pars
0330: 65 72 3a 3a 70 72 6f 63 65 73 73 20 66 69 6c 65  er::process file
0340: 0a 23 0a 23 20 50 61 72 73 65 73 20 74 68 65 20  .#.# Parses the 
0350: 72 63 73 20 66 69 6c 65 20 61 6e 64 20 72 65 74  rcs file and ret
0360: 75 72 6e 73 20 61 20 64 69 63 74 69 6f 6e 61 72  urns a dictionar
0370: 79 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65  y containing the
0380: 20 6d 65 74 61 0a 23 20 64 61 74 61 2e 20 54 68   meta.# data. Th
0390: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6b 65 79 73  e following keys
03a0: 20 61 72 65 20 75 73 65 64 0a 23 0a 23 20 4b 65   are used.#.# Ke
03b0: 79 09 09 4d 65 61 6e 69 6e 67 0a 23 20 2d 2d 2d  y..Meaning.# ---
03c0: 09 09 2d 2d 2d 2d 2d 2d 2d 0a 23 20 27 68 65 61  ..-------.# 'hea
03d0: 64 27 09 68 65 61 64 20 72 65 76 69 73 69 6f 6e  d'.head revision
03e0: 0a 23 20 27 62 72 61 6e 63 68 27 09 3f 0a 23 20  .# 'branch'.?.# 
03f0: 27 73 79 6d 62 6f 6c 27 09 64 69 63 74 20 28 73  'symbol'.dict (s
0400: 79 6d 62 6f 6c 20 2d 3e 20 72 65 76 69 73 69 6f  ymbol -> revisio
0410: 6e 29 0a 23 20 27 6c 6f 63 6b 27 09 64 69 63 74  n).# 'lock'.dict
0420: 20 28 73 79 6d 62 6f 6c 20 2d 3e 20 72 65 76 69   (symbol -> revi
0430: 73 69 6f 6e 29 0a 23 20 27 63 6f 6d 6d 65 6e 74  sion).# 'comment
0440: 27 09 66 69 6c 65 20 63 6f 6d 6d 65 6e 74 0a 23  '.file comment.#
0450: 20 27 65 78 70 61 6e 64 27 09 3f 0a 23 20 27 64   'expand'.?.# 'd
0460: 61 74 65 27 09 64 69 63 74 20 28 72 65 76 69 73  ate'.dict (revis
0470: 69 6f 6e 20 2d 3e 20 64 61 74 65 29 0a 23 20 27  ion -> date).# '
0480: 61 75 74 68 6f 72 27 09 64 69 63 74 20 28 72 65  author'.dict (re
0490: 76 69 73 69 6f 6e 20 2d 3e 20 61 75 74 68 6f 72  vision -> author
04a0: 29 0a 23 20 27 73 74 61 74 65 27 09 64 69 63 74  ).# 'state'.dict
04b0: 20 28 72 65 76 69 73 69 6f 6e 20 2d 3e 20 73 74   (revision -> st
04c0: 61 74 65 29 0a 23 20 27 70 61 72 65 6e 74 27 09  ate).# 'parent'.
04d0: 64 69 63 74 20 28 72 65 76 69 73 69 6f 6e 20 2d  dict (revision -
04e0: 3e 20 70 61 72 65 6e 74 20 72 65 76 69 73 69 6f  > parent revisio
04f0: 6e 29 0a 23 20 27 63 6f 6d 6d 69 74 27 09 64 69  n).# 'commit'.di
0500: 63 74 20 28 72 65 76 69 73 69 6f 6e 20 2d 3e 20  ct (revision -> 
0510: 63 6f 6d 6d 69 74 20 6d 65 73 73 61 67 65 29 0a  commit message).
0520: 23 0a 23 20 54 68 65 20 73 74 61 74 65 20 27 64  #.# The state 'd
0530: 65 61 64 27 20 68 61 73 20 73 70 65 63 69 61 6c  ead' has special
0540: 20 6d 65 61 6e 69 6e 67 2c 20 74 68 65 20 75 73   meaning, the us
0550: 65 72 20 73 68 6f 75 6c 64 20 6b 6e 6f 77 20 74  er should know t
0560: 68 61 74 2e 0a 0a 23 20 2d 2d 2d 2d 2d 2d 2d 2d  hat...# --------
0570: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0580: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0590: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
05a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
05b0: 2d 2d 2d 2d 2d 0a 23 20 41 50 49 20 49 6d 70 6c  -----.# API Impl
05c0: 65 6d 65 6e 74 61 74 69 6f 6e 0a 0a 70 72 6f 63  ementation..proc
05d0: 20 3a 3a 76 63 3a 3a 72 63 73 3a 3a 70 61 72 73   ::vc::rcs::pars
05e0: 65 72 3a 3a 63 6f 6e 66 69 67 75 72 65 20 7b 6b  er::configure {k
05f0: 65 79 20 76 61 6c 75 65 7d 20 7b 0a 20 20 20 20  ey value} {.    
0600: 76 61 72 69 61 62 6c 65 20 63 61 63 68 65 0a 20  variable cache. 
0610: 20 20 20 73 77 69 74 63 68 20 2d 65 78 61 63 74     switch -exact
0620: 20 2d 2d 20 24 6b 65 79 20 7b 0a 09 2d 63 61 63   -- $key {..-cac
0630: 68 65 20 20 7b 0a 09 20 20 20 20 73 65 74 20 63  he  {..    set c
0640: 61 63 68 65 20 24 76 61 6c 75 65 0a 09 7d 0a 09  ache $value..}..
0650: 64 65 66 61 75 6c 74 20 7b 0a 09 20 20 20 20 72  default {..    r
0660: 65 74 75 72 6e 20 2d 63 6f 64 65 20 65 72 72 6f  eturn -code erro
0670: 72 20 22 55 6e 6b 6e 6f 77 6e 20 73 77 69 74 63  r "Unknown switc
0680: 68 20 24 6b 65 79 2c 20 65 78 70 65 63 74 65 64  h $key, expected
0690: 20 6f 6e 65 20 6f 66 20 2d 63 61 63 68 65 22 0a   one of -cache".
06a0: 09 7d 0a 20 20 20 20 7d 0a 20 20 20 20 72 65 74  .}.    }.    ret
06b0: 75 72 6e 0a 7d 0a 0a 70 72 6f 63 20 3a 3a 76 63  urn.}..proc ::vc
06c0: 3a 3a 72 63 73 3a 3a 70 61 72 73 65 72 3a 3a 70  ::rcs::parser::p
06d0: 72 6f 63 65 73 73 20 7b 70 61 74 68 7d 20 7b 0a  rocess {path} {.
06e0: 20 20 20 20 76 61 72 69 61 62 6c 65 20 63 61 63      variable cac
06f0: 68 65 0a 0a 20 20 20 20 69 66 20 7b 21 24 63 61  he..    if {!$ca
0700: 63 68 65 7d 20 7b 0a 09 72 65 74 75 72 6e 20 5b  che} {..return [
0710: 50 72 6f 63 65 73 73 20 24 70 61 74 68 5d 0a 20  Process $path]. 
0720: 20 20 20 7d 0a 0a 20 20 20 20 73 65 74 20 63 61     }..    set ca
0730: 63 68 65 66 69 6c 65 20 5b 43 61 63 68 65 20 24  chefile [Cache $
0740: 70 61 74 68 5d 0a 20 20 20 20 69 66 20 7b 0a 09  path].    if {..
0750: 5b 66 69 6c 65 20 65 78 69 73 74 73 20 24 63 61  [file exists $ca
0760: 63 68 65 66 69 6c 65 5d 20 26 26 0a 09 28 5b 66  chefile] &&..([f
0770: 69 6c 65 20 6d 74 69 6d 65 20 24 63 61 63 68 65  ile mtime $cache
0780: 66 69 6c 65 5d 20 3e 20 5b 66 69 6c 65 20 6d 74  file] > [file mt
0790: 69 6d 65 20 24 70 61 74 68 5d 29 0a 20 20 20 20  ime $path]).    
07a0: 7d 20 7b 0a 09 23 20 55 73 65 20 70 72 65 70 61  } {..# Use prepa
07b0: 72 73 65 64 20 64 61 74 61 20 69 66 20 6e 6f 74  rsed data if not
07c0: 20 69 6e 76 61 6c 69 64 61 74 65 64 20 62 79 20   invalidated by 
07d0: 63 68 61 6e 67 65 73 20 74 6f 20 74 68 65 0a 09  changes to the..
07e0: 23 20 61 72 63 68 69 76 65 20 74 68 65 79 20 61  # archive they a
07f0: 72 65 20 64 65 72 69 76 65 64 20 66 72 6f 6d 2e  re derived from.
0800: 0a 09 77 72 69 74 65 20 34 20 72 63 73 20 7b 4c  ..write 4 rcs {L
0810: 6f 61 64 20 70 72 65 70 61 72 73 65 64 20 64 61  oad preparsed da
0820: 74 61 20 62 6c 6f 63 6b 7d 0a 09 72 65 74 75 72  ta block}..retur
0830: 6e 20 5b 66 69 6c 65 75 74 69 6c 3a 3a 63 61 74  n [fileutil::cat
0840: 20 2d 65 6e 63 6f 64 69 6e 67 20 62 69 6e 61 72   -encoding binar
0850: 79 20 24 63 61 63 68 65 66 69 6c 65 5d 0a 20 20  y $cachefile].  
0860: 20 20 7d 0a 0a 20 20 20 20 73 65 74 20 72 65 73    }..    set res
0870: 20 5b 50 72 6f 63 65 73 73 20 24 70 61 74 68 5d   [Process $path]
0880: 0a 0a 20 20 20 20 23 20 53 61 76 65 20 70 61 72  ..    # Save par
0890: 73 65 20 72 65 73 75 6c 74 20 66 6f 72 20 71 75  se result for qu
08a0: 69 63 6b 20 70 69 63 6b 75 70 20 62 79 20 66 75  ick pickup by fu
08b0: 74 75 72 65 20 72 75 6e 73 2e 0a 20 20 20 20 66  ture runs..    f
08c0: 69 6c 65 75 74 69 6c 3a 3a 77 72 69 74 65 46 69  ileutil::writeFi
08d0: 6c 65 20 24 63 61 63 68 65 66 69 6c 65 20 24 72  le $cachefile $r
08e0: 65 73 0a 0a 20 20 20 20 72 65 74 75 72 6e 20 24  es..    return $
08f0: 72 65 73 0a 7d 0a 0a 23 20 2d 2d 2d 2d 2d 2d 2d  res.}..# -------
0900: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0910: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0920: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0930: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0940: 2d 2d 2d 2d 2d 2d 0a 0a 70 72 6f 63 20 3a 3a 76  ------..proc ::v
0950: 63 3a 3a 72 63 73 3a 3a 70 61 72 73 65 72 3a 3a  c::rcs::parser::
0960: 50 72 6f 63 65 73 73 20 7b 70 61 74 68 7d 20 7b  Process {path} {
0970: 0a 20 20 20 20 73 65 74 20 64 61 74 61 20 5b 66  .    set data [f
0980: 69 6c 65 75 74 69 6c 3a 3a 63 61 74 20 2d 65 6e  ileutil::cat -en
0990: 63 6f 64 69 6e 67 20 62 69 6e 61 72 79 20 24 70  coding binary $p
09a0: 61 74 68 5d 0a 20 20 20 20 61 72 72 61 79 20 73  ath].    array s
09b0: 65 74 20 72 65 73 20 7b 7d 0a 20 20 20 20 73 65  et res {}.    se
09c0: 74 20 72 65 73 28 73 69 7a 65 29 20 5b 66 69 6c  t res(size) [fil
09d0: 65 20 73 69 7a 65 20 24 70 61 74 68 5d 0a 20 20  e size $path].  
09e0: 20 20 73 65 74 20 72 65 73 28 64 6f 6e 65 29 20    set res(done) 
09f0: 30 0a 20 20 20 20 73 65 74 20 72 65 73 28 6e 73  0.    set res(ns
0a00: 69 7a 65 29 20 5b 73 74 72 69 6e 67 20 6c 65 6e  ize) [string len
0a10: 67 74 68 20 24 72 65 73 28 73 69 7a 65 29 5d 0a  gth $res(size)].
0a20: 0a 20 20 20 20 41 64 6d 69 6e 0a 20 20 20 20 44  .    Admin.    D
0a30: 65 6c 74 61 73 0a 20 20 20 20 44 65 73 63 72 69  eltas.    Descri
0a40: 70 74 69 6f 6e 0a 20 20 20 20 44 65 6c 74 61 54  ption.    DeltaT
0a50: 65 78 74 73 0a 0a 20 20 20 20 23 20 52 65 6d 6f  exts..    # Remo
0a60: 76 65 20 70 61 72 73 65 72 20 73 74 61 74 65 0a  ve parser state.
0a70: 20 20 20 20 63 61 74 63 68 20 7b 75 6e 73 65 74      catch {unset
0a80: 20 72 65 73 28 69 64 29 7d 0a 20 20 20 20 63 61   res(id)}.    ca
0a90: 74 63 68 20 7b 75 6e 73 65 74 20 72 65 73 28 6c  tch {unset res(l
0aa0: 61 73 74 76 61 6c 29 7d 0a 20 20 20 20 75 6e 73  astval)}.    uns
0ab0: 65 74 20 72 65 73 28 73 69 7a 65 29 0a 20 20 20  et res(size).   
0ac0: 20 75 6e 73 65 74 20 72 65 73 28 6e 73 69 7a 65   unset res(nsize
0ad0: 29 0a 20 20 20 20 75 6e 73 65 74 20 72 65 73 28  ).    unset res(
0ae0: 64 6f 6e 65 29 0a 0a 20 20 20 20 72 65 74 75 72  done)..    retur
0af0: 6e 20 5b 61 72 72 61 79 20 67 65 74 20 72 65 73  n [array get res
0b00: 5d 0a 7d 0a 0a 70 72 6f 63 20 3a 3a 76 63 3a 3a  ].}..proc ::vc::
0b10: 72 63 73 3a 3a 70 61 72 73 65 72 3a 3a 43 61 63  rcs::parser::Cac
0b20: 68 65 20 7b 70 61 74 68 7d 20 7b 0a 20 20 20 20  he {path} {.    
0b30: 72 65 74 75 72 6e 20 24 7b 70 61 74 68 7d 2c 2c  return ${path},,
0b40: 70 72 65 70 61 72 73 65 64 0a 7d 0a 0a 23 20 2d  preparsed.}..# -
0b50: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0b60: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0b70: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0b80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0b90: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 20 49  ------------.# I
0ba0: 6e 74 65 72 6e 61 6c 20 2d 20 52 65 63 75 72 73  nternal - Recurs
0bb0: 69 76 65 20 44 65 73 63 65 6e 74 20 66 75 6e 63  ive Descent func
0bc0: 74 69 6f 6e 73 20 69 6d 70 6c 65 6d 65 6e 74 69  tions implementi
0bd0: 6e 67 20 74 68 65 20 73 79 6e 74 61 78 2e 0a 0a  ng the syntax...
0be0: 70 72 6f 63 20 3a 3a 76 63 3a 3a 72 63 73 3a 3a  proc ::vc::rcs::
0bf0: 70 61 72 73 65 72 3a 3a 41 64 6d 69 6e 20 7b 7d  parser::Admin {}
0c00: 20 7b 0a 20 20 20 20 75 70 76 61 72 20 31 20 64   {.    upvar 1 d
0c10: 61 74 61 20 64 61 74 61 20 72 65 73 20 72 65 73  ata data res res
0c20: 0a 20 20 20 20 48 65 61 64 20 3b 20 42 72 61 6e  .    Head ; Bran
0c30: 63 68 20 3b 20 41 63 63 65 73 73 20 3b 20 53 79  ch ; Access ; Sy
0c40: 6d 62 6f 6c 73 20 3b 20 4c 6f 63 6b 73 20 3b 20  mbols ; Locks ; 
0c50: 53 74 72 69 63 74 20 3b 20 43 6f 6d 6d 65 6e 74  Strict ; Comment
0c60: 20 3b 20 45 78 70 61 6e 64 0a 20 20 20 20 72 65   ; Expand.    re
0c70: 74 75 72 6e 0a 7d 0a 0a 70 72 6f 63 20 3a 3a 76  turn.}..proc ::v
0c80: 63 3a 3a 72 63 73 3a 3a 70 61 72 73 65 72 3a 3a  c::rcs::parser::
0c90: 44 65 6c 74 61 73 20 7b 7d 20 7b 0a 20 20 20 20  Deltas {} {.    
0ca0: 75 70 76 61 72 20 31 20 64 61 74 61 20 64 61 74  upvar 1 data dat
0cb0: 61 20 72 65 73 20 72 65 73 0a 20 20 20 20 77 68  a res res.    wh
0cc0: 69 6c 65 20 7b 5b 4e 75 6d 20 30 5d 7d 20 7b 20  ile {[Num 0]} { 
0cd0: 49 73 49 64 65 6e 74 20 3b 20 44 61 74 65 20 3b  IsIdent ; Date ;
0ce0: 20 41 75 74 68 6f 72 20 3b 20 53 74 61 74 65 20   Author ; State 
0cf0: 3b 20 42 72 61 6e 63 68 65 73 20 3b 20 4e 65 78  ; Branches ; Nex
0d00: 74 52 65 76 20 7d 0a 20 20 20 20 72 65 74 75 72  tRev }.    retur
0d10: 6e 0a 7d 0a 0a 70 72 6f 63 20 3a 3a 76 63 3a 3a  n.}..proc ::vc::
0d20: 72 63 73 3a 3a 70 61 72 73 65 72 3a 3a 44 65 73  rcs::parser::Des
0d30: 63 72 69 70 74 69 6f 6e 20 7b 7d 20 7b 0a 20 20  cription {} {.  
0d40: 20 20 75 70 76 61 72 20 31 20 64 61 74 61 20 64    upvar 1 data d
0d50: 61 74 61 20 72 65 73 20 72 65 73 0a 20 20 20 20  ata res res.    
0d60: 4c 69 74 65 72 61 6c 20 64 65 73 63 0a 20 20 20  Literal desc.   
0d70: 20 53 74 72 69 6e 67 20 31 0a 20 20 20 20 44 65   String 1.    De
0d80: 66 20 64 65 73 63 0a 20 20 20 20 72 65 74 75 72  f desc.    retur
0d90: 6e 0a 7d 0a 0a 70 72 6f 63 20 3a 3a 76 63 3a 3a  n.}..proc ::vc::
0da0: 72 63 73 3a 3a 70 61 72 73 65 72 3a 3a 44 65 6c  rcs::parser::Del
0db0: 74 61 54 65 78 74 73 20 7b 7d 20 7b 0a 20 20 20  taTexts {} {.   
0dc0: 20 75 70 76 61 72 20 31 20 64 61 74 61 20 64 61   upvar 1 data da
0dd0: 74 61 20 72 65 73 20 72 65 73 0a 20 20 20 20 77  ta res res.    w
0de0: 68 69 6c 65 20 7b 5b 4e 75 6d 20 30 5d 7d 20 7b  hile {[Num 0]} {
0df0: 20 49 73 49 64 65 6e 74 20 3b 20 4c 6f 67 20 3b   IsIdent ; Log ;
0e00: 20 54 65 78 74 20 7d 0a 20 20 20 20 72 65 74 75   Text }.    retu
0e10: 72 6e 0a 7d 0a 0a 70 72 6f 63 20 3a 3a 76 63 3a  rn.}..proc ::vc:
0e20: 3a 72 63 73 3a 3a 70 61 72 73 65 72 3a 3a 48 65  :rcs::parser::He
0e30: 61 64 20 7b 7d 20 7b 0a 20 20 20 20 75 70 76 61  ad {} {.    upva
0e40: 72 20 31 20 64 61 74 61 20 64 61 74 61 20 72 65  r 1 data data re
0e50: 73 20 72 65 73 0a 20 20 20 20 4c 69 74 65 72 61  s res.    Litera
0e60: 6c 20 68 65 61 64 20 3b 20 4e 75 6d 20 31 20 3b  l head ; Num 1 ;
0e70: 20 4c 69 74 65 72 61 6c 20 5c 3b 0a 20 20 20 20   Literal \;.    
0e80: 44 65 66 20 68 65 61 64 0a 20 20 20 20 72 65 74  Def head.    ret
0e90: 75 72 6e 0a 7d 0a 0a 70 72 6f 63 20 3a 3a 76 63  urn.}..proc ::vc
0ea0: 3a 3a 72 63 73 3a 3a 70 61 72 73 65 72 3a 3a 42  ::rcs::parser::B
0eb0: 72 61 6e 63 68 20 7b 7d 20 7b 0a 20 20 20 20 75  ranch {} {.    u
0ec0: 70 76 61 72 20 31 20 64 61 74 61 20 64 61 74 61  pvar 1 data data
0ed0: 20 72 65 73 20 72 65 73 0a 20 20 20 20 69 66 20   res res.    if 
0ee0: 7b 21 5b 4c 69 74 65 72 61 6c 20 62 72 61 6e 63  {![Literal branc
0ef0: 68 20 30 5d 7d 20 72 65 74 75 72 6e 20 3b 20 4e  h 0]} return ; N
0f00: 75 6d 20 31 20 3b 20 4c 69 74 65 72 61 6c 20 5c  um 1 ; Literal \
0f10: 3b 0a 20 20 20 20 44 65 66 20 62 72 61 6e 63 68  ;.    Def branch
0f20: 0a 20 20 20 20 72 65 74 75 72 6e 0a 7d 0a 0a 70  .    return.}..p
0f30: 72 6f 63 20 3a 3a 76 63 3a 3a 72 63 73 3a 3a 70  roc ::vc::rcs::p
0f40: 61 72 73 65 72 3a 3a 41 63 63 65 73 73 20 7b 7d  arser::Access {}
0f50: 20 7b 0a 20 20 20 20 75 70 76 61 72 20 31 20 64   {.    upvar 1 d
0f60: 61 74 61 20 64 61 74 61 20 72 65 73 20 72 65 73  ata data res res
0f70: 0a 20 20 20 20 4c 69 74 65 72 61 6c 20 61 63 63  .    Literal acc
0f80: 65 73 73 20 3b 20 4c 69 74 65 72 61 6c 20 5c 3b  ess ; Literal \;
0f90: 0a 20 20 20 20 72 65 74 75 72 6e 0a 7d 0a 0a 70  .    return.}..p
0fa0: 72 6f 63 20 3a 3a 76 63 3a 3a 72 63 73 3a 3a 70  roc ::vc::rcs::p
0fb0: 61 72 73 65 72 3a 3a 53 79 6d 62 6f 6c 73 20 7b  arser::Symbols {
0fc0: 7d 20 7b 0a 20 20 20 20 75 70 76 61 72 20 31 20  } {.    upvar 1 
0fd0: 64 61 74 61 20 64 61 74 61 20 72 65 73 20 72 65  data data res re
0fe0: 73 0a 20 20 20 20 4c 69 74 65 72 61 6c 20 73 79  s.    Literal sy
0ff0: 6d 62 6f 6c 73 0a 20 20 20 20 77 68 69 6c 65 20  mbols.    while 
1000: 7b 5b 49 64 65 6e 74 5d 7d 20 7b 20 4e 75 6d 20  {[Ident]} { Num 
1010: 31 20 3b 20 4d 61 70 20 73 79 6d 62 6f 6c 20 7d  1 ; Map symbol }
1020: 0a 20 20 20 20 4c 69 74 65 72 61 6c 20 5c 3b 0a  .    Literal \;.
1030: 20 20 20 20 72 65 74 75 72 6e 0a 7d 0a 0a 70 72      return.}..pr
1040: 6f 63 20 3a 3a 76 63 3a 3a 72 63 73 3a 3a 70 61  oc ::vc::rcs::pa
1050: 72 73 65 72 3a 3a 4c 6f 63 6b 73 20 7b 7d 20 7b  rser::Locks {} {
1060: 0a 20 20 20 20 75 70 76 61 72 20 31 20 64 61 74  .    upvar 1 dat
1070: 61 20 64 61 74 61 20 72 65 73 20 72 65 73 0a 20  a data res res. 
1080: 20 20 20 4c 69 74 65 72 61 6c 20 6c 6f 63 6b 73     Literal locks
1090: 0a 20 20 20 20 77 68 69 6c 65 20 7b 5b 49 64 65  .    while {[Ide
10a0: 6e 74 5d 7d 20 7b 20 4e 75 6d 20 31 20 3b 20 4d  nt]} { Num 1 ; M
10b0: 61 70 20 6c 6f 63 6b 20 7d 0a 20 20 20 20 4c 69  ap lock }.    Li
10c0: 74 65 72 61 6c 20 5c 3b 0a 20 20 20 20 72 65 74  teral \;.    ret
10d0: 75 72 6e 0a 7d 0a 0a 70 72 6f 63 20 3a 3a 76 63  urn.}..proc ::vc
10e0: 3a 3a 72 63 73 3a 3a 70 61 72 73 65 72 3a 3a 53  ::rcs::parser::S
10f0: 74 72 69 63 74 20 7b 7d 20 7b 0a 20 20 20 20 75  trict {} {.    u
1100: 70 76 61 72 20 31 20 64 61 74 61 20 64 61 74 61  pvar 1 data data
1110: 20 72 65 73 20 72 65 73 0a 20 20 20 20 69 66 20   res res.    if 
1120: 7b 21 5b 4c 69 74 65 72 61 6c 20 73 74 72 69 63  {![Literal stric
1130: 74 20 30 5d 7d 20 72 65 74 75 72 6e 20 3b 20 4c  t 0]} return ; L
1140: 69 74 65 72 61 6c 20 5c 3b 0a 20 20 20 20 72 65  iteral \;.    re
1150: 74 75 72 6e 0a 7d 0a 0a 70 72 6f 63 20 3a 3a 76  turn.}..proc ::v
1160: 63 3a 3a 72 63 73 3a 3a 70 61 72 73 65 72 3a 3a  c::rcs::parser::
1170: 43 6f 6d 6d 65 6e 74 20 7b 7d 20 7b 0a 20 20 20  Comment {} {.   
1180: 20 75 70 76 61 72 20 31 20 64 61 74 61 20 64 61   upvar 1 data da
1190: 74 61 20 72 65 73 20 72 65 73 0a 20 20 20 20 69  ta res res.    i
11a0: 66 20 7b 21 5b 4c 69 74 65 72 61 6c 20 63 6f 6d  f {![Literal com
11b0: 6d 65 6e 74 20 30 5d 7d 20 72 65 74 75 72 6e 20  ment 0]} return 
11c0: 3b 0a 20 20 20 20 69 66 20 7b 21 5b 53 74 72 69  ;.    if {![Stri
11d0: 6e 67 20 30 5d 7d 20 72 65 74 75 72 6e 20 3b 0a  ng 0]} return ;.
11e0: 20 20 20 20 4c 69 74 65 72 61 6c 20 5c 3b 0a 20      Literal \;. 
11f0: 20 20 20 44 65 66 20 63 6f 6d 6d 65 6e 74 0a 20     Def comment. 
1200: 20 20 20 72 65 74 75 72 6e 0a 7d 0a 0a 70 72 6f     return.}..pro
1210: 63 20 3a 3a 76 63 3a 3a 72 63 73 3a 3a 70 61 72  c ::vc::rcs::par
1220: 73 65 72 3a 3a 45 78 70 61 6e 64 20 7b 7d 20 7b  ser::Expand {} {
1230: 0a 20 20 20 20 75 70 76 61 72 20 31 20 64 61 74  .    upvar 1 dat
1240: 61 20 64 61 74 61 20 72 65 73 20 72 65 73 0a 20  a data res res. 
1250: 20 20 20 69 66 20 7b 21 5b 4c 69 74 65 72 61 6c     if {![Literal
1260: 20 65 78 70 61 6e 64 20 30 5d 7d 20 72 65 74 75   expand 0]} retu
1270: 72 6e 20 3b 0a 20 20 20 20 69 66 20 7b 21 5b 53  rn ;.    if {![S
1280: 74 72 69 6e 67 20 30 5d 7d 20 72 65 74 75 72 6e  tring 0]} return
1290: 20 3b 0a 20 20 20 20 4c 69 74 65 72 61 6c 20 5c   ;.    Literal \
12a0: 3b 0a 20 20 20 20 44 65 66 20 65 78 70 61 6e 64  ;.    Def expand
12b0: 0a 20 20 20 20 72 65 74 75 72 6e 0a 7d 0a 0a 70  .    return.}..p
12c0: 72 6f 63 20 3a 3a 76 63 3a 3a 72 63 73 3a 3a 70  roc ::vc::rcs::p
12d0: 61 72 73 65 72 3a 3a 44 61 74 65 20 7b 7d 20 7b  arser::Date {} {
12e0: 0a 20 20 20 20 75 70 76 61 72 20 31 20 64 61 74  .    upvar 1 dat
12f0: 61 20 64 61 74 61 20 72 65 73 20 72 65 73 0a 20  a data res res. 
1300: 20 20 20 4c 69 74 65 72 61 6c 20 64 61 74 65 20     Literal date 
1310: 3b 20 4e 75 6d 20 31 20 3b 20 4c 69 74 65 72 61  ; Num 1 ; Litera
1320: 6c 20 5c 3b 0a 0a 20 20 20 20 66 6f 72 65 61 63  l \;..    foreac
1330: 68 20 7b 79 72 20 6d 6f 20 64 79 20 68 20 6d 20  h {yr mo dy h m 
1340: 73 7d 20 5b 73 70 6c 69 74 20 24 72 65 73 28 6c  s} [split $res(l
1350: 61 73 74 76 61 6c 29 20 2e 5d 20 62 72 65 61 6b  astval) .] break
1360: 0a 20 20 20 20 69 66 20 7b 24 79 72 20 3c 20 31  .    if {$yr < 1
1370: 30 30 7d 20 7b 69 6e 63 72 20 79 72 20 31 39 30  00} {incr yr 190
1380: 30 7d 0a 20 20 20 20 73 65 74 20 72 65 73 28 6c  0}.    set res(l
1390: 61 73 74 76 61 6c 29 20 5b 6a 6f 69 6e 20 5b 6c  astval) [join [l
13a0: 69 73 74 20 24 79 72 20 24 6d 6f 20 24 64 79 20  ist $yr $mo $dy 
13b0: 24 68 20 24 6d 20 24 73 5d 20 2e 5d 0a 20 20 20  $h $m $s] .].   
13c0: 20 4d 61 70 20 64 61 74 65 0a 20 20 20 20 72 65   Map date.    re
13d0: 74 75 72 6e 0a 7d 0a 0a 70 72 6f 63 20 3a 3a 76  turn.}..proc ::v
13e0: 63 3a 3a 72 63 73 3a 3a 70 61 72 73 65 72 3a 3a  c::rcs::parser::
13f0: 41 75 74 68 6f 72 20 7b 7d 20 7b 0a 20 20 20 20  Author {} {.    
1400: 75 70 76 61 72 20 31 20 64 61 74 61 20 64 61 74  upvar 1 data dat
1410: 61 20 72 65 73 20 72 65 73 0a 20 20 20 20 4c 69  a res res.    Li
1420: 74 65 72 61 6c 20 61 75 74 68 6f 72 20 3b 20 53  teral author ; S
1430: 6b 69 70 20 3b 20 4c 69 74 65 72 61 6c 20 5c 3b  kip ; Literal \;
1440: 20 3b 20 4d 61 70 20 61 75 74 68 6f 72 0a 20 20   ; Map author.  
1450: 20 20 72 65 74 75 72 6e 0a 7d 0a 0a 70 72 6f 63    return.}..proc
1460: 20 3a 3a 76 63 3a 3a 72 63 73 3a 3a 70 61 72 73   ::vc::rcs::pars
1470: 65 72 3a 3a 53 74 61 74 65 20 7b 7d 20 7b 0a 20  er::State {} {. 
1480: 20 20 20 75 70 76 61 72 20 31 20 64 61 74 61 20     upvar 1 data 
1490: 64 61 74 61 20 72 65 73 20 72 65 73 0a 20 20 20  data res res.   
14a0: 20 4c 69 74 65 72 61 6c 20 73 74 61 74 65 20 3b   Literal state ;
14b0: 20 53 6b 69 70 20 3b 20 4c 69 74 65 72 61 6c 20   Skip ; Literal 
14c0: 5c 3b 20 3b 20 4d 61 70 20 73 74 61 74 65 0a 20  \; ; Map state. 
14d0: 20 20 20 72 65 74 75 72 6e 0a 7d 0a 0a 70 72 6f     return.}..pro
14e0: 63 20 3a 3a 76 63 3a 3a 72 63 73 3a 3a 70 61 72  c ::vc::rcs::par
14f0: 73 65 72 3a 3a 42 72 61 6e 63 68 65 73 20 7b 7d  ser::Branches {}
1500: 20 7b 0a 20 20 20 20 75 70 76 61 72 20 31 20 64   {.    upvar 1 d
1510: 61 74 61 20 64 61 74 61 20 72 65 73 20 72 65 73  ata data res res
1520: 0a 20 20 20 20 4c 69 74 65 72 61 6c 20 62 72 61  .    Literal bra
1530: 6e 63 68 65 73 20 3b 20 53 6b 69 70 20 3b 20 4c  nches ; Skip ; L
1540: 69 74 65 72 61 6c 20 5c 3b 0a 20 20 20 20 72 65  iteral \;.    re
1550: 74 75 72 6e 0a 7d 0a 0a 70 72 6f 63 20 3a 3a 76  turn.}..proc ::v
1560: 63 3a 3a 72 63 73 3a 3a 70 61 72 73 65 72 3a 3a  c::rcs::parser::
1570: 4e 65 78 74 52 65 76 20 7b 7d 20 7b 0a 20 20 20  NextRev {} {.   
1580: 20 75 70 76 61 72 20 31 20 64 61 74 61 20 64 61   upvar 1 data da
1590: 74 61 20 72 65 73 20 72 65 73 0a 20 20 20 20 4c  ta res res.    L
15a0: 69 74 65 72 61 6c 20 6e 65 78 74 20 3b 20 53 6b  iteral next ; Sk
15b0: 69 70 20 3b 20 4c 69 74 65 72 61 6c 20 5c 3b 20  ip ; Literal \; 
15c0: 3b 20 4d 61 70 20 70 61 72 65 6e 74 0a 20 20 20  ; Map parent.   
15d0: 20 72 65 74 75 72 6e 0a 7d 0a 0a 70 72 6f 63 20   return.}..proc 
15e0: 3a 3a 76 63 3a 3a 72 63 73 3a 3a 70 61 72 73 65  ::vc::rcs::parse
15f0: 72 3a 3a 4c 6f 67 20 7b 7d 20 7b 0a 20 20 20 20  r::Log {} {.    
1600: 75 70 76 61 72 20 31 20 64 61 74 61 20 64 61 74  upvar 1 data dat
1610: 61 20 72 65 73 20 72 65 73 0a 20 20 20 20 4c 69  a res res.    Li
1620: 74 65 72 61 6c 20 6c 6f 67 20 3b 20 53 74 72 69  teral log ; Stri
1630: 6e 67 20 31 20 3b 20 4d 61 70 20 63 6f 6d 6d 69  ng 1 ; Map commi
1640: 74 0a 20 20 20 20 72 65 74 75 72 6e 0a 7d 0a 0a  t.    return.}..
1650: 70 72 6f 63 20 3a 3a 76 63 3a 3a 72 63 73 3a 3a  proc ::vc::rcs::
1660: 70 61 72 73 65 72 3a 3a 54 65 78 74 20 7b 7d 20  parser::Text {} 
1670: 7b 0a 20 20 20 20 75 70 76 61 72 20 31 20 64 61  {.    upvar 1 da
1680: 74 61 20 64 61 74 61 20 72 65 73 20 72 65 73 0a  ta data res res.
1690: 20 20 20 20 4c 69 74 65 72 61 6c 20 74 65 78 74      Literal text
16a0: 20 3b 20 53 74 72 69 6e 67 20 31 0a 20 20 20 20   ; String 1.    
16b0: 72 65 74 75 72 6e 0a 7d 0a 0a 23 20 2d 2d 2d 2d  return.}..# ----
16c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
16d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
16e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
16f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
1700: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 20 49 6e 74 65  ---------.# Inte
1710: 72 6e 61 6c 20 2d 20 4c 65 78 69 63 6f 67 72 61  rnal - Lexicogra
1720: 70 68 69 63 61 6c 20 63 6f 6d 6d 61 6e 64 73 20  phical commands 
1730: 61 6e 64 20 64 61 74 61 20 61 71 75 69 73 69 74  and data aquisit
1740: 69 6f 6e 20 70 72 65 70 61 72 61 74 69 6f 6e 0a  ion preparation.
1750: 0a 70 72 6f 63 20 3a 3a 76 63 3a 3a 72 63 73 3a  .proc ::vc::rcs:
1760: 3a 70 61 72 73 65 72 3a 3a 49 64 65 6e 74 20 7b  :parser::Ident {
1770: 7d 20 7b 0a 20 20 20 20 75 70 76 61 72 20 31 20  } {.    upvar 1 
1780: 64 61 74 61 20 64 61 74 61 20 72 65 73 20 72 65  data data res re
1790: 73 0a 0a 20 20 20 20 23 70 75 74 73 20 49 40 3f  s..    #puts I@?
17a0: 3c 5b 73 74 72 69 6e 67 20 72 61 6e 67 65 20 24  <[string range $
17b0: 64 61 74 61 20 30 20 31 30 5d 2e 2e 2e 3e 0a 0a  data 0 10]...>..
17c0: 20 20 20 20 69 66 20 7b 5b 72 65 67 65 78 70 20      if {[regexp 
17d0: 2d 69 6e 64 69 63 65 73 20 2d 2d 20 7b 5e 5c 73  -indices -- {^\s
17e0: 2a 3b 5c 73 2a 7d 20 24 64 61 74 61 5d 7d 20 7b  *;\s*} $data]} {
17f0: 0a 09 72 65 74 75 72 6e 20 30 0a 20 20 20 20 7d  ..return 0.    }
1800: 20 65 6c 73 65 69 66 20 7b 21 5b 72 65 67 65 78   elseif {![regex
1810: 70 20 2d 69 6e 64 69 63 65 73 20 2d 2d 20 7b 5e  p -indices -- {^
1820: 5c 73 2a 28 5b 5e 3a 5d 2a 29 5c 73 2a 3a 5c 73  \s*([^:]*)\s*:\s
1830: 2a 7d 20 24 64 61 74 61 20 6d 61 74 63 68 20 76  *} $data match v
1840: 61 6c 5d 7d 20 7b 0a 09 72 65 74 75 72 6e 20 30  al]} {..return 0
1850: 0a 20 20 20 20 7d 0a 0a 20 20 20 20 47 65 74 20  .    }..    Get 
1860: 24 76 61 6c 20 3b 20 49 73 49 64 65 6e 74 0a 20  $val ; IsIdent. 
1870: 20 20 20 4e 65 78 74 0a 20 20 20 20 72 65 74 75     Next.    retu
1880: 72 6e 20 31 0a 7d 0a 0a 70 72 6f 63 20 3a 3a 76  rn 1.}..proc ::v
1890: 63 3a 3a 72 63 73 3a 3a 70 61 72 73 65 72 3a 3a  c::rcs::parser::
18a0: 4c 69 74 65 72 61 6c 20 7b 6e 61 6d 65 20 7b 72  Literal {name {r
18b0: 65 71 75 69 72 65 64 20 31 7d 7d 20 7b 0a 20 20  equired 1}} {.  
18c0: 20 20 75 70 76 61 72 20 31 20 64 61 74 61 20 64    upvar 1 data d
18d0: 61 74 61 20 72 65 73 20 72 65 73 0a 20 20 20 20  ata res res.    
18e0: 69 66 20 7b 21 5b 72 65 67 65 78 70 20 2d 69 6e  if {![regexp -in
18f0: 64 69 63 65 73 20 2d 2d 20 22 5e 5c 5c 73 2a 24  dices -- "^\\s*$
1900: 6e 61 6d 65 5c 5c 73 2a 22 20 24 64 61 74 61 20  name\\s*" $data 
1910: 6d 61 74 63 68 5d 7d 20 7b 0a 09 69 66 20 7b 24  match]} {..if {$
1920: 72 65 71 75 69 72 65 64 7d 20 7b 0a 09 20 20 20  required} {..   
1930: 20 72 65 74 75 72 6e 20 2d 63 6f 64 65 20 65 72   return -code er
1940: 72 6f 72 20 22 45 78 70 65 63 74 65 64 20 27 24  ror "Expected '$
1950: 6e 61 6d 65 27 20 40 20 27 5b 73 74 72 69 6e 67  name' @ '[string
1960: 20 72 61 6e 67 65 20 24 64 61 74 61 20 30 20 33   range $data 0 3
1970: 30 5d 2e 2e 2e 27 22 0a 09 7d 0a 09 72 65 74 75  0]...'"..}..retu
1980: 72 6e 20 30 0a 20 20 20 20 7d 0a 0a 20 20 20 20  rn 0.    }..    
1990: 4e 65 78 74 0a 20 20 20 20 72 65 74 75 72 6e 20  Next.    return 
19a0: 31 0a 7d 0a 0a 70 72 6f 63 20 3a 3a 76 63 3a 3a  1.}..proc ::vc::
19b0: 72 63 73 3a 3a 70 61 72 73 65 72 3a 3a 53 74 72  rcs::parser::Str
19c0: 69 6e 67 20 7b 7b 72 65 71 75 69 72 65 64 20 31  ing {{required 1
19d0: 7d 7d 20 7b 0a 20 20 20 20 75 70 76 61 72 20 31  }} {.    upvar 1
19e0: 20 64 61 74 61 20 64 61 74 61 20 72 65 73 20 72   data data res r
19f0: 65 73 0a 0a 20 20 20 20 69 66 20 7b 21 5b 72 65  es..    if {![re
1a00: 67 65 78 70 20 2d 69 6e 64 69 63 65 73 20 2d 2d  gexp -indices --
1a10: 20 7b 5e 5c 73 2a 40 28 28 5b 5e 40 5d 2a 28 40   {^\s*@(([^@]*(@
1a20: 40 29 2a 29 2a 29 40 5c 73 2a 7d 20 24 64 61 74  @)*)*)@\s*} $dat
1a30: 61 20 6d 61 74 63 68 20 76 61 6c 5d 7d 20 7b 0a  a match val]} {.
1a40: 09 69 66 20 7b 24 72 65 71 75 69 72 65 64 7d 20  .if {$required} 
1a50: 7b 0a 09 20 20 20 20 72 65 74 75 72 6e 20 2d 63  {..    return -c
1a60: 6f 64 65 20 65 72 72 6f 72 20 22 45 78 70 65 63  ode error "Expec
1a70: 74 65 64 20 73 74 72 69 6e 67 20 40 20 27 5b 73  ted string @ '[s
1a80: 74 72 69 6e 67 20 72 61 6e 67 65 20 24 64 61 74  tring range $dat
1a90: 61 20 30 20 33 30 5d 2e 2e 2e 27 22 0a 09 7d 0a  a 0 30]...'"..}.
1aa0: 09 72 65 74 75 72 6e 20 30 0a 20 20 20 20 7d 0a  .return 0.    }.
1ab0: 0a 20 20 20 20 47 65 74 20 24 76 61 6c 0a 20 20  .    Get $val.  
1ac0: 20 20 4e 65 78 74 0a 20 20 20 20 72 65 74 75 72    Next.    retur
1ad0: 6e 20 31 0a 7d 0a 0a 70 72 6f 63 20 3a 3a 76 63  n 1.}..proc ::vc
1ae0: 3a 3a 72 63 73 3a 3a 70 61 72 73 65 72 3a 3a 4e  ::rcs::parser::N
1af0: 75 6d 20 7b 72 65 71 75 69 72 65 64 7d 20 7b 0a  um {required} {.
1b00: 20 20 20 20 75 70 76 61 72 20 31 20 64 61 74 61      upvar 1 data
1b10: 20 64 61 74 61 20 72 65 73 20 72 65 73 0a 20 20   data res res.  
1b20: 20 20 69 66 20 7b 21 5b 72 65 67 65 78 70 20 2d    if {![regexp -
1b30: 69 6e 64 69 63 65 73 20 2d 2d 20 7b 5e 5c 73 2a  indices -- {^\s*
1b40: 28 28 5c 64 7c 5c 2e 29 2b 29 5c 73 2a 7d 20 24  ((\d|\.)+)\s*} $
1b50: 64 61 74 61 20 6d 61 74 63 68 20 76 61 6c 5d 7d  data match val]}
1b60: 20 7b 0a 09 69 66 20 7b 24 72 65 71 75 69 72 65   {..if {$require
1b70: 64 7d 20 7b 0a 09 20 20 20 20 72 65 74 75 72 6e  d} {..    return
1b80: 20 2d 63 6f 64 65 20 65 72 72 6f 72 20 22 45 78   -code error "Ex
1b90: 70 65 63 74 65 64 20 69 64 20 40 20 27 5b 73 74  pected id @ '[st
1ba0: 72 69 6e 67 20 72 61 6e 67 65 20 24 64 61 74 61  ring range $data
1bb0: 20 30 20 33 30 5d 2e 2e 2e 27 22 0a 09 7d 0a 09   0 30]...'"..}..
1bc0: 72 65 74 75 72 6e 20 30 0a 20 20 20 20 7d 0a 0a  return 0.    }..
1bd0: 20 20 20 20 47 65 74 20 24 76 61 6c 0a 20 20 20      Get $val.   
1be0: 20 4e 65 78 74 0a 20 20 20 20 72 65 74 75 72 6e   Next.    return
1bf0: 20 31 0a 7d 0a 0a 70 72 6f 63 20 3a 3a 76 63 3a   1.}..proc ::vc:
1c00: 3a 72 63 73 3a 3a 70 61 72 73 65 72 3a 3a 53 6b  :rcs::parser::Sk
1c10: 69 70 20 7b 7d 20 7b 0a 20 20 20 20 75 70 76 61  ip {} {.    upva
1c20: 72 20 31 20 64 61 74 61 20 64 61 74 61 20 72 65  r 1 data data re
1c30: 73 20 72 65 73 0a 20 20 20 20 72 65 67 65 78 70  s res.    regexp
1c40: 20 2d 69 6e 64 69 63 65 73 20 2d 2d 20 7b 5e 5c   -indices -- {^\
1c50: 73 2a 28 5b 5e 3b 5d 2a 29 5c 73 2a 7d 20 24 64  s*([^;]*)\s*} $d
1c60: 61 74 61 20 6d 61 74 63 68 20 76 61 6c 0a 20 20  ata match val.  
1c70: 20 20 47 65 74 20 24 76 61 6c 0a 20 20 20 20 4e    Get $val.    N
1c80: 65 78 74 0a 20 20 20 20 72 65 74 75 72 6e 0a 7d  ext.    return.}
1c90: 0a 0a 23 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ..# ------------
1ca0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
1cb0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
1cc0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
1cd0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
1ce0: 2d 0a 23 20 49 6e 74 65 72 6e 61 6c 20 2d 20 44  -.# Internal - D
1cf0: 61 74 61 20 61 71 75 69 73 69 74 69 6f 6e 0a 0a  ata aquisition..
1d00: 70 72 6f 63 20 3a 3a 76 63 3a 3a 72 63 73 3a 3a  proc ::vc::rcs::
1d10: 70 61 72 73 65 72 3a 3a 44 65 66 20 7b 6b 65 79  parser::Def {key
1d20: 7d 20 7b 0a 20 20 20 20 75 70 76 61 72 20 31 20  } {.    upvar 1 
1d30: 64 61 74 61 20 64 61 74 61 20 72 65 73 20 72 65  data data res re
1d40: 73 0a 20 20 20 20 73 65 74 20 72 65 73 28 24 6b  s.    set res($k
1d50: 65 79 29 20 24 72 65 73 28 6c 61 73 74 76 61 6c  ey) $res(lastval
1d60: 29 0a 20 20 20 20 75 6e 73 65 74 20 72 65 73 28  ).    unset res(
1d70: 6c 61 73 74 76 61 6c 29 0a 20 20 20 20 72 65 74  lastval).    ret
1d80: 75 72 6e 0a 7d 0a 0a 70 72 6f 63 20 3a 3a 76 63  urn.}..proc ::vc
1d90: 3a 3a 72 63 73 3a 3a 70 61 72 73 65 72 3a 3a 4d  ::rcs::parser::M
1da0: 61 70 20 7b 6b 65 79 7d 20 7b 0a 20 20 20 20 75  ap {key} {.    u
1db0: 70 76 61 72 20 31 20 64 61 74 61 20 64 61 74 61  pvar 1 data data
1dc0: 20 72 65 73 20 72 65 73 0a 20 20 20 20 6c 61 70   res res.    lap
1dd0: 70 65 6e 64 20 72 65 73 28 24 6b 65 79 29 20 24  pend res($key) $
1de0: 72 65 73 28 69 64 29 20 24 72 65 73 28 6c 61 73  res(id) $res(las
1df0: 74 76 61 6c 29 0a 20 20 20 20 23 70 75 74 73 20  tval).    #puts 
1e00: 4d 61 70 28 24 72 65 73 28 69 64 29 29 3d 28 24  Map($res(id))=($
1e10: 72 65 73 28 6c 61 73 74 76 61 6c 29 29 0a 20 20  res(lastval)).  
1e20: 20 20 75 6e 73 65 74 20 72 65 73 28 6c 61 73 74    unset res(last
1e30: 76 61 6c 29 0a 20 20 20 20 23 75 6e 73 65 74 20  val).    #unset 
1e40: 72 65 73 28 69 64 29 3b 23 4b 65 65 70 20 69 64  res(id);#Keep id
1e50: 20 66 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c 20   for additional 
1e60: 6d 61 70 70 69 6e 67 73 2e 0a 20 20 20 20 72 65  mappings..    re
1e70: 74 75 72 6e 0a 7d 0a 0a 70 72 6f 63 20 3a 3a 76  turn.}..proc ::v
1e80: 63 3a 3a 72 63 73 3a 3a 70 61 72 73 65 72 3a 3a  c::rcs::parser::
1e90: 49 73 49 64 65 6e 74 20 7b 7d 20 7b 0a 20 20 20  IsIdent {} {.   
1ea0: 20 75 70 76 61 72 20 31 20 64 61 74 61 20 64 61   upvar 1 data da
1eb0: 74 61 20 72 65 73 20 72 65 73 0a 20 20 20 20 73  ta res res.    s
1ec0: 65 74 20 72 65 73 28 69 64 29 20 24 72 65 73 28  et res(id) $res(
1ed0: 6c 61 73 74 76 61 6c 29 0a 20 20 20 20 75 6e 73  lastval).    uns
1ee0: 65 74 20 72 65 73 28 6c 61 73 74 76 61 6c 29 0a  et res(lastval).
1ef0: 20 20 20 20 72 65 74 75 72 6e 0a 7d 0a 0a 70 72      return.}..pr
1f00: 6f 63 20 3a 3a 76 63 3a 3a 72 63 73 3a 3a 70 61  oc ::vc::rcs::pa
1f10: 72 73 65 72 3a 3a 47 65 74 20 7b 76 61 6c 7d 20  rser::Get {val} 
1f20: 7b 0a 20 20 20 20 75 70 76 61 72 20 31 20 64 61  {.    upvar 1 da
1f30: 74 61 20 64 61 74 61 20 72 65 73 20 72 65 73 0a  ta data res res.
1f40: 20 20 20 20 66 6f 72 65 61 63 68 20 7b 73 20 65      foreach {s e
1f50: 7d 20 24 76 61 6c 20 62 72 65 61 6b 0a 20 20 20  } $val break.   
1f60: 20 73 65 74 20 72 65 73 28 6c 61 73 74 76 61 6c   set res(lastval
1f70: 29 20 5b 73 74 72 69 6e 67 20 72 61 6e 67 65 20  ) [string range 
1f80: 24 64 61 74 61 20 24 73 20 24 65 5d 0a 20 20 20  $data $s $e].   
1f90: 20 23 70 75 74 73 20 47 7c 24 72 65 73 28 6c 61   #puts G|$res(la
1fa0: 73 74 76 61 6c 29 0a 20 20 20 20 72 65 74 75 72  stval).    retur
1fb0: 6e 0a 7d 0a 0a 70 72 6f 63 20 3a 3a 76 63 3a 3a  n.}..proc ::vc::
1fc0: 72 63 73 3a 3a 70 61 72 73 65 72 3a 3a 4e 65 78  rcs::parser::Nex
1fd0: 74 20 7b 7d 20 7b 0a 20 20 20 20 75 70 76 61 72  t {} {.    upvar
1fe0: 20 31 20 6d 61 74 63 68 20 6d 61 74 63 68 20 64   1 match match d
1ff0: 61 74 61 20 64 61 74 61 20 72 65 73 20 72 65 73  ata data res res
2000: 0a 20 20 20 20 66 6f 72 65 61 63 68 20 7b 73 20  .    foreach {s 
2010: 65 7d 20 24 6d 61 74 63 68 20 62 72 65 61 6b 20  e} $match break 
2020: 3b 20 69 6e 63 72 20 65 0a 20 20 20 20 73 65 74  ; incr e.    set
2030: 20 64 61 74 61 20 5b 73 74 72 69 6e 67 20 72 61   data [string ra
2040: 6e 67 65 20 24 64 61 74 61 20 24 65 20 65 6e 64  nge $data $e end
2050: 5d 0a 20 20 20 20 73 65 74 20 72 65 73 28 64 6f  ].    set res(do
2060: 6e 65 29 20 5b 65 78 70 72 20 7b 24 72 65 73 28  ne) [expr {$res(
2070: 73 69 7a 65 29 20 2d 20 5b 73 74 72 69 6e 67 20  size) - [string 
2080: 6c 65 6e 67 74 68 20 24 64 61 74 61 5d 7d 5d 0a  length $data]}].
2090: 0a 20 20 20 20 70 72 6f 67 72 65 73 73 20 32 20  .    progress 2 
20a0: 72 63 73 20 24 72 65 73 28 64 6f 6e 65 29 20 24  rcs $res(done) $
20b0: 72 65 73 28 73 69 7a 65 29 0a 20 20 20 20 72 65  res(size).    re
20c0: 74 75 72 6e 0a 7d 0a 0a 23 20 2d 2d 2d 2d 2d 2d  turn.}..# ------
20d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
20e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
20f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
2100: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
2110: 2d 2d 2d 2d 2d 2d 2d 0a 0a 6e 61 6d 65 73 70 61  -------..namespa
2120: 63 65 20 65 76 61 6c 20 3a 3a 76 63 3a 3a 72 63  ce eval ::vc::rc
2130: 73 3a 3a 70 61 72 73 65 72 20 7b 0a 20 20 20 20  s::parser {.    
2140: 76 61 72 69 61 62 6c 65 20 63 61 63 68 65 20 30  variable cache 0
2150: 20 3b 20 23 20 4e 6f 20 72 65 73 75 6c 74 20 63   ; # No result c
2160: 61 63 68 69 6e 67 20 62 79 20 64 65 66 61 75 6c  aching by defaul
2170: 74 2e 0a 0a 20 20 20 20 6e 61 6d 65 73 70 61 63  t...    namespac
2180: 65 20 65 78 70 6f 72 74 20 70 72 6f 63 65 73 73  e export process
2190: 20 63 6f 6e 66 69 67 75 72 65 0a 7d 0a 0a 23 20   configure.}..# 
21a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
21b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
21c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
21d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
21e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 20  -------------.# 
21f0: 52 65 61 64 79 0a 0a 70 61 63 6b 61 67 65 20 70  Ready..package p
2200: 72 6f 76 69 64 65 20 76 63 3a 3a 72 63 73 3a 3a  rovide vc::rcs::
2210: 70 61 72 73 65 72 20 31 2e 30 0a 72 65 74 75 72  parser 1.0.retur
2220: 6e 0a                                            n.