Artifact f653273970b3dbf6c7328ce53de6e964948c44a0:

File tools/cvs2fossil/lib/trouble.tcl part of check-in [38b967dcf5] - Merge aku's CVS import changes into the main line. Fix a small bug in diff.c. by drh on 2007-11-17 00:29:42. Also file tools/cvs2fossil/lib/trouble.tcl part of check-in [7eaa420a23] - Extended options processing to handle --exclude, --force-tag, and --force-branch options. Extended project::sym class with in-memkory databases to hold the option information and replaced the 'UserConfig' placeholder with the actual code using the new databases to determine symbol types based on user-requests. Extended the pass itself with code performing various checks on the results of type determination, partially paranoia, partially to find genuine bad requests (excluding symbols with unexcluded blockers, making a symbol with commits on it a tag, ...). NYI: Computation of the prefered parent for all symbols. by aku on 2007-11-05 09:04:25.

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 23 20 55 74 69  ########..## Uti
0200: 6c 69 74 79 20 70 61 63 6b 61 67 65 2c 20 65 72  lity package, er
0210: 72 6f 72 20 72 65 70 6f 72 74 69 6e 67 20 6f 6e  ror reporting on
0220: 20 74 6f 70 20 6f 66 20 74 68 65 20 6c 6f 67 20   top of the log 
0230: 70 61 63 6b 61 67 65 2e 0a 0a 23 20 23 20 23 23  package...# # ##
0240: 20 23 23 23 20 23 23 23 23 23 20 23 23 23 23 23   ### ##### #####
0250: 23 23 23 20 23 23 23 23 23 23 23 23 23 23 23 23  ### ############
0260: 23 20 23 23 23 23 23 23 23 23 23 23 23 23 23 23  # ##############
0270: 23 23 23 23 23 23 23 0a 23 23 20 52 65 71 75 69  #######.## Requi
0280: 72 65 6d 65 6e 74 73 0a 0a 70 61 63 6b 61 67 65  rements..package
0290: 20 72 65 71 75 69 72 65 20 54 63 6c 20 38 2e 34   require Tcl 8.4
02a0: 20 20 20 20 20 20 20 20 3b 20 23 20 52 65 71 75          ; # Requ
02b0: 69 72 65 64 20 72 75 6e 74 69 6d 65 2e 0a 70 61  ired runtime..pa
02c0: 63 6b 61 67 65 20 72 65 71 75 69 72 65 20 76 63  ckage require vc
02d0: 3a 3a 74 6f 6f 6c 73 3a 3a 6c 6f 67 20 3b 20 23  ::tools::log ; #
02e0: 20 42 61 73 69 63 20 6c 6f 67 20 67 65 6e 65 72   Basic log gener
02f0: 61 74 69 6f 6e 2e 0a 70 61 63 6b 61 67 65 20 72  ation..package r
0300: 65 71 75 69 72 65 20 73 6e 69 74 20 20 20 20 20  equire snit     
0310: 20 20 20 20 20 20 3b 20 23 20 4f 4f 20 73 79 73        ; # OO sys
0320: 74 65 6d 2e 0a 0a 23 20 23 20 23 23 20 23 23 23  tem...# # ## ###
0330: 20 23 23 23 23 23 20 23 23 23 23 23 23 23 23 20   ##### ######## 
0340: 23 23 23 23 23 23 23 23 23 23 23 23 23 20 23 23  ############# ##
0350: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0360: 23 23 23 0a 23 23 20 0a 0a 73 6e 69 74 3a 3a 74  ###.## ..snit::t
0370: 79 70 65 20 3a 3a 76 63 3a 3a 74 6f 6f 6c 73 3a  ype ::vc::tools:
0380: 3a 74 72 6f 75 62 6c 65 20 7b 0a 20 20 20 20 23  :trouble {.    #
0390: 20 23 20 23 23 20 23 23 23 20 23 23 23 23 23 20   # ## ### ##### 
03a0: 23 23 23 23 23 23 23 23 20 23 23 23 23 23 23 23  ######## #######
03b0: 23 23 23 23 23 23 0a 20 20 20 20 23 23 20 50 75  ######.    ## Pu
03c0: 62 6c 69 63 20 41 50 49 2c 20 4d 65 74 68 6f 64  blic API, Method
03d0: 73 0a 0a 20 20 20 20 74 79 70 65 6d 65 74 68 6f  s..    typemetho
03e0: 64 20 69 6e 74 65 72 6e 61 6c 20 7b 74 65 78 74  d internal {text
03f0: 7d 20 7b 0a 09 66 6f 72 65 61 63 68 20 6c 69 6e  } {..foreach lin
0400: 65 20 5b 73 70 6c 69 74 20 24 74 65 78 74 20 5c  e [split $text \
0410: 6e 5d 20 7b 20 24 74 79 70 65 20 66 61 74 61 6c  n] { $type fatal
0420: 20 22 49 4e 54 45 52 4e 41 4c 20 45 52 52 4f 52   "INTERNAL ERROR
0430: 21 20 24 6c 69 6e 65 22 20 7d 0a 09 65 78 69 74  ! $line" }..exit
0440: 20 31 0a 20 20 20 20 7d 0a 0a 20 20 20 20 74 79   1.    }..    ty
0450: 70 65 6d 65 74 68 6f 64 20 66 61 74 61 6c 20 7b  pemethod fatal {
0460: 74 65 78 74 7d 20 7b 0a 09 6c 61 70 70 65 6e 64  text} {..lappend
0470: 20 6d 79 66 61 74 61 6c 20 24 74 65 78 74 0a 09   myfatal $text..
0480: 72 65 74 75 72 6e 0a 20 20 20 20 7d 0a 0a 20 20  return.    }..  
0490: 20 20 74 79 70 65 6d 65 74 68 6f 64 20 77 61 72    typemethod war
04a0: 6e 20 7b 74 65 78 74 7d 20 7b 0a 09 6c 61 70 70  n {text} {..lapp
04b0: 65 6e 64 20 6d 79 77 61 72 6e 20 24 74 65 78 74  end mywarn $text
04c0: 0a 09 6c 6f 67 20 77 72 69 74 65 20 30 20 74 72  ..log write 0 tr
04d0: 6f 75 62 6c 65 20 24 74 65 78 74 0a 09 72 65 74  ouble $text..ret
04e0: 75 72 6e 0a 20 20 20 20 7d 0a 0a 20 20 20 20 74  urn.    }..    t
04f0: 79 70 65 6d 65 74 68 6f 64 20 69 6e 66 6f 20 7b  ypemethod info {
0500: 74 65 78 74 7d 20 7b 0a 09 6c 61 70 70 65 6e 64  text} {..lappend
0510: 20 6d 79 69 6e 66 6f 20 24 74 65 78 74 0a 09 72   myinfo $text..r
0520: 65 74 75 72 6e 0a 20 20 20 20 7d 0a 0a 20 20 20  eturn.    }..   
0530: 20 74 79 70 65 6d 65 74 68 6f 64 20 73 68 6f 77   typemethod show
0540: 20 7b 7d 20 7b 0a 09 66 6f 72 65 61 63 68 20 6d   {} {..foreach m
0550: 20 24 6d 79 69 6e 66 6f 20 20 7b 20 6c 6f 67 20   $myinfo  { log 
0560: 77 72 69 74 65 20 30 20 22 22 20 20 20 20 20 20  write 0 ""      
0570: 24 6d 20 7d 0a 09 66 6f 72 65 61 63 68 20 6d 20  $m }..foreach m 
0580: 24 6d 79 77 61 72 6e 20 20 7b 20 6c 6f 67 20 77  $mywarn  { log w
0590: 72 69 74 65 20 30 20 77 61 72 6e 69 6e 67 20 24  rite 0 warning $
05a0: 6d 20 7d 0a 09 66 6f 72 65 61 63 68 20 6d 20 24  m }..foreach m $
05b0: 6d 79 66 61 74 61 6c 20 7b 20 6c 6f 67 20 77 72  myfatal { log wr
05c0: 69 74 65 20 30 20 66 61 74 61 6c 20 20 20 24 6d  ite 0 fatal   $m
05d0: 20 7d 0a 09 72 65 74 75 72 6e 0a 20 20 20 20 7d   }..return.    }
05e0: 0a 0a 20 20 20 20 74 79 70 65 6d 65 74 68 6f 64  ..    typemethod
05f0: 20 3f 20 7b 7d 20 7b 0a 09 72 65 74 75 72 6e 20   ? {} {..return 
0600: 5b 65 78 70 72 20 7b 0a 09 20 20 20 20 5b 6c 6c  [expr {..    [ll
0610: 65 6e 67 74 68 20 24 6d 79 69 6e 66 6f 5d 20 7c  ength $myinfo] |
0620: 7c 0a 09 20 20 20 20 5b 6c 6c 65 6e 67 74 68 20  |..    [llength 
0630: 24 6d 79 77 61 72 6e 5d 20 7c 7c 0a 09 20 20 20  $mywarn] ||..   
0640: 20 5b 6c 6c 65 6e 67 74 68 20 24 6d 79 66 61 74   [llength $myfat
0650: 61 6c 5d 0a 09 7d 5d 0a 20 20 20 20 7d 0a 0a 20  al]..}].    }.. 
0660: 20 20 20 74 79 70 65 6d 65 74 68 6f 64 20 61 62     typemethod ab
0670: 6f 72 74 3f 20 7b 7d 20 7b 0a 09 69 66 20 7b 0a  ort? {} {..if {.
0680: 09 20 20 20 20 21 5b 6c 6c 65 6e 67 74 68 20 24  .    ![llength $
0690: 6d 79 69 6e 66 6f 5d 20 26 26 0a 09 20 20 20 20  myinfo] &&..    
06a0: 21 5b 6c 6c 65 6e 67 74 68 20 24 6d 79 77 61 72  ![llength $mywar
06b0: 6e 5d 20 26 26 0a 09 20 20 20 20 21 5b 6c 6c 65  n] &&..    ![lle
06c0: 6e 67 74 68 20 24 6d 79 66 61 74 61 6c 5d 0a 09  ngth $myfatal]..
06d0: 7d 20 72 65 74 75 72 6e 0a 0a 09 23 20 46 72 61  } return...# Fra
06e0: 6d 65 20 74 68 65 20 70 65 6e 64 69 6e 67 20 6d  me the pending m
06f0: 65 73 73 61 67 65 73 20 74 6f 20 6d 61 6b 65 20  essages to make 
0700: 74 68 65 6d 20 6d 6f 72 65 20 63 6c 65 61 72 20  them more clear 
0710: 61 73 20 74 68 65 0a 09 23 20 63 61 75 73 65 20  as the..# cause 
0720: 6f 66 20 74 68 65 20 61 62 6f 72 74 2e 0a 0a 09  of the abort....
0730: 73 65 74 20 20 20 20 20 6d 79 69 6e 66 6f 20 5b  set     myinfo [
0740: 6c 69 6e 73 65 72 74 20 24 6d 79 69 6e 66 6f 20  linsert $myinfo 
0750: 30 20 22 22 20 22 45 6e 63 6f 75 6e 74 65 72 65  0 "" "Encountere
0760: 64 20 70 72 6f 62 6c 65 6d 73 2e 22 20 22 22 5d  d problems." ""]
0770: 0a 09 6c 61 70 70 65 6e 64 20 6d 79 66 61 74 61  ..lappend myfata
0780: 6c 20 22 53 74 6f 70 70 65 64 20 64 75 65 20 74  l "Stopped due t
0790: 6f 20 70 72 6f 62 6c 65 6d 73 2e 22 0a 0a 09 23  o problems."...#
07a0: 20 57 65 20 68 61 76 65 20 65 72 72 6f 72 20 6d   We have error m
07b0: 65 73 73 61 67 65 73 20 74 6f 20 70 72 69 6e 74  essages to print
07c0: 2c 20 73 6f 20 73 74 6f 70 20 6e 6f 77 2e 0a 09  , so stop now...
07d0: 65 78 69 74 20 31 0a 20 20 20 20 7d 0a 0a 20 20  exit 1.    }..  
07e0: 20 20 23 20 23 20 23 23 20 23 23 23 20 23 23 23    # # ## ### ###
07f0: 23 23 20 23 23 23 23 23 23 23 23 20 23 23 23 23  ## ######## ####
0800: 23 23 23 23 23 23 23 23 23 0a 20 20 20 20 23 23  #########.    ##
0810: 20 49 6e 74 65 72 6e 61 6c 2c 20 73 74 61 74 65   Internal, state
0820: 0a 0a 20 20 20 20 74 79 70 65 76 61 72 69 61 62  ..    typevariab
0830: 6c 65 20 6d 79 69 6e 66 6f 20 20 7b 7d 0a 20 20  le myinfo  {}.  
0840: 20 20 74 79 70 65 76 61 72 69 61 62 6c 65 20 6d    typevariable m
0850: 79 77 61 72 6e 20 20 7b 7d 0a 20 20 20 20 74 79  ywarn  {}.    ty
0860: 70 65 76 61 72 69 61 62 6c 65 20 6d 79 66 61 74  pevariable myfat
0870: 61 6c 20 7b 7d 0a 0a 20 20 20 20 23 20 23 20 23  al {}..    # # #
0880: 23 20 23 23 23 20 23 23 23 23 23 20 23 23 23 23  # ### ##### ####
0890: 23 23 23 23 20 23 23 23 23 23 23 23 23 23 23 23  #### ###########
08a0: 23 23 0a 20 20 20 20 23 23 20 43 6f 6e 66 69 67  ##.    ## Config
08b0: 75 72 61 74 69 6f 6e 0a 0a 20 20 20 20 70 72 61  uration..    pra
08c0: 67 6d 61 20 2d 68 61 73 69 6e 73 74 61 6e 63 65  gma -hasinstance
08d0: 73 20 20 20 6e 6f 20 3b 20 23 20 73 69 6e 67 6c  s   no ; # singl
08e0: 65 74 6f 6e 0a 20 20 20 20 70 72 61 67 6d 61 20  eton.    pragma 
08f0: 2d 68 61 73 74 79 70 65 69 6e 66 6f 20 20 20 20  -hastypeinfo    
0900: 6e 6f 20 3b 20 23 20 6e 6f 20 69 6e 74 72 6f 73  no ; # no intros
0910: 70 65 63 74 69 6f 6e 0a 20 20 20 20 70 72 61 67  pection.    prag
0920: 6d 61 20 2d 68 61 73 74 79 70 65 64 65 73 74 72  ma -hastypedestr
0930: 6f 79 20 6e 6f 20 3b 20 23 20 69 6d 6d 6f 72 74  oy no ; # immort
0940: 61 6c 0a 0a 20 20 20 20 23 20 23 20 23 23 20 23  al..    # # ## #
0950: 23 23 20 23 23 23 23 23 20 23 23 23 23 23 23 23  ## ##### #######
0960: 23 20 23 23 23 23 23 23 23 23 23 23 23 23 23 0a  # #############.
0970: 7d 0a 0a 23 20 23 20 23 23 20 23 23 23 20 23 23  }..# # ## ### ##
0980: 23 23 23 20 23 23 23 23 23 23 23 23 20 23 23 23  ### ######## ###
0990: 23 23 23 23 23 23 23 23 23 23 20 23 23 23 23 23  ########## #####
09a0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
09b0: 0a 23 23 20 49 6e 74 65 72 6e 61 6c 2e 20 53 70  .## Internal. Sp
09c0: 65 63 69 61 6c 2e 20 53 65 74 20 75 70 20 61 20  ecial. Set up a 
09d0: 68 6f 6f 6b 20 69 6e 74 6f 20 74 68 65 20 61 70  hook into the ap
09e0: 70 6c 69 63 61 74 69 6f 6e 20 65 78 69 74 2c 20  plication exit, 
09f0: 74 6f 20 73 68 6f 77 0a 23 23 20 74 68 65 20 72  to show.## the r
0a00: 65 6d 65 6d 62 65 72 65 64 20 6d 65 73 73 61 67  emembered messag
0a10: 65 73 2c 20 62 65 66 6f 72 65 20 70 61 73 73 69  es, before passi
0a20: 6e 67 20 74 68 72 6f 75 67 68 20 74 68 65 20 72  ng through the r
0a30: 65 67 75 6c 61 72 20 63 6f 6d 6d 61 6e 64 2e 0a  egular command..
0a40: 0a 72 65 6e 61 6d 65 20 3a 3a 65 78 69 74 20 3a  .rename ::exit :
0a50: 3a 76 63 3a 3a 74 6f 6f 6c 73 3a 3a 74 72 6f 75  :vc::tools::trou
0a60: 62 6c 65 3a 3a 45 58 49 54 0a 70 72 6f 63 20 20  ble::EXIT.proc  
0a70: 20 3a 3a 65 78 69 74 20 7b 7b 73 74 61 74 75 73   ::exit {{status
0a80: 20 30 7d 7d 20 7b 0a 20 20 20 20 3a 3a 76 63 3a   0}} {.    ::vc:
0a90: 3a 74 6f 6f 6c 73 3a 3a 74 72 6f 75 62 6c 65 20  :tools::trouble 
0aa0: 73 68 6f 77 0a 20 20 20 20 3a 3a 76 63 3a 3a 74  show.    ::vc::t
0ab0: 6f 6f 6c 73 3a 3a 74 72 6f 75 62 6c 65 3a 3a 45  ools::trouble::E
0ac0: 58 49 54 20 24 73 74 61 74 75 73 0a 20 20 20 20  XIT $status.    
0ad0: 23 20 4e 6f 74 20 72 65 61 63 68 65 64 2e 0a 20  # Not reached.. 
0ae0: 20 20 20 72 65 74 75 72 6e 0a 7d 0a 0a 6e 61 6d     return.}..nam
0af0: 65 73 70 61 63 65 20 65 76 61 6c 20 3a 3a 76 63  espace eval ::vc
0b00: 3a 3a 74 6f 6f 6c 73 20 7b 0a 20 20 20 20 6e 61  ::tools {.    na
0b10: 6d 65 73 70 61 63 65 20 65 76 61 6c 20 74 72 6f  mespace eval tro
0b20: 75 62 6c 65 20 7b 6e 61 6d 65 73 70 61 63 65 20  uble {namespace 
0b30: 69 6d 70 6f 72 74 20 3a 3a 76 63 3a 3a 74 6f 6f  import ::vc::too
0b40: 6c 73 3a 3a 6c 6f 67 20 7d 0a 20 20 20 20 74 72  ls::log }.    tr
0b50: 6f 75 62 6c 65 3a 3a 6c 6f 67 20 72 65 67 69 73  ouble::log regis
0b60: 74 65 72 20 22 22 0a 20 20 20 20 74 72 6f 75 62  ter "".    troub
0b70: 6c 65 3a 3a 6c 6f 67 20 72 65 67 69 73 74 65 72  le::log register
0b80: 20 66 61 74 61 6c 0a 20 20 20 20 74 72 6f 75 62   fatal.    troub
0b90: 6c 65 3a 3a 6c 6f 67 20 72 65 67 69 73 74 65 72  le::log register
0ba0: 20 74 72 6f 75 62 6c 65 0a 20 20 20 20 74 72 6f   trouble.    tro
0bb0: 75 62 6c 65 3a 3a 6c 6f 67 20 72 65 67 69 73 74  uble::log regist
0bc0: 65 72 20 77 61 72 6e 69 6e 67 0a 20 20 20 20 6e  er warning.    n
0bd0: 61 6d 65 73 70 61 63 65 20 65 78 70 6f 72 74 20  amespace export 
0be0: 74 72 6f 75 62 6c 65 0a 7d 0a 0a 23 20 23 20 23  trouble.}..# # #
0bf0: 23 20 23 23 23 20 23 23 23 23 23 20 23 23 23 23  # ### ##### ####
0c00: 23 23 23 23 20 23 23 23 23 23 23 23 23 23 23 23  #### ###########
0c10: 23 23 20 23 23 23 23 23 23 23 23 23 23 23 23 23  ## #############
0c20: 23 23 23 23 23 23 23 23 0a 23 23 20 52 65 61 64  ########.## Read
0c30: 79 0a 0a 70 61 63 6b 61 67 65 20 70 72 6f 76 69  y..package provi
0c40: 64 65 20 76 63 3a 3a 74 6f 6f 6c 73 3a 3a 74 72  de vc::tools::tr
0c50: 6f 75 62 6c 65 20 31 2e 30 0a 72 65 74 75 72 6e  ouble 1.0.return
0c60: 0a                                               .