Artifact fdf622fa2099ec0acf077f5434b7895a20007573:

File tools/cvs2fossil/lib/trouble.tcl part of check-in [d57b7b4a05] - Re-added the user feedback and error reporting utilities, with modifications, and completed the handling of the informational options. by aku on 2007-10-02 05:33:09.

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 66 61 74 61 6c 20 7b 74 65 78 74 7d 20 7b  d fatal {text} {
03f0: 0a 09 6c 61 70 70 65 6e 64 20 6d 79 66 61 74 61  ..lappend myfata
0400: 6c 20 24 74 65 78 74 0a 09 65 78 69 74 20 31 0a  l $text..exit 1.
0410: 20 20 20 20 7d 0a 0a 20 20 20 20 74 79 70 65 6d      }..    typem
0420: 65 74 68 6f 64 20 77 61 72 6e 20 7b 74 65 78 74  ethod warn {text
0430: 7d 20 7b 0a 09 6c 61 70 70 65 6e 64 20 6d 79 77  } {..lappend myw
0440: 61 72 6e 20 24 74 65 78 74 0a 09 6c 6f 67 20 77  arn $text..log w
0450: 72 69 74 65 20 30 20 74 72 6f 75 62 6c 65 20 24  rite 0 trouble $
0460: 74 65 78 74 0a 09 72 65 74 75 72 6e 0a 20 20 20  text..return.   
0470: 20 7d 0a 0a 20 20 20 20 74 79 70 65 6d 65 74 68   }..    typemeth
0480: 6f 64 20 69 6e 66 6f 20 7b 74 65 78 74 7d 20 7b  od info {text} {
0490: 0a 09 6c 61 70 70 65 6e 64 20 6d 79 69 6e 66 6f  ..lappend myinfo
04a0: 20 24 74 65 78 74 0a 09 72 65 74 75 72 6e 0a 20   $text..return. 
04b0: 20 20 20 7d 0a 0a 20 20 20 20 74 79 70 65 6d 65     }..    typeme
04c0: 74 68 6f 64 20 73 68 6f 77 20 7b 7d 20 7b 0a 09  thod show {} {..
04d0: 66 6f 72 65 61 63 68 20 6d 20 24 6d 79 69 6e 66  foreach m $myinf
04e0: 6f 20 20 7b 20 6c 6f 67 20 77 72 69 74 65 20 30  o  { log write 0
04f0: 20 22 22 20 20 20 20 20 20 24 6d 20 7d 0a 09 66   ""      $m }..f
0500: 6f 72 65 61 63 68 20 6d 20 24 6d 79 77 61 72 6e  oreach m $mywarn
0510: 20 20 7b 20 6c 6f 67 20 77 72 69 74 65 20 30 20    { log write 0 
0520: 77 61 72 6e 69 6e 67 20 24 6d 20 7d 0a 09 66 6f  warning $m }..fo
0530: 72 65 61 63 68 20 6d 20 24 6d 79 66 61 74 61 6c  reach m $myfatal
0540: 20 7b 20 6c 6f 67 20 77 72 69 74 65 20 30 20 66   { log write 0 f
0550: 61 74 61 6c 20 20 20 24 6d 20 7d 0a 09 72 65 74  atal   $m }..ret
0560: 75 72 6e 0a 20 20 20 20 7d 0a 0a 20 20 20 20 23  urn.    }..    #
0570: 20 23 20 23 23 20 23 23 23 20 23 23 23 23 23 20   # ## ### ##### 
0580: 23 23 23 23 23 23 23 23 20 23 23 23 23 23 23 23  ######## #######
0590: 23 23 23 23 23 23 0a 20 20 20 20 23 23 20 49 6e  ######.    ## In
05a0: 74 65 72 6e 61 6c 2c 20 73 74 61 74 65 0a 0a 20  ternal, state.. 
05b0: 20 20 20 74 79 70 65 76 61 72 69 61 62 6c 65 20     typevariable 
05c0: 6d 79 69 6e 66 6f 20 20 7b 7d 0a 20 20 20 20 74  myinfo  {}.    t
05d0: 79 70 65 76 61 72 69 61 62 6c 65 20 6d 79 77 61  ypevariable mywa
05e0: 72 6e 20 20 7b 7d 0a 20 20 20 20 74 79 70 65 76  rn  {}.    typev
05f0: 61 72 69 61 62 6c 65 20 6d 79 66 61 74 61 6c 20  ariable myfatal 
0600: 7b 7d 0a 0a 20 20 20 20 23 20 23 20 23 23 20 23  {}..    # # ## #
0610: 23 23 20 23 23 23 23 23 20 23 23 23 23 23 23 23  ## ##### #######
0620: 23 20 23 23 23 23 23 23 23 23 23 23 23 23 23 0a  # #############.
0630: 20 20 20 20 23 23 20 43 6f 6e 66 69 67 75 72 61      ## Configura
0640: 74 69 6f 6e 0a 0a 20 20 20 20 70 72 61 67 6d 61  tion..    pragma
0650: 20 2d 68 61 73 69 6e 73 74 61 6e 63 65 73 20 20   -hasinstances  
0660: 20 6e 6f 20 3b 20 23 20 73 69 6e 67 6c 65 74 6f   no ; # singleto
0670: 6e 0a 20 20 20 20 70 72 61 67 6d 61 20 2d 68 61  n.    pragma -ha
0680: 73 74 79 70 65 69 6e 66 6f 20 20 20 20 6e 6f 20  stypeinfo    no 
0690: 3b 20 23 20 6e 6f 20 69 6e 74 72 6f 73 70 65 63  ; # no introspec
06a0: 74 69 6f 6e 0a 20 20 20 20 70 72 61 67 6d 61 20  tion.    pragma 
06b0: 2d 68 61 73 74 79 70 65 64 65 73 74 72 6f 79 20  -hastypedestroy 
06c0: 6e 6f 20 3b 20 23 20 69 6d 6d 6f 72 74 61 6c 0a  no ; # immortal.
06d0: 0a 20 20 20 20 23 20 23 20 23 23 20 23 23 23 20  .    # # ## ### 
06e0: 23 23 23 23 23 20 23 23 23 23 23 23 23 23 20 23  ##### ######## #
06f0: 23 23 23 23 23 23 23 23 23 23 23 23 0a 7d 0a 0a  ############.}..
0700: 23 20 23 20 23 23 20 23 23 23 20 23 23 23 23 23  # # ## ### #####
0710: 20 23 23 23 23 23 23 23 23 20 23 23 23 23 23 23   ######## ######
0720: 23 23 23 23 23 23 23 20 23 23 23 23 23 23 23 23  ####### ########
0730: 23 23 23 23 23 23 23 23 23 23 23 23 23 0a 23 23  #############.##
0740: 20 49 6e 74 65 72 6e 61 6c 2e 20 53 70 65 63 69   Internal. Speci
0750: 61 6c 2e 20 53 65 74 20 75 70 20 61 20 68 6f 6f  al. Set up a hoo
0760: 6b 20 69 6e 74 6f 20 74 68 65 20 61 70 70 6c 69  k into the appli
0770: 63 61 74 69 6f 6e 20 65 78 69 74 2c 20 74 6f 20  cation exit, to 
0780: 73 68 6f 77 0a 23 23 20 74 68 65 20 72 65 6d 65  show.## the reme
0790: 6d 62 65 72 65 64 20 6d 65 73 73 61 67 65 73 2c  mbered messages,
07a0: 20 62 65 66 6f 72 65 20 70 61 73 73 69 6e 67 20   before passing 
07b0: 74 68 72 6f 75 67 68 20 74 68 65 20 72 65 67 75  through the regu
07c0: 6c 61 72 20 63 6f 6d 6d 61 6e 64 2e 0a 0a 72 65  lar command...re
07d0: 6e 61 6d 65 20 3a 3a 65 78 69 74 20 3a 3a 76 63  name ::exit ::vc
07e0: 3a 3a 74 6f 6f 6c 73 3a 3a 74 72 6f 75 62 6c 65  ::tools::trouble
07f0: 3a 3a 45 58 49 54 0a 70 72 6f 63 20 20 20 3a 3a  ::EXIT.proc   ::
0800: 65 78 69 74 20 7b 7b 73 74 61 74 75 73 20 30 7d  exit {{status 0}
0810: 7d 20 7b 0a 20 20 20 20 3a 3a 76 63 3a 3a 74 6f  } {.    ::vc::to
0820: 6f 6c 73 3a 3a 74 72 6f 75 62 6c 65 20 73 68 6f  ols::trouble sho
0830: 77 0a 20 20 20 20 3a 3a 76 63 3a 3a 74 6f 6f 6c  w.    ::vc::tool
0840: 73 3a 3a 74 72 6f 75 62 6c 65 3a 3a 45 58 49 54  s::trouble::EXIT
0850: 20 24 73 74 61 74 75 73 0a 20 20 20 20 23 20 4e   $status.    # N
0860: 6f 74 20 72 65 61 63 68 65 64 2e 0a 20 20 20 20  ot reached..    
0870: 72 65 74 75 72 6e 0a 7d 0a 0a 6e 61 6d 65 73 70  return.}..namesp
0880: 61 63 65 20 65 76 61 6c 20 3a 3a 76 63 3a 3a 74  ace eval ::vc::t
0890: 6f 6f 6c 73 20 7b 0a 20 20 20 20 6e 61 6d 65 73  ools {.    names
08a0: 70 61 63 65 20 65 76 61 6c 20 74 72 6f 75 62 6c  pace eval troubl
08b0: 65 20 7b 6e 61 6d 65 73 70 61 63 65 20 69 6d 70  e {namespace imp
08c0: 6f 72 74 20 3a 3a 76 63 3a 3a 74 6f 6f 6c 73 3a  ort ::vc::tools:
08d0: 3a 6c 6f 67 20 7d 0a 20 20 20 20 74 72 6f 75 62  :log }.    troub
08e0: 6c 65 3a 3a 6c 6f 67 20 72 65 67 69 73 74 65 72  le::log register
08f0: 20 22 22 0a 20 20 20 20 74 72 6f 75 62 6c 65 3a   "".    trouble:
0900: 3a 6c 6f 67 20 72 65 67 69 73 74 65 72 20 66 61  :log register fa
0910: 74 61 6c 0a 20 20 20 20 74 72 6f 75 62 6c 65 3a  tal.    trouble:
0920: 3a 6c 6f 67 20 72 65 67 69 73 74 65 72 20 74 72  :log register tr
0930: 6f 75 62 6c 65 0a 20 20 20 20 74 72 6f 75 62 6c  ouble.    troubl
0940: 65 3a 3a 6c 6f 67 20 72 65 67 69 73 74 65 72 20  e::log register 
0950: 77 61 72 6e 69 6e 67 0a 20 20 20 20 6e 61 6d 65  warning.    name
0960: 73 70 61 63 65 20 65 78 70 6f 72 74 20 74 72 6f  space export tro
0970: 75 62 6c 65 0a 7d 0a 0a 23 20 23 20 23 23 20 23  uble.}..# # ## #
0980: 23 23 20 23 23 23 23 23 20 23 23 23 23 23 23 23  ## ##### #######
0990: 23 20 23 23 23 23 23 23 23 23 23 23 23 23 23 20  # ############# 
09a0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
09b0: 23 23 23 23 23 0a 23 23 20 52 65 61 64 79 0a 0a  #####.## Ready..
09c0: 70 61 63 6b 61 67 65 20 70 72 6f 76 69 64 65 20  package provide 
09d0: 76 63 3a 3a 74 6f 6f 6c 73 3a 3a 74 72 6f 75 62  vc::tools::troub
09e0: 6c 65 20 31 2e 30 0a 72 65 74 75 72 6e 0a        le 1.0.return.