Documentation Source Text

Hex Artifact Content
Login

Artifact 999c13eabb88838ee185066b061e218d0563bd71:


0000: 23 21 2f 75 73 72 2f 62 69 6e 2f 74 63 6c 73 68  #!/usr/bin/tclsh
0010: 0a 23 0a 23 20 54 68 69 73 20 73 63 72 69 70 74  .#.# This script
0020: 20 70 72 6f 63 65 73 73 65 73 20 72 61 77 20 64   processes raw d
0030: 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 73 6f 75  ocumentation sou
0040: 72 63 65 20 74 65 78 74 20 69 6e 74 6f 20 69 74  rce text into it
0050: 73 20 66 69 6e 61 6c 20 66 6f 72 6d 20 0a 23 20  s final form .# 
0060: 66 6f 72 20 64 69 73 70 6c 61 79 2e 20 20 54 68  for display.  Th
0070: 65 20 70 72 6f 63 65 73 73 69 6e 67 20 61 63 74  e processing act
0080: 69 6f 6e 73 20 61 72 65 20 64 65 73 63 72 69 62  ions are describ
0090: 65 64 20 62 65 6c 6f 77 2e 0a 23 0a 23 20 49 6e  ed below..#.# In
00a0: 76 6f 6b 65 20 74 68 69 73 20 63 6f 6d 6d 61 6e  voke this comman
00b0: 64 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 23 0a  d as follows:.#.
00c0: 23 20 20 20 20 20 20 20 74 63 6c 73 68 20 77 72  #       tclsh wr
00d0: 61 70 2e 74 63 6c 20 24 28 44 4f 43 29 20 24 28  ap.tcl $(DOC) $(
00e0: 53 52 43 29 20 24 28 44 45 53 54 29 20 73 6f 75  SRC) $(DEST) sou
00f0: 72 63 65 31 2e 69 6e 20 73 6f 75 72 63 65 32 2e  rce1.in source2.
0100: 69 6e 20 2e 2e 2e 0a 23 0a 23 20 54 68 65 20 24  in ....#.# The $
0110: 28 44 4f 43 29 20 61 6e 64 20 24 28 53 52 43 29  (DOC) and $(SRC)
0120: 20 76 61 6c 75 65 73 20 61 72 65 20 74 68 65 20   values are the 
0130: 6e 61 6d 65 73 20 6f 66 20 64 69 72 65 63 74 6f  names of directo
0140: 72 69 65 73 20 63 6f 6e 74 61 69 6e 69 6e 67 0a  ries containing.
0150: 23 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61 74  # the documentat
0160: 69 6f 6e 20 73 6f 75 72 63 65 20 61 6e 64 20 70  ion source and p
0170: 72 6f 67 72 61 6d 20 73 6f 75 72 63 65 2e 20 20  rogram source.  
0180: 24 28 44 45 53 54 29 20 69 73 20 74 68 65 20 6e  $(DEST) is the n
0190: 61 6d 65 20 6f 66 0a 23 20 6f 66 20 74 68 65 20  ame of.# of the 
01a0: 64 69 72 65 63 74 6f 72 79 20 77 68 65 72 65 20  directory where 
01b0: 67 65 6e 65 72 61 74 65 64 20 48 54 4d 4c 20 69  generated HTML i
01c0: 73 20 77 72 69 74 74 65 6e 2e 20 20 73 6f 75 72  s written.  sour
01d0: 63 65 4e 2e 69 6e 20 69 73 20 74 68 65 0a 23 20  ceN.in is the.# 
01e0: 69 6e 70 75 74 20 66 69 6c 65 20 74 6f 20 62 65  input file to be
01f0: 20 70 72 6f 63 65 73 73 65 64 2e 20 20 54 68 65   processed.  The
0200: 20 6f 75 74 70 75 74 20 69 73 20 73 6f 75 72 63   output is sourc
0210: 65 4e 2e 68 74 6d 6c 20 69 6e 20 74 68 65 0a 23  eN.html in the.#
0220: 20 24 28 44 45 53 54 29 20 64 69 72 65 63 74 6f   $(DEST) directo
0230: 72 79 2e 0a 23 0a 23 20 43 68 61 6e 67 65 73 20  ry..#.# Changes 
0240: 6d 61 64 65 20 74 6f 20 74 68 65 20 73 6f 75 72  made to the sour
0250: 63 65 20 66 69 6c 65 73 3a 0a 23 0a 23 20 20 20  ce files:.#.#   
0260: 20 20 2a 20 20 41 6e 20 61 70 70 72 6f 70 72 69    *  An appropri
0270: 61 74 65 20 68 65 61 64 65 72 20 28 63 6f 6e 74  ate header (cont
0280: 61 69 6e 69 6e 67 20 74 68 65 20 53 51 4c 69 74  aining the SQLit
0290: 65 20 6c 6f 67 6f 20 61 6e 64 20 73 74 61 6e 64  e logo and stand
02a0: 61 72 64 0a 23 20 20 20 20 20 20 20 20 6d 65 6e  ard.#        men
02b0: 75 20 62 61 72 29 20 69 73 20 70 72 65 70 65 6e  u bar) is prepen
02c0: 64 65 64 20 74 6f 20 74 68 65 20 66 69 6c 65 2e  ded to the file.
02d0: 20 20 0a 23 0a 23 20 20 20 20 20 2a 20 20 41 6e    .#.#     *  An
02e0: 79 20 3c 74 69 74 6c 65 3e 2e 2e 2e 3c 2f 74 69  y <title>...</ti
02f0: 74 6c 65 3e 20 69 6e 20 74 68 65 20 69 6e 70 75  tle> in the inpu
0300: 74 20 69 73 20 6d 6f 76 65 64 20 69 6e 74 6f 20  t is moved into 
0310: 74 68 65 20 70 72 65 70 65 6e 64 65 64 0a 23 20  the prepended.# 
0320: 20 20 20 20 20 20 20 68 65 61 64 65 72 2e 0a 23         header..#
0330: 0a 23 20 20 20 20 20 2a 20 20 41 6e 20 61 70 70  .#     *  An app
0340: 72 6f 70 72 69 61 74 65 20 66 6f 6f 74 65 72 20  ropriate footer 
0350: 69 73 20 61 70 70 65 6e 64 65 64 2e 0a 23 0a 23  is appended..#.#
0360: 20 20 20 20 20 2a 20 20 53 63 72 69 70 74 73 20       *  Scripts 
0370: 77 69 74 68 69 6e 20 3c 74 63 6c 3e 2e 2e 2e 3c  within <tcl>...<
0380: 2f 74 63 6c 3e 20 61 72 65 20 65 76 61 6c 75 61  /tcl> are evalua
0390: 74 65 64 2e 20 20 4f 75 74 70 75 74 20 74 68 61  ted.  Output tha
03a0: 74 0a 23 20 20 20 20 20 20 20 20 69 73 20 65 6d  t.#        is em
03b0: 69 74 74 65 64 20 66 72 6f 6d 20 74 68 65 73 65  itted from these
03c0: 20 73 63 72 69 70 74 73 20 62 79 20 22 68 64 5f   scripts by "hd_
03d0: 70 75 74 73 22 20 6f 72 20 22 68 64 5f 72 65 73  puts" or "hd_res
03e0: 6f 6c 76 65 22 0a 23 20 20 20 20 20 20 20 20 70  olve".#        p
03f0: 72 6f 63 65 64 75 72 65 73 20 61 70 70 65 61 72  rocedures appear
0400: 73 20 69 6e 20 70 6c 61 63 65 20 6f 66 20 74 68  s in place of th
0410: 65 20 6f 72 69 67 69 6e 61 6c 20 73 63 72 69 70  e original scrip
0420: 74 2e 0a 23 0a 23 20 20 20 20 20 2a 20 20 48 79  t..#.#     *  Hy
0430: 70 65 72 6c 69 6e 6b 73 20 77 69 74 68 69 6e 20  perlinks within 
0440: 5b 2e 2e 2e 5d 20 61 72 65 20 72 65 73 6f 6c 76  [...] are resolv
0450: 65 64 2e 0a 23 0a 23 20 41 20 74 77 6f 2d 70 61  ed..#.# A two-pa
0460: 73 73 20 61 6c 67 6f 72 69 74 68 6d 20 69 73 20  ss algorithm is 
0470: 75 73 65 64 2e 20 20 54 68 65 20 66 69 72 73 74  used.  The first
0480: 20 70 61 73 73 20 63 6f 6c 6c 65 63 74 73 20 74   pass collects t
0490: 68 65 20 6e 61 6d 65 73 20 6f 66 0a 23 20 68 79  he names of.# hy
04a0: 70 65 72 6c 69 6e 6b 20 74 61 72 67 65 74 73 2c  perlink targets,
04b0: 20 72 65 71 75 69 72 65 6d 65 6e 74 73 20 74 65   requirements te
04c0: 78 74 2c 20 61 6e 64 20 6f 74 68 65 72 20 67 6c  xt, and other gl
04d0: 6f 62 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e  obal information
04e0: 2e 0a 23 20 54 68 65 20 73 65 63 6f 6e 64 20 70  ..# The second p
04f0: 61 73 73 20 75 73 65 73 20 74 68 65 20 64 61 74  ass uses the dat
0500: 61 20 67 61 74 68 65 72 65 64 20 6f 6e 20 74 68  a gathered on th
0510: 65 20 66 69 72 73 74 20 70 61 73 73 20 74 6f 20  e first pass to 
0520: 67 65 6e 65 72 61 74 65 0a 23 20 74 68 65 20 66  generate.# the f
0530: 69 6e 61 6c 20 6f 75 74 70 75 74 2e 0a 23 0a 73  inal output..#.s
0540: 65 74 20 44 4f 43 20 5b 6c 69 6e 64 65 78 20 24  et DOC [lindex $
0550: 61 72 67 76 20 30 5d 0a 73 65 74 20 53 52 43 20  argv 0].set SRC 
0560: 5b 6c 69 6e 64 65 78 20 24 61 72 67 76 20 31 5d  [lindex $argv 1]
0570: 0a 73 65 74 20 44 45 53 54 20 5b 6c 69 6e 64 65  .set DEST [linde
0580: 78 20 24 61 72 67 76 20 32 5d 0a 73 65 74 20 48  x $argv 2].set H
0590: 4f 4d 45 44 49 52 20 5b 70 77 64 5d 20 20 20 20  OMEDIR [pwd]    
05a0: 20 20 20 20 20 20 20 20 3b 23 20 41 6c 73 6f 20          ;# Also 
05b0: 72 65 6d 65 6d 62 65 72 20 6f 75 72 20 68 6f 6d  remember our hom
05c0: 65 20 64 69 72 65 63 74 6f 72 79 2e 0a 0a 23 20  e directory...# 
05d0: 4f 70 65 6e 20 74 68 65 20 53 51 4c 69 74 65 20  Open the SQLite 
05e0: 64 61 74 61 62 61 73 65 2e 0a 23 0a 73 71 6c 69  database..#.sqli
05f0: 74 65 33 20 64 62 20 64 6f 63 69 6e 66 6f 2e 64  te3 db docinfo.d
0600: 62 0a 64 62 20 65 76 61 6c 20 7b 0a 20 20 42 45  b.db eval {.  BE
0610: 47 49 4e 3b 0a 20 20 44 45 4c 45 54 45 20 46 52  GIN;.  DELETE FR
0620: 4f 4d 20 6c 69 6e 6b 3b 0a 20 20 44 45 4c 45 54  OM link;.  DELET
0630: 45 20 46 52 4f 4d 20 6b 65 79 77 6f 72 64 3b 0a  E FROM keyword;.
0640: 20 20 44 45 4c 45 54 45 20 46 52 4f 4d 20 66 72    DELETE FROM fr
0650: 61 67 6d 65 6e 74 3b 0a 20 20 44 45 4c 45 54 45  agment;.  DELETE
0660: 20 46 52 4f 4d 20 70 61 67 65 3b 0a 7d 0a 0a 23   FROM page;.}..#
0670: 20 4c 6f 61 64 20 74 68 65 20 73 79 6e 74 61 78   Load the syntax
0680: 20 64 69 61 67 72 61 6d 20 6c 69 6e 6b 61 67 65   diagram linkage
0690: 20 64 61 74 61 0a 23 0a 73 6f 75 72 63 65 20 24   data.#.source $
06a0: 44 4f 43 2f 61 72 74 2f 73 79 6e 74 61 78 2f 73  DOC/art/syntax/s
06b0: 79 6e 74 61 78 5f 6c 69 6e 6b 61 67 65 2e 74 63  yntax_linkage.tc
06c0: 6c 0a 0a 0a 23 20 54 68 69 73 20 69 73 20 74 68  l...# This is th
06d0: 65 20 66 69 72 73 74 2d 70 61 73 73 20 69 6d 70  e first-pass imp
06e0: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 70  lementation of p
06f0: 72 6f 63 65 64 75 72 65 20 74 68 61 74 20 72 65  rocedure that re
0700: 6e 64 65 72 73 0a 23 20 68 79 70 65 72 6c 69 6e  nders.# hyperlin
0710: 6b 73 2e 20 20 44 6f 20 6e 6f 74 20 65 76 65 6e  ks.  Do not even
0720: 20 62 6f 74 68 65 72 20 74 72 79 69 6e 67 20 74   bother trying t
0730: 6f 20 64 6f 20 61 6e 79 74 68 69 6e 67 20 64 75  o do anything du
0740: 72 69 6e 67 20 74 68 65 0a 23 20 66 69 72 73 74  ring the.# first
0750: 20 70 61 73 73 2e 20 20 57 65 20 68 61 76 65 20   pass.  We have 
0760: 74 6f 20 63 6f 6c 6c 65 63 74 20 6b 65 79 77 6f  to collect keywo
0770: 72 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 62  rd information b
0780: 65 66 6f 72 65 20 74 68 65 0a 23 20 68 79 70 65  efore the.# hype
0790: 72 6c 69 6e 6b 73 20 61 72 65 20 6d 65 61 6e 69  rlinks are meani
07a0: 6e 67 66 75 6c 2e 20 20 0a 23 0a 70 72 6f 63 20  ngful.  .#.proc 
07b0: 68 64 5f 72 65 73 6f 6c 76 65 20 7b 74 65 78 74  hd_resolve {text
07c0: 7d 20 7b 0a 20 20 68 64 5f 70 75 74 73 20 24 74  } {.  hd_puts $t
07d0: 65 78 74 0a 7d 0a 0a 23 20 54 68 69 73 20 69 73  ext.}..# This is
07e0: 20 74 68 65 20 73 65 63 6f 6e 64 2d 70 61 73 73   the second-pass
07f0: 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20   implementation 
0800: 6f 66 20 74 68 65 20 70 72 6f 63 65 64 75 72 65  of the procedure
0810: 20 74 68 61 74 0a 23 20 72 65 6e 64 65 72 73 20   that.# renders 
0820: 68 79 70 65 72 6c 69 6e 6b 73 2e 20 20 43 6f 6e  hyperlinks.  Con
0830: 76 65 72 74 20 61 6c 6c 20 68 79 70 65 72 6c 69  vert all hyperli
0840: 6e 6b 73 20 69 6e 20 24 74 65 78 74 20 69 6e 74  nks in $text int
0850: 6f 20 0a 23 20 61 70 70 72 6f 70 72 69 61 74 65  o .# appropriate
0860: 20 3c 61 20 68 72 65 66 3d 22 22 3e 20 6d 61 72   <a href=""> mar
0870: 6b 75 70 2e 0a 23 0a 23 20 4c 69 6e 6b 73 20 74  kup..#.# Links t
0880: 6f 20 6b 65 79 77 6f 72 64 73 20 77 69 74 68 69  o keywords withi
0890: 6e 20 74 68 65 20 73 61 6d 65 20 6d 61 69 6e 20  n the same main 
08a0: 66 69 6c 65 20 61 72 65 20 72 65 73 6f 6c 76 65  file are resolve
08b0: 64 20 75 73 69 6e 67 0a 23 20 24 3a 3a 6c 6c 69  d using.# $::lli
08c0: 6e 6b 28 29 20 69 66 20 70 6f 73 73 69 62 6c 65  nk() if possible
08d0: 2e 20 20 41 6c 6c 20 6f 74 68 65 72 20 6c 69 6e  .  All other lin
08e0: 6b 73 20 61 6e 64 20 6c 69 6e 6b 73 20 74 68 61  ks and links tha
08f0: 74 20 63 6f 75 6c 64 0a 23 20 6e 6f 74 20 62 65  t could.# not be
0900: 20 72 65 73 6f 6c 76 65 64 20 75 73 69 6e 67 20   resolved using 
0910: 24 3a 3a 6c 6c 69 6e 6b 28 29 20 61 72 65 20 72  $::llink() are r
0920: 65 73 6f 6c 76 65 64 20 75 73 69 6e 67 20 24 3a  esolved using $:
0930: 3a 67 6c 69 6e 6b 28 29 2e 0a 23 20 0a 70 72 6f  :glink()..# .pro
0940: 63 20 68 64 5f 72 65 73 6f 6c 76 65 5f 32 6e 64  c hd_resolve_2nd
0950: 70 61 73 73 20 7b 74 65 78 74 7d 20 7b 0a 20 20  pass {text} {.  
0960: 72 65 67 73 75 62 20 2d 61 6c 6c 20 7b 5c 5b 28  regsub -all {\[(
0970: 2e 2a 3f 29 5c 5d 7d 20 24 74 65 78 74 20 5c 0a  .*?)\]} $text \.
0980: 20 20 20 20 20 20 22 5c 31 37 35 3b 20 68 64 5f        "\175; hd_
0990: 72 65 73 6f 6c 76 65 5f 6f 6e 65 20 5c 31 37 33  resolve_one \173
09a0: 5c 5c 31 5c 31 37 35 3b 20 68 64 5f 70 75 74 73  \\1\175; hd_puts
09b0: 20 5c 31 37 33 22 20 74 65 78 74 0a 20 20 65 76   \173" text.  ev
09c0: 61 6c 20 22 68 64 5f 70 75 74 73 20 5c 31 37 33  al "hd_puts \173
09d0: 24 74 65 78 74 5c 31 37 35 22 0a 7d 0a 70 72 6f  $text\175".}.pro
09e0: 63 20 68 64 5f 72 65 73 6f 6c 76 65 5f 6f 6e 65  c hd_resolve_one
09f0: 20 7b 78 7d 20 7b 0a 20 20 69 66 20 7b 5b 73 74   {x} {.  if {[st
0a00: 72 69 6e 67 20 69 73 20 69 6e 74 65 67 65 72 20  ring is integer 
0a10: 24 78 5d 7d 20 7b 0a 20 20 20 20 68 64 5f 70 75  $x]} {.    hd_pu
0a20: 74 73 20 5c 5b 24 78 5c 5d 0a 20 20 20 20 72 65  ts \[$x\].    re
0a30: 74 75 72 6e 0a 20 20 7d 0a 20 20 73 65 74 20 78  turn.  }.  set x
0a40: 32 20 5b 73 70 6c 69 74 20 24 78 20 7c 5d 0a 20  2 [split $x |]. 
0a50: 20 73 65 74 20 6b 77 20 5b 73 74 72 69 6e 67 20   set kw [string 
0a60: 74 72 69 6d 20 5b 6c 69 6e 64 65 78 20 24 78 32  trim [lindex $x2
0a70: 20 30 5d 5d 0a 20 20 69 66 20 7b 5b 6c 6c 65 6e   0]].  if {[llen
0a80: 67 74 68 20 24 78 32 5d 3d 3d 31 7d 20 7b 0a 20  gth $x2]==1} {. 
0a90: 20 20 20 73 65 74 20 63 6f 6e 74 65 6e 74 20 24     set content $
0aa0: 6b 77 0a 20 20 20 20 72 65 67 73 75 62 20 7b 5c  kw.    regsub {\
0ab0: 28 5b 5e 29 5d 2a 5c 29 7d 20 24 63 6f 6e 74 65  ([^)]*\)} $conte
0ac0: 6e 74 20 7b 7d 20 6b 77 0a 20 20 20 20 72 65 67  nt {} kw.    reg
0ad0: 73 75 62 20 7b 3d 2e 2a 7d 20 24 6b 77 20 7b 7d  sub {=.*} $kw {}
0ae0: 20 6b 77 0a 20 20 7d 20 65 6c 73 65 20 7b 0a 20   kw.  } else {. 
0af0: 20 20 20 73 65 74 20 63 6f 6e 74 65 6e 74 20 5b     set content [
0b00: 73 74 72 69 6e 67 20 74 72 69 6d 20 5b 6c 69 6e  string trim [lin
0b10: 64 65 78 20 24 78 32 20 31 5d 5d 0a 20 20 7d 0a  dex $x2 1]].  }.
0b20: 20 20 69 66 20 7b 21 5b 72 65 67 65 78 70 20 7b    if {![regexp {
0b30: 5e 68 74 74 70 3a 7d 20 24 6b 77 5d 7d 20 7b 0a  ^http:} $kw]} {.
0b40: 20 20 20 20 72 65 67 73 75 62 20 2d 61 6c 6c 20      regsub -all 
0b50: 7b 5b 5e 61 2d 7a 41 2d 5a 30 2d 39 5f 2e 23 2f  {[^a-zA-Z0-9_.#/
0b60: 20 2d 5d 7d 20 24 6b 77 20 7b 7d 20 6b 77 0a 20   -]} $kw {} kw. 
0b70: 20 7d 0a 20 20 67 6c 6f 62 61 6c 20 68 64 20 6c   }.  global hd l
0b80: 6c 69 6e 6b 20 67 6c 69 6e 6b 20 62 61 63 6b 6c  link glink backl
0b90: 69 6e 6b 0a 20 20 69 66 20 7b 24 68 64 28 65 6e  ink.  if {$hd(en
0ba0: 61 62 6c 65 2d 6d 61 69 6e 29 7d 20 7b 0a 20 20  able-main)} {.  
0bb0: 20 20 73 65 74 20 66 6e 20 24 68 64 28 66 6e 2d    set fn $hd(fn-
0bc0: 6d 61 69 6e 29 0a 20 20 20 20 69 66 20 7b 24 68  main).    if {$h
0bd0: 64 28 66 72 61 67 6d 65 6e 74 29 21 3d 22 22 7d  d(fragment)!=""}
0be0: 20 7b 0a 20 20 20 20 20 20 73 65 74 20 73 72 63   {.      set src
0bf0: 75 72 6c 20 24 66 6e 23 24 68 64 28 66 72 61 67  url $fn#$hd(frag
0c00: 6d 65 6e 74 29 0a 20 20 20 20 7d 20 65 6c 73 65  ment).    } else
0c10: 20 7b 0a 20 20 20 20 20 20 73 65 74 20 73 72 63   {.      set src
0c20: 75 72 6c 20 24 66 6e 0a 20 20 20 20 7d 0a 20 20  url $fn.    }.  
0c30: 20 20 69 66 20 7b 5b 72 65 67 65 78 70 20 7b 5e    if {[regexp {^
0c40: 68 74 74 70 3a 7d 20 24 6b 77 5d 7d 20 7b 0a 20  http:} $kw]} {. 
0c50: 20 20 20 20 20 70 75 74 73 20 2d 6e 6f 6e 65 77       puts -nonew
0c60: 6c 69 6e 65 20 24 68 64 28 6d 61 69 6e 29 20 5c  line $hd(main) \
0c70: 0a 20 20 20 20 20 20 20 20 22 3c 61 20 68 72 65  .        "<a hre
0c80: 66 3d 5c 22 24 6b 77 5c 22 3e 24 63 6f 6e 74 65  f=\"$kw\">$conte
0c90: 6e 74 3c 2f 61 3e 22 0a 20 20 20 20 7d 20 65 6c  nt</a>".    } el
0ca0: 73 65 69 66 20 7b 5b 72 65 67 65 78 70 20 7b 5e  seif {[regexp {^
0cb0: 5b 54 74 5d 69 63 6b 65 74 20 23 28 5c 64 2b 29  [Tt]icket #(\d+)
0cc0: 24 7d 20 24 6b 77 20 61 6c 6c 20 74 6b 74 69 64  $} $kw all tktid
0cd0: 5d 7d 20 7b 0a 20 20 20 20 20 20 73 65 74 20 75  ]} {.      set u
0ce0: 72 6c 20 68 74 74 70 3a 2f 2f 77 77 77 2e 73 71  rl http://www.sq
0cf0: 6c 69 74 65 2e 6f 72 67 2f 63 76 73 74 72 61 63  lite.org/cvstrac
0d00: 2f 74 6b 74 76 69 65 77 3f 74 6e 3d 24 74 6b 74  /tktview?tn=$tkt
0d10: 69 64 0a 20 20 20 20 20 20 70 75 74 73 20 2d 6e  id.      puts -n
0d20: 6f 6e 65 77 6c 69 6e 65 20 24 68 64 28 6d 61 69  onewline $hd(mai
0d30: 6e 29 20 5c 0a 20 20 20 20 20 20 20 20 22 3c 61  n) \.        "<a
0d40: 20 68 72 65 66 3d 5c 22 24 75 72 6c 5c 22 3e 24   href=\"$url\">$
0d50: 63 6f 6e 74 65 6e 74 3c 2f 61 3e 22 0a 20 20 20  content</a>".   
0d60: 20 7d 20 65 6c 73 65 69 66 20 7b 5b 69 6e 66 6f   } elseif {[info
0d70: 20 65 78 69 73 74 73 20 6c 6c 69 6e 6b 28 24 66   exists llink($f
0d80: 6e 3a 24 6b 77 29 5d 7d 20 7b 0a 20 20 20 20 20  n:$kw)]} {.     
0d90: 20 70 75 74 73 20 2d 6e 6f 6e 65 77 6c 69 6e 65   puts -nonewline
0da0: 20 24 68 64 28 6d 61 69 6e 29 20 5c 0a 20 20 20   $hd(main) \.   
0db0: 20 20 20 20 20 22 3c 61 20 68 72 65 66 3d 5c 22       "<a href=\"
0dc0: 24 68 64 28 72 6f 6f 74 70 61 74 68 2d 6d 61 69  $hd(rootpath-mai
0dd0: 6e 29 24 6c 6c 69 6e 6b 28 24 66 6e 3a 24 6b 77  n)$llink($fn:$kw
0de0: 29 5c 22 3e 24 63 6f 6e 74 65 6e 74 3c 2f 61 3e  )\">$content</a>
0df0: 22 0a 20 20 20 20 7d 20 65 6c 73 65 69 66 20 7b  ".    } elseif {
0e00: 5b 69 6e 66 6f 20 65 78 69 73 74 73 20 67 6c 69  [info exists gli
0e10: 6e 6b 28 24 6b 77 29 5d 7d 20 7b 0a 20 20 20 20  nk($kw)]} {.    
0e20: 20 20 70 75 74 73 20 2d 6e 6f 6e 65 77 6c 69 6e    puts -nonewlin
0e30: 65 20 24 68 64 28 6d 61 69 6e 29 20 5c 0a 20 20  e $hd(main) \.  
0e40: 20 20 20 20 20 20 22 3c 61 20 68 72 65 66 3d 5c        "<a href=\
0e50: 22 24 68 64 28 72 6f 6f 74 70 61 74 68 2d 6d 61  "$hd(rootpath-ma
0e60: 69 6e 29 24 67 6c 69 6e 6b 28 24 6b 77 29 5c 22  in)$glink($kw)\"
0e70: 3e 24 63 6f 6e 74 65 6e 74 3c 2f 61 3e 22 0a 20  >$content</a>". 
0e80: 20 20 20 7d 20 65 6c 73 65 69 66 20 7b 5b 72 65     } elseif {[re
0e90: 67 65 78 70 20 7b 5c 2e 67 69 66 24 7d 20 24 6b  gexp {\.gif$} $k
0ea0: 77 5d 7d 20 7b 0a 20 20 20 20 20 20 70 75 74 73  w]} {.      puts
0eb0: 20 2d 6e 6f 6e 65 77 6c 69 6e 65 20 24 68 64 28   -nonewline $hd(
0ec0: 6d 61 69 6e 29 20 5c 0a 20 20 20 20 20 20 20 20  main) \.        
0ed0: 22 3c 69 6d 67 20 73 72 63 3d 5c 22 24 68 64 28  "<img src=\"$hd(
0ee0: 72 6f 6f 74 70 61 74 68 2d 6d 61 69 6e 29 69 6d  rootpath-main)im
0ef0: 61 67 65 73 2f 24 6b 77 5c 22 3e 22 0a 20 20 20  ages/$kw\">".   
0f00: 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20 20 20 20   } else {.      
0f10: 70 75 74 73 20 73 74 64 65 72 72 20 22 45 52 52  puts stderr "ERR
0f20: 4f 52 3a 20 75 6e 6b 6e 6f 77 6e 20 68 79 70 65  OR: unknown hype
0f30: 72 6c 69 6e 6b 20 74 61 72 67 65 74 3a 20 24 6b  rlink target: $k
0f40: 77 22 0a 20 20 20 20 20 20 70 75 74 73 20 2d 6e  w".      puts -n
0f50: 6f 6e 65 77 6c 69 6e 65 20 24 68 64 28 6d 61 69  onewline $hd(mai
0f60: 6e 29 20 22 3c 66 6f 6e 74 20 63 6f 6c 6f 72 3d  n) "<font color=
0f70: 5c 22 72 65 64 5c 22 3e 24 63 6f 6e 74 65 6e 74  \"red\">$content
0f80: 3c 2f 66 6f 6e 74 3e 22 0a 20 20 20 20 7d 0a 20  </font>".    }. 
0f90: 20 20 20 6c 61 70 70 65 6e 64 20 62 61 63 6b 6c     lappend backl
0fa0: 69 6e 6b 28 24 6b 77 29 20 24 73 72 63 75 72 6c  ink($kw) $srcurl
0fb0: 0a 20 20 7d 0a 20 20 69 66 20 7b 24 68 64 28 65  .  }.  if {$hd(e
0fc0: 6e 61 62 6c 65 2d 61 75 78 29 7d 20 7b 0a 20 20  nable-aux)} {.  
0fd0: 20 20 69 66 20 7b 5b 72 65 67 65 78 70 20 7b 5e    if {[regexp {^
0fe0: 68 74 74 70 3a 7d 20 24 6b 77 5d 7d 20 7b 0a 20  http:} $kw]} {. 
0ff0: 20 20 20 20 20 70 75 74 73 20 2d 6e 6f 6e 65 77       puts -nonew
1000: 6c 69 6e 65 20 24 68 64 28 61 75 78 29 20 5c 0a  line $hd(aux) \.
1010: 20 20 20 20 20 20 20 20 22 3c 61 20 68 72 65 66          "<a href
1020: 3d 5c 22 24 6b 77 5c 22 3e 24 63 6f 6e 74 65 6e  =\"$kw\">$conten
1030: 74 3c 2f 61 3e 22 0a 20 20 20 20 7d 20 65 6c 73  t</a>".    } els
1040: 65 69 66 20 7b 5b 72 65 67 65 78 70 20 7b 5e 5b  eif {[regexp {^[
1050: 54 74 5d 69 63 6b 65 74 20 23 28 5c 64 2b 29 24  Tt]icket #(\d+)$
1060: 7d 20 24 6b 77 20 61 6c 6c 20 74 6b 74 69 64 5d  } $kw all tktid]
1070: 7d 20 7b 0a 20 20 20 20 20 20 73 65 74 20 75 72  } {.      set ur
1080: 6c 20 68 74 74 70 3a 2f 2f 77 77 77 2e 73 71 6c  l http://www.sql
1090: 69 74 65 2e 6f 72 67 2f 63 76 73 74 72 61 63 2f  ite.org/cvstrac/
10a0: 74 6b 74 76 69 65 77 3f 74 6e 3d 24 74 6b 74 69  tktview?tn=$tkti
10b0: 64 0a 20 20 20 20 20 20 70 75 74 73 20 2d 6e 6f  d.      puts -no
10c0: 6e 65 77 6c 69 6e 65 20 24 68 64 28 61 75 78 29  newline $hd(aux)
10d0: 20 5c 0a 20 20 20 20 20 20 20 20 22 3c 61 20 68   \.        "<a h
10e0: 72 65 66 3d 5c 22 24 75 72 6c 5c 22 3e 24 63 6f  ref=\"$url\">$co
10f0: 6e 74 65 6e 74 3c 2f 61 3e 22 0a 20 20 20 20 7d  ntent</a>".    }
1100: 20 65 6c 73 65 69 66 20 7b 5b 69 6e 66 6f 20 65   elseif {[info e
1110: 78 69 73 74 73 20 67 6c 69 6e 6b 28 24 6b 77 29  xists glink($kw)
1120: 5d 7d 20 7b 0a 20 20 20 20 20 20 70 75 74 73 20  ]} {.      puts 
1130: 2d 6e 6f 6e 65 77 6c 69 6e 65 20 24 68 64 28 61  -nonewline $hd(a
1140: 75 78 29 20 5c 0a 20 20 20 20 20 20 20 20 22 3c  ux) \.        "<
1150: 61 20 68 72 65 66 3d 5c 22 24 68 64 28 72 6f 6f  a href=\"$hd(roo
1160: 74 70 61 74 68 2d 61 75 78 29 24 67 6c 69 6e 6b  tpath-aux)$glink
1170: 28 24 6b 77 29 5c 22 3e 24 63 6f 6e 74 65 6e 74  ($kw)\">$content
1180: 3c 2f 61 3e 22 0a 20 20 20 20 7d 20 65 6c 73 65  </a>".    } else
1190: 69 66 20 7b 5b 72 65 67 65 78 70 20 7b 5c 2e 67  if {[regexp {\.g
11a0: 69 66 24 7d 20 24 6b 77 5d 7d 20 7b 0a 20 20 20  if$} $kw]} {.   
11b0: 20 20 20 70 75 74 73 20 2d 6e 6f 6e 65 77 6c 69     puts -nonewli
11c0: 6e 65 20 24 68 64 28 6d 61 69 6e 29 20 5c 0a 20  ne $hd(main) \. 
11d0: 20 20 20 20 20 20 20 22 3c 69 6d 67 20 73 72 63         "<img src
11e0: 3d 5c 22 24 68 64 28 72 6f 6f 74 70 61 74 68 2d  =\"$hd(rootpath-
11f0: 61 75 78 29 69 6d 61 67 65 73 2f 24 6b 77 5c 22  aux)images/$kw\"
1200: 3e 22 0a 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a  >".    } else {.
1210: 20 20 20 20 20 20 70 75 74 73 20 73 74 64 65 72        puts stder
1220: 72 20 22 45 52 52 4f 52 3a 20 75 6e 6b 6e 6f 77  r "ERROR: unknow
1230: 6e 20 68 79 70 65 72 6c 69 6e 6b 20 74 61 72 67  n hyperlink targ
1240: 65 74 3a 20 24 6b 77 22 0a 20 20 20 20 20 20 70  et: $kw".      p
1250: 75 74 73 20 2d 6e 6f 6e 65 77 6c 69 6e 65 20 24  uts -nonewline $
1260: 68 64 28 61 75 78 29 20 22 3c 66 6f 6e 74 20 63  hd(aux) "<font c
1270: 6f 6c 6f 72 3d 5c 22 72 65 64 5c 22 3e 24 63 6f  olor=\"red\">$co
1280: 6e 74 65 6e 74 3c 2f 66 6f 6e 74 3e 22 0a 20 20  ntent</font>".  
1290: 20 20 7d 0a 20 20 20 20 6c 61 70 70 65 6e 64 20    }.    lappend 
12a0: 62 61 63 6b 6c 69 6e 6b 28 24 6b 77 29 20 24 68  backlink($kw) $h
12b0: 64 28 66 6e 2d 61 75 78 29 0a 20 20 7d 0a 7d 0a  d(fn-aux).  }.}.
12c0: 0a 0a 0a 23 20 52 65 63 6f 72 64 20 74 68 65 20  ...# Record the 
12d0: 66 61 63 74 20 74 68 61 74 20 61 6c 6c 20 6b 65  fact that all ke
12e0: 79 77 6f 72 64 73 20 67 69 76 65 6e 20 69 6e 20  ywords given in 
12f0: 74 68 65 20 61 72 67 75 6d 65 6e 74 20 6c 69 73  the argument lis
1300: 74 20 73 68 6f 75 6c 64 0a 23 20 63 61 75 73 65  t should.# cause
1310: 20 61 20 6a 75 6d 70 20 74 6f 20 74 68 65 20 63   a jump to the c
1320: 75 72 72 65 6e 74 20 6c 6f 63 61 74 69 6f 6e 20  urrent location 
1330: 69 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 66  in the current f
1340: 69 6c 65 2e 0a 23 0a 23 20 49 66 20 6f 6e 6c 79  ile..#.# If only
1350: 20 74 68 65 20 6d 61 69 6e 20 6f 75 74 70 75 74   the main output
1360: 20 66 69 6c 65 20 69 73 20 6f 70 65 6e 2c 20 74   file is open, t
1370: 68 65 6e 20 61 6c 6c 20 72 65 66 65 72 65 6e 63  hen all referenc
1380: 65 73 20 74 6f 20 74 68 65 0a 23 20 6b 65 79 77  es to the.# keyw
1390: 6f 72 64 20 6a 75 6d 70 20 74 6f 20 74 68 65 20  ord jump to the 
13a0: 6d 61 69 6e 20 6f 75 74 70 75 74 20 66 69 6c 65  main output file
13b0: 2e 20 20 49 66 20 62 6f 74 68 20 6d 61 69 6e 20  .  If both main 
13c0: 61 6e 64 20 61 75 78 20 61 72 65 0a 23 20 6f 70  and aux are.# op
13d0: 65 6e 20 74 68 65 6e 20 72 65 66 65 72 65 6e 63  en then referenc
13e0: 65 73 20 66 72 6f 6d 20 77 69 74 68 69 6e 20 74  es from within t
13f0: 68 65 20 6d 61 69 6e 20 66 69 6c 65 20 6a 75 6d  he main file jum
1400: 70 20 74 6f 20 74 68 65 20 6d 61 69 6e 20 66 69  p to the main fi
1410: 6c 65 0a 23 20 61 6e 64 20 61 6c 6c 20 6f 74 68  le.# and all oth
1420: 65 72 20 72 65 66 65 72 65 6e 63 65 73 20 6a 75  er references ju
1430: 6d 70 20 74 6f 20 74 68 65 20 61 75 78 69 6c 69  mp to the auxili
1440: 61 72 79 20 66 69 6c 65 2e 0a 23 0a 23 20 54 68  ary file..#.# Th
1450: 69 73 20 70 72 6f 63 65 64 75 72 65 20 69 73 20  is procedure is 
1460: 6f 6e 6c 79 20 61 63 74 69 76 65 20 64 75 72 69  only active duri
1470: 6e 67 20 74 68 65 20 66 69 72 73 74 20 70 61 73  ng the first pas
1480: 73 20 77 68 65 6e 20 77 65 20 61 72 65 0a 23 20  s when we are.# 
1490: 63 6f 6c 6c 65 63 74 69 6e 67 20 68 79 70 65 72  collecting hyper
14a0: 6c 69 6e 6b 20 69 6e 66 6f 72 6d 61 74 69 6f 6e  link information
14b0: 2e 20 20 54 68 69 73 20 70 72 6f 63 65 64 75 72  .  This procedur
14c0: 65 20 69 73 20 72 65 64 65 66 69 6e 65 64 20 74  e is redefined t
14d0: 6f 0a 23 20 62 65 20 61 20 6e 6f 2d 6f 70 20 62  o.# be a no-op b
14e0: 65 66 6f 72 65 20 74 68 65 20 73 74 61 72 74 20  efore the start 
14f0: 6f 66 20 74 68 65 20 73 65 63 6f 6e 64 20 70 61  of the second pa
1500: 73 73 2e 0a 23 0a 70 72 6f 63 20 68 64 5f 6b 65  ss..#.proc hd_ke
1510: 79 77 6f 72 64 73 20 7b 61 72 67 73 7d 20 7b 0a  ywords {args} {.
1520: 20 20 67 6c 6f 62 61 6c 20 67 6c 69 6e 6b 20 6c    global glink l
1530: 6c 69 6e 6b 20 68 64 0a 20 20 69 66 20 7b 24 68  link hd.  if {$h
1540: 64 28 66 72 61 67 6d 65 6e 74 29 3d 3d 22 22 7d  d(fragment)==""}
1550: 20 7b 0a 20 20 20 20 73 65 74 20 6c 75 72 6c 20   {.    set lurl 
1560: 24 68 64 28 66 6e 2d 6d 61 69 6e 29 0a 20 20 7d  $hd(fn-main).  }
1570: 20 65 6c 73 65 20 7b 0a 20 20 20 20 73 65 74 20   else {.    set 
1580: 6c 75 72 6c 20 22 23 24 68 64 28 66 72 61 67 6d  lurl "#$hd(fragm
1590: 65 6e 74 29 22 0a 20 20 7d 0a 20 20 73 65 74 20  ent)".  }.  set 
15a0: 66 6e 20 24 68 64 28 66 6e 2d 6d 61 69 6e 29 0a  fn $hd(fn-main).
15b0: 20 20 69 66 20 7b 5b 69 6e 66 6f 20 65 78 69 73    if {[info exis
15c0: 74 73 20 68 64 28 61 75 78 29 5d 7d 20 7b 0a 20  ts hd(aux)]} {. 
15d0: 20 20 20 73 65 74 20 67 75 72 6c 20 24 68 64 28     set gurl $hd(
15e0: 66 6e 2d 61 75 78 29 0a 20 20 7d 20 65 6c 73 65  fn-aux).  } else
15f0: 20 7b 0a 20 20 20 20 73 65 74 20 67 75 72 6c 20   {.    set gurl 
1600: 7b 7d 0a 20 20 20 20 69 66 20 7b 24 68 64 28 66  {}.    if {$hd(f
1610: 72 61 67 6d 65 6e 74 29 21 3d 22 22 7d 20 7b 0a  ragment)!=""} {.
1620: 20 20 20 20 20 20 73 65 74 20 6c 75 72 6c 20 24        set lurl $
1630: 68 64 28 66 6e 2d 6d 61 69 6e 29 23 24 68 64 28  hd(fn-main)#$hd(
1640: 66 72 61 67 6d 65 6e 74 29 0a 20 20 20 20 7d 0a  fragment).    }.
1650: 20 20 7d 0a 20 20 66 6f 72 65 61 63 68 20 61 20    }.  foreach a 
1660: 24 61 72 67 73 20 7b 0a 20 20 20 20 69 66 20 7b  $args {.    if {
1670: 5b 72 65 67 65 78 70 20 7b 5e 5c 2a 7d 20 24 61  [regexp {^\*} $a
1680: 5d 7d 20 7b 0a 20 20 20 20 20 20 73 65 74 20 76  ]} {.      set v
1690: 69 73 69 62 6c 65 20 30 0a 20 20 20 20 20 20 73  isible 0.      s
16a0: 65 74 20 61 20 5b 73 74 72 69 6e 67 20 72 61 6e  et a [string ran
16b0: 67 65 20 24 61 20 31 20 65 6e 64 5d 0a 20 20 20  ge $a 1 end].   
16c0: 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20 20 20 20   } else {.      
16d0: 73 65 74 20 76 69 73 69 62 6c 65 20 31 0a 20 20  set visible 1.  
16e0: 20 20 7d 0a 20 20 20 20 72 65 67 73 75 62 20 2d    }.    regsub -
16f0: 61 6c 6c 20 7b 5b 5e 61 2d 7a 41 2d 5a 30 2d 39  all {[^a-zA-Z0-9
1700: 5f 2e 23 2f 20 2d 5d 7d 20 24 61 20 7b 7d 20 6b  _.#/ -]} $a {} k
1710: 77 0a 20 20 20 20 69 66 20 7b 5b 69 6e 66 6f 20  w.    if {[info 
1720: 65 78 69 73 74 73 20 67 6c 69 6e 6b 28 24 6b 77  exists glink($kw
1730: 29 5d 7d 20 7b 0a 20 20 20 20 20 20 70 75 74 73  )]} {.      puts
1740: 20 73 74 64 65 72 72 20 22 57 41 52 4e 49 4e 47   stderr "WARNING
1750: 3a 20 64 75 70 6c 69 63 61 74 65 20 6b 65 79 77  : duplicate keyw
1760: 6f 72 64 20 5c 22 24 6b 77 5c 22 20 2d 20 24 67  ord \"$kw\" - $g
1770: 6c 69 6e 6b 28 24 6b 77 29 20 61 6e 64 20 24 6c  link($kw) and $l
1780: 75 72 6c 22 0a 20 20 20 20 7d 0a 20 20 20 20 69  url".    }.    i
1790: 66 20 7b 24 67 75 72 6c 3d 3d 22 22 7d 20 7b 0a  f {$gurl==""} {.
17a0: 20 20 20 20 20 20 73 65 74 20 67 6c 69 6e 6b 28        set glink(
17b0: 24 6b 77 29 20 24 6c 75 72 6c 0a 20 20 20 20 20  $kw) $lurl.     
17c0: 20 64 62 20 65 76 61 6c 20 7b 49 4e 53 45 52 54   db eval {INSERT
17d0: 20 49 4e 54 4f 20 6b 65 79 77 6f 72 64 28 6b 77   INTO keyword(kw
17e0: 2c 66 72 61 67 6d 65 6e 74 2c 69 6e 64 65 78 4b  ,fragment,indexK
17f0: 77 29 20 0a 20 20 20 20 20 20 20 20 20 20 20 20  w) .            
1800: 20 20 20 20 56 41 4c 55 45 53 28 24 61 2c 24 6c      VALUES($a,$l
1810: 75 72 6c 2c 24 76 69 73 69 62 6c 65 29 7d 0a 20  url,$visible)}. 
1820: 20 20 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20 20     } else {.    
1830: 20 20 73 65 74 20 67 6c 69 6e 6b 28 24 6b 77 29    set glink($kw)
1840: 20 24 67 75 72 6c 0a 20 20 20 20 20 20 73 65 74   $gurl.      set
1850: 20 6c 6c 69 6e 6b 28 24 66 6e 3a 24 6b 77 29 20   llink($fn:$kw) 
1860: 24 6c 75 72 6c 0a 20 20 20 20 20 20 64 62 20 65  $lurl.      db e
1870: 76 61 6c 20 7b 49 4e 53 45 52 54 20 49 4e 54 4f  val {INSERT INTO
1880: 20 6b 65 79 77 6f 72 64 28 6b 77 2c 66 72 61 67   keyword(kw,frag
1890: 6d 65 6e 74 2c 69 6e 64 65 78 4b 77 29 20 0a 20  ment,indexKw) . 
18a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 56                 V
18b0: 41 4c 55 45 53 28 24 61 2c 24 67 75 72 6c 2c 24  ALUES($a,$gurl,$
18c0: 76 69 73 69 62 6c 65 29 7d 0a 20 20 20 20 7d 0a  visible)}.    }.
18d0: 20 20 7d 0a 7d 0a 0a 23 20 53 74 61 72 74 20 61    }.}..# Start a
18e0: 20 6e 65 77 20 66 72 61 67 6d 65 6e 74 20 69 6e   new fragment in
18f0: 20 74 68 65 20 6d 61 69 6e 20 66 69 6c 65 2e 20   the main file. 
1900: 20 47 69 76 65 20 74 68 65 20 6e 65 77 20 66 72   Give the new fr
1910: 61 67 6d 65 6e 74 20 74 68 65 0a 23 20 69 6e 64  agment the.# ind
1920: 69 63 61 74 65 64 20 6e 61 6d 65 2e 20 20 41 6e  icated name.  An
1930: 79 20 6b 65 79 77 6f 72 64 73 20 64 65 66 69 6e  y keywords defin
1940: 65 64 20 61 66 74 65 72 20 74 68 69 73 20 70 6f  ed after this po
1950: 69 6e 74 20 77 69 6c 6c 20 72 65 66 65 72 0a 23  int will refer.#
1960: 20 74 6f 20 74 68 65 20 66 72 61 67 6d 65 6e 74   to the fragment
1970: 2c 20 6e 6f 74 20 74 6f 20 74 68 65 20 62 65 67  , not to the beg
1980: 69 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20 66 69  inning of the fi
1990: 6c 65 2e 0a 23 0a 23 20 4f 6e 6c 79 20 74 68 65  le..#.# Only the
19a0: 20 6d 61 69 6e 20 66 69 6c 65 20 6d 61 79 20 68   main file may h
19b0: 61 76 65 20 66 72 61 67 6d 65 6e 74 73 2e 20 20  ave fragments.  
19c0: 41 75 78 69 6c 69 61 72 79 20 66 69 6c 65 73 20  Auxiliary files 
19d0: 61 72 65 20 61 73 73 75 6d 65 64 0a 23 20 74 6f  are assumed.# to
19e0: 20 62 65 20 73 6d 61 6c 6c 20 65 6e 6f 75 67 68   be small enough
19f0: 20 74 68 61 74 20 66 72 61 67 6d 65 6e 74 73 20   that fragments 
1a00: 61 72 65 20 6e 6f 74 20 68 65 6c 70 66 75 6c 2e  are not helpful.
1a10: 0a 23 0a 70 72 6f 63 20 68 64 5f 66 72 61 67 6d  .#.proc hd_fragm
1a20: 65 6e 74 20 7b 6e 61 6d 65 20 61 72 67 73 7d 20  ent {name args} 
1a30: 7b 0a 20 20 67 6c 6f 62 61 6c 20 68 64 0a 20 20  {.  global hd.  
1a40: 73 65 74 20 68 64 28 66 72 61 67 6d 65 6e 74 29  set hd(fragment)
1a50: 20 24 6e 61 6d 65 0a 20 20 70 75 74 73 20 24 68   $name.  puts $h
1a60: 64 28 6d 61 69 6e 29 20 22 3c 61 20 6e 61 6d 65  d(main) "<a name
1a70: 3d 5c 22 24 6e 61 6d 65 5c 22 3e 3c 2f 61 3e 22  =\"$name\"></a>"
1a80: 0a 20 20 65 76 61 6c 20 68 64 5f 6b 65 79 77 6f  .  eval hd_keywo
1a90: 72 64 73 20 24 61 72 67 73 0a 7d 0a 0a 23 20 57  rds $args.}..# W
1aa0: 72 69 74 65 20 72 61 77 20 6f 75 74 70 75 74 20  rite raw output 
1ab0: 74 6f 20 62 6f 74 68 20 74 68 65 20 6d 61 69 6e  to both the main
1ac0: 20 66 69 6c 65 20 61 6e 64 20 74 68 65 20 61 75   file and the au
1ad0: 78 69 6c 69 61 72 79 2e 20 20 4f 6e 6c 79 20 77  xiliary.  Only w
1ae0: 72 69 74 65 0a 23 20 74 6f 20 66 69 6c 65 73 20  rite.# to files 
1af0: 74 68 61 74 20 61 72 65 20 65 6e 61 62 6c 65 64  that are enabled
1b00: 2e 0a 23 0a 70 72 6f 63 20 68 64 5f 70 75 74 73  ..#.proc hd_puts
1b10: 20 7b 74 65 78 74 7d 20 7b 0a 20 20 67 6c 6f 62   {text} {.  glob
1b20: 61 6c 20 68 64 0a 20 20 69 66 20 7b 24 68 64 28  al hd.  if {$hd(
1b30: 65 6e 61 62 6c 65 2d 6d 61 69 6e 29 7d 20 7b 0a  enable-main)} {.
1b40: 20 20 20 20 73 65 74 20 66 6e 20 24 68 64 28 66      set fn $hd(f
1b50: 6e 2d 6d 61 69 6e 29 0a 20 20 20 20 70 75 74 73  n-main).    puts
1b60: 20 2d 6e 6f 6e 65 77 6c 69 6e 65 20 24 68 64 28   -nonewline $hd(
1b70: 6d 61 69 6e 29 20 24 74 65 78 74 0a 20 20 7d 0a  main) $text.  }.
1b80: 20 20 69 66 20 7b 24 68 64 28 65 6e 61 62 6c 65    if {$hd(enable
1b90: 2d 61 75 78 29 7d 20 7b 0a 20 20 20 20 73 65 74  -aux)} {.    set
1ba0: 20 66 6e 20 24 68 64 28 66 6e 2d 61 75 78 29 0a   fn $hd(fn-aux).
1bb0: 20 20 20 20 70 75 74 73 20 2d 6e 6f 6e 65 77 6c      puts -nonewl
1bc0: 69 6e 65 20 24 68 64 28 61 75 78 29 20 24 74 65  ine $hd(aux) $te
1bd0: 78 74 0a 20 20 7d 0a 20 20 0a 20 20 23 20 4f 75  xt.  }.  .  # Ou
1be0: 72 20 70 61 67 65 6c 69 6e 6b 20 70 72 6f 63 65  r pagelink proce
1bf0: 73 73 69 6e 67 20 62 61 73 65 64 20 6f 66 66 20  ssing based off 
1c00: 74 68 65 20 67 6c 6f 62 61 6c 73 0a 20 20 23 20  the globals.  # 
1c10: 6c 6c 69 6e 6b 2c 20 67 6c 69 6e 6b 2c 20 61 6e  llink, glink, an
1c20: 64 20 62 61 63 6b 6c 69 6e 6b 20 67 65 6e 65 72  d backlink gener
1c30: 61 74 65 64 20 64 75 72 69 6e 67 20 68 64 5f 72  ated during hd_r
1c40: 65 73 6f 6c 76 65 0a 20 20 23 20 70 72 6f 63 65  esolve.  # proce
1c50: 73 73 69 6e 67 20 64 6f 65 73 6e 27 74 20 63 61  ssing doesn't ca
1c60: 74 63 68 20 6c 69 6e 6b 73 20 6f 75 74 70 75 74  tch links output
1c70: 74 65 64 20 64 69 72 65 63 74 6c 79 0a 20 20 23  ted directly.  #
1c80: 20 77 69 74 68 20 68 64 5f 70 75 74 73 2e 20 20   with hd_puts.  
1c90: 54 68 69 73 20 63 6f 64 65 20 61 74 74 65 6d 70  This code attemp
1ca0: 74 73 20 74 6f 20 61 64 64 20 74 68 6f 73 65 20  ts to add those 
1cb0: 6c 69 6e 6b 73 20 74 6f 0a 20 20 23 20 6f 75 72  links to.  # our
1cc0: 20 70 61 67 65 6c 69 6e 6b 20 61 72 72 61 79 2e   pagelink array.
1cd0: 0a 20 20 67 6c 6f 62 61 6c 20 70 61 67 65 6c 69  .  global pageli
1ce0: 6e 6b 0a 20 20 73 65 74 20 72 65 66 73 20 5b 72  nk.  set refs [r
1cf0: 65 67 65 78 70 20 2d 61 6c 6c 20 2d 69 6e 6c 69  egexp -all -inli
1d00: 6e 65 20 7b 68 72 65 66 3d 5c 22 28 2e 2a 3f 29  ne {href=\"(.*?)
1d10: 5c 22 7d 20 24 74 65 78 74 5d 0a 20 20 66 6f 72  \"} $text].  for
1d20: 65 61 63 68 20 7b 68 72 65 66 20 72 65 66 7d 20  each {href ref} 
1d30: 24 72 65 66 73 20 7b 0a 20 20 20 20 72 65 67 73  $refs {.    regs
1d40: 75 62 20 7b 23 2e 2a 7d 20 24 72 65 66 20 7b 7d  ub {#.*} $ref {}
1d50: 20 72 65 66 32 0a 20 20 20 20 72 65 67 73 75 62   ref2.    regsub
1d60: 20 7b 68 74 74 70 3a 5c 2f 5c 2f 77 77 77 5c 2e   {http:\/\/www\.
1d70: 73 71 6c 69 74 65 5c 2e 6f 72 67 5c 2f 7d 20 24  sqlite\.org\/} $
1d80: 72 65 66 32 20 7b 7d 20 72 65 66 33 0a 20 20 20  ref2 {} ref3.   
1d90: 20 72 65 67 73 75 62 20 7b 5c 2e 5c 2e 5c 2f 7d   regsub {\.\.\/}
1da0: 20 24 72 65 66 33 20 7b 7d 20 72 65 66 34 0a 20   $ref3 {} ref4. 
1db0: 20 20 20 69 66 20 7b 5b 72 65 67 65 78 70 20 7b     if {[regexp {
1dc0: 5e 68 74 74 70 7d 20 24 72 65 66 34 5d 7d 20 63  ^http} $ref4]} c
1dd0: 6f 6e 74 69 6e 75 65 0a 20 20 20 20 69 66 20 7b  ontinue.    if {
1de0: 24 72 65 66 34 3d 3d 22 22 7d 20 63 6f 6e 74 69  $ref4==""} conti
1df0: 6e 75 65 0a 20 20 20 20 69 66 20 7b 5b 72 65 67  nue.    if {[reg
1e00: 65 78 70 20 7b 5c 2e 68 74 6d 6c 24 7d 20 24 72  exp {\.html$} $r
1e10: 65 66 34 5d 7d 20 7b 0a 20 20 20 20 20 20 6c 61  ef4]} {.      la
1e20: 70 70 65 6e 64 20 70 61 67 65 6c 69 6e 6b 28 24  ppend pagelink($
1e30: 72 65 66 34 29 20 24 66 6e 0a 20 20 20 20 7d 0a  ref4) $fn.    }.
1e40: 20 20 7d 0a 7d 0a 70 72 6f 63 20 68 64 5f 70 75    }.}.proc hd_pu
1e50: 74 73 6e 6c 20 7b 74 65 78 74 7d 20 7b 0a 20 20  tsnl {text} {.  
1e60: 68 64 5f 70 75 74 73 20 24 74 65 78 74 5c 6e 0a  hd_puts $text\n.
1e70: 7d 0a 0a 23 20 45 6e 61 62 6c 65 20 6f 72 20 64  }..# Enable or d
1e80: 69 73 61 62 6c 65 20 74 68 65 20 6d 61 69 6e 20  isable the main 
1e90: 6f 75 74 70 75 74 20 66 69 6c 65 2e 0a 23 0a 70  output file..#.p
1ea0: 72 6f 63 20 68 64 5f 65 6e 61 62 6c 65 5f 6d 61  roc hd_enable_ma
1eb0: 69 6e 20 7b 62 6f 6f 6c 65 61 6e 7d 20 7b 0a 20  in {boolean} {. 
1ec0: 20 67 6c 6f 62 61 6c 20 68 64 0a 20 20 73 65 74   global hd.  set
1ed0: 20 68 64 28 65 6e 61 62 6c 65 2d 6d 61 69 6e 29   hd(enable-main)
1ee0: 20 24 62 6f 6f 6c 65 61 6e 0a 7d 0a 0a 23 20 45   $boolean.}..# E
1ef0: 6e 61 62 6c 65 20 6f 72 20 64 69 73 61 62 6c 65  nable or disable
1f00: 20 74 68 65 20 61 75 78 69 6c 69 61 72 79 20 6f   the auxiliary o
1f10: 75 74 70 75 74 20 66 69 6c 65 2e 0a 23 0a 70 72  utput file..#.pr
1f20: 6f 63 20 68 64 5f 65 6e 61 62 6c 65 5f 61 75 78  oc hd_enable_aux
1f30: 20 7b 62 6f 6f 6c 65 61 6e 7d 20 7b 0a 20 20 67   {boolean} {.  g
1f40: 6c 6f 62 61 6c 20 68 64 0a 20 20 73 65 74 20 68  lobal hd.  set h
1f50: 64 28 65 6e 61 62 6c 65 2d 61 75 78 29 20 24 62  d(enable-aux) $b
1f60: 6f 6f 6c 65 61 6e 0a 7d 0a 73 65 74 20 68 64 28  oolean.}.set hd(
1f70: 65 6e 61 62 6c 65 2d 61 75 78 29 20 30 0a 0a 23  enable-aux) 0..#
1f80: 20 4f 70 65 6e 20 74 68 65 20 6d 61 69 6e 20 6f   Open the main o
1f90: 75 74 70 75 74 20 66 69 6c 65 2e 20 20 24 66 69  utput file.  $fi
1fa0: 6c 65 6e 61 6d 65 20 69 73 20 72 65 6c 61 74 69  lename is relati
1fb0: 76 65 20 74 6f 20 24 3a 3a 44 45 53 54 2e 20 20  ve to $::DEST.  
1fc0: 0a 23 0a 70 72 6f 63 20 68 64 5f 6f 70 65 6e 5f  .#.proc hd_open_
1fd0: 6d 61 69 6e 20 7b 66 69 6c 65 6e 61 6d 65 7d 20  main {filename} 
1fe0: 7b 0a 20 20 67 6c 6f 62 61 6c 20 68 64 20 44 45  {.  global hd DE
1ff0: 53 54 0a 20 20 68 64 5f 63 6c 6f 73 65 5f 6d 61  ST.  hd_close_ma
2000: 69 6e 0a 20 20 73 65 74 20 68 64 28 66 6e 2d 6d  in.  set hd(fn-m
2010: 61 69 6e 29 20 24 66 69 6c 65 6e 61 6d 65 0a 20  ain) $filename. 
2020: 20 73 65 74 20 68 64 28 72 6f 6f 74 70 61 74 68   set hd(rootpath
2030: 2d 6d 61 69 6e 29 20 5b 68 64 5f 72 6f 6f 74 70  -main) [hd_rootp
2040: 61 74 68 20 24 66 69 6c 65 6e 61 6d 65 5d 0a 20  ath $filename]. 
2050: 20 73 65 74 20 68 64 28 6d 61 69 6e 29 20 5b 6f   set hd(main) [o
2060: 70 65 6e 20 24 44 45 53 54 2f 24 66 69 6c 65 6e  pen $DEST/$filen
2070: 61 6d 65 20 77 5d 0a 20 20 73 65 74 20 68 64 28  ame w].  set hd(
2080: 65 6e 61 62 6c 65 2d 6d 61 69 6e 29 20 31 0a 20  enable-main) 1. 
2090: 20 73 65 74 20 68 64 28 66 72 61 67 6d 65 6e 74   set hd(fragment
20a0: 29 20 7b 7d 0a 20 20 67 6c 6f 62 61 6c 20 70 61  ) {}.  global pa
20b0: 67 65 6c 69 6e 6b 0a 20 20 6c 61 70 70 65 6e 64  gelink.  lappend
20c0: 20 70 61 67 65 6c 69 6e 6b 28 24 66 69 6c 65 6e   pagelink($filen
20d0: 61 6d 65 29 20 24 66 69 6c 65 6e 61 6d 65 0a 7d  ame) $filename.}
20e0: 0a 0a 23 20 49 66 20 24 66 69 6c 65 6e 61 6d 65  ..# If $filename
20f0: 20 69 73 20 61 20 70 61 74 68 20 66 72 6f 6d 20   is a path from 
2100: 24 3a 3a 44 45 53 54 20 74 6f 20 61 20 66 69 6c  $::DEST to a fil
2110: 65 2c 20 72 65 74 75 72 6e 20 61 20 70 61 74 68  e, return a path
2120: 0a 23 20 66 72 6f 6d 20 74 68 65 20 64 69 72 65  .# from the dire
2130: 63 74 6f 72 79 20 63 6f 6e 74 61 69 6e 69 6e 67  ctory containing
2140: 20 24 66 69 6c 65 6e 61 6d 65 20 62 61 63 6b 20   $filename back 
2150: 74 6f 20 74 68 65 20 64 69 72 65 63 74 6f 72 79  to the directory
2160: 20 24 3a 3a 44 45 53 54 2e 0a 23 0a 70 72 6f 63   $::DEST..#.proc
2170: 20 68 64 5f 72 6f 6f 74 70 61 74 68 20 7b 66 69   hd_rootpath {fi
2180: 6c 65 6e 61 6d 65 7d 20 7b 0a 20 20 73 65 74 20  lename} {.  set 
2190: 75 70 20 7b 7d 0a 20 20 73 65 74 20 6e 20 5b 6c  up {}.  set n [l
21a0: 6c 65 6e 67 74 68 20 5b 73 70 6c 69 74 20 24 66  length [split $f
21b0: 69 6c 65 6e 61 6d 65 20 2f 5d 5d 0a 20 20 69 66  ilename /]].  if
21c0: 20 7b 24 6e 3c 3d 31 7d 20 7b 0a 20 20 20 20 72   {$n<=1} {.    r
21d0: 65 74 75 72 6e 20 7b 7d 0a 20 20 7d 20 65 6c 73  eturn {}.  } els
21e0: 65 20 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 5b  e {.    return [
21f0: 73 74 72 69 6e 67 20 72 65 70 65 61 74 20 2e 2e  string repeat ..
2200: 2f 20 5b 65 78 70 72 20 7b 24 6e 2d 31 7d 5d 5d  / [expr {$n-1}]]
2210: 0a 20 20 7d 0a 7d 0a 0a 23 20 43 6c 6f 73 65 20  .  }.}..# Close 
2220: 74 68 65 20 6d 61 69 6e 20 6f 75 74 70 75 74 20  the main output 
2230: 66 69 6c 65 2e 0a 23 0a 70 72 6f 63 20 68 64 5f  file..#.proc hd_
2240: 63 6c 6f 73 65 5f 6d 61 69 6e 20 7b 7d 20 7b 0a  close_main {} {.
2250: 20 20 67 6c 6f 62 61 6c 20 68 64 0a 20 20 68 64    global hd.  hd
2260: 5f 63 6c 6f 73 65 5f 61 75 78 0a 20 20 69 66 20  _close_aux.  if 
2270: 7b 5b 69 6e 66 6f 20 65 78 69 73 74 73 20 68 64  {[info exists hd
2280: 28 6d 61 69 6e 29 5d 7d 20 7b 0a 20 20 20 20 70  (main)]} {.    p
2290: 75 74 73 20 24 68 64 28 6d 61 69 6e 29 20 24 68  uts $hd(main) $h
22a0: 64 28 66 6f 6f 74 65 72 29 0a 20 20 20 20 63 6c  d(footer).    cl
22b0: 6f 73 65 20 24 68 64 28 6d 61 69 6e 29 0a 20 20  ose $hd(main).  
22c0: 20 20 75 6e 73 65 74 20 68 64 28 6d 61 69 6e 29    unset hd(main)
22d0: 0a 20 20 7d 0a 7d 0a 0a 23 20 4f 70 65 6e 20 74  .  }.}..# Open t
22e0: 68 65 20 61 75 78 69 6c 69 61 72 79 20 6f 75 74  he auxiliary out
22f0: 70 75 74 20 66 69 6c 65 2e 0a 23 0a 23 20 4d 6f  put file..#.# Mo
2300: 73 74 20 64 6f 63 75 6d 65 6e 74 73 20 68 61 76  st documents hav
2310: 65 20 6f 6e 6c 79 20 61 20 6d 61 69 6e 20 66 69  e only a main fi
2320: 6c 65 20 61 6e 64 20 6e 6f 20 61 75 78 69 6c 69  le and no auxili
2330: 61 72 79 2e 20 20 48 6f 77 65 76 65 72 2c 20 73  ary.  However, s
2340: 6f 6d 65 0a 23 20 6c 61 72 67 65 20 64 6f 63 75  ome.# large docu
2350: 6d 65 6e 74 73 20 61 72 65 20 62 72 6f 6b 65 6e  ments are broken
2360: 20 75 70 20 69 6e 74 6f 20 73 6d 61 6c 6c 65 72   up into smaller
2370: 20 70 69 65 63 65 73 20 77 68 65 72 65 20 65 61   pieces where ea
2380: 63 68 20 73 6d 61 6c 6c 65 72 20 70 69 65 63 65  ch smaller piece
2390: 0a 23 20 69 73 20 61 6e 20 61 75 78 69 6c 69 61  .# is an auxilia
23a0: 72 79 20 66 69 6c 65 2e 20 20 54 68 65 72 65 20  ry file.  There 
23b0: 77 69 6c 6c 20 74 79 70 69 63 61 6c 6c 79 20 62  will typically b
23c0: 65 20 65 69 74 68 65 72 20 6d 61 6e 79 20 61 75  e either many au
23d0: 78 69 6c 69 61 72 79 20 66 69 6c 65 73 0a 23 20  xiliary files.# 
23e0: 6f 72 20 6e 6f 20 61 75 78 69 6c 69 61 72 79 20  or no auxiliary 
23f0: 66 69 6c 65 73 20 61 73 73 6f 63 69 61 74 65 64  files associated
2400: 20 77 69 74 68 20 65 61 63 68 20 6d 61 69 6e 20   with each main 
2410: 66 69 6c 65 2e 0a 23 0a 70 72 6f 63 20 68 64 5f  file..#.proc hd_
2420: 6f 70 65 6e 5f 61 75 78 20 7b 66 69 6c 65 6e 61  open_aux {filena
2430: 6d 65 7d 20 7b 0a 20 20 67 6c 6f 62 61 6c 20 68  me} {.  global h
2440: 64 20 44 45 53 54 0a 20 20 68 64 5f 63 6c 6f 73  d DEST.  hd_clos
2450: 65 5f 61 75 78 0a 20 20 73 65 74 20 68 64 28 66  e_aux.  set hd(f
2460: 6e 2d 61 75 78 29 20 24 66 69 6c 65 6e 61 6d 65  n-aux) $filename
2470: 0a 20 20 73 65 74 20 68 64 28 72 6f 6f 74 70 61  .  set hd(rootpa
2480: 74 68 2d 61 75 78 29 20 5b 68 64 5f 72 6f 6f 74  th-aux) [hd_root
2490: 70 61 74 68 20 24 66 69 6c 65 6e 61 6d 65 5d 0a  path $filename].
24a0: 20 20 73 65 74 20 68 64 28 61 75 78 29 20 5b 6f    set hd(aux) [o
24b0: 70 65 6e 20 24 44 45 53 54 2f 24 66 69 6c 65 6e  pen $DEST/$filen
24c0: 61 6d 65 20 77 5d 0a 20 20 73 65 74 20 68 64 28  ame w].  set hd(
24d0: 65 6e 61 62 6c 65 2d 61 75 78 29 20 31 0a 20 20  enable-aux) 1.  
24e0: 67 6c 6f 62 61 6c 20 70 61 67 65 6c 69 6e 6b 0a  global pagelink.
24f0: 20 20 6c 61 70 70 65 6e 64 20 70 61 67 65 6c 69    lappend pageli
2500: 6e 6b 28 24 66 69 6c 65 6e 61 6d 65 29 20 24 66  nk($filename) $f
2510: 69 6c 65 6e 61 6d 65 0a 7d 0a 0a 23 20 43 6c 6f  ilename.}..# Clo
2520: 73 65 20 74 68 65 20 61 75 78 69 6c 69 61 72 79  se the auxiliary
2530: 20 6f 75 74 70 75 74 20 66 69 6c 65 0a 23 0a 70   output file.#.p
2540: 72 6f 63 20 68 64 5f 63 6c 6f 73 65 5f 61 75 78  roc hd_close_aux
2550: 20 7b 7d 20 7b 0a 20 20 67 6c 6f 62 61 6c 20 68   {} {.  global h
2560: 64 0a 20 20 69 66 20 7b 5b 69 6e 66 6f 20 65 78  d.  if {[info ex
2570: 69 73 74 73 20 68 64 28 61 75 78 29 5d 7d 20 7b  ists hd(aux)]} {
2580: 0a 20 20 20 20 70 75 74 73 20 24 68 64 28 61 75  .    puts $hd(au
2590: 78 29 20 24 68 64 28 66 6f 6f 74 65 72 29 0a 20  x) $hd(footer). 
25a0: 20 20 20 63 6c 6f 73 65 20 24 68 64 28 61 75 78     close $hd(aux
25b0: 29 0a 20 20 20 20 75 6e 73 65 74 20 68 64 28 61  ).    unset hd(a
25c0: 75 78 29 0a 20 20 20 20 73 65 74 20 68 64 28 65  ux).    set hd(e
25d0: 6e 61 62 6c 65 2d 61 75 78 29 20 30 0a 20 20 20  nable-aux) 0.   
25e0: 20 73 65 74 20 68 64 28 65 6e 61 62 6c 65 2d 6d   set hd(enable-m
25f0: 61 69 6e 29 20 31 0a 20 20 7d 0a 7d 0a 0a 0a 23  ain) 1.  }.}...#
2600: 20 68 64 5f 70 75 74 73 69 6e 34 20 69 73 20 6c   hd_putsin4 is l
2610: 69 6b 65 20 70 75 74 73 20 65 78 63 65 70 74 20  ike puts except 
2620: 74 68 61 74 20 69 74 20 72 65 6d 6f 76 65 73 20  that it removes 
2630: 74 68 65 20 66 69 72 73 74 20 34 20 69 6e 64 65  the first 4 inde
2640: 6e 74 61 74 69 6f 6e 0a 23 20 63 68 61 72 61 63  ntation.# charac
2650: 74 65 72 73 20 66 72 6f 6d 20 65 61 63 68 20 6c  ters from each l
2660: 69 6e 65 2e 20 20 49 74 20 61 6c 73 6f 20 64 6f  ine.  It also do
2670: 65 73 20 76 61 72 69 61 62 6c 65 20 73 75 62 73  es variable subs
2680: 74 69 74 75 74 69 6f 6e 20 69 6e 0a 23 20 74 68  titution in.# th
2690: 65 20 6e 61 6d 65 73 70 61 63 65 20 6f 66 20 69  e namespace of i
26a0: 74 73 20 63 61 6c 6c 69 6e 67 20 70 72 6f 63 65  ts calling proce
26b0: 64 75 72 65 2e 0a 23 0a 70 72 6f 63 20 70 75 74  dure..#.proc put
26c0: 73 69 6e 34 20 7b 66 64 20 74 65 78 74 7d 20 7b  sin4 {fd text} {
26d0: 0a 20 20 72 65 67 73 75 62 20 2d 61 6c 6c 20 22  .  regsub -all "
26e0: 5c 6e 20 20 20 20 22 20 24 74 65 78 74 20 5c 6e  \n    " $text \n
26f0: 20 74 65 78 74 0a 20 20 70 75 74 73 20 24 66 64   text.  puts $fd
2700: 20 5b 75 70 6c 65 76 65 6c 20 31 20 5b 6c 69 73   [uplevel 1 [lis
2710: 74 20 73 75 62 73 74 20 2d 6e 6f 62 61 63 6b 20  t subst -noback 
2720: 2d 6e 6f 63 6f 6d 20 24 74 65 78 74 5d 5d 0a 7d  -nocom $text]].}
2730: 0a 0a 23 20 41 20 70 72 6f 63 65 64 75 72 65 20  ..# A procedure 
2740: 74 6f 20 77 72 69 74 65 20 74 68 65 20 63 6f 6d  to write the com
2750: 6d 6f 6e 20 68 65 61 64 65 72 20 66 6f 75 6e 64  mon header found
2760: 20 6f 6e 20 65 76 65 72 79 20 48 54 4d 4c 20 66   on every HTML f
2770: 69 6c 65 20 6f 6e 0a 23 20 74 68 65 20 53 51 4c  ile on.# the SQL
2780: 69 74 65 20 77 65 62 73 69 74 65 2e 0a 23 0a 23  ite website..#.#
2790: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
27a0: 23 23 23 23 0a 23 20 4e 4f 54 45 3a 20 20 54 68  ####.# NOTE:  Th
27b0: 69 73 20 63 6f 64 65 20 69 73 20 63 6f 70 69 65  is code is copie
27c0: 64 20 61 6e 64 20 72 65 75 73 65 64 20 69 6e 20  d and reused in 
27d0: 6d 61 74 72 69 78 2e 74 63 6c 2e 20 20 57 68 65  matrix.tcl.  Whe
27e0: 6e 20 6d 61 6b 69 6e 67 0a 23 20 63 68 61 6e 67  n making.# chang
27f0: 65 73 20 74 6f 20 74 68 69 73 20 69 6d 70 6c 65  es to this imple
2800: 6d 65 6e 74 61 74 69 6f 6e 2c 20 62 65 20 73 75  mentation, be su
2810: 72 65 20 74 6f 20 61 6c 73 6f 20 63 68 61 6e 67  re to also chang
2820: 65 20 6d 61 74 72 69 78 2e 74 63 6c 2e 0a 23 0a  e matrix.tcl..#.
2830: 70 72 6f 63 20 68 64 5f 68 65 61 64 65 72 20 7b  proc hd_header {
2840: 74 69 74 6c 65 20 7b 73 72 63 66 69 6c 65 20 7b  title {srcfile {
2850: 7d 7d 7d 20 7b 0a 20 20 67 6c 6f 62 61 6c 20 68  }}} {.  global h
2860: 64 0a 20 20 73 65 74 20 73 61 76 65 64 5f 65 6e  d.  set saved_en
2870: 61 62 6c 65 20 24 68 64 28 65 6e 61 62 6c 65 2d  able $hd(enable-
2880: 6d 61 69 6e 29 0a 20 20 69 66 20 7b 24 73 72 63  main).  if {$src
2890: 66 69 6c 65 3d 3d 22 22 7d 20 7b 0a 20 20 20 20  file==""} {.    
28a0: 73 65 74 20 66 64 20 24 68 64 28 61 75 78 29 0a  set fd $hd(aux).
28b0: 20 20 20 20 73 65 74 20 70 61 74 68 20 24 68 64      set path $hd
28c0: 28 72 6f 6f 74 70 61 74 68 2d 61 75 78 29 0a 20  (rootpath-aux). 
28d0: 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20 20 73 65   } else {.    se
28e0: 74 20 66 64 20 24 68 64 28 6d 61 69 6e 29 0a 20  t fd $hd(main). 
28f0: 20 20 20 73 65 74 20 70 61 74 68 20 24 68 64 28     set path $hd(
2900: 72 6f 6f 74 70 61 74 68 2d 6d 61 69 6e 29 0a 20  rootpath-main). 
2910: 20 7d 0a 20 20 70 75 74 73 20 24 66 64 20 7b 3c   }.  puts $fd {<
2920: 21 44 4f 43 54 59 50 45 20 48 54 4d 4c 20 50 55  !DOCTYPE HTML PU
2930: 42 4c 49 43 20 22 2d 2f 2f 57 33 43 2f 2f 44 54  BLIC "-//W3C//DT
2940: 44 20 48 54 4d 4c 20 34 2e 30 31 2f 2f 45 4e 22  D HTML 4.01//EN"
2950: 20 22 68 74 74 70 3a 2f 2f 77 77 77 2e 77 33 2e   "http://www.w3.
2960: 6f 72 67 2f 54 52 2f 68 74 6d 6c 34 2f 73 74 72  org/TR/html4/str
2970: 69 63 74 2e 64 74 64 22 3e 7d 0a 20 20 70 75 74  ict.dtd">}.  put
2980: 73 20 24 66 64 20 7b 3c 68 74 6d 6c 3e 3c 68 65  s $fd {<html><he
2990: 61 64 3e 7d 0a 20 20 70 75 74 73 20 24 66 64 20  ad>}.  puts $fd 
29a0: 22 3c 74 69 74 6c 65 3e 24 74 69 74 6c 65 3c 2f  "<title>$title</
29b0: 74 69 74 6c 65 3e 22 0a 20 20 70 75 74 73 69 6e  title>".  putsin
29c0: 34 20 24 66 64 20 7b 3c 73 74 79 6c 65 20 74 79  4 $fd {<style ty
29d0: 70 65 3d 22 74 65 78 74 2f 63 73 73 22 3e 0a 20  pe="text/css">. 
29e0: 20 20 20 62 6f 64 79 20 7b 0a 20 20 20 20 20 20     body {.      
29f0: 20 20 6d 61 72 67 69 6e 3a 20 61 75 74 6f 3b 0a    margin: auto;.
2a00: 20 20 20 20 20 20 20 20 66 6f 6e 74 2d 66 61 6d          font-fam
2a10: 69 6c 79 3a 20 56 65 72 64 61 6e 61 2c 20 73 61  ily: Verdana, sa
2a20: 6e 73 2d 73 65 72 69 66 3b 0a 20 20 20 20 20 20  ns-serif;.      
2a30: 20 20 70 61 64 64 69 6e 67 3a 20 38 70 78 20 31    padding: 8px 1
2a40: 25 3b 0a 20 20 20 20 7d 0a 20 20 20 20 0a 20 20  %;.    }.    .  
2a50: 20 20 61 20 7b 20 63 6f 6c 6f 72 3a 20 23 34 35    a { color: #45
2a60: 37 33 35 66 20 7d 0a 20 20 20 20 61 3a 76 69 73  735f }.    a:vis
2a70: 69 74 65 64 20 7b 20 63 6f 6c 6f 72 3a 20 23 37  ited { color: #7
2a80: 33 34 35 35 39 20 7d 0a 20 20 20 20 0a 20 20 20  34559 }.    .   
2a90: 20 2e 6c 6f 67 6f 20 7b 20 70 6f 73 69 74 69 6f   .logo { positio
2aa0: 6e 3a 61 62 73 6f 6c 75 74 65 3b 20 6d 61 72 67  n:absolute; marg
2ab0: 69 6e 3a 33 70 78 3b 20 7d 0a 20 20 20 20 2e 74  in:3px; }.    .t
2ac0: 61 67 6c 69 6e 65 20 7b 0a 20 20 20 20 20 20 66  agline {.      f
2ad0: 6c 6f 61 74 3a 72 69 67 68 74 3b 0a 20 20 20 20  loat:right;.    
2ae0: 20 20 74 65 78 74 2d 61 6c 69 67 6e 3a 72 69 67    text-align:rig
2af0: 68 74 3b 0a 20 20 20 20 20 20 66 6f 6e 74 2d 73  ht;.      font-s
2b00: 74 79 6c 65 3a 69 74 61 6c 69 63 3b 0a 20 20 20  tyle:italic;.   
2b10: 20 20 20 77 69 64 74 68 3a 33 30 30 70 78 3b 0a     width:300px;.
2b20: 20 20 20 20 20 20 6d 61 72 67 69 6e 3a 31 32 70        margin:12p
2b30: 78 3b 0a 20 20 20 20 20 20 6d 61 72 67 69 6e 2d  x;.      margin-
2b40: 74 6f 70 3a 35 38 70 78 3b 0a 20 20 20 20 7d 0a  top:58px;.    }.
2b50: 20 20 20 20 0a 20 20 20 20 2e 74 6f 6f 6c 62 61      .    .toolba
2b60: 72 20 7b 0a 20 20 20 20 20 20 74 65 78 74 2d 61  r {.      text-a
2b70: 6c 69 67 6e 3a 20 63 65 6e 74 65 72 3b 0a 20 20  lign: center;.  
2b80: 20 20 20 20 6c 69 6e 65 2d 68 65 69 67 68 74 3a      line-height:
2b90: 20 31 2e 36 65 6d 3b 0a 20 20 20 20 20 20 6d 61   1.6em;.      ma
2ba0: 72 67 69 6e 3a 20 30 3b 0a 20 20 20 20 20 20 70  rgin: 0;.      p
2bb0: 61 64 64 69 6e 67 3a 20 30 70 78 20 38 70 78 3b  adding: 0px 8px;
2bc0: 0a 20 20 20 20 7d 0a 20 20 20 20 2e 74 6f 6f 6c  .    }.    .tool
2bd0: 62 61 72 20 61 20 7b 20 63 6f 6c 6f 72 3a 20 77  bar a { color: w
2be0: 68 69 74 65 3b 20 74 65 78 74 2d 64 65 63 6f 72  hite; text-decor
2bf0: 61 74 69 6f 6e 3a 20 6e 6f 6e 65 3b 20 70 61 64  ation: none; pad
2c00: 64 69 6e 67 3a 20 36 70 78 20 31 32 70 78 3b 20  ding: 6px 12px; 
2c10: 7d 0a 20 20 20 20 2e 74 6f 6f 6c 62 61 72 20 61  }.    .toolbar a
2c20: 3a 76 69 73 69 74 65 64 20 7b 20 63 6f 6c 6f 72  :visited { color
2c30: 3a 20 77 68 69 74 65 3b 20 7d 0a 20 20 20 20 2e  : white; }.    .
2c40: 74 6f 6f 6c 62 61 72 20 61 3a 68 6f 76 65 72 20  toolbar a:hover 
2c50: 7b 20 63 6f 6c 6f 72 3a 20 23 38 30 61 37 39 36  { color: #80a796
2c60: 3b 20 62 61 63 6b 67 72 6f 75 6e 64 3a 20 77 68  ; background: wh
2c70: 69 74 65 3b 20 7d 0a 20 20 20 20 0a 20 20 20 20  ite; }.    .    
2c80: 2e 63 6f 6e 74 65 6e 74 20 20 20 20 7b 20 6d 61  .content    { ma
2c90: 72 67 69 6e 3a 20 35 25 3b 20 7d 0a 20 20 20 20  rgin: 5%; }.    
2ca0: 2e 63 6f 6e 74 65 6e 74 20 64 74 20 7b 20 66 6f  .content dt { fo
2cb0: 6e 74 2d 77 65 69 67 68 74 3a 62 6f 6c 64 3b 20  nt-weight:bold; 
2cc0: 7d 0a 20 20 20 20 2e 63 6f 6e 74 65 6e 74 20 64  }.    .content d
2cd0: 64 20 7b 20 6d 61 72 67 69 6e 2d 62 6f 74 74 6f  d { margin-botto
2ce0: 6d 3a 20 32 35 70 78 3b 20 6d 61 72 67 69 6e 2d  m: 25px; margin-
2cf0: 6c 65 66 74 3a 32 30 25 3b 20 7d 0a 20 20 20 20  left:20%; }.    
2d00: 2e 63 6f 6e 74 65 6e 74 20 75 6c 20 7b 20 70 61  .content ul { pa
2d10: 64 64 69 6e 67 3a 30 70 78 3b 20 70 61 64 64 69  dding:0px; paddi
2d20: 6e 67 2d 6c 65 66 74 3a 20 31 35 70 78 3b 20 6d  ng-left: 15px; m
2d30: 61 72 67 69 6e 3a 30 70 78 3b 20 7d 0a 20 20 20  argin:0px; }.   
2d40: 20 0a 20 20 20 20 2f 2a 20 72 6f 75 6e 64 65 64   .    /* rounded
2d50: 20 63 6f 72 6e 65 72 73 20 2a 2f 0a 20 20 20 20   corners */.    
2d60: 2e 73 65 20 20 7b 20 62 61 63 6b 67 72 6f 75 6e  .se  { backgroun
2d70: 64 3a 20 75 72 6c 28 24 7b 70 61 74 68 7d 69 6d  d: url(${path}im
2d80: 61 67 65 73 2f 73 65 2e 70 6e 67 29 20 31 30 30  ages/se.png) 100
2d90: 25 20 31 30 30 25 20 6e 6f 2d 72 65 70 65 61 74  % 100% no-repeat
2da0: 20 23 38 30 61 37 39 36 7d 0a 20 20 20 20 2e 73   #80a796}.    .s
2db0: 77 20 20 7b 20 62 61 63 6b 67 72 6f 75 6e 64 3a  w  { background:
2dc0: 20 75 72 6c 28 24 7b 70 61 74 68 7d 69 6d 61 67   url(${path}imag
2dd0: 65 73 2f 73 77 2e 70 6e 67 29 20 30 25 20 31 30  es/sw.png) 0% 10
2de0: 30 25 20 6e 6f 2d 72 65 70 65 61 74 20 7d 0a 20  0% no-repeat }. 
2df0: 20 20 20 2e 6e 65 20 20 7b 20 62 61 63 6b 67 72     .ne  { backgr
2e00: 6f 75 6e 64 3a 20 75 72 6c 28 24 7b 70 61 74 68  ound: url(${path
2e10: 7d 69 6d 61 67 65 73 2f 6e 65 2e 70 6e 67 29 20  }images/ne.png) 
2e20: 31 30 30 25 20 30 25 20 6e 6f 2d 72 65 70 65 61  100% 0% no-repea
2e30: 74 20 7d 0a 20 20 20 20 2e 6e 77 20 20 7b 20 62  t }.    .nw  { b
2e40: 61 63 6b 67 72 6f 75 6e 64 3a 20 75 72 6c 28 24  ackground: url($
2e50: 7b 70 61 74 68 7d 69 6d 61 67 65 73 2f 6e 77 2e  {path}images/nw.
2e60: 70 6e 67 29 20 30 25 20 30 25 20 6e 6f 2d 72 65  png) 0% 0% no-re
2e70: 70 65 61 74 20 7d 0a 0a 20 20 20 20 2f 2a 20 54  peat }..    /* T
2e80: 68 69 6e 67 73 20 66 6f 72 20 22 66 61 6e 63 79  hings for "fancy
2e90: 66 6f 72 6d 61 74 22 20 64 6f 63 75 6d 65 6e 74  format" document
2ea0: 73 20 73 74 61 72 74 20 68 65 72 65 2e 20 2a 2f  s start here. */
2eb0: 0a 20 20 20 20 2e 66 61 6e 63 79 20 2e 63 6f 64  .    .fancy .cod
2ec0: 65 62 6c 6f 63 6b 20 69 20 7b 20 63 6f 6c 6f 72  eblock i { color
2ed0: 3a 20 64 61 72 6b 62 6c 75 65 3b 20 7d 0a 20 20  : darkblue; }.  
2ee0: 20 20 2e 66 61 6e 63 79 20 68 31 2c 2e 66 61 6e    .fancy h1,.fan
2ef0: 63 79 20 68 32 2c 2e 66 61 6e 63 79 20 68 33 2c  cy h2,.fancy h3,
2f00: 2e 66 61 6e 63 79 20 68 34 20 7b 66 6f 6e 74 2d  .fancy h4 {font-
2f10: 77 65 69 67 68 74 3a 6e 6f 72 6d 61 6c 3b 63 6f  weight:normal;co
2f20: 6c 6f 72 3a 23 38 30 61 37 39 36 7d 0a 20 20 20  lor:#80a796}.   
2f30: 20 2e 66 61 6e 63 79 20 68 32 20 7b 20 6d 61 72   .fancy h2 { mar
2f40: 67 69 6e 2d 6c 65 66 74 3a 20 31 30 70 78 20 7d  gin-left: 10px }
2f50: 0a 20 20 20 20 2e 66 61 6e 63 79 20 68 33 20 7b  .    .fancy h3 {
2f60: 20 6d 61 72 67 69 6e 2d 6c 65 66 74 3a 20 32 30   margin-left: 20
2f70: 70 78 20 7d 0a 20 20 20 20 2e 66 61 6e 63 79 20  px }.    .fancy 
2f80: 68 34 20 7b 20 6d 61 72 67 69 6e 2d 6c 65 66 74  h4 { margin-left
2f90: 3a 20 33 30 70 78 20 7d 0a 20 20 20 20 2e 66 61  : 30px }.    .fa
2fa0: 6e 63 79 20 74 68 20 7b 77 68 69 74 65 2d 73 70  ncy th {white-sp
2fb0: 61 63 65 3a 6e 6f 77 72 61 70 3b 74 65 78 74 2d  ace:nowrap;text-
2fc0: 61 6c 69 67 6e 3a 6c 65 66 74 3b 62 6f 72 64 65  align:left;borde
2fd0: 72 2d 62 6f 74 74 6f 6d 3a 73 6f 6c 69 64 20 31  r-bottom:solid 1
2fe0: 70 78 20 23 34 34 34 7d 0a 20 20 20 20 2e 66 61  px #444}.    .fa
2ff0: 6e 63 79 20 74 68 2c 20 2e 66 61 6e 63 79 20 74  ncy th, .fancy t
3000: 64 20 7b 70 61 64 64 69 6e 67 3a 20 30 2e 32 65  d {padding: 0.2e
3010: 6d 20 31 65 78 3b 20 76 65 72 74 69 63 61 6c 2d  m 1ex; vertical-
3020: 61 6c 69 67 6e 3a 74 6f 70 7d 0a 20 20 20 20 2e  align:top}.    .
3030: 66 61 6e 63 79 20 23 74 6f 63 20 61 20 20 20 20  fancy #toc a    
3040: 20 20 20 20 7b 20 63 6f 6c 6f 72 3a 20 64 61 72      { color: dar
3050: 6b 62 6c 75 65 20 3b 20 74 65 78 74 2d 64 65 63  kblue ; text-dec
3060: 6f 72 61 74 69 6f 6e 3a 20 6e 6f 6e 65 20 7d 0a  oration: none }.
3070: 20 20 20 20 2e 66 61 6e 63 79 20 2e 74 6f 64 6f      .fancy .todo
3080: 20 20 20 20 20 20 20 20 20 7b 20 63 6f 6c 6f 72           { color
3090: 3a 20 23 41 41 33 33 33 33 20 3b 20 66 6f 6e 74  : #AA3333 ; font
30a0: 2d 73 74 79 6c 65 20 3a 20 69 74 61 6c 69 63 20  -style : italic 
30b0: 7d 0a 20 20 20 20 2e 66 61 6e 63 79 20 2e 74 6f  }.    .fancy .to
30c0: 64 6f 3a 62 65 66 6f 72 65 20 20 7b 20 63 6f 6e  do:before  { con
30d0: 74 65 6e 74 3a 20 27 54 4f 44 4f 3a 27 20 7d 0a  tent: 'TODO:' }.
30e0: 20 20 20 20 2e 66 61 6e 63 79 20 70 2e 74 6f 64      .fancy p.tod
30f0: 6f 20 20 20 20 20 20 20 20 7b 20 62 6f 72 64 65  o        { borde
3100: 72 3a 20 73 6f 6c 69 64 20 23 41 41 33 33 33 33  r: solid #AA3333
3110: 20 31 70 78 3b 20 70 61 64 64 69 6e 67 3a 20 31   1px; padding: 1
3120: 65 78 20 7d 0a 20 20 20 20 2e 66 61 6e 63 79 20  ex }.    .fancy 
3130: 69 6d 67 20 7b 20 64 69 73 70 6c 61 79 3a 62 6c  img { display:bl
3140: 6f 63 6b 3b 20 7d 0a 20 20 20 20 2e 66 61 6e 63  ock; }.    .fanc
3150: 79 20 3a 6c 69 6e 6b 3a 68 6f 76 65 72 2c 20 2e  y :link:hover, .
3160: 66 61 6e 63 79 20 3a 76 69 73 69 74 65 64 3a 68  fancy :visited:h
3170: 6f 76 65 72 20 7b 20 62 61 63 6b 67 72 6f 75 6e  over { backgroun
3180: 64 3a 20 77 68 65 61 74 20 7d 0a 20 20 20 20 2e  d: wheat }.    .
3190: 66 61 6e 63 79 20 70 2c 2e 66 61 6e 63 79 20 75  fancy p,.fancy u
31a0: 6c 2c 2e 66 61 6e 63 79 20 6f 6c 20 7b 20 6d 61  l,.fancy ol { ma
31b0: 72 67 69 6e 3a 20 31 65 6d 20 35 65 78 20 7d 0a  rgin: 1em 5ex }.
31c0: 20 20 20 20 2e 66 61 6e 63 79 20 6c 69 20 70 20      .fancy li p 
31d0: 7b 20 6d 61 72 67 69 6e 3a 20 31 65 6d 20 30 20  { margin: 1em 0 
31e0: 7d 0a 20 20 20 20 2f 2a 20 45 6e 64 20 6f 66 20  }.    /* End of 
31f0: 22 66 61 6e 63 79 66 6f 72 6d 61 74 22 20 73 70  "fancyformat" sp
3200: 65 63 69 66 69 63 20 72 75 6c 65 73 2e 20 2a 2f  ecific rules. */
3210: 0a 0a 20 20 20 20 3c 2f 73 74 79 6c 65 3e 0a 20  ..    </style>. 
3220: 20 20 20 3c 6d 65 74 61 20 68 74 74 70 2d 65 71     <meta http-eq
3230: 75 69 76 3d 22 63 6f 6e 74 65 6e 74 2d 74 79 70  uiv="content-typ
3240: 65 22 20 63 6f 6e 74 65 6e 74 3d 22 74 65 78 74  e" content="text
3250: 2f 68 74 6d 6c 3b 20 63 68 61 72 73 65 74 3d 55  /html; charset=U
3260: 54 46 2d 38 22 3e 0a 20 20 7d 0a 20 20 70 75 74  TF-8">.  }.  put
3270: 73 20 24 66 64 20 7b 3c 2f 68 65 61 64 3e 7d 0a  s $fd {</head>}.
3280: 20 20 69 66 20 7b 5b 66 69 6c 65 20 65 78 69 73    if {[file exis
3290: 74 73 20 44 52 41 46 54 5d 7d 20 7b 0a 20 20 20  ts DRAFT]} {.   
32a0: 20 73 65 74 20 74 61 67 6c 69 6e 65 20 7b 3c 66   set tagline {<f
32b0: 6f 6e 74 20 73 69 7a 65 3d 22 36 22 20 63 6f 6c  ont size="6" col
32c0: 6f 72 3d 22 72 65 64 22 3e 2a 2a 2a 20 44 52 41  or="red">*** DRA
32d0: 46 54 20 2a 2a 2a 3c 2f 66 6f 6e 74 3e 7d 0a 20  FT ***</font>}. 
32e0: 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20 20 73 65   } else {.    se
32f0: 74 20 74 61 67 6c 69 6e 65 20 7b 53 6d 61 6c 6c  t tagline {Small
3300: 2e 20 46 61 73 74 2e 20 52 65 6c 69 61 62 6c 65  . Fast. Reliable
3310: 2e 3c 62 72 3e 43 68 6f 6f 73 65 20 61 6e 79 20  .<br>Choose any 
3320: 74 68 72 65 65 2e 7d 0a 20 20 7d 0a 20 20 70 75  three.}.  }.  pu
3330: 74 73 69 6e 34 20 24 66 64 20 7b 3c 62 6f 64 79  tsin4 $fd {<body
3340: 3e 0a 20 20 20 20 3c 64 69 76 3e 3c 21 2d 2d 20  >.    <div><!-- 
3350: 63 6f 6e 74 61 69 6e 65 72 20 64 69 76 20 74 6f  container div to
3360: 20 73 61 74 69 73 66 79 20 76 61 6c 69 64 61 74   satisfy validat
3370: 6f 72 20 2d 2d 3e 0a 20 20 20 20 0a 20 20 20 20  or -->.    .    
3380: 3c 61 20 68 72 65 66 3d 22 24 7b 70 61 74 68 7d  <a href="${path}
3390: 69 6e 64 65 78 2e 68 74 6d 6c 22 3e 0a 20 20 20  index.html">.   
33a0: 20 3c 69 6d 67 20 63 6c 61 73 73 3d 22 6c 6f 67   <img class="log
33b0: 6f 22 20 73 72 63 3d 22 24 7b 70 61 74 68 7d 69  o" src="${path}i
33c0: 6d 61 67 65 73 2f 53 51 4c 69 74 65 2e 67 69 66  mages/SQLite.gif
33d0: 22 20 61 6c 74 3d 22 53 51 4c 69 74 65 20 4c 6f  " alt="SQLite Lo
33e0: 67 6f 22 0a 20 20 20 20 20 62 6f 72 64 65 72 3d  go".     border=
33f0: 22 30 22 3e 3c 2f 61 3e 0a 20 20 20 20 3c 64 69  "0"></a>.    <di
3400: 76 3e 3c 21 2d 2d 20 49 45 20 68 61 63 6b 20 74  v><!-- IE hack t
3410: 6f 20 70 72 65 76 65 6e 74 20 64 69 73 61 70 70  o prevent disapp
3420: 65 61 72 69 6e 67 20 6c 6f 67 6f 2d 2d 3e 3c 2f  earing logo--></
3430: 64 69 76 3e 0a 20 20 20 20 3c 64 69 76 20 63 6c  div>.    <div cl
3440: 61 73 73 3d 22 74 61 67 6c 69 6e 65 22 3e 24 7b  ass="tagline">${
3450: 74 61 67 6c 69 6e 65 7d 3c 2f 64 69 76 3e 0a 0a  tagline}</div>..
3460: 20 20 20 20 3c 74 61 62 6c 65 20 77 69 64 74 68      <table width
3470: 3d 31 30 30 25 20 73 74 79 6c 65 3d 22 63 6c 65  =100% style="cle
3480: 61 72 3a 62 6f 74 68 22 3e 3c 74 72 3e 3c 74 64  ar:both"><tr><td
3490: 3e 0a 20 20 20 20 20 20 3c 64 69 76 20 63 6c 61  >.      <div cla
34a0: 73 73 3d 22 73 65 22 3e 3c 64 69 76 20 63 6c 61  ss="se"><div cla
34b0: 73 73 3d 22 73 77 22 3e 3c 64 69 76 20 63 6c 61  ss="sw"><div cla
34c0: 73 73 3d 22 6e 65 22 3e 3c 64 69 76 20 63 6c 61  ss="ne"><div cla
34d0: 73 73 3d 22 6e 77 22 3e 0a 20 20 20 20 20 20 3c  ss="nw">.      <
34e0: 74 61 62 6c 65 20 77 69 64 74 68 3d 31 30 30 25  table width=100%
34f0: 20 73 74 79 6c 65 3d 22 70 61 64 64 69 6e 67 3a   style="padding:
3500: 30 3b 6d 61 72 67 69 6e 3a 30 3b 63 65 6c 6c 2d  0;margin:0;cell-
3510: 73 70 61 63 69 6e 67 3a 30 22 3e 3c 74 72 3e 0a  spacing:0"><tr>.
3520: 20 20 20 20 20 20 3c 74 64 20 77 69 64 74 68 3d        <td width=
3530: 31 30 30 25 3e 0a 20 20 20 20 20 20 3c 64 69 76  100%>.      <div
3540: 20 63 6c 61 73 73 3d 22 74 6f 6f 6c 62 61 72 22   class="toolbar"
3550: 3e 0a 20 20 20 20 20 20 20 20 3c 61 20 68 72 65  >.        <a hre
3560: 66 3d 22 24 7b 70 61 74 68 7d 61 62 6f 75 74 2e  f="${path}about.
3570: 68 74 6d 6c 22 3e 41 62 6f 75 74 3c 2f 61 3e 0a  html">About</a>.
3580: 20 20 20 20 20 20 20 20 3c 61 20 68 72 65 66 3d          <a href=
3590: 22 24 7b 70 61 74 68 7d 73 69 74 65 6d 61 70 2e  "${path}sitemap.
35a0: 68 74 6d 6c 22 3e 53 69 74 65 6d 61 70 3c 2f 61  html">Sitemap</a
35b0: 3e 0a 20 20 20 20 20 20 20 20 3c 61 20 68 72 65  >.        <a hre
35c0: 66 3d 22 24 7b 70 61 74 68 7d 64 6f 63 73 2e 68  f="${path}docs.h
35d0: 74 6d 6c 22 3e 44 6f 63 75 6d 65 6e 74 61 74 69  tml">Documentati
35e0: 6f 6e 3c 2f 61 3e 0a 20 20 20 20 20 20 20 20 3c  on</a>.        <
35f0: 61 20 68 72 65 66 3d 22 24 7b 70 61 74 68 7d 64  a href="${path}d
3600: 6f 77 6e 6c 6f 61 64 2e 68 74 6d 6c 22 3e 44 6f  ownload.html">Do
3610: 77 6e 6c 6f 61 64 3c 2f 61 3e 0a 20 20 20 20 20  wnload</a>.     
3620: 20 20 20 3c 61 20 68 72 65 66 3d 22 24 7b 70 61     <a href="${pa
3630: 74 68 7d 63 6f 70 79 72 69 67 68 74 2e 68 74 6d  th}copyright.htm
3640: 6c 22 3e 4c 69 63 65 6e 73 65 3c 2f 61 3e 0a 20  l">License</a>. 
3650: 20 20 20 20 20 20 20 3c 61 20 68 72 65 66 3d 22         <a href="
3660: 24 7b 70 61 74 68 7d 6e 65 77 73 2e 68 74 6d 6c  ${path}news.html
3670: 22 3e 4e 65 77 73 3c 2f 61 3e 0a 20 20 20 20 20  ">News</a>.     
3680: 20 20 20 3c 61 20 68 72 65 66 3d 22 24 7b 70 61     <a href="${pa
3690: 74 68 7d 73 75 70 70 6f 72 74 2e 68 74 6d 6c 22  th}support.html"
36a0: 3e 53 75 70 70 6f 72 74 3c 2f 61 3e 0a 20 20 20  >Support</a>.   
36b0: 20 20 20 3c 2f 64 69 76 3e 7d 0a 20 20 69 66 20     </div>}.  if 
36c0: 7b 5b 66 69 6c 65 20 65 78 69 73 74 73 20 53 45  {[file exists SE
36d0: 41 52 43 48 5d 7d 20 7b 0a 20 20 20 20 70 75 74  ARCH]} {.    put
36e0: 73 69 6e 34 20 24 66 64 20 7b 3c 74 64 3e 0a 20  sin4 $fd {<td>. 
36f0: 20 20 20 20 20 20 20 3c 64 69 76 20 73 74 79 6c         <div styl
3700: 65 3d 22 70 61 64 64 69 6e 67 3a 30 20 31 65 6d  e="padding:0 1em
3710: 20 30 70 78 20 30 3b 77 68 69 74 65 2d 73 70 61   0px 0;white-spa
3720: 63 65 3a 6e 6f 77 72 61 70 22 3e 0a 20 20 20 20  ce:nowrap">.    
3730: 20 20 20 20 3c 66 6f 72 6d 20 6e 61 6d 65 3d 66      <form name=f
3740: 20 6d 65 74 68 6f 64 3d 22 47 45 54 22 20 61 63   method="GET" ac
3750: 74 69 6f 6e 3d 22 68 74 74 70 3a 2f 2f 77 77 77  tion="http://www
3760: 2e 73 71 6c 69 74 65 2e 6f 72 67 2f 73 65 61 72  .sqlite.org/sear
3770: 63 68 22 3e 0a 20 20 20 20 20 20 20 20 20 20 3c  ch">.          <
3780: 69 6e 70 75 74 20 69 64 3d 71 20 6e 61 6d 65 3d  input id=q name=
3790: 71 20 74 79 70 65 3d 74 65 78 74 20 76 61 6c 75  q type=text valu
37a0: 65 3d 22 22 0a 20 20 20 20 20 20 20 20 20 20 20  e="".           
37b0: 6f 6e 66 6f 63 75 73 3d 22 65 6e 74 65 72 73 65  onfocus="enterse
37c0: 61 72 63 68 28 29 22 20 6f 6e 62 6c 75 72 3d 22  arch()" onblur="
37d0: 6c 65 61 76 65 73 65 61 72 63 68 28 29 22 20 73  leavesearch()" s
37e0: 74 79 6c 65 3d 22 77 69 64 74 68 3a 32 34 65 78  tyle="width:24ex
37f0: 3b 70 61 64 64 69 6e 67 3a 31 70 78 20 31 65 78  ;padding:1px 1ex
3800: 3b 20 62 6f 72 64 65 72 3a 73 6f 6c 69 64 20 77  ; border:solid w
3810: 68 69 74 65 20 31 70 78 3b 20 66 6f 6e 74 2d 73  hite 1px; font-s
3820: 69 7a 65 3a 30 2e 39 65 6d 22 3e 0a 20 20 20 20  ize:0.9em">.    
3830: 20 20 20 20 20 20 3c 69 6e 70 75 74 20 74 79 70        <input typ
3840: 65 3d 73 75 62 6d 69 74 20 76 61 6c 75 65 3d 22  e=submit value="
3850: 47 6f 22 20 73 74 79 6c 65 3d 22 62 6f 72 64 65  Go" style="borde
3860: 72 3a 73 6f 6c 69 64 20 77 68 69 74 65 20 31 70  r:solid white 1p
3870: 78 3b 62 61 63 6b 67 72 6f 75 6e 64 2d 63 6f 6c  x;background-col
3880: 6f 72 3a 23 38 30 61 37 39 36 3b 63 6f 6c 6f 72  or:#80a796;color
3890: 3a 77 68 69 74 65 3b 66 6f 6e 74 2d 73 69 7a 65  :white;font-size
38a0: 3a 30 2e 39 65 6d 3b 70 61 64 64 69 6e 67 3a 30  :0.9em;padding:0
38b0: 20 31 65 78 22 3e 0a 20 20 20 20 20 20 20 20 3c   1ex">.        <
38c0: 2f 66 6f 72 6d 3e 0a 20 20 20 20 20 20 20 20 3c  /form>.        <
38d0: 2f 64 69 76 3e 0a 20 20 20 20 20 20 3c 2f 74 61  /div>.      </ta
38e0: 62 6c 65 3e 7d 0a 20 20 7d 0a 20 20 70 75 74 73  ble>}.  }.  puts
38f0: 69 6e 34 20 24 66 64 20 7b 3c 2f 64 69 76 3e 3c  in4 $fd {</div><
3900: 2f 64 69 76 3e 3c 2f 64 69 76 3e 3c 2f 64 69 76  /div></div></div
3910: 3e 0a 20 20 20 20 3c 2f 74 64 3e 3c 2f 74 72 3e  >.    </td></tr>
3920: 3c 2f 74 61 62 6c 65 3e 0a 20 20 7d 0a 20 20 69  </table>.  }.  i
3930: 66 20 7b 5b 66 69 6c 65 20 65 78 69 73 74 73 20  f {[file exists 
3940: 53 45 41 52 43 48 5d 7d 20 7b 0a 20 20 20 20 70  SEARCH]} {.    p
3950: 75 74 73 69 6e 34 20 24 66 64 20 7b 3c 73 63 72  utsin4 $fd {<scr
3960: 69 70 74 3e 0a 20 20 20 20 20 20 67 4d 73 67 20  ipt>.      gMsg 
3970: 3d 20 22 53 65 61 72 63 68 20 53 51 4c 69 74 65  = "Search SQLite
3980: 20 44 6f 63 73 2e 2e 2e 22 0a 20 20 20 20 20 20   Docs...".      
3990: 66 75 6e 63 74 69 6f 6e 20 65 6e 74 65 72 73 65  function enterse
39a0: 61 72 63 68 28 29 20 7b 0a 20 20 20 20 20 20 20  arch() {.       
39b0: 20 76 61 72 20 71 20 3d 20 64 6f 63 75 6d 65 6e   var q = documen
39c0: 74 2e 67 65 74 45 6c 65 6d 65 6e 74 42 79 49 64  t.getElementById
39d0: 28 22 71 22 29 3b 0a 20 20 20 20 20 20 20 20 69  ("q");.        i
39e0: 66 28 20 71 2e 76 61 6c 75 65 20 3d 3d 20 67 4d  f( q.value == gM
39f0: 73 67 20 29 20 7b 20 71 2e 76 61 6c 75 65 20 3d  sg ) { q.value =
3a00: 20 22 22 20 7d 0a 20 20 20 20 20 20 20 20 71 2e   "" }.        q.
3a10: 73 74 79 6c 65 2e 63 6f 6c 6f 72 20 3d 20 22 62  style.color = "b
3a20: 6c 61 63 6b 22 0a 20 20 20 20 20 20 20 20 71 2e  lack".        q.
3a30: 73 74 79 6c 65 2e 66 6f 6e 74 53 74 79 6c 65 20  style.fontStyle 
3a40: 3d 20 22 6e 6f 72 6d 61 6c 22 0a 20 20 20 20 20  = "normal".     
3a50: 20 7d 0a 20 20 20 20 20 20 66 75 6e 63 74 69 6f   }.      functio
3a60: 6e 20 6c 65 61 76 65 73 65 61 72 63 68 28 29 20  n leavesearch() 
3a70: 7b 0a 20 20 20 20 20 20 20 20 76 61 72 20 71 20  {.        var q 
3a80: 3d 20 64 6f 63 75 6d 65 6e 74 2e 67 65 74 45 6c  = document.getEl
3a90: 65 6d 65 6e 74 42 79 49 64 28 22 71 22 29 3b 0a  ementById("q");.
3aa0: 20 20 20 20 20 20 20 20 69 66 28 20 71 2e 76 61          if( q.va
3ab0: 6c 75 65 20 3d 3d 20 22 22 20 29 20 7b 20 0a 20  lue == "" ) { . 
3ac0: 20 20 20 20 20 20 20 20 20 71 2e 76 61 6c 75 65           q.value
3ad0: 20 3d 20 67 4d 73 67 0a 20 20 20 20 20 20 20 20   = gMsg.        
3ae0: 20 20 71 2e 73 74 79 6c 65 2e 63 6f 6c 6f 72 20    q.style.color 
3af0: 3d 20 22 23 38 30 61 37 39 36 22 0a 20 20 20 20  = "#80a796".    
3b00: 20 20 20 20 20 20 71 2e 73 74 79 6c 65 2e 66 6f        q.style.fo
3b10: 6e 74 53 74 79 6c 65 20 3d 20 22 69 74 61 6c 69  ntStyle = "itali
3b20: 63 22 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20  c".        }.   
3b30: 20 20 20 7d 0a 20 20 20 20 20 20 66 75 6e 63 74     }.      funct
3b40: 69 6f 6e 20 69 6e 69 74 73 65 61 72 63 68 28 29  ion initsearch()
3b50: 20 7b 0a 20 20 20 20 20 20 20 20 76 61 72 20 71   {.        var q
3b60: 20 3d 20 64 6f 63 75 6d 65 6e 74 2e 67 65 74 45   = document.getE
3b70: 6c 65 6d 65 6e 74 42 79 49 64 28 22 71 22 29 3b  lementById("q");
3b80: 0a 20 20 20 20 20 20 20 20 71 2e 76 61 6c 75 65  .        q.value
3b90: 20 3d 20 22 22 0a 20 20 20 20 20 20 20 20 20 20   = "".          
3ba0: 71 2e 76 61 6c 75 65 20 3d 20 67 4d 73 67 0a 20  q.value = gMsg. 
3bb0: 20 20 20 20 20 20 20 20 20 71 2e 73 74 79 6c 65           q.style
3bc0: 2e 63 6f 6c 6f 72 20 3d 20 22 23 38 30 61 37 39  .color = "#80a79
3bd0: 36 22 0a 20 20 20 20 20 20 20 20 20 20 71 2e 73  6".          q.s
3be0: 74 79 6c 65 2e 66 6f 6e 74 53 74 79 6c 65 20 3d  tyle.fontStyle =
3bf0: 20 22 69 74 61 6c 69 63 22 0a 20 20 20 20 20 20   "italic".      
3c00: 7d 0a 20 20 20 20 20 20 77 69 6e 64 6f 77 2e 6f  }.      window.o
3c10: 6e 6c 6f 61 64 20 3d 20 69 6e 69 74 73 65 61 72  nload = initsear
3c20: 63 68 0a 20 20 20 20 3c 2f 73 63 72 69 70 74 3e  ch.    </script>
3c30: 7d 0a 20 20 7d 0a 20 20 69 66 20 7b 24 73 72 63  }.  }.  if {$src
3c40: 66 69 6c 65 21 3d 22 22 7d 20 7b 0a 20 20 20 20  file!=""} {.    
3c50: 69 66 20 7b 5b 66 69 6c 65 20 65 78 69 73 74 73  if {[file exists
3c60: 20 44 52 41 46 54 5d 7d 20 7b 0a 20 20 20 20 20   DRAFT]} {.     
3c70: 20 73 65 74 20 68 64 28 66 6f 6f 74 65 72 29 20   set hd(footer) 
3c80: 7b 0a 20 20 20 20 20 20 20 20 3c 70 20 61 6c 69  {.        <p ali
3c90: 67 6e 3d 22 63 65 6e 74 65 72 22 3e 3c 66 6f 6e  gn="center"><fon
3ca0: 74 20 73 69 7a 65 3d 22 36 22 20 63 6f 6c 6f 72  t size="6" color
3cb0: 3d 22 72 65 64 22 3e 2a 2a 2a 20 44 52 41 46 54  ="red">*** DRAFT
3cc0: 20 2a 2a 2a 3c 2f 66 6f 6e 74 3e 3c 2f 70 3e 0a   ***</font></p>.
3cd0: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 20 65 6c        }.    } el
3ce0: 73 65 20 7b 0a 20 20 20 20 20 20 73 65 74 20 68  se {.      set h
3cf0: 64 28 66 6f 6f 74 65 72 29 20 7b 7d 0a 20 20 20  d(footer) {}.   
3d00: 20 7d 0a 20 20 7d 20 65 6c 73 65 20 7b 0a 20 20   }.  } else {.  
3d10: 20 20 73 65 74 20 68 64 28 65 6e 61 62 6c 65 2d    set hd(enable-
3d20: 6d 61 69 6e 29 20 24 73 61 76 65 64 5f 65 6e 61  main) $saved_ena
3d30: 62 6c 65 0a 20 20 7d 0a 7d 0a 0a 23 20 49 6e 73  ble.  }.}..# Ins
3d40: 65 72 74 20 61 20 62 75 62 62 6c 65 20 73 79 6e  ert a bubble syn
3d50: 74 61 78 20 64 69 61 67 72 61 6d 20 69 6e 74 6f  tax diagram into
3d60: 20 74 68 65 20 6f 75 74 70 75 74 2e 0a 23 0a 70   the output..#.p
3d70: 72 6f 63 20 42 75 62 62 6c 65 44 69 61 67 72 61  roc BubbleDiagra
3d80: 6d 20 7b 6e 61 6d 65 20 7b 61 6e 6f 6e 79 6d 6f  m {name {anonymo
3d90: 75 73 5f 66 6c 61 67 20 30 7d 7d 20 7b 0a 20 20  us_flag 0}} {.  
3da0: 67 6c 6f 62 61 6c 20 68 64 0a 0a 20 20 23 69 66  global hd..  #if
3db0: 20 7b 21 24 61 6e 6f 6e 79 6d 6f 75 73 5f 66 6c   {!$anonymous_fl
3dc0: 61 67 7d 20 7b 0a 20 20 23 20 20 68 64 5f 72 65  ag} {.  #  hd_re
3dd0: 73 6f 6c 76 65 20 22 3c 68 34 3e 5c 5b 24 6e 61  solve "<h4>\[$na
3de0: 6d 65 3a 5c 5d 3c 2f 68 34 3e 22 0a 20 20 23 7d  me:\]</h4>".  #}
3df0: 0a 20 20 68 64 5f 72 65 73 6f 6c 76 65 20 22 3c  .  hd_resolve "<
3e00: 68 34 3e 5c 5b 24 6e 61 6d 65 3a 5c 5d 3c 2f 68  h4>\[$name:\]</h
3e10: 34 3e 22 0a 20 20 73 65 74 20 61 6c 74 20 22 61  4>".  set alt "a
3e20: 6c 74 3d 5c 22 73 79 6e 74 61 78 20 64 69 61 67  lt=\"syntax diag
3e30: 72 61 6d 20 24 6e 61 6d 65 5c 22 22 0a 20 20 69  ram $name\"".  i
3e40: 66 20 7b 24 68 64 28 65 6e 61 62 6c 65 2d 6d 61  f {$hd(enable-ma
3e50: 69 6e 29 7d 20 7b 0a 20 20 20 20 70 75 74 73 20  in)} {.    puts 
3e60: 24 68 64 28 6d 61 69 6e 29 20 22 3c 62 6c 6f 63  $hd(main) "<bloc
3e70: 6b 71 75 6f 74 65 3e 5c 0a 20 20 20 20 20 20 20  kquote>\.       
3e80: 20 3c 69 6d 67 20 24 61 6c 74 20 73 72 63 3d 5c   <img $alt src=\
3e90: 22 24 68 64 28 72 6f 6f 74 70 61 74 68 2d 6d 61  "$hd(rootpath-ma
3ea0: 69 6e 29 69 6d 61 67 65 73 2f 73 79 6e 74 61 78  in)images/syntax
3eb0: 2f 24 6e 61 6d 65 2e 67 69 66 5c 22 3e 3c 2f 69  /$name.gif\"></i
3ec0: 6d 67 3e 5c 0a 20 20 20 20 20 20 20 20 3c 2f 62  mg>\.        </b
3ed0: 6c 6f 63 6b 71 75 6f 74 65 3e 22 0a 20 20 7d 0a  lockquote>".  }.
3ee0: 20 20 69 66 20 7b 24 68 64 28 65 6e 61 62 6c 65    if {$hd(enable
3ef0: 2d 61 75 78 29 7d 20 7b 0a 20 20 20 20 70 75 74  -aux)} {.    put
3f00: 73 20 24 68 64 28 61 75 78 29 20 22 3c 62 6c 6f  s $hd(aux) "<blo
3f10: 63 6b 71 75 6f 74 65 3e 5c 0a 20 20 20 20 20 20  ckquote>\.      
3f20: 20 20 3c 69 6d 67 20 24 61 6c 74 20 73 72 63 3d    <img $alt src=
3f30: 5c 22 24 68 64 28 72 6f 6f 74 70 61 74 68 2d 61  \"$hd(rootpath-a
3f40: 75 78 29 69 6d 61 67 65 73 2f 73 79 6e 74 61 78  ux)images/syntax
3f50: 2f 24 6e 61 6d 65 2e 67 69 66 5c 22 3e 3c 2f 69  /$name.gif\"></i
3f60: 6d 67 3e 5c 0a 20 20 20 20 20 20 20 20 3c 2f 62  mg>\.        </b
3f70: 6c 6f 63 6b 71 75 6f 74 65 3e 22 0a 20 20 7d 0a  lockquote>".  }.
3f80: 7d 0a 0a 23 20 52 65 63 6f 72 64 20 61 20 72 65  }..# Record a re
3f90: 71 75 69 72 65 6d 65 6e 74 2e 20 20 54 68 69 73  quirement.  This
3fa0: 20 70 72 6f 63 65 64 75 72 65 20 69 73 20 61 63   procedure is ac
3fb0: 74 69 76 65 20 6f 6e 6c 79 20 66 6f 72 20 74 68  tive only for th
3fc0: 65 20 66 69 72 73 74 0a 23 20 70 61 73 73 2e 20  e first.# pass. 
3fd0: 20 54 68 69 73 20 70 72 6f 63 65 64 75 72 65 20   This procedure 
3fe0: 62 65 63 6f 6d 65 73 20 61 20 6e 6f 2d 6f 70 20  becomes a no-op 
3ff0: 66 6f 72 20 74 68 65 20 73 65 63 6f 6e 64 20 70  for the second p
4000: 61 73 73 2e 20 20 44 75 72 69 6e 67 0a 23 20 74  ass.  During.# t
4010: 68 65 20 73 65 63 6f 6e 64 20 70 61 73 73 2c 20  he second pass, 
4020: 72 65 71 75 69 72 65 6d 65 6e 74 73 20 6c 69 73  requirements lis
4030: 74 69 6e 67 20 72 65 70 6f 72 74 20 67 65 6e 65  ting report gene
4040: 72 61 74 6f 72 73 20 63 61 6e 20 75 73 65 20 74  rators can use t
4050: 68 65 0a 23 20 64 61 74 61 20 61 63 63 75 6d 75  he.# data accumu
4060: 6c 61 74 65 64 20 64 75 72 69 6e 67 20 74 68 65  lated during the
4070: 20 66 69 72 73 74 20 70 61 73 73 20 74 6f 20 63   first pass to c
4080: 6f 6e 73 74 72 75 63 74 20 74 68 65 69 72 20 72  onstruct their r
4090: 65 70 6f 72 74 73 2e 0a 23 0a 23 20 49 66 20 74  eports..#.# If t
40a0: 68 65 20 22 76 65 72 62 61 74 69 6d 22 20 61 72  he "verbatim" ar
40b0: 67 75 6d 65 6e 74 20 69 73 20 74 72 75 65 2c 20  gument is true, 
40c0: 74 68 65 6e 20 74 68 65 20 72 65 71 75 69 72 65  then the require
40d0: 6d 65 6e 74 20 74 65 78 74 20 69 73 0a 23 20 72  ment text is.# r
40e0: 65 6e 64 65 72 65 64 20 61 73 20 69 73 2e 20 20  endered as is.  
40f0: 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20  In other words, 
4100: 74 68 65 20 72 65 71 75 69 72 65 6d 65 6e 74 20  the requirement 
4110: 74 65 78 74 20 69 73 20 61 73 73 75 6d 65 64 20  text is assumed 
4120: 74 6f 0a 23 20 62 65 20 76 61 6c 69 64 20 48 54  to.# be valid HT
4130: 4d 4c 20 77 69 74 68 20 61 6c 6c 20 68 79 70 65  ML with all hype
4140: 72 6c 69 6e 6b 73 20 61 6c 72 65 61 64 79 20 72  rlinks already r
4150: 65 73 6f 6c 76 65 64 2e 20 20 49 66 20 74 68 65  esolved.  If the
4160: 20 22 76 65 72 62 61 74 69 6d 22 0a 23 20 61 72   "verbatim".# ar
4170: 67 75 6d 65 6e 74 20 69 73 20 66 61 6c 73 65 20  gument is false 
4180: 28 74 68 65 20 64 65 66 61 75 6c 74 29 20 74 68  (the default) th
4190: 65 6e 20 74 68 65 20 72 65 71 75 69 72 65 6d 65  en the requireme
41a0: 6e 74 20 74 65 78 74 20 69 73 20 72 65 6e 64 65  nt text is rende
41b0: 72 65 64 0a 23 20 75 73 69 6e 67 20 68 64 5f 72  red.# using hd_r
41c0: 65 6e 64 65 72 20 77 68 69 63 68 20 77 69 6c 6c  ender which will
41d0: 20 66 69 6e 64 20 61 6e 20 65 78 70 61 6e 64 20   find an expand 
41e0: 68 79 70 65 72 6c 69 6e 6b 73 20 77 69 74 68 69  hyperlinks withi
41f0: 6e 20 74 68 65 20 74 65 78 74 2e 0a 23 0a 23 20  n the text..#.# 
4200: 54 68 65 20 22 63 6f 6d 6d 65 6e 74 22 20 61 72  The "comment" ar
4210: 67 75 6d 65 6e 74 20 69 73 20 6e 6f 6e 2d 62 69  gument is non-bi
4220: 6e 64 69 6e 67 20 63 6f 6d 6d 65 6e 74 61 72 79  nding commentary
4230: 20 61 6e 64 20 65 78 70 6c 61 6e 61 74 69 6f 6e   and explanation
4240: 20 74 68 61 74 0a 23 20 61 63 63 6f 6d 70 61 6e   that.# accompan
4250: 69 65 73 20 74 68 65 20 72 65 71 75 69 72 65 6d  ies the requirem
4260: 65 6e 74 2e 0a 23 0a 70 72 6f 63 20 68 64 5f 72  ent..#.proc hd_r
4270: 65 71 75 69 72 65 6d 65 6e 74 20 7b 69 64 20 74  equirement {id t
4280: 65 78 74 20 64 65 72 69 76 65 64 66 72 6f 6d 20  ext derivedfrom 
4290: 63 6f 6d 6d 65 6e 74 7d 20 7b 0a 20 20 67 6c 6f  comment} {.  glo
42a0: 62 61 6c 20 41 4c 4c 52 45 51 20 41 4c 4c 52 45  bal ALLREQ ALLRE
42b0: 51 5f 44 45 52 49 56 45 44 46 52 4f 4d 20 41 4c  Q_DERIVEDFROM AL
42c0: 4c 52 45 51 5f 43 4f 4d 0a 20 20 69 66 20 7b 5b  LREQ_COM.  if {[
42d0: 69 6e 66 6f 20 65 78 69 73 74 73 20 41 4c 4c 52  info exists ALLR
42e0: 45 51 28 24 69 64 29 5d 7d 20 7b 0a 20 20 20 20  EQ($id)]} {.    
42f0: 70 75 74 73 20 73 74 64 65 72 72 20 22 64 75 70  puts stderr "dup
4300: 6c 69 63 61 74 65 20 72 65 71 75 69 72 65 6d 65  licate requireme
4310: 6e 74 20 6c 61 62 65 6c 3a 20 24 69 64 22 0a 20  nt label: $id". 
4320: 20 7d 0a 20 20 73 65 74 20 41 4c 4c 52 45 51 5f   }.  set ALLREQ_
4330: 44 45 52 49 56 45 44 46 52 4f 4d 28 24 69 64 29  DERIVEDFROM($id)
4340: 20 24 64 65 72 69 76 65 64 66 72 6f 6d 0a 20 20   $derivedfrom.  
4350: 73 65 74 20 41 4c 4c 52 45 51 28 24 69 64 29 20  set ALLREQ($id) 
4360: 24 74 65 78 74 0a 20 20 73 65 74 20 41 4c 4c 52  $text.  set ALLR
4370: 45 51 5f 43 4f 4d 28 24 69 64 29 20 24 63 6f 6d  EQ_COM($id) $com
4380: 6d 65 6e 74 0a 7d 0a 0a 23 20 52 65 61 64 20 61  ment.}..# Read a
4390: 20 62 6c 6f 63 6b 20 6f 66 20 72 65 71 75 69 72   block of requir
43a0: 65 6d 65 6e 74 73 20 66 72 6f 6d 20 61 6e 20 41  ements from an A
43b0: 53 43 49 49 20 74 65 78 74 20 66 69 6c 65 2e 20  SCII text file. 
43c0: 20 53 74 6f 72 65 20 74 68 65 0a 23 20 69 6e 66   Store the.# inf
43d0: 6f 72 6d 61 74 69 6f 6e 20 6f 62 74 61 69 6e 65  ormation obtaine
43e0: 64 20 69 6e 20 61 20 67 6c 6f 62 61 6c 20 76 61  d in a global va
43f0: 72 69 61 62 6c 65 20 6e 61 6d 65 64 20 62 79 20  riable named by 
4400: 74 68 65 20 73 65 63 6f 6e 64 20 70 61 72 61 6d  the second param
4410: 65 74 65 72 2e 0a 23 0a 70 72 6f 63 20 68 64 5f  eter..#.proc hd_
4420: 72 65 61 64 5f 72 65 71 75 69 72 65 6d 65 6e 74  read_requirement
4430: 5f 66 69 6c 65 20 7b 66 69 6c 65 6e 61 6d 65 20  _file {filename 
4440: 76 61 72 6e 61 6d 65 7d 20 7b 0a 20 20 67 6c 6f  varname} {.  glo
4450: 62 61 6c 20 68 64 5f 72 65 71 5f 72 64 72 0a 20  bal hd_req_rdr. 
4460: 20 68 64 5f 72 65 73 65 74 5f 72 65 71 75 69 72   hd_reset_requir
4470: 65 6d 65 6e 74 5f 72 65 61 64 65 72 0a 20 20 73  ement_reader.  s
4480: 65 74 20 69 6e 20 5b 6f 70 65 6e 20 24 66 69 6c  et in [open $fil
4490: 65 6e 61 6d 65 5d 0a 20 20 77 68 69 6c 65 20 7b  ename].  while {
44a0: 21 5b 65 6f 66 20 24 69 6e 5d 7d 20 7b 0a 20 20  ![eof $in]} {.  
44b0: 20 20 73 65 74 20 6c 69 6e 65 20 5b 67 65 74 73    set line [gets
44c0: 20 24 69 6e 5d 0a 20 20 20 20 69 66 20 7b 5b 72   $in].    if {[r
44d0: 65 67 65 78 70 20 7b 5e 28 48 4c 52 7c 55 4e 44  egexp {^(HLR|UND
44e0: 45 46 7c 53 59 53 52 45 51 29 20 2b 28 5b 4c 48  EF|SYSREQ) +([LH
44f0: 53 55 5d 5c 64 2b 29 20 2a 28 2e 2a 29 7d 20 24  SU]\d+) *(.*)} $
4500: 6c 69 6e 65 20 61 6c 6c 20 74 79 70 65 20 72 6e  line all type rn
4510: 20 64 66 5d 7d 20 7b 0a 20 20 20 20 20 20 68 64   df]} {.      hd
4520: 5f 61 64 64 5f 6f 6e 65 5f 72 65 71 75 69 72 65  _add_one_require
4530: 6d 65 6e 74 20 24 76 61 72 6e 61 6d 65 0a 20 20  ment $varname.  
4540: 20 20 20 20 73 65 74 20 68 64 5f 72 65 71 5f 72      set hd_req_r
4550: 64 72 28 72 6e 29 20 24 72 6e 0a 20 20 20 20 20  dr(rn) $rn.     
4560: 20 73 65 74 20 68 64 5f 72 65 71 5f 72 64 72 28   set hd_req_rdr(
4570: 64 65 72 69 76 65 64 29 20 24 64 66 0a 20 20 20  derived) $df.   
4580: 20 7d 20 65 6c 73 65 69 66 20 7b 5b 73 74 72 69   } elseif {[stri
4590: 6e 67 20 74 72 69 6d 20 24 6c 69 6e 65 5d 3d 3d  ng trim $line]==
45a0: 22 22 7d 20 7b 0a 20 20 20 20 20 20 69 66 20 7b  ""} {.      if {
45b0: 24 68 64 5f 72 65 71 5f 72 64 72 28 62 6f 64 79  $hd_req_rdr(body
45c0: 29 3d 3d 22 22 7d 20 7b 0a 20 20 20 20 20 20 20  )==""} {.       
45d0: 20 73 65 74 20 68 64 5f 72 65 71 5f 72 64 72 28   set hd_req_rdr(
45e0: 62 6f 64 79 29 20 24 68 64 5f 72 65 71 5f 72 64  body) $hd_req_rd
45f0: 72 28 63 6f 6d 6d 65 6e 74 29 0a 20 20 20 20 20  r(comment).     
4600: 20 20 20 73 65 74 20 68 64 5f 72 65 71 5f 72 64     set hd_req_rd
4610: 72 28 63 6f 6d 6d 65 6e 74 29 20 7b 7d 0a 20 20  r(comment) {}.  
4620: 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20      } else {.   
4630: 20 20 20 20 20 61 70 70 65 6e 64 20 68 64 5f 72       append hd_r
4640: 65 71 5f 72 64 72 28 63 6f 6d 6d 65 6e 74 29 20  eq_rdr(comment) 
4650: 5c 6e 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d  \n.      }.    }
4660: 20 65 6c 73 65 20 7b 0a 20 20 20 20 20 20 61 70   else {.      ap
4670: 70 65 6e 64 20 68 64 5f 72 65 71 5f 72 64 72 28  pend hd_req_rdr(
4680: 63 6f 6d 6d 65 6e 74 29 20 24 6c 69 6e 65 5c 6e  comment) $line\n
4690: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 68 64 5f  .    }.  }.  hd_
46a0: 61 64 64 5f 6f 6e 65 5f 72 65 71 75 69 72 65 6d  add_one_requirem
46b0: 65 6e 74 20 24 76 61 72 6e 61 6d 65 0a 20 20 63  ent $varname.  c
46c0: 6c 6f 73 65 20 24 69 6e 0a 20 20 0a 7d 0a 70 72  lose $in.  .}.pr
46d0: 6f 63 20 68 64 5f 72 65 73 65 74 5f 72 65 71 75  oc hd_reset_requ
46e0: 69 72 65 6d 65 6e 74 5f 72 65 61 64 65 72 20 7b  irement_reader {
46f0: 7d 20 7b 0a 20 20 67 6c 6f 62 61 6c 20 68 64 5f  } {.  global hd_
4700: 72 65 71 5f 72 64 72 0a 20 20 73 65 74 20 68 64  req_rdr.  set hd
4710: 5f 72 65 71 5f 72 64 72 28 72 6e 29 20 7b 7d 0a  _req_rdr(rn) {}.
4720: 20 20 73 65 74 20 68 64 5f 72 65 71 5f 72 64 72    set hd_req_rdr
4730: 28 63 6f 6d 6d 65 6e 74 29 20 7b 7d 0a 20 20 73  (comment) {}.  s
4740: 65 74 20 68 64 5f 72 65 71 5f 72 64 72 28 62 6f  et hd_req_rdr(bo
4750: 64 79 29 20 7b 7d 0a 20 20 73 65 74 20 68 64 5f  dy) {}.  set hd_
4760: 72 65 71 5f 72 64 72 28 64 65 72 69 76 65 64 29  req_rdr(derived)
4770: 20 7b 7d 0a 7d 0a 70 72 6f 63 20 68 64 5f 61 64   {}.}.proc hd_ad
4780: 64 5f 6f 6e 65 5f 72 65 71 75 69 72 65 6d 65 6e  d_one_requiremen
4790: 74 20 7b 76 61 72 6e 61 6d 65 7d 20 7b 0a 20 20  t {varname} {.  
47a0: 67 6c 6f 62 61 6c 20 68 64 5f 72 65 71 5f 72 64  global hd_req_rd
47b0: 72 0a 20 20 73 65 74 20 72 6e 20 24 68 64 5f 72  r.  set rn $hd_r
47c0: 65 71 5f 72 64 72 28 72 6e 29 0a 20 20 69 66 20  eq_rdr(rn).  if 
47d0: 7b 24 72 6e 21 3d 22 22 7d 20 7b 0a 20 20 20 20  {$rn!=""} {.    
47e0: 69 66 20 7b 24 68 64 5f 72 65 71 5f 72 64 72 28  if {$hd_req_rdr(
47f0: 62 6f 64 79 29 3d 3d 22 22 7d 20 7b 0a 20 20 20  body)==""} {.   
4800: 20 20 20 73 65 74 20 68 64 5f 72 65 71 5f 72 64     set hd_req_rd
4810: 72 28 62 6f 64 79 29 20 24 68 64 5f 72 65 71 5f  r(body) $hd_req_
4820: 72 64 72 28 63 6f 6d 6d 65 6e 74 29 0a 20 20 20  rdr(comment).   
4830: 20 20 20 73 65 74 20 68 64 5f 72 65 71 5f 72 64     set hd_req_rd
4840: 72 28 63 6f 6d 6d 65 6e 74 29 20 7b 7d 0a 20 20  r(comment) {}.  
4850: 20 20 7d 0a 20 20 20 20 73 65 74 20 62 20 5b 73    }.    set b [s
4860: 74 72 69 6e 67 20 74 72 69 6d 20 24 68 64 5f 72  tring trim $hd_r
4870: 65 71 5f 72 64 72 28 62 6f 64 79 29 5d 0a 20 20  eq_rdr(body)].  
4880: 20 20 73 65 74 20 63 20 5b 73 74 72 69 6e 67 20    set c [string 
4890: 74 72 69 6d 20 24 68 64 5f 72 65 71 5f 72 64 72  trim $hd_req_rdr
48a0: 28 63 6f 6d 6d 65 6e 74 29 5d 0a 20 20 20 20 73  (comment)].    s
48b0: 65 74 20 3a 3a 24 7b 76 61 72 6e 61 6d 65 7d 28  et ::${varname}(
48c0: 24 72 6e 29 20 5b 6c 69 73 74 20 24 68 64 5f 72  $rn) [list $hd_r
48d0: 65 71 5f 72 64 72 28 64 65 72 69 76 65 64 29 20  eq_rdr(derived) 
48e0: 24 62 20 24 63 5d 0a 20 20 20 20 6c 61 70 70 65  $b $c].    lappe
48f0: 6e 64 20 3a 3a 24 7b 76 61 72 6e 61 6d 65 7d 28  nd ::${varname}(
4900: 2a 29 20 24 72 6e 0a 20 20 7d 0a 20 20 68 64 5f  *) $rn.  }.  hd_
4910: 72 65 73 65 74 5f 72 65 71 75 69 72 65 6d 65 6e  reset_requiremen
4920: 74 5f 72 65 61 64 65 72 0a 7d 0a 0a 23 20 46 69  t_reader.}..# Fi
4930: 72 73 74 20 70 61 73 73 2e 20 20 50 72 6f 63 65  rst pass.  Proce
4940: 73 73 20 61 6c 6c 20 66 69 6c 65 73 2e 20 20 42  ss all files.  B
4950: 75 74 20 64 6f 20 6e 6f 74 20 72 65 6e 64 65 72  ut do not render
4960: 20 68 79 70 65 72 6c 69 6e 6b 73 2e 0a 23 20 4d   hyperlinks..# M
4970: 65 72 65 6c 79 20 63 6f 6c 6c 65 63 74 20 6b 65  erely collect ke
4980: 79 77 6f 72 64 20 69 6e 66 6f 72 6d 61 74 69 6f  yword informatio
4990: 6e 20 73 6f 20 74 68 61 74 20 68 79 70 65 72 6c  n so that hyperl
49a0: 69 6e 6b 73 20 63 61 6e 20 62 65 0a 23 20 63 6f  inks can be.# co
49b0: 72 72 65 63 74 6c 79 20 72 65 6e 64 65 72 65 64  rrectly rendered
49c0: 20 6f 6e 20 74 68 65 20 73 65 63 6f 6e 64 20 70   on the second p
49d0: 61 73 73 2e 0a 23 0a 66 6f 72 65 61 63 68 20 69  ass..#.foreach i
49e0: 6e 66 69 6c 65 20 5b 6c 72 61 6e 67 65 20 24 61  nfile [lrange $a
49f0: 72 67 76 20 33 20 65 6e 64 5d 20 7b 0a 20 20 63  rgv 3 end] {.  c
4a00: 64 20 24 48 4f 4d 45 44 49 52 0a 20 20 70 75 74  d $HOMEDIR.  put
4a10: 73 20 22 50 72 6f 63 65 73 73 69 6e 67 20 24 69  s "Processing $i
4a20: 6e 66 69 6c 65 22 0a 20 20 73 65 74 20 66 64 20  nfile".  set fd 
4a30: 5b 6f 70 65 6e 20 24 69 6e 66 69 6c 65 20 72 5d  [open $infile r]
4a40: 0a 20 20 73 65 74 20 69 6e 20 5b 72 65 61 64 20  .  set in [read 
4a50: 24 66 64 5d 0a 20 20 63 6c 6f 73 65 20 24 66 64  $fd].  close $fd
4a60: 0a 20 20 73 65 74 20 74 69 74 6c 65 20 7b 4e 6f  .  set title {No
4a70: 20 54 69 74 6c 65 7d 0a 20 20 72 65 67 65 78 70   Title}.  regexp
4a80: 20 7b 3c 74 69 74 6c 65 3e 28 5b 5e 5c 6e 5d 2a   {<title>([^\n]*
4a90: 29 3c 2f 74 69 74 6c 65 3e 7d 20 24 69 6e 20 61  )</title>} $in a
4aa0: 6c 6c 20 74 69 74 6c 65 0a 20 20 72 65 67 73 75  ll title.  regsu
4ab0: 62 20 7b 3c 74 69 74 6c 65 3e 5b 5e 5c 6e 5d 2a  b {<title>[^\n]*
4ac0: 3c 2f 74 69 74 6c 65 3e 7d 20 24 69 6e 20 7b 7d  </title>} $in {}
4ad0: 20 69 6e 0a 20 20 73 65 74 20 6f 75 74 66 69 6c   in.  set outfil
4ae0: 65 20 5b 66 69 6c 65 20 72 6f 6f 74 20 5b 66 69  e [file root [fi
4af0: 6c 65 20 74 61 69 6c 20 24 69 6e 66 69 6c 65 5d  le tail $infile]
4b00: 5d 2e 68 74 6d 6c 0a 20 20 68 64 5f 6f 70 65 6e  ].html.  hd_open
4b10: 5f 6d 61 69 6e 20 24 6f 75 74 66 69 6c 65 0a 20  _main $outfile. 
4b20: 20 64 62 20 65 76 61 6c 20 7b 0a 20 20 20 20 49   db eval {.    I
4b30: 4e 53 45 52 54 20 49 4e 54 4f 20 70 61 67 65 28  NSERT INTO page(
4b40: 66 69 6c 65 6e 61 6d 65 2c 70 61 67 65 74 69 74  filename,pagetit
4b50: 6c 65 29 0a 20 20 20 20 56 41 4c 55 45 53 28 24  le).    VALUES($
4b60: 6f 75 74 66 69 6c 65 2c 24 74 69 74 6c 65 29 3b  outfile,$title);
4b70: 0a 20 20 7d 0a 20 20 73 65 74 20 68 28 70 61 67  .  }.  set h(pag
4b80: 65 69 64 29 20 5b 64 62 20 6c 61 73 74 5f 69 6e  eid) [db last_in
4b90: 73 65 72 74 5f 72 6f 77 69 64 5d 0a 20 20 68 64  sert_rowid].  hd
4ba0: 5f 68 65 61 64 65 72 20 24 74 69 74 6c 65 20 24  _header $title $
4bb0: 69 6e 66 69 6c 65 0a 20 20 72 65 67 73 75 62 20  infile.  regsub 
4bc0: 2d 61 6c 6c 20 7b 3c 74 63 6c 3e 7d 20 24 69 6e  -all {<tcl>} $in
4bd0: 20 22 5c 31 37 35 3b 20 65 76 61 6c 20 5c 31 37   "\175; eval \17
4be0: 33 22 20 69 6e 0a 20 20 72 65 67 73 75 62 20 2d  3" in.  regsub -
4bf0: 61 6c 6c 20 7b 3c 2f 74 63 6c 3e 7d 20 24 69 6e  all {</tcl>} $in
4c00: 20 22 5c 31 37 35 3b 20 68 64 5f 70 75 74 73 20   "\175; hd_puts 
4c10: 5c 31 37 33 22 20 69 6e 0a 20 20 65 76 61 6c 20  \173" in.  eval 
4c20: 22 68 64 5f 70 75 74 73 20 5c 31 37 33 24 69 6e  "hd_puts \173$in
4c30: 5c 31 37 35 22 0a 20 20 63 64 20 24 3a 3a 48 4f  \175".  cd $::HO
4c40: 4d 45 44 49 52 0a 20 20 68 64 5f 63 6c 6f 73 65  MEDIR.  hd_close
4c50: 5f 6d 61 69 6e 0a 7d 0a 0a 23 20 53 65 63 6f 6e  _main.}..# Secon
4c60: 64 20 70 61 73 73 2e 20 20 50 72 6f 63 65 73 73  d pass.  Process
4c70: 20 61 6c 6c 20 66 69 6c 65 73 20 61 67 61 69 6e   all files again
4c80: 2e 20 20 54 68 69 73 20 74 69 6d 65 20 72 65 6e  .  This time ren
4c90: 64 65 72 20 68 79 70 65 72 6c 69 6e 6b 73 0a 23  der hyperlinks.#
4ca0: 20 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 74 68   according to th
4cb0: 65 20 6b 65 79 77 6f 72 64 20 69 6e 66 6f 72 6d  e keyword inform
4cc0: 61 74 69 6f 6e 20 63 6f 6c 6c 65 63 74 65 64 20  ation collected 
4cd0: 6f 6e 20 74 68 65 20 66 69 72 73 74 20 70 61 73  on the first pas
4ce0: 73 2e 0a 23 0a 70 72 6f 63 20 68 64 5f 6b 65 79  s..#.proc hd_key
4cf0: 77 6f 72 64 73 20 7b 61 72 67 73 7d 20 7b 7d 0a  words {args} {}.
4d00: 72 65 6e 61 6d 65 20 68 64 5f 72 65 73 6f 6c 76  rename hd_resolv
4d10: 65 20 7b 7d 0a 72 65 6e 61 6d 65 20 68 64 5f 72  e {}.rename hd_r
4d20: 65 73 6f 6c 76 65 5f 32 6e 64 70 61 73 73 20 68  esolve_2ndpass h
4d30: 64 5f 72 65 73 6f 6c 76 65 0a 70 72 6f 63 20 68  d_resolve.proc h
4d40: 64 5f 72 65 71 75 69 72 65 6d 65 6e 74 20 7b 61  d_requirement {a
4d50: 72 67 73 7d 20 7b 7d 0a 66 6f 72 65 61 63 68 20  rgs} {}.foreach 
4d60: 69 6e 66 69 6c 65 20 5b 6c 72 61 6e 67 65 20 24  infile [lrange $
4d70: 61 72 67 76 20 33 20 65 6e 64 5d 20 7b 0a 20 20  argv 3 end] {.  
4d80: 63 64 20 24 48 4f 4d 45 44 49 52 0a 20 20 70 75  cd $HOMEDIR.  pu
4d90: 74 73 20 22 50 72 6f 63 65 73 73 69 6e 67 20 24  ts "Processing $
4da0: 69 6e 66 69 6c 65 22 0a 20 20 73 65 74 20 66 64  infile".  set fd
4db0: 20 5b 6f 70 65 6e 20 24 69 6e 66 69 6c 65 20 72   [open $infile r
4dc0: 5d 0a 20 20 73 65 74 20 69 6e 20 5b 72 65 61 64  ].  set in [read
4dd0: 20 24 66 64 5d 0a 20 20 63 6c 6f 73 65 20 24 66   $fd].  close $f
4de0: 64 0a 20 20 73 65 74 20 74 69 74 6c 65 20 7b 4e  d.  set title {N
4df0: 6f 20 54 69 74 6c 65 7d 0a 20 20 72 65 67 65 78  o Title}.  regex
4e00: 70 20 7b 3c 74 69 74 6c 65 3e 28 5b 5e 5c 6e 5d  p {<title>([^\n]
4e10: 2a 29 3c 2f 74 69 74 6c 65 3e 7d 20 24 69 6e 20  *)</title>} $in 
4e20: 61 6c 6c 20 74 69 74 6c 65 0a 20 20 72 65 67 73  all title.  regs
4e30: 75 62 20 7b 3c 74 69 74 6c 65 3e 5b 5e 5c 6e 5d  ub {<title>[^\n]
4e40: 2a 3c 2f 74 69 74 6c 65 3e 7d 20 24 69 6e 20 7b  *</title>} $in {
4e50: 7d 20 69 6e 0a 20 20 73 65 74 20 6f 75 74 66 69  } in.  set outfi
4e60: 6c 65 20 5b 66 69 6c 65 20 72 6f 6f 74 20 5b 66  le [file root [f
4e70: 69 6c 65 20 74 61 69 6c 20 24 69 6e 66 69 6c 65  ile tail $infile
4e80: 5d 5d 2e 68 74 6d 6c 0a 20 20 68 64 5f 6f 70 65  ]].html.  hd_ope
4e90: 6e 5f 6d 61 69 6e 20 24 6f 75 74 66 69 6c 65 0a  n_main $outfile.
4ea0: 20 20 68 64 5f 68 65 61 64 65 72 20 24 74 69 74    hd_header $tit
4eb0: 6c 65 20 24 69 6e 66 69 6c 65 0a 20 20 72 65 67  le $infile.  reg
4ec0: 73 75 62 20 2d 61 6c 6c 20 7b 3c 74 63 6c 3e 7d  sub -all {<tcl>}
4ed0: 20 24 69 6e 20 22 5c 31 37 35 3b 20 65 76 61 6c   $in "\175; eval
4ee0: 20 5c 31 37 33 22 20 69 6e 0a 20 20 72 65 67 73   \173" in.  regs
4ef0: 75 62 20 2d 61 6c 6c 20 7b 3c 2f 74 63 6c 3e 7d  ub -all {</tcl>}
4f00: 20 24 69 6e 20 22 5c 31 37 35 3b 20 68 64 5f 72   $in "\175; hd_r
4f10: 65 73 6f 6c 76 65 20 5c 31 37 33 22 20 69 6e 0a  esolve \173" in.
4f20: 20 20 65 76 61 6c 20 22 68 64 5f 72 65 73 6f 6c    eval "hd_resol
4f30: 76 65 20 5c 31 37 33 24 69 6e 5c 31 37 35 22 0a  ve \173$in\175".
4f40: 20 20 63 64 20 24 3a 3a 48 4f 4d 45 44 49 52 0a    cd $::HOMEDIR.
4f50: 20 20 68 64 5f 63 6c 6f 73 65 5f 6d 61 69 6e 0a    hd_close_main.
4f60: 7d 0a 0a 23 20 47 65 6e 65 72 61 74 65 20 61 20  }..# Generate a 
4f70: 64 6f 63 75 6d 65 6e 74 20 73 68 6f 77 69 6e 67  document showing
4f80: 20 74 68 65 20 68 79 70 65 72 6c 69 6e 6b 20 6b   the hyperlink k
4f90: 65 79 77 6f 72 64 73 20 61 6e 64 20 74 68 65 69  eywords and thei
4fa0: 72 0a 23 20 74 61 72 67 65 74 73 2e 0a 23 0a 68  r.# targets..#.h
4fb0: 64 5f 6f 70 65 6e 5f 6d 61 69 6e 20 64 6f 63 5f  d_open_main doc_
4fc0: 6b 65 79 77 6f 72 64 5f 63 72 6f 73 73 72 65 66  keyword_crossref
4fd0: 2e 68 74 6d 6c 0a 68 64 5f 68 65 61 64 65 72 20  .html.hd_header 
4fe0: 7b 4b 65 79 77 6f 72 64 20 43 72 6f 73 73 72 65  {Keyword Crossre
4ff0: 66 65 72 65 6e 63 65 7d 20 24 44 4f 43 2f 77 72  ference} $DOC/wr
5000: 61 70 2e 74 63 6c 0a 68 64 5f 70 75 74 73 20 22  ap.tcl.hd_puts "
5010: 3c 75 6c 3e 22 0a 66 6f 72 65 61 63 68 20 78 20  <ul>".foreach x 
5020: 5b 6c 73 6f 72 74 20 2d 64 69 63 74 20 5b 61 72  [lsort -dict [ar
5030: 72 61 79 20 6e 61 6d 65 73 20 67 6c 69 6e 6b 5d  ray names glink]
5040: 5d 20 7b 0a 20 20 73 65 74 20 79 20 24 67 6c 69  ] {.  set y $gli
5050: 6e 6b 28 24 78 29 0a 20 20 68 64 5f 70 75 74 73  nk($x).  hd_puts
5060: 20 22 3c 6c 69 3e 24 78 20 2d 20 3c 61 20 68 72   "<li>$x - <a hr
5070: 65 66 3d 5c 22 24 79 5c 22 3e 24 79 3c 2f 61 3e  ef=\"$y\">$y</a>
5080: 3c 2f 6c 69 3e 22 0a 20 20 6c 61 70 70 65 6e 64  </li>".  lappend
5090: 20 72 65 76 67 6c 69 6e 6b 28 24 79 29 20 24 78   revglink($y) $x
50a0: 0a 7d 0a 68 64 5f 70 75 74 73 20 22 3c 2f 75 6c  .}.hd_puts "</ul
50b0: 3e 22 0a 68 64 5f 63 6c 6f 73 65 5f 6d 61 69 6e  >".hd_close_main
50c0: 0a 0a 68 64 5f 6f 70 65 6e 5f 6d 61 69 6e 20 64  ..hd_open_main d
50d0: 6f 63 5f 74 61 72 67 65 74 5f 63 72 6f 73 73 72  oc_target_crossr
50e0: 65 66 2e 68 74 6d 6c 0a 68 64 5f 68 65 61 64 65  ef.html.hd_heade
50f0: 72 20 7b 54 61 72 67 65 74 20 43 72 6f 73 73 72  r {Target Crossr
5100: 65 66 65 72 65 6e 63 65 7d 20 24 44 4f 43 2f 77  eference} $DOC/w
5110: 72 61 70 2e 74 63 6c 0a 68 64 5f 70 75 74 73 20  rap.tcl.hd_puts 
5120: 22 3c 75 6c 3e 22 0a 66 6f 72 65 61 63 68 20 79  "<ul>".foreach y
5130: 20 5b 6c 73 6f 72 74 20 5b 61 72 72 61 79 20 6e   [lsort [array n
5140: 61 6d 65 73 20 72 65 76 67 6c 69 6e 6b 5d 5d 20  ames revglink]] 
5150: 7b 0a 20 20 68 64 5f 70 75 74 73 20 22 3c 6c 69  {.  hd_puts "<li
5160: 3e 3c 61 20 68 72 65 66 3d 5c 22 24 79 5c 22 3e  ><a href=\"$y\">
5170: 24 79 3c 2f 61 3e 20 2d 20 5b 6c 73 6f 72 74 20  $y</a> - [lsort 
5180: 24 72 65 76 67 6c 69 6e 6b 28 24 79 29 5d 3c 2f  $revglink($y)]</
5190: 6c 69 3e 22 0a 7d 0a 68 64 5f 70 75 74 73 20 22  li>".}.hd_puts "
51a0: 3c 2f 75 6c 3e 22 0a 68 64 5f 63 6c 6f 73 65 5f  </ul>".hd_close_
51b0: 6d 61 69 6e 0a 0a 68 64 5f 6f 70 65 6e 5f 6d 61  main..hd_open_ma
51c0: 69 6e 20 64 6f 63 5f 62 61 63 6b 6c 69 6e 6b 5f  in doc_backlink_
51d0: 63 72 6f 73 73 72 65 66 2e 68 74 6d 6c 0a 68 64  crossref.html.hd
51e0: 5f 68 65 61 64 65 72 20 7b 42 61 63 6b 6c 69 6e  _header {Backlin
51f0: 6b 20 43 72 6f 73 73 72 65 66 65 72 65 6e 63 65  k Crossreference
5200: 7d 20 24 44 4f 43 2f 77 72 61 70 2e 74 63 6c 0a  } $DOC/wrap.tcl.
5210: 68 64 5f 70 75 74 73 20 22 3c 75 6c 3e 22 0a 66  hd_puts "<ul>".f
5220: 6f 72 65 61 63 68 20 6b 77 20 5b 6c 73 6f 72 74  oreach kw [lsort
5230: 20 2d 6e 6f 63 61 73 65 20 5b 61 72 72 61 79 20   -nocase [array 
5240: 6e 61 6d 65 73 20 62 61 63 6b 6c 69 6e 6b 5d 5d  names backlink]]
5250: 20 7b 0a 20 20 68 64 5f 70 75 74 73 20 22 3c 6c   {.  hd_puts "<l
5260: 69 3e 24 6b 77 20 2d 22 0a 20 20 73 65 74 20 70  i>$kw -".  set p
5270: 72 65 76 20 7b 7d 0a 20 20 66 6f 72 65 61 63 68  rev {}.  foreach
5280: 20 72 65 66 20 5b 6c 73 6f 72 74 20 24 62 61 63   ref [lsort $bac
5290: 6b 6c 69 6e 6b 28 24 6b 77 29 5d 20 7b 0a 20 20  klink($kw)] {.  
52a0: 20 20 69 66 20 7b 24 72 65 66 3d 3d 24 70 72 65    if {$ref==$pre
52b0: 76 7d 20 63 6f 6e 74 69 6e 75 65 0a 20 20 20 20  v} continue.    
52c0: 73 65 74 20 70 72 65 76 20 24 72 65 66 0a 20 20  set prev $ref.  
52d0: 20 20 68 64 5f 70 75 74 73 20 22 20 20 3c 61 20    hd_puts "  <a 
52e0: 68 72 65 66 3d 5c 22 24 72 65 66 5c 22 3e 24 72  href=\"$ref\">$r
52f0: 65 66 3c 2f 61 3e 22 0a 20 20 7d 0a 7d 0a 68 64  ef</a>".  }.}.hd
5300: 5f 70 75 74 73 20 22 3c 2f 75 6c 3e 22 0a 68 64  _puts "</ul>".hd
5310: 5f 63 6c 6f 73 65 5f 6d 61 69 6e 0a 0a 68 64 5f  _close_main..hd_
5320: 6f 70 65 6e 5f 6d 61 69 6e 20 64 6f 63 5f 70 61  open_main doc_pa
5330: 67 65 6c 69 6e 6b 5f 63 72 6f 73 73 72 65 66 2e  gelink_crossref.
5340: 68 74 6d 6c 0a 68 64 5f 68 65 61 64 65 72 20 7b  html.hd_header {
5350: 50 61 67 65 6c 69 6e 6b 20 43 72 6f 73 73 72 65  Pagelink Crossre
5360: 66 65 72 65 6e 63 65 7d 20 24 44 4f 43 2f 77 72  ference} $DOC/wr
5370: 61 70 2e 74 63 6c 0a 68 64 5f 70 75 74 73 20 22  ap.tcl.hd_puts "
5380: 3c 70 3e 54 61 72 67 65 74 20 50 61 67 65 20 2d  <p>Target Page -
5390: 20 57 68 69 63 68 20 70 61 67 65 73 20 72 65 66   Which pages ref
53a0: 65 72 65 6e 63 65 20 69 74 2e 3c 2f 70 3e 22 0a  erence it.</p>".
53b0: 68 64 5f 70 75 74 73 20 22 3c 70 3e 50 61 67 65  hd_puts "<p>Page
53c0: 73 20 6d 61 74 63 68 69 6e 67 20 28 6e 65 77 73  s matching (news
53d0: 7c 63 68 61 6e 67 65 73 7c 72 65 6c 65 61 73 65  |changes|release
53e0: 6c 6f 67 7c 5c 5b 30 2d 39 5d 74 6f 5c 5b 30 2d  log|\[0-9]to\[0-
53f0: 39 5d 7c 26 23 39 34 3b 64 6f 63 5f 2e 2a 5f 63  9]|&#94;doc_.*_c
5400: 72 6f 73 73 72 65 66 29 20 61 72 65 20 73 6b 69  rossref) are ski
5410: 70 70 65 64 2e 3c 2f 70 3e 22 0a 68 64 5f 70 75  pped.</p>".hd_pu
5420: 74 73 20 22 3c 75 6c 3e 22 0a 66 6f 72 65 61 63  ts "<ul>".foreac
5430: 68 20 79 20 5b 6c 73 6f 72 74 20 5b 61 72 72 61  h y [lsort [arra
5440: 79 20 6e 61 6d 65 73 20 72 65 76 67 6c 69 6e 6b  y names revglink
5450: 5d 5d 20 7b 0a 20 20 72 65 67 73 75 62 20 7b 23  ]] {.  regsub {#
5460: 2e 2a 7d 20 24 79 20 7b 7d 20 79 32 0a 20 20 66  .*} $y {} y2.  f
5470: 6f 72 65 61 63 68 20 6b 77 20 5b 6c 73 6f 72 74  oreach kw [lsort
5480: 20 24 72 65 76 67 6c 69 6e 6b 28 24 79 29 5d 20   $revglink($y)] 
5490: 7b 0a 20 20 20 20 69 66 20 7b 5b 69 6e 66 6f 20  {.    if {[info 
54a0: 65 78 69 73 74 73 20 62 61 63 6b 6c 69 6e 6b 28  exists backlink(
54b0: 24 6b 77 29 5d 7d 20 7b 0a 20 20 20 20 20 20 66  $kw)]} {.      f
54c0: 6f 72 65 61 63 68 20 72 65 66 20 5b 6c 73 6f 72  oreach ref [lsor
54d0: 74 20 24 62 61 63 6b 6c 69 6e 6b 28 24 6b 77 29  t $backlink($kw)
54e0: 5d 20 7b 0a 20 20 20 20 20 20 20 20 72 65 67 73  ] {.        regs
54f0: 75 62 20 7b 23 2e 2a 7d 20 24 72 65 66 20 7b 7d  ub {#.*} $ref {}
5500: 20 72 65 66 32 0a 20 20 20 20 20 20 20 20 6c 61   ref2.        la
5510: 70 70 65 6e 64 20 70 61 67 65 6c 69 6e 6b 28 24  ppend pagelink($
5520: 79 32 29 20 24 72 65 66 32 0a 20 20 20 20 20 20  y2) $ref2.      
5530: 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 66 6f  }.    }.  }.}.fo
5540: 72 65 61 63 68 20 79 20 5b 6c 73 6f 72 74 20 5b  reach y [lsort [
5550: 61 72 72 61 79 20 6e 61 6d 65 73 20 70 61 67 65  array names page
5560: 6c 69 6e 6b 5d 5d 20 7b 0a 20 20 69 66 20 7b 5b  link]] {.  if {[
5570: 72 65 67 65 78 70 20 7b 28 6e 65 77 73 7c 63 68  regexp {(news|ch
5580: 61 6e 67 65 73 7c 72 65 6c 65 61 73 65 6c 6f 67  anges|releaselog
5590: 7c 5b 30 2d 39 5d 74 6f 5b 30 2d 39 5d 7c 5e 64  |[0-9]to[0-9]|^d
55a0: 6f 63 5f 2e 2a 5f 63 72 6f 73 73 72 65 66 29 7d  oc_.*_crossref)}
55b0: 20 24 79 5d 7d 20 63 6f 6e 74 69 6e 75 65 0a 20   $y]} continue. 
55c0: 20 68 64 5f 70 75 74 73 20 22 3c 6c 69 3e 3c 61   hd_puts "<li><a
55d0: 20 68 72 65 66 3d 5c 22 24 79 5c 22 3e 24 79 3c   href=\"$y\">$y<
55e0: 2f 61 3e 20 2d 20 22 0a 20 20 73 65 74 20 70 72  /a> - ".  set pr
55f0: 65 76 20 7b 7d 0a 20 20 66 6f 72 65 61 63 68 20  ev {}.  foreach 
5600: 72 65 66 20 5b 6c 73 6f 72 74 20 24 70 61 67 65  ref [lsort $page
5610: 6c 69 6e 6b 28 24 79 29 5d 20 7b 0a 20 20 20 20  link($y)] {.    
5620: 69 66 20 7b 24 72 65 66 3d 3d 24 70 72 65 76 7d  if {$ref==$prev}
5630: 20 63 6f 6e 74 69 6e 75 65 0a 20 20 20 20 69 66   continue.    if
5640: 20 7b 24 72 65 66 3d 3d 24 79 7d 20 63 6f 6e 74   {$ref==$y} cont
5650: 69 6e 75 65 0a 20 20 20 20 69 66 20 7b 5b 72 65  inue.    if {[re
5660: 67 65 78 70 20 7b 28 6e 65 77 73 7c 63 68 61 6e  gexp {(news|chan
5670: 67 65 73 7c 72 65 6c 65 61 73 65 6c 6f 67 7c 5b  ges|releaselog|[
5680: 30 2d 39 5d 74 6f 5b 30 2d 39 5d 7c 5e 64 6f 63  0-9]to[0-9]|^doc
5690: 5f 2e 2a 5f 63 72 6f 73 73 72 65 66 29 7d 20 24  _.*_crossref)} $
56a0: 72 65 66 5d 7d 20 63 6f 6e 74 69 6e 75 65 0a 20  ref]} continue. 
56b0: 20 20 20 68 64 5f 70 75 74 73 20 22 3c 61 20 68     hd_puts "<a h
56c0: 72 65 66 3d 5c 22 24 72 65 66 5c 22 3e 24 72 65  ref=\"$ref\">$re
56d0: 66 3c 2f 61 3e 20 22 0a 20 20 20 20 73 65 74 20  f</a> ".    set 
56e0: 70 72 65 76 20 24 72 65 66 0a 20 20 7d 0a 20 20  prev $ref.  }.  
56f0: 68 64 5f 70 75 74 73 20 22 3c 2f 6c 69 3e 22 0a  hd_puts "</li>".
5700: 7d 0a 68 64 5f 70 75 74 73 20 22 3c 2f 75 6c 3e  }.hd_puts "</ul>
5710: 22 0a 68 64 5f 63 6c 6f 73 65 5f 6d 61 69 6e 0a  ".hd_close_main.
5720: 64 62 20 65 76 61 6c 20 43 4f 4d 4d 49 54 0a     db eval COMMIT.