Documentation Source Text

Hex Artifact Content
Login

Artifact ad219016be90ec1d5b439b28952299b1638d82be:


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 4e 41 57 4b 20 20 20   TCL.#.# NAWK   
0210: 20 20 20 20 20 20 20 20 20 20 4e 61 77 6b 20 63            Nawk c
0220: 6f 6d 70 61 74 69 62 6c 65 20 61 77 6b 20 70 72  ompatible awk pr
0230: 6f 67 72 61 6d 2e 20 20 4f 6c 64 65 72 20 28 6f  ogram.  Older (o
0240: 62 73 6f 6c 65 74 65 3f 29 20 73 6f 6c 61 72 69  bsolete?) solari
0250: 73 0a 23 20 20 20 20 20 20 20 20 20 20 20 20 20  s.#             
0260: 20 20 20 20 20 73 79 73 74 65 6d 73 20 6e 65 65       systems nee
0270: 64 20 74 68 69 73 20 74 6f 20 61 76 6f 69 64 20  d this to avoid 
0280: 75 73 69 6e 67 20 74 68 65 20 6f 72 69 67 69 6e  using the origin
0290: 61 6c 20 41 54 26 54 20 41 57 4b 2e 0a 23 0a 23  al AT&T AWK..#.#
02a0: 20 43 43 20 20 20 20 20 20 20 20 20 20 20 20 20   CC             
02b0: 20 20 41 20 43 2d 63 6f 6d 70 69 6c 65 72 20 61    A C-compiler a
02c0: 6e 64 20 61 72 67 75 6d 65 6e 74 73 20 66 6f 72  nd arguments for
02d0: 20 62 75 69 6c 64 69 6e 67 20 75 74 69 6c 69 74   building utilit
02e0: 79 20 70 72 6f 67 72 61 6d 73 0a 23 0a 23 20 4f  y programs.#.# O
02f0: 6e 63 65 20 74 68 65 20 6d 61 63 72 6f 73 20 61  nce the macros a
0300: 62 6f 76 65 20 61 72 65 20 64 65 66 69 6e 65 64  bove are defined
0310: 2c 20 74 68 65 20 72 65 73 74 20 6f 66 20 74 68  , the rest of th
0320: 69 73 20 6d 61 6b 65 20 73 63 72 69 70 74 20 77  is make script w
0330: 69 6c 6c 0a 23 20 62 75 69 6c 64 20 74 68 65 20  ill.# build the 
0340: 53 51 4c 69 74 65 20 6c 69 62 72 61 72 79 20 61  SQLite library a
0350: 6e 64 20 74 65 73 74 69 6e 67 20 74 6f 6f 6c 73  nd testing tools
0360: 2e 0a 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ..##############
0370: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0380: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0390: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
03a0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
03b0: 23 23 0a 0a 64 65 66 61 75 6c 74 3a 09 0a 09 40  ##..default:...@
03c0: 65 63 68 6f 20 27 6d 61 6b 65 20 62 61 73 65 3b  echo 'make base;
03d0: 20 20 20 20 20 20 20 23 20 42 75 69 6c 64 20 62         # Build b
03e0: 61 73 65 20 64 6f 63 75 6d 65 6e 74 73 27 0a 09  ase documents'..
03f0: 40 65 63 68 6f 20 27 6d 61 6b 65 20 65 76 69 64  @echo 'make evid
0400: 65 6e 63 65 3b 20 20 20 23 20 47 61 74 68 65 72  ence;   # Gather
0410: 20 65 76 69 64 65 6e 63 65 20 6d 61 72 6b 73 27   evidence marks'
0420: 0a 09 40 65 63 68 6f 20 27 6d 61 6b 65 20 6d 61  ..@echo 'make ma
0430: 74 72 69 78 3b 20 20 20 20 20 23 20 42 75 69 6c  trix;     # Buil
0440: 64 20 74 68 65 20 74 72 61 63 65 61 62 69 6c 69  d the traceabili
0450: 74 79 20 6d 61 74 72 69 78 27 0a 09 40 65 63 68  ty matrix'..@ech
0460: 6f 20 27 6d 61 6b 65 20 61 6c 6c 3b 20 20 20 20  o 'make all;    
0470: 20 20 20 20 23 20 44 6f 20 61 6c 6c 20 6f 66 20      # Do all of 
0480: 74 68 65 20 61 62 6f 76 65 27 0a 0a 61 6c 6c 3a  the above'..all:
0490: 09 62 61 73 65 20 65 76 69 64 65 6e 63 65 20 66  .base evidence f
04a0: 6f 72 6d 61 74 5f 65 76 69 64 65 6e 63 65 20 6d  ormat_evidence m
04b0: 61 74 72 69 78 20 64 6f 63 0a 0a 74 63 6c 73 68  atrix doc..tclsh
04c0: 3a 09 24 28 54 43 4c 53 51 4c 49 54 45 33 43 29  :.$(TCLSQLITE3C)
04d0: 0a 09 24 28 43 43 29 20 2d 67 20 2d 6f 20 74 63  ..$(CC) -g -o tc
04e0: 6c 73 68 20 2d 44 54 43 4c 53 48 3d 31 20 2d 44  lsh -DTCLSH=1 -D
04f0: 53 51 4c 49 54 45 5f 54 43 4c 4d 44 35 20 24 28  SQLITE_TCLMD5 $(
0500: 54 43 4c 49 4e 43 29 20 24 28 54 43 4c 53 51 4c  TCLINC) $(TCLSQL
0510: 49 54 45 33 43 29 20 24 28 54 43 4c 46 4c 41 47  ITE3C) $(TCLFLAG
0520: 53 29 0a 0a 73 71 6c 69 74 65 33 2e 68 3a 09 74  S)..sqlite3.h:.t
0530: 63 6c 73 68 20 24 28 53 52 43 29 2f 73 72 63 2f  clsh $(SRC)/src/
0540: 73 71 6c 69 74 65 2e 68 2e 69 6e 20 24 28 53 52  sqlite.h.in $(SR
0550: 43 29 2f 6d 61 6e 69 66 65 73 74 2e 75 75 69 64  C)/manifest.uuid
0560: 20 24 28 53 52 43 29 2f 56 45 52 53 49 4f 4e 0a   $(SRC)/VERSION.
0570: 09 2e 2f 74 63 6c 73 68 20 24 28 53 52 43 29 2f  ../tclsh $(SRC)/
0580: 74 6f 6f 6c 2f 6d 6b 73 71 6c 69 74 65 33 68 2e  tool/mksqlite3h.
0590: 74 63 6c 20 24 28 53 52 43 29 20 7c 20 5c 0a 09  tcl $(SRC) | \..
05a0: 73 65 64 20 27 73 2f 5e 53 51 4c 49 54 45 5f 41  sed 's/^SQLITE_A
05b0: 50 49 20 2f 2f 27 20 3e 73 71 6c 69 74 65 33 2e  PI //' >sqlite3.
05c0: 68 0a 0a 23 20 47 65 6e 65 72 61 74 65 20 74 68  h..# Generate th
05d0: 65 20 64 69 72 65 63 74 6f 72 79 20 69 6e 74 6f  e directory into
05e0: 20 77 68 69 63 68 20 67 65 6e 65 72 61 74 65 64   which generated
05f0: 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 66   documentation f
0600: 69 6c 65 73 20 77 69 6c 6c 0a 23 20 62 65 20 77  iles will.# be w
0610: 72 69 74 74 65 6e 2e 0a 23 0a 64 6f 63 64 69 72  ritten..#.docdir
0620: 3a 0a 09 6d 6b 64 69 72 20 2d 70 20 64 6f 63 20  :..mkdir -p doc 
0630: 64 6f 63 2f 63 33 72 65 66 20 64 6f 63 2f 6d 61  doc/c3ref doc/ma
0640: 74 72 69 78 20 64 6f 63 2f 6d 61 74 72 69 78 2f  trix doc/matrix/
0650: 63 33 72 65 66 0a 0a 23 20 54 68 69 73 20 72 75  c3ref..# This ru
0660: 6c 65 20 67 65 6e 65 72 61 74 65 73 20 61 6c 6c  le generates all
0670: 20 64 6f 63 75 6d 65 6e 74 69 6f 6e 20 66 69 6c   documention fil
0680: 65 73 20 66 72 6f 6d 20 74 68 65 69 72 20 73 6f  es from their so
0690: 75 72 63 65 73 2e 20 20 54 68 65 0a 23 20 73 70  urces.  The.# sp
06a0: 65 63 69 61 6c 20 6d 61 72 6b 75 70 20 6f 6e 20  ecial markup on 
06b0: 48 54 4d 4c 20 66 69 6c 65 73 20 75 73 65 64 20  HTML files used 
06c0: 74 6f 20 69 64 65 6e 74 69 66 79 20 74 65 73 74  to identify test
06d0: 61 62 6c 65 20 73 74 61 74 65 6d 65 6e 74 73 20  able statements 
06e0: 61 6e 64 0a 23 20 72 65 71 75 69 72 65 6d 65 6e  and.# requiremen
06f0: 74 73 20 61 72 65 20 72 65 74 61 69 6e 65 64 20  ts are retained 
0700: 69 6e 20 74 68 65 20 48 54 4d 4c 20 61 6e 64 20  in the HTML and 
0710: 73 6f 20 74 68 65 20 48 54 4d 4c 20 67 65 6e 65  so the HTML gene
0720: 72 61 74 65 64 20 62 79 0a 23 20 74 68 69 73 20  rated by.# this 
0730: 72 75 6c 65 20 69 73 20 6e 6f 74 20 73 75 69 74  rule is not suit
0740: 61 62 6c 65 20 66 6f 72 20 70 75 62 6c 69 63 61  able for publica
0750: 74 69 6f 6e 2e 20 20 54 68 69 73 20 69 73 20 74  tion.  This is t
0760: 68 65 20 66 69 72 73 74 20 73 74 65 70 0a 23 20  he first step.# 
0770: 6f 6e 6c 79 2e 0a 23 0a 62 61 73 65 3a 09 74 63  only..#.base:.tc
0780: 6c 73 68 20 73 71 6c 69 74 65 33 2e 68 20 64 6f  lsh sqlite3.h do
0790: 63 64 69 72 20 61 6c 77 61 79 73 0a 09 72 6d 20  cdir always..rm 
07a0: 2d 72 66 20 64 6f 63 2f 69 6d 61 67 65 73 0a 09  -rf doc/images..
07b0: 63 70 20 2d 72 20 24 28 44 4f 43 29 2f 69 6d 61  cp -r $(DOC)/ima
07c0: 67 65 73 20 64 6f 63 0a 09 63 70 20 24 28 53 52  ges doc..cp $(SR
07d0: 43 29 2f 61 72 74 2f 2a 2e 67 69 66 20 64 6f 63  C)/art/*.gif doc
07e0: 2f 69 6d 61 67 65 73 0a 09 6d 6b 64 69 72 20 64  /images..mkdir d
07f0: 6f 63 2f 69 6d 61 67 65 73 2f 73 79 6e 74 61 78  oc/images/syntax
0800: 0a 09 63 70 20 24 28 44 4f 43 29 2f 61 72 74 2f  ..cp $(DOC)/art/
0810: 73 79 6e 74 61 78 2f 2a 2e 67 69 66 20 64 6f 63  syntax/*.gif doc
0820: 2f 69 6d 61 67 65 73 2f 73 79 6e 74 61 78 0a 09  /images/syntax..
0830: 63 70 20 24 28 44 4f 43 29 2f 72 61 77 70 61 67  cp $(DOC)/rawpag
0840: 65 73 2f 2a 20 64 6f 63 0a 09 2e 2f 74 63 6c 73  es/* doc.../tcls
0850: 68 20 24 28 44 4f 43 29 2f 77 72 61 70 2e 74 63  h $(DOC)/wrap.tc
0860: 6c 20 24 28 44 4f 43 29 20 24 28 53 52 43 29 20  l $(DOC) $(SRC) 
0870: 64 6f 63 20 24 28 44 4f 43 29 2f 70 61 67 65 73  doc $(DOC)/pages
0880: 2f 2a 2e 69 6e 0a 0a 23 20 53 74 72 69 70 20 74  /*.in..# Strip t
0890: 68 65 20 73 70 65 63 69 61 6c 20 6d 61 72 6b 75  he special marku
08a0: 70 20 69 6e 20 48 54 4d 4c 20 66 69 6c 65 73 20  p in HTML files 
08b0: 74 68 61 74 20 69 64 65 6e 74 69 66 69 65 73 20  that identifies 
08c0: 74 65 73 74 61 62 6c 65 20 73 74 61 74 65 6d 65  testable stateme
08d0: 6e 74 73 0a 23 20 61 6e 64 20 72 65 71 75 69 72  nts.# and requir
08e0: 65 6d 65 6e 74 73 2e 0a 23 0a 64 6f 63 3a 09 61  ements..#.doc:.a
08f0: 6c 77 61 79 73 20 24 28 44 4f 43 29 2f 72 65 6d  lways $(DOC)/rem
0900: 6f 76 65 5f 63 61 72 65 74 73 2e 73 68 0a 09 73  ove_carets.sh..s
0910: 68 20 24 28 44 4f 43 29 2f 72 65 6d 6f 76 65 5f  h $(DOC)/remove_
0920: 63 61 72 65 74 73 2e 73 68 20 64 6f 63 0a 0a 0a  carets.sh doc...
0930: 23 20 43 6f 6e 73 74 72 75 63 74 20 74 68 65 20  # Construct the 
0940: 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 2e  database schema.
0950: 0a 23 0a 73 63 68 65 6d 61 3a 09 74 63 6c 73 68  .#.schema:.tclsh
0960: 0a 09 2e 2f 74 63 6c 73 68 20 24 28 44 4f 43 29  .../tclsh $(DOC)
0970: 2f 73 63 68 65 6d 61 2e 74 63 6c 0a 0a 23 20 54  /schema.tcl..# T
0980: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 75 6c  he following rul
0990: 65 20 73 63 61 6e 73 20 73 71 6c 69 74 65 33 2e  e scans sqlite3.
09a0: 63 20 73 6f 75 72 63 65 20 74 65 78 74 2c 20 74  c source text, t
09b0: 68 65 20 74 65 78 74 20 6f 66 20 74 68 65 20 54  he text of the T
09c0: 43 4c 0a 23 20 74 65 73 74 20 63 61 73 65 73 2c  CL.# test cases,
09d0: 20 61 6e 64 20 28 6f 70 74 69 6f 6e 61 6c 6c 79   and (optionally
09e0: 29 20 74 68 65 20 54 48 33 20 74 65 73 74 20 63  ) the TH3 test c
09f0: 61 73 65 20 73 6f 75 72 63 65 73 20 6c 6f 6f 6b  ase sources look
0a00: 69 6e 67 20 66 6f 72 0a 23 20 63 6f 6d 6d 65 6e  ing for.# commen
0a10: 74 73 20 74 68 61 74 20 69 64 65 6e 74 69 66 79  ts that identify
0a20: 20 61 73 73 65 72 74 69 6f 6e 73 20 61 6e 64 20   assertions and 
0a30: 74 65 73 74 20 63 61 73 65 73 20 74 68 61 74 20  test cases that 
0a40: 70 72 6f 76 69 64 65 20 65 76 69 64 65 6e 63 65  provide evidence
0a50: 0a 23 20 74 68 61 74 20 53 51 4c 69 74 65 20 62  .# that SQLite b
0a60: 65 68 61 76 65 73 20 61 73 20 69 74 20 73 61 79  ehaves as it say
0a70: 73 20 69 74 20 64 6f 65 73 2e 20 20 53 65 65 20  s it does.  See 
0a80: 74 68 65 20 63 6f 6d 6d 65 6e 74 73 20 69 6e 20  the comments in 
0a90: 0a 23 20 73 63 61 6e 5f 74 65 73 74 5f 63 61 73  .# scan_test_cas
0aa0: 65 73 2e 74 63 6c 20 66 6f 72 20 61 64 64 69 74  es.tcl for addit
0ab0: 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f  ional informatio
0ac0: 6e 2e 0a 23 0a 23 20 54 68 65 20 6f 75 74 70 75  n..#.# The outpu
0ad0: 74 20 66 69 6c 65 20 65 76 69 64 65 6e 63 65 2e  t file evidence.
0ae0: 74 78 74 20 69 73 20 75 73 65 64 20 62 79 20 72  txt is used by r
0af0: 65 71 75 69 72 65 6d 65 6e 74 73 20 63 6f 76 65  equirements cove
0b00: 72 61 67 65 20 61 6e 61 6c 79 73 69 73 2e 0a 23  rage analysis..#
0b10: 0a 53 43 41 4e 4e 45 52 20 3d 20 24 28 44 4f 43  .SCANNER = $(DOC
0b20: 29 2f 73 63 61 6e 5f 74 65 73 74 5f 63 61 73 65  )/scan_test_case
0b30: 73 2e 74 63 6c 0a 0a 65 76 69 64 65 6e 63 65 3a  s.tcl..evidence:
0b40: 09 74 63 6c 73 68 0a 09 2e 2f 74 63 6c 73 68 20  .tclsh.../tclsh 
0b50: 24 28 53 43 41 4e 4e 45 52 29 20 2d 72 65 73 65  $(SCANNER) -rese
0b60: 74 20 73 72 63 20 24 28 53 52 43 29 2f 73 72 63  t src $(SRC)/src
0b70: 2f 2a 2e 5b 63 68 79 5d 0a 09 2e 2f 74 63 6c 73  /*.[chy].../tcls
0b80: 68 20 24 28 53 43 41 4e 4e 45 52 29 20 73 72 63  h $(SCANNER) src
0b90: 20 24 28 53 52 43 29 2f 65 78 74 2f 66 74 73 33   $(SRC)/ext/fts3
0ba0: 2f 2a 2e 5b 63 68 5d 0a 09 2e 2f 74 63 6c 73 68  /*.[ch].../tclsh
0bb0: 20 24 28 53 43 41 4e 4e 45 52 29 20 73 72 63 20   $(SCANNER) src 
0bc0: 24 28 53 52 43 29 2f 65 78 74 2f 72 74 72 65 65  $(SRC)/ext/rtree
0bd0: 2f 2a 2e 5b 63 68 5d 0a 09 2e 2f 74 63 6c 73 68  /*.[ch].../tclsh
0be0: 20 24 28 53 43 41 4e 4e 45 52 29 20 74 63 6c 20   $(SCANNER) tcl 
0bf0: 24 28 53 52 43 29 2f 74 65 73 74 2f 2a 2e 74 65  $(SRC)/test/*.te
0c00: 73 74 0a 09 69 66 20 74 65 73 74 20 27 27 20 21  st..if test '' !
0c10: 3d 20 27 24 28 54 48 33 29 27 3b 20 74 68 65 6e  = '$(TH3)'; then
0c20: 20 5c 0a 09 20 20 2e 2f 74 63 6c 73 68 20 24 28   \..  ./tclsh $(
0c30: 53 43 41 4e 4e 45 52 29 20 74 68 33 20 24 28 54  SCANNER) th3 $(T
0c40: 48 33 29 2f 6d 6b 74 68 33 2e 74 63 6c 3b 20 5c  H3)/mkth3.tcl; \
0c50: 0a 09 20 20 2e 2f 74 63 6c 73 68 20 24 28 53 43  ..  ./tclsh $(SC
0c60: 41 4e 4e 45 52 29 20 74 68 33 2f 72 65 71 31 20  ANNER) th3/req1 
0c70: 24 28 54 48 33 29 2f 72 65 71 31 2f 2a 2e 74 65  $(TH3)/req1/*.te
0c80: 73 74 3b 20 5c 0a 09 20 20 2e 2f 74 63 6c 73 68  st; \..  ./tclsh
0c90: 20 24 28 53 43 41 4e 4e 45 52 29 20 74 68 33 2f   $(SCANNER) th3/
0ca0: 63 6f 76 31 20 24 28 54 48 33 29 2f 63 6f 76 31  cov1 $(TH3)/cov1
0cb0: 2f 2a 2e 74 65 73 74 3b 20 5c 0a 09 66 69 0a 0a  /*.test; \..fi..
0cc0: 23 20 43 6f 70 79 20 61 6e 64 20 48 54 4d 4c 69  # Copy and HTMLi
0cd0: 7a 65 20 65 76 69 64 65 6e 63 65 20 66 69 6c 65  ze evidence file
0ce0: 73 0a 23 0a 46 4d 54 20 3d 20 24 28 44 4f 43 29  s.#.FMT = $(DOC)
0cf0: 2f 66 6f 72 6d 61 74 5f 65 76 69 64 65 6e 63 65  /format_evidence
0d00: 2e 74 63 6c 0a 0a 66 6f 72 6d 61 74 5f 65 76 69  .tcl..format_evi
0d10: 64 65 6e 63 65 3a 20 74 63 6c 73 68 0a 09 6d 6b  dence: tclsh..mk
0d20: 64 69 72 20 2d 70 20 64 6f 63 2f 6d 61 74 72 69  dir -p doc/matri
0d30: 78 2f 65 76 0a 09 72 6d 20 2d 66 20 64 6f 63 2f  x/ev..rm -f doc/
0d40: 6d 61 74 72 69 78 2f 65 76 2f 2a 0a 09 2e 2f 74  matrix/ev/*.../t
0d50: 63 6c 73 68 20 24 28 46 4d 54 29 20 73 72 63 20  clsh $(FMT) src 
0d60: 64 6f 63 2f 6d 61 74 72 69 78 20 24 28 53 52 43  doc/matrix $(SRC
0d70: 29 2f 73 72 63 2f 2a 2e 5b 63 68 79 5d 0a 09 2e  )/src/*.[chy]...
0d80: 2f 74 63 6c 73 68 20 24 28 46 4d 54 29 20 73 72  /tclsh $(FMT) sr
0d90: 63 20 64 6f 63 2f 6d 61 74 72 69 78 20 24 28 53  c doc/matrix $(S
0da0: 52 43 29 2f 65 78 74 2f 66 74 73 33 2f 2a 2e 5b  RC)/ext/fts3/*.[
0db0: 63 68 5d 0a 09 2e 2f 74 63 6c 73 68 20 24 28 46  ch].../tclsh $(F
0dc0: 4d 54 29 20 73 72 63 20 64 6f 63 2f 6d 61 74 72  MT) src doc/matr
0dd0: 69 78 20 24 28 53 52 43 29 2f 65 78 74 2f 72 74  ix $(SRC)/ext/rt
0de0: 72 65 65 2f 2a 2e 5b 63 68 5d 0a 09 2e 2f 74 63  ree/*.[ch].../tc
0df0: 6c 73 68 20 24 28 46 4d 54 29 20 74 63 6c 20 64  lsh $(FMT) tcl d
0e00: 6f 63 2f 6d 61 74 72 69 78 20 24 28 53 52 43 29  oc/matrix $(SRC)
0e10: 2f 74 65 73 74 2f 2a 2e 74 65 73 74 0a 0a 70 72  /test/*.test..pr
0e20: 69 76 61 74 65 5f 65 76 69 64 65 6e 63 65 3a 20  ivate_evidence: 
0e30: 66 6f 72 6d 61 74 5f 65 76 69 64 65 6e 63 65 0a  format_evidence.
0e40: 09 2e 2f 74 63 6c 73 68 20 24 28 46 4d 54 29 20  ../tclsh $(FMT) 
0e50: 74 68 33 20 64 6f 63 2f 6d 61 74 72 69 78 20 24  th3 doc/matrix $
0e60: 28 54 48 33 29 2f 6d 6b 74 68 33 2e 74 63 6c 0a  (TH3)/mkth3.tcl.
0e70: 09 2e 2f 74 63 6c 73 68 20 24 28 46 4d 54 29 20  ../tclsh $(FMT) 
0e80: 74 68 33 2f 72 65 71 31 20 64 6f 63 2f 6d 61 74  th3/req1 doc/mat
0e90: 72 69 78 20 24 28 54 48 33 29 2f 72 65 71 31 2f  rix $(TH3)/req1/
0ea0: 2a 2e 74 65 73 74 0a 09 2e 2f 74 63 6c 73 68 20  *.test.../tclsh 
0eb0: 24 28 46 4d 54 29 20 74 68 33 2f 63 6f 76 31 20  $(FMT) th3/cov1 
0ec0: 64 6f 63 2f 6d 61 74 72 69 78 20 24 28 54 48 33  doc/matrix $(TH3
0ed0: 29 2f 63 6f 76 31 2f 2a 2e 74 65 73 74 0a 0a 23  )/cov1/*.test..#
0ee0: 20 47 65 6e 65 72 61 74 65 20 74 68 65 20 74 72   Generate the tr
0ef0: 61 63 65 61 62 69 6c 69 74 79 20 6d 61 74 72 69  aceability matri
0f00: 78 0a 23 0a 6d 61 74 72 69 78 3a 09 0a 09 72 6d  x.#.matrix:...rm
0f10: 20 2d 72 66 20 64 6f 63 2f 6d 61 74 72 69 78 2f   -rf doc/matrix/
0f20: 69 6d 61 67 65 73 0a 09 63 70 20 2d 72 20 64 6f  images..cp -r do
0f30: 63 2f 69 6d 61 67 65 73 20 64 6f 63 2f 6d 61 74  c/images doc/mat
0f40: 72 69 78 0a 09 2e 2f 74 63 6c 73 68 20 24 28 44  rix.../tclsh $(D
0f50: 4f 43 29 2f 6d 61 74 72 69 78 2e 74 63 6c 0a 0a  OC)/matrix.tcl..
0f60: 61 6c 77 61 79 73 3a 09 0a 0a 63 6c 65 61 6e 3a  always:...clean:
0f70: 09 0a 09 72 6d 20 2d 72 66 20 74 63 6c 73 68 20  ...rm -rf tclsh 
0f80: 64 6f 63 20 73 71 6c 69 74 65 33 2e 68 20 64 6f  doc sqlite3.h do
0f90: 63 69 6e 66 6f 2e 64 62 0a                       cinfo.db.