Documentation Source Text

Hex Artifact Content
Login

Artifact 30fb9f69de575101c4aed2930cf0fced50f3314c:


0000: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0010: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0020: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0030: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0040: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 0a  ###############.
0050: 23 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  # The following 
0060: 6d 61 63 72 6f 73 20 73 68 6f 75 6c 64 20 62 65  macros should be
0070: 20 64 65 66 69 6e 65 64 20 62 65 66 6f 72 65 20   defined before 
0080: 74 68 69 73 20 73 63 72 69 70 74 20 69 73 0a 23  this script is.#
0090: 20 69 6e 76 6f 6b 65 64 3a 0a 23 0a 23 20 44 4f   invoked:.#.# DO
00a0: 43 20 20 20 20 20 20 20 20 20 20 20 20 20 20 54  C              T
00b0: 68 65 20 74 6f 70 6c 65 76 65 6c 20 64 69 72 65  he toplevel dire
00c0: 63 74 6f 72 79 20 6f 66 20 74 68 65 20 64 6f 63  ctory of the doc
00d0: 75 6d 65 6e 74 61 74 69 6f 6e 20 73 6f 75 72 63  umentation sourc
00e0: 65 20 74 72 65 65 2e 0a 23 0a 23 20 53 52 43 20  e tree..#.# SRC 
00f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 54 68 65               The
0100: 20 74 6f 70 6c 65 76 65 6c 20 64 69 72 65 63 74   toplevel direct
0110: 6f 72 79 20 6f 66 20 74 68 65 20 73 6f 75 72 63  ory of the sourc
0120: 65 20 63 6f 64 65 20 73 6f 75 72 63 65 20 74 72  e code source tr
0130: 65 65 2e 0a 23 0a 23 20 54 43 4c 53 51 4c 49 54  ee..#.# TCLSQLIT
0140: 45 33 43 20 20 20 20 20 20 4e 61 6d 65 20 6f 66  E3C      Name of
0150: 20 74 68 65 20 61 6d 61 6c 67 61 6d 61 74 69 6f   the amalgamatio
0160: 6e 20 73 6f 75 72 63 65 20 66 69 6c 65 0a 23 0a  n source file.#.
0170: 23 20 54 48 33 20 20 20 20 20 20 20 20 20 20 20  # TH3           
0180: 20 20 20 54 68 65 20 74 6f 70 6c 65 76 65 6c 20     The toplevel 
0190: 64 69 72 65 63 74 6f 72 79 20 66 6f 72 20 54 48  directory for TH
01a0: 33 2e 20 20 4d 61 79 20 62 65 20 61 6e 20 65 6d  3.  May be an em
01b0: 70 74 79 20 73 74 72 69 6e 67 2e 0a 23 0a 23 20  pty string..#.# 
01c0: 54 43 4c 46 4c 41 47 53 20 20 20 20 20 20 20 20  TCLFLAGS        
01d0: 20 45 78 74 72 61 20 43 2d 63 6f 6d 70 69 6c 65   Extra C-compile
01e0: 72 20 6f 70 74 69 6f 6e 73 20 6e 65 65 64 65 64  r options needed
01f0: 20 74 6f 20 6c 69 6e 6b 20 61 67 61 69 6e 73 74   to link against
0200: 20 54 43 4c 0a 23 0a 23 20 54 43 4c 53 54 55 42   TCL.#.# TCLSTUB
0210: 46 4c 41 47 53 20 20 20 20 20 45 78 74 72 61 20  FLAGS     Extra 
0220: 43 2d 63 6f 6d 70 69 6c 65 72 20 6f 70 74 69 6f  C-compiler optio
0230: 6e 73 20 6e 65 65 64 65 64 20 74 6f 20 6c 69 6e  ns needed to lin
0240: 6b 20 61 20 54 43 4c 20 65 78 74 65 6e 73 69 6f  k a TCL extensio
0250: 6e 0a 23 0a 23 20 4e 41 57 4b 20 20 20 20 20 20  n.#.# NAWK      
0260: 20 20 20 20 20 20 20 4e 61 77 6b 20 63 6f 6d 70         Nawk comp
0270: 61 74 69 62 6c 65 20 61 77 6b 20 70 72 6f 67 72  atible awk progr
0280: 61 6d 2e 20 20 4f 6c 64 65 72 20 28 6f 62 73 6f  am.  Older (obso
0290: 6c 65 74 65 3f 29 20 73 6f 6c 61 72 69 73 0a 23  lete?) solaris.#
02a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
02b0: 20 20 73 79 73 74 65 6d 73 20 6e 65 65 64 20 74    systems need t
02c0: 68 69 73 20 74 6f 20 61 76 6f 69 64 20 75 73 69  his to avoid usi
02d0: 6e 67 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20  ng the original 
02e0: 41 54 26 54 20 41 57 4b 2e 0a 23 0a 23 20 43 43  AT&T AWK..#.# CC
02f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 41                 A
0300: 20 43 2d 63 6f 6d 70 69 6c 65 72 20 61 6e 64 20   C-compiler and 
0310: 61 72 67 75 6d 65 6e 74 73 20 66 6f 72 20 62 75  arguments for bu
0320: 69 6c 64 69 6e 67 20 75 74 69 6c 69 74 79 20 70  ilding utility p
0330: 72 6f 67 72 61 6d 73 0a 23 0a 23 20 4f 6e 63 65  rograms.#.# Once
0340: 20 74 68 65 20 6d 61 63 72 6f 73 20 61 62 6f 76   the macros abov
0350: 65 20 61 72 65 20 64 65 66 69 6e 65 64 2c 20 74  e are defined, t
0360: 68 65 20 72 65 73 74 20 6f 66 20 74 68 69 73 20  he rest of this 
0370: 6d 61 6b 65 20 73 63 72 69 70 74 20 77 69 6c 6c  make script will
0380: 0a 23 20 62 75 69 6c 64 20 74 68 65 20 53 51 4c  .# build the SQL
0390: 69 74 65 20 6c 69 62 72 61 72 79 20 61 6e 64 20  ite library and 
03a0: 74 65 73 74 69 6e 67 20 74 6f 6f 6c 73 2e 0a 23  testing tools..#
03b0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
03c0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
03d0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
03e0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
03f0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 0a  ###############.
0400: 0a 64 65 66 61 75 6c 74 3a 09 0a 09 40 65 63 68  .default:...@ech
0410: 6f 20 27 6d 61 6b 65 20 62 61 73 65 3b 20 20 20  o 'make base;   
0420: 20 20 20 20 23 20 42 75 69 6c 64 20 62 61 73 65      # Build base
0430: 20 64 6f 63 75 6d 65 6e 74 73 27 0a 09 40 65 63   documents'..@ec
0440: 68 6f 20 27 6d 61 6b 65 20 65 76 69 64 65 6e 63  ho 'make evidenc
0450: 65 3b 20 20 20 23 20 47 61 74 68 65 72 20 65 76  e;   # Gather ev
0460: 69 64 65 6e 63 65 20 6d 61 72 6b 73 27 0a 09 40  idence marks'..@
0470: 65 63 68 6f 20 27 6d 61 6b 65 20 6d 61 74 72 69  echo 'make matri
0480: 78 3b 20 20 20 20 20 23 20 42 75 69 6c 64 20 74  x;     # Build t
0490: 68 65 20 74 72 61 63 65 61 62 69 6c 69 74 79 20  he traceability 
04a0: 6d 61 74 72 69 78 27 0a 09 40 65 63 68 6f 20 27  matrix'..@echo '
04b0: 6d 61 6b 65 20 61 6c 6c 3b 20 20 20 20 20 20 20  make all;       
04c0: 20 23 20 44 6f 20 61 6c 6c 20 6f 66 20 74 68 65   # Do all of the
04d0: 20 61 62 6f 76 65 27 0a 0a 61 6c 6c 3a 09 62 61   above'..all:.ba
04e0: 73 65 20 65 76 69 64 65 6e 63 65 20 66 6f 72 6d  se evidence form
04f0: 61 74 5f 65 76 69 64 65 6e 63 65 20 6d 61 74 72  at_evidence matr
0500: 69 78 20 64 6f 63 0a 0a 70 72 69 76 61 74 65 3a  ix doc..private:
0510: 09 62 61 73 65 20 65 76 69 64 65 6e 63 65 20 70  .base evidence p
0520: 72 69 76 61 74 65 5f 65 76 69 64 65 6e 63 65 20  rivate_evidence 
0530: 6d 61 74 72 69 78 20 64 6f 63 0a 0a 74 63 6c 73  matrix doc..tcls
0540: 68 3a 09 24 28 54 43 4c 53 51 4c 49 54 45 33 43  h:.$(TCLSQLITE3C
0550: 29 0a 09 24 28 43 43 29 20 2d 67 20 2d 6f 20 74  )..$(CC) -g -o t
0560: 63 6c 73 68 20 2d 44 53 51 4c 49 54 45 5f 45 4e  clsh -DSQLITE_EN
0570: 41 42 4c 45 5f 46 54 53 33 20 2d 44 54 43 4c 53  ABLE_FTS3 -DTCLS
0580: 48 3d 31 20 2d 44 53 51 4c 49 54 45 5f 54 43 4c  H=1 -DSQLITE_TCL
0590: 4d 44 35 20 24 28 54 43 4c 49 4e 43 29 20 24 28  MD5 $(TCLINC) $(
05a0: 54 43 4c 53 51 4c 49 54 45 33 43 29 20 24 28 54  TCLSQLITE3C) $(T
05b0: 43 4c 46 4c 41 47 53 29 0a 0a 74 63 6c 73 71 6c  CLFLAGS)..tclsql
05c0: 69 74 65 33 2e 66 74 73 33 3a 09 24 28 54 43 4c  ite3.fts3:.$(TCL
05d0: 53 51 4c 49 54 45 33 43 29 20 24 28 44 4f 43 29  SQLITE3C) $(DOC)
05e0: 2f 73 65 61 72 63 68 2f 73 65 61 72 63 68 63 2e  /search/searchc.
05f0: 63 0a 09 24 28 43 43 29 20 2d 73 74 61 74 69 63  c..$(CC) -static
0600: 20 2d 4f 32 20 2d 6f 20 74 63 6c 73 71 6c 69 74   -O2 -o tclsqlit
0610: 65 33 2e 66 74 73 33 20 2d 44 53 51 4c 49 54 45  e3.fts3 -DSQLITE
0620: 5f 45 4e 41 42 4c 45 5f 46 54 53 33 20 24 28 54  _ENABLE_FTS3 $(T
0630: 43 4c 49 4e 43 29 20 24 28 44 4f 43 29 2f 73 65  CLINC) $(DOC)/se
0640: 61 72 63 68 2f 73 65 61 72 63 68 63 2e 63 20 24  arch/searchc.c $
0650: 28 54 43 4c 53 51 4c 49 54 45 33 43 29 20 24 28  (TCLSQLITE3C) $(
0660: 54 43 4c 46 4c 41 47 53 29 0a 0a 73 71 6c 69 74  TCLFLAGS)..sqlit
0670: 65 33 2e 68 3a 09 74 63 6c 73 68 20 24 28 53 52  e3.h:.tclsh $(SR
0680: 43 29 2f 73 72 63 2f 73 71 6c 69 74 65 2e 68 2e  C)/src/sqlite.h.
0690: 69 6e 20 24 28 53 52 43 29 2f 6d 61 6e 69 66 65  in $(SRC)/manife
06a0: 73 74 2e 75 75 69 64 20 24 28 53 52 43 29 2f 56  st.uuid $(SRC)/V
06b0: 45 52 53 49 4f 4e 0a 09 2e 2f 74 63 6c 73 68 20  ERSION.../tclsh 
06c0: 24 28 53 52 43 29 2f 74 6f 6f 6c 2f 6d 6b 73 71  $(SRC)/tool/mksq
06d0: 6c 69 74 65 33 68 2e 74 63 6c 20 24 28 53 52 43  lite3h.tcl $(SRC
06e0: 29 20 7c 20 5c 0a 09 73 65 64 20 27 73 2f 5e 53  ) | \..sed 's/^S
06f0: 51 4c 49 54 45 5f 41 50 49 20 2f 2f 27 20 3e 73  QLITE_API //' >s
0700: 71 6c 69 74 65 33 2e 68 0a 0a 23 20 47 65 6e 65  qlite3.h..# Gene
0710: 72 61 74 65 20 74 68 65 20 64 69 72 65 63 74 6f  rate the directo
0720: 72 79 20 69 6e 74 6f 20 77 68 69 63 68 20 67 65  ry into which ge
0730: 6e 65 72 61 74 65 64 20 64 6f 63 75 6d 65 6e 74  nerated document
0740: 61 74 69 6f 6e 20 66 69 6c 65 73 20 77 69 6c 6c  ation files will
0750: 0a 23 20 62 65 20 77 72 69 74 74 65 6e 2e 0a 23  .# be written..#
0760: 0a 64 6f 63 64 69 72 3a 0a 09 6d 6b 64 69 72 20  .docdir:..mkdir 
0770: 2d 70 20 64 6f 63 20 64 6f 63 2f 63 33 72 65 66  -p doc doc/c3ref
0780: 20 64 6f 63 2f 6d 61 74 72 69 78 20 64 6f 63 2f   doc/matrix doc/
0790: 6d 61 74 72 69 78 2f 63 33 72 65 66 0a 0a 23 20  matrix/c3ref..# 
07a0: 54 68 69 73 20 72 75 6c 65 20 67 65 6e 65 72 61  This rule genera
07b0: 74 65 73 20 61 6c 6c 20 64 6f 63 75 6d 65 6e 74  tes all document
07c0: 69 6f 6e 20 66 69 6c 65 73 20 66 72 6f 6d 20 74  ion files from t
07d0: 68 65 69 72 20 73 6f 75 72 63 65 73 2e 20 20 54  heir sources.  T
07e0: 68 65 0a 23 20 73 70 65 63 69 61 6c 20 6d 61 72  he.# special mar
07f0: 6b 75 70 20 6f 6e 20 48 54 4d 4c 20 66 69 6c 65  kup on HTML file
0800: 73 20 75 73 65 64 20 74 6f 20 69 64 65 6e 74 69  s used to identi
0810: 66 79 20 74 65 73 74 61 62 6c 65 20 73 74 61 74  fy testable stat
0820: 65 6d 65 6e 74 73 20 61 6e 64 0a 23 20 72 65 71  ements and.# req
0830: 75 69 72 65 6d 65 6e 74 73 20 61 72 65 20 72 65  uirements are re
0840: 74 61 69 6e 65 64 20 69 6e 20 74 68 65 20 48 54  tained in the HT
0850: 4d 4c 20 61 6e 64 20 73 6f 20 74 68 65 20 48 54  ML and so the HT
0860: 4d 4c 20 67 65 6e 65 72 61 74 65 64 20 62 79 0a  ML generated by.
0870: 23 20 74 68 69 73 20 72 75 6c 65 20 69 73 20 6e  # this rule is n
0880: 6f 74 20 73 75 69 74 61 62 6c 65 20 66 6f 72 20  ot suitable for 
0890: 70 75 62 6c 69 63 61 74 69 6f 6e 2e 20 20 54 68  publication.  Th
08a0: 69 73 20 69 73 20 74 68 65 20 66 69 72 73 74 20  is is the first 
08b0: 73 74 65 70 0a 23 20 6f 6e 6c 79 2e 0a 23 0a 62  step.# only..#.b
08c0: 61 73 65 3a 09 74 63 6c 73 68 20 73 71 6c 69 74  ase:.tclsh sqlit
08d0: 65 33 2e 68 20 64 6f 63 64 69 72 20 61 6c 77 61  e3.h docdir alwa
08e0: 79 73 20 70 61 72 73 65 68 74 6d 6c 2e 73 6f 0a  ys parsehtml.so.
08f0: 09 72 6d 20 2d 72 66 20 64 6f 63 2f 69 6d 61 67  .rm -rf doc/imag
0900: 65 73 0a 09 63 70 20 2d 72 20 24 28 44 4f 43 29  es..cp -r $(DOC)
0910: 2f 69 6d 61 67 65 73 20 64 6f 63 0a 09 63 70 20  /images doc..cp 
0920: 24 28 53 52 43 29 2f 61 72 74 2f 2a 2e 67 69 66  $(SRC)/art/*.gif
0930: 20 64 6f 63 2f 69 6d 61 67 65 73 0a 09 6d 6b 64   doc/images..mkd
0940: 69 72 20 64 6f 63 2f 69 6d 61 67 65 73 2f 73 79  ir doc/images/sy
0950: 6e 74 61 78 0a 09 63 70 20 24 28 44 4f 43 29 2f  ntax..cp $(DOC)/
0960: 61 72 74 2f 73 79 6e 74 61 78 2f 2a 2e 67 69 66  art/syntax/*.gif
0970: 20 64 6f 63 2f 69 6d 61 67 65 73 2f 73 79 6e 74   doc/images/synt
0980: 61 78 0a 09 63 70 20 24 28 44 4f 43 29 2f 72 61  ax..cp $(DOC)/ra
0990: 77 70 61 67 65 73 2f 2a 20 64 6f 63 0a 09 2e 2f  wpages/* doc.../
09a0: 74 63 6c 73 68 20 24 28 44 4f 43 29 2f 77 72 61  tclsh $(DOC)/wra
09b0: 70 2e 74 63 6c 20 24 28 44 4f 43 29 20 24 28 53  p.tcl $(DOC) $(S
09c0: 52 43 29 20 64 6f 63 20 24 28 44 4f 43 29 2f 70  RC) doc $(DOC)/p
09d0: 61 67 65 73 2f 2a 2e 69 6e 0a 0a 23 20 53 74 72  ages/*.in..# Str
09e0: 69 70 20 74 68 65 20 73 70 65 63 69 61 6c 20 6d  ip the special m
09f0: 61 72 6b 75 70 20 69 6e 20 48 54 4d 4c 20 66 69  arkup in HTML fi
0a00: 6c 65 73 20 74 68 61 74 20 69 64 65 6e 74 69 66  les that identif
0a10: 69 65 73 20 74 65 73 74 61 62 6c 65 20 73 74 61  ies testable sta
0a20: 74 65 6d 65 6e 74 73 0a 23 20 61 6e 64 20 72 65  tements.# and re
0a30: 71 75 69 72 65 6d 65 6e 74 73 2e 0a 23 0a 64 6f  quirements..#.do
0a40: 63 3a 09 61 6c 77 61 79 73 20 24 28 44 4f 43 29  c:.always $(DOC)
0a50: 2f 72 65 6d 6f 76 65 5f 63 61 72 65 74 73 2e 73  /remove_carets.s
0a60: 68 0a 09 73 68 20 24 28 44 4f 43 29 2f 72 65 6d  h..sh $(DOC)/rem
0a70: 6f 76 65 5f 63 61 72 65 74 73 2e 73 68 20 64 6f  ove_carets.sh do
0a80: 63 0a 0a 0a 23 20 43 6f 6e 73 74 72 75 63 74 20  c...# Construct 
0a90: 74 68 65 20 64 61 74 61 62 61 73 65 20 73 63 68  the database sch
0aa0: 65 6d 61 2e 0a 23 0a 73 63 68 65 6d 61 3a 09 74  ema..#.schema:.t
0ab0: 63 6c 73 68 0a 09 2e 2f 74 63 6c 73 68 20 24 28  clsh.../tclsh $(
0ac0: 44 4f 43 29 2f 73 63 68 65 6d 61 2e 74 63 6c 0a  DOC)/schema.tcl.
0ad0: 0a 23 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  .# The following
0ae0: 20 72 75 6c 65 20 73 63 61 6e 73 20 73 71 6c 69   rule scans sqli
0af0: 74 65 33 2e 63 20 73 6f 75 72 63 65 20 74 65 78  te3.c source tex
0b00: 74 2c 20 74 68 65 20 74 65 78 74 20 6f 66 20 74  t, the text of t
0b10: 68 65 20 54 43 4c 0a 23 20 74 65 73 74 20 63 61  he TCL.# test ca
0b20: 73 65 73 2c 20 61 6e 64 20 28 6f 70 74 69 6f 6e  ses, and (option
0b30: 61 6c 6c 79 29 20 74 68 65 20 54 48 33 20 74 65  ally) the TH3 te
0b40: 73 74 20 63 61 73 65 20 73 6f 75 72 63 65 73 20  st case sources 
0b50: 6c 6f 6f 6b 69 6e 67 20 66 6f 72 0a 23 20 63 6f  looking for.# co
0b60: 6d 6d 65 6e 74 73 20 74 68 61 74 20 69 64 65 6e  mments that iden
0b70: 74 69 66 79 20 61 73 73 65 72 74 69 6f 6e 73 20  tify assertions 
0b80: 61 6e 64 20 74 65 73 74 20 63 61 73 65 73 20 74  and test cases t
0b90: 68 61 74 20 70 72 6f 76 69 64 65 20 65 76 69 64  hat provide evid
0ba0: 65 6e 63 65 0a 23 20 74 68 61 74 20 53 51 4c 69  ence.# that SQLi
0bb0: 74 65 20 62 65 68 61 76 65 73 20 61 73 20 69 74  te behaves as it
0bc0: 20 73 61 79 73 20 69 74 20 64 6f 65 73 2e 20 20   says it does.  
0bd0: 53 65 65 20 74 68 65 20 63 6f 6d 6d 65 6e 74 73  See the comments
0be0: 20 69 6e 20 0a 23 20 73 63 61 6e 5f 74 65 73 74   in .# scan_test
0bf0: 5f 63 61 73 65 73 2e 74 63 6c 20 66 6f 72 20 61  _cases.tcl for a
0c00: 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d  dditional inform
0c10: 61 74 69 6f 6e 2e 0a 23 0a 23 20 54 68 65 20 6f  ation..#.# The o
0c20: 75 74 70 75 74 20 66 69 6c 65 20 65 76 69 64 65  utput file evide
0c30: 6e 63 65 2e 74 78 74 20 69 73 20 75 73 65 64 20  nce.txt is used 
0c40: 62 79 20 72 65 71 75 69 72 65 6d 65 6e 74 73 20  by requirements 
0c50: 63 6f 76 65 72 61 67 65 20 61 6e 61 6c 79 73 69  coverage analysi
0c60: 73 2e 0a 23 0a 53 43 41 4e 4e 45 52 20 3d 20 24  s..#.SCANNER = $
0c70: 28 44 4f 43 29 2f 73 63 61 6e 5f 74 65 73 74 5f  (DOC)/scan_test_
0c80: 63 61 73 65 73 2e 74 63 6c 0a 0a 65 76 69 64 65  cases.tcl..evide
0c90: 6e 63 65 3a 09 74 63 6c 73 68 0a 09 2e 2f 74 63  nce:.tclsh.../tc
0ca0: 6c 73 68 20 24 28 53 43 41 4e 4e 45 52 29 20 2d  lsh $(SCANNER) -
0cb0: 72 65 73 65 74 20 73 72 63 20 24 28 53 52 43 29  reset src $(SRC)
0cc0: 2f 73 72 63 2f 2a 2e 5b 63 68 79 5d 0a 09 2e 2f  /src/*.[chy].../
0cd0: 74 63 6c 73 68 20 24 28 53 43 41 4e 4e 45 52 29  tclsh $(SCANNER)
0ce0: 20 73 72 63 20 24 28 53 52 43 29 2f 65 78 74 2f   src $(SRC)/ext/
0cf0: 66 74 73 33 2f 2a 2e 5b 63 68 5d 0a 09 2e 2f 74  fts3/*.[ch].../t
0d00: 63 6c 73 68 20 24 28 53 43 41 4e 4e 45 52 29 20  clsh $(SCANNER) 
0d10: 73 72 63 20 24 28 53 52 43 29 2f 65 78 74 2f 72  src $(SRC)/ext/r
0d20: 74 72 65 65 2f 2a 2e 5b 63 68 5d 0a 09 2e 2f 74  tree/*.[ch].../t
0d30: 63 6c 73 68 20 24 28 53 43 41 4e 4e 45 52 29 20  clsh $(SCANNER) 
0d40: 74 63 6c 20 24 28 53 52 43 29 2f 74 65 73 74 2f  tcl $(SRC)/test/
0d50: 2a 2e 74 65 73 74 0a 09 69 66 20 74 65 73 74 20  *.test..if test 
0d60: 27 27 20 21 3d 20 27 24 28 54 48 33 29 27 3b 20  '' != '$(TH3)'; 
0d70: 74 68 65 6e 20 5c 0a 09 20 20 2e 2f 74 63 6c 73  then \..  ./tcls
0d80: 68 20 24 28 53 43 41 4e 4e 45 52 29 20 74 68 33  h $(SCANNER) th3
0d90: 20 24 28 54 48 33 29 2f 6d 6b 74 68 33 2e 74 63   $(TH3)/mkth3.tc
0da0: 6c 3b 20 5c 0a 09 20 20 2e 2f 74 63 6c 73 68 20  l; \..  ./tclsh 
0db0: 24 28 53 43 41 4e 4e 45 52 29 20 74 68 33 2f 72  $(SCANNER) th3/r
0dc0: 65 71 31 20 24 28 54 48 33 29 2f 72 65 71 31 2f  eq1 $(TH3)/req1/
0dd0: 2a 2e 74 65 73 74 3b 20 5c 0a 09 20 20 2e 2f 74  *.test; \..  ./t
0de0: 63 6c 73 68 20 24 28 53 43 41 4e 4e 45 52 29 20  clsh $(SCANNER) 
0df0: 74 68 33 2f 63 6f 76 31 20 24 28 54 48 33 29 2f  th3/cov1 $(TH3)/
0e00: 63 6f 76 31 2f 2a 2e 74 65 73 74 3b 20 5c 0a 09  cov1/*.test; \..
0e10: 66 69 0a 0a 23 20 43 6f 70 79 20 61 6e 64 20 48  fi..# Copy and H
0e20: 54 4d 4c 69 7a 65 20 65 76 69 64 65 6e 63 65 20  TMLize evidence 
0e30: 66 69 6c 65 73 0a 23 0a 46 4d 54 20 3d 20 24 28  files.#.FMT = $(
0e40: 44 4f 43 29 2f 66 6f 72 6d 61 74 5f 65 76 69 64  DOC)/format_evid
0e50: 65 6e 63 65 2e 74 63 6c 0a 0a 66 6f 72 6d 61 74  ence.tcl..format
0e60: 5f 65 76 69 64 65 6e 63 65 3a 20 74 63 6c 73 68  _evidence: tclsh
0e70: 0a 09 72 6d 20 2d 66 72 20 64 6f 63 2f 6d 61 74  ..rm -fr doc/mat
0e80: 72 69 78 2f 65 76 2f 2a 0a 09 2e 2f 74 63 6c 73  rix/ev/*.../tcls
0e90: 68 20 24 28 46 4d 54 29 20 73 72 63 20 64 6f 63  h $(FMT) src doc
0ea0: 2f 6d 61 74 72 69 78 20 24 28 53 52 43 29 2f 73  /matrix $(SRC)/s
0eb0: 72 63 2f 2a 2e 5b 63 68 79 5d 0a 09 2e 2f 74 63  rc/*.[chy].../tc
0ec0: 6c 73 68 20 24 28 46 4d 54 29 20 73 72 63 20 64  lsh $(FMT) src d
0ed0: 6f 63 2f 6d 61 74 72 69 78 20 24 28 53 52 43 29  oc/matrix $(SRC)
0ee0: 2f 65 78 74 2f 66 74 73 33 2f 2a 2e 5b 63 68 5d  /ext/fts3/*.[ch]
0ef0: 0a 09 2e 2f 74 63 6c 73 68 20 24 28 46 4d 54 29  .../tclsh $(FMT)
0f00: 20 73 72 63 20 64 6f 63 2f 6d 61 74 72 69 78 20   src doc/matrix 
0f10: 24 28 53 52 43 29 2f 65 78 74 2f 72 74 72 65 65  $(SRC)/ext/rtree
0f20: 2f 2a 2e 5b 63 68 5d 0a 09 2e 2f 74 63 6c 73 68  /*.[ch].../tclsh
0f30: 20 24 28 46 4d 54 29 20 74 63 6c 20 64 6f 63 2f   $(FMT) tcl doc/
0f40: 6d 61 74 72 69 78 20 24 28 53 52 43 29 2f 74 65  matrix $(SRC)/te
0f50: 73 74 2f 2a 2e 74 65 73 74 0a 0a 70 72 69 76 61  st/*.test..priva
0f60: 74 65 5f 65 76 69 64 65 6e 63 65 3a 20 66 6f 72  te_evidence: for
0f70: 6d 61 74 5f 65 76 69 64 65 6e 63 65 0a 09 2e 2f  mat_evidence.../
0f80: 74 63 6c 73 68 20 24 28 46 4d 54 29 20 74 68 33  tclsh $(FMT) th3
0f90: 20 64 6f 63 2f 6d 61 74 72 69 78 20 24 28 54 48   doc/matrix $(TH
0fa0: 33 29 2f 6d 6b 74 68 33 2e 74 63 6c 0a 09 2e 2f  3)/mkth3.tcl.../
0fb0: 74 63 6c 73 68 20 24 28 46 4d 54 29 20 74 68 33  tclsh $(FMT) th3
0fc0: 2f 72 65 71 31 20 64 6f 63 2f 6d 61 74 72 69 78  /req1 doc/matrix
0fd0: 20 24 28 54 48 33 29 2f 72 65 71 31 2f 2a 2e 74   $(TH3)/req1/*.t
0fe0: 65 73 74 0a 09 2e 2f 74 63 6c 73 68 20 24 28 46  est.../tclsh $(F
0ff0: 4d 54 29 20 74 68 33 2f 63 6f 76 31 20 64 6f 63  MT) th3/cov1 doc
1000: 2f 6d 61 74 72 69 78 20 24 28 54 48 33 29 2f 63  /matrix $(TH3)/c
1010: 6f 76 31 2f 2a 2e 74 65 73 74 0a 0a 23 20 47 65  ov1/*.test..# Ge
1020: 6e 65 72 61 74 65 20 74 68 65 20 74 72 61 63 65  nerate the trace
1030: 61 62 69 6c 69 74 79 20 6d 61 74 72 69 78 0a 23  ability matrix.#
1040: 0a 6d 61 74 72 69 78 3a 09 0a 09 72 6d 20 2d 72  .matrix:...rm -r
1050: 66 20 64 6f 63 2f 6d 61 74 72 69 78 2f 69 6d 61  f doc/matrix/ima
1060: 67 65 73 0a 09 63 70 20 2d 72 20 64 6f 63 2f 69  ges..cp -r doc/i
1070: 6d 61 67 65 73 20 64 6f 63 2f 6d 61 74 72 69 78  mages doc/matrix
1080: 0a 09 2e 2f 74 63 6c 73 68 20 24 28 44 4f 43 29  .../tclsh $(DOC)
1090: 2f 6d 61 74 72 69 78 2e 74 63 6c 0a 0a 23 20 42  /matrix.tcl..# B
10a0: 75 69 6c 64 20 74 68 65 20 66 74 73 33 20 64 61  uild the fts3 da
10b0: 74 61 62 61 73 65 20 75 73 65 64 20 62 79 20 74  tabase used by t
10c0: 68 65 20 73 65 61 72 63 68 20 73 63 72 69 70 74  he search script
10d0: 0a 23 0a 70 61 72 73 65 68 74 6d 6c 2e 73 6f 3a  .#.parsehtml.so:
10e0: 20 24 28 44 4f 43 29 2f 73 65 61 72 63 68 2f 70   $(DOC)/search/p
10f0: 61 72 73 65 68 74 6d 6c 2e 63 0a 09 67 63 63 20  arsehtml.c..gcc 
1100: 2d 67 20 2d 73 68 61 72 65 64 20 2d 44 55 53 45  -g -shared -DUSE
1110: 5f 54 43 4c 5f 53 54 55 42 53 20 24 28 54 43 4c  _TCL_STUBS $(TCL
1120: 49 4e 43 29 20 2d 49 2e 20 2d 49 24 28 53 52 43  INC) -I. -I$(SRC
1130: 29 2f 65 78 74 2f 66 74 73 33 20 24 28 44 4f 43  )/ext/fts3 $(DOC
1140: 29 2f 73 65 61 72 63 68 2f 70 61 72 73 65 68 74  )/search/parseht
1150: 6d 6c 2e 63 20 24 28 54 43 4c 53 54 55 42 46 4c  ml.c $(TCLSTUBFL
1160: 41 47 53 29 20 2d 6f 20 70 61 72 73 65 68 74 6d  AGS) -o parsehtm
1170: 6c 2e 73 6f 0a 0a 73 65 61 72 63 68 64 62 3a 20  l.so..searchdb: 
1180: 70 61 72 73 65 68 74 6d 6c 2e 73 6f 20 74 63 6c  parsehtml.so tcl
1190: 73 68 0a 09 2e 2f 74 63 6c 73 68 20 24 28 44 4f  sh.../tclsh $(DO
11a0: 43 29 2f 73 65 61 72 63 68 2f 62 75 69 6c 64 73  C)/search/builds
11b0: 65 61 72 63 68 64 62 2e 74 63 6c 0a 09 63 70 20  earchdb.tcl..cp 
11c0: 24 28 44 4f 43 29 2f 73 65 61 72 63 68 2f 73 65  $(DOC)/search/se
11d0: 61 72 63 68 2e 74 63 6c 20 64 6f 63 2f 73 65 61  arch.tcl doc/sea
11e0: 72 63 68 0a 09 63 68 6d 6f 64 20 2b 78 20 64 6f  rch..chmod +x do
11f0: 63 2f 73 65 61 72 63 68 0a 0a 61 6c 77 61 79 73  c/search..always
1200: 3a 09 0a 0a 63 6c 65 61 6e 3a 09 0a 09 72 6d 20  :...clean:...rm 
1210: 2d 72 66 20 74 63 6c 73 68 20 64 6f 63 20 73 71  -rf tclsh doc sq
1220: 6c 69 74 65 33 2e 68 0a                          lite3.h.