Hex Artifact Content
Not logged in

Artifact b7e70320c9a8e0a58d93506bd614d333c8ef311e:

File tools/cvs2fossil/lib/rcsparser.tcl part of check-in [294156a36f] - Extended the RCS parser to handle extended (aka new) phrases coming after the regular data of a revision, in the revision tree. by aku on 2007-10-19 07:22:44.

0000: 23 23 20 2d 2a 2d 20 74 63 6c 20 2d 2a 2d 0a 23  ## -*- tcl -*-.#
0010: 20 23 20 23 23 20 23 23 23 20 23 23 23 23 23 20   # ## ### ##### 
0020: 23 23 23 23 23 23 23 23 20 23 23 23 23 23 23 23  ######## #######
0030: 23 23 23 23 23 23 20 23 23 23 23 23 23 23 23 23  ###### #########
0040: 23 23 23 23 23 23 23 23 23 23 23 23 0a 23 23 20  ############.## 
0050: 43 6f 70 79 72 69 67 68 74 20 28 63 29 20 32 30  Copyright (c) 20
0060: 30 37 20 41 6e 64 72 65 61 73 20 4b 75 70 72 69  07 Andreas Kupri
0070: 65 73 2e 0a 23 0a 23 20 54 68 69 73 20 73 6f 66  es..#.# This sof
0080: 74 77 61 72 65 20 69 73 20 6c 69 63 65 6e 73 65  tware is license
0090: 64 20 61 73 20 64 65 73 63 72 69 62 65 64 20 69  d as described i
00a0: 6e 20 74 68 65 20 66 69 6c 65 20 4c 49 43 45 4e  n the file LICEN
00b0: 53 45 2c 20 77 68 69 63 68 0a 23 20 79 6f 75 20  SE, which.# you 
00c0: 73 68 6f 75 6c 64 20 68 61 76 65 20 72 65 63 65  should have rece
00d0: 69 76 65 64 20 61 73 20 70 61 72 74 20 6f 66 20  ived as part of 
00e0: 74 68 69 73 20 64 69 73 74 72 69 62 75 74 69 6f  this distributio
00f0: 6e 2e 0a 23 0a 23 20 54 68 69 73 20 73 6f 66 74  n..#.# This soft
0100: 77 61 72 65 20 63 6f 6e 73 69 73 74 73 20 6f 66  ware consists of
0110: 20 76 6f 6c 75 6e 74 61 72 79 20 63 6f 6e 74 72   voluntary contr
0120: 69 62 75 74 69 6f 6e 73 20 6d 61 64 65 20 62 79  ibutions made by
0130: 20 6d 61 6e 79 0a 23 20 69 6e 64 69 76 69 64 75   many.# individu
0140: 61 6c 73 2e 20 20 46 6f 72 20 65 78 61 63 74 20  als.  For exact 
0150: 63 6f 6e 74 72 69 62 75 74 69 6f 6e 20 68 69 73  contribution his
0160: 74 6f 72 79 2c 20 73 65 65 20 74 68 65 20 72 65  tory, see the re
0170: 76 69 73 69 6f 6e 0a 23 20 68 69 73 74 6f 72 79  vision.# history
0180: 20 61 6e 64 20 6c 6f 67 73 2c 20 61 76 61 69 6c   and logs, avail
0190: 61 62 6c 65 20 61 74 20 68 74 74 70 3a 2f 2f 66  able at http://f
01a0: 6f 73 73 69 6c 2d 73 63 6d 2e 68 77 61 63 69 2e  ossil-scm.hwaci.
01b0: 63 6f 6d 2f 66 6f 73 73 69 6c 0a 23 20 23 20 23  com/fossil.# # #
01c0: 23 20 23 23 23 20 23 23 23 23 23 20 23 23 23 23  # ### ##### ####
01d0: 23 23 23 23 20 23 23 23 23 23 23 23 23 23 23 23  #### ###########
01e0: 23 23 20 23 23 23 23 23 23 23 23 23 23 23 23 23  ## #############
01f0: 23 23 23 23 23 23 23 23 0a 0a 23 20 41 20 74 6f  ########..# A to
0200: 6f 6c 20 70 61 63 6b 61 67 65 2c 20 70 72 6f 76  ol package, prov
0210: 69 64 65 73 20 61 20 70 61 72 73 65 72 20 66 6f  ides a parser fo
0220: 72 20 52 43 53 20 61 72 63 68 69 76 65 20 66 69  r RCS archive fi
0230: 6c 65 73 2e 20 54 68 69 73 20 70 61 72 73 65 72  les. This parser
0240: 0a 23 20 69 73 20 69 6d 70 6c 65 6d 65 6e 74 65  .# is implemente
0250: 64 20 76 69 61 20 72 65 63 75 72 73 69 76 65 20  d via recursive 
0260: 64 65 73 63 65 6e 74 2e 20 49 74 20 69 73 20 6e  descent. It is n
0270: 6f 74 20 6f 6e 6c 79 20 67 69 76 65 6e 20 61 20  ot only given a 
0280: 66 69 6c 65 20 74 6f 0a 23 20 70 72 6f 63 65 73  file to.# proces
0290: 73 2c 20 62 75 74 20 61 6c 73 6f 20 61 20 27 73  s, but also a 's
02a0: 69 6e 6b 27 2c 20 61 6e 20 6f 62 6a 65 63 74 20  ink', an object 
02b0: 69 74 20 63 61 6c 6c 73 20 6f 75 74 20 74 6f 20  it calls out to 
02c0: 61 74 20 69 6d 70 6f 72 74 61 6e 74 0a 23 20 70  at important.# p
02d0: 6c 61 63 65 73 20 6f 66 20 74 68 65 20 70 61 72  laces of the par
02e0: 73 69 6e 67 20 70 72 6f 63 65 73 73 20 74 6f 20  sing process to 
02f0: 65 69 74 68 65 72 20 73 69 67 6e 61 6c 20 61 6e  either signal an
0300: 20 65 76 65 6e 74 20 61 6e 64 2f 6f 72 0a 23 20   event and/or.# 
0310: 63 6f 6e 76 65 79 20 67 61 74 68 65 72 65 64 20  convey gathered 
0320: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 74 6f 20 69  information to i
0330: 74 2e 20 54 68 65 20 73 69 6e 6b 20 69 73 20 72  t. The sink is r
0340: 65 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 20 74  esponsible for t
0350: 68 65 0a 23 20 61 63 74 75 61 6c 20 70 72 6f 63  he.# actual proc
0360: 65 73 73 69 6e 67 20 6f 66 20 74 68 65 20 64 61  essing of the da
0370: 74 61 20 69 6e 20 77 68 61 74 65 76 65 72 20 77  ta in whatever w
0380: 61 79 20 69 74 20 64 65 73 69 72 65 73 2e 0a 0a  ay it desires...
0390: 23 20 23 20 23 23 20 23 23 23 20 23 23 23 23 23  # # ## ### #####
03a0: 20 23 23 23 23 23 23 23 23 20 23 23 23 23 23 23   ######## ######
03b0: 23 23 23 23 23 23 23 20 23 23 23 23 23 23 23 23  ####### ########
03c0: 23 23 23 23 23 23 23 23 23 23 23 23 23 0a 23 23  #############.##
03d0: 20 52 65 71 75 69 72 65 6d 65 6e 74 73 0a 0a 70   Requirements..p
03e0: 61 63 6b 61 67 65 20 72 65 71 75 69 72 65 20 54  ackage require T
03f0: 63 6c 20 38 2e 34 20 20 20 20 20 20 20 20 20 20  cl 8.4          
0400: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0410: 20 20 20 3b 20 23 20 52 65 71 75 69 72 65 64 20     ; # Required 
0420: 72 75 6e 74 69 6d 65 2e 0a 70 61 63 6b 61 67 65  runtime..package
0430: 20 72 65 71 75 69 72 65 20 73 6e 69 74 20 20 20   require snit   
0440: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0450: 20 20 20 20 20 20 20 20 20 20 20 20 20 3b 20 23               ; #
0460: 20 4f 4f 20 73 79 73 74 65 6d 2e 0a 70 61 63 6b   OO system..pack
0470: 61 67 65 20 72 65 71 75 69 72 65 20 66 69 6c 65  age require file
0480: 75 74 69 6c 20 20 20 20 20 20 20 20 20 20 20 20  util            
0490: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
04a0: 3b 20 23 20 46 69 6c 65 20 75 74 69 6c 69 74 69  ; # File utiliti
04b0: 65 73 2e 0a 70 61 63 6b 61 67 65 20 72 65 71 75  es..package requ
04c0: 69 72 65 20 76 63 3a 3a 74 6f 6f 6c 73 3a 3a 6c  ire vc::tools::l
04d0: 6f 67 20 20 20 20 20 20 20 20 20 20 20 20 20 20  og              
04e0: 20 20 20 20 20 20 20 20 3b 20 23 20 55 73 65 72          ; # User
04f0: 20 66 65 65 64 62 61 63 6b 2e 0a 70 61 63 6b 61   feedback..packa
0500: 67 65 20 72 65 71 75 69 72 65 20 73 74 72 75 63  ge require struc
0510: 74 3a 3a 6c 69 73 74 20 20 20 20 20 20 20 20 20  t::list         
0520: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3b                 ;
0530: 20 23 20 41 64 76 61 6e 63 65 64 20 6c 69 73 74   # Advanced list
0540: 20 6f 70 73 2e 0a 0a 23 20 23 20 23 23 20 23 23   ops...# # ## ##
0550: 23 20 23 23 23 23 23 20 23 23 23 23 23 23 23 23  # ##### ########
0560: 20 23 23 23 23 23 23 23 23 23 23 23 23 23 20 23   ############# #
0570: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0580: 23 23 23 23 0a 23 23 20 0a 0a 73 6e 69 74 3a 3a  ####.## ..snit::
0590: 74 79 70 65 20 3a 3a 76 63 3a 3a 72 63 73 3a 3a  type ::vc::rcs::
05a0: 70 61 72 73 65 72 20 7b 0a 20 20 20 20 23 20 23  parser {.    # #
05b0: 20 23 23 20 23 23 23 20 23 23 23 23 23 20 23 23   ## ### ##### ##
05c0: 23 23 23 23 23 23 20 23 23 23 23 23 23 23 23 23  ###### #########
05d0: 23 23 23 23 0a 20 20 20 20 23 23 20 50 75 62 6c  ####.    ## Publ
05e0: 69 63 20 41 50 49 0a 0a 20 20 20 20 74 79 70 65  ic API..    type
05f0: 6d 65 74 68 6f 64 20 70 72 6f 63 65 73 73 20 7b  method process {
0600: 70 61 74 68 20 73 69 6e 6b 7d 20 7b 0a 09 49 6e  path sink} {..In
0610: 69 74 69 61 6c 69 7a 65 20 24 70 61 74 68 20 24  itialize $path $
0620: 73 69 6e 6b 0a 09 43 61 6c 6c 20 62 65 67 69 6e  sink..Call begin
0630: 0a 09 41 64 6d 69 6e 20 3b 20 44 65 6c 74 61 73  ..Admin ; Deltas
0640: 20 3b 20 44 65 73 63 72 69 70 74 69 6f 6e 20 3b   ; Description ;
0650: 20 44 65 6c 74 61 54 65 78 74 73 0a 09 43 61 6c   DeltaTexts..Cal
0660: 6c 20 64 6f 6e 65 0a 09 72 65 74 75 72 6e 0a 20  l done..return. 
0670: 20 20 20 7d 0a 0a 20 20 20 20 23 20 23 20 23 23     }..    # # ##
0680: 20 23 23 23 20 23 23 23 23 23 20 23 23 23 23 23   ### ##### #####
0690: 23 23 23 20 23 23 23 23 23 23 23 23 23 23 23 23  ### ############
06a0: 23 0a 20 20 20 20 23 23 20 49 6e 74 65 72 6e 61  #.    ## Interna
06b0: 6c 20 6d 65 74 68 6f 64 73 2c 20 72 65 63 75 72  l methods, recur
06c0: 73 69 76 65 20 64 65 73 63 65 6e 74 2c 20 73 79  sive descent, sy
06d0: 6e 74 61 63 74 69 63 61 6c 20 70 72 6f 63 65 73  ntactical proces
06e0: 73 69 6e 67 0a 0a 20 20 20 20 70 72 6f 63 20 41  sing..    proc A
06f0: 64 6d 69 6e 20 7b 7d 20 7b 0a 09 48 65 61 64 20  dmin {} {..Head 
0700: 3b 20 50 72 69 6e 63 69 70 61 6c 42 72 61 6e 63  ; PrincipalBranc
0710: 68 20 3b 20 41 63 63 65 73 73 20 3b 20 53 79 6d  h ; Access ; Sym
0720: 62 6f 6c 73 0a 09 4c 6f 63 6b 73 20 3b 20 53 74  bols..Locks ; St
0730: 72 69 63 74 6e 65 73 73 20 3b 20 46 69 6c 65 43  rictness ; FileC
0740: 6f 6d 6d 65 6e 74 20 3b 20 45 78 70 61 6e 64 0a  omment ; Expand.
0750: 09 43 61 6c 6c 20 61 64 6d 69 6e 64 6f 6e 65 0a  .Call admindone.
0760: 09 72 65 74 75 72 6e 0a 20 20 20 20 7d 0a 0a 20  .return.    }.. 
0770: 20 20 20 23 20 23 20 23 23 20 23 23 23 20 23 23     # # ## ### ##
0780: 23 23 23 20 23 23 23 23 23 23 23 23 20 23 23 23  ### ######## ###
0790: 23 23 23 23 23 23 23 23 23 23 0a 0a 20 20 20 20  ##########..    
07a0: 70 72 6f 63 20 48 65 61 64 20 7b 7d 20 7b 0a 09  proc Head {} {..
07b0: 52 65 71 75 69 72 65 64 4c 69 74 65 72 61 6c 20  RequiredLiteral 
07c0: 68 65 61 64 0a 09 52 65 71 75 69 72 65 64 4e 75  head..RequiredNu
07d0: 6d 62 65 72 20 2d 3e 20 68 65 61 64 0a 09 53 65  mber -> head..Se
07e0: 6d 69 63 6f 6c 6f 6e 0a 09 43 61 6c 6c 20 73 65  micolon..Call se
07f0: 74 68 65 61 64 20 24 68 65 61 64 0a 09 72 65 74  thead $head..ret
0800: 75 72 6e 0a 20 20 20 20 7d 0a 0a 20 20 20 20 70  urn.    }..    p
0810: 72 6f 63 20 50 72 69 6e 63 69 70 61 6c 42 72 61  roc PrincipalBra
0820: 6e 63 68 20 7b 7d 20 7b 0a 09 69 66 20 7b 21 5b  nch {} {..if {![
0830: 4f 70 74 69 6f 6e 61 6c 4c 69 74 65 72 61 6c 20  OptionalLiteral 
0840: 62 72 61 6e 63 68 5d 7d 20 72 65 74 75 72 6e 0a  branch]} return.
0850: 09 52 65 71 75 69 72 65 64 4e 75 6d 62 65 72 20  .RequiredNumber 
0860: 2d 3e 20 62 72 61 6e 63 68 0a 09 53 65 6d 69 63  -> branch..Semic
0870: 6f 6c 6f 6e 0a 09 43 61 6c 6c 20 73 65 74 70 72  olon..Call setpr
0880: 69 6e 63 69 70 61 6c 62 72 61 6e 63 68 20 24 62  incipalbranch $b
0890: 72 61 6e 63 68 0a 09 72 65 74 75 72 6e 0a 20 20  ranch..return.  
08a0: 20 20 7d 0a 0a 20 20 20 20 70 72 6f 63 20 41 63    }..    proc Ac
08b0: 63 65 73 73 20 7b 7d 20 7b 0a 09 52 65 71 75 69  cess {} {..Requi
08c0: 72 65 64 4c 69 74 65 72 61 6c 20 61 63 63 65 73  redLiteral acces
08d0: 73 20 3b 0a 09 53 65 6d 69 63 6f 6c 6f 6e 0a 09  s ;..Semicolon..
08e0: 72 65 74 75 72 6e 0a 20 20 20 20 7d 0a 0a 20 20  return.    }..  
08f0: 20 20 70 72 6f 63 20 53 79 6d 62 6f 6c 73 20 7b    proc Symbols {
0900: 7d 20 7b 0a 09 52 65 71 75 69 72 65 64 4c 69 74  } {..RequiredLit
0910: 65 72 61 6c 20 73 79 6d 62 6f 6c 73 0a 09 77 68  eral symbols..wh
0920: 69 6c 65 20 7b 5b 49 64 65 6e 74 20 2d 3e 20 73  ile {[Ident -> s
0930: 79 6d 62 6f 6c 5d 7d 20 7b 0a 09 20 20 20 20 52  ymbol]} {..    R
0940: 65 71 75 69 72 65 64 4e 75 6d 62 65 72 20 2d 3e  equiredNumber ->
0950: 20 72 65 76 0a 09 20 20 20 20 43 61 6c 6c 20 64   rev..    Call d
0960: 65 66 74 61 67 20 24 73 79 6d 62 6f 6c 20 24 72  eftag $symbol $r
0970: 65 76 0a 09 7d 0a 09 53 65 6d 69 63 6f 6c 6f 6e  ev..}..Semicolon
0980: 0a 09 72 65 74 75 72 6e 0a 20 20 20 20 7d 0a 0a  ..return.    }..
0990: 20 20 20 20 70 72 6f 63 20 4c 6f 63 6b 73 20 7b      proc Locks {
09a0: 7d 20 7b 0a 09 23 20 4e 6f 74 20 73 61 76 69 6e  } {..# Not savin
09b0: 67 20 6c 6f 63 6b 73 2e 0a 09 52 65 71 75 69 72  g locks...Requir
09c0: 65 64 4c 69 74 65 72 61 6c 20 6c 6f 63 6b 73 0a  edLiteral locks.
09d0: 09 77 68 69 6c 65 20 7b 5b 49 64 65 6e 74 20 2d  .while {[Ident -
09e0: 3e 20 73 79 6d 62 6f 6c 5d 7d 20 7b 0a 09 20 20  > symbol]} {..  
09f0: 20 20 52 65 71 75 69 72 65 64 4e 75 6d 62 65 72    RequiredNumber
0a00: 20 2d 3e 20 6c 0a 09 7d 0a 09 53 65 6d 69 63 6f   -> l..}..Semico
0a10: 6c 6f 6e 0a 09 72 65 74 75 72 6e 0a 20 20 20 20  lon..return.    
0a20: 7d 0a 0a 20 20 20 20 70 72 6f 63 20 53 74 72 69  }..    proc Stri
0a30: 63 74 6e 65 73 73 20 7b 7d 20 7b 0a 09 23 20 4e  ctness {} {..# N
0a40: 6f 74 20 73 61 76 69 6e 67 20 73 74 72 69 63 74  ot saving strict
0a50: 6e 65 73 73 0a 09 69 66 20 7b 21 5b 4f 70 74 69  ness..if {![Opti
0a60: 6f 6e 61 6c 4c 69 74 65 72 61 6c 20 73 74 72 69  onalLiteral stri
0a70: 63 74 5d 7d 20 72 65 74 75 72 6e 0a 09 53 65 6d  ct]} return..Sem
0a80: 69 63 6f 6c 6f 6e 0a 09 72 65 74 75 72 6e 0a 20  icolon..return. 
0a90: 20 20 20 7d 0a 0a 20 20 20 20 70 72 6f 63 20 46     }..    proc F
0aa0: 69 6c 65 43 6f 6d 6d 65 6e 74 20 7b 7d 20 7b 0a  ileComment {} {.
0ab0: 09 69 66 20 7b 21 5b 4f 70 74 69 6f 6e 61 6c 4c  .if {![OptionalL
0ac0: 69 74 65 72 61 6c 20 63 6f 6d 6d 65 6e 74 5d 7d  iteral comment]}
0ad0: 20 72 65 74 75 72 6e 0a 09 69 66 20 7b 21 5b 4f   return..if {![O
0ae0: 70 74 69 6f 6e 61 6c 53 74 72 69 6e 67 20 2d 3e  ptionalString ->
0af0: 20 63 5d 7d 20 72 65 74 75 72 6e 0a 09 53 65 6d   c]} return..Sem
0b00: 69 63 6f 6c 6f 6e 0a 09 43 61 6c 6c 20 73 65 74  icolon..Call set
0b10: 63 6f 6d 6d 65 6e 74 20 24 63 0a 09 72 65 74 75  comment $c..retu
0b20: 72 6e 0a 20 20 20 20 7d 0a 0a 20 20 20 20 70 72  rn.    }..    pr
0b30: 6f 63 20 45 78 70 61 6e 64 20 7b 7d 20 7b 0a 09  oc Expand {} {..
0b40: 23 20 4e 6f 74 20 73 61 76 69 6e 67 20 65 78 70  # Not saving exp
0b50: 61 6e 64 65 64 20 6b 65 79 77 6f 72 64 73 0a 09  anded keywords..
0b60: 69 66 20 7b 21 5b 4f 70 74 69 6f 6e 61 6c 4c 69  if {![OptionalLi
0b70: 74 65 72 61 6c 20 65 78 70 61 6e 64 5d 7d 20 72  teral expand]} r
0b80: 65 74 75 72 6e 0a 09 69 66 20 7b 21 5b 4f 70 74  eturn..if {![Opt
0b90: 69 6f 6e 61 6c 53 74 72 69 6e 67 20 2d 3e 20 64  ionalString -> d
0ba0: 75 6d 6d 79 5d 7d 20 72 65 74 75 72 6e 0a 09 53  ummy]} return..S
0bb0: 65 6d 69 63 6f 6c 6f 6e 0a 09 72 65 74 75 72 6e  emicolon..return
0bc0: 0a 20 20 20 20 7d 0a 0a 20 20 20 20 23 20 23 20  .    }..    # # 
0bd0: 23 23 20 23 23 23 20 23 23 23 23 23 20 23 23 23  ## ### ##### ###
0be0: 23 23 23 23 23 20 23 23 23 23 23 23 23 23 23 23  ##### ##########
0bf0: 23 23 23 0a 0a 20 20 20 20 70 72 6f 63 20 44 65  ###..    proc De
0c00: 6c 74 61 73 20 7b 7d 20 7b 0a 09 73 65 74 20 6f  ltas {} {..set o
0c10: 6b 20 5b 4f 70 74 69 6f 6e 61 6c 4e 75 6d 62 65  k [OptionalNumbe
0c20: 72 20 2d 3e 20 72 65 76 5d 0a 09 77 68 69 6c 65  r -> rev]..while
0c30: 20 7b 24 6f 6b 7d 20 7b 0a 09 20 20 20 20 44 61   {$ok} {..    Da
0c40: 74 65 20 20 20 20 20 2d 3e 20 64 0a 09 20 20 20  te     -> d..   
0c50: 20 41 75 74 68 6f 72 20 20 20 2d 3e 20 61 0a 09   Author   -> a..
0c60: 20 20 20 20 53 74 61 74 65 20 20 20 20 2d 3e 20      State    -> 
0c70: 73 0a 09 20 20 20 20 42 72 61 6e 63 68 65 73 20  s..    Branches 
0c80: 2d 3e 20 62 0a 09 20 20 20 20 4e 65 78 74 52 65  -> b..    NextRe
0c90: 76 20 20 2d 3e 20 6e 0a 09 20 20 20 20 43 61 6c  v  -> n..    Cal
0ca0: 6c 20 64 65 66 20 24 72 65 76 20 24 64 20 24 61  l def $rev $d $a
0cb0: 20 24 73 20 24 6e 20 24 62 0a 0a 09 20 20 20 20   $s $n $b...    
0cc0: 23 20 43 68 65 63 6b 20 69 66 20 74 68 69 73 20  # Check if this 
0cd0: 69 73 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 61  is followed by a
0ce0: 20 72 65 76 69 73 69 6f 6e 20 6e 75 6d 62 65 72   revision number
0cf0: 20 6f 72 20 74 68 65 0a 09 20 20 20 20 23 20 6c   or the..    # l
0d00: 69 74 65 72 61 6c 20 27 64 65 73 63 27 2e 20 49  iteral 'desc'. I
0d10: 66 20 6e 65 69 74 68 65 72 20 77 65 20 63 6f 6e  f neither we con
0d20: 73 75 6d 65 20 77 68 61 74 65 76 65 72 20 69 73  sume whatever is
0d30: 20 74 68 65 72 65 0a 09 20 20 20 20 23 20 75 6e   there..    # un
0d40: 74 69 6c 20 74 68 65 20 6e 65 78 74 20 73 65 6d  til the next sem
0d50: 69 63 6f 6c 6f 6e 2c 20 61 73 20 69 74 20 68 61  icolon, as it ha
0d60: 73 20 74 6f 20 62 65 20 61 20 27 6e 65 77 0a 09  s to be a 'new..
0d70: 20 20 20 20 23 20 70 68 72 61 73 65 27 2e 20 4f      # phrase'. O
0d80: 74 68 65 72 77 69 73 65 2c 20 66 6f 72 20 61 20  therwise, for a 
0d90: 72 65 76 69 73 69 6f 6e 20 6e 75 6d 62 65 72 20  revision number 
0da0: 77 65 20 6c 6f 6f 70 20 62 61 63 6b 0a 09 20 20  we loop back..  
0db0: 20 20 23 20 61 6e 64 20 63 6f 6e 73 75 6d 65 20    # and consume 
0dc0: 74 68 61 74 20 72 65 76 69 73 69 6f 6e 2c 20 61  that revision, a
0dd0: 6e 64 20 6c 61 73 74 6c 79 20 66 6f 72 20 27 64  nd lastly for 'd
0de0: 65 73 63 27 20 77 65 20 73 74 6f 70 0a 09 20 20  esc' we stop..  
0df0: 20 20 23 20 63 6f 6d 70 6c 65 74 65 6c 79 20 61    # completely a
0e00: 73 20 74 68 69 73 20 73 69 67 6e 61 6c 73 20 74  s this signals t
0e10: 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 72 65  he end of the re
0e20: 76 69 73 69 6f 6e 20 74 72 65 65 0a 09 20 20 20  vision tree..   
0e30: 20 23 20 61 6e 64 20 74 68 65 20 62 65 67 69 6e   # and the begin
0e40: 6e 69 6e 67 20 6f 66 20 74 68 65 20 64 65 6c 74  ning of the delt
0e50: 61 73 2e 0a 0a 09 20 20 20 20 77 68 69 6c 65 20  as....    while 
0e60: 7b 31 7d 20 7b 0a 09 09 73 65 74 20 6f 6b 20 5b  {1} {...set ok [
0e70: 4f 70 74 69 6f 6e 61 6c 4e 75 6d 62 65 72 20 2d  OptionalNumber -
0e80: 3e 20 72 65 76 5d 0a 09 09 69 66 20 7b 24 6f 6b  > rev]...if {$ok
0e90: 7d 20 62 72 65 61 6b 0a 0a 09 09 69 66 20 7b 5b  } break....if {[
0ea0: 4c 69 74 65 72 61 6c 50 65 65 6b 20 64 65 73 63  LiteralPeek desc
0eb0: 5d 7d 20 7b 0a 09 09 20 20 20 20 73 65 74 20 6f  ]} {...    set o
0ec0: 6b 20 30 0a 09 09 20 20 20 20 62 72 65 61 6b 0a  k 0...    break.
0ed0: 09 09 7d 0a 0a 09 09 41 6e 79 74 68 69 6e 67 20  ..}....Anything 
0ee0: 2d 3e 20 64 75 6d 6d 79 0a 09 09 53 65 6d 69 63  -> dummy...Semic
0ef0: 6f 6c 6f 6e 0a 09 20 20 20 20 7d 0a 09 7d 0a 09  olon..    }..}..
0f00: 43 61 6c 6c 20 64 65 66 64 6f 6e 65 0a 09 72 65  Call defdone..re
0f10: 74 75 72 6e 0a 20 20 20 20 7d 0a 0a 20 20 20 20  turn.    }..    
0f20: 23 20 23 20 23 23 20 23 23 23 20 23 23 23 23 23  # # ## ### #####
0f30: 20 23 23 23 23 23 23 23 23 20 23 23 23 23 23 23   ######## ######
0f40: 23 23 23 23 23 23 23 0a 0a 20 20 20 20 70 72 6f  #######..    pro
0f50: 63 20 44 61 74 65 20 7b 5f 20 64 76 7d 20 7b 0a  c Date {_ dv} {.
0f60: 09 75 70 76 61 72 20 31 20 24 64 76 20 64 0a 09  .upvar 1 $dv d..
0f70: 52 65 71 75 69 72 65 64 4c 69 74 65 72 61 6c 20  RequiredLiteral 
0f80: 64 61 74 65 0a 09 52 65 71 75 69 72 65 64 4e 75  date..RequiredNu
0f90: 6d 62 65 72 20 2d 3e 20 64 0a 09 53 65 6d 69 63  mber -> d..Semic
0fa0: 6f 6c 6f 6e 0a 0a 09 73 74 72 75 63 74 3a 3a 6c  olon...struct::l
0fb0: 69 73 74 20 61 73 73 69 67 6e 20 5b 73 70 6c 69  ist assign [spli
0fc0: 74 20 24 64 20 2e 5d 20 79 65 61 72 20 6d 6f 6e  t $d .] year mon
0fd0: 74 68 20 64 61 79 20 68 6f 75 72 20 6d 69 6e 20  th day hour min 
0fe0: 73 65 63 0a 09 69 66 20 7b 24 79 65 61 72 20 3c  sec..if {$year <
0ff0: 20 31 30 30 7d 20 7b 69 6e 63 72 20 79 65 61 72   100} {incr year
1000: 20 31 39 30 30 7d 0a 09 73 65 74 20 64 20 5b 63   1900}..set d [c
1010: 6c 6f 63 6b 20 73 63 61 6e 20 22 24 7b 79 65 61  lock scan "${yea
1020: 72 7d 2d 24 7b 6d 6f 6e 74 68 7d 2d 24 7b 64 61  r}-${month}-${da
1030: 79 7d 20 24 7b 68 6f 75 72 7d 3a 24 7b 6d 69 6e  y} ${hour}:${min
1040: 7d 3a 24 7b 73 65 63 7d 22 5d 0a 09 72 65 74 75  }:${sec}"]..retu
1050: 72 6e 0a 20 20 20 20 7d 0a 0a 20 20 20 20 70 72  rn.    }..    pr
1060: 6f 63 20 41 75 74 68 6f 72 20 7b 5f 20 61 76 7d  oc Author {_ av}
1070: 20 7b 0a 09 75 70 76 61 72 20 31 20 24 61 76 20   {..upvar 1 $av 
1080: 61 0a 09 52 65 71 75 69 72 65 64 4c 69 74 65 72  a..RequiredLiter
1090: 61 6c 20 61 75 74 68 6f 72 0a 09 41 6e 79 74 68  al author..Anyth
10a0: 69 6e 67 20 2d 3e 20 61 0a 09 53 65 6d 69 63 6f  ing -> a..Semico
10b0: 6c 6f 6e 0a 09 72 65 74 75 72 6e 0a 20 20 20 20  lon..return.    
10c0: 7d 0a 0a 20 20 20 20 70 72 6f 63 20 53 74 61 74  }..    proc Stat
10d0: 65 20 7b 5f 20 73 76 7d 20 7b 0a 09 75 70 76 61  e {_ sv} {..upva
10e0: 72 20 31 20 24 73 76 20 73 0a 09 52 65 71 75 69  r 1 $sv s..Requi
10f0: 72 65 64 4c 69 74 65 72 61 6c 20 73 74 61 74 65  redLiteral state
1100: 0a 09 41 6e 79 74 68 69 6e 67 20 2d 3e 20 73 0a  ..Anything -> s.
1110: 09 53 65 6d 69 63 6f 6c 6f 6e 0a 09 72 65 74 75  .Semicolon..retu
1120: 72 6e 0a 20 20 20 20 7d 0a 0a 20 20 20 20 70 72  rn.    }..    pr
1130: 6f 63 20 42 72 61 6e 63 68 65 73 20 7b 5f 20 62  oc Branches {_ b
1140: 76 7d 20 7b 0a 09 75 70 76 61 72 20 31 20 24 62  v} {..upvar 1 $b
1150: 76 20 62 0a 09 52 65 71 75 69 72 65 64 4c 69 74  v b..RequiredLit
1160: 65 72 61 6c 20 62 72 61 6e 63 68 65 73 0a 09 41  eral branches..A
1170: 6e 79 74 68 69 6e 67 20 2d 3e 20 62 0a 09 53 65  nything -> b..Se
1180: 6d 69 63 6f 6c 6f 6e 0a 09 72 65 74 75 72 6e 0a  micolon..return.
1190: 20 20 20 20 7d 0a 0a 20 20 20 20 70 72 6f 63 20      }..    proc 
11a0: 4e 65 78 74 52 65 76 20 7b 5f 20 6e 76 7d 20 7b  NextRev {_ nv} {
11b0: 0a 09 75 70 76 61 72 20 31 20 24 6e 76 20 6e 0a  ..upvar 1 $nv n.
11c0: 09 52 65 71 75 69 72 65 64 4c 69 74 65 72 61 6c  .RequiredLiteral
11d0: 20 6e 65 78 74 0a 09 41 6e 79 74 68 69 6e 67 20   next..Anything 
11e0: 2d 3e 20 6e 0a 09 53 65 6d 69 63 6f 6c 6f 6e 0a  -> n..Semicolon.
11f0: 09 72 65 74 75 72 6e 0a 20 20 20 20 7d 0a 0a 20  .return.    }.. 
1200: 20 20 20 23 20 23 20 23 23 20 23 23 23 20 23 23     # # ## ### ##
1210: 23 23 23 20 23 23 23 23 23 23 23 23 20 23 23 23  ### ######## ###
1220: 23 23 23 23 23 23 23 23 23 23 0a 0a 20 20 20 20  ##########..    
1230: 70 72 6f 63 20 44 65 73 63 72 69 70 74 69 6f 6e  proc Description
1240: 20 7b 7d 20 7b 0a 09 75 70 76 61 72 20 31 20 64   {} {..upvar 1 d
1250: 61 74 61 20 64 61 74 61 20 72 65 73 20 72 65 73  ata data res res
1260: 0a 09 52 65 71 75 69 72 65 64 4c 69 74 65 72 61  ..RequiredLitera
1270: 6c 20 64 65 73 63 0a 09 52 65 71 75 69 72 65 64  l desc..Required
1280: 53 74 72 69 6e 67 20 2d 3e 20 64 0a 09 43 61 6c  String -> d..Cal
1290: 6c 20 73 65 74 64 65 73 63 20 24 64 0a 09 72 65  l setdesc $d..re
12a0: 74 75 72 6e 0a 20 20 20 20 7d 0a 0a 20 20 20 20  turn.    }..    
12b0: 23 20 23 20 23 23 20 23 23 23 20 23 23 23 23 23  # # ## ### #####
12c0: 20 23 23 23 23 23 23 23 23 20 23 23 23 23 23 23   ######## ######
12d0: 23 23 23 23 23 23 23 0a 0a 20 20 20 20 70 72 6f  #######..    pro
12e0: 63 20 44 65 6c 74 61 54 65 78 74 73 20 7b 7d 20  c DeltaTexts {} 
12f0: 7b 0a 09 77 68 69 6c 65 20 7b 5b 4f 70 74 69 6f  {..while {[Optio
1300: 6e 61 6c 4e 75 6d 62 65 72 20 2d 3e 20 72 65 76  nalNumber -> rev
1310: 5d 7d 20 7b 0a 09 20 20 20 20 52 65 71 75 69 72  ]} {..    Requir
1320: 65 64 4c 69 74 65 72 61 6c 20 6c 6f 67 0a 09 20  edLiteral log.. 
1330: 20 20 20 52 65 71 75 69 72 65 64 53 74 72 69 6e     RequiredStrin
1340: 67 20 20 20 20 20 20 2d 3e 20 63 6d 73 67 0a 09  g      -> cmsg..
1350: 20 20 20 20 52 65 71 75 69 72 65 64 4c 69 74 65      RequiredLite
1360: 72 61 6c 20 74 65 78 74 0a 09 20 20 20 20 52 65  ral text..    Re
1370: 71 75 69 72 65 64 53 74 72 69 6e 67 52 61 6e 67  quiredStringRang
1380: 65 20 2d 3e 20 64 65 6c 74 61 0a 09 20 20 20 20  e -> delta..    
1390: 43 61 6c 6c 20 65 78 74 65 6e 64 20 24 72 65 76  Call extend $rev
13a0: 20 24 63 6d 73 67 20 24 64 65 6c 74 61 0a 09 7d   $cmsg $delta..}
13b0: 0a 09 72 65 74 75 72 6e 0a 20 20 20 20 7d 0a 0a  ..return.    }..
13c0: 20 20 20 20 23 20 23 20 23 23 20 23 23 23 20 23      # # ## ### #
13d0: 23 23 23 23 20 23 23 23 23 23 23 23 23 20 23 23  #### ######## ##
13e0: 23 23 23 23 23 23 23 23 23 23 23 0a 20 20 20 20  ###########.    
13f0: 23 23 20 49 6e 74 65 72 6e 61 6c 20 6d 65 74 68  ## Internal meth
1400: 6f 64 73 2c 20 6c 65 78 69 6f 67 72 61 70 68 69  ods, lexiographi
1410: 63 61 6c 20 70 72 6f 63 65 73 73 69 6e 67 0a 0a  cal processing..
1420: 20 20 20 20 70 72 6f 63 20 53 65 6d 69 63 6f 6c      proc Semicol
1430: 6f 6e 20 7b 7d 20 7b 0a 09 3a 3a 76 61 72 69 61  on {} {..::varia
1440: 62 6c 65 20 6d 79 64 61 74 61 0a 09 3a 3a 76 61  ble mydata..::va
1450: 72 69 61 62 6c 65 20 6d 79 70 6f 73 0a 0a 09 73  riable mypos...s
1460: 65 74 20 6f 6b 20 5b 72 65 67 65 78 70 20 2d 73  et ok [regexp -s
1470: 74 61 72 74 20 24 6d 79 70 6f 73 20 2d 69 6e 64  tart $mypos -ind
1480: 69 63 65 73 20 2d 2d 20 7b 5c 41 5c 73 2a 3b 5c  ices -- {\A\s*;\
1490: 73 2a 7d 20 24 6d 79 64 61 74 61 20 6d 61 74 63  s*} $mydata matc
14a0: 68 5d 0a 09 69 66 20 7b 21 24 6f 6b 7d 20 7b 20  h]..if {!$ok} { 
14b0: 45 78 70 65 63 74 65 64 20 27 3b 27 20 7d 0a 0a  Expected ';' }..
14c0: 09 53 6b 69 70 4f 76 65 72 20 6d 61 74 63 68 0a  .SkipOver match.
14d0: 09 72 65 74 75 72 6e 0a 20 20 20 20 7d 0a 0a 20  .return.    }.. 
14e0: 20 20 20 70 72 6f 63 20 52 65 71 75 69 72 65 64     proc Required
14f0: 4c 69 74 65 72 61 6c 20 7b 6e 61 6d 65 7d 20 7b  Literal {name} {
1500: 0a 09 3a 3a 76 61 72 69 61 62 6c 65 20 6d 79 64  ..::variable myd
1510: 61 74 61 0a 09 3a 3a 76 61 72 69 61 62 6c 65 20  ata..::variable 
1520: 6d 79 70 6f 73 0a 0a 09 73 65 74 20 70 61 74 74  mypos...set patt
1530: 65 72 6e 20 22 5c 5c 41 5c 5c 73 2a 24 6e 61 6d  ern "\\A\\s*$nam
1540: 65 5c 5c 73 2a 22 0a 09 73 65 74 20 6f 6b 20 5b  e\\s*"..set ok [
1550: 72 65 67 65 78 70 20 2d 73 74 61 72 74 20 24 6d  regexp -start $m
1560: 79 70 6f 73 20 2d 69 6e 64 69 63 65 73 20 2d 2d  ypos -indices --
1570: 20 24 70 61 74 74 65 72 6e 20 24 6d 79 64 61 74   $pattern $mydat
1580: 61 20 6d 61 74 63 68 5d 0a 09 69 66 20 7b 21 24  a match]..if {!$
1590: 6f 6b 7d 20 7b 20 45 78 70 65 63 74 65 64 20 27  ok} { Expected '
15a0: 24 6e 61 6d 65 27 20 7d 0a 0a 09 53 6b 69 70 4f  $name' }...SkipO
15b0: 76 65 72 20 6d 61 74 63 68 0a 09 72 65 74 75 72  ver match..retur
15c0: 6e 0a 20 20 20 20 7d 0a 0a 20 20 20 20 70 72 6f  n.    }..    pro
15d0: 63 20 4f 70 74 69 6f 6e 61 6c 4c 69 74 65 72 61  c OptionalLitera
15e0: 6c 20 7b 6e 61 6d 65 7d 20 7b 0a 09 3a 3a 76 61  l {name} {..::va
15f0: 72 69 61 62 6c 65 20 6d 79 64 61 74 61 0a 09 3a  riable mydata..:
1600: 3a 76 61 72 69 61 62 6c 65 20 6d 79 70 6f 73 0a  :variable mypos.
1610: 0a 09 73 65 74 20 70 61 74 74 65 72 6e 20 22 5c  ..set pattern "\
1620: 5c 41 5c 5c 73 2a 24 6e 61 6d 65 5c 5c 73 2a 22  \A\\s*$name\\s*"
1630: 0a 09 73 65 74 20 6f 6b 20 5b 72 65 67 65 78 70  ..set ok [regexp
1640: 20 2d 73 74 61 72 74 20 24 6d 79 70 6f 73 20 2d   -start $mypos -
1650: 69 6e 64 69 63 65 73 20 2d 2d 20 24 70 61 74 74  indices -- $patt
1660: 65 72 6e 20 24 6d 79 64 61 74 61 20 6d 61 74 63  ern $mydata matc
1670: 68 5d 0a 09 69 66 20 7b 21 24 6f 6b 7d 20 7b 20  h]..if {!$ok} { 
1680: 72 65 74 75 72 6e 20 30 20 7d 0a 0a 09 53 6b 69  return 0 }...Ski
1690: 70 4f 76 65 72 20 6d 61 74 63 68 0a 09 72 65 74  pOver match..ret
16a0: 75 72 6e 20 31 0a 20 20 20 20 7d 0a 0a 20 20 20  urn 1.    }..   
16b0: 20 70 72 6f 63 20 4c 69 74 65 72 61 6c 50 65 65   proc LiteralPee
16c0: 6b 20 7b 6e 61 6d 65 7d 20 7b 0a 09 3a 3a 76 61  k {name} {..::va
16d0: 72 69 61 62 6c 65 20 6d 79 64 61 74 61 0a 09 3a  riable mydata..:
16e0: 3a 76 61 72 69 61 62 6c 65 20 6d 79 70 6f 73 0a  :variable mypos.
16f0: 0a 09 73 65 74 20 70 61 74 74 65 72 6e 20 22 5c  ..set pattern "\
1700: 5c 41 5c 5c 73 2a 24 6e 61 6d 65 5c 5c 73 2a 22  \A\\s*$name\\s*"
1710: 0a 09 73 65 74 20 6f 6b 20 5b 72 65 67 65 78 70  ..set ok [regexp
1720: 20 2d 73 74 61 72 74 20 24 6d 79 70 6f 73 20 2d   -start $mypos -
1730: 69 6e 64 69 63 65 73 20 2d 2d 20 24 70 61 74 74  indices -- $patt
1740: 65 72 6e 20 24 6d 79 64 61 74 61 20 6d 61 74 63  ern $mydata matc
1750: 68 5d 0a 09 69 66 20 7b 21 24 6f 6b 7d 20 7b 20  h]..if {!$ok} { 
1760: 72 65 74 75 72 6e 20 30 20 7d 0a 0a 09 23 20 4e  return 0 }...# N
1770: 4f 20 2d 20 53 6b 69 70 4f 76 65 72 20 6d 61 74  O - SkipOver mat
1780: 63 68 20 2d 20 4f 6e 6c 79 20 6c 6f 6f 6b 69 6e  ch - Only lookin
1790: 67 20 61 68 65 61 64 20 68 65 72 65 2e 0a 09 72  g ahead here...r
17a0: 65 74 75 72 6e 20 31 0a 20 20 20 20 7d 0a 0a 20  eturn 1.    }.. 
17b0: 20 20 20 70 72 6f 63 20 52 65 71 75 69 72 65 64     proc Required
17c0: 4e 75 6d 62 65 72 20 7b 5f 20 76 7d 20 7b 0a 09  Number {_ v} {..
17d0: 75 70 76 61 72 20 31 20 24 76 20 76 61 6c 75 65  upvar 1 $v value
17e0: 0a 09 3a 3a 76 61 72 69 61 62 6c 65 20 6d 79 64  ..::variable myd
17f0: 61 74 61 0a 09 3a 3a 76 61 72 69 61 62 6c 65 20  ata..::variable 
1800: 6d 79 70 6f 73 0a 0a 09 73 65 74 20 70 61 74 74  mypos...set patt
1810: 65 72 6e 20 7b 5c 41 5c 73 2a 28 28 5c 64 7c 5c  ern {\A\s*((\d|\
1820: 2e 29 2b 29 5c 73 2a 7d 0a 09 73 65 74 20 6f 6b  .)+)\s*}..set ok
1830: 20 5b 72 65 67 65 78 70 20 2d 73 74 61 72 74 20   [regexp -start 
1840: 24 6d 79 70 6f 73 20 2d 69 6e 64 69 63 65 73 20  $mypos -indices 
1850: 2d 2d 20 24 70 61 74 74 65 72 6e 20 24 6d 79 64  -- $pattern $myd
1860: 61 74 61 20 6d 61 74 63 68 20 76 5d 0a 09 69 66  ata match v]..if
1870: 20 7b 21 24 6f 6b 7d 20 7b 20 45 78 70 65 63 74   {!$ok} { Expect
1880: 65 64 20 69 64 20 7d 0a 0a 09 45 78 74 72 61 63  ed id }...Extrac
1890: 74 20 24 76 20 2d 3e 20 76 61 6c 75 65 0a 09 53  t $v -> value..S
18a0: 6b 69 70 4f 76 65 72 20 6d 61 74 63 68 0a 09 72  kipOver match..r
18b0: 65 74 75 72 6e 0a 20 20 20 20 7d 0a 0a 20 20 20  eturn.    }..   
18c0: 20 70 72 6f 63 20 4f 70 74 69 6f 6e 61 6c 4e 75   proc OptionalNu
18d0: 6d 62 65 72 20 7b 5f 20 76 7d 20 7b 0a 09 75 70  mber {_ v} {..up
18e0: 76 61 72 20 31 20 24 76 20 76 61 6c 75 65 0a 09  var 1 $v value..
18f0: 3a 3a 76 61 72 69 61 62 6c 65 20 6d 79 64 61 74  ::variable mydat
1900: 61 0a 09 3a 3a 76 61 72 69 61 62 6c 65 20 6d 79  a..::variable my
1910: 70 6f 73 0a 0a 09 73 65 74 20 70 61 74 74 65 72  pos...set patter
1920: 6e 20 7b 5c 41 5c 73 2a 28 28 5c 64 7c 5c 2e 29  n {\A\s*((\d|\.)
1930: 2b 29 5c 73 2a 7d 0a 09 73 65 74 20 6f 6b 20 5b  +)\s*}..set ok [
1940: 72 65 67 65 78 70 20 2d 73 74 61 72 74 20 24 6d  regexp -start $m
1950: 79 70 6f 73 20 2d 69 6e 64 69 63 65 73 20 2d 2d  ypos -indices --
1960: 20 24 70 61 74 74 65 72 6e 20 24 6d 79 64 61 74   $pattern $mydat
1970: 61 20 6d 61 74 63 68 20 76 5d 0a 09 69 66 20 7b  a match v]..if {
1980: 21 24 6f 6b 7d 20 7b 20 72 65 74 75 72 6e 20 30  !$ok} { return 0
1990: 20 7d 0a 0a 09 45 78 74 72 61 63 74 20 24 76 20   }...Extract $v 
19a0: 2d 3e 20 76 61 6c 75 65 0a 09 53 6b 69 70 4f 76  -> value..SkipOv
19b0: 65 72 20 6d 61 74 63 68 0a 09 72 65 74 75 72 6e  er match..return
19c0: 20 31 0a 20 20 20 20 7d 0a 0a 20 20 20 20 70 72   1.    }..    pr
19d0: 6f 63 20 52 65 71 75 69 72 65 64 53 74 72 69 6e  oc RequiredStrin
19e0: 67 20 7b 5f 20 76 7d 20 7b 0a 09 75 70 76 61 72  g {_ v} {..upvar
19f0: 20 31 20 24 76 20 76 61 6c 75 65 0a 09 3a 3a 76   1 $v value..::v
1a00: 61 72 69 61 62 6c 65 20 6d 79 64 61 74 61 0a 09  ariable mydata..
1a10: 3a 3a 76 61 72 69 61 62 6c 65 20 6d 79 70 6f 73  ::variable mypos
1a20: 0a 0a 09 73 65 74 20 6f 6b 20 5b 72 65 67 65 78  ...set ok [regex
1a30: 70 20 2d 73 74 61 72 74 20 24 6d 79 70 6f 73 20  p -start $mypos 
1a40: 2d 69 6e 64 69 63 65 73 20 2d 2d 20 7b 5c 41 5c  -indices -- {\A\
1a50: 73 2a 40 28 28 5b 5e 40 5d 2a 28 40 40 29 2a 29  s*@(([^@]*(@@)*)
1a60: 2a 29 40 5c 73 2a 7d 20 24 6d 79 64 61 74 61 20  *)@\s*} $mydata 
1a70: 6d 61 74 63 68 20 76 5d 0a 09 69 66 20 7b 21 24  match v]..if {!$
1a80: 6f 6b 7d 20 7b 20 45 78 70 65 63 74 65 64 20 73  ok} { Expected s
1a90: 74 72 69 6e 67 20 7d 0a 0a 09 45 78 74 72 61 63  tring }...Extrac
1aa0: 74 20 24 76 20 2d 3e 20 76 61 6c 75 65 0a 09 73  t $v -> value..s
1ab0: 65 74 20 76 61 6c 75 65 20 5b 73 74 72 69 6e 67  et value [string
1ac0: 20 6d 61 70 20 7b 40 40 20 40 7d 20 24 76 61 6c   map {@@ @} $val
1ad0: 75 65 5d 0a 09 53 6b 69 70 4f 76 65 72 20 6d 61  ue]..SkipOver ma
1ae0: 74 63 68 0a 09 72 65 74 75 72 6e 0a 20 20 20 20  tch..return.    
1af0: 7d 0a 0a 20 20 20 20 70 72 6f 63 20 52 65 71 75  }..    proc Requ
1b00: 69 72 65 64 53 74 72 69 6e 67 52 61 6e 67 65 20  iredStringRange 
1b10: 7b 5f 20 76 7d 20 7b 0a 09 75 70 76 61 72 20 31  {_ v} {..upvar 1
1b20: 20 24 76 20 76 61 6c 75 65 0a 09 3a 3a 76 61 72   $v value..::var
1b30: 69 61 62 6c 65 20 6d 79 64 61 74 61 0a 09 3a 3a  iable mydata..::
1b40: 76 61 72 69 61 62 6c 65 20 6d 79 70 6f 73 0a 0a  variable mypos..
1b50: 09 73 65 74 20 6f 6b 20 5b 72 65 67 65 78 70 20  .set ok [regexp 
1b60: 2d 73 74 61 72 74 20 24 6d 79 70 6f 73 20 2d 69  -start $mypos -i
1b70: 6e 64 69 63 65 73 20 2d 2d 20 7b 5c 41 5c 73 2a  ndices -- {\A\s*
1b80: 40 28 28 5b 5e 40 5d 2a 28 40 40 29 2a 29 2a 29  @(([^@]*(@@)*)*)
1b90: 40 5c 73 2a 7d 20 24 6d 79 64 61 74 61 20 6d 61  @\s*} $mydata ma
1ba0: 74 63 68 20 76 61 6c 75 65 5d 0a 09 69 66 20 7b  tch value]..if {
1bb0: 21 24 6f 6b 7d 20 7b 20 45 78 70 65 63 74 65 64  !$ok} { Expected
1bc0: 20 73 74 72 69 6e 67 20 7d 0a 0a 09 53 6b 69 70   string }...Skip
1bd0: 4f 76 65 72 20 6d 61 74 63 68 0a 09 72 65 74 75  Over match..retu
1be0: 72 6e 0a 20 20 20 20 7d 0a 0a 20 20 20 20 70 72  rn.    }..    pr
1bf0: 6f 63 20 4f 70 74 69 6f 6e 61 6c 53 74 72 69 6e  oc OptionalStrin
1c00: 67 20 7b 5f 20 76 7d 20 7b 0a 09 75 70 76 61 72  g {_ v} {..upvar
1c10: 20 31 20 24 76 20 76 61 6c 75 65 0a 09 3a 3a 76   1 $v value..::v
1c20: 61 72 69 61 62 6c 65 20 6d 79 64 61 74 61 0a 09  ariable mydata..
1c30: 3a 3a 76 61 72 69 61 62 6c 65 20 6d 79 70 6f 73  ::variable mypos
1c40: 0a 0a 09 73 65 74 20 6f 6b 20 5b 72 65 67 65 78  ...set ok [regex
1c50: 70 20 2d 73 74 61 72 74 20 24 6d 79 70 6f 73 20  p -start $mypos 
1c60: 2d 69 6e 64 69 63 65 73 20 2d 2d 20 7b 5c 41 5c  -indices -- {\A\
1c70: 73 2a 40 28 28 5b 5e 40 5d 2a 28 40 40 29 2a 29  s*@(([^@]*(@@)*)
1c80: 2a 29 40 5c 73 2a 7d 20 24 6d 79 64 61 74 61 20  *)@\s*} $mydata 
1c90: 6d 61 74 63 68 20 76 5d 0a 09 69 66 20 7b 21 24  match v]..if {!$
1ca0: 6f 6b 7d 20 7b 20 72 65 74 75 72 6e 20 30 20 7d  ok} { return 0 }
1cb0: 0a 0a 09 45 78 74 72 61 63 74 20 24 76 20 2d 3e  ...Extract $v ->
1cc0: 20 76 61 6c 75 65 0a 09 73 65 74 20 76 61 6c 75   value..set valu
1cd0: 65 20 5b 73 74 72 69 6e 67 20 6d 61 70 20 7b 40  e [string map {@
1ce0: 40 20 40 7d 20 24 76 61 6c 75 65 5d 0a 09 53 6b  @ @} $value]..Sk
1cf0: 69 70 4f 76 65 72 20 6d 61 74 63 68 0a 09 72 65  ipOver match..re
1d00: 74 75 72 6e 20 31 0a 20 20 20 20 7d 0a 0a 20 20  turn 1.    }..  
1d10: 20 20 70 72 6f 63 20 49 64 65 6e 74 20 7b 5f 20    proc Ident {_ 
1d20: 76 7d 20 7b 0a 09 75 70 76 61 72 20 31 20 24 76  v} {..upvar 1 $v
1d30: 20 76 61 6c 75 65 0a 09 3a 3a 76 61 72 69 61 62   value..::variab
1d40: 6c 65 20 6d 79 64 61 74 61 0a 09 3a 3a 76 61 72  le mydata..::var
1d50: 69 61 62 6c 65 20 6d 79 70 6f 73 0a 0a 09 73 65  iable mypos...se
1d60: 74 20 6f 6b 20 5b 72 65 67 65 78 70 20 2d 73 74  t ok [regexp -st
1d70: 61 72 74 20 24 6d 79 70 6f 73 20 2d 69 6e 64 69  art $mypos -indi
1d80: 63 65 73 20 2d 2d 20 7b 5c 41 5c 73 2a 3b 5c 73  ces -- {\A\s*;\s
1d90: 2a 7d 20 24 6d 79 64 61 74 61 5d 0a 09 69 66 20  *} $mydata]..if 
1da0: 7b 24 6f 6b 7d 20 7b 20 72 65 74 75 72 6e 20 30  {$ok} { return 0
1db0: 20 7d 0a 0a 09 73 65 74 20 6f 6b 20 5b 72 65 67   }...set ok [reg
1dc0: 65 78 70 20 2d 73 74 61 72 74 20 24 6d 79 70 6f  exp -start $mypo
1dd0: 73 20 2d 69 6e 64 69 63 65 73 20 2d 2d 20 7b 5c  s -indices -- {\
1de0: 41 5c 73 2a 28 5b 5e 3a 5d 2a 29 5c 73 2a 3a 5c  A\s*([^:]*)\s*:\
1df0: 73 2a 7d 20 24 6d 79 64 61 74 61 20 6d 61 74 63  s*} $mydata matc
1e00: 68 20 76 5d 0a 09 69 66 20 7b 21 24 6f 6b 7d 20  h v]..if {!$ok} 
1e10: 7b 20 72 65 74 75 72 6e 20 30 20 7d 0a 0a 09 45  { return 0 }...E
1e20: 78 74 72 61 63 74 20 24 76 20 2d 3e 20 76 61 6c  xtract $v -> val
1e30: 75 65 0a 09 53 6b 69 70 4f 76 65 72 20 6d 61 74  ue..SkipOver mat
1e40: 63 68 0a 09 72 65 74 75 72 6e 20 31 0a 20 20 20  ch..return 1.   
1e50: 20 7d 0a 0a 20 20 20 20 70 72 6f 63 20 41 6e 79   }..    proc Any
1e60: 74 68 69 6e 67 20 7b 5f 20 76 7d 20 7b 0a 09 75  thing {_ v} {..u
1e70: 70 76 61 72 20 31 20 24 76 20 76 61 6c 75 65 0a  pvar 1 $v value.
1e80: 09 3a 3a 76 61 72 69 61 62 6c 65 20 6d 79 64 61  .::variable myda
1e90: 74 61 0a 09 3a 3a 76 61 72 69 61 62 6c 65 20 6d  ta..::variable m
1ea0: 79 70 6f 73 0a 0a 09 72 65 67 65 78 70 20 2d 73  ypos...regexp -s
1eb0: 74 61 72 74 20 24 6d 79 70 6f 73 20 2d 69 6e 64  tart $mypos -ind
1ec0: 69 63 65 73 20 2d 2d 20 7b 5c 41 5c 73 2a 28 5b  ices -- {\A\s*([
1ed0: 5e 3b 5d 2a 29 5c 73 2a 7d 20 24 6d 79 64 61 74  ^;]*)\s*} $mydat
1ee0: 61 20 6d 61 74 63 68 20 76 0a 0a 09 45 78 74 72  a match v...Extr
1ef0: 61 63 74 20 24 76 20 2d 3e 20 76 61 6c 75 65 0a  act $v -> value.
1f00: 09 53 6b 69 70 4f 76 65 72 20 6d 61 74 63 68 0a  .SkipOver match.
1f10: 09 72 65 74 75 72 6e 0a 20 20 20 20 7d 0a 0a 20  .return.    }.. 
1f20: 20 20 20 23 20 23 20 23 23 20 23 23 23 20 23 23     # # ## ### ##
1f30: 23 23 23 20 23 23 23 23 23 23 23 23 20 23 23 23  ### ######## ###
1f40: 23 23 23 23 23 23 23 23 23 23 0a 20 20 20 20 23  ##########.    #
1f50: 23 20 49 6e 74 65 72 6e 61 6c 20 6d 65 74 68 6f  # Internal metho
1f60: 64 73 2c 20 69 6e 70 75 74 20 68 61 6e 64 6c 69  ds, input handli
1f70: 6e 67 0a 0a 20 20 20 20 70 72 6f 63 20 45 78 74  ng..    proc Ext
1f80: 72 61 63 74 20 7b 72 61 6e 67 65 20 5f 20 76 7d  ract {range _ v}
1f90: 20 7b 0a 09 75 70 76 61 72 20 31 20 24 76 20 76   {..upvar 1 $v v
1fa0: 61 6c 75 65 0a 09 3a 3a 76 61 72 69 61 62 6c 65  alue..::variable
1fb0: 20 6d 79 64 61 74 61 0a 09 73 74 72 75 63 74 3a   mydata..struct:
1fc0: 3a 6c 69 73 74 20 61 73 73 69 67 6e 20 24 72 61  :list assign $ra
1fd0: 6e 67 65 20 73 20 65 0a 09 73 65 74 20 76 61 6c  nge s e..set val
1fe0: 75 65 20 5b 73 74 72 69 6e 67 20 72 61 6e 67 65  ue [string range
1ff0: 20 24 6d 79 64 61 74 61 20 24 73 20 24 65 5d 0a   $mydata $s $e].
2000: 09 72 65 74 75 72 6e 0a 20 20 20 20 7d 0a 0a 20  .return.    }.. 
2010: 20 20 20 70 72 6f 63 20 53 6b 69 70 4f 76 65 72     proc SkipOver
2020: 20 7b 6d 76 7d 20 7b 0a 09 23 20 4e 6f 74 65 3a   {mv} {..# Note:
2030: 20 54 68 65 20 69 6e 64 69 63 65 73 20 61 72 65   The indices are
2040: 20 61 62 73 6f 6c 75 74 65 21 2c 20 6e 6f 74 20   absolute!, not 
2050: 72 65 6c 61 74 69 76 65 20 74 6f 20 74 68 65 20  relative to the 
2060: 73 74 61 72 74 0a 09 23 20 6c 6f 63 61 74 69 6f  start..# locatio
2070: 6e 2e 0a 09 75 70 76 61 72 20 31 20 24 6d 76 20  n...upvar 1 $mv 
2080: 6d 61 74 63 68 0a 09 3a 3a 76 61 72 69 61 62 6c  match..::variabl
2090: 65 20 6d 79 70 6f 73 0a 09 3a 3a 76 61 72 69 61  e mypos..::varia
20a0: 62 6c 65 20 6d 79 73 69 7a 65 0a 0a 09 73 74 72  ble mysize...str
20b0: 75 63 74 3a 3a 6c 69 73 74 20 61 73 73 69 67 6e  uct::list assign
20c0: 20 24 6d 61 74 63 68 20 73 20 65 0a 09 23 70 75   $match s e..#pu
20d0: 74 73 20 22 3c 24 73 20 24 65 3e 20 5b 69 6e 66  ts "<$s $e> [inf
20e0: 6f 20 6c 65 76 65 6c 20 2d 31 5d 22 0a 0a 09 73  o level -1]"...s
20f0: 65 74 20 20 6d 79 70 6f 73 20 24 65 0a 09 69 6e  et  mypos $e..in
2100: 63 72 20 6d 79 70 6f 73 0a 0a 09 6c 6f 67 20 70  cr mypos...log p
2110: 72 6f 67 72 65 73 73 20 32 20 72 63 73 20 24 6d  rogress 2 rcs $m
2120: 79 70 6f 73 20 24 6d 79 73 69 7a 65 0a 09 23 70  ypos $mysize..#p
2130: 75 74 73 20 24 6d 79 70 6f 73 2f 24 6d 79 73 69  uts $mypos/$mysi
2140: 7a 65 0a 09 72 65 74 75 72 6e 0a 20 20 20 20 7d  ze..return.    }
2150: 0a 0a 20 20 20 20 70 72 6f 63 20 45 78 70 65 63  ..    proc Expec
2160: 74 65 64 20 7b 78 7d 20 7b 0a 09 3a 3a 76 61 72  ted {x} {..::var
2170: 69 61 62 6c 65 20 6d 79 64 61 74 61 0a 09 3a 3a  iable mydata..::
2180: 76 61 72 69 61 62 6c 65 20 6d 79 70 6f 73 0a 09  variable mypos..
2190: 73 65 74 20 65 20 24 6d 79 70 6f 73 20 3b 20 69  set e $mypos ; i
21a0: 6e 63 72 20 65 20 33 30 0a 09 72 65 74 75 72 6e  ncr e 30..return
21b0: 20 2d 63 6f 64 65 20 65 72 72 6f 72 20 2d 65 72   -code error -er
21c0: 72 6f 72 63 6f 64 65 20 76 63 3a 3a 72 63 73 3a  rorcode vc::rcs:
21d0: 3a 70 61 72 73 65 72 20 5c 0a 09 20 20 20 20 22  :parser \..    "
21e0: 45 78 70 65 63 74 65 64 20 24 78 20 40 20 27 5b  Expected $x @ '[
21f0: 73 74 72 69 6e 67 20 72 61 6e 67 65 20 24 6d 79  string range $my
2200: 64 61 74 61 20 24 6d 79 70 6f 73 20 24 65 5d 2e  data $mypos $e].
2210: 2e 2e 27 22 20 0a 20 20 20 20 7d 0a 0a 20 20 20  ..'" .    }..   
2220: 20 23 20 23 20 23 23 20 23 23 23 20 23 23 23 23   # # ## ### ####
2230: 23 20 23 23 23 23 23 23 23 23 20 23 23 23 23 23  # ######## #####
2240: 23 23 23 23 23 23 23 23 0a 20 20 20 20 23 23 20  ########.    ## 
2250: 53 65 74 75 70 2c 20 63 61 6c 6c 62 61 63 6b 73  Setup, callbacks
2260: 2e 0a 0a 20 20 20 20 70 72 6f 63 20 49 6e 69 74  ...    proc Init
2270: 69 61 6c 69 7a 65 20 7b 70 61 74 68 20 73 69 6e  ialize {path sin
2280: 6b 7d 20 7b 0a 09 3a 3a 76 61 72 69 61 62 6c 65  k} {..::variable
2290: 20 6d 79 70 6f 73 20 20 30 0a 09 3a 3a 76 61 72   mypos  0..::var
22a0: 69 61 62 6c 65 20 6d 79 64 61 74 61 20 5b 66 69  iable mydata [fi
22b0: 6c 65 75 74 69 6c 3a 3a 63 61 74 20 2d 65 6e 63  leutil::cat -enc
22c0: 6f 64 69 6e 67 20 62 69 6e 61 72 79 20 24 70 61  oding binary $pa
22d0: 74 68 5d 0a 09 3a 3a 76 61 72 69 61 62 6c 65 20  th]..::variable 
22e0: 6d 79 73 69 7a 65 20 5b 66 69 6c 65 20 73 69 7a  mysize [file siz
22f0: 65 20 24 70 61 74 68 5d 0a 09 3a 3a 76 61 72 69  e $path]..::vari
2300: 61 62 6c 65 20 6d 79 73 69 6e 6b 20 24 73 69 6e  able mysink $sin
2310: 6b 0a 09 72 65 74 75 72 6e 0a 20 20 20 20 7d 0a  k..return.    }.
2320: 0a 20 20 20 20 70 72 6f 63 20 43 61 6c 6c 20 7b  .    proc Call {
2330: 61 72 67 73 7d 20 7b 0a 09 3a 3a 76 61 72 69 61  args} {..::varia
2340: 62 6c 65 20 6d 79 73 69 6e 6b 0a 09 73 65 74 20  ble mysink..set 
2350: 63 6d 64 20 24 6d 79 73 69 6e 6b 0a 09 66 6f 72  cmd $mysink..for
2360: 65 61 63 68 20 61 20 24 61 72 67 73 20 7b 20 6c  each a $args { l
2370: 61 70 70 65 6e 64 20 63 6d 64 20 24 61 20 7d 0a  append cmd $a }.
2380: 09 65 76 61 6c 20 24 63 6d 64 0a 09 72 65 74 75  .eval $cmd..retu
2390: 72 6e 0a 20 20 20 20 7d 0a 0a 20 20 20 20 23 20  rn.    }..    # 
23a0: 23 20 23 23 20 23 23 23 20 23 23 23 23 23 20 23  # ## ### ##### #
23b0: 23 23 23 23 23 23 23 20 23 23 23 23 23 23 23 23  ####### ########
23c0: 23 23 23 23 23 0a 20 20 20 20 23 23 20 43 6f 6e  #####.    ## Con
23d0: 66 69 67 75 72 61 74 69 6f 6e 0a 0a 20 20 20 20  figuration..    
23e0: 74 79 70 65 76 61 72 69 61 62 6c 65 20 6d 79 64  typevariable myd
23f0: 61 74 61 20 7b 7d 20 3b 20 23 20 52 63 73 20 61  ata {} ; # Rcs a
2400: 72 63 68 69 76 65 20 63 6f 6e 74 65 6e 74 73 20  rchive contents 
2410: 74 6f 20 70 72 6f 63 65 73 73 0a 20 20 20 20 74  to process.    t
2420: 79 70 65 76 61 72 69 61 62 6c 65 20 6d 79 73 69  ypevariable mysi
2430: 7a 65 20 30 20 20 3b 20 23 20 4c 65 6e 67 74 68  ze 0  ; # Length
2440: 20 6f 66 20 63 6f 6e 74 65 6e 74 73 0a 20 20 20   of contents.   
2450: 20 74 79 70 65 76 61 72 69 61 62 6c 65 20 6d 79   typevariable my
2460: 73 69 6e 6b 20 7b 7d 20 3b 20 23 20 53 69 6e 6b  sink {} ; # Sink
2470: 20 74 6f 20 72 65 70 6f 72 74 20 74 6f 0a 0a 20   to report to.. 
2480: 20 20 20 70 72 61 67 6d 61 20 2d 68 61 73 69 6e     pragma -hasin
2490: 73 74 61 6e 63 65 73 20 20 20 6e 6f 20 3b 20 23  stances   no ; #
24a0: 20 73 69 6e 67 6c 65 74 6f 6e 0a 20 20 20 20 70   singleton.    p
24b0: 72 61 67 6d 61 20 2d 68 61 73 74 79 70 65 69 6e  ragma -hastypein
24c0: 66 6f 20 20 20 20 6e 6f 20 3b 20 23 20 6e 6f 20  fo    no ; # no 
24d0: 69 6e 74 72 6f 73 70 65 63 74 69 6f 6e 0a 20 20  introspection.  
24e0: 20 20 70 72 61 67 6d 61 20 2d 68 61 73 74 79 70    pragma -hastyp
24f0: 65 64 65 73 74 72 6f 79 20 6e 6f 20 3b 20 23 20  edestroy no ; # 
2500: 69 6d 6d 6f 72 74 61 6c 0a 0a 20 20 20 20 23 20  immortal..    # 
2510: 23 20 23 23 20 23 23 23 20 23 23 23 23 23 20 23  # ## ### ##### #
2520: 23 23 23 23 23 23 23 20 23 23 23 23 23 23 23 23  ####### ########
2530: 23 23 23 23 23 0a 7d 0a 0a 6e 61 6d 65 73 70 61  #####.}..namespa
2540: 63 65 20 65 76 61 6c 20 3a 3a 76 63 3a 3a 72 63  ce eval ::vc::rc
2550: 73 20 7b 0a 20 20 20 20 6e 61 6d 65 73 70 61 63  s {.    namespac
2560: 65 20 65 78 70 6f 72 74 20 70 61 72 73 65 72 0a  e export parser.
2570: 20 20 20 20 6e 61 6d 65 73 70 61 63 65 20 65 76      namespace ev
2580: 61 6c 20 70 61 72 73 65 72 20 7b 0a 09 6e 61 6d  al parser {..nam
2590: 65 73 70 61 63 65 20 69 6d 70 6f 72 74 20 3a 3a  espace import ::
25a0: 76 63 3a 3a 74 6f 6f 6c 73 3a 3a 6c 6f 67 0a 09  vc::tools::log..
25b0: 6c 6f 67 20 72 65 67 69 73 74 65 72 20 72 63 73  log register rcs
25c0: 0a 20 20 20 20 7d 0a 7d 0a 0a 23 20 23 20 23 23  .    }.}..# # ##
25d0: 20 23 23 23 20 23 23 23 23 23 20 23 23 23 23 23   ### ##### #####
25e0: 23 23 23 20 23 23 23 23 23 23 23 23 23 23 23 23  ### ############
25f0: 23 20 23 23 23 23 23 23 23 23 23 23 23 23 23 23  # ##############
2600: 23 23 23 23 23 23 23 0a 23 23 20 52 65 61 64 79  #######.## Ready
2610: 0a 0a 70 61 63 6b 61 67 65 20 70 72 6f 76 69 64  ..package provid
2620: 65 20 76 63 3a 3a 72 63 73 3a 3a 70 61 72 73 65  e vc::rcs::parse
2630: 72 20 31 2e 30 0a 72 65 74 75 72 6e 0a           r 1.0.return.