Documentation Source Text

Hex Artifact Content
Login

Artifact f11cec12ce53cb2704bbd071ccacbc767fd80d99:


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: 53 4c 54 20 20 20 20 20 20 20 20 20 20 20 20 20  SLT             
01d0: 20 54 68 65 20 74 6f 70 6c 65 76 65 6c 20 64 69   The toplevel di
01e0: 72 65 63 74 6f 72 79 20 66 6f 72 20 53 51 4c 4c  rectory for SQLL
01f0: 6f 67 69 63 54 65 73 74 2e 20 20 4d 61 79 20 62  ogicTest.  May b
0200: 65 20 61 6e 0a 23 20 20 20 20 20 20 20 20 20 20  e an.#          
0210: 20 20 20 20 20 20 20 20 65 6d 70 74 79 20 73 74          empty st
0220: 72 69 6e 67 0a 23 0a 23 20 54 43 4c 46 4c 41 47  ring.#.# TCLFLAG
0230: 53 20 20 20 20 20 20 20 20 20 45 78 74 72 61 20  S         Extra 
0240: 43 2d 63 6f 6d 70 69 6c 65 72 20 6f 70 74 69 6f  C-compiler optio
0250: 6e 73 20 6e 65 65 64 65 64 20 74 6f 20 6c 69 6e  ns needed to lin
0260: 6b 20 61 67 61 69 6e 73 74 20 54 43 4c 0a 23 0a  k against TCL.#.
0270: 23 20 54 43 4c 53 54 55 42 46 4c 41 47 53 20 20  # TCLSTUBFLAGS  
0280: 20 20 20 45 78 74 72 61 20 43 2d 63 6f 6d 70 69     Extra C-compi
0290: 6c 65 72 20 6f 70 74 69 6f 6e 73 20 6e 65 65 64  ler options need
02a0: 65 64 20 74 6f 20 6c 69 6e 6b 20 61 20 54 43 4c  ed to link a TCL
02b0: 20 65 78 74 65 6e 73 69 6f 6e 0a 23 0a 23 20 4e   extension.#.# N
02c0: 41 57 4b 20 20 20 20 20 20 20 20 20 20 20 20 20  AWK             
02d0: 4e 61 77 6b 20 63 6f 6d 70 61 74 69 62 6c 65 20  Nawk compatible 
02e0: 61 77 6b 20 70 72 6f 67 72 61 6d 2e 20 20 4f 6c  awk program.  Ol
02f0: 64 65 72 20 28 6f 62 73 6f 6c 65 74 65 3f 29 20  der (obsolete?) 
0300: 73 6f 6c 61 72 69 73 0a 23 20 20 20 20 20 20 20  solaris.#       
0310: 20 20 20 20 20 20 20 20 20 20 20 73 79 73 74 65             syste
0320: 6d 73 20 6e 65 65 64 20 74 68 69 73 20 74 6f 20  ms need this to 
0330: 61 76 6f 69 64 20 75 73 69 6e 67 20 74 68 65 20  avoid using the 
0340: 6f 72 69 67 69 6e 61 6c 20 41 54 26 54 20 41 57  original AT&T AW
0350: 4b 2e 0a 23 0a 23 20 43 43 20 20 20 20 20 20 20  K..#.# CC       
0360: 20 20 20 20 20 20 20 20 41 20 43 2d 63 6f 6d 70          A C-comp
0370: 69 6c 65 72 20 61 6e 64 20 61 72 67 75 6d 65 6e  iler and argumen
0380: 74 73 20 66 6f 72 20 62 75 69 6c 64 69 6e 67 20  ts for building 
0390: 75 74 69 6c 69 74 79 20 70 72 6f 67 72 61 6d 73  utility programs
03a0: 0a 23 0a 23 20 4f 6e 63 65 20 74 68 65 20 6d 61  .#.# Once the ma
03b0: 63 72 6f 73 20 61 62 6f 76 65 20 61 72 65 20 64  cros above are d
03c0: 65 66 69 6e 65 64 2c 20 74 68 65 20 72 65 73 74  efined, the rest
03d0: 20 6f 66 20 74 68 69 73 20 6d 61 6b 65 20 73 63   of this make sc
03e0: 72 69 70 74 20 77 69 6c 6c 0a 23 20 62 75 69 6c  ript will.# buil
03f0: 64 20 74 68 65 20 53 51 4c 69 74 65 20 6c 69 62  d the SQLite lib
0400: 72 61 72 79 20 61 6e 64 20 74 65 73 74 69 6e 67  rary and testing
0410: 20 74 6f 6f 6c 73 2e 0a 23 23 23 23 23 23 23 23   tools..########
0420: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0430: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0440: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0450: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0460: 23 23 23 23 23 23 23 23 0a 0a 54 43 4c 53 48 20  ########..TCLSH 
0470: 3d 20 74 63 6c 73 68 2e 64 6f 63 73 72 63 0a 0a  = tclsh.docsrc..
0480: 64 65 66 61 75 6c 74 3a 09 0a 09 40 65 63 68 6f  default:...@echo
0490: 20 27 6d 61 6b 65 20 62 61 73 65 3b 20 20 20 20   'make base;    
04a0: 20 20 20 23 20 42 75 69 6c 64 20 62 61 73 65 20     # Build base 
04b0: 64 6f 63 75 6d 65 6e 74 73 27 0a 09 40 65 63 68  documents'..@ech
04c0: 6f 20 27 6d 61 6b 65 20 65 76 69 64 65 6e 63 65  o 'make evidence
04d0: 3b 20 20 20 23 20 47 61 74 68 65 72 20 65 76 69  ;   # Gather evi
04e0: 64 65 6e 63 65 20 6d 61 72 6b 73 27 0a 09 40 65  dence marks'..@e
04f0: 63 68 6f 20 27 6d 61 6b 65 20 6d 61 74 72 69 78  cho 'make matrix
0500: 3b 20 20 20 20 20 23 20 42 75 69 6c 64 20 74 68  ;     # Build th
0510: 65 20 74 72 61 63 65 61 62 69 6c 69 74 79 20 6d  e traceability m
0520: 61 74 72 69 78 27 0a 09 40 65 63 68 6f 20 27 6d  atrix'..@echo 'm
0530: 61 6b 65 20 61 6c 6c 3b 20 20 20 20 20 20 20 20  ake all;        
0540: 23 20 44 6f 20 61 6c 6c 20 6f 66 20 74 68 65 20  # Do all of the 
0550: 61 62 6f 76 65 27 0a 09 40 65 63 68 6f 20 27 6d  above'..@echo 'm
0560: 61 6b 65 20 73 70 65 6c 6c 3b 20 20 20 20 20 20  ake spell;      
0570: 23 20 53 70 65 6c 6c 20 63 68 65 63 6b 20 67 65  # Spell check ge
0580: 6e 65 72 61 74 65 64 20 64 6f 63 73 27 0a 09 40  nerated docs'..@
0590: 65 63 68 6f 20 27 6d 61 6b 65 20 66 61 73 74 3b  echo 'make fast;
05a0: 20 20 20 20 20 20 20 23 20 42 75 69 6c 64 20 64         # Build d
05b0: 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 6f 6e 6c  ocumentation onl
05c0: 79 20 2d 20 6e 6f 20 72 65 71 75 69 72 65 6d 65  y - no requireme
05d0: 6e 74 73 27 0a 09 40 65 63 68 6f 20 27 6d 61 6b  nts'..@echo 'mak
05e0: 65 20 73 63 68 65 6d 61 3b 20 20 20 20 20 23 20  e schema;     # 
05f0: 52 75 6e 20 6f 6e 63 65 20 74 6f 20 69 6e 69 74  Run once to init
0600: 69 61 6c 69 7a 65 20 74 68 65 20 62 75 69 6c 64  ialize the build
0610: 20 70 72 6f 63 65 73 73 27 0a 0a 61 6c 6c 3a 09   process'..all:.
0620: 62 61 73 65 20 65 76 69 64 65 6e 63 65 20 66 6f  base evidence fo
0630: 72 6d 61 74 5f 65 76 69 64 65 6e 63 65 20 6d 61  rmat_evidence ma
0640: 74 72 69 78 20 64 6f 63 0a 0a 70 72 69 76 61 74  trix doc..privat
0650: 65 3a 09 62 61 73 65 20 65 76 69 64 65 6e 63 65  e:.base evidence
0660: 20 70 72 69 76 61 74 65 5f 65 76 69 64 65 6e 63   private_evidenc
0670: 65 20 6d 61 74 72 69 78 20 64 6f 63 0a 0a 66 61  e matrix doc..fa
0680: 73 74 3a 09 62 61 73 65 20 64 6f 63 0a 0a 73 71  st:.base doc..sq
0690: 6c 69 74 65 33 2e 68 3a 20 24 28 54 43 4c 53 48  lite3.h: $(TCLSH
06a0: 29 20 24 28 53 52 43 29 2f 73 72 63 2f 73 71 6c  ) $(SRC)/src/sql
06b0: 69 74 65 2e 68 2e 69 6e 20 24 28 53 52 43 29 2f  ite.h.in $(SRC)/
06c0: 6d 61 6e 69 66 65 73 74 2e 75 75 69 64 20 24 28  manifest.uuid $(
06d0: 53 52 43 29 2f 56 45 52 53 49 4f 4e 0a 09 2e 2f  SRC)/VERSION.../
06e0: 24 28 54 43 4c 53 48 29 20 24 28 53 52 43 29 2f  $(TCLSH) $(SRC)/
06f0: 74 6f 6f 6c 2f 6d 6b 73 71 6c 69 74 65 33 68 2e  tool/mksqlite3h.
0700: 74 63 6c 20 24 28 53 52 43 29 20 7c 20 5c 0a 09  tcl $(SRC) | \..
0710: 73 65 64 20 27 73 2f 5e 53 51 4c 49 54 45 5f 41  sed 's/^SQLITE_A
0720: 50 49 20 2f 2f 27 20 3e 73 71 6c 69 74 65 33 2e  PI //' >sqlite3.
0730: 68 0a 0a 23 20 47 65 6e 65 72 61 74 65 20 74 68  h..# Generate th
0740: 65 20 64 69 72 65 63 74 6f 72 79 20 69 6e 74 6f  e directory into
0750: 20 77 68 69 63 68 20 67 65 6e 65 72 61 74 65 64   which generated
0760: 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 66   documentation f
0770: 69 6c 65 73 20 77 69 6c 6c 0a 23 20 62 65 20 77  iles will.# be w
0780: 72 69 74 74 65 6e 2e 0a 23 0a 64 6f 63 64 69 72  ritten..#.docdir
0790: 3a 0a 09 6d 6b 64 69 72 20 2d 70 20 64 6f 63 20  :..mkdir -p doc 
07a0: 64 6f 63 2f 63 33 72 65 66 20 64 6f 63 2f 6d 61  doc/c3ref doc/ma
07b0: 74 72 69 78 20 64 6f 63 2f 6d 61 74 72 69 78 2f  trix doc/matrix/
07c0: 63 33 72 65 66 20 64 6f 63 2f 6d 61 74 72 69 78  c3ref doc/matrix
07d0: 2f 73 79 6e 74 61 78 0a 0a 23 20 54 68 69 73 20  /syntax..# This 
07e0: 72 75 6c 65 20 67 65 6e 65 72 61 74 65 73 20 61  rule generates a
07f0: 6c 6c 20 64 6f 63 75 6d 65 6e 74 69 6f 6e 20 66  ll documention f
0800: 69 6c 65 73 20 66 72 6f 6d 20 74 68 65 69 72 20  iles from their 
0810: 73 6f 75 72 63 65 73 2e 20 20 54 68 65 0a 23 20  sources.  The.# 
0820: 73 70 65 63 69 61 6c 20 6d 61 72 6b 75 70 20 6f  special markup o
0830: 6e 20 48 54 4d 4c 20 66 69 6c 65 73 20 75 73 65  n HTML files use
0840: 64 20 74 6f 20 69 64 65 6e 74 69 66 79 20 74 65  d to identify te
0850: 73 74 61 62 6c 65 20 73 74 61 74 65 6d 65 6e 74  stable statement
0860: 73 20 61 6e 64 0a 23 20 72 65 71 75 69 72 65 6d  s and.# requirem
0870: 65 6e 74 73 20 61 72 65 20 72 65 74 61 69 6e 65  ents are retaine
0880: 64 20 69 6e 20 74 68 65 20 48 54 4d 4c 20 61 6e  d in the HTML an
0890: 64 20 73 6f 20 74 68 65 20 48 54 4d 4c 20 67 65  d so the HTML ge
08a0: 6e 65 72 61 74 65 64 20 62 79 0a 23 20 74 68 69  nerated by.# thi
08b0: 73 20 72 75 6c 65 20 69 73 20 6e 6f 74 20 73 75  s rule is not su
08c0: 69 74 61 62 6c 65 20 66 6f 72 20 70 75 62 6c 69  itable for publi
08d0: 63 61 74 69 6f 6e 2e 20 20 54 68 69 73 20 69 73  cation.  This is
08e0: 20 74 68 65 20 66 69 72 73 74 20 73 74 65 70 0a   the first step.
08f0: 23 20 6f 6e 6c 79 2e 0a 23 0a 62 61 73 65 3a 09  # only..#.base:.
0900: 24 28 54 43 4c 53 48 29 20 73 71 6c 69 74 65 33  $(TCLSH) sqlite3
0910: 2e 68 20 64 6f 63 64 69 72 20 61 6c 77 61 79 73  .h docdir always
0920: 20 0a 09 72 6d 20 2d 72 66 20 64 6f 63 2f 69 6d   ..rm -rf doc/im
0930: 61 67 65 73 0a 09 63 70 20 2d 72 20 24 28 44 4f  ages..cp -r $(DO
0940: 43 29 2f 69 6d 61 67 65 73 20 64 6f 63 0a 09 6d  C)/images doc..m
0950: 6b 64 69 72 20 64 6f 63 2f 69 6d 61 67 65 73 2f  kdir doc/images/
0960: 73 79 6e 74 61 78 0a 09 63 70 20 24 28 44 4f 43  syntax..cp $(DOC
0970: 29 2f 61 72 74 2f 73 79 6e 74 61 78 2f 2a 2e 67  )/art/syntax/*.g
0980: 69 66 20 64 6f 63 2f 69 6d 61 67 65 73 2f 73 79  if doc/images/sy
0990: 6e 74 61 78 0a 09 63 70 20 24 28 44 4f 43 29 2f  ntax..cp $(DOC)/
09a0: 72 61 77 70 61 67 65 73 2f 2a 20 64 6f 63 0a 09  rawpages/* doc..
09b0: 2e 2f 24 28 54 43 4c 53 48 29 20 24 28 44 4f 43  ./$(TCLSH) $(DOC
09c0: 29 2f 77 72 61 70 2e 74 63 6c 20 24 28 44 4f 43  )/wrap.tcl $(DOC
09d0: 29 20 24 28 53 52 43 29 20 64 6f 63 20 24 28 44  ) $(SRC) doc $(D
09e0: 4f 43 29 2f 70 61 67 65 73 2f 2a 2e 69 6e 0a 09  OC)/pages/*.in..
09f0: 63 70 20 64 6f 63 2f 66 69 6c 65 66 6f 72 6d 61  cp doc/fileforma
0a00: 74 32 2e 68 74 6d 6c 20 64 6f 63 2f 66 69 6c 65  t2.html doc/file
0a10: 66 6f 72 6d 61 74 2e 68 74 6d 6c 0a 0a 23 20 53  format.html..# S
0a20: 74 72 69 70 20 74 68 65 20 73 70 65 63 69 61 6c  trip the special
0a30: 20 6d 61 72 6b 75 70 20 69 6e 20 48 54 4d 4c 20   markup in HTML 
0a40: 66 69 6c 65 73 20 74 68 61 74 20 69 64 65 6e 74  files that ident
0a50: 69 66 69 65 73 20 74 65 73 74 61 62 6c 65 20 73  ifies testable s
0a60: 74 61 74 65 6d 65 6e 74 73 0a 23 20 61 6e 64 20  tatements.# and 
0a70: 72 65 71 75 69 72 65 6d 65 6e 74 73 2e 0a 23 0a  requirements..#.
0a80: 64 6f 63 3a 09 61 6c 77 61 79 73 20 24 28 44 4f  doc:.always $(DO
0a90: 43 29 2f 72 65 6d 6f 76 65 5f 63 61 72 65 74 73  C)/remove_carets
0aa0: 2e 73 68 0a 09 73 68 20 24 28 44 4f 43 29 2f 72  .sh..sh $(DOC)/r
0ab0: 65 6d 6f 76 65 5f 63 61 72 65 74 73 2e 73 68 20  emove_carets.sh 
0ac0: 64 6f 63 0a 0a 23 20 53 70 65 6c 6c 20 63 68 65  doc..# Spell che
0ad0: 63 6b 20 67 65 6e 65 72 61 74 65 64 20 64 6f 63  ck generated doc
0ae0: 73 2e 0a 23 0a 73 70 65 6c 6c 3a 20 24 28 44 4f  s..#.spell: $(DO
0af0: 43 29 2f 73 70 65 6c 6c 5f 63 68 6b 2e 73 68 20  C)/spell_chk.sh 
0b00: 24 28 44 4f 43 29 2f 63 75 73 74 6f 6d 2e 74 78  $(DOC)/custom.tx
0b10: 74 0a 09 73 68 20 24 28 44 4f 43 29 2f 73 70 65  t..sh $(DOC)/spe
0b20: 6c 6c 5f 63 68 6b 2e 73 68 20 64 6f 63 20 27 2a  ll_chk.sh doc '*
0b30: 2e 68 74 6d 6c 27 20 24 28 44 4f 43 29 2f 63 75  .html' $(DOC)/cu
0b40: 73 74 6f 6d 2e 74 78 74 0a 0a 23 20 43 6f 6e 73  stom.txt..# Cons
0b50: 74 72 75 63 74 20 74 68 65 20 64 61 74 61 62 61  truct the databa
0b60: 73 65 20 73 63 68 65 6d 61 2e 0a 23 0a 73 63 68  se schema..#.sch
0b70: 65 6d 61 3a 09 24 28 54 43 4c 53 48 29 0a 09 2e  ema:.$(TCLSH)...
0b80: 2f 24 28 54 43 4c 53 48 29 20 24 28 44 4f 43 29  /$(TCLSH) $(DOC)
0b90: 2f 73 63 68 65 6d 61 2e 74 63 6c 0a 0a 23 20 54  /schema.tcl..# T
0ba0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 75 6c  he following rul
0bb0: 65 20 73 63 61 6e 73 20 73 71 6c 69 74 65 33 2e  e scans sqlite3.
0bc0: 63 20 73 6f 75 72 63 65 20 74 65 78 74 2c 20 74  c source text, t
0bd0: 68 65 20 74 65 78 74 20 6f 66 20 74 68 65 20 54  he text of the T
0be0: 43 4c 0a 23 20 74 65 73 74 20 63 61 73 65 73 2c  CL.# test cases,
0bf0: 20 61 6e 64 20 28 6f 70 74 69 6f 6e 61 6c 6c 79   and (optionally
0c00: 29 20 74 68 65 20 54 48 33 20 74 65 73 74 20 63  ) the TH3 test c
0c10: 61 73 65 20 73 6f 75 72 63 65 73 20 6c 6f 6f 6b  ase sources look
0c20: 69 6e 67 20 66 6f 72 0a 23 20 63 6f 6d 6d 65 6e  ing for.# commen
0c30: 74 73 20 74 68 61 74 20 69 64 65 6e 74 69 66 79  ts that identify
0c40: 20 61 73 73 65 72 74 69 6f 6e 73 20 61 6e 64 20   assertions and 
0c50: 74 65 73 74 20 63 61 73 65 73 20 74 68 61 74 20  test cases that 
0c60: 70 72 6f 76 69 64 65 20 65 76 69 64 65 6e 63 65  provide evidence
0c70: 0a 23 20 74 68 61 74 20 53 51 4c 69 74 65 20 62  .# that SQLite b
0c80: 65 68 61 76 65 73 20 61 73 20 69 74 20 73 61 79  ehaves as it say
0c90: 73 20 69 74 20 64 6f 65 73 2e 20 20 53 65 65 20  s it does.  See 
0ca0: 74 68 65 20 63 6f 6d 6d 65 6e 74 73 20 69 6e 20  the comments in 
0cb0: 0a 23 20 73 63 61 6e 5f 74 65 73 74 5f 63 61 73  .# scan_test_cas
0cc0: 65 73 2e 74 63 6c 20 66 6f 72 20 61 64 64 69 74  es.tcl for addit
0cd0: 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f  ional informatio
0ce0: 6e 2e 0a 23 0a 23 20 54 68 65 20 6f 75 74 70 75  n..#.# The outpu
0cf0: 74 20 66 69 6c 65 20 65 76 69 64 65 6e 63 65 2e  t file evidence.
0d00: 74 78 74 20 69 73 20 75 73 65 64 20 62 79 20 72  txt is used by r
0d10: 65 71 75 69 72 65 6d 65 6e 74 73 20 63 6f 76 65  equirements cove
0d20: 72 61 67 65 20 61 6e 61 6c 79 73 69 73 2e 0a 23  rage analysis..#
0d30: 0a 53 43 41 4e 4e 45 52 20 3d 20 24 28 44 4f 43  .SCANNER = $(DOC
0d40: 29 2f 73 63 61 6e 5f 74 65 73 74 5f 63 61 73 65  )/scan_test_case
0d50: 73 2e 74 63 6c 0a 0a 65 76 69 64 65 6e 63 65 3a  s.tcl..evidence:
0d60: 09 24 28 54 43 4c 53 48 29 0a 09 2e 2f 24 28 54  .$(TCLSH).../$(T
0d70: 43 4c 53 48 29 20 24 28 53 43 41 4e 4e 45 52 29  CLSH) $(SCANNER)
0d80: 20 2d 72 65 73 65 74 20 73 72 63 20 24 28 53 52   -reset src $(SR
0d90: 43 29 2f 73 72 63 2f 2a 2e 5b 63 68 79 5d 0a 09  C)/src/*.[chy]..
0da0: 2e 2f 24 28 54 43 4c 53 48 29 20 24 28 53 43 41  ./$(TCLSH) $(SCA
0db0: 4e 4e 45 52 29 20 73 72 63 20 24 28 53 52 43 29  NNER) src $(SRC)
0dc0: 2f 65 78 74 2f 66 74 73 33 2f 2a 2e 5b 63 68 5d  /ext/fts3/*.[ch]
0dd0: 0a 09 2e 2f 24 28 54 43 4c 53 48 29 20 24 28 53  .../$(TCLSH) $(S
0de0: 43 41 4e 4e 45 52 29 20 73 72 63 20 24 28 53 52  CANNER) src $(SR
0df0: 43 29 2f 65 78 74 2f 72 74 72 65 65 2f 2a 2e 5b  C)/ext/rtree/*.[
0e00: 63 68 5d 0a 09 2e 2f 24 28 54 43 4c 53 48 29 20  ch].../$(TCLSH) 
0e10: 24 28 53 43 41 4e 4e 45 52 29 20 74 63 6c 20 24  $(SCANNER) tcl $
0e20: 28 53 52 43 29 2f 74 65 73 74 2f 2a 2e 74 65 73  (SRC)/test/*.tes
0e30: 74 0a 09 69 66 20 74 65 73 74 20 27 27 20 21 3d  t..if test '' !=
0e40: 20 27 24 28 54 48 33 29 27 3b 20 74 68 65 6e 20   '$(TH3)'; then 
0e50: 5c 0a 09 20 20 2e 2f 24 28 54 43 4c 53 48 29 20  \..  ./$(TCLSH) 
0e60: 24 28 53 43 41 4e 4e 45 52 29 20 74 68 33 20 24  $(SCANNER) th3 $
0e70: 28 54 48 33 29 2f 6d 6b 74 68 33 2e 74 63 6c 3b  (TH3)/mkth3.tcl;
0e80: 20 5c 0a 09 20 20 2e 2f 24 28 54 43 4c 53 48 29   \..  ./$(TCLSH)
0e90: 20 24 28 53 43 41 4e 4e 45 52 29 20 74 68 33 20   $(SCANNER) th3 
0ea0: 24 28 54 48 33 29 2f 62 61 73 65 2f 2a 2e 63 3b  $(TH3)/base/*.c;
0eb0: 20 5c 0a 09 20 20 2e 2f 24 28 54 43 4c 53 48 29   \..  ./$(TCLSH)
0ec0: 20 24 28 53 43 41 4e 4e 45 52 29 20 74 68 33 2f   $(SCANNER) th3/
0ed0: 72 65 71 31 20 24 28 54 48 33 29 2f 72 65 71 31  req1 $(TH3)/req1
0ee0: 2f 2a 2e 74 65 73 74 3b 20 5c 0a 09 20 20 2e 2f  /*.test; \..  ./
0ef0: 24 28 54 43 4c 53 48 29 20 24 28 53 43 41 4e 4e  $(TCLSH) $(SCANN
0f00: 45 52 29 20 74 68 33 2f 63 6f 76 31 20 24 28 54  ER) th3/cov1 $(T
0f10: 48 33 29 2f 63 6f 76 31 2f 2a 2e 74 65 73 74 3b  H3)/cov1/*.test;
0f20: 20 5c 0a 09 20 20 2e 2f 24 28 54 43 4c 53 48 29   \..  ./$(TCLSH)
0f30: 20 24 28 53 43 41 4e 4e 45 52 29 20 74 68 33 2f   $(SCANNER) th3/
0f40: 73 74 72 65 73 73 20 24 28 54 48 33 29 2f 73 74  stress $(TH3)/st
0f50: 72 65 73 73 2f 2a 2e 74 65 73 74 3b 20 5c 0a 09  ress/*.test; \..
0f60: 66 69 0a 09 69 66 20 74 65 73 74 20 27 27 20 21  fi..if test '' !
0f70: 3d 20 27 24 28 53 4c 54 29 27 3b 20 74 68 65 6e  = '$(SLT)'; then
0f80: 20 5c 0a 09 20 20 2e 2f 24 28 54 43 4c 53 48 29   \..  ./$(TCLSH)
0f90: 20 24 28 53 43 41 4e 4e 45 52 29 20 73 6c 74 20   $(SCANNER) slt 
0fa0: 24 28 53 4c 54 29 2f 74 65 73 74 2f 65 76 69 64  $(SLT)/test/evid
0fb0: 65 6e 63 65 2f 2a 2e 74 65 73 74 3b 20 5c 0a 09  ence/*.test; \..
0fc0: 66 69 0a 0a 23 20 43 6f 70 79 20 61 6e 64 20 48  fi..# Copy and H
0fd0: 54 4d 4c 69 7a 65 20 65 76 69 64 65 6e 63 65 20  TMLize evidence 
0fe0: 66 69 6c 65 73 0a 23 0a 46 4d 54 20 3d 20 24 28  files.#.FMT = $(
0ff0: 44 4f 43 29 2f 66 6f 72 6d 61 74 5f 65 76 69 64  DOC)/format_evid
1000: 65 6e 63 65 2e 74 63 6c 0a 0a 66 6f 72 6d 61 74  ence.tcl..format
1010: 5f 65 76 69 64 65 6e 63 65 3a 20 24 28 54 43 4c  _evidence: $(TCL
1020: 53 48 29 0a 09 72 6d 20 2d 66 72 20 64 6f 63 2f  SH)..rm -fr doc/
1030: 6d 61 74 72 69 78 2f 65 76 2f 2a 0a 09 2e 2f 24  matrix/ev/*.../$
1040: 28 54 43 4c 53 48 29 20 24 28 46 4d 54 29 20 73  (TCLSH) $(FMT) s
1050: 72 63 20 64 6f 63 2f 6d 61 74 72 69 78 20 24 28  rc doc/matrix $(
1060: 53 52 43 29 2f 73 72 63 2f 2a 2e 5b 63 68 79 5d  SRC)/src/*.[chy]
1070: 0a 09 2e 2f 24 28 54 43 4c 53 48 29 20 24 28 46  .../$(TCLSH) $(F
1080: 4d 54 29 20 73 72 63 20 64 6f 63 2f 6d 61 74 72  MT) src doc/matr
1090: 69 78 20 24 28 53 52 43 29 2f 65 78 74 2f 66 74  ix $(SRC)/ext/ft
10a0: 73 33 2f 2a 2e 5b 63 68 5d 0a 09 2e 2f 24 28 54  s3/*.[ch].../$(T
10b0: 43 4c 53 48 29 20 24 28 46 4d 54 29 20 73 72 63  CLSH) $(FMT) src
10c0: 20 64 6f 63 2f 6d 61 74 72 69 78 20 24 28 53 52   doc/matrix $(SR
10d0: 43 29 2f 65 78 74 2f 72 74 72 65 65 2f 2a 2e 5b  C)/ext/rtree/*.[
10e0: 63 68 5d 0a 09 2e 2f 24 28 54 43 4c 53 48 29 20  ch].../$(TCLSH) 
10f0: 24 28 46 4d 54 29 20 74 63 6c 20 64 6f 63 2f 6d  $(FMT) tcl doc/m
1100: 61 74 72 69 78 20 24 28 53 52 43 29 2f 74 65 73  atrix $(SRC)/tes
1110: 74 2f 2a 2e 74 65 73 74 0a 09 69 66 20 74 65 73  t/*.test..if tes
1120: 74 20 27 27 20 21 3d 20 27 24 28 53 4c 54 29 27  t '' != '$(SLT)'
1130: 3b 20 74 68 65 6e 20 5c 0a 09 20 20 2e 2f 24 28  ; then \..  ./$(
1140: 54 43 4c 53 48 29 20 24 28 46 4d 54 29 20 73 6c  TCLSH) $(FMT) sl
1150: 74 20 64 6f 63 2f 6d 61 74 72 69 78 20 24 28 53  t doc/matrix $(S
1160: 4c 54 29 2f 74 65 73 74 2f 65 76 69 64 65 6e 63  LT)/test/evidenc
1170: 65 2f 2a 2e 74 65 73 74 3b 20 5c 0a 09 66 69 0a  e/*.test; \..fi.
1180: 0a 70 72 69 76 61 74 65 5f 65 76 69 64 65 6e 63  .private_evidenc
1190: 65 3a 20 66 6f 72 6d 61 74 5f 65 76 69 64 65 6e  e: format_eviden
11a0: 63 65 0a 09 2e 2f 24 28 54 43 4c 53 48 29 20 24  ce.../$(TCLSH) $
11b0: 28 46 4d 54 29 20 74 68 33 20 64 6f 63 2f 6d 61  (FMT) th3 doc/ma
11c0: 74 72 69 78 20 24 28 54 48 33 29 2f 6d 6b 74 68  trix $(TH3)/mkth
11d0: 33 2e 74 63 6c 0a 09 2e 2f 24 28 54 43 4c 53 48  3.tcl.../$(TCLSH
11e0: 29 20 24 28 46 4d 54 29 20 74 68 33 2f 72 65 71  ) $(FMT) th3/req
11f0: 31 20 64 6f 63 2f 6d 61 74 72 69 78 20 24 28 54  1 doc/matrix $(T
1200: 48 33 29 2f 72 65 71 31 2f 2a 2e 74 65 73 74 0a  H3)/req1/*.test.
1210: 09 2e 2f 24 28 54 43 4c 53 48 29 20 24 28 46 4d  ../$(TCLSH) $(FM
1220: 54 29 20 74 68 33 2f 63 6f 76 31 20 64 6f 63 2f  T) th3/cov1 doc/
1230: 6d 61 74 72 69 78 20 24 28 54 48 33 29 2f 63 6f  matrix $(TH3)/co
1240: 76 31 2f 2a 2e 74 65 73 74 0a 0a 23 20 47 65 6e  v1/*.test..# Gen
1250: 65 72 61 74 65 20 74 68 65 20 74 72 61 63 65 61  erate the tracea
1260: 62 69 6c 69 74 79 20 6d 61 74 72 69 78 0a 23 0a  bility matrix.#.
1270: 6d 61 74 72 69 78 3a 09 0a 09 72 6d 20 2d 72 66  matrix:...rm -rf
1280: 20 64 6f 63 2f 6d 61 74 72 69 78 2f 69 6d 61 67   doc/matrix/imag
1290: 65 73 0a 09 63 70 20 2d 72 20 64 6f 63 2f 69 6d  es..cp -r doc/im
12a0: 61 67 65 73 20 64 6f 63 2f 6d 61 74 72 69 78 0a  ages doc/matrix.
12b0: 09 2e 2f 24 28 54 43 4c 53 48 29 20 24 28 44 4f  ../$(TCLSH) $(DO
12c0: 43 29 2f 6d 61 74 72 69 78 2e 74 63 6c 0a 0a 0a  C)/matrix.tcl...
12d0: 23 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  #---------------
12e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
12f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
1300: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
1310: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 23 20 53 6f  ----------..# So
1320: 75 72 63 65 20 66 69 6c 65 73 20 66 6f 72 20 74  urce files for t
1330: 68 65 20 5b 74 63 6c 73 71 6c 69 74 65 33 2e 73  he [tclsqlite3.s
1340: 65 61 72 63 68 5d 20 65 78 65 63 75 74 61 62 6c  earch] executabl
1350: 65 2e 20 0a 23 0a 53 53 52 43 20 3d 20 24 28 44  e. .#.SSRC = $(D
1360: 4f 43 29 2f 73 65 61 72 63 68 2f 73 65 61 72 63  OC)/search/searc
1370: 68 63 2e 63 20 5c 0a 09 20 20 20 20 24 28 44 4f  hc.c \..    $(DO
1380: 43 29 2f 73 65 61 72 63 68 2f 70 61 72 73 65 68  C)/search/parseh
1390: 74 6d 6c 2e 63 20 5c 0a 09 20 20 20 20 24 28 44  tml.c \..    $(D
13a0: 4f 43 29 2f 73 65 61 72 63 68 2f 66 74 73 35 65  OC)/search/fts5e
13b0: 78 74 2e 63 20 5c 0a 09 20 20 20 20 24 28 54 43  xt.c \..    $(TC
13c0: 4c 53 51 4c 49 54 45 33 43 29 0a 0a 23 20 46 6c  LSQLITE3C)..# Fl
13d0: 61 67 73 20 74 6f 20 62 75 69 6c 64 20 5b 74 63  ags to build [tc
13e0: 6c 73 71 6c 69 74 65 33 2e 73 65 61 72 63 68 5d  lsqlite3.search]
13f0: 20 77 69 74 68 2e 0a 23 0a 53 46 4c 41 47 53 20   with..#.SFLAGS 
1400: 3d 20 24 28 54 43 4c 49 4e 43 29 20 2d 44 53 51  = $(TCLINC) -DSQ
1410: 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 3d  LITE_THREADSAFE=
1420: 30 20 2d 44 53 51 4c 49 54 45 5f 45 4e 41 42 4c  0 -DSQLITE_ENABL
1430: 45 5f 46 54 53 35 20 2d 44 53 51 4c 49 54 45 5f  E_FTS5 -DSQLITE_
1440: 54 43 4c 4d 44 35 20 2d 44 54 43 4c 53 48 20 2d  TCLMD5 -DTCLSH -
1450: 44 6d 61 69 6e 3d 78 6d 61 69 6e 0a 0a 24 28 54  Dmain=xmain..$(T
1460: 43 4c 53 48 29 3a 20 24 28 53 53 52 43 29 0a 09  CLSH): $(SSRC)..
1470: 24 28 43 43 29 20 2d 4f 32 20 2d 6f 20 24 40 20  $(CC) -O2 -o $@ 
1480: 2d 49 2e 20 24 28 53 46 4c 41 47 53 29 20 24 28  -I. $(SFLAGS) $(
1490: 53 53 52 43 29 20 24 28 54 43 4c 46 4c 41 47 53  SSRC) $(TCLFLAGS
14a0: 29 0a 0a 73 65 61 72 63 68 64 62 3a 20 24 28 54  )..searchdb: $(T
14b0: 43 4c 53 48 29 0a 09 6d 6b 64 69 72 20 64 6f 63  CLSH)..mkdir doc
14c0: 2f 73 65 61 72 63 68 2e 64 2f 0a 09 2e 2f 24 28  /search.d/.../$(
14d0: 54 43 4c 53 48 29 20 24 28 44 4f 43 29 2f 73 65  TCLSH) $(DOC)/se
14e0: 61 72 63 68 2f 62 75 69 6c 64 73 65 61 72 63 68  arch/buildsearch
14f0: 64 62 2e 74 63 6c 0a 09 63 70 20 24 28 44 4f 43  db.tcl..cp $(DOC
1500: 29 2f 64 6f 63 75 6d 65 6e 74 5f 68 65 61 64 65  )/document_heade
1510: 72 2e 74 63 6c 20 64 6f 63 2f 64 6f 63 75 6d 65  r.tcl doc/docume
1520: 6e 74 5f 68 65 61 64 65 72 2e 74 63 6c 0a 09 63  nt_header.tcl..c
1530: 70 20 24 28 44 4f 43 29 2f 64 6f 63 75 6d 65 6e  p $(DOC)/documen
1540: 74 5f 68 65 61 64 65 72 2e 74 63 6c 20 64 6f 63  t_header.tcl doc
1550: 2f 73 65 61 72 63 68 2e 64 2f 64 6f 63 75 6d 65  /search.d/docume
1560: 6e 74 5f 68 65 61 64 65 72 2e 74 63 6c 0a 09 63  nt_header.tcl..c
1570: 70 20 24 28 44 4f 43 29 2f 73 65 61 72 63 68 2f  p $(DOC)/search/
1580: 73 65 61 72 63 68 2e 74 63 6c 20 64 6f 63 2f 73  search.tcl doc/s
1590: 65 61 72 63 68 0a 09 63 68 6d 6f 64 20 2b 78 20  earch..chmod +x 
15a0: 64 6f 63 2f 73 65 61 72 63 68 0a 09 63 70 20 24  doc/search..cp $
15b0: 28 44 4f 43 29 2f 73 65 61 72 63 68 2f 73 65 61  (DOC)/search/sea
15c0: 72 63 68 2e 74 63 6c 20 64 6f 63 2f 73 65 61 72  rch.tcl doc/sear
15d0: 63 68 2e 64 2f 61 64 6d 69 6e 0a 09 63 68 6d 6f  ch.d/admin..chmo
15e0: 64 20 2b 78 20 64 6f 63 2f 73 65 61 72 63 68 2e  d +x doc/search.
15f0: 64 2f 61 64 6d 69 6e 0a 0a 61 6c 77 61 79 73 3a  d/admin..always:
1600: 09 0a 0a 63 6c 65 61 6e 3a 09 0a 09 72 6d 20 2d  ...clean:...rm -
1610: 72 66 20 24 28 54 43 4c 53 48 29 20 64 6f 63 20  rf $(TCLSH) doc 
1620: 73 71 6c 69 74 65 33 2e 68 0a                    sqlite3.h.