Documentation Source Text

Hex Artifact Content
Login

Artifact 1d72a9cd43b1468a824641e94ca14c44414f1f0f:


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 6e 61 6d        <input nam
3840: 65 3d 73 20 74 79 70 65 3d 73 75 62 6d 69 74 20  e=s type=submit 
3850: 76 61 6c 75 65 3d 22 47 6f 22 20 73 74 79 6c 65  value="Go" style
3860: 3d 22 62 6f 72 64 65 72 3a 73 6f 6c 69 64 20 77  ="border:solid w
3870: 68 69 74 65 20 31 70 78 3b 62 61 63 6b 67 72 6f  hite 1px;backgro
3880: 75 6e 64 2d 63 6f 6c 6f 72 3a 23 38 30 61 37 39  und-color:#80a79
3890: 36 3b 63 6f 6c 6f 72 3a 77 68 69 74 65 3b 66 6f  6;color:white;fo
38a0: 6e 74 2d 73 69 7a 65 3a 30 2e 39 65 6d 3b 70 61  nt-size:0.9em;pa
38b0: 64 64 69 6e 67 3a 30 20 31 65 78 22 3e 0a 20 20  dding:0 1ex">.  
38c0: 20 20 20 20 20 20 3c 2f 66 6f 72 6d 3e 0a 20 20        </form>.  
38d0: 20 20 20 20 20 20 3c 2f 64 69 76 3e 0a 20 20 20        </div>.   
38e0: 20 20 20 3c 2f 74 61 62 6c 65 3e 7d 0a 20 20 7d     </table>}.  }
38f0: 0a 20 20 70 75 74 73 69 6e 34 20 24 66 64 20 7b  .  putsin4 $fd {
3900: 3c 2f 64 69 76 3e 3c 2f 64 69 76 3e 3c 2f 64 69  </div></div></di
3910: 76 3e 3c 2f 64 69 76 3e 0a 20 20 20 20 3c 2f 74  v></div>.    </t
3920: 64 3e 3c 2f 74 72 3e 3c 2f 74 61 62 6c 65 3e 0a  d></tr></table>.
3930: 20 20 7d 0a 20 20 69 66 20 7b 5b 66 69 6c 65 20    }.  if {[file 
3940: 65 78 69 73 74 73 20 53 45 41 52 43 48 5d 7d 20  exists SEARCH]} 
3950: 7b 0a 20 20 20 20 70 75 74 73 69 6e 34 20 24 66  {.    putsin4 $f
3960: 64 20 7b 3c 73 63 72 69 70 74 3e 0a 20 20 20 20  d {<script>.    
3970: 20 20 67 4d 73 67 20 3d 20 22 53 65 61 72 63 68    gMsg = "Search
3980: 20 53 51 4c 69 74 65 20 44 6f 63 73 2e 2e 2e 22   SQLite Docs..."
3990: 0a 20 20 20 20 20 20 66 75 6e 63 74 69 6f 6e 20  .      function 
39a0: 65 6e 74 65 72 73 65 61 72 63 68 28 29 20 7b 0a  entersearch() {.
39b0: 20 20 20 20 20 20 20 20 76 61 72 20 71 20 3d 20          var q = 
39c0: 64 6f 63 75 6d 65 6e 74 2e 67 65 74 45 6c 65 6d  document.getElem
39d0: 65 6e 74 42 79 49 64 28 22 71 22 29 3b 0a 20 20  entById("q");.  
39e0: 20 20 20 20 20 20 69 66 28 20 71 2e 76 61 6c 75        if( q.valu
39f0: 65 20 3d 3d 20 67 4d 73 67 20 29 20 7b 20 71 2e  e == gMsg ) { q.
3a00: 76 61 6c 75 65 20 3d 20 22 22 20 7d 0a 20 20 20  value = "" }.   
3a10: 20 20 20 20 20 71 2e 73 74 79 6c 65 2e 63 6f 6c       q.style.col
3a20: 6f 72 20 3d 20 22 62 6c 61 63 6b 22 0a 20 20 20  or = "black".   
3a30: 20 20 20 20 20 71 2e 73 74 79 6c 65 2e 66 6f 6e       q.style.fon
3a40: 74 53 74 79 6c 65 20 3d 20 22 6e 6f 72 6d 61 6c  tStyle = "normal
3a50: 22 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ".      }.      
3a60: 66 75 6e 63 74 69 6f 6e 20 6c 65 61 76 65 73 65  function leavese
3a70: 61 72 63 68 28 29 20 7b 0a 20 20 20 20 20 20 20  arch() {.       
3a80: 20 76 61 72 20 71 20 3d 20 64 6f 63 75 6d 65 6e   var q = documen
3a90: 74 2e 67 65 74 45 6c 65 6d 65 6e 74 42 79 49 64  t.getElementById
3aa0: 28 22 71 22 29 3b 0a 20 20 20 20 20 20 20 20 69  ("q");.        i
3ab0: 66 28 20 71 2e 76 61 6c 75 65 20 3d 3d 20 22 22  f( q.value == ""
3ac0: 20 29 20 7b 20 0a 20 20 20 20 20 20 20 20 20 20   ) { .          
3ad0: 71 2e 76 61 6c 75 65 20 3d 20 67 4d 73 67 0a 20  q.value = gMsg. 
3ae0: 20 20 20 20 20 20 20 20 20 71 2e 73 74 79 6c 65           q.style
3af0: 2e 63 6f 6c 6f 72 20 3d 20 22 23 38 30 61 37 39  .color = "#80a79
3b00: 36 22 0a 20 20 20 20 20 20 20 20 20 20 71 2e 73  6".          q.s
3b10: 74 79 6c 65 2e 66 6f 6e 74 53 74 79 6c 65 20 3d  tyle.fontStyle =
3b20: 20 22 69 74 61 6c 69 63 22 0a 20 20 20 20 20 20   "italic".      
3b30: 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20    }.      }.    
3b40: 20 20 66 75 6e 63 74 69 6f 6e 20 69 6e 69 74 73    function inits
3b50: 65 61 72 63 68 28 29 20 7b 0a 20 20 20 20 20 20  earch() {.      
3b60: 20 20 76 61 72 20 71 20 3d 20 64 6f 63 75 6d 65    var q = docume
3b70: 6e 74 2e 67 65 74 45 6c 65 6d 65 6e 74 42 79 49  nt.getElementByI
3b80: 64 28 22 71 22 29 3b 0a 20 20 20 20 20 20 20 20  d("q");.        
3b90: 71 2e 76 61 6c 75 65 20 3d 20 22 22 0a 20 20 20  q.value = "".   
3ba0: 20 20 20 20 20 20 20 71 2e 76 61 6c 75 65 20 3d         q.value =
3bb0: 20 67 4d 73 67 0a 20 20 20 20 20 20 20 20 20 20   gMsg.          
3bc0: 71 2e 73 74 79 6c 65 2e 63 6f 6c 6f 72 20 3d 20  q.style.color = 
3bd0: 22 23 38 30 61 37 39 36 22 0a 20 20 20 20 20 20  "#80a796".      
3be0: 20 20 20 20 71 2e 73 74 79 6c 65 2e 66 6f 6e 74      q.style.font
3bf0: 53 74 79 6c 65 20 3d 20 22 69 74 61 6c 69 63 22  Style = "italic"
3c00: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 77  .      }.      w
3c10: 69 6e 64 6f 77 2e 6f 6e 6c 6f 61 64 20 3d 20 69  indow.onload = i
3c20: 6e 69 74 73 65 61 72 63 68 0a 20 20 20 20 3c 2f  nitsearch.    </
3c30: 73 63 72 69 70 74 3e 7d 0a 20 20 7d 0a 20 20 69  script>}.  }.  i
3c40: 66 20 7b 24 73 72 63 66 69 6c 65 21 3d 22 22 7d  f {$srcfile!=""}
3c50: 20 7b 0a 20 20 20 20 69 66 20 7b 5b 66 69 6c 65   {.    if {[file
3c60: 20 65 78 69 73 74 73 20 44 52 41 46 54 5d 7d 20   exists DRAFT]} 
3c70: 7b 0a 20 20 20 20 20 20 73 65 74 20 68 64 28 66  {.      set hd(f
3c80: 6f 6f 74 65 72 29 20 7b 0a 20 20 20 20 20 20 20  ooter) {.       
3c90: 20 3c 70 20 61 6c 69 67 6e 3d 22 63 65 6e 74 65   <p align="cente
3ca0: 72 22 3e 3c 66 6f 6e 74 20 73 69 7a 65 3d 22 36  r"><font size="6
3cb0: 22 20 63 6f 6c 6f 72 3d 22 72 65 64 22 3e 2a 2a  " color="red">**
3cc0: 2a 20 44 52 41 46 54 20 2a 2a 2a 3c 2f 66 6f 6e  * DRAFT ***</fon
3cd0: 74 3e 3c 2f 70 3e 0a 20 20 20 20 20 20 7d 0a 20  t></p>.      }. 
3ce0: 20 20 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20 20     } else {.    
3cf0: 20 20 73 65 74 20 68 64 28 66 6f 6f 74 65 72 29    set hd(footer)
3d00: 20 7b 7d 0a 20 20 20 20 7d 0a 20 20 7d 20 65 6c   {}.    }.  } el
3d10: 73 65 20 7b 0a 20 20 20 20 73 65 74 20 68 64 28  se {.    set hd(
3d20: 65 6e 61 62 6c 65 2d 6d 61 69 6e 29 20 24 73 61  enable-main) $sa
3d30: 76 65 64 5f 65 6e 61 62 6c 65 0a 20 20 7d 0a 7d  ved_enable.  }.}
3d40: 0a 0a 23 20 49 6e 73 65 72 74 20 61 20 62 75 62  ..# Insert a bub
3d50: 62 6c 65 20 73 79 6e 74 61 78 20 64 69 61 67 72  ble syntax diagr
3d60: 61 6d 20 69 6e 74 6f 20 74 68 65 20 6f 75 74 70  am into the outp
3d70: 75 74 2e 0a 23 0a 70 72 6f 63 20 42 75 62 62 6c  ut..#.proc Bubbl
3d80: 65 44 69 61 67 72 61 6d 20 7b 6e 61 6d 65 20 7b  eDiagram {name {
3d90: 61 6e 6f 6e 79 6d 6f 75 73 5f 66 6c 61 67 20 30  anonymous_flag 0
3da0: 7d 7d 20 7b 0a 20 20 67 6c 6f 62 61 6c 20 68 64  }} {.  global hd
3db0: 0a 0a 20 20 23 69 66 20 7b 21 24 61 6e 6f 6e 79  ..  #if {!$anony
3dc0: 6d 6f 75 73 5f 66 6c 61 67 7d 20 7b 0a 20 20 23  mous_flag} {.  #
3dd0: 20 20 68 64 5f 72 65 73 6f 6c 76 65 20 22 3c 68    hd_resolve "<h
3de0: 34 3e 5c 5b 24 6e 61 6d 65 3a 5c 5d 3c 2f 68 34  4>\[$name:\]</h4
3df0: 3e 22 0a 20 20 23 7d 0a 20 20 68 64 5f 72 65 73  >".  #}.  hd_res
3e00: 6f 6c 76 65 20 22 3c 68 34 3e 5c 5b 24 6e 61 6d  olve "<h4>\[$nam
3e10: 65 3a 5c 5d 3c 2f 68 34 3e 22 0a 20 20 73 65 74  e:\]</h4>".  set
3e20: 20 61 6c 74 20 22 61 6c 74 3d 5c 22 73 79 6e 74   alt "alt=\"synt
3e30: 61 78 20 64 69 61 67 72 61 6d 20 24 6e 61 6d 65  ax diagram $name
3e40: 5c 22 22 0a 20 20 69 66 20 7b 24 68 64 28 65 6e  \"".  if {$hd(en
3e50: 61 62 6c 65 2d 6d 61 69 6e 29 7d 20 7b 0a 20 20  able-main)} {.  
3e60: 20 20 70 75 74 73 20 24 68 64 28 6d 61 69 6e 29    puts $hd(main)
3e70: 20 22 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 5c 0a   "<blockquote>\.
3e80: 20 20 20 20 20 20 20 20 3c 69 6d 67 20 24 61 6c          <img $al
3e90: 74 20 73 72 63 3d 5c 22 24 68 64 28 72 6f 6f 74  t src=\"$hd(root
3ea0: 70 61 74 68 2d 6d 61 69 6e 29 69 6d 61 67 65 73  path-main)images
3eb0: 2f 73 79 6e 74 61 78 2f 24 6e 61 6d 65 2e 67 69  /syntax/$name.gi
3ec0: 66 5c 22 3e 3c 2f 69 6d 67 3e 5c 0a 20 20 20 20  f\"></img>\.    
3ed0: 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65      </blockquote
3ee0: 3e 22 0a 20 20 7d 0a 20 20 69 66 20 7b 24 68 64  >".  }.  if {$hd
3ef0: 28 65 6e 61 62 6c 65 2d 61 75 78 29 7d 20 7b 0a  (enable-aux)} {.
3f00: 20 20 20 20 70 75 74 73 20 24 68 64 28 61 75 78      puts $hd(aux
3f10: 29 20 22 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 5c  ) "<blockquote>\
3f20: 0a 20 20 20 20 20 20 20 20 3c 69 6d 67 20 24 61  .        <img $a
3f30: 6c 74 20 73 72 63 3d 5c 22 24 68 64 28 72 6f 6f  lt src=\"$hd(roo
3f40: 74 70 61 74 68 2d 61 75 78 29 69 6d 61 67 65 73  tpath-aux)images
3f50: 2f 73 79 6e 74 61 78 2f 24 6e 61 6d 65 2e 67 69  /syntax/$name.gi
3f60: 66 5c 22 3e 3c 2f 69 6d 67 3e 5c 0a 20 20 20 20  f\"></img>\.    
3f70: 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65      </blockquote
3f80: 3e 22 0a 20 20 7d 0a 7d 0a 0a 23 20 52 65 63 6f  >".  }.}..# Reco
3f90: 72 64 20 61 20 72 65 71 75 69 72 65 6d 65 6e 74  rd a requirement
3fa0: 2e 20 20 54 68 69 73 20 70 72 6f 63 65 64 75 72  .  This procedur
3fb0: 65 20 69 73 20 61 63 74 69 76 65 20 6f 6e 6c 79  e is active only
3fc0: 20 66 6f 72 20 74 68 65 20 66 69 72 73 74 0a 23   for the first.#
3fd0: 20 70 61 73 73 2e 20 20 54 68 69 73 20 70 72 6f   pass.  This pro
3fe0: 63 65 64 75 72 65 20 62 65 63 6f 6d 65 73 20 61  cedure becomes a
3ff0: 20 6e 6f 2d 6f 70 20 66 6f 72 20 74 68 65 20 73   no-op for the s
4000: 65 63 6f 6e 64 20 70 61 73 73 2e 20 20 44 75 72  econd pass.  Dur
4010: 69 6e 67 0a 23 20 74 68 65 20 73 65 63 6f 6e 64  ing.# the second
4020: 20 70 61 73 73 2c 20 72 65 71 75 69 72 65 6d 65   pass, requireme
4030: 6e 74 73 20 6c 69 73 74 69 6e 67 20 72 65 70 6f  nts listing repo
4040: 72 74 20 67 65 6e 65 72 61 74 6f 72 73 20 63 61  rt generators ca
4050: 6e 20 75 73 65 20 74 68 65 0a 23 20 64 61 74 61  n use the.# data
4060: 20 61 63 63 75 6d 75 6c 61 74 65 64 20 64 75 72   accumulated dur
4070: 69 6e 67 20 74 68 65 20 66 69 72 73 74 20 70 61  ing the first pa
4080: 73 73 20 74 6f 20 63 6f 6e 73 74 72 75 63 74 20  ss to construct 
4090: 74 68 65 69 72 20 72 65 70 6f 72 74 73 2e 0a 23  their reports..#
40a0: 0a 23 20 49 66 20 74 68 65 20 22 76 65 72 62 61  .# If the "verba
40b0: 74 69 6d 22 20 61 72 67 75 6d 65 6e 74 20 69 73  tim" argument is
40c0: 20 74 72 75 65 2c 20 74 68 65 6e 20 74 68 65 20   true, then the 
40d0: 72 65 71 75 69 72 65 6d 65 6e 74 20 74 65 78 74  requirement text
40e0: 20 69 73 0a 23 20 72 65 6e 64 65 72 65 64 20 61   is.# rendered a
40f0: 73 20 69 73 2e 20 20 49 6e 20 6f 74 68 65 72 20  s is.  In other 
4100: 77 6f 72 64 73 2c 20 74 68 65 20 72 65 71 75 69  words, the requi
4110: 72 65 6d 65 6e 74 20 74 65 78 74 20 69 73 20 61  rement text is a
4120: 73 73 75 6d 65 64 20 74 6f 0a 23 20 62 65 20 76  ssumed to.# be v
4130: 61 6c 69 64 20 48 54 4d 4c 20 77 69 74 68 20 61  alid HTML with a
4140: 6c 6c 20 68 79 70 65 72 6c 69 6e 6b 73 20 61 6c  ll hyperlinks al
4150: 72 65 61 64 79 20 72 65 73 6f 6c 76 65 64 2e 20  ready resolved. 
4160: 20 49 66 20 74 68 65 20 22 76 65 72 62 61 74 69   If the "verbati
4170: 6d 22 0a 23 20 61 72 67 75 6d 65 6e 74 20 69 73  m".# argument is
4180: 20 66 61 6c 73 65 20 28 74 68 65 20 64 65 66 61   false (the defa
4190: 75 6c 74 29 20 74 68 65 6e 20 74 68 65 20 72 65  ult) then the re
41a0: 71 75 69 72 65 6d 65 6e 74 20 74 65 78 74 20 69  quirement text i
41b0: 73 20 72 65 6e 64 65 72 65 64 0a 23 20 75 73 69  s rendered.# usi
41c0: 6e 67 20 68 64 5f 72 65 6e 64 65 72 20 77 68 69  ng hd_render whi
41d0: 63 68 20 77 69 6c 6c 20 66 69 6e 64 20 61 6e 20  ch will find an 
41e0: 65 78 70 61 6e 64 20 68 79 70 65 72 6c 69 6e 6b  expand hyperlink
41f0: 73 20 77 69 74 68 69 6e 20 74 68 65 20 74 65 78  s within the tex
4200: 74 2e 0a 23 0a 23 20 54 68 65 20 22 63 6f 6d 6d  t..#.# The "comm
4210: 65 6e 74 22 20 61 72 67 75 6d 65 6e 74 20 69 73  ent" argument is
4220: 20 6e 6f 6e 2d 62 69 6e 64 69 6e 67 20 63 6f 6d   non-binding com
4230: 6d 65 6e 74 61 72 79 20 61 6e 64 20 65 78 70 6c  mentary and expl
4240: 61 6e 61 74 69 6f 6e 20 74 68 61 74 0a 23 20 61  anation that.# a
4250: 63 63 6f 6d 70 61 6e 69 65 73 20 74 68 65 20 72  ccompanies the r
4260: 65 71 75 69 72 65 6d 65 6e 74 2e 0a 23 0a 70 72  equirement..#.pr
4270: 6f 63 20 68 64 5f 72 65 71 75 69 72 65 6d 65 6e  oc hd_requiremen
4280: 74 20 7b 69 64 20 74 65 78 74 20 64 65 72 69 76  t {id text deriv
4290: 65 64 66 72 6f 6d 20 63 6f 6d 6d 65 6e 74 7d 20  edfrom comment} 
42a0: 7b 0a 20 20 67 6c 6f 62 61 6c 20 41 4c 4c 52 45  {.  global ALLRE
42b0: 51 20 41 4c 4c 52 45 51 5f 44 45 52 49 56 45 44  Q ALLREQ_DERIVED
42c0: 46 52 4f 4d 20 41 4c 4c 52 45 51 5f 43 4f 4d 0a  FROM ALLREQ_COM.
42d0: 20 20 69 66 20 7b 5b 69 6e 66 6f 20 65 78 69 73    if {[info exis
42e0: 74 73 20 41 4c 4c 52 45 51 28 24 69 64 29 5d 7d  ts ALLREQ($id)]}
42f0: 20 7b 0a 20 20 20 20 70 75 74 73 20 73 74 64 65   {.    puts stde
4300: 72 72 20 22 64 75 70 6c 69 63 61 74 65 20 72 65  rr "duplicate re
4310: 71 75 69 72 65 6d 65 6e 74 20 6c 61 62 65 6c 3a  quirement label:
4320: 20 24 69 64 22 0a 20 20 7d 0a 20 20 73 65 74 20   $id".  }.  set 
4330: 41 4c 4c 52 45 51 5f 44 45 52 49 56 45 44 46 52  ALLREQ_DERIVEDFR
4340: 4f 4d 28 24 69 64 29 20 24 64 65 72 69 76 65 64  OM($id) $derived
4350: 66 72 6f 6d 0a 20 20 73 65 74 20 41 4c 4c 52 45  from.  set ALLRE
4360: 51 28 24 69 64 29 20 24 74 65 78 74 0a 20 20 73  Q($id) $text.  s
4370: 65 74 20 41 4c 4c 52 45 51 5f 43 4f 4d 28 24 69  et ALLREQ_COM($i
4380: 64 29 20 24 63 6f 6d 6d 65 6e 74 0a 7d 0a 0a 23  d) $comment.}..#
4390: 20 52 65 61 64 20 61 20 62 6c 6f 63 6b 20 6f 66   Read a block of
43a0: 20 72 65 71 75 69 72 65 6d 65 6e 74 73 20 66 72   requirements fr
43b0: 6f 6d 20 61 6e 20 41 53 43 49 49 20 74 65 78 74  om an ASCII text
43c0: 20 66 69 6c 65 2e 20 20 53 74 6f 72 65 20 74 68   file.  Store th
43d0: 65 0a 23 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20  e.# information 
43e0: 6f 62 74 61 69 6e 65 64 20 69 6e 20 61 20 67 6c  obtained in a gl
43f0: 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 20 6e 61  obal variable na
4400: 6d 65 64 20 62 79 20 74 68 65 20 73 65 63 6f 6e  med by the secon
4410: 64 20 70 61 72 61 6d 65 74 65 72 2e 0a 23 0a 70  d parameter..#.p
4420: 72 6f 63 20 68 64 5f 72 65 61 64 5f 72 65 71 75  roc hd_read_requ
4430: 69 72 65 6d 65 6e 74 5f 66 69 6c 65 20 7b 66 69  irement_file {fi
4440: 6c 65 6e 61 6d 65 20 76 61 72 6e 61 6d 65 7d 20  lename varname} 
4450: 7b 0a 20 20 67 6c 6f 62 61 6c 20 68 64 5f 72 65  {.  global hd_re
4460: 71 5f 72 64 72 0a 20 20 68 64 5f 72 65 73 65 74  q_rdr.  hd_reset
4470: 5f 72 65 71 75 69 72 65 6d 65 6e 74 5f 72 65 61  _requirement_rea
4480: 64 65 72 0a 20 20 73 65 74 20 69 6e 20 5b 6f 70  der.  set in [op
4490: 65 6e 20 24 66 69 6c 65 6e 61 6d 65 5d 0a 20 20  en $filename].  
44a0: 77 68 69 6c 65 20 7b 21 5b 65 6f 66 20 24 69 6e  while {![eof $in
44b0: 5d 7d 20 7b 0a 20 20 20 20 73 65 74 20 6c 69 6e  ]} {.    set lin
44c0: 65 20 5b 67 65 74 73 20 24 69 6e 5d 0a 20 20 20  e [gets $in].   
44d0: 20 69 66 20 7b 5b 72 65 67 65 78 70 20 7b 5e 28   if {[regexp {^(
44e0: 48 4c 52 7c 55 4e 44 45 46 7c 53 59 53 52 45 51  HLR|UNDEF|SYSREQ
44f0: 29 20 2b 28 5b 4c 48 53 55 5d 5c 64 2b 29 20 2a  ) +([LHSU]\d+) *
4500: 28 2e 2a 29 7d 20 24 6c 69 6e 65 20 61 6c 6c 20  (.*)} $line all 
4510: 74 79 70 65 20 72 6e 20 64 66 5d 7d 20 7b 0a 20  type rn df]} {. 
4520: 20 20 20 20 20 68 64 5f 61 64 64 5f 6f 6e 65 5f       hd_add_one_
4530: 72 65 71 75 69 72 65 6d 65 6e 74 20 24 76 61 72  requirement $var
4540: 6e 61 6d 65 0a 20 20 20 20 20 20 73 65 74 20 68  name.      set h
4550: 64 5f 72 65 71 5f 72 64 72 28 72 6e 29 20 24 72  d_req_rdr(rn) $r
4560: 6e 0a 20 20 20 20 20 20 73 65 74 20 68 64 5f 72  n.      set hd_r
4570: 65 71 5f 72 64 72 28 64 65 72 69 76 65 64 29 20  eq_rdr(derived) 
4580: 24 64 66 0a 20 20 20 20 7d 20 65 6c 73 65 69 66  $df.    } elseif
4590: 20 7b 5b 73 74 72 69 6e 67 20 74 72 69 6d 20 24   {[string trim $
45a0: 6c 69 6e 65 5d 3d 3d 22 22 7d 20 7b 0a 20 20 20  line]==""} {.   
45b0: 20 20 20 69 66 20 7b 24 68 64 5f 72 65 71 5f 72     if {$hd_req_r
45c0: 64 72 28 62 6f 64 79 29 3d 3d 22 22 7d 20 7b 0a  dr(body)==""} {.
45d0: 20 20 20 20 20 20 20 20 73 65 74 20 68 64 5f 72          set hd_r
45e0: 65 71 5f 72 64 72 28 62 6f 64 79 29 20 24 68 64  eq_rdr(body) $hd
45f0: 5f 72 65 71 5f 72 64 72 28 63 6f 6d 6d 65 6e 74  _req_rdr(comment
4600: 29 0a 20 20 20 20 20 20 20 20 73 65 74 20 68 64  ).        set hd
4610: 5f 72 65 71 5f 72 64 72 28 63 6f 6d 6d 65 6e 74  _req_rdr(comment
4620: 29 20 7b 7d 0a 20 20 20 20 20 20 7d 20 65 6c 73  ) {}.      } els
4630: 65 20 7b 0a 20 20 20 20 20 20 20 20 61 70 70 65  e {.        appe
4640: 6e 64 20 68 64 5f 72 65 71 5f 72 64 72 28 63 6f  nd hd_req_rdr(co
4650: 6d 6d 65 6e 74 29 20 5c 6e 0a 20 20 20 20 20 20  mment) \n.      
4660: 7d 0a 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a 20  }.    } else {. 
4670: 20 20 20 20 20 61 70 70 65 6e 64 20 68 64 5f 72       append hd_r
4680: 65 71 5f 72 64 72 28 63 6f 6d 6d 65 6e 74 29 20  eq_rdr(comment) 
4690: 24 6c 69 6e 65 5c 6e 0a 20 20 20 20 7d 0a 20 20  $line\n.    }.  
46a0: 7d 0a 20 20 68 64 5f 61 64 64 5f 6f 6e 65 5f 72  }.  hd_add_one_r
46b0: 65 71 75 69 72 65 6d 65 6e 74 20 24 76 61 72 6e  equirement $varn
46c0: 61 6d 65 0a 20 20 63 6c 6f 73 65 20 24 69 6e 0a  ame.  close $in.
46d0: 20 20 0a 7d 0a 70 72 6f 63 20 68 64 5f 72 65 73    .}.proc hd_res
46e0: 65 74 5f 72 65 71 75 69 72 65 6d 65 6e 74 5f 72  et_requirement_r
46f0: 65 61 64 65 72 20 7b 7d 20 7b 0a 20 20 67 6c 6f  eader {} {.  glo
4700: 62 61 6c 20 68 64 5f 72 65 71 5f 72 64 72 0a 20  bal hd_req_rdr. 
4710: 20 73 65 74 20 68 64 5f 72 65 71 5f 72 64 72 28   set hd_req_rdr(
4720: 72 6e 29 20 7b 7d 0a 20 20 73 65 74 20 68 64 5f  rn) {}.  set hd_
4730: 72 65 71 5f 72 64 72 28 63 6f 6d 6d 65 6e 74 29  req_rdr(comment)
4740: 20 7b 7d 0a 20 20 73 65 74 20 68 64 5f 72 65 71   {}.  set hd_req
4750: 5f 72 64 72 28 62 6f 64 79 29 20 7b 7d 0a 20 20  _rdr(body) {}.  
4760: 73 65 74 20 68 64 5f 72 65 71 5f 72 64 72 28 64  set hd_req_rdr(d
4770: 65 72 69 76 65 64 29 20 7b 7d 0a 7d 0a 70 72 6f  erived) {}.}.pro
4780: 63 20 68 64 5f 61 64 64 5f 6f 6e 65 5f 72 65 71  c hd_add_one_req
4790: 75 69 72 65 6d 65 6e 74 20 7b 76 61 72 6e 61 6d  uirement {varnam
47a0: 65 7d 20 7b 0a 20 20 67 6c 6f 62 61 6c 20 68 64  e} {.  global hd
47b0: 5f 72 65 71 5f 72 64 72 0a 20 20 73 65 74 20 72  _req_rdr.  set r
47c0: 6e 20 24 68 64 5f 72 65 71 5f 72 64 72 28 72 6e  n $hd_req_rdr(rn
47d0: 29 0a 20 20 69 66 20 7b 24 72 6e 21 3d 22 22 7d  ).  if {$rn!=""}
47e0: 20 7b 0a 20 20 20 20 69 66 20 7b 24 68 64 5f 72   {.    if {$hd_r
47f0: 65 71 5f 72 64 72 28 62 6f 64 79 29 3d 3d 22 22  eq_rdr(body)==""
4800: 7d 20 7b 0a 20 20 20 20 20 20 73 65 74 20 68 64  } {.      set hd
4810: 5f 72 65 71 5f 72 64 72 28 62 6f 64 79 29 20 24  _req_rdr(body) $
4820: 68 64 5f 72 65 71 5f 72 64 72 28 63 6f 6d 6d 65  hd_req_rdr(comme
4830: 6e 74 29 0a 20 20 20 20 20 20 73 65 74 20 68 64  nt).      set hd
4840: 5f 72 65 71 5f 72 64 72 28 63 6f 6d 6d 65 6e 74  _req_rdr(comment
4850: 29 20 7b 7d 0a 20 20 20 20 7d 0a 20 20 20 20 73  ) {}.    }.    s
4860: 65 74 20 62 20 5b 73 74 72 69 6e 67 20 74 72 69  et b [string tri
4870: 6d 20 24 68 64 5f 72 65 71 5f 72 64 72 28 62 6f  m $hd_req_rdr(bo
4880: 64 79 29 5d 0a 20 20 20 20 73 65 74 20 63 20 5b  dy)].    set c [
4890: 73 74 72 69 6e 67 20 74 72 69 6d 20 24 68 64 5f  string trim $hd_
48a0: 72 65 71 5f 72 64 72 28 63 6f 6d 6d 65 6e 74 29  req_rdr(comment)
48b0: 5d 0a 20 20 20 20 73 65 74 20 3a 3a 24 7b 76 61  ].    set ::${va
48c0: 72 6e 61 6d 65 7d 28 24 72 6e 29 20 5b 6c 69 73  rname}($rn) [lis
48d0: 74 20 24 68 64 5f 72 65 71 5f 72 64 72 28 64 65  t $hd_req_rdr(de
48e0: 72 69 76 65 64 29 20 24 62 20 24 63 5d 0a 20 20  rived) $b $c].  
48f0: 20 20 6c 61 70 70 65 6e 64 20 3a 3a 24 7b 76 61    lappend ::${va
4900: 72 6e 61 6d 65 7d 28 2a 29 20 24 72 6e 0a 20 20  rname}(*) $rn.  
4910: 7d 0a 20 20 68 64 5f 72 65 73 65 74 5f 72 65 71  }.  hd_reset_req
4920: 75 69 72 65 6d 65 6e 74 5f 72 65 61 64 65 72 0a  uirement_reader.
4930: 7d 0a 0a 23 20 46 69 72 73 74 20 70 61 73 73 2e  }..# First pass.
4940: 20 20 50 72 6f 63 65 73 73 20 61 6c 6c 20 66 69    Process all fi
4950: 6c 65 73 2e 20 20 42 75 74 20 64 6f 20 6e 6f 74  les.  But do not
4960: 20 72 65 6e 64 65 72 20 68 79 70 65 72 6c 69 6e   render hyperlin
4970: 6b 73 2e 0a 23 20 4d 65 72 65 6c 79 20 63 6f 6c  ks..# Merely col
4980: 6c 65 63 74 20 6b 65 79 77 6f 72 64 20 69 6e 66  lect keyword inf
4990: 6f 72 6d 61 74 69 6f 6e 20 73 6f 20 74 68 61 74  ormation so that
49a0: 20 68 79 70 65 72 6c 69 6e 6b 73 20 63 61 6e 20   hyperlinks can 
49b0: 62 65 0a 23 20 63 6f 72 72 65 63 74 6c 79 20 72  be.# correctly r
49c0: 65 6e 64 65 72 65 64 20 6f 6e 20 74 68 65 20 73  endered on the s
49d0: 65 63 6f 6e 64 20 70 61 73 73 2e 0a 23 0a 66 6f  econd pass..#.fo
49e0: 72 65 61 63 68 20 69 6e 66 69 6c 65 20 5b 6c 72  reach infile [lr
49f0: 61 6e 67 65 20 24 61 72 67 76 20 33 20 65 6e 64  ange $argv 3 end
4a00: 5d 20 7b 0a 20 20 63 64 20 24 48 4f 4d 45 44 49  ] {.  cd $HOMEDI
4a10: 52 0a 20 20 70 75 74 73 20 22 50 72 6f 63 65 73  R.  puts "Proces
4a20: 73 69 6e 67 20 24 69 6e 66 69 6c 65 22 0a 20 20  sing $infile".  
4a30: 73 65 74 20 66 64 20 5b 6f 70 65 6e 20 24 69 6e  set fd [open $in
4a40: 66 69 6c 65 20 72 5d 0a 20 20 73 65 74 20 69 6e  file r].  set in
4a50: 20 5b 72 65 61 64 20 24 66 64 5d 0a 20 20 63 6c   [read $fd].  cl
4a60: 6f 73 65 20 24 66 64 0a 20 20 73 65 74 20 74 69  ose $fd.  set ti
4a70: 74 6c 65 20 7b 4e 6f 20 54 69 74 6c 65 7d 0a 20  tle {No Title}. 
4a80: 20 72 65 67 65 78 70 20 7b 3c 74 69 74 6c 65 3e   regexp {<title>
4a90: 28 5b 5e 5c 6e 5d 2a 29 3c 2f 74 69 74 6c 65 3e  ([^\n]*)</title>
4aa0: 7d 20 24 69 6e 20 61 6c 6c 20 74 69 74 6c 65 0a  } $in all title.
4ab0: 20 20 72 65 67 73 75 62 20 7b 3c 74 69 74 6c 65    regsub {<title
4ac0: 3e 5b 5e 5c 6e 5d 2a 3c 2f 74 69 74 6c 65 3e 7d  >[^\n]*</title>}
4ad0: 20 24 69 6e 20 7b 7d 20 69 6e 0a 20 20 73 65 74   $in {} in.  set
4ae0: 20 6f 75 74 66 69 6c 65 20 5b 66 69 6c 65 20 72   outfile [file r
4af0: 6f 6f 74 20 5b 66 69 6c 65 20 74 61 69 6c 20 24  oot [file tail $
4b00: 69 6e 66 69 6c 65 5d 5d 2e 68 74 6d 6c 0a 20 20  infile]].html.  
4b10: 68 64 5f 6f 70 65 6e 5f 6d 61 69 6e 20 24 6f 75  hd_open_main $ou
4b20: 74 66 69 6c 65 0a 20 20 64 62 20 65 76 61 6c 20  tfile.  db eval 
4b30: 7b 0a 20 20 20 20 49 4e 53 45 52 54 20 49 4e 54  {.    INSERT INT
4b40: 4f 20 70 61 67 65 28 66 69 6c 65 6e 61 6d 65 2c  O page(filename,
4b50: 70 61 67 65 74 69 74 6c 65 29 0a 20 20 20 20 56  pagetitle).    V
4b60: 41 4c 55 45 53 28 24 6f 75 74 66 69 6c 65 2c 24  ALUES($outfile,$
4b70: 74 69 74 6c 65 29 3b 0a 20 20 7d 0a 20 20 73 65  title);.  }.  se
4b80: 74 20 68 28 70 61 67 65 69 64 29 20 5b 64 62 20  t h(pageid) [db 
4b90: 6c 61 73 74 5f 69 6e 73 65 72 74 5f 72 6f 77 69  last_insert_rowi
4ba0: 64 5d 0a 20 20 68 64 5f 68 65 61 64 65 72 20 24  d].  hd_header $
4bb0: 74 69 74 6c 65 20 24 69 6e 66 69 6c 65 0a 20 20  title $infile.  
4bc0: 72 65 67 73 75 62 20 2d 61 6c 6c 20 7b 3c 74 63  regsub -all {<tc
4bd0: 6c 3e 7d 20 24 69 6e 20 22 5c 31 37 35 3b 20 65  l>} $in "\175; e
4be0: 76 61 6c 20 5c 31 37 33 22 20 69 6e 0a 20 20 72  val \173" in.  r
4bf0: 65 67 73 75 62 20 2d 61 6c 6c 20 7b 3c 2f 74 63  egsub -all {</tc
4c00: 6c 3e 7d 20 24 69 6e 20 22 5c 31 37 35 3b 20 68  l>} $in "\175; h
4c10: 64 5f 70 75 74 73 20 5c 31 37 33 22 20 69 6e 0a  d_puts \173" in.
4c20: 20 20 65 76 61 6c 20 22 68 64 5f 70 75 74 73 20    eval "hd_puts 
4c30: 5c 31 37 33 24 69 6e 5c 31 37 35 22 0a 20 20 63  \173$in\175".  c
4c40: 64 20 24 3a 3a 48 4f 4d 45 44 49 52 0a 20 20 68  d $::HOMEDIR.  h
4c50: 64 5f 63 6c 6f 73 65 5f 6d 61 69 6e 0a 7d 0a 0a  d_close_main.}..
4c60: 23 20 53 65 63 6f 6e 64 20 70 61 73 73 2e 20 20  # Second pass.  
4c70: 50 72 6f 63 65 73 73 20 61 6c 6c 20 66 69 6c 65  Process all file
4c80: 73 20 61 67 61 69 6e 2e 20 20 54 68 69 73 20 74  s again.  This t
4c90: 69 6d 65 20 72 65 6e 64 65 72 20 68 79 70 65 72  ime render hyper
4ca0: 6c 69 6e 6b 73 0a 23 20 61 63 63 6f 72 64 69 6e  links.# accordin
4cb0: 67 20 74 6f 20 74 68 65 20 6b 65 79 77 6f 72 64  g to the keyword
4cc0: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 63 6f 6c   information col
4cd0: 6c 65 63 74 65 64 20 6f 6e 20 74 68 65 20 66 69  lected on the fi
4ce0: 72 73 74 20 70 61 73 73 2e 0a 23 0a 70 72 6f 63  rst pass..#.proc
4cf0: 20 68 64 5f 6b 65 79 77 6f 72 64 73 20 7b 61 72   hd_keywords {ar
4d00: 67 73 7d 20 7b 7d 0a 72 65 6e 61 6d 65 20 68 64  gs} {}.rename hd
4d10: 5f 72 65 73 6f 6c 76 65 20 7b 7d 0a 72 65 6e 61  _resolve {}.rena
4d20: 6d 65 20 68 64 5f 72 65 73 6f 6c 76 65 5f 32 6e  me hd_resolve_2n
4d30: 64 70 61 73 73 20 68 64 5f 72 65 73 6f 6c 76 65  dpass hd_resolve
4d40: 0a 70 72 6f 63 20 68 64 5f 72 65 71 75 69 72 65  .proc hd_require
4d50: 6d 65 6e 74 20 7b 61 72 67 73 7d 20 7b 7d 0a 66  ment {args} {}.f
4d60: 6f 72 65 61 63 68 20 69 6e 66 69 6c 65 20 5b 6c  oreach infile [l
4d70: 72 61 6e 67 65 20 24 61 72 67 76 20 33 20 65 6e  range $argv 3 en
4d80: 64 5d 20 7b 0a 20 20 63 64 20 24 48 4f 4d 45 44  d] {.  cd $HOMED
4d90: 49 52 0a 20 20 70 75 74 73 20 22 50 72 6f 63 65  IR.  puts "Proce
4da0: 73 73 69 6e 67 20 24 69 6e 66 69 6c 65 22 0a 20  ssing $infile". 
4db0: 20 73 65 74 20 66 64 20 5b 6f 70 65 6e 20 24 69   set fd [open $i
4dc0: 6e 66 69 6c 65 20 72 5d 0a 20 20 73 65 74 20 69  nfile r].  set i
4dd0: 6e 20 5b 72 65 61 64 20 24 66 64 5d 0a 20 20 63  n [read $fd].  c
4de0: 6c 6f 73 65 20 24 66 64 0a 20 20 73 65 74 20 74  lose $fd.  set t
4df0: 69 74 6c 65 20 7b 4e 6f 20 54 69 74 6c 65 7d 0a  itle {No Title}.
4e00: 20 20 72 65 67 65 78 70 20 7b 3c 74 69 74 6c 65    regexp {<title
4e10: 3e 28 5b 5e 5c 6e 5d 2a 29 3c 2f 74 69 74 6c 65  >([^\n]*)</title
4e20: 3e 7d 20 24 69 6e 20 61 6c 6c 20 74 69 74 6c 65  >} $in all title
4e30: 0a 20 20 72 65 67 73 75 62 20 7b 3c 74 69 74 6c  .  regsub {<titl
4e40: 65 3e 5b 5e 5c 6e 5d 2a 3c 2f 74 69 74 6c 65 3e  e>[^\n]*</title>
4e50: 7d 20 24 69 6e 20 7b 7d 20 69 6e 0a 20 20 73 65  } $in {} in.  se
4e60: 74 20 6f 75 74 66 69 6c 65 20 5b 66 69 6c 65 20  t outfile [file 
4e70: 72 6f 6f 74 20 5b 66 69 6c 65 20 74 61 69 6c 20  root [file tail 
4e80: 24 69 6e 66 69 6c 65 5d 5d 2e 68 74 6d 6c 0a 20  $infile]].html. 
4e90: 20 68 64 5f 6f 70 65 6e 5f 6d 61 69 6e 20 24 6f   hd_open_main $o
4ea0: 75 74 66 69 6c 65 0a 20 20 68 64 5f 68 65 61 64  utfile.  hd_head
4eb0: 65 72 20 24 74 69 74 6c 65 20 24 69 6e 66 69 6c  er $title $infil
4ec0: 65 0a 20 20 72 65 67 73 75 62 20 2d 61 6c 6c 20  e.  regsub -all 
4ed0: 7b 3c 74 63 6c 3e 7d 20 24 69 6e 20 22 5c 31 37  {<tcl>} $in "\17
4ee0: 35 3b 20 65 76 61 6c 20 5c 31 37 33 22 20 69 6e  5; eval \173" in
4ef0: 0a 20 20 72 65 67 73 75 62 20 2d 61 6c 6c 20 7b  .  regsub -all {
4f00: 3c 2f 74 63 6c 3e 7d 20 24 69 6e 20 22 5c 31 37  </tcl>} $in "\17
4f10: 35 3b 20 68 64 5f 72 65 73 6f 6c 76 65 20 5c 31  5; hd_resolve \1
4f20: 37 33 22 20 69 6e 0a 20 20 65 76 61 6c 20 22 68  73" in.  eval "h
4f30: 64 5f 72 65 73 6f 6c 76 65 20 5c 31 37 33 24 69  d_resolve \173$i
4f40: 6e 5c 31 37 35 22 0a 20 20 63 64 20 24 3a 3a 48  n\175".  cd $::H
4f50: 4f 4d 45 44 49 52 0a 20 20 68 64 5f 63 6c 6f 73  OMEDIR.  hd_clos
4f60: 65 5f 6d 61 69 6e 0a 7d 0a 0a 23 20 47 65 6e 65  e_main.}..# Gene
4f70: 72 61 74 65 20 61 20 64 6f 63 75 6d 65 6e 74 20  rate a document 
4f80: 73 68 6f 77 69 6e 67 20 74 68 65 20 68 79 70 65  showing the hype
4f90: 72 6c 69 6e 6b 20 6b 65 79 77 6f 72 64 73 20 61  rlink keywords a
4fa0: 6e 64 20 74 68 65 69 72 0a 23 20 74 61 72 67 65  nd their.# targe
4fb0: 74 73 2e 0a 23 0a 68 64 5f 6f 70 65 6e 5f 6d 61  ts..#.hd_open_ma
4fc0: 69 6e 20 64 6f 63 5f 6b 65 79 77 6f 72 64 5f 63  in doc_keyword_c
4fd0: 72 6f 73 73 72 65 66 2e 68 74 6d 6c 0a 68 64 5f  rossref.html.hd_
4fe0: 68 65 61 64 65 72 20 7b 4b 65 79 77 6f 72 64 20  header {Keyword 
4ff0: 43 72 6f 73 73 72 65 66 65 72 65 6e 63 65 7d 20  Crossreference} 
5000: 24 44 4f 43 2f 77 72 61 70 2e 74 63 6c 0a 68 64  $DOC/wrap.tcl.hd
5010: 5f 70 75 74 73 20 22 3c 75 6c 3e 22 0a 66 6f 72  _puts "<ul>".for
5020: 65 61 63 68 20 78 20 5b 6c 73 6f 72 74 20 2d 64  each x [lsort -d
5030: 69 63 74 20 5b 61 72 72 61 79 20 6e 61 6d 65 73  ict [array names
5040: 20 67 6c 69 6e 6b 5d 5d 20 7b 0a 20 20 73 65 74   glink]] {.  set
5050: 20 79 20 24 67 6c 69 6e 6b 28 24 78 29 0a 20 20   y $glink($x).  
5060: 68 64 5f 70 75 74 73 20 22 3c 6c 69 3e 24 78 20  hd_puts "<li>$x 
5070: 2d 20 3c 61 20 68 72 65 66 3d 5c 22 24 79 5c 22  - <a href=\"$y\"
5080: 3e 24 79 3c 2f 61 3e 3c 2f 6c 69 3e 22 0a 20 20  >$y</a></li>".  
5090: 6c 61 70 70 65 6e 64 20 72 65 76 67 6c 69 6e 6b  lappend revglink
50a0: 28 24 79 29 20 24 78 0a 7d 0a 68 64 5f 70 75 74  ($y) $x.}.hd_put
50b0: 73 20 22 3c 2f 75 6c 3e 22 0a 68 64 5f 63 6c 6f  s "</ul>".hd_clo
50c0: 73 65 5f 6d 61 69 6e 0a 0a 68 64 5f 6f 70 65 6e  se_main..hd_open
50d0: 5f 6d 61 69 6e 20 64 6f 63 5f 74 61 72 67 65 74  _main doc_target
50e0: 5f 63 72 6f 73 73 72 65 66 2e 68 74 6d 6c 0a 68  _crossref.html.h
50f0: 64 5f 68 65 61 64 65 72 20 7b 54 61 72 67 65 74  d_header {Target
5100: 20 43 72 6f 73 73 72 65 66 65 72 65 6e 63 65 7d   Crossreference}
5110: 20 24 44 4f 43 2f 77 72 61 70 2e 74 63 6c 0a 68   $DOC/wrap.tcl.h
5120: 64 5f 70 75 74 73 20 22 3c 75 6c 3e 22 0a 66 6f  d_puts "<ul>".fo
5130: 72 65 61 63 68 20 79 20 5b 6c 73 6f 72 74 20 5b  reach y [lsort [
5140: 61 72 72 61 79 20 6e 61 6d 65 73 20 72 65 76 67  array names revg
5150: 6c 69 6e 6b 5d 5d 20 7b 0a 20 20 68 64 5f 70 75  link]] {.  hd_pu
5160: 74 73 20 22 3c 6c 69 3e 3c 61 20 68 72 65 66 3d  ts "<li><a href=
5170: 5c 22 24 79 5c 22 3e 24 79 3c 2f 61 3e 20 2d 20  \"$y\">$y</a> - 
5180: 5b 6c 73 6f 72 74 20 24 72 65 76 67 6c 69 6e 6b  [lsort $revglink
5190: 28 24 79 29 5d 3c 2f 6c 69 3e 22 0a 7d 0a 68 64  ($y)]</li>".}.hd
51a0: 5f 70 75 74 73 20 22 3c 2f 75 6c 3e 22 0a 68 64  _puts "</ul>".hd
51b0: 5f 63 6c 6f 73 65 5f 6d 61 69 6e 0a 0a 68 64 5f  _close_main..hd_
51c0: 6f 70 65 6e 5f 6d 61 69 6e 20 64 6f 63 5f 62 61  open_main doc_ba
51d0: 63 6b 6c 69 6e 6b 5f 63 72 6f 73 73 72 65 66 2e  cklink_crossref.
51e0: 68 74 6d 6c 0a 68 64 5f 68 65 61 64 65 72 20 7b  html.hd_header {
51f0: 42 61 63 6b 6c 69 6e 6b 20 43 72 6f 73 73 72 65  Backlink Crossre
5200: 66 65 72 65 6e 63 65 7d 20 24 44 4f 43 2f 77 72  ference} $DOC/wr
5210: 61 70 2e 74 63 6c 0a 68 64 5f 70 75 74 73 20 22  ap.tcl.hd_puts "
5220: 3c 75 6c 3e 22 0a 66 6f 72 65 61 63 68 20 6b 77  <ul>".foreach kw
5230: 20 5b 6c 73 6f 72 74 20 2d 6e 6f 63 61 73 65 20   [lsort -nocase 
5240: 5b 61 72 72 61 79 20 6e 61 6d 65 73 20 62 61 63  [array names bac
5250: 6b 6c 69 6e 6b 5d 5d 20 7b 0a 20 20 68 64 5f 70  klink]] {.  hd_p
5260: 75 74 73 20 22 3c 6c 69 3e 24 6b 77 20 2d 22 0a  uts "<li>$kw -".
5270: 20 20 73 65 74 20 70 72 65 76 20 7b 7d 0a 20 20    set prev {}.  
5280: 66 6f 72 65 61 63 68 20 72 65 66 20 5b 6c 73 6f  foreach ref [lso
5290: 72 74 20 24 62 61 63 6b 6c 69 6e 6b 28 24 6b 77  rt $backlink($kw
52a0: 29 5d 20 7b 0a 20 20 20 20 69 66 20 7b 24 72 65  )] {.    if {$re
52b0: 66 3d 3d 24 70 72 65 76 7d 20 63 6f 6e 74 69 6e  f==$prev} contin
52c0: 75 65 0a 20 20 20 20 73 65 74 20 70 72 65 76 20  ue.    set prev 
52d0: 24 72 65 66 0a 20 20 20 20 68 64 5f 70 75 74 73  $ref.    hd_puts
52e0: 20 22 20 20 3c 61 20 68 72 65 66 3d 5c 22 24 72   "  <a href=\"$r
52f0: 65 66 5c 22 3e 24 72 65 66 3c 2f 61 3e 22 0a 20  ef\">$ref</a>". 
5300: 20 7d 0a 7d 0a 68 64 5f 70 75 74 73 20 22 3c 2f   }.}.hd_puts "</
5310: 75 6c 3e 22 0a 68 64 5f 63 6c 6f 73 65 5f 6d 61  ul>".hd_close_ma
5320: 69 6e 0a 0a 68 64 5f 6f 70 65 6e 5f 6d 61 69 6e  in..hd_open_main
5330: 20 64 6f 63 5f 70 61 67 65 6c 69 6e 6b 5f 63 72   doc_pagelink_cr
5340: 6f 73 73 72 65 66 2e 68 74 6d 6c 0a 68 64 5f 68  ossref.html.hd_h
5350: 65 61 64 65 72 20 7b 50 61 67 65 6c 69 6e 6b 20  eader {Pagelink 
5360: 43 72 6f 73 73 72 65 66 65 72 65 6e 63 65 7d 20  Crossreference} 
5370: 24 44 4f 43 2f 77 72 61 70 2e 74 63 6c 0a 68 64  $DOC/wrap.tcl.hd
5380: 5f 70 75 74 73 20 22 3c 70 3e 54 61 72 67 65 74  _puts "<p>Target
5390: 20 50 61 67 65 20 2d 20 57 68 69 63 68 20 70 61   Page - Which pa
53a0: 67 65 73 20 72 65 66 65 72 65 6e 63 65 20 69 74  ges reference it
53b0: 2e 3c 2f 70 3e 22 0a 68 64 5f 70 75 74 73 20 22  .</p>".hd_puts "
53c0: 3c 70 3e 50 61 67 65 73 20 6d 61 74 63 68 69 6e  <p>Pages matchin
53d0: 67 20 28 6e 65 77 73 7c 63 68 61 6e 67 65 73 7c  g (news|changes|
53e0: 72 65 6c 65 61 73 65 6c 6f 67 7c 5c 5b 30 2d 39  releaselog|\[0-9
53f0: 5d 74 6f 5c 5b 30 2d 39 5d 7c 26 23 39 34 3b 64  ]to\[0-9]|&#94;d
5400: 6f 63 5f 2e 2a 5f 63 72 6f 73 73 72 65 66 29 20  oc_.*_crossref) 
5410: 61 72 65 20 73 6b 69 70 70 65 64 2e 3c 2f 70 3e  are skipped.</p>
5420: 22 0a 68 64 5f 70 75 74 73 20 22 3c 75 6c 3e 22  ".hd_puts "<ul>"
5430: 0a 66 6f 72 65 61 63 68 20 79 20 5b 6c 73 6f 72  .foreach y [lsor
5440: 74 20 5b 61 72 72 61 79 20 6e 61 6d 65 73 20 72  t [array names r
5450: 65 76 67 6c 69 6e 6b 5d 5d 20 7b 0a 20 20 72 65  evglink]] {.  re
5460: 67 73 75 62 20 7b 23 2e 2a 7d 20 24 79 20 7b 7d  gsub {#.*} $y {}
5470: 20 79 32 0a 20 20 66 6f 72 65 61 63 68 20 6b 77   y2.  foreach kw
5480: 20 5b 6c 73 6f 72 74 20 24 72 65 76 67 6c 69 6e   [lsort $revglin
5490: 6b 28 24 79 29 5d 20 7b 0a 20 20 20 20 69 66 20  k($y)] {.    if 
54a0: 7b 5b 69 6e 66 6f 20 65 78 69 73 74 73 20 62 61  {[info exists ba
54b0: 63 6b 6c 69 6e 6b 28 24 6b 77 29 5d 7d 20 7b 0a  cklink($kw)]} {.
54c0: 20 20 20 20 20 20 66 6f 72 65 61 63 68 20 72 65        foreach re
54d0: 66 20 5b 6c 73 6f 72 74 20 24 62 61 63 6b 6c 69  f [lsort $backli
54e0: 6e 6b 28 24 6b 77 29 5d 20 7b 0a 20 20 20 20 20  nk($kw)] {.     
54f0: 20 20 20 72 65 67 73 75 62 20 7b 23 2e 2a 7d 20     regsub {#.*} 
5500: 24 72 65 66 20 7b 7d 20 72 65 66 32 0a 20 20 20  $ref {} ref2.   
5510: 20 20 20 20 20 6c 61 70 70 65 6e 64 20 70 61 67       lappend pag
5520: 65 6c 69 6e 6b 28 24 79 32 29 20 24 72 65 66 32  elink($y2) $ref2
5530: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20  .      }.    }. 
5540: 20 7d 0a 7d 0a 66 6f 72 65 61 63 68 20 79 20 5b   }.}.foreach y [
5550: 6c 73 6f 72 74 20 5b 61 72 72 61 79 20 6e 61 6d  lsort [array nam
5560: 65 73 20 70 61 67 65 6c 69 6e 6b 5d 5d 20 7b 0a  es pagelink]] {.
5570: 20 20 69 66 20 7b 5b 72 65 67 65 78 70 20 7b 28    if {[regexp {(
5580: 6e 65 77 73 7c 63 68 61 6e 67 65 73 7c 72 65 6c  news|changes|rel
5590: 65 61 73 65 6c 6f 67 7c 5b 30 2d 39 5d 74 6f 5b  easelog|[0-9]to[
55a0: 30 2d 39 5d 7c 5e 64 6f 63 5f 2e 2a 5f 63 72 6f  0-9]|^doc_.*_cro
55b0: 73 73 72 65 66 29 7d 20 24 79 5d 7d 20 63 6f 6e  ssref)} $y]} con
55c0: 74 69 6e 75 65 0a 20 20 68 64 5f 70 75 74 73 20  tinue.  hd_puts 
55d0: 22 3c 6c 69 3e 3c 61 20 68 72 65 66 3d 5c 22 24  "<li><a href=\"$
55e0: 79 5c 22 3e 24 79 3c 2f 61 3e 20 2d 20 22 0a 20  y\">$y</a> - ". 
55f0: 20 73 65 74 20 70 72 65 76 20 7b 7d 0a 20 20 66   set prev {}.  f
5600: 6f 72 65 61 63 68 20 72 65 66 20 5b 6c 73 6f 72  oreach ref [lsor
5610: 74 20 24 70 61 67 65 6c 69 6e 6b 28 24 79 29 5d  t $pagelink($y)]
5620: 20 7b 0a 20 20 20 20 69 66 20 7b 24 72 65 66 3d   {.    if {$ref=
5630: 3d 24 70 72 65 76 7d 20 63 6f 6e 74 69 6e 75 65  =$prev} continue
5640: 0a 20 20 20 20 69 66 20 7b 24 72 65 66 3d 3d 24  .    if {$ref==$
5650: 79 7d 20 63 6f 6e 74 69 6e 75 65 0a 20 20 20 20  y} continue.    
5660: 69 66 20 7b 5b 72 65 67 65 78 70 20 7b 28 6e 65  if {[regexp {(ne
5670: 77 73 7c 63 68 61 6e 67 65 73 7c 72 65 6c 65 61  ws|changes|relea
5680: 73 65 6c 6f 67 7c 5b 30 2d 39 5d 74 6f 5b 30 2d  selog|[0-9]to[0-
5690: 39 5d 7c 5e 64 6f 63 5f 2e 2a 5f 63 72 6f 73 73  9]|^doc_.*_cross
56a0: 72 65 66 29 7d 20 24 72 65 66 5d 7d 20 63 6f 6e  ref)} $ref]} con
56b0: 74 69 6e 75 65 0a 20 20 20 20 68 64 5f 70 75 74  tinue.    hd_put
56c0: 73 20 22 3c 61 20 68 72 65 66 3d 5c 22 24 72 65  s "<a href=\"$re
56d0: 66 5c 22 3e 24 72 65 66 3c 2f 61 3e 20 22 0a 20  f\">$ref</a> ". 
56e0: 20 20 20 73 65 74 20 70 72 65 76 20 24 72 65 66     set prev $ref
56f0: 0a 20 20 7d 0a 20 20 68 64 5f 70 75 74 73 20 22  .  }.  hd_puts "
5700: 3c 2f 6c 69 3e 22 0a 7d 0a 68 64 5f 70 75 74 73  </li>".}.hd_puts
5710: 20 22 3c 2f 75 6c 3e 22 0a 68 64 5f 63 6c 6f 73   "</ul>".hd_clos
5720: 65 5f 6d 61 69 6e 0a 64 62 20 65 76 61 6c 20 43  e_main.db eval C
5730: 4f 4d 4d 49 54 0a                                OMMIT.