TextSweep

Hex Artifact Content
Login

Artifact 95aa6ac1154478ba7ebf5c5e4c765e2e7ba8e6db:


0000: 23 20 2d 2a 2d 20 74 63 6c 20 2d 2a 2d 0a 23 0a  # -*- tcl -*-.#.
0010: 23 20 5f 63 6f 6d 6d 6f 6e 2e 74 63 6c 0a 23 0a  # _common.tcl.#.
0020: 23 20 28 63 29 20 32 30 30 31 20 41 6e 64 72 65  # (c) 2001 Andre
0030: 61 73 20 4b 75 70 72 69 65 73 20 3c 61 6e 64 72  as Kupries <andr
0040: 65 61 73 5f 6b 75 70 72 69 65 73 40 73 6f 75 72  eas_kupries@sour
0050: 63 65 66 6f 72 67 65 2e 6e 65 74 3e 0a 23 20 28  ceforge.net>.# (
0060: 63 29 20 32 30 30 32 20 41 6e 64 72 65 61 73 20  c) 2002 Andreas 
0070: 4b 75 70 72 69 65 73 20 3c 61 6e 64 72 65 61 73  Kupries <andreas
0080: 5f 6b 75 70 72 69 65 73 40 73 6f 75 72 63 65 66  _kupries@sourcef
0090: 6f 72 67 65 2e 6e 65 74 3e 0a 0a 23 23 23 23 23  orge.net>..#####
00a0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
00b0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
00c0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
00d0: 23 23 23 23 23 23 23 23 23 23 23 0a 23 20 54 68  ###########.# Th
00e0: 65 20 63 6f 64 65 20 68 65 72 65 20 63 6f 6e 74  e code here cont
00f0: 61 69 6e 73 20 67 65 6e 65 72 61 6c 20 64 65 66  ains general def
0100: 69 6e 69 74 69 6f 6e 73 20 66 6f 72 20 41 50 49  initions for API
0110: 20 66 75 6e 63 74 69 6f 6e 73 20 61 6e 64 0a 23   functions and.#
0120: 20 73 74 61 74 65 20 69 6e 66 6f 72 6d 61 74 69   state informati
0130: 6f 6e 2e 20 54 68 65 79 20 61 72 65 20 75 73 65  on. They are use
0140: 64 20 62 79 20 73 65 76 65 72 61 6c 20 66 6f 72  d by several for
0150: 6d 61 74 74 65 72 73 20 74 6f 20 73 69 6d 70 6c  matters to simpl
0160: 69 66 79 0a 23 20 74 68 65 69 72 20 6f 77 6e 20  ify.# their own 
0170: 63 6f 64 65 2e 0a 0a 67 6c 6f 62 61 6c 20 20 20  code...global   
0180: 20 73 74 61 74 65 0a 61 72 72 61 79 20 73 65 74   state.array set
0190: 20 73 74 61 74 65 20 7b 7d 0a 0a 70 72 6f 63 20   state {}..proc 
01a0: 66 6d 74 5f 69 6e 69 74 69 61 6c 69 7a 65 20 7b  fmt_initialize {
01b0: 7d 20 7b 0a 20 20 20 20 67 6c 6f 62 61 6c 20 20  } {.    global  
01c0: 20 20 73 74 61 74 65 0a 20 20 20 20 75 6e 73 65    state.    unse
01d0: 74 20 20 20 20 20 73 74 61 74 65 0a 0a 20 20 20  t     state..   
01e0: 20 73 65 74 20 73 74 61 74 65 28 70 61 73 73 29   set state(pass)
01f0: 20 20 20 75 6e 6b 6e 6f 77 6e 20 3b 20 23 20 4e     unknown ; # N
0200: 6f 74 20 72 65 6c 65 76 61 6e 74 20 62 65 66 6f  ot relevant befo
0210: 72 65 20 61 20 70 61 73 73 0a 20 20 20 20 73 65  re a pass.    se
0220: 74 20 73 74 61 74 65 28 62 65 67 75 6e 29 20 20  t state(begun)  
0230: 75 6e 6b 6e 6f 77 6e 20 3b 20 23 20 69 73 20 61  unknown ; # is a
0240: 63 74 69 76 65 0a 20 20 20 20 73 65 74 20 73 74  ctive.    set st
0250: 61 74 65 28 6d 64 65 73 63 29 20 20 7b 7d 20 20  ate(mdesc)  {}  
0260: 20 20 20 20 3b 20 23 20 54 65 78 74 2c 20 6d 6f      ; # Text, mo
0270: 64 75 6c 65 20 64 65 73 63 69 70 74 69 6f 6e 0a  dule desciption.
0280: 20 20 20 20 23 73 65 74 20 73 74 61 74 65 28 74      #set state(t
0290: 64 65 73 63 29 20 7b 7d 20 20 20 20 20 20 3b 20  desc) {}      ; 
02a0: 23 20 54 65 78 74 2c 20 74 69 74 6c 65 20 6f 66  # Text, title of
02b0: 20 6d 61 6e 70 61 67 65 0a 20 20 20 20 73 65 74   manpage.    set
02c0: 20 73 74 61 74 65 28 63 6f 70 79 72 69 67 68 74   state(copyright
02d0: 29 20 7b 7d 20 20 20 3b 20 23 20 54 65 78 74 2c  ) {}   ; # Text,
02e0: 20 63 6f 70 79 72 69 67 68 74 20 61 73 73 69 67   copyright assig
02f0: 6e 6d 65 6e 74 20 28 6c 69 73 74 29 0a 20 20 20  nment (list).   
0300: 20 72 65 74 75 72 6e 0a 7d 0a 0a 70 72 6f 63 20   return.}..proc 
0310: 66 6d 74 5f 73 68 75 74 64 6f 77 6e 20 20 20 20  fmt_shutdown    
0320: 20 20 7b 7d 20 20 20 20 20 20 20 20 20 20 20 20    {}            
0330: 20 7b 72 65 74 75 72 6e 7d 0a 70 72 6f 63 20 66   {return}.proc f
0340: 6d 74 5f 6e 75 6d 70 61 73 73 65 73 20 20 20 20  mt_numpasses    
0350: 20 7b 7d 20 20 20 20 20 20 20 20 20 20 20 20 20   {}             
0360: 7b 72 65 74 75 72 6e 20 32 7d 0a 70 72 6f 63 20  {return 2}.proc 
0370: 66 6d 74 5f 70 6f 73 74 70 72 6f 63 65 73 73 20  fmt_postprocess 
0380: 20 20 7b 74 65 78 74 7d 20 20 20 20 20 20 20 20    {text}        
0390: 20 7b 72 65 74 75 72 6e 20 24 74 65 78 74 7d 0a   {return $text}.
03a0: 70 72 6f 63 20 66 6d 74 5f 70 6c 61 69 6e 5f 74  proc fmt_plain_t
03b0: 65 78 74 20 20 20 20 7b 74 65 78 74 7d 20 20 20  ext    {text}   
03c0: 20 20 20 20 20 20 7b 72 65 74 75 72 6e 20 24 74        {return $t
03d0: 65 78 74 7d 0a 70 72 6f 63 20 66 6d 74 5f 6c 69  ext}.proc fmt_li
03e0: 73 74 76 61 72 69 61 62 6c 65 73 20 7b 7d 20 20  stvariables {}  
03f0: 20 20 20 20 20 20 20 20 20 20 20 7b 72 65 74 75             {retu
0400: 72 6e 20 7b 7d 7d 0a 70 72 6f 63 20 66 6d 74 5f  rn {}}.proc fmt_
0410: 76 61 72 73 65 74 20 20 20 20 20 20 20 20 7b 76  varset        {v
0420: 61 72 6e 61 6d 65 20 74 65 78 74 7d 20 7b 72 65  arname text} {re
0430: 74 75 72 6e 7d 0a 0a 70 72 6f 63 20 66 6d 74 5f  turn}..proc fmt_
0440: 73 65 74 75 70 20 7b 6e 7d 20 7b 0a 20 20 20 20  setup {n} {.    
0450: 23 20 43 61 6c 6c 65 64 20 74 6f 20 73 65 74 75  # Called to setu
0460: 70 20 61 20 70 61 73 73 20 74 68 72 6f 75 67 68  p a pass through
0470: 20 74 68 65 20 69 6e 70 75 74 2e 0a 0a 20 20 20   the input...   
0480: 20 67 6c 6f 62 61 6c 20 73 74 61 74 65 0a 20 20   global state.  
0490: 20 20 73 65 74 20 20 20 20 73 74 61 74 65 28 70    set    state(p
04a0: 61 73 73 29 20 20 24 6e 20 20 3b 20 23 20 57 65  ass)  $n  ; # We
04b0: 20 61 72 65 20 69 6e 20 70 61 73 73 20 27 6e 27   are in pass 'n'
04c0: 20 74 68 72 6f 75 67 68 20 74 68 65 20 74 65 78   through the tex
04d0: 74 2e 0a 20 20 20 20 73 65 74 20 20 20 20 73 74  t..    set    st
04e0: 61 74 65 28 62 65 67 75 6e 29 20 30 20 20 20 3b  ate(begun) 0   ;
04f0: 20 23 20 4e 6f 20 6d 61 6e 70 61 67 65 5f 62 65   # No manpage_be
0500: 67 69 6e 20 79 65 74 0a 0a 20 20 20 20 69 66 20  gin yet..    if 
0510: 7b 24 6e 20 3d 3d 20 31 7d 20 7b 63 5f 78 72 65  {$n == 1} {c_xre
0520: 66 5f 69 6e 69 74 7d 0a 0a 20 20 20 20 53 65 74  f_init}..    Set
0530: 50 61 73 73 50 72 6f 63 73 20 24 6e 0a 20 20 20  PassProcs $n.   
0540: 20 72 65 74 75 72 6e 0a 7d 0a 0a 23 23 23 23 23   return.}..#####
0550: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0560: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0570: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0580: 23 23 23 23 23 23 23 23 23 23 23 0a 23 20 46 75  ###########.# Fu
0590: 6e 63 74 69 6f 6e 73 20 6d 61 64 65 20 61 76 61  nctions made ava
05a0: 69 6c 61 62 6c 65 20 74 6f 20 74 68 65 20 66 6f  ilable to the fo
05b0: 72 6d 61 74 74 65 72 20 74 6f 20 61 63 63 65 73  rmatter to acces
05c0: 73 20 74 68 65 20 63 6f 6d 6d 6f 6e 0a 23 20 73  s the common.# s
05d0: 74 61 74 65 20 6d 61 6e 61 67 65 64 20 68 65 72  tate managed her
05e0: 65 2e 0a 0a 70 72 6f 63 20 63 5f 69 6e 70 61 73  e...proc c_inpas
05f0: 73 20 7b 7d 20 7b 67 6c 6f 62 61 6c 20 73 74 61  s {} {global sta
0600: 74 65 20 3b 20 72 65 74 75 72 6e 20 24 73 74 61  te ; return $sta
0610: 74 65 28 70 61 73 73 29 7d 0a 0a 70 72 6f 63 20  te(pass)}..proc 
0620: 63 5f 62 65 67 69 6e 20 7b 7d 20 7b 67 6c 6f 62  c_begin {} {glob
0630: 61 6c 20 73 74 61 74 65 20 3b 20 73 65 74 20 20  al state ; set  
0640: 20 20 20 73 74 61 74 65 28 62 65 67 75 6e 29 20     state(begun) 
0650: 31 20 3b 20 72 65 74 75 72 6e 7d 0a 70 72 6f 63  1 ; return}.proc
0660: 20 63 5f 62 65 67 75 6e 20 7b 7d 20 7b 67 6c 6f   c_begun {} {glo
0670: 62 61 6c 20 73 74 61 74 65 20 3b 20 72 65 74 75  bal state ; retu
0680: 72 6e 20 24 73 74 61 74 65 28 62 65 67 75 6e 29  rn $state(begun)
0690: 7d 0a 0a 70 72 6f 63 20 63 5f 67 65 74 5f 6d 6f  }..proc c_get_mo
06a0: 64 75 6c 65 20 7b 7d 20 20 20 20 20 7b 67 6c 6f  dule {}     {glo
06b0: 62 61 6c 20 73 74 61 74 65 20 3b 20 72 65 74 75  bal state ; retu
06c0: 72 6e 20 24 73 74 61 74 65 28 6d 64 65 73 63 29  rn $state(mdesc)
06d0: 7d 0a 70 72 6f 63 20 63 5f 73 65 74 5f 6d 6f 64  }.proc c_set_mod
06e0: 75 6c 65 20 7b 74 65 78 74 7d 20 7b 67 6c 6f 62  ule {text} {glob
06f0: 61 6c 20 73 74 61 74 65 20 3b 20 73 65 74 20 20  al state ; set  
0700: 20 20 20 73 74 61 74 65 28 6d 64 65 73 63 29 20     state(mdesc) 
0710: 24 74 65 78 74 20 3b 20 72 65 74 75 72 6e 7d 0a  $text ; return}.
0720: 0a 70 72 6f 63 20 63 5f 73 65 74 5f 74 69 74 6c  .proc c_set_titl
0730: 65 20 7b 74 65 78 74 7d 20 7b 67 6c 6f 62 61 6c  e {text} {global
0740: 20 73 74 61 74 65 20 3b 20 73 65 74 20 73 74 61   state ; set sta
0750: 74 65 28 74 64 65 73 63 29 20 24 74 65 78 74 20  te(tdesc) $text 
0760: 3b 20 72 65 74 75 72 6e 7d 0a 70 72 6f 63 20 63  ; return}.proc c
0770: 5f 67 65 74 5f 74 69 74 6c 65 20 7b 7d 20 7b 0a  _get_title {} {.
0780: 20 20 20 20 67 6c 6f 62 61 6c 20 73 74 61 74 65      global state
0790: 0a 20 20 20 20 69 66 20 7b 21 5b 69 6e 66 6f 20  .    if {![info 
07a0: 65 78 69 73 74 73 20 73 74 61 74 65 28 74 64 65  exists state(tde
07b0: 73 63 29 5d 7d 20 7b 0a 09 72 65 74 75 72 6e 20  sc)]} {..return 
07c0: 24 73 74 61 74 65 28 6d 64 65 73 63 29 0a 20 20  $state(mdesc).  
07d0: 20 20 7d 0a 20 20 20 20 72 65 74 75 72 6e 20 24    }.    return $
07e0: 73 74 61 74 65 28 74 64 65 73 63 29 0a 7d 0a 0a  state(tdesc).}..
07f0: 70 72 6f 63 20 63 5f 63 6f 70 79 72 69 67 68 74  proc c_copyright
0800: 73 79 6d 62 6f 6c 20 7b 7d 20 7b 72 65 74 75 72  symbol {} {retur
0810: 6e 20 22 28 63 29 22 7d 0a 70 72 6f 63 20 63 5f  n "(c)"}.proc c_
0820: 73 65 74 5f 63 6f 70 79 72 69 67 68 74 20 7b 74  set_copyright {t
0830: 65 78 74 7d 20 7b 67 6c 6f 62 61 6c 20 73 74 61  ext} {global sta
0840: 74 65 20 3b 20 6c 61 70 70 65 6e 64 20 73 74 61  te ; lappend sta
0850: 74 65 28 63 6f 70 79 72 69 67 68 74 29 20 24 74  te(copyright) $t
0860: 65 78 74 20 3b 20 72 65 74 75 72 6e 7d 0a 70 72  ext ; return}.pr
0870: 6f 63 20 63 5f 67 65 74 5f 63 6f 70 79 72 69 67  oc c_get_copyrig
0880: 68 74 20 7b 7d 20 20 20 20 20 7b 0a 20 20 20 20  ht {}     {.    
0890: 67 6c 6f 62 61 6c 20 73 74 61 74 65 0a 0a 20 20  global state..  
08a0: 20 20 73 65 74 20 63 63 20 24 73 74 61 74 65 28    set cc $state(
08b0: 63 6f 70 79 72 69 67 68 74 29 0a 20 20 20 20 69  copyright).    i
08c0: 66 20 7b 24 63 63 20 3d 3d 20 7b 7d 7d 20 7b 73  f {$cc == {}} {s
08d0: 65 74 20 63 63 20 5b 64 74 5f 63 6f 70 79 72 69  et cc [dt_copyri
08e0: 67 68 74 5d 7d 0a 20 20 20 20 69 66 20 7b 24 63  ght]}.    if {$c
08f0: 63 20 3d 3d 20 7b 7d 7d 20 7b 72 65 74 75 72 6e  c == {}} {return
0900: 20 7b 7d 7d 0a 0a 20 20 20 20 72 65 74 75 72 6e   {}}..    return
0910: 20 22 43 6f 70 79 72 69 67 68 74 20 5b 63 5f 63   "Copyright [c_c
0920: 6f 70 79 72 69 67 68 74 73 79 6d 62 6f 6c 5d 20  opyrightsymbol] 
0930: 5b 6a 6f 69 6e 20 24 63 63 20 22 5c 6e 43 6f 70  [join $cc "\nCop
0940: 79 72 69 67 68 74 20 5b 63 5f 63 6f 70 79 72 69  yright [c_copyri
0950: 67 68 74 73 79 6d 62 6f 6c 5d 20 22 5d 22 0a 7d  ghtsymbol] "]".}
0960: 0a 0a 70 72 6f 63 20 63 5f 70 72 6f 76 65 6e 61  ..proc c_provena
0970: 6e 63 65 20 7b 7d 20 7b 0a 20 20 20 20 72 65 74  nce {} {.    ret
0980: 75 72 6e 20 22 47 65 6e 65 72 61 74 65 64 20 66  urn "Generated f
0990: 72 6f 6d 20 66 69 6c 65 20 27 5b 64 74 5f 66 69  rom file '[dt_fi
09a0: 6c 65 5d 27 20 62 79 20 74 63 6c 6c 69 62 2f 64  le]' by tcllib/d
09b0: 6f 63 74 6f 6f 6c 73 20 77 69 74 68 20 66 6f 72  octools with for
09c0: 6d 61 74 20 27 5b 64 74 5f 66 6f 72 6d 61 74 5d  mat '[dt_format]
09d0: 27 22 0a 7d 0a 0a 23 23 23 23 23 23 23 23 23 23  '".}..##########
09e0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
09f0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0a00: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0a10: 23 23 23 23 23 23 0a 23 20 4d 61 6e 61 67 65 20  ######.# Manage 
0a20: 70 61 73 73 2d 64 65 70 65 6e 64 65 6e 74 20 70  pass-dependent p
0a30: 72 6f 63 65 64 75 72 65 20 64 65 66 69 6e 69 74  rocedure definit
0a40: 69 6f 6e 73 2e 0a 0a 67 6c 6f 62 61 6c 20 50 61  ions...global Pa
0a50: 73 73 50 72 6f 63 73 0a 0a 23 20 70 61 73 73 20  ssProcs..# pass 
0a60: 24 70 61 73 73 4e 6f 20 70 72 6f 63 4e 61 6d 65  $passNo procName
0a70: 20 70 72 6f 63 41 72 67 73 20 7b 20 62 6f 64 79   procArgs { body
0a80: 20 20 7d 20 2d 2d 0a 23 09 53 70 65 63 69 66 69    } --.#.Specifi
0a90: 65 73 20 70 72 6f 63 65 64 75 72 65 20 64 65 66  es procedure def
0aa0: 69 6e 69 74 69 6f 6e 20 66 6f 72 20 70 61 73 73  inition for pass
0ab0: 20 24 6e 2e 0a 23 0a 70 72 6f 63 20 63 5f 70 61   $n..#.proc c_pa
0ac0: 73 73 20 7b 70 61 73 73 20 70 72 6f 63 20 61 72  ss {pass proc ar
0ad0: 67 75 6d 65 6e 74 73 20 62 6f 64 79 7d 20 7b 0a  guments body} {.
0ae0: 20 20 20 20 67 6c 6f 62 61 6c 20 20 50 61 73 73      global  Pass
0af0: 50 72 6f 63 73 0a 20 20 20 20 6c 61 70 70 65 6e  Procs.    lappen
0b00: 64 20 50 61 73 73 50 72 6f 63 73 28 24 70 61 73  d PassProcs($pas
0b10: 73 29 20 24 70 72 6f 63 20 24 61 72 67 75 6d 65  s) $proc $argume
0b20: 6e 74 73 20 24 62 6f 64 79 0a 7d 0a 70 72 6f 63  nts $body.}.proc
0b30: 20 53 65 74 50 61 73 73 50 72 6f 63 73 20 7b 70   SetPassProcs {p
0b40: 61 73 73 7d 20 7b 0a 20 20 20 20 67 6c 6f 62 61  ass} {.    globa
0b50: 6c 20 50 61 73 73 50 72 6f 63 73 0a 20 20 20 20  l PassProcs.    
0b60: 66 6f 72 65 61 63 68 20 7b 70 72 6f 63 20 61 72  foreach {proc ar
0b70: 67 73 20 62 6f 64 79 7d 20 24 50 61 73 73 50 72  gs body} $PassPr
0b80: 6f 63 73 28 24 70 61 73 73 29 20 7b 0a 09 70 72  ocs($pass) {..pr
0b90: 6f 63 20 24 70 72 6f 63 20 24 61 72 67 73 20 24  oc $proc $args $
0ba0: 62 6f 64 79 0a 20 20 20 20 7d 0a 7d 0a 0a 0a 23  body.    }.}...#
0bb0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0bc0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0bd0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0be0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 0a  ###############.
0bf0: 23 20 4d 61 6e 61 67 65 20 61 20 73 65 74 20 6f  # Manage a set o
0c00: 66 20 62 75 66 66 65 72 73 20 74 6f 20 68 6f 6c  f buffers to hol
0c10: 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 62 65  d information be
0c20: 74 77 65 65 6e 20 70 61 73 73 65 73 2e 0a 23 20  tween passes..# 
0c30: 45 61 63 68 20 62 75 66 66 65 72 20 68 6f 6c 64  Each buffer hold
0c40: 73 20 61 20 6c 69 73 74 20 6f 66 20 6c 69 6e 65  s a list of line
0c50: 73 2e 0a 0a 67 6c 6f 62 61 6c 20 42 75 66 66 65  s...global Buffe
0c60: 72 73 0a 0a 23 20 68 6f 6c 64 42 75 66 66 65 72  rs..# holdBuffer
0c70: 73 20 62 75 66 66 65 72 20 3f 20 62 75 66 66 65  s buffer ? buffe
0c80: 72 20 2e 2e 2e 3f 20 2d 2d 0a 23 09 44 65 63 6c  r ...? --.#.Decl
0c90: 61 72 65 20 61 20 6c 69 73 74 20 6f 66 20 68 6f  are a list of ho
0ca0: 6c 64 20 62 75 66 66 65 72 73 2c 0a 23 09 74 6f  ld buffers,.#.to
0cb0: 20 63 6f 6c 6c 65 63 74 20 64 61 74 61 20 69 6e   collect data in
0cc0: 20 6f 6e 65 20 70 61 73 73 20 61 6e 64 20 6f 75   one pass and ou
0cd0: 74 70 75 74 20 69 74 20 6c 61 74 65 72 2e 0a 23  tput it later..#
0ce0: 0a 70 72 6f 63 20 63 5f 68 6f 6c 64 42 75 66 66  .proc c_holdBuff
0cf0: 65 72 73 20 7b 61 72 67 73 7d 20 7b 0a 20 20 20  ers {args} {.   
0d00: 20 67 6c 6f 62 61 6c 20 42 75 66 66 65 72 73 0a   global Buffers.
0d10: 20 20 20 20 66 6f 72 65 61 63 68 20 61 72 67 20      foreach arg 
0d20: 24 61 72 67 73 20 7b 0a 09 73 65 74 20 42 75 66  $args {..set Buf
0d30: 66 65 72 73 28 24 61 72 67 29 20 5b 6c 69 73 74  fers($arg) [list
0d40: 5d 0a 20 20 20 20 7d 0a 7d 0a 0a 70 72 6f 63 20  ].    }.}..proc 
0d50: 63 5f 68 6f 6c 64 52 65 6d 6f 76 65 20 7b 61 72  c_holdRemove {ar
0d60: 67 73 7d 20 7b 0a 20 20 20 20 67 6c 6f 62 61 6c  gs} {.    global
0d70: 20 42 75 66 66 65 72 73 0a 20 20 20 20 66 6f 72   Buffers.    for
0d80: 65 61 63 68 20 61 72 67 20 24 61 72 67 73 20 7b  each arg $args {
0d90: 0a 09 63 61 74 63 68 20 7b 75 6e 73 65 74 20 42  ..catch {unset B
0da0: 75 66 66 65 72 73 28 24 61 72 67 29 7d 0a 20 20  uffers($arg)}.  
0db0: 20 20 7d 0a 20 20 20 20 72 65 74 75 72 6e 0a 7d    }.    return.}
0dc0: 0a 0a 23 20 68 6f 6c 64 20 62 75 66 66 65 72 20  ..# hold buffer 
0dd0: 74 65 78 74 20 2d 2d 0a 23 09 41 70 70 65 6e 64  text --.#.Append
0de0: 20 74 65 78 74 20 74 6f 20 6e 61 6d 65 64 20 62   text to named b
0df0: 75 66 66 65 72 0a 23 0a 70 72 6f 63 20 63 5f 68  uffer.#.proc c_h
0e00: 6f 6c 64 20 7b 62 75 66 66 65 72 20 65 6e 74 72  old {buffer entr
0e10: 79 7d 20 7b 0a 20 20 20 20 67 6c 6f 62 61 6c 20  y} {.    global 
0e20: 20 42 75 66 66 65 72 73 0a 20 20 20 20 6c 61 70   Buffers.    lap
0e30: 70 65 6e 64 20 42 75 66 66 65 72 73 28 24 62 75  pend Buffers($bu
0e40: 66 66 65 72 29 20 24 65 6e 74 72 79 0a 0a 20 20  ffer) $entry..  
0e50: 20 20 23 70 75 74 73 20 22 24 62 75 66 66 65 72    #puts "$buffer
0e60: 20 2d 2d 20 24 65 6e 74 72 79 22 0a 20 20 20 20   -- $entry".    
0e70: 72 65 74 75 72 6e 0a 7d 0a 0a 70 72 6f 63 20 63  return.}..proc c
0e80: 5f 68 6f 6c 64 69 6e 67 20 7b 62 75 66 66 65 72  _holding {buffer
0e90: 7d 20 7b 0a 20 20 20 20 67 6c 6f 62 61 6c 20 20  } {.    global  
0ea0: 42 75 66 66 65 72 73 0a 20 20 20 20 73 65 74 20  Buffers.    set 
0eb0: 6c 20 30 0a 20 20 20 20 63 61 74 63 68 20 7b 73  l 0.    catch {s
0ec0: 65 74 20 6c 20 5b 6c 6c 65 6e 67 74 68 20 24 42  et l [llength $B
0ed0: 75 66 66 65 72 73 28 24 62 75 66 66 65 72 29 5d  uffers($buffer)]
0ee0: 7d 0a 20 20 20 20 72 65 74 75 72 6e 20 24 6c 0a  }.    return $l.
0ef0: 7d 0a 0a 23 20 68 65 6c 64 20 62 75 66 66 65 72  }..# held buffer
0f00: 20 2d 2d 0a 23 09 52 65 74 75 72 6e 73 20 63 75   --.#.Returns cu
0f10: 72 72 65 6e 74 20 63 6f 6e 74 65 6e 74 73 20 6f  rrent contents o
0f20: 66 20 6e 61 6d 65 64 20 62 75 66 66 65 72 20 61  f named buffer a
0f30: 6e 64 20 65 6d 70 74 79 20 74 68 65 20 62 75 66  nd empty the buf
0f40: 66 65 72 2e 0a 23 0a 70 72 6f 63 20 63 5f 68 65  fer..#.proc c_he
0f50: 6c 64 20 7b 62 75 66 66 65 72 7d 20 7b 0a 20 20  ld {buffer} {.  
0f60: 20 20 67 6c 6f 62 61 6c 20 42 75 66 66 65 72 73    global Buffers
0f70: 0a 20 20 20 20 73 65 74 20 63 6f 6e 74 65 6e 74  .    set content
0f80: 20 5b 6a 6f 69 6e 20 24 42 75 66 66 65 72 73 28   [join $Buffers(
0f90: 24 62 75 66 66 65 72 29 20 22 5c 6e 22 5d 0a 20  $buffer) "\n"]. 
0fa0: 20 20 20 73 65 74 20 42 75 66 66 65 72 73 28 24     set Buffers($
0fb0: 62 75 66 66 65 72 29 20 5b 6c 69 73 74 5d 0a 20  buffer) [list]. 
0fc0: 20 20 20 72 65 74 75 72 6e 20 24 63 6f 6e 74 65     return $conte
0fd0: 6e 74 0a 7d 0a 0a 23 23 23 23 23 23 23 23 23 23  nt.}..##########
0fe0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
0ff0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
1000: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
1010: 23 23 23 23 23 23 23 23 23 23 23 23 0a 23 20 4e  ############.# N
1020: 65 73 74 65 64 20 63 6f 75 6e 74 65 72 0a 0a 67  ested counter..g
1030: 6c 6f 62 61 6c 20 63 6f 75 6e 74 65 72 73 20 63  lobal counters c
1040: 6e 74 0a 73 65 74 20 20 20 20 63 6f 75 6e 74 65  nt.set    counte
1050: 72 73 20 5b 6c 69 73 74 5d 0a 73 65 74 20 20 20  rs [list].set   
1060: 20 63 6e 74 20 30 0a 0a 70 72 6f 63 20 63 5f 63   cnt 0..proc c_c
1070: 6e 65 78 74 20 7b 7d 20 7b 67 6c 6f 62 61 6c 20  next {} {global 
1080: 63 6e 74 20 3b 20 69 6e 63 72 20 63 6e 74 7d 0a  cnt ; incr cnt}.
1090: 70 72 6f 63 20 63 5f 63 69 6e 69 74 20 7b 7d 20  proc c_cinit {} 
10a0: 7b 0a 20 20 20 20 67 6c 6f 62 61 6c 20 63 6f 75  {.    global cou
10b0: 6e 74 65 72 73 20 63 6e 74 0a 20 20 20 20 73 65  nters cnt.    se
10c0: 74 20 63 6f 75 6e 74 65 72 73 20 5b 6c 69 6e 73  t counters [lins
10d0: 65 72 74 20 24 63 6f 75 6e 74 65 72 73 20 30 20  ert $counters 0 
10e0: 24 63 6e 74 5d 0a 20 20 20 20 73 65 74 20 63 6e  $cnt].    set cn
10f0: 74 20 20 20 20 20 20 30 0a 20 20 20 20 72 65 74  t      0.    ret
1100: 75 72 6e 0a 7d 0a 70 72 6f 63 20 63 5f 63 72 65  urn.}.proc c_cre
1110: 73 65 74 20 7b 7d 20 7b 0a 20 20 20 20 67 6c 6f  set {} {.    glo
1120: 62 61 6c 20 63 6f 75 6e 74 65 72 73 20 63 6e 74  bal counters cnt
1130: 0a 20 20 20 20 73 65 74 20 63 6e 74 20 20 20 20  .    set cnt    
1140: 20 20 5b 6c 69 6e 64 65 78 20 24 63 6f 75 6e 74    [lindex $count
1150: 65 72 73 20 30 5d 0a 20 20 20 20 73 65 74 20 63  ers 0].    set c
1160: 6f 75 6e 74 65 72 73 20 5b 6c 72 61 6e 67 65 20  ounters [lrange 
1170: 24 63 6f 75 6e 74 65 72 73 20 31 20 65 6e 64 5d  $counters 1 end]
1180: 0a 20 20 20 20 72 65 74 75 72 6e 0a 7d 0a 0a 0a  .    return.}...
1190: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
11a0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
11b0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
11c0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
11d0: 23 23 23 23 23 23 0a 23 20 55 74 69 6c 69 74 69  ######.# Utiliti
11e0: 65 73 2e 0a 23 0a 0a 70 72 6f 63 20 4e 4f 50 20  es..#..proc NOP 
11f0: 7b 61 72 67 73 7d 20 7b 20 7d 09 09 3b 23 20 64  {args} { }..;# d
1200: 6f 20 6e 6f 74 68 69 6e 67 0a 70 72 6f 63 20 4e  o nothing.proc N
1210: 59 49 20 7b 7b 6d 65 73 73 61 67 65 20 7b 7d 7d  YI {{message {}}
1220: 7d 20 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 2d  } {.    return -
1230: 63 6f 64 65 20 65 72 72 6f 72 20 5b 61 70 70 65  code error [appe
1240: 6e 64 20 6d 65 73 73 61 67 65 20 22 20 4e 6f 74  nd message " Not
1250: 20 59 65 74 20 49 6d 70 6c 65 6d 65 6e 74 65 64   Yet Implemented
1260: 22 5d 0a 7d 0a 0a 23 23 23 23 23 23 23 23 23 23  "].}..##########
1270: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
1280: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
1290: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
12a0: 23 23 23 23 23 23 23 23 23 23 23 23 0a 23 20 43  ############.# C
12b0: 72 6f 73 73 2d 72 65 66 65 72 65 6e 63 65 20 74  ross-reference t
12c0: 72 61 63 6b 69 6e 67 20 28 66 6f 72 20 61 20 73  racking (for a s
12d0: 69 6e 67 6c 65 20 66 69 6c 65 29 2e 0a 23 0a 67  ingle file)..#.g
12e0: 6c 6f 62 61 6c 20 53 65 63 74 69 6f 6e 4e 61 6d  lobal SectionNam
12f0: 65 73 09 3b 23 20 61 72 72 61 79 20 6d 61 70 70  es.;# array mapp
1300: 69 6e 67 20 27 73 65 63 74 69 6f 6e 20 6e 61 6d  ing 'section nam
1310: 65 27 20 74 6f 20 27 72 65 66 65 72 65 6e 63 65  e' to 'reference
1320: 20 69 64 27 0a 67 6c 6f 62 61 6c 20 53 65 63 74   id'.global Sect
1330: 69 6f 6e 4c 69 73 74 20 20 20 20 20 20 3b 23 20  ionList      ;# 
1340: 4c 69 73 74 20 6f 66 20 73 65 63 74 69 6f 6e 73  List of sections
1350: 2c 20 74 68 65 69 72 20 69 64 73 2c 20 61 6e 64  , their ids, and
1360: 20 6c 65 76 65 6c 73 2c 20 69 6e 0a 73 65 74 20   levels, in.set 
1370: 20 20 20 53 65 63 74 69 6f 6e 4c 69 73 74 20 7b     SectionList {
1380: 7d 20 20 20 3b 23 20 6f 72 64 65 72 20 6f 66 20  }   ;# order of 
1390: 64 65 66 69 6e 69 74 69 6f 6e 2e 0a 0a 23 20 73  definition...# s
13a0: 65 63 74 69 6f 6e 49 64 20 2d 2d 0a 23 09 46 6f  ectionId --.#.Fo
13b0: 72 6d 61 74 20 73 65 63 74 69 6f 6e 20 6e 61 6d  rmat section nam
13c0: 65 20 61 73 20 61 6e 20 58 4d 4c 20 49 44 2e 0a  e as an XML ID..
13d0: 23 0a 70 72 6f 63 20 63 5f 73 65 63 74 69 6f 6e  #.proc c_section
13e0: 49 64 20 7b 6e 61 6d 65 7d 20 7b 0a 20 20 20 20  Id {name} {.    
13f0: 23 20 49 64 65 6e 74 69 63 61 6c 20 74 6f 20 27  # Identical to '
1400: 5f 5f 73 69 64 27 20 69 6e 20 63 68 65 63 6b 65  __sid' in checke
1410: 72 2e 74 63 6c 0a 20 20 20 20 72 65 67 73 75 62  r.tcl.    regsub
1420: 20 2d 61 6c 6c 20 7b 5b 20 09 5d 2b 7d 20 5b 73   -all {[ .]+} [s
1430: 74 72 69 6e 67 20 74 6f 6c 6f 77 65 72 20 5b 73  tring tolower [s
1440: 74 72 69 6e 67 20 74 72 69 6d 20 24 6e 61 6d 65  tring trim $name
1450: 5d 5d 20 5f 20 69 64 0a 20 20 20 20 72 65 67 73  ]] _ id.    regs
1460: 75 62 20 2d 61 6c 6c 20 7b 22 7d 20 24 69 64 20  ub -all {"} $id 
1470: 5f 20 69 64 20 3b 20 23 20 22 0a 20 20 20 20 72  _ id ; # ".    r
1480: 65 74 75 72 6e 20 24 69 64 0a 7d 0a 0a 23 20 70  eturn $id.}..# p
1490: 6f 73 73 69 62 6c 65 52 65 66 65 72 65 6e 63 65  ossibleReference
14a0: 20 74 65 78 74 20 67 69 20 2d 2d 0a 23 09 43 68   text gi --.#.Ch
14b0: 65 63 6b 20 69 66 20 24 74 65 78 74 20 69 73 20  eck if $text is 
14c0: 61 20 70 6f 74 65 6e 74 69 61 6c 20 63 72 6f 73  a potential cros
14d0: 73 2d 72 65 66 65 72 65 6e 63 65 3b 0a 23 09 69  s-reference;.#.i
14e0: 66 20 73 6f 2c 20 66 6f 72 6d 61 74 20 61 73 20  f so, format as 
14f0: 61 20 72 65 66 65 72 65 6e 63 65 3b 0a 23 09 6f  a reference;.#.o
1500: 74 68 65 72 77 69 73 65 20 66 6f 72 6d 61 74 20  therwise format 
1510: 61 73 20 61 20 24 67 69 20 65 6c 65 6d 65 6e 74  as a $gi element
1520: 2e 0a 23 0a 70 72 6f 63 20 63 5f 70 6f 73 73 69  ..#.proc c_possi
1530: 62 6c 65 52 65 66 65 72 65 6e 63 65 20 7b 74 65  bleReference {te
1540: 78 74 20 67 69 20 7b 6c 61 62 65 6c 20 7b 7d 7d  xt gi {label {}}
1550: 7d 20 7b 0a 20 20 20 20 67 6c 6f 62 61 6c 20 53  } {.    global S
1560: 65 63 74 69 6f 6e 4e 61 6d 65 73 0a 20 20 20 20  ectionNames.    
1570: 69 66 20 7b 21 5b 73 74 72 69 6e 67 20 6c 65 6e  if {![string len
1580: 67 74 68 20 24 6c 61 62 65 6c 5d 7d 20 7b 73 65  gth $label]} {se
1590: 74 20 6c 61 62 65 6c 20 24 74 65 78 74 7d 0a 20  t label $text}. 
15a0: 20 20 20 73 65 74 20 69 64 20 5b 63 5f 73 65 63     set id [c_sec
15b0: 74 69 6f 6e 49 64 20 24 74 65 78 74 5d 0a 20 20  tionId $text].  
15c0: 20 20 69 66 20 7b 5b 69 6e 66 6f 20 65 78 69 73    if {[info exis
15d0: 74 73 20 53 65 63 74 69 6f 6e 4e 61 6d 65 73 28  ts SectionNames(
15e0: 24 69 64 29 5d 7d 20 7b 0a 20 20 20 20 09 72 65  $id)]} {.    .re
15f0: 74 75 72 6e 20 22 5b 73 74 61 72 74 54 61 67 20  turn "[startTag 
1600: 72 65 66 20 72 65 66 69 64 20 24 69 64 5d 24 6c  ref refid $id]$l
1610: 61 62 65 6c 5b 65 6e 64 54 61 67 20 72 65 66 5d  abel[endTag ref]
1620: 22 0a 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a 20  ".    } else {. 
1630: 20 20 20 09 72 65 74 75 72 6e 20 5b 77 72 61 70     .return [wrap
1640: 20 24 6c 61 62 65 6c 20 24 67 69 5d 0a 20 20 20   $label $gi].   
1650: 20 7d 0a 7d 0a 0a 70 72 6f 63 20 63 5f 6e 65 77   }.}..proc c_new
1660: 53 65 63 74 69 6f 6e 20 7b 6e 61 6d 65 20 6c 65  Section {name le
1670: 76 65 6c 20 6c 6f 63 61 74 69 6f 6e 20 7b 69 64  vel location {id
1680: 20 7b 7d 7d 7d 20 7b 0a 20 20 20 20 67 6c 6f 62   {}}} {.    glob
1690: 61 6c 20 53 65 63 74 69 6f 6e 4c 69 73 74 20 53  al SectionList S
16a0: 65 63 74 69 6f 6e 4e 61 6d 65 73 0a 20 20 20 20  ectionNames.    
16b0: 69 66 20 7b 24 69 64 20 3d 3d 20 7b 7d 7d 20 7b  if {$id == {}} {
16c0: 0a 09 73 65 74 20 69 64 20 5b 63 5f 73 65 63 74  ..set id [c_sect
16d0: 69 6f 6e 49 64 20 24 6e 61 6d 65 5d 0a 20 20 20  ionId $name].   
16e0: 20 7d 0a 20 20 20 20 73 65 74 20 53 65 63 74 69   }.    set Secti
16f0: 6f 6e 4e 61 6d 65 73 28 24 69 64 29 20 2e 0a 20  onNames($id) .. 
1700: 20 20 20 73 65 74 20 53 65 63 74 69 6f 6e 4c 69     set SectionLi
1710: 73 74 20 5b 6c 69 6e 73 65 72 74 20 24 53 65 63  st [linsert $Sec
1720: 74 69 6f 6e 4c 69 73 74 20 24 6c 6f 63 61 74 69  tionList $locati
1730: 6f 6e 20 24 6e 61 6d 65 20 24 69 64 20 24 6c 65  on $name $id $le
1740: 76 65 6c 5d 0a 20 20 20 20 72 65 74 75 72 6e 0a  vel].    return.
1750: 7d 0a 0a 70 72 6f 63 20 63 5f 63 6c 72 53 65 63  }..proc c_clrSec
1760: 74 69 6f 6e 73 20 7b 7d 20 7b 0a 20 20 20 20 67  tions {} {.    g
1770: 6c 6f 62 61 6c 20 53 65 63 74 69 6f 6e 4c 69 73  lobal SectionLis
1780: 74 20 53 65 63 74 69 6f 6e 4e 61 6d 65 73 0a 20  t SectionNames. 
1790: 20 20 20 73 65 74 20 20 20 20 53 65 63 74 69 6f     set    Sectio
17a0: 6e 4c 69 73 74 20 7b 7d 0a 20 20 20 20 63 61 74  nList {}.    cat
17b0: 63 68 20 7b 75 6e 73 65 74 20 53 65 63 74 69 6f  ch {unset Sectio
17c0: 6e 4e 61 6d 65 73 7d 0a 7d 0a 0a 23 23 23 23 23  nNames}.}..#####
17d0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
17e0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
17f0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
1800: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
1810: 23 0a 23 20 43 6f 6e 76 65 72 73 69 6f 6e 20 73  #.# Conversion s
1820: 70 65 63 69 66 69 63 61 74 69 6f 6e 2e 0a 23 0a  pecification..#.
1830: 23 20 54 77 6f 2d 70 61 73 73 20 70 72 6f 63 65  # Two-pass proce
1840: 73 73 69 6e 67 2e 20 20 54 68 65 20 66 69 72 73  ssing.  The firs
1850: 74 20 70 61 73 73 20 63 6f 6c 6c 65 63 74 73 20  t pass collects 
1860: 74 65 78 74 20 66 6f 72 20 74 68 65 0a 23 20 53  text for the.# S
1870: 59 4e 4f 50 53 49 53 2c 20 53 45 45 20 41 4c 53  YNOPSIS, SEE ALS
1880: 4f 2c 20 61 6e 64 20 4b 45 59 57 4f 52 44 53 20  O, and KEYWORDS 
1890: 73 65 63 74 69 6f 6e 73 2c 20 61 6e 64 20 74 68  sections, and th
18a0: 65 20 73 65 63 6f 6e 64 20 70 61 73 73 0a 23 20  e second pass.# 
18b0: 70 72 6f 64 75 63 65 73 20 6f 75 74 70 75 74 2e  produces output.
18c0: 0a 23 0a 0a 63 5f 68 6f 6c 64 42 75 66 66 65 72  .#..c_holdBuffer
18d0: 73 20 73 79 6e 6f 70 73 69 73 20 73 65 65 5f 61  s synopsis see_a
18e0: 6c 73 6f 20 6b 65 79 77 6f 72 64 73 20 70 72 65  lso keywords pre
18f0: 63 6f 6d 6d 65 6e 74 73 20 63 61 74 65 67 6f 72  comments categor
1900: 79 0a 0a 23 23 23 23 23 23 23 23 23 23 23 23 23  y..#############
1910: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
1920: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
1930: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
1940: 23 23 23 0a 23 20 4d 61 6e 61 67 65 6d 65 6e 74  ###.# Management
1950: 20 6f 66 20 73 65 65 2d 61 6c 73 6f 20 61 6e 64   of see-also and
1960: 20 6b 65 79 77 6f 72 64 20 63 72 6f 73 73 2d 72   keyword cross-r
1970: 65 66 65 72 65 6e 63 65 73 0a 0a 70 72 6f 63 20  eferences..proc 
1980: 63 5f 78 72 65 66 5f 69 6e 69 74 20 7b 7d 20 7b  c_xref_init {} {
1990: 0a 20 20 20 20 67 6c 6f 62 61 6c 20 73 65 65 61  .    global seea
19a0: 6c 73 6f 20 20 73 65 65 61 6c 73 6f 5f 5f 20 20  lso  seealso__  
19b0: 3b 20 73 65 74 20 73 65 65 61 6c 73 6f 20 20 5b  ; set seealso  [
19c0: 6c 69 73 74 5d 20 3b 20 63 61 74 63 68 20 7b 75  list] ; catch {u
19d0: 6e 73 65 74 20 73 65 65 61 6c 73 6f 5f 5f 7d 20  nset seealso__} 
19e0: 20 3b 20 61 72 72 61 79 20 73 65 74 20 73 65 65   ; array set see
19f0: 61 6c 73 6f 5f 5f 20 20 7b 7d 0a 20 20 20 20 67  also__  {}.    g
1a00: 6c 6f 62 61 6c 20 6b 65 79 77 6f 72 64 73 20 6b  lobal keywords k
1a10: 65 79 77 6f 72 64 73 5f 5f 20 3b 20 73 65 74 20  eywords__ ; set 
1a20: 6b 65 79 77 6f 72 64 73 20 5b 6c 69 73 74 5d 20  keywords [list] 
1a30: 3b 20 63 61 74 63 68 20 7b 75 6e 73 65 74 20 6b  ; catch {unset k
1a40: 65 79 77 6f 72 64 73 5f 5f 7d 20 3b 20 61 72 72  eywords__} ; arr
1a50: 61 79 20 73 65 74 20 6b 65 79 77 6f 72 64 73 5f  ay set keywords_
1a60: 5f 20 7b 7d 0a 20 20 20 20 67 6c 6f 62 61 6c 20  _ {}.    global 
1a70: 63 61 74 65 67 6f 72 79 20 20 20 20 20 20 20 20  category        
1a80: 20 20 20 20 3b 20 73 65 74 20 63 61 74 65 67 6f      ; set catego
1a90: 72 79 20 22 22 0a 7d 0a 0a 70 72 6f 63 20 63 5f  ry "".}..proc c_
1aa0: 78 72 65 66 5f 73 65 65 61 6c 73 6f 20 20 7b 7d  xref_seealso  {}
1ab0: 20 7b 67 6c 6f 62 61 6c 20 73 65 65 61 6c 73 6f   {global seealso
1ac0: 20 20 3b 20 72 65 74 75 72 6e 20 24 73 65 65 61    ; return $seea
1ad0: 6c 73 6f 7d 0a 70 72 6f 63 20 63 5f 78 72 65 66  lso}.proc c_xref
1ae0: 5f 6b 65 79 77 6f 72 64 73 20 7b 7d 20 7b 67 6c  _keywords {} {gl
1af0: 6f 62 61 6c 20 6b 65 79 77 6f 72 64 73 20 3b 20  obal keywords ; 
1b00: 72 65 74 75 72 6e 20 24 6b 65 79 77 6f 72 64 73  return $keywords
1b10: 7d 0a 70 72 6f 63 20 63 5f 78 72 65 66 5f 63 61  }.proc c_xref_ca
1b20: 74 65 67 6f 72 79 20 7b 7d 20 7b 67 6c 6f 62 61  tegory {} {globa
1b30: 6c 20 63 61 74 65 67 6f 72 79 20 3b 20 72 65 74  l category ; ret
1b40: 75 72 6e 20 24 63 61 74 65 67 6f 72 79 7d 0a 0a  urn $category}..
1b50: 63 5f 70 61 73 73 20 31 20 66 6d 74 5f 63 61 74  c_pass 1 fmt_cat
1b60: 65 67 6f 72 79 20 7b 74 65 78 74 7d 20 7b 0a 20  egory {text} {. 
1b70: 20 20 20 67 6c 6f 62 61 6c 20 63 61 74 65 67 6f     global catego
1b80: 72 79 0a 20 20 20 20 73 65 74 20 20 20 20 63 61  ry.    set    ca
1b90: 74 65 67 6f 72 79 20 24 74 65 78 74 0a 20 20 20  tegory $text.   
1ba0: 20 72 65 74 75 72 6e 0a 7d 0a 0a 63 5f 70 61 73   return.}..c_pas
1bb0: 73 20 31 20 66 6d 74 5f 73 65 65 5f 61 6c 73 6f  s 1 fmt_see_also
1bc0: 20 7b 61 72 67 73 7d 20 7b 0a 20 20 20 20 67 6c   {args} {.    gl
1bd0: 6f 62 61 6c 20 73 65 65 61 6c 73 6f 20 73 65 65  obal seealso see
1be0: 61 6c 73 6f 5f 5f 0a 20 20 20 20 66 6f 72 65 61  also__.    forea
1bf0: 63 68 20 72 65 66 20 24 61 72 67 73 20 7b 0a 09  ch ref $args {..
1c00: 69 66 20 7b 5b 69 6e 66 6f 20 65 78 69 73 74 73  if {[info exists
1c10: 20 73 65 65 61 6c 73 6f 5f 5f 28 24 72 65 66 29   seealso__($ref)
1c20: 5d 7d 20 63 6f 6e 74 69 6e 75 65 0a 09 6c 61 70  ]} continue..lap
1c30: 70 65 6e 64 20 73 65 65 61 6c 73 6f 20 24 72 65  pend seealso $re
1c40: 66 0a 09 73 65 74 20 20 20 20 20 73 65 65 61 6c  f..set     seeal
1c50: 73 6f 5f 5f 28 24 72 65 66 29 20 2e 0a 20 20 20  so__($ref) ..   
1c60: 20 7d 0a 20 20 20 20 72 65 74 75 72 6e 0a 7d 0a   }.    return.}.
1c70: 0a 63 5f 70 61 73 73 20 31 20 66 6d 74 5f 6b 65  .c_pass 1 fmt_ke
1c80: 79 77 6f 72 64 73 20 7b 61 72 67 73 7d 20 7b 0a  ywords {args} {.
1c90: 20 20 20 20 67 6c 6f 62 61 6c 20 6b 65 79 77 6f      global keywo
1ca0: 72 64 73 20 6b 65 79 77 6f 72 64 73 5f 5f 0a 20  rds keywords__. 
1cb0: 20 20 20 66 6f 72 65 61 63 68 20 72 65 66 20 24     foreach ref $
1cc0: 61 72 67 73 20 7b 0a 09 69 66 20 7b 5b 69 6e 66  args {..if {[inf
1cd0: 6f 20 65 78 69 73 74 73 20 6b 65 79 77 6f 72 64  o exists keyword
1ce0: 73 5f 5f 28 24 72 65 66 29 5d 7d 20 63 6f 6e 74  s__($ref)]} cont
1cf0: 69 6e 75 65 0a 09 6c 61 70 70 65 6e 64 20 6b 65  inue..lappend ke
1d00: 79 77 6f 72 64 73 20 24 72 65 66 0a 09 73 65 74  ywords $ref..set
1d10: 20 20 20 20 20 6b 65 79 77 6f 72 64 73 5f 5f 28       keywords__(
1d20: 24 72 65 66 29 20 2e 0a 20 20 20 20 7d 0a 20 20  $ref) ..    }.  
1d30: 20 20 72 65 74 75 72 6e 0a 7d 0a 0a 63 5f 70 61    return.}..c_pa
1d40: 73 73 20 32 20 66 6d 74 5f 63 61 74 65 67 6f 72  ss 2 fmt_categor
1d50: 79 20 7b 61 72 67 73 7d 20 4e 4f 50 0a 63 5f 70  y {args} NOP.c_p
1d60: 61 73 73 20 32 20 66 6d 74 5f 73 65 65 5f 61 6c  ass 2 fmt_see_al
1d70: 73 6f 20 7b 61 72 67 73 7d 20 4e 4f 50 0a 63 5f  so {args} NOP.c_
1d80: 70 61 73 73 20 32 20 66 6d 74 5f 6b 65 79 77 6f  pass 2 fmt_keywo
1d90: 72 64 73 20 7b 61 72 67 73 7d 20 4e 4f 50 0a 0a  rds {args} NOP..
1da0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
1db0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
1dc0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
1dd0: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23  ################
1de0: 0a                                               .