Hex Artifact Content

Not logged in
Bounty program for improvements to Tcl and certain Tcl packages.
Tcl 2019 Conference, Houston/TX, US, Nov 4-8
Send your abstracts to tclconference@googlegroups.com
or submit via the online form by Sep 9.

Artifact 28a9dd548ce410c83fd89679ee63826c5a35ab24:


0000: 23 20 2d 2a 2d 20 74 63 6c 20 2d 2a 2d 20 43 6f  # -*- tcl -*- Co
0010: 70 79 72 69 67 68 74 20 28 63 29 20 32 30 31 33  pyright (c) 2013
0020: 20 41 6e 64 72 65 61 73 20 4b 75 70 72 69 65 73   Andreas Kupries
0030: 0a 23 20 23 20 23 23 20 23 23 23 20 23 23 23 23  .# # ## ### ####
0040: 23 20 23 23 23 23 23 23 23 23 20 23 23 23 23 23  # ######## #####
0050: 23 23 23 23 23 23 23 23 20 23 23 23 23 23 23 23  ######## #######
0060: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 0a 23  ##############.#
0070: 23 20 54 45 41 70 6f 74 20 6d 65 74 61 20 64 61  # TEApot meta da
0080: 74 61 20 73 75 70 70 6f 72 74 3a 20 72 65 66 65  ta support: refe
0090: 72 65 6e 63 65 73 2e 0a 0a 23 20 23 20 23 23 20  rences...# # ## 
00a0: 23 23 23 20 23 23 23 23 23 20 23 23 23 23 23 23  ### ##### ######
00b0: 23 23 20 23 23 23 23 23 23 23 23 23 23 23 23 23  ## #############
00c0: 20 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23   ###############
00d0: 23 23 23 23 23 23 0a 23 23 20 45 78 70 6f 72 74  ######.## Export
00e0: 20 28 69 6e 74 65 72 6e 61 6c 73 20 2d 20 29 0a   (internals - ).
00f0: 0a 6e 61 6d 65 73 70 61 63 65 20 65 76 61 6c 20  .namespace eval 
0100: 3a 3a 6b 65 74 74 6c 65 3a 3a 6d 64 72 65 66 20  ::kettle::mdref 
0110: 7b 0a 20 20 20 20 6e 61 6d 65 73 70 61 63 65 20  {.    namespace 
0120: 65 78 70 6f 72 74 20 7b 5b 61 2d 7a 5d 2a 7d 20  export {[a-z]*} 
0130: 32 74 63 6c 0a 20 20 20 20 6e 61 6d 65 73 70 61  2tcl.    namespa
0140: 63 65 20 65 6e 73 65 6d 62 6c 65 20 63 72 65 61  ce ensemble crea
0150: 74 65 0a 7d 0a 0a 23 20 23 20 23 23 20 23 23 23  te.}..# # ## ###
0160: 20 23 23 23 23 23 20 23 23 23 23 23 23 23 23 20   ##### ######## 
0170: 23 23 23 23 23 23 23 23 23 23 23 23 23 20 23 23  ############# ##
0180: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0190: 23 23 23 0a 23 23 20 53 74 61 74 65 0a 0a 23 20  ###.## State..# 
01a0: 23 20 23 23 20 23 23 23 20 23 23 23 23 23 20 23  # ## ### ##### #
01b0: 23 23 23 23 23 23 23 20 23 23 23 23 23 23 23 23  ####### ########
01c0: 23 23 23 23 23 20 23 23 23 23 23 23 23 23 23 23  ##### ##########
01d0: 23 23 23 23 23 23 23 23 23 23 23 0a 23 23 20 41  ###########.## A
01e0: 50 49 2e 0a 0a 70 72 6f 63 20 3a 3a 6b 65 74 74  PI...proc ::kett
01f0: 6c 65 3a 3a 6d 64 72 65 66 3a 3a 76 61 6c 69 64  le::mdref::valid
0200: 20 7b 72 65 66 20 7b 6d 76 20 7b 7d 7d 7d 20 7b   {ref {mv {}}} {
0210: 0a 20 20 20 20 69 66 20 7b 24 6d 76 20 6e 65 20  .    if {$mv ne 
0220: 22 22 7d 20 7b 75 70 76 61 72 20 31 20 24 6d 76  ""} {upvar 1 $mv
0230: 20 6d 65 73 73 61 67 65 7d 0a 0a 20 20 20 20 23   message}..    #
0240: 20 47 65 74 20 73 69 7a 65 20 74 6f 20 63 68 65   Get size to che
0250: 63 6b 2c 20 69 6d 70 6c 69 63 69 74 6c 79 20 61  ck, implicitly a
0260: 6c 73 6f 20 63 68 65 63 6b 73 20 74 68 61 74 20  lso checks that 
0270: 74 68 65 20 72 65 66 65 72 65 6e 63 65 20 69 73  the reference is
0280: 0a 20 20 20 20 23 20 61 20 76 61 6c 69 64 20 6c  .    # a valid l
0290: 69 73 74 2e 0a 0a 20 20 20 20 69 66 20 7b 5b 63  ist...    if {[c
02a0: 61 74 63 68 20 7b 0a 09 73 65 74 20 73 69 7a 65  atch {..set size
02b0: 20 5b 6c 6c 65 6e 67 74 68 20 24 72 65 66 5d 0a   [llength $ref].
02c0: 20 20 20 20 7d 20 6d 73 67 5d 7d 20 7b 0a 09 73      } msg]} {..s
02d0: 65 74 20 6d 65 73 73 61 67 65 20 24 6d 73 67 0a  et message $msg.
02e0: 09 72 65 74 75 72 6e 20 30 0a 20 20 20 20 7d 0a  .return 0.    }.
02f0: 0a 20 20 20 20 23 20 42 61 73 69 63 73 3a 20 45  .    # Basics: E
0300: 6d 70 74 79 20 69 73 20 62 61 64 2e 20 4a 75 73  mpty is bad. Jus
0310: 74 20 74 68 65 20 70 61 63 6b 61 67 65 20 6e 61  t the package na
0320: 6d 65 20 69 73 20 6f 6b 2e 0a 0a 20 20 20 20 69  me is ok...    i
0330: 66 20 7b 24 73 69 7a 65 20 3d 3d 20 30 7d 20 7b  f {$size == 0} {
0340: 73 65 74 20 6d 65 73 73 61 67 65 20 22 45 6d 70  set message "Emp
0350: 74 79 22 20 3b 20 72 65 74 75 72 6e 20 30 7d 0a  ty" ; return 0}.
0360: 20 20 20 20 69 66 20 7b 24 73 69 7a 65 20 3d 3d      if {$size ==
0370: 20 31 7d 20 7b 72 65 74 75 72 6e 20 31 7d 0a 0a   1} {return 1}..
0380: 20 20 20 20 73 65 74 20 72 65 66 20 5b 6c 72 61      set ref [lra
0390: 6e 67 65 20 24 72 65 66 20 31 20 65 6e 64 5d 20  nge $ref 1 end] 
03a0: 3b 20 23 20 43 75 74 20 6e 61 6d 65 0a 0a 20 20  ; # Cut name..  
03b0: 20 20 77 68 69 6c 65 20 7b 5b 6c 6c 65 6e 67 74    while {[llengt
03c0: 68 20 24 72 65 66 5d 7d 20 7b 0a 09 23 20 53 63  h $ref]} {..# Sc
03d0: 61 6e 20 75 6e 74 69 6c 20 66 69 72 73 74 20 6f  an until first o
03e0: 70 74 69 6f 6e 0a 09 73 65 74 20 76 20 5b 6c 69  ption..set v [li
03f0: 6e 64 65 78 20 24 72 65 66 20 30 5d 0a 09 69 66  ndex $ref 0]..if
0400: 20 7b 5b 73 74 72 69 6e 67 20 6d 61 74 63 68 20   {[string match 
0410: 2d 2a 20 24 76 5d 7d 20 62 72 65 61 6b 0a 09 23  -* $v]} break..#
0420: 20 43 68 65 63 6b 20 74 68 61 74 20 74 68 65 20   Check that the 
0430: 6e 6f 6e 2d 6f 70 74 69 6f 6e 20 69 73 20 61 20  non-option is a 
0440: 76 61 6c 69 64 20 72 65 71 75 69 72 65 6d 65 6e  valid requiremen
0450: 74 73 2e 0a 09 69 66 20 7b 21 5b 56 72 65 71 76  ts...if {![Vreqv
0460: 61 6c 69 64 20 24 76 20 6d 65 73 73 61 67 65 5d  alid $v message]
0470: 7d 20 7b 0a 09 20 20 20 20 72 65 74 75 72 6e 20  } {..    return 
0480: 30 0a 09 7d 0a 09 73 65 74 20 72 65 66 20 5b 6c  0..}..set ref [l
0490: 72 61 6e 67 65 20 24 72 65 66 20 31 20 65 6e 64  range $ref 1 end
04a0: 5d 20 3b 20 23 20 43 75 74 20 72 65 71 75 69 72  ] ; # Cut requir
04b0: 65 6d 65 6e 74 0a 20 20 20 20 7d 0a 0a 20 20 20  ement.    }..   
04c0: 20 23 20 55 6e 65 76 65 6e 20 6c 65 6e 67 74 68   # Uneven length
04d0: 20 69 73 20 62 61 64 2e 20 54 68 65 20 6c 61 73   is bad. The las
04e0: 74 20 6f 70 74 69 6f 6e 20 77 69 6c 6c 20 68 61  t option will ha
04f0: 76 65 20 6e 6f 0a 20 20 20 20 23 20 76 61 6c 75  ve no.    # valu
0500: 65 2e 20 52 65 6d 65 6d 62 65 72 2c 20 66 69 72  e. Remember, fir
0510: 73 74 20 65 6c 65 6d 65 6e 74 20 69 73 20 6e 61  st element is na
0520: 6d 65 2c 20 74 68 65 6e 20 72 65 71 75 69 72 65  me, then require
0530: 6d 65 6e 74 73 2c 20 74 68 65 6e 0a 20 20 20 20  ments, then.    
0540: 23 20 6f 70 74 69 6f 6e 2f 76 61 6c 75 65 20 70  # option/value p
0550: 61 69 72 73 2e 20 41 6e 20 65 76 65 6e 20 6c 65  airs. An even le
0560: 6e 67 74 68 20 69 73 20 65 78 70 65 63 74 65 64  ngth is expected
0570: 20 77 68 65 6e 20 6c 6f 6f 6b 69 6e 67 20 61 74   when looking at
0580: 0a 20 20 20 20 23 20 74 68 65 20 6f 70 74 69 6f  .    # the optio
0590: 6e 2f 76 61 6c 75 65 20 70 61 69 72 73 65 2e 0a  n/value pairse..
05a0: 0a 20 20 20 20 69 66 20 7b 5b 6c 6c 65 6e 67 74  .    if {[llengt
05b0: 68 20 24 72 65 66 5d 20 25 20 32 20 3d 3d 20 31  h $ref] % 2 == 1
05c0: 7d 20 7b 0a 09 73 65 74 20 6d 65 73 73 61 67 65  } {..set message
05d0: 20 22 4c 61 73 74 20 6f 70 74 69 6f 6e 20 69 73   "Last option is
05e0: 20 77 69 74 68 6f 75 74 20 76 61 6c 75 65 22 0a   without value".
05f0: 09 72 65 74 75 72 6e 20 30 0a 20 20 20 20 7d 0a  .return 0.    }.
0600: 0a 20 20 20 20 23 20 53 63 61 6e 20 74 68 65 20  .    # Scan the 
0610: 6f 70 74 69 6f 6e 73 20 61 6e 64 20 76 61 6c 69  options and vali
0620: 64 61 74 65 20 74 68 65 6d 2e 0a 0a 20 20 20 20  date them...    
0630: 66 6f 72 65 61 63 68 20 7b 6b 20 76 7d 20 24 72  foreach {k v} $r
0640: 65 66 20 7b 0a 09 73 77 69 74 63 68 20 2d 65 78  ef {..switch -ex
0650: 61 63 74 20 2d 2d 20 24 6b 20 7b 0a 09 20 20 20  act -- $k {..   
0660: 20 2d 72 65 71 75 69 72 65 20 7b 0a 09 09 69 66   -require {...if
0670: 20 7b 21 5b 56 72 65 71 76 61 6c 69 64 20 24 76   {![Vreqvalid $v
0680: 20 6d 65 73 73 61 67 65 5d 7d 20 7b 0a 09 09 20   message]} {... 
0690: 20 20 20 72 65 74 75 72 6e 20 30 0a 09 09 7d 0a     return 0...}.
06a0: 09 20 20 20 20 7d 0a 09 20 20 20 20 2d 70 6c 61  .    }..    -pla
06b0: 74 66 6f 72 6d 20 2d 0a 09 20 20 20 20 2d 61 72  tform -..    -ar
06c0: 63 68 67 6c 6f 62 20 7b 7d 0a 09 20 20 20 20 2d  chglob {}..    -
06d0: 69 73 20 7b 0a 09 09 69 66 20 7b 21 5b 45 76 61  is {...if {![Eva
06e0: 6c 69 64 20 24 76 20 6d 65 73 73 61 67 65 5d 7d  lid $v message]}
06f0: 20 7b 0a 09 09 20 20 20 20 72 65 74 75 72 6e 20   {...    return 
0700: 30 0a 09 09 7d 0a 09 20 20 20 20 7d 0a 09 20 20  0...}..    }..  
0710: 20 20 64 65 66 61 75 6c 74 20 7b 0a 09 09 73 65    default {...se
0720: 74 20 6d 65 73 73 61 67 65 20 22 55 6e 6b 6e 6f  t message "Unkno
0730: 77 6e 20 6f 70 74 69 6f 6e 20 5c 22 24 6b 5c 22  wn option \"$k\"
0740: 22 0a 09 09 72 65 74 75 72 6e 20 30 0a 09 20 20  "...return 0..  
0750: 20 20 7d 0a 09 7d 0a 20 20 20 20 7d 0a 0a 20 20    }..}.    }..  
0760: 20 20 72 65 74 75 72 6e 20 31 0a 7d 0a 0a 70 72    return 1.}..pr
0770: 6f 63 20 3a 3a 6b 65 74 74 6c 65 3a 3a 6d 64 72  oc ::kettle::mdr
0780: 65 66 3a 3a 6e 6f 72 6d 61 6c 69 7a 65 20 7b 72  ef::normalize {r
0790: 65 66 65 72 65 6e 63 65 73 7d 20 7b 0a 20 20 20  eferences} {.   
07a0: 20 23 20 54 61 6b 65 20 61 20 6c 69 73 74 20 6f   # Take a list o
07b0: 66 20 72 65 66 65 72 65 6e 63 65 73 20 61 6e 64  f references and
07c0: 20 72 65 6d 6f 76 65 20 72 65 64 75 6e 64 61 6e   remove redundan
07d0: 63 69 65 73 20 69 6e 20 65 61 63 68 0a 20 20 20  cies in each.   
07e0: 20 23 20 72 65 66 65 72 65 6e 63 65 2c 20 61 6e   # reference, an
07f0: 64 20 61 63 72 6f 73 73 20 61 6c 6c 20 72 65 66  d across all ref
0800: 65 72 65 6e 63 65 73 2e 0a 0a 20 20 20 20 23 20  erences...    # 
0810: 49 6e 20 61 20 66 69 72 73 74 20 69 74 65 72 61  In a first itera
0820: 74 69 6f 6e 20 65 61 63 68 20 72 65 66 65 72 65  tion each refere
0830: 6e 63 65 20 69 73 20 62 72 6f 75 67 68 74 20 69  nce is brought i
0840: 6e 74 6f 20 63 61 6e 6f 6e 69 63 61 6c 0a 20 20  nto canonical.  
0850: 20 20 23 20 66 6f 72 6d 2e 20 54 68 69 73 20 72    # form. This r
0860: 65 6d 6f 76 65 73 20 74 68 65 20 72 65 64 75 6e  emoves the redun
0870: 64 61 6e 63 69 65 73 20 69 6e 20 65 61 63 68 20  dancies in each 
0880: 72 65 66 65 72 65 6e 63 65 2e 20 54 68 65 6e 20  reference. Then 
0890: 77 65 0a 20 20 20 20 23 20 73 6f 72 74 20 74 68  we.    # sort th
08a0: 65 20 72 65 66 65 72 65 6e 63 65 73 20 62 79 20  e references by 
08b0: 70 61 63 6b 61 67 65 20 6e 61 6d 65 2c 20 61 6e  package name, an
08c0: 64 20 66 6f 72 20 65 61 63 68 20 70 61 63 6b 61  d for each packa
08d0: 67 65 20 77 69 74 68 0a 20 20 20 20 23 20 6d 6f  ge with.    # mo
08e0: 72 65 20 74 68 61 6e 20 6f 6e 65 20 72 65 66 65  re than one refe
08f0: 72 65 6e 63 65 20 77 65 20 70 75 74 20 74 68 65  rence we put the
0900: 6d 20 74 6f 67 65 74 68 65 72 20 61 6e 64 20 72  m together and r
0910: 65 2d 63 6f 6e 73 74 72 75 63 74 0a 20 20 20 20  e-construct.    
0920: 23 20 74 68 65 20 63 61 6e 6f 6e 69 63 61 6c 20  # the canonical 
0930: 66 6f 72 6d 2e 0a 0a 20 20 20 20 61 72 72 61 79  form...    array
0940: 20 73 65 74 20 70 61 63 6b 61 67 65 20 7b 7d 0a   set package {}.
0950: 0a 20 20 20 20 23 20 42 75 67 20 37 32 39 36 39  .    # Bug 72969
0960: 2e 20 4b 65 65 70 20 74 68 65 20 6f 72 64 65 72  . Keep the order
0970: 20 6f 66 20 64 65 70 65 6e 64 65 6e 63 69 65 73   of dependencies
0980: 2c 20 69 74 20 6d 61 79 20 62 65 20 69 6d 70 6f  , it may be impo
0990: 72 74 61 6e 74 0a 20 20 20 20 23 20 64 75 72 69  rtant.    # duri
09a0: 6e 67 20 73 65 74 75 70 2e 0a 0a 20 20 20 20 73  ng setup...    s
09b0: 65 74 20 6e 61 6d 65 73 20 7b 7d 0a 0a 20 20 20  et names {}..   
09c0: 20 66 6f 72 65 61 63 68 20 72 65 66 20 24 72 65   foreach ref $re
09d0: 66 65 72 65 6e 63 65 73 20 7b 0a 09 73 65 74 20  ferences {..set 
09e0: 6e 61 6d 65 20 5b 6c 69 6e 64 65 78 20 24 72 65  name [lindex $re
09f0: 66 20 30 5d 0a 09 73 65 74 20 73 70 65 63 20 5b  f 0]..set spec [
0a00: 6c 72 61 6e 67 65 20 24 72 65 66 20 31 20 65 6e  lrange $ref 1 en
0a10: 64 5d 0a 0a 09 73 65 74 20 72 65 66 20 5b 43 6f  d]...set ref [Co
0a20: 6e 73 6c 69 73 74 20 24 6e 61 6d 65 20 24 73 70  nslist $name $sp
0a30: 65 63 5d 0a 0a 09 73 65 74 20 6e 61 6d 65 20 5b  ec]...set name [
0a40: 6c 69 6e 64 65 78 20 24 72 65 66 20 30 5d 0a 09  lindex $ref 0]..
0a50: 73 65 74 20 73 70 65 63 20 5b 6c 72 61 6e 67 65  set spec [lrange
0a60: 20 24 72 65 66 20 31 20 65 6e 64 5d 0a 0a 09 69   $ref 1 end]...i
0a70: 66 20 7b 21 5b 69 6e 66 6f 20 65 78 69 73 74 73  f {![info exists
0a80: 20 70 61 63 6b 61 67 65 28 24 6e 61 6d 65 29 5d   package($name)]
0a90: 7d 20 7b 0a 09 20 20 20 20 6c 61 70 70 65 6e 64  } {..    lappend
0aa0: 20 6e 61 6d 65 73 20 24 6e 61 6d 65 0a 09 7d 0a   names $name..}.
0ab0: 09 6c 61 70 70 65 6e 64 20 70 61 63 6b 61 67 65  .lappend package
0ac0: 28 24 6e 61 6d 65 29 20 24 73 70 65 63 0a 20 20  ($name) $spec.  
0ad0: 20 20 7d 0a 0a 20 20 20 20 73 65 74 20 72 65 66    }..    set ref
0ae0: 65 72 65 6e 63 65 73 20 7b 7d 0a 20 20 20 20 66  erences {}.    f
0af0: 6f 72 65 61 63 68 20 6e 61 6d 65 20 24 6e 61 6d  oreach name $nam
0b00: 65 73 20 7b 0a 09 73 65 74 20 73 70 65 63 73 20  es {..set specs 
0b10: 24 70 61 63 6b 61 67 65 28 24 6e 61 6d 65 29 0a  $package($name).
0b20: 0a 09 69 66 20 7b 5b 6c 6c 65 6e 67 74 68 20 24  ..if {[llength $
0b30: 73 70 65 63 73 5d 20 3d 3d 20 31 7d 20 7b 0a 09  specs] == 1} {..
0b40: 20 20 20 20 23 20 53 69 6e 67 6c 65 20 72 65 66      # Single ref
0b50: 65 72 65 6e 63 65 2c 20 72 65 63 6f 6e 73 74 72  erence, reconstr
0b60: 75 63 74 20 66 72 6f 6d 20 70 61 72 74 73 2c 20  uct from parts, 
0b70: 69 73 20 63 61 6e 6f 6e 69 63 61 6c 0a 09 20 20  is canonical..  
0b80: 20 20 23 20 61 6c 72 65 61 64 79 2e 0a 0a 09 20    # already.... 
0b90: 20 20 20 6c 61 70 70 65 6e 64 20 72 65 66 65 72     lappend refer
0ba0: 65 6e 63 65 73 20 5b 6c 69 6e 73 65 72 74 20 5b  ences [linsert [
0bb0: 6c 69 6e 64 65 78 20 24 73 70 65 63 73 20 30 5d  lindex $specs 0]
0bc0: 20 30 20 24 6e 61 6d 65 5d 0a 09 7d 20 65 6c 73   0 $name]..} els
0bd0: 65 20 7b 0a 09 20 20 20 20 23 20 4d 75 6c 74 69  e {..    # Multi
0be0: 70 6c 65 20 72 65 66 65 72 65 6e 63 65 73 20 74  ple references t
0bf0: 6f 20 6f 6e 65 20 70 61 63 6b 61 67 65 2e 0a 09  o one package...
0c00: 20 20 20 20 23 20 4d 65 72 67 65 20 73 70 65 63      # Merge spec
0c10: 73 20 69 6e 74 6f 20 6f 6e 65 20 6c 69 73 74 20  s into one list 
0c20: 61 6e 64 20 72 65 2d 63 61 6e 6f 6e 69 63 61 6c  and re-canonical
0c30: 69 7a 65 2e 0a 0a 09 20 20 20 20 73 65 74 20 73  ize....    set s
0c40: 70 65 63 20 5b 63 6f 6e 63 61 74 20 7b 2a 7d 24  pec [concat {*}$
0c50: 73 70 65 63 73 5d 0a 09 20 20 20 20 6c 61 70 70  specs]..    lapp
0c60: 65 6e 64 20 72 65 66 65 72 65 6e 63 65 73 20 5b  end references [
0c70: 43 6f 6e 73 6c 69 73 74 20 24 6e 61 6d 65 20 24  Conslist $name $
0c80: 73 70 65 63 5d 0a 09 7d 0a 20 20 20 20 7d 0a 0a  spec]..}.    }..
0c90: 20 20 20 20 72 65 74 75 72 6e 20 24 72 65 66 65      return $refe
0ca0: 72 65 6e 63 65 73 0a 7d 0a 0a 70 72 6f 63 20 3a  rences.}..proc :
0cb0: 3a 6b 65 74 74 6c 65 3a 3a 6d 64 72 65 66 3a 3a  :kettle::mdref::
0cc0: 32 74 63 6c 20 7b 72 65 66 7d 20 7b 0a 20 20 20  2tcl {ref} {.   
0cd0: 20 23 20 43 6f 6e 76 65 72 74 20 69 6e 74 65 72   # Convert inter
0ce0: 6e 61 6c 20 66 6f 72 6d 20 28 72 65 71 75 69 72  nal form (requir
0cf0: 65 6d 65 6e 74 73 20 61 72 65 20 31 2f 32 2d 65  ements are 1/2-e
0d00: 6c 65 6d 65 6e 74 20 6c 69 73 74 73 29 20 74 6f  lement lists) to
0d10: 0a 20 20 20 20 23 20 54 63 6c 20 66 6f 72 6d 2c  .    # Tcl form,
0d20: 20 72 65 71 75 69 72 65 6d 65 6e 74 73 20 61 72   requirements ar
0d30: 65 20 27 61 27 2c 20 27 61 2d 62 27 2c 20 27 61  e 'a', 'a-b', 'a
0d40: 2d 27 2e 20 54 68 69 73 20 66 6f 72 6d 20 69 73  -'. This form is
0d50: 0a 20 20 20 20 23 20 61 63 63 65 70 74 65 64 20  .    # accepted 
0d60: 6f 6e 20 69 6e 70 75 74 2c 20 65 61 73 69 65 72  on input, easier
0d70: 20 74 6f 20 72 65 61 64 20 62 79 20 61 20 75 73   to read by a us
0d80: 65 72 2c 20 61 6e 64 20 6e 6f 20 64 69 66 66 65  er, and no diffe
0d90: 72 65 6e 63 65 0a 20 20 20 20 23 20 74 6f 20 72  rence.    # to r
0da0: 65 67 75 6c 61 72 20 54 63 6c 2e 20 57 65 20 61  egular Tcl. We a
0db0: 64 64 69 74 69 6f 6e 61 6c 6c 79 20 63 6f 6e 76  dditionally conv
0dc0: 65 72 74 20 2d 72 65 71 75 69 72 65 20 6f 70 74  ert -require opt
0dd0: 69 6f 6e 73 20 69 6e 74 6f 0a 20 20 20 20 23 20  ions into.    # 
0de0: 70 6c 61 69 6e 20 6e 6f 6e 2d 6f 70 74 69 6f 6e  plain non-option
0df0: 20 72 65 71 75 69 72 65 6d 65 6e 74 73 20 73 69   requirements si
0e00: 74 74 69 6e 67 20 62 65 74 77 65 65 6e 20 6e 61  tting between na
0e10: 6d 65 20 61 6e 64 20 74 68 65 0a 20 20 20 20 23  me and the.    #
0e20: 20 6f 70 74 69 6f 6e 2f 76 61 6c 75 65 20 70 61   option/value pa
0e30: 72 74 2e 0a 0a 20 20 20 20 73 65 74 20 72 65 73  rt...    set res
0e40: 20 5b 6c 69 6e 64 65 78 20 24 72 65 66 20 30 5d   [lindex $ref 0]
0e50: 0a 0a 20 20 20 20 23 20 4e 6f 6e 2d 6f 70 74 69  ..    # Non-opti
0e60: 6f 6e 20 72 65 71 75 69 72 65 6d 65 6e 74 73 2e  on requirements.
0e70: 0a 0a 20 20 20 20 73 65 74 20 6f 69 64 78 20 31  ..    set oidx 1
0e80: 0a 20 20 20 20 66 6f 72 65 61 63 68 20 76 20 5b  .    foreach v [
0e90: 6c 72 61 6e 67 65 20 24 72 65 66 20 31 20 65 6e  lrange $ref 1 en
0ea0: 64 5d 20 7b 0a 09 23 20 53 63 61 6e 20 75 6e 74  d] {..# Scan unt
0eb0: 69 6c 20 66 69 72 73 74 20 6f 70 74 69 6f 6e 0a  il first option.
0ec0: 09 69 66 20 7b 5b 73 74 72 69 6e 67 20 6d 61 74  .if {[string mat
0ed0: 63 68 20 2d 2a 20 24 76 5d 7d 20 62 72 65 61 6b  ch -* $v]} break
0ee0: 0a 09 69 6e 63 72 20 6f 69 64 78 0a 09 6c 61 70  ..incr oidx..lap
0ef0: 70 65 6e 64 20 72 65 73 20 5b 56 72 65 71 73 74  pend res [Vreqst
0f00: 72 69 6e 67 20 24 76 5d 0a 20 20 20 20 7d 0a 20  ring $v].    }. 
0f10: 20 20 20 73 65 74 20 6f 70 74 69 6f 6e 73 20 5b     set options [
0f20: 6c 72 61 6e 67 65 20 24 72 65 66 20 24 6f 69 64  lrange $ref $oid
0f30: 78 20 65 6e 64 5d 0a 0a 20 20 20 20 23 20 4f 70  x end]..    # Op
0f40: 74 69 6f 6e 20 72 65 71 75 69 72 65 6d 65 6e 74  tion requirement
0f50: 73 20 74 6f 20 6e 6f 6e 2d 6f 70 74 69 6f 6e 20  s to non-option 
0f60: 72 65 71 75 69 72 65 6d 65 6e 74 73 2e 0a 0a 20  requirements... 
0f70: 20 20 20 66 6f 72 65 61 63 68 20 7b 6b 20 76 7d     foreach {k v}
0f80: 20 24 6f 70 74 69 6f 6e 73 20 7b 0a 09 69 66 20   $options {..if 
0f90: 7b 24 6b 20 6e 65 20 22 2d 72 65 71 75 69 72 65  {$k ne "-require
0fa0: 22 7d 20 63 6f 6e 74 69 6e 75 65 0a 09 6c 61 70  "} continue..lap
0fb0: 70 65 6e 64 20 72 65 73 20 5b 56 72 65 71 73 74  pend res [Vreqst
0fc0: 72 69 6e 67 20 24 76 5d 0a 20 20 20 20 7d 0a 0a  ring $v].    }..
0fd0: 20 20 20 20 23 20 41 6c 6c 20 6f 74 68 65 72 20      # All other 
0fe0: 6f 70 74 69 6f 6e 73 2e 0a 0a 20 20 20 20 66 6f  options...    fo
0ff0: 72 65 61 63 68 20 7b 6b 20 76 7d 20 24 6f 70 74  reach {k v} $opt
1000: 69 6f 6e 73 20 7b 0a 09 69 66 20 7b 24 6b 20 65  ions {..if {$k e
1010: 71 20 22 2d 72 65 71 75 69 72 65 22 7d 20 63 6f  q "-require"} co
1020: 6e 74 69 6e 75 65 0a 09 6c 61 70 70 65 6e 64 20  ntinue..lappend 
1030: 72 65 73 20 24 6b 20 24 76 0a 20 20 20 20 7d 0a  res $k $v.    }.
1040: 20 20 20 20 72 65 74 75 72 6e 20 24 72 65 73 0a      return $res.
1050: 7d 0a 0a 23 20 23 20 23 23 20 23 23 23 20 23 23  }..# # ## ### ##
1060: 23 23 23 20 23 23 23 23 23 23 23 23 20 23 23 23  ### ######## ###
1070: 23 23 23 23 23 23 23 23 23 23 20 23 23 23 23 23  ########## #####
1080: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
1090: 0a 23 23 20 49 6e 74 65 72 6e 61 6c 73 0a 0a 70  .## Internals..p
10a0: 72 6f 63 20 3a 3a 6b 65 74 74 6c 65 3a 3a 6d 64  roc ::kettle::md
10b0: 72 65 66 3a 3a 43 6f 6e 73 6c 69 73 74 20 7b 6e  ref::Conslist {n
10c0: 61 6d 65 20 73 70 65 63 7d 20 7b 0a 0a 20 20 20  ame spec} {..   
10d0: 20 23 20 54 68 65 20 63 6f 6e 73 74 72 75 63 74   # The construct
10e0: 6f 72 20 66 6f 72 20 72 65 66 65 72 65 6e 63 65  or for reference
10f0: 73 20 72 65 63 6f 67 6e 69 7a 65 73 20 6e 6f 74  s recognizes not
1100: 20 6f 6e 6c 79 20 74 68 65 20 6f 70 74 69 6f 6e   only the option
1110: 73 0a 20 20 20 20 23 20 66 6f 72 20 74 68 65 20  s.    # for the 
1120: 6e 65 77 65 72 20 73 79 6e 74 61 78 2c 20 62 75  newer syntax, bu
1130: 74 20 61 6c 73 6f 20 66 6f 72 20 74 68 65 20 6e  t also for the n
1140: 65 77 20 73 79 6e 74 61 78 20 28 73 65 65 20 74  ew syntax (see t
1150: 6f 70 20 6f 66 0a 20 20 20 20 23 20 66 69 6c 65  op of.    # file
1160: 29 2e 20 54 68 65 20 6c 61 74 74 65 72 20 61 72  ). The latter ar
1170: 65 20 61 63 63 65 70 74 65 64 20 69 66 20 61 6e  e accepted if an
1180: 64 20 6f 6e 6c 79 20 69 66 20 6e 6f 74 20 6d 69  d only if not mi
1190: 78 65 64 20 77 69 74 68 20 74 68 65 0a 20 20 20  xed with the.   
11a0: 20 23 20 6e 65 77 65 72 20 6f 70 74 69 6f 6e 73   # newer options
11b0: 2c 20 61 6e 64 20 61 72 65 20 63 6f 6e 76 65 72  , and are conver
11c0: 74 65 64 20 6f 6e 20 74 68 65 20 66 6c 79 20 74  ted on the fly t
11d0: 6f 20 74 68 65 20 6e 65 77 65 72 20 73 79 6e 74  o the newer synt
11e0: 61 78 2e 0a 20 20 20 20 23 20 52 65 71 75 69 72  ax..    # Requir
11f0: 65 6d 65 6e 74 73 20 62 65 74 77 65 65 6e 20 6e  ements between n
1200: 61 6d 65 20 61 6e 64 20 6f 70 74 69 6f 6e 73 20  ame and options 
1210: 61 72 65 20 72 65 63 6f 67 6e 69 7a 65 64 20 61  are recognized a
1220: 6e 64 0a 20 20 20 20 23 20 63 6f 6c 6c 65 63 74  nd.    # collect
1230: 65 64 20 61 73 20 77 65 6c 6c 2e 0a 0a 20 20 20  ed as well...   
1240: 20 23 20 41 64 64 69 74 69 6f 6e 61 6c 20 77 6f   # Additional wo
1250: 72 6b 20 64 6f 6e 65 20 62 79 20 74 68 65 20 63  rk done by the c
1260: 6f 6e 73 74 72 75 63 74 6f 72 20 69 73 0a 20 20  onstructor is.  
1270: 20 20 23 20 2d 20 52 65 6d 6f 76 61 6c 20 6f 66    # - Removal of
1280: 20 72 65 64 75 6e 64 61 6e 74 20 73 77 69 74 63   redundant switc
1290: 68 65 73 0a 20 20 20 20 23 20 20 20 40 20 2d 70  hes.    #   @ -p
12a0: 6c 61 74 66 6f 72 6d 2c 20 2d 61 72 63 68 67 6c  latform, -archgl
12b0: 6f 62 2c 20 2d 69 73 20 3d 20 4f 6e 6c 79 20 6c  ob, -is = Only l
12c0: 61 73 74 20 76 61 6c 75 65 20 63 6f 75 6e 74 73  ast value counts
12d0: 2e 0a 20 20 20 20 23 20 20 20 40 20 2d 72 65 71  ..    #   @ -req
12e0: 75 69 72 65 20 20 20 20 20 20 20 20 20 20 20 20  uire            
12f0: 20 20 20 20 20 20 3d 20 4f 6e 6c 79 20 75 6e 69        = Only uni
1300: 71 75 65 20 72 61 6e 67 65 73 2c 20 6e 6f 6e 2d  que ranges, non-
1310: 72 65 64 75 6e 64 61 6e 74 20 72 61 6e 67 65 73  redundant ranges
1320: 0a 20 20 20 20 23 20 2d 20 53 6f 72 74 20 6f 66  .    # - Sort of
1330: 20 73 77 69 74 63 68 65 73 2e 0a 20 20 20 20 23   switches..    #
1340: 20 54 68 69 73 20 67 65 6e 65 72 61 74 65 73 20   This generates 
1350: 61 20 63 61 6e 6f 6e 69 63 61 6c 20 72 65 66 65  a canonical refe
1360: 72 65 6e 63 65 2e 0a 0a 20 20 20 20 23 20 51 75  rence...    # Qu
1370: 69 63 6b 20 72 65 74 75 72 6e 20 69 66 20 72 65  ick return if re
1380: 66 65 72 65 6e 63 65 20 69 73 20 70 6c 61 69 6e  ference is plain
1390: 20 6e 61 6d 65 20 77 69 74 68 6f 75 74 20 73 77   name without sw
13a0: 69 74 63 68 65 73 2e 0a 0a 20 20 20 20 69 66 20  itches...    if 
13b0: 7b 21 5b 6c 6c 65 6e 67 74 68 20 24 73 70 65 63  {![llength $spec
13c0: 5d 7d 20 7b 0a 09 72 65 74 75 72 6e 20 5b 6c 69  ]} {..return [li
13d0: 73 74 20 24 6e 61 6d 65 5d 0a 20 20 20 20 7d 0a  st $name].    }.
13e0: 0a 20 20 20 20 23 20 50 68 61 73 65 20 49 2e 20  .    # Phase I. 
13f0: 54 61 6b 65 20 73 70 65 63 20 61 70 61 72 74 20  Take spec apart 
1400: 69 6e 74 6f 20 72 65 71 75 69 72 65 6d 65 6e 74  into requirement
1410: 73 20 61 6e 64 20 72 65 67 75 6c 61 72 20 73 77  s and regular sw
1420: 69 74 63 68 65 73 2e 0a 0a 20 20 20 20 73 65 74  itches...    set
1430: 20 76 65 72 20 20 20 7b 7d 20 3b 20 73 65 74 20   ver   {} ; set 
1440: 68 61 73 76 65 72 20 20 30 20 3b 20 23 20 44 61  hasver  0 ; # Da
1450: 74 61 20 66 6f 72 20 2d 76 65 72 73 69 6f 6e 2c  ta for -version,
1460: 20 20 66 6c 61 67 20 77 68 65 6e 20 75 73 65 64    flag when used
1470: 2e 0a 20 20 20 20 73 65 74 20 65 78 61 63 74 20  ..    set exact 
1480: 30 20 20 3b 20 73 65 74 20 68 61 73 65 78 20 20  0  ; set hasex  
1490: 20 30 20 3b 20 23 20 44 61 74 61 20 66 6f 72 20   0 ; # Data for 
14a0: 2d 65 78 61 63 74 2c 20 20 20 20 66 6c 61 67 20  -exact,    flag 
14b0: 77 68 65 6e 20 75 73 65 64 2e 0a 20 20 20 20 73  when used..    s
14c0: 65 74 20 70 6c 61 74 20 20 7b 7d 20 3b 20 73 65  et plat  {} ; se
14d0: 74 20 68 61 73 70 6c 61 74 20 30 20 3b 20 23 20  t hasplat 0 ; # 
14e0: 44 61 74 61 20 66 6f 72 20 2d 70 6c 61 74 66 6f  Data for -platfo
14f0: 72 6d 2c 20 66 6c 61 67 20 77 68 65 6e 20 75 73  rm, flag when us
1500: 65 64 2e 0a 20 20 20 20 73 65 74 20 61 67 20 20  ed..    set ag  
1510: 20 20 7b 7d 20 3b 20 73 65 74 20 68 61 73 61 67    {} ; set hasag
1520: 20 20 20 30 20 3b 20 23 20 44 61 74 61 20 66 6f     0 ; # Data fo
1530: 72 20 2d 61 72 63 68 67 6c 6f 62 2c 20 66 6c 61  r -archglob, fla
1540: 67 20 77 68 65 6e 20 75 73 65 64 2e 0a 20 20 20  g when used..   
1550: 20 73 65 74 20 69 73 20 20 20 20 7b 7d 20 3b 20   set is    {} ; 
1560: 73 65 74 20 68 61 73 69 73 20 20 20 30 20 3b 20  set hasis   0 ; 
1570: 23 20 44 61 74 61 20 66 6f 72 20 2d 69 73 2c 20  # Data for -is, 
1580: 20 20 20 20 20 20 66 6c 61 67 20 77 68 65 6e 20        flag when 
1590: 75 73 65 64 2e 0a 0a 20 20 20 20 61 72 72 61 79  used...    array
15a0: 20 73 65 74 20 72 65 71 73 20 7b 7d 0a 0a 20 20   set reqs {}..  
15b0: 20 20 73 65 74 20 6f 69 64 78 20 30 0a 20 20 20    set oidx 0.   
15c0: 20 66 6f 72 65 61 63 68 20 76 20 24 73 70 65 63   foreach v $spec
15d0: 20 7b 0a 09 23 20 53 63 61 6e 20 75 6e 74 69 6c   {..# Scan until
15e0: 20 66 69 72 73 74 20 6f 70 74 69 6f 6e 0a 09 69   first option..i
15f0: 66 20 7b 5b 73 74 72 69 6e 67 20 6d 61 74 63 68  f {[string match
1600: 20 2d 2a 20 24 76 5d 7d 20 62 72 65 61 6b 0a 09   -* $v]} break..
1610: 69 6e 63 72 20 6f 69 64 78 0a 09 73 65 74 20 72  incr oidx..set r
1620: 65 71 73 28 24 76 29 20 2e 0a 20 20 20 20 7d 0a  eqs($v) ..    }.
1630: 0a 20 20 20 20 66 6f 72 65 61 63 68 20 7b 6f 20  .    foreach {o 
1640: 76 7d 20 5b 6c 72 61 6e 67 65 20 24 73 70 65 63  v} [lrange $spec
1650: 20 24 6f 69 64 78 20 65 6e 64 5d 20 7b 0a 09 73   $oidx end] {..s
1660: 77 69 74 63 68 20 2d 65 78 61 63 74 20 2d 2d 20  witch -exact -- 
1670: 24 6f 20 7b 0a 09 20 20 20 20 2d 65 78 61 63 74  $o {..    -exact
1680: 20 20 20 20 7b 73 65 74 20 65 78 61 63 74 20 24      {set exact $
1690: 76 20 3b 20 73 65 74 20 68 61 73 65 78 20 20 20  v ; set hasex   
16a0: 31 7d 0a 09 20 20 20 20 2d 76 65 72 73 69 6f 6e  1}..    -version
16b0: 20 20 7b 73 65 74 20 76 65 72 20 20 20 24 76 20    {set ver   $v 
16c0: 3b 20 73 65 74 20 68 61 73 76 65 72 20 20 31 7d  ; set hasver  1}
16d0: 0a 09 20 20 20 20 2d 70 6c 61 74 66 6f 72 6d 20  ..    -platform 
16e0: 7b 73 65 74 20 70 6c 61 74 20 20 24 76 20 3b 20  {set plat  $v ; 
16f0: 73 65 74 20 68 61 73 70 6c 61 74 20 31 7d 0a 09  set hasplat 1}..
1700: 20 20 20 20 2d 61 72 63 68 67 6c 6f 62 20 7b 73      -archglob {s
1710: 65 74 20 61 67 20 20 20 20 24 76 20 3b 20 73 65  et ag    $v ; se
1720: 74 20 68 61 73 61 67 20 20 20 31 7d 0a 09 20 20  t hasag   1}..  
1730: 20 20 2d 69 73 20 20 20 20 20 20 20 7b 73 65 74    -is       {set
1740: 20 69 73 20 20 20 20 24 76 20 3b 20 73 65 74 20   is    $v ; set 
1750: 68 61 73 69 73 20 20 20 31 7d 0a 09 20 20 20 20  hasis   1}..    
1760: 2d 72 65 71 75 69 72 65 20 20 7b 73 65 74 20 72  -require  {set r
1770: 65 71 73 28 24 76 29 20 2e 7d 0a 09 7d 0a 20 20  eqs($v) .}..}.  
1780: 20 20 7d 0a 0a 20 20 20 20 23 20 50 68 61 73 65    }..    # Phase
1790: 20 49 49 2e 20 56 61 6c 69 64 61 74 65 20 74 68   II. Validate th
17a0: 65 20 69 6e 70 75 74 2c 20 62 61 73 69 63 73 2e  e input, basics.
17b0: 20 43 68 65 63 6b 20 66 6f 72 20 6f 6c 64 20 76   Check for old v
17c0: 73 2e 20 6e 65 77 2c 20 61 6e 64 0a 20 20 20 20  s. new, and.    
17d0: 23 20 76 61 72 69 6f 75 73 20 6f 74 68 65 72 20  # various other 
17e0: 73 69 6d 70 6c 65 20 76 61 6c 69 64 61 74 69 6f  simple validatio
17f0: 6e 73 2e 0a 0a 20 20 20 20 69 66 20 7b 24 68 61  ns...    if {$ha
1800: 73 76 65 72 20 7c 7c 20 24 68 61 73 65 78 7d 20  sver || $hasex} 
1810: 7b 0a 09 69 66 20 7b 5b 61 72 72 61 79 20 73 69  {..if {[array si
1820: 7a 65 20 72 65 71 73 5d 7d 20 7b 0a 09 20 20 20  ze reqs]} {..   
1830: 20 72 65 74 75 72 6e 20 2d 63 6f 64 65 20 65 72   return -code er
1840: 72 6f 72 20 22 43 61 6e 6e 6f 74 20 6d 69 78 20  ror "Cannot mix 
1850: 6f 6c 64 20 61 6e 64 20 6e 65 77 20 73 74 79 6c  old and new styl
1860: 65 20 76 65 72 73 69 6f 6e 20 72 65 71 75 69 72  e version requir
1870: 65 6d 65 6e 74 73 22 0a 09 7d 0a 0a 09 23 20 2d  ements"..}...# -
1880: 65 78 61 63 74 20 69 6d 70 6c 69 65 73 20 2d 76  exact implies -v
1890: 65 72 73 69 6f 6e 0a 09 69 66 20 7b 24 68 61 73  ersion..if {$has
18a0: 65 78 20 26 26 20 21 24 68 61 73 76 65 72 7d 20  ex && !$hasver} 
18b0: 7b 0a 09 20 20 20 20 72 65 74 75 72 6e 20 2d 63  {..    return -c
18c0: 6f 64 65 20 65 72 72 6f 72 20 22 2d 65 78 61 63  ode error "-exac
18d0: 74 20 77 69 74 68 6f 75 74 20 2d 76 65 72 73 69  t without -versi
18e0: 6f 6e 22 0a 09 7d 0a 0a 09 69 66 20 7b 24 68 61  on"..}...if {$ha
18f0: 73 65 78 20 26 26 20 21 5b 73 74 72 69 6e 67 20  sex && ![string 
1900: 69 73 20 62 6f 6f 6c 65 61 6e 20 2d 73 74 72 69  is boolean -stri
1910: 63 74 20 24 65 78 61 63 74 5d 7d 20 7b 0a 09 20  ct $exact]} {.. 
1920: 20 20 20 72 65 74 75 72 6e 20 2d 63 6f 64 65 20     return -code 
1930: 65 72 72 6f 72 20 22 45 78 70 65 63 74 65 64 20  error "Expected 
1940: 62 6f 6f 6c 65 61 6e 20 66 6f 72 20 2d 65 78 61  boolean for -exa
1950: 63 74 2c 20 62 75 74 20 67 6f 74 20 5c 22 24 76  ct, but got \"$v
1960: 5c 22 22 0a 09 7d 0a 09 69 66 20 7b 24 68 61 73  \""..}..if {$has
1970: 76 65 72 20 26 26 20 21 5b 56 76 61 6c 69 64 20  ver && ![Vvalid 
1980: 24 76 65 72 20 6d 65 73 73 61 67 65 5d 7d 20 7b  $ver message]} {
1990: 0a 09 20 20 20 20 72 65 74 75 72 6e 20 2d 63 6f  ..    return -co
19a0: 64 65 20 65 72 72 6f 72 20 24 6d 65 73 73 61 67  de error $messag
19b0: 65 0a 09 7d 0a 0a 09 23 20 54 72 61 6e 73 6c 61  e..}...# Transla
19c0: 74 65 20 74 6f 20 6e 65 77 20 66 6f 72 6d 2e 0a  te to new form..
19d0: 0a 09 6c 61 70 70 65 6e 64 20 69 74 65 6d 20 24  ..lappend item $
19e0: 76 65 72 0a 09 69 66 20 7b 24 65 78 61 63 74 7d  ver..if {$exact}
19f0: 20 7b 0a 09 20 20 20 20 6c 61 70 70 65 6e 64 20   {..    lappend 
1a00: 69 74 65 6d 20 5b 56 6e 65 78 74 20 24 76 65 72  item [Vnext $ver
1a10: 5d 0a 09 7d 20 65 6c 73 65 20 7b 0a 09 20 20 20  ]..} else {..   
1a20: 20 23 20 43 61 70 20 61 74 20 6e 65 78 74 20 6d   # Cap at next m
1a30: 61 6a 6f 72 20 76 65 72 73 69 6f 6e 2e 0a 09 20  ajor version... 
1a40: 20 20 20 23 20 2d 76 65 72 73 69 6f 6e 20 38 20     # -version 8 
1a50: 20 20 3d 3e 20 38 2d 39 0a 09 20 20 20 20 23 20    => 8-9..    # 
1a60: 2d 76 65 72 73 69 6f 6e 20 38 2e 34 20 3d 3e 20  -version 8.4 => 
1a70: 38 2e 34 2d 39 0a 0a 09 20 20 20 20 6c 61 70 70  8.4-9...    lapp
1a80: 65 6e 64 20 69 74 65 6d 20 5b 65 78 70 72 20 7b  end item [expr {
1a90: 5b 6c 69 6e 64 65 78 20 5b 73 70 6c 69 74 20 24  [lindex [split $
1aa0: 76 65 72 20 2e 5d 20 30 5d 2b 31 7d 5d 0a 09 7d  ver .] 0]+1}]..}
1ab0: 0a 09 73 65 74 20 72 65 71 73 28 24 69 74 65 6d  ..set reqs($item
1ac0: 29 20 2e 0a 20 20 20 20 7d 0a 0a 20 20 20 20 69  ) ..    }..    i
1ad0: 66 20 7b 24 68 61 73 69 73 7d 20 7b 0a 09 73 65  f {$hasis} {..se
1ae0: 74 20 69 73 20 5b 73 74 72 69 6e 67 20 74 6f 6c  t is [string tol
1af0: 6f 77 65 72 20 24 69 73 5d 0a 09 69 66 20 7b 21  ower $is]..if {!
1b00: 5b 45 76 61 6c 69 64 20 24 69 73 20 6d 65 73 73  [Evalid $is mess
1b10: 61 67 65 5d 7d 20 7b 0a 09 20 20 20 20 72 65 74  age]} {..    ret
1b20: 75 72 6e 20 2d 63 6f 64 65 20 65 72 72 6f 72 20  urn -code error 
1b30: 24 6d 65 73 73 61 67 65 0a 09 7d 0a 20 20 20 20  $message..}.    
1b40: 7d 0a 0a 20 20 20 20 23 20 50 68 61 73 65 20 49  }..    # Phase I
1b50: 49 49 2e 20 47 65 74 20 6f 76 65 72 20 74 68 65  II. Get over the
1b60: 20 72 65 71 75 69 72 65 6d 65 6e 74 73 20 61 6e   requirements an
1b70: 64 20 72 65 6d 6f 76 65 20 72 65 64 75 6e 64 61  d remove redunda
1b80: 6e 74 0a 20 20 20 20 23 20 72 61 6e 67 65 73 2e  nt.    # ranges.
1b90: 20 56 61 6c 69 64 61 74 65 20 74 68 65 6d 20 66   Validate them f
1ba0: 69 72 73 74 2e 20 49 66 20 74 68 65 72 65 20 69  irst. If there i
1bb0: 73 20 6f 6e 6c 79 20 6f 6e 65 20 72 61 6e 67 65  s only one range
1bc0: 20 69 74 0a 20 20 20 20 23 20 63 61 6e 6e 6f 74   it.    # cannot
1bd0: 20 62 65 20 72 65 64 75 6e 64 61 6e 74 2e 0a 0a   be redundant...
1be0: 20 20 20 20 69 66 20 7b 5b 61 72 72 61 79 20 73      if {[array s
1bf0: 69 7a 65 20 72 65 71 73 5d 7d 20 7b 0a 09 66 6f  ize reqs]} {..fo
1c00: 72 65 61 63 68 20 72 65 71 20 5b 61 72 72 61 79  reach req [array
1c10: 20 6e 61 6d 65 73 20 72 65 71 73 5d 20 7b 0a 09   names reqs] {..
1c20: 20 20 20 20 56 72 65 71 63 68 65 63 6b 20 24 72      Vreqcheck $r
1c30: 65 71 0a 09 20 20 20 20 23 20 54 72 61 6e 73 6c  eq..    # Transl
1c40: 61 74 65 20 58 2d 59 20 66 6f 72 6d 73 20 69 6e  ate X-Y forms in
1c50: 74 6f 20 74 68 65 20 6c 69 73 74 20 66 6f 72 6d  to the list form
1c60: 20 66 6f 72 20 61 6c 6c 20 69 6e 74 65 72 6e 61   for all interna
1c70: 6c 20 75 73 65 0a 09 20 20 20 20 69 66 20 7b 5b  l use..    if {[
1c80: 73 74 72 69 6e 67 20 6d 61 74 63 68 20 2a 2d 2a  string match *-*
1c90: 20 24 72 65 71 5d 7d 20 7b 0a 09 09 73 65 74 20   $req]} {...set 
1ca0: 72 78 20 5b 73 70 6c 69 74 20 24 72 65 71 20 2d  rx [split $req -
1cb0: 5d 0a 09 09 75 6e 73 65 74 20 72 65 71 73 28 24  ]...unset reqs($
1cc0: 72 65 71 29 0a 09 09 73 65 74 20 72 65 71 73 28  req)...set reqs(
1cd0: 24 72 78 29 20 2e 0a 09 20 20 20 20 7d 0a 09 7d  $rx) ...    }..}
1ce0: 0a 0a 09 69 66 20 7b 5b 61 72 72 61 79 20 73 69  ...if {[array si
1cf0: 7a 65 20 72 65 71 73 5d 20 3e 20 31 7d 20 7b 0a  ze reqs] > 1} {.
1d00: 09 20 20 20 20 66 6f 72 65 61 63 68 20 72 65 71  .    foreach req
1d10: 20 5b 61 72 72 61 79 20 6e 61 6d 65 73 20 72 65   [array names re
1d20: 71 73 5d 20 7b 0a 09 09 66 6f 72 65 61 63 68 20  qs] {...foreach 
1d30: 6f 74 68 65 72 20 5b 61 72 72 61 79 20 6e 61 6d  other [array nam
1d40: 65 73 20 72 65 71 73 5d 20 7b 0a 09 09 20 20 20  es reqs] {...   
1d50: 20 23 20 49 67 6e 6f 72 65 20 73 65 6c 66 2e 0a   # Ignore self..
1d60: 09 09 20 20 20 20 69 66 20 7b 24 6f 74 68 65 72  ..    if {$other
1d70: 20 65 71 20 24 72 65 71 7d 20 63 6f 6e 74 69 6e   eq $req} contin
1d80: 75 65 0a 09 09 20 20 20 20 69 66 20 7b 5b 53 75  ue...    if {[Su
1d90: 62 73 65 74 20 24 72 65 71 20 24 6f 74 68 65 72  bset $req $other
1da0: 5d 7d 20 7b 0a 09 09 09 75 6e 73 65 74 20 72 65  ]} {....unset re
1db0: 71 73 28 24 72 65 71 29 0a 09 09 09 62 72 65 61  qs($req)....brea
1dc0: 6b 0a 09 09 20 20 20 20 7d 0a 09 09 7d 0a 09 20  k...    }...}.. 
1dd0: 20 20 20 7d 0a 09 7d 0a 20 20 20 20 7d 0a 0a 20     }..}.    }.. 
1de0: 20 20 20 23 20 50 68 61 73 65 20 49 56 2e 20 50     # Phase IV. P
1df0: 75 74 20 74 68 65 20 70 69 65 63 65 73 20 62 61  ut the pieces ba
1e00: 63 6b 20 74 6f 67 65 74 68 65 72 20 74 6f 20 67  ck together to g
1e10: 65 74 20 74 68 65 20 63 61 6e 6f 6e 69 63 61 6c  et the canonical
1e20: 0a 20 20 20 20 23 20 66 6f 72 6d 2e 20 57 68 69  .    # form. Whi
1e30: 63 68 20 63 6f 6e 74 61 69 6e 73 20 65 76 65 72  ch contains ever
1e40: 79 20 72 65 71 75 69 72 65 6d 65 6e 74 20 69 6e  y requirement in
1e50: 20 6f 70 74 69 6f 6e 20 66 6f 72 6d 2e 0a 0a 20   option form... 
1e60: 20 20 20 73 65 74 20 72 65 66 20 5b 6c 69 73 74     set ref [list
1e70: 20 24 6e 61 6d 65 5d 0a 20 20 20 20 69 66 20 7b   $name].    if {
1e80: 24 68 61 73 69 73 7d 20 20 20 7b 6c 61 70 70 65  $hasis}   {lappe
1e90: 6e 64 20 72 65 66 20 2d 69 73 20 24 69 73 7d 0a  nd ref -is $is}.
1ea0: 20 20 20 20 69 66 20 7b 24 68 61 73 61 67 7d 20      if {$hasag} 
1eb0: 20 20 7b 6c 61 70 70 65 6e 64 20 72 65 66 20 2d    {lappend ref -
1ec0: 61 72 63 68 67 6c 6f 62 20 24 61 67 7d 0a 20 20  archglob $ag}.  
1ed0: 20 20 69 66 20 7b 24 68 61 73 70 6c 61 74 7d 20    if {$hasplat} 
1ee0: 7b 6c 61 70 70 65 6e 64 20 72 65 66 20 2d 70 6c  {lappend ref -pl
1ef0: 61 74 66 6f 72 6d 20 24 70 6c 61 74 7d 0a 0a 20  atform $plat}.. 
1f00: 20 20 20 69 66 20 7b 5b 61 72 72 61 79 20 73 69     if {[array si
1f10: 7a 65 20 72 65 71 73 5d 7d 20 7b 0a 09 66 6f 72  ze reqs]} {..for
1f20: 65 61 63 68 20 72 65 71 20 5b 6c 73 6f 72 74 20  each req [lsort 
1f30: 2d 64 69 63 74 20 5b 61 72 72 61 79 20 6e 61 6d  -dict [array nam
1f40: 65 73 20 72 65 71 73 5d 5d 20 7b 0a 09 20 20 20  es reqs]] {..   
1f50: 20 6c 61 70 70 65 6e 64 20 72 65 66 20 2d 72 65   lappend ref -re
1f60: 71 75 69 72 65 20 24 72 65 71 0a 09 7d 0a 20 20  quire $req..}.  
1f70: 20 20 7d 0a 0a 20 20 20 20 23 20 4e 6f 20 76 61    }..    # No va
1f80: 6c 69 64 61 74 69 6f 6e 20 72 65 71 75 69 72 65  lidation require
1f90: 64 2c 20 77 65 20 6b 6e 6f 77 20 74 68 61 74 20  d, we know that 
1fa0: 74 68 65 20 72 65 73 75 6c 74 20 69 73 20 6f 6b  the result is ok
1fb0: 2e 20 57 65 0a 20 20 20 20 23 20 63 68 65 63 6b  . We.    # check
1fc0: 65 64 20 61 6c 6c 20 74 68 65 20 69 6e 70 75 74  ed all the input
1fd0: 73 20 69 6e 20 74 68 65 20 73 61 6d 65 20 6d 61  s in the same ma
1fe0: 6e 6e 65 72 20 61 73 20 74 68 65 20 76 61 6c 69  nner as the vali
1ff0: 64 61 74 6f 72 2e 0a 0a 20 20 20 20 72 65 74 75  dator...    retu
2000: 72 6e 20 24 72 65 66 0a 7d 0a 0a 70 72 6f 63 20  rn $ref.}..proc 
2010: 3a 3a 6b 65 74 74 6c 65 3a 3a 6d 64 72 65 66 3a  ::kettle::mdref:
2020: 3a 53 75 62 73 65 74 20 7b 61 20 62 7d 20 7b 0a  :Subset {a b} {.
2030: 20 20 20 20 23 20 52 65 74 75 72 6e 73 20 74 72      # Returns tr
2040: 75 65 20 69 66 20 74 68 65 20 72 65 71 75 69 72  ue if the requir
2050: 65 6d 65 6e 74 20 41 20 69 73 20 61 20 74 72 75  ement A is a tru
2060: 65 20 73 75 62 73 65 74 20 6f 66 20 72 65 71 75  e subset of requ
2070: 69 72 65 6d 65 6e 74 20 42 2e 0a 0a 20 20 20 20  irement B...    
2080: 23 20 31 20 20 41 20 3d 20 76 41 20 20 20 20 20  # 1  A = vA     
2090: 20 20 20 20 20 20 20 42 20 3d 20 76 42 0a 20 20         B = vB.  
20a0: 20 20 23 20 32 20 20 41 20 3d 20 76 41 20 2d 20    # 2  A = vA - 
20b0: 20 20 20 20 20 20 20 20 20 42 20 3d 20 76 42 20           B = vB 
20c0: 2d 0a 20 20 20 20 23 20 33 20 20 41 20 3d 20 76  -.    # 3  A = v
20d0: 41 6d 69 6e 20 76 41 6d 61 78 20 20 20 42 20 3d  Amin vAmax   B =
20e0: 20 76 42 6d 69 6e 20 76 42 6d 61 78 0a 0a 20 20   vBmin vBmax..  
20f0: 20 20 23 20 33 20 63 61 73 65 73 20 70 65 72 20    # 3 cases per 
2100: 41 20 61 6e 64 20 42 2c 20 66 6f 72 20 61 20 74  A and B, for a t
2110: 6f 74 61 6c 20 6f 66 20 39 20 63 6f 6d 62 69 6e  otal of 9 combin
2120: 61 74 69 6f 6e 73 2e 0a 0a 20 20 20 20 23 20 54  ations...    # T
2130: 68 69 73 20 63 61 6e 20 62 65 20 72 65 64 75 63  his can be reduc
2140: 65 64 20 62 79 20 72 65 63 6f 67 6e 69 7a 69 6e  ed by recognizin
2150: 67 20 74 68 61 74 20 28 31 29 20 69 73 20 61 63  g that (1) is ac
2160: 74 75 61 6c 6c 79 20 28 33 29 2c 0a 20 20 20 20  tually (3),.    
2170: 23 20 77 69 74 68 20 74 68 65 20 6d 61 78 20 76  # with the max v
2180: 61 6c 75 65 20 69 6d 70 6c 69 65 64 2c 20 69 2e  alue implied, i.
2190: 65 2e 20 64 65 72 69 76 65 64 20 66 72 6f 6d 20  e. derived from 
21a0: 74 68 65 20 6d 69 6e 20 76 61 6c 75 65 2e 0a 20  the min value.. 
21b0: 20 20 20 23 20 54 68 69 73 20 72 65 64 75 63 65     # This reduce
21c0: 73 20 74 68 65 20 73 69 74 75 61 74 69 6f 6e 20  s the situation 
21d0: 74 6f 20 66 6f 75 72 20 63 6f 6d 62 69 6e 61 74  to four combinat
21e0: 69 6f 6e 73 2e 0a 0a 20 20 20 20 73 65 74 20 61  ions...    set a
21f0: 20 5b 52 74 79 70 65 20 24 61 20 6d 69 6e 61 20   [Rtype $a mina 
2200: 6d 61 78 61 5d 0a 20 20 20 20 73 65 74 20 62 20  maxa].    set b 
2210: 5b 52 74 79 70 65 20 24 62 20 6d 69 6e 62 20 6d  [Rtype $b minb m
2220: 61 78 62 5d 0a 0a 20 20 20 20 23 20 32 32 2c 20  axb]..    # 22, 
2230: 33 32 20 61 72 65 20 6f 6e 65 20 63 61 73 65 2c  32 are one case,
2240: 20 74 68 65 79 20 68 61 76 65 20 74 68 65 20 73   they have the s
2250: 61 6d 65 20 63 6f 6e 64 69 74 69 6f 6e 20 74 6f  ame condition to
2260: 20 63 68 65 63 6b 2e 20 53 65 65 20 62 65 6c 6f   check. See belo
2270: 77 2e 0a 20 20 20 20 23 23 0a 20 20 20 20 23 20  w..    ##.    # 
2280: 32 32 20 3a 0a 20 20 20 20 23 20 41 20 61 6e 64  22 :.    # A and
2290: 20 42 20 61 72 65 20 72 61 6e 67 65 73 20 66 72   B are ranges fr
22a0: 6f 6d 20 61 20 6d 69 6e 69 6d 75 6d 20 74 6f 20  om a minimum to 
22b0: 69 6e 66 69 6e 69 74 79 2e 0a 20 20 20 20 23 20  infinity..    # 
22c0: 54 68 65 20 72 61 6e 67 65 20 77 69 74 68 20 74  The range with t
22d0: 68 65 20 6c 61 72 67 65 72 20 6d 69 6e 69 6d 75  he larger minimu
22e0: 6d 20 69 73 20 74 68 65 20 74 72 75 65 20 73 75  m is the true su
22f0: 62 73 65 74 2e 0a 20 20 20 20 23 20 54 68 69 73  bset..    # This
2300: 20 69 6d 70 6c 69 65 73 3a 20 41 20 69 73 20 61   implies: A is a
2310: 20 74 72 75 65 20 73 75 62 73 65 74 20 6f 66 20   true subset of 
2320: 42 20 69 66 66 20 6d 69 6e 41 20 3e 20 6d 69 6e  B iff minA > min
2330: 42 2e 20 2a 2a 20 73 61 6d 65 0a 20 20 20 20 23  B. ** same.    #
2340: 23 0a 20 20 20 20 23 20 33 32 20 3a 0a 20 20 20  #.    # 32 :.   
2350: 20 23 20 41 20 69 73 20 6d 69 6e 20 74 6f 20 61   # A is min to a
2360: 20 6d 61 78 2c 20 20 20 20 69 2e 65 2e 20 6f 66   max,    i.e. of
2370: 20 66 69 6e 69 74 65 20 73 69 7a 65 2e 0a 20 20   finite size..  
2380: 20 20 23 20 42 20 69 73 20 6d 69 6e 20 74 6f 20    # B is min to 
2390: 69 6e 66 69 6e 69 74 79 2c 20 69 2e 65 2e 20 6f  infinity, i.e. o
23a0: 66 20 69 6e 66 69 6e 69 74 65 20 73 69 7a 65 2e  f infinite size.
23b0: 0a 20 20 20 20 23 20 54 68 69 73 20 69 6d 70 6c  .    # This impl
23c0: 69 65 73 3a 20 41 20 69 73 20 61 20 74 72 75 65  ies: A is a true
23d0: 20 73 75 62 73 65 74 20 69 66 66 20 6d 69 6e 41   subset iff minA
23e0: 20 3e 20 6d 69 6e 42 2e 20 20 20 20 20 20 2a 2a   > minB.      **
23f0: 20 73 61 6d 65 0a 20 20 20 20 23 23 0a 20 20 20   same.    ##.   
2400: 20 23 20 32 33 20 3a 0a 20 20 20 20 23 20 41 20   # 23 :.    # A 
2410: 69 73 20 6d 69 6e 20 74 6f 20 69 6e 66 69 6e 69  is min to infini
2420: 74 79 2c 20 69 2e 65 2e 20 6f 66 20 69 6e 66 69  ty, i.e. of infi
2430: 6e 69 74 65 20 73 69 7a 65 2e 0a 20 20 20 20 23  nite size..    #
2440: 20 42 20 69 73 20 6d 69 6e 20 74 6f 20 61 20 6d   B is min to a m
2450: 61 78 2c 20 20 20 20 69 2e 65 2e 20 6f 66 20 66  ax,    i.e. of f
2460: 69 6e 69 74 65 20 73 69 7a 65 2e 0a 20 20 20 20  inite size..    
2470: 23 20 41 6e 20 69 6e 66 69 6e 69 74 65 20 73 75  # An infinite su
2480: 62 73 65 74 20 6f 66 20 61 20 66 69 6e 69 74 65  bset of a finite
2490: 20 73 65 74 20 69 73 20 6e 6f 74 20 70 6f 73 73   set is not poss
24a0: 69 62 6c 65 2e 0a 20 20 20 20 23 20 54 68 69 73  ible..    # This
24b0: 20 69 6d 70 6c 69 65 73 3a 20 41 20 69 73 20 6e   implies: A is n
24c0: 6f 74 20 61 20 74 72 75 65 20 73 75 62 73 65 74  ot a true subset
24d0: 20 6f 66 20 42 0a 20 20 20 20 23 23 0a 20 20 20   of B.    ##.   
24e0: 20 23 20 33 33 20 3a 0a 20 20 20 20 23 20 42 6f   # 33 :.    # Bo
24f0: 74 68 20 41 20 61 6e 64 20 42 20 61 72 65 20 66  th A and B are f
2500: 69 6e 69 74 65 20 72 61 6e 67 65 73 2e 20 41 20  inite ranges. A 
2510: 69 73 20 61 20 74 72 75 65 20 73 75 62 73 65 74  is a true subset
2520: 20 6f 66 20 42 20 69 66 66 0a 20 20 20 20 23 20   of B iff.    # 
2530: 28 6d 69 6e 41 20 3e 20 20 6d 69 6e 42 29 20 26  (minA >  minB) &
2540: 26 20 28 6d 61 78 41 20 3c 3d 20 6d 61 78 42 29  & (maxA <= maxB)
2550: 20 6f 72 0a 20 20 20 20 23 20 28 6d 69 6e 41 20   or.    # (minA 
2560: 3e 3d 20 6d 69 6e 42 29 20 26 26 20 28 6d 61 78  >= minB) && (max
2570: 41 20 3c 20 20 6d 61 78 42 29 0a 0a 20 20 20 20  A <  maxB)..    
2580: 73 77 69 74 63 68 20 2d 65 78 61 63 74 20 2d 2d  switch -exact --
2590: 20 24 61 24 62 20 7b 0a 09 32 32 20 2d 0a 09 33   $a$b {..22 -..3
25a0: 32 20 7b 72 65 74 75 72 6e 20 5b 65 78 70 72 20  2 {return [expr 
25b0: 7b 5b 70 61 63 6b 61 67 65 20 76 63 6f 6d 70 61  {[package vcompa
25c0: 72 65 20 24 6d 69 6e 61 20 24 6d 69 6e 62 5d 20  re $mina $minb] 
25d0: 3e 20 30 7d 5d 7d 0a 09 32 33 20 7b 72 65 74 75  > 0}]}..23 {retu
25e0: 72 6e 20 30 7d 0a 09 33 33 20 7b 72 65 74 75 72  rn 0}..33 {retur
25f0: 6e 20 5b 65 78 70 72 20 7b 0a 09 09 09 20 20 28  n [expr {....  (
2600: 28 5b 70 61 63 6b 61 67 65 20 76 63 6f 6d 70 61  ([package vcompa
2610: 72 65 20 24 6d 69 6e 61 20 24 6d 69 6e 62 5d 20  re $mina $minb] 
2620: 3e 20 20 30 29 20 26 26 0a 09 09 09 20 20 20 28  >  0) &&....   (
2630: 5b 70 61 63 6b 61 67 65 20 76 63 6f 6d 70 61 72  [package vcompar
2640: 65 20 24 6d 61 78 61 20 24 6d 61 78 62 5d 20 3c  e $maxa $maxb] <
2650: 3d 20 30 29 29 20 7c 7c 0a 09 09 09 20 20 28 28  = 0)) ||....  ((
2660: 5b 70 61 63 6b 61 67 65 20 76 63 6f 6d 70 61 72  [package vcompar
2670: 65 20 24 6d 69 6e 61 20 24 6d 69 6e 62 5d 20 3e  e $mina $minb] >
2680: 3d 20 30 29 20 26 26 0a 09 09 09 20 20 20 28 5b  = 0) &&....   ([
2690: 70 61 63 6b 61 67 65 20 76 63 6f 6d 70 61 72 65  package vcompare
26a0: 20 24 6d 61 78 61 20 24 6d 61 78 62 5d 20 3c 20   $maxa $maxb] < 
26b0: 20 30 29 29 0a 09 09 20 20 20 20 20 20 7d 5d 7d   0))...      }]}
26c0: 0a 20 20 20 20 7d 0a 7d 0a 0a 70 72 6f 63 20 3a  .    }.}..proc :
26d0: 3a 6b 65 74 74 6c 65 3a 3a 6d 64 72 65 66 3a 3a  :kettle::mdref::
26e0: 52 74 79 70 65 20 7b 61 20 6d 69 6e 76 20 6d 61  Rtype {a minv ma
26f0: 78 76 7d 20 7b 0a 20 20 20 20 75 70 76 61 72 20  xv} {.    upvar 
2700: 31 20 24 6d 69 6e 76 20 6d 69 6e 20 24 6d 61 78  1 $minv min $max
2710: 76 20 6d 61 78 0a 0a 20 20 20 20 69 66 20 7b 5b  v max..    if {[
2720: 6c 6c 65 6e 67 74 68 20 24 61 5d 20 3d 3d 20 31  llength $a] == 1
2730: 7d 20 7b 0a 09 23 20 28 31 29 2c 20 6d 61 6b 65  } {..# (1), make
2740: 20 69 74 20 61 20 28 33 29 0a 09 73 65 74 20 6d   it a (3)..set m
2750: 69 6e 20 20 20 5b 6c 69 6e 64 65 78 20 24 61 20  in   [lindex $a 
2760: 30 5d 0a 09 73 65 74 20 6d 61 6a 6f 72 20 5b 6c  0]..set major [l
2770: 69 6e 64 65 78 20 5b 73 70 6c 69 74 20 24 6d 69  index [split $mi
2780: 6e 20 2e 5d 20 30 5d 0a 09 73 65 74 20 6d 61 78  n .] 0]..set max
2790: 20 20 20 24 6d 61 6a 6f 72 0a 09 23 20 42 75 67     $major..# Bug
27a0: 20 36 37 31 38 36 0a 09 69 6e 63 72 20 6d 61 78   67186..incr max
27b0: 0a 09 72 65 74 75 72 6e 20 33 0a 20 20 20 20 7d  ..return 3.    }
27c0: 20 65 6c 73 65 20 7b 0a 09 23 20 28 6c 6c 65 6e   else {..# (llen
27d0: 67 74 68 20 61 20 3d 3d 20 32 29 0a 09 23 20 28  gth a == 2)..# (
27e0: 32 29 2c 20 28 33 29 0a 09 66 6f 72 65 61 63 68  2), (3)..foreach
27f0: 20 7b 6d 69 6e 20 6d 61 78 7d 20 24 61 20 62 72   {min max} $a br
2800: 65 61 6b 0a 09 72 65 74 75 72 6e 20 5b 65 78 70  eak..return [exp
2810: 72 20 7b 24 6d 61 78 20 65 71 20 22 22 20 3f 20  r {$max eq "" ? 
2820: 32 20 3a 20 33 7d 5d 0a 20 20 20 20 7d 0a 7d 0a  2 : 3}].    }.}.
2830: 0a 70 72 6f 63 20 3a 3a 6b 65 74 74 6c 65 3a 3a  .proc ::kettle::
2840: 6d 64 72 65 66 3a 3a 45 76 61 6c 69 64 20 7b 65  mdref::Evalid {e
2850: 20 7b 6d 76 20 7b 7d 7d 7d 20 7b 0a 20 20 20 20   {mv {}}} {.    
2860: 76 61 72 69 61 62 6c 65 20 6e 61 6d 65 0a 20 20  variable name.  
2870: 20 20 69 66 20 7b 24 6d 76 20 6e 65 20 22 22 7d    if {$mv ne ""}
2880: 20 7b 75 70 76 61 72 20 31 20 24 6d 76 20 6d 65   {upvar 1 $mv me
2890: 73 73 61 67 65 7d 0a 0a 20 20 20 20 73 65 74 20  ssage}..    set 
28a0: 65 78 20 5b 73 74 72 69 6e 67 20 74 6f 6c 6f 77  ex [string tolow
28b0: 65 72 20 24 65 5d 0a 20 20 20 20 73 65 74 20 6f  er $e].    set o
28c0: 6b 20 5b 65 78 70 72 20 7b 24 78 20 69 6e 20 7b  k [expr {$x in {
28d0: 70 61 63 6b 61 67 65 20 61 70 70 6c 69 63 61 74  package applicat
28e0: 69 6f 6e 7d 7d 5d 20 20 20 20 0a 0a 20 20 20 20  ion}}]    ..    
28f0: 69 66 20 7b 21 24 6f 6b 7d 20 7b 0a 09 73 65 74  if {!$ok} {..set
2900: 20 6d 65 73 73 61 67 65 20 22 55 6e 6b 6e 6f 77   message "Unknow
2910: 6e 20 65 6e 74 69 74 79 20 74 79 70 65 20 5c 22  n entity type \"
2920: 24 65 5c 22 2c 20 65 78 70 65 63 74 65 64 20 61  $e\", expected a
2930: 70 70 6c 69 63 61 74 69 6f 6e 2c 20 6f 72 20 70  pplication, or p
2940: 61 63 6b 61 67 65 22 0a 20 20 20 20 7d 0a 20 20  ackage".    }.  
2950: 20 20 72 65 74 75 72 6e 20 24 6f 6b 0a 7d 0a 0a    return $ok.}..
2960: 0a 70 72 6f 63 20 3a 3a 6b 65 74 74 6c 65 3a 3a  .proc ::kettle::
2970: 6d 64 72 65 66 3a 3a 56 72 65 71 63 68 65 63 6b  mdref::Vreqcheck
2980: 20 7b 72 65 71 7d 20 7b 0a 20 20 20 20 69 66 20   {req} {.    if 
2990: 7b 21 5b 56 72 65 71 76 61 6c 69 64 20 24 72 65  {![Vreqvalid $re
29a0: 71 20 6d 65 73 73 61 67 65 5d 7d 20 7b 72 65 74  q message]} {ret
29b0: 75 72 6e 20 2d 63 6f 64 65 20 65 72 72 6f 72 20  urn -code error 
29c0: 24 6d 65 73 73 61 67 65 7d 0a 7d 0a 0a 70 72 6f  $message}.}..pro
29d0: 63 20 3a 3a 6b 65 74 74 6c 65 3a 3a 6d 64 72 65  c ::kettle::mdre
29e0: 66 3a 3a 56 72 65 71 76 61 6c 69 64 20 7b 72 65  f::Vreqvalid {re
29f0: 71 20 7b 6d 76 20 7b 7d 7d 7d 20 7b 0a 20 20 20  q {mv {}}} {.   
2a00: 20 69 66 20 7b 24 6d 76 20 6e 65 20 22 22 7d 20   if {$mv ne ""} 
2a10: 7b 75 70 76 61 72 20 31 20 24 6d 76 20 6d 65 73  {upvar 1 $mv mes
2a20: 73 61 67 65 7d 0a 0a 20 20 20 20 69 66 20 7b 5b  sage}..    if {[
2a30: 73 74 72 69 6e 67 20 6d 61 74 63 68 20 2a 2d 2a  string match *-*
2a40: 20 24 72 65 71 5d 7d 20 7b 0a 09 73 65 74 20 72   $req]} {..set r
2a50: 78 20 5b 73 70 6c 69 74 20 24 72 65 71 20 2d 5d  x [split $req -]
2a60: 0a 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a 09 73  .    } else {..s
2a70: 65 74 20 72 78 20 24 72 65 71 0a 20 20 20 20 7d  et rx $req.    }
2a80: 0a 20 20 20 20 69 66 20 7b 5b 6c 6c 65 6e 67 74  .    if {[llengt
2a90: 68 20 24 72 78 5d 20 3d 3d 20 31 7d 20 7b 0a 09  h $rx] == 1} {..
2aa0: 69 66 20 7b 21 5b 76 61 6c 69 64 20 5b 6c 69 6e  if {![valid [lin
2ab0: 64 65 78 20 24 72 78 20 30 5d 20 6d 65 73 73 61  dex $rx 0] messa
2ac0: 67 65 5d 7d 20 7b 72 65 74 75 72 6e 20 30 7d 0a  ge]} {return 0}.
2ad0: 20 20 20 20 7d 20 65 6c 73 65 69 66 20 7b 5b 6c      } elseif {[l
2ae0: 6c 65 6e 67 74 68 20 24 72 78 5d 20 3d 3d 20 32  length $rx] == 2
2af0: 7d 20 7b 0a 09 66 6f 72 65 61 63 68 20 7b 6d 69  } {..foreach {mi
2b00: 6e 20 6d 61 78 7d 20 24 72 78 20 62 72 65 61 6b  n max} $rx break
2b10: 0a 09 69 66 20 7b 21 5b 76 61 6c 69 64 20 24 6d  ..if {![valid $m
2b20: 69 6e 20 6d 65 73 73 61 67 65 5d 7d 20 20 20 20  in message]}    
2b30: 20 20 20 20 20 20 20 20 20 20 20 20 20 7b 72 65               {re
2b40: 74 75 72 6e 20 30 7d 0a 09 69 66 20 7b 28 24 6d  turn 0}..if {($m
2b50: 61 78 20 6e 65 20 22 22 29 20 26 26 20 21 5b 56  ax ne "") && ![V
2b60: 76 61 6c 69 64 20 24 6d 61 78 20 6d 65 73 73 61  valid $max messa
2b70: 67 65 5d 7d 20 7b 72 65 74 75 72 6e 20 30 7d 0a  ge]} {return 0}.
2b80: 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a 09 73 65      } else {..se
2b90: 74 20 6d 65 73 73 61 67 65 20 22 42 61 64 20 72  t message "Bad r
2ba0: 65 71 75 69 72 65 6d 65 6e 74 20 5c 22 24 72 65  equirement \"$re
2bb0: 71 5c 22 22 0a 09 72 65 74 75 72 6e 20 30 0a 20  q\""..return 0. 
2bc0: 20 20 20 7d 0a 20 20 20 20 72 65 74 75 72 6e 20     }.    return 
2bd0: 31 0a 7d 0a 0a 70 72 6f 63 20 3a 3a 6b 65 74 74  1.}..proc ::kett
2be0: 6c 65 3a 3a 6d 64 72 65 66 3a 3a 56 72 65 71 73  le::mdref::Vreqs
2bf0: 74 72 69 6e 67 20 7b 72 65 71 7d 20 7b 0a 20 20  tring {req} {.  
2c00: 20 20 69 66 20 7b 5b 6c 6c 65 6e 67 74 68 20 24    if {[llength $
2c10: 72 65 71 5d 20 3d 3d 20 31 7d 20 7b 0a 09 72 65  req] == 1} {..re
2c20: 74 75 72 6e 20 5b 6c 69 6e 64 65 78 20 24 72 65  turn [lindex $re
2c30: 71 20 30 5d 0a 20 20 20 20 7d 20 65 6c 73 65 69  q 0].    } elsei
2c40: 66 20 7b 5b 6c 6c 65 6e 67 74 68 20 24 72 65 71  f {[llength $req
2c50: 5d 20 3d 3d 20 32 7d 20 7b 0a 09 66 6f 72 65 61  ] == 2} {..forea
2c60: 63 68 20 7b 6d 69 6e 20 6d 61 78 7d 20 24 72 65  ch {min max} $re
2c70: 71 20 62 72 65 61 6b 0a 09 69 66 20 7b 24 6d 61  q break..if {$ma
2c80: 78 20 65 71 20 22 22 7d 20 7b 0a 09 20 20 20 20  x eq ""} {..    
2c90: 72 65 74 75 72 6e 20 24 7b 6d 69 6e 7d 2d 0a 09  return ${min}-..
2ca0: 7d 20 65 6c 73 65 20 7b 0a 09 20 20 20 20 72 65  } else {..    re
2cb0: 74 75 72 6e 20 24 7b 6d 69 6e 7d 2d 24 6d 61 78  turn ${min}-$max
2cc0: 0a 09 7d 0a 20 20 20 20 7d 0a 7d 0a 0a 70 72 6f  ..}.    }.}..pro
2cd0: 63 20 3a 3a 6b 65 74 74 6c 65 3a 3a 6d 64 72 65  c ::kettle::mdre
2ce0: 66 3a 3a 56 76 61 6c 69 64 20 7b 76 20 7b 6d 76  f::Vvalid {v {mv
2cf0: 20 7b 7d 7d 7d 20 7b 0a 20 20 20 20 69 66 20 7b   {}}} {.    if {
2d00: 24 6d 76 20 6e 65 20 22 22 7d 20 7b 75 70 76 61  $mv ne ""} {upva
2d10: 72 20 31 20 24 6d 76 20 6d 65 73 73 61 67 65 7d  r 1 $mv message}
2d20: 0a 0a 20 20 20 20 23 20 44 65 66 65 72 20 74 6f  ..    # Defer to
2d30: 20 74 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 20   the underlying 
2d40: 54 63 6c 20 69 6e 74 65 72 70 72 65 74 65 72 2e  Tcl interpreter.
2d50: 20 57 68 69 6c 65 20 74 68 65 72 65 20 69 73 20   While there is 
2d60: 6e 6f 0a 20 20 20 20 23 20 64 69 72 65 63 74 20  no.    # direct 
2d70: 76 61 6c 69 64 61 74 69 6f 6e 20 28 73 75 62 29  validation (sub)
2d80: 63 6f 6d 6d 61 6e 64 20 77 65 20 63 61 6e 20 6d  command we can m
2d90: 69 73 2d 75 73 65 20 22 70 61 63 6b 61 67 65 76  is-use "packagev
2da0: 63 6f 6d 70 61 72 65 22 0a 20 20 20 20 23 20 66  compare".    # f
2db0: 6f 72 20 6f 75 72 20 70 75 72 70 6f 73 65 73 2e  or our purposes.
2dc0: 20 50 72 6f 76 69 64 65 20 61 20 76 61 6c 69 64   Provide a valid
2dd0: 20 76 65 72 73 69 6f 6e 20 6e 75 6d 62 65 72 20   version number 
2de0: 61 73 20 73 65 63 6f 6e 64 0a 20 20 20 20 23 20  as second.    # 
2df0: 61 72 67 75 6d 65 6e 74 20 61 6e 64 20 64 69 73  argument and dis
2e00: 63 61 72 64 20 74 68 65 20 63 6f 6d 70 61 72 69  card the compari
2e10: 73 6f 6e 20 72 65 73 75 6c 74 2e 20 57 65 20 61  son result. We a
2e20: 72 65 20 6f 6e 6c 79 0a 20 20 20 20 23 20 69 6e  re only.    # in
2e30: 74 65 72 65 73 74 65 64 20 69 6e 20 74 68 65 20  terested in the 
2e40: 6f 6b 2f 65 72 72 6f 72 20 73 74 61 74 75 73 2c  ok/error status,
2e50: 20 74 68 65 20 6c 61 74 74 65 72 20 74 68 72 6f   the latter thro
2e60: 77 6e 20 69 66 20 61 6e 64 20 6f 6e 6c 79 0a 20  wn if and only. 
2e70: 20 20 20 23 20 69 66 20 74 68 65 20 61 72 67 75     # if the argu
2e80: 6d 65 6e 74 20 69 73 20 61 20 73 79 6e 74 61 63  ment is a syntac
2e90: 74 69 63 61 6c 6c 79 20 69 6e 76 61 6c 69 64 20  tically invalid 
2ea0: 76 65 72 73 69 6f 6e 20 6e 75 6d 62 65 72 2e 0a  version number..
2eb0: 0a 20 20 20 20 73 65 74 20 6f 6b 20 5b 65 78 70  .    set ok [exp
2ec0: 72 20 7b 5b 63 61 74 63 68 20 7b 0a 09 70 61 63  r {[catch {..pac
2ed0: 6b 61 67 65 20 76 63 6f 6d 70 61 72 65 20 24 76  kage vcompare $v
2ee0: 20 30 0a 20 20 20 20 7d 5d 20 3f 20 30 20 3a 20   0.    }] ? 0 : 
2ef0: 31 7d 5d 0a 0a 20 20 20 20 69 66 20 7b 21 24 6f  1}]..    if {!$o
2f00: 6b 7d 20 7b 0a 09 73 65 74 20 6d 65 73 73 61 67  k} {..set messag
2f10: 65 20 22 42 61 64 20 76 65 72 73 69 6f 6e 20 5c  e "Bad version \
2f20: 22 24 76 5c 22 22 0a 20 20 20 20 7d 0a 20 20 20  "$v\"".    }.   
2f30: 20 72 65 74 75 72 6e 20 24 6f 6b 0a 7d 0a 0a 70   return $ok.}..p
2f40: 72 6f 63 20 3a 3a 6b 65 74 74 6c 65 3a 3a 6d 64  roc ::kettle::md
2f50: 72 65 66 3a 3a 56 6e 65 78 74 20 7b 76 7d 20 7b  ref::Vnext {v} {
2f60: 0a 20 20 20 20 23 20 45 78 61 6d 70 6c 65 73 3a  .    # Examples:
2f70: 0a 20 20 20 20 23 20 2a 20 38 2e 34 20 20 20 2d  .    # * 8.4   -
2f80: 3e 20 38 2e 35 0a 20 20 20 20 23 20 2a 20 38 2e  > 8.5.    # * 8.
2f90: 35 2e 39 20 2d 3e 20 38 2e 35 2e 31 30 0a 20 20  5.9 -> 8.5.10.  
2fa0: 20 20 23 0a 20 20 20 20 23 20 4e 6f 74 65 3a 20    #.    # Note: 
2fb0: 57 65 20 72 65 6d 6f 76 65 20 6c 65 61 64 69 6e  We remove leadin
2fc0: 67 20 7a 65 72 6f 73 20 28 76 69 61 20 5b 73 63  g zeros (via [sc
2fd0: 61 6e 5d 29 20 74 6f 20 70 72 65 76 65 6e 74 0a  an]) to prevent.
2fe0: 20 20 20 20 23 20 6d 69 73 2d 69 6e 74 65 72 70      # mis-interp
2ff0: 72 65 74 61 74 69 6f 6e 20 61 73 20 61 6e 20 6f  retation as an o
3000: 63 74 61 6c 20 6e 75 6d 62 65 72 2e 0a 0a 20 20  ctal number...  
3010: 20 20 73 65 74 20 76 6e 20 5b 73 70 6c 69 74 20    set vn [split 
3020: 24 76 20 2e 5d 0a 20 20 20 20 73 63 61 6e 20 5b  $v .].    scan [
3030: 6c 69 6e 64 65 78 20 24 76 6e 20 65 6e 64 5d 20  lindex $vn end] 
3040: 25 64 20 6c 61 73 74 0a 20 20 20 20 72 65 74 75  %d last.    retu
3050: 72 6e 20 5b 6a 6f 69 6e 20 5b 6c 72 65 70 6c 61  rn [join [lrepla
3060: 63 65 20 24 76 6e 20 65 6e 64 20 65 6e 64 20 5b  ce $vn end end [
3070: 69 6e 63 72 20 6c 61 73 74 5d 5d 20 2e 5d 0a 7d  incr last]] .].}
3080: 0a 0a 23 20 23 20 23 23 20 23 23 23 20 23 23 23  ..# # ## ### ###
3090: 23 23 20 23 23 23 23 23 23 23 23 20 23 23 23 23  ## ######## ####
30a0: 23 23 23 23 23 23 23 23 23 20 23 23 23 23 23 23  ######### ######
30b0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 0a  ###############.
30c0: 23 23 20 49 6e 69 74 69 61 6c 69 7a 61 74 69 6f  ## Initializatio
30d0: 6e 0a 0a 23 20 23 20 23 23 20 23 23 23 20 23 23  n..# # ## ### ##
30e0: 23 23 23 20 23 23 23 23 23 23 23 23 20 23 23 23  ### ######## ###
30f0: 23 23 23 23 23 23 23 23 23 23 20 23 23 23 23 23  ########## #####
3100: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
3110: 0a 72 65 74 75 72 6e 0a 0a                       .return..