/ Celestin Apprentice 4 / Apprentice-Release4.iso / Source Code / C / Applications / Python 1.3 / source code / Doc / libsgmllib.tex

< prev

next >

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 73 65 63 74 69 6f 6e | 7b 53 74 61 6e 64 61 72 |\section|{Standar|
|00000010| 64 20 4d 6f 64 75 6c 65 | 20 5c 73 65 63 74 63 6f |d Module| \sectco|
|00000020| 64 65 7b 73 67 6d 6c 6c | 69 62 7d 7d 0d 5c 73 74 |de{sgmll|ib}}.\st|
|00000030| 6d 6f 64 69 6e 64 65 78 | 7b 73 67 6d 6c 6c 69 62 |modindex|{sgmllib|
|00000040| 7d 0d 5c 69 6e 64 65 78 | 7b 53 47 4d 4c 7d 0d 0d |}.\index|{SGML}..|
|00000050| 5c 72 65 6e 65 77 63 6f | 6d 6d 61 6e 64 7b 5c 69 |\renewco|mmand{\i|
|00000060| 6e 64 65 78 73 75 62 69 | 74 65 6d 7d 7b 28 69 6e |ndexsubi|tem}{(in|
|00000070| 20 6d 6f 64 75 6c 65 20 | 73 67 6d 6c 6c 69 62 29 | module |sgmllib)|
|00000080| 7d 0d 0d 54 68 69 73 20 | 6d 6f 64 75 6c 65 20 64 |}..This |module d|
|00000090| 65 66 69 6e 65 73 20 61 | 20 63 6c 61 73 73 20 5c |efines a| class \|
|000000a0| 63 6f 64 65 7b 53 47 4d | 4c 50 61 72 73 65 72 7d |code{SGM|LParser}|
|000000b0| 20 77 68 69 63 68 20 73 | 65 72 76 65 73 20 61 73 | which s|erves as|
|000000c0| 20 74 68 65 0d 62 61 73 | 69 73 20 66 6f 72 20 70 | the.bas|is for p|
|000000d0| 61 72 73 69 6e 67 20 74 | 65 78 74 20 66 69 6c 65 |arsing t|ext file|
|000000e0| 73 20 66 6f 72 6d 61 74 | 74 65 64 20 69 6e 20 53 |s format|ted in S|
|000000f0| 47 4d 4c 20 28 53 74 61 | 6e 64 61 72 64 20 47 65 |GML (Sta|ndard Ge|
|00000100| 6e 65 72 61 6c 69 7a 65 | 64 0d 4d 61 72 6b 2d 75 |neralize|d.Mark-u|
|00000110| 70 20 4c 61 6e 67 75 61 | 67 65 29 2e 20 20 49 6e |p Langua|ge).  In|
|00000120| 20 66 61 63 74 2c 20 69 | 74 20 64 6f 65 73 20 6e | fact, i|t does n|
|00000130| 6f 74 20 70 72 6f 76 69 | 64 65 20 61 20 66 75 6c |ot provi|de a ful|
|00000140| 6c 20 53 47 4d 4c 20 70 | 61 72 73 65 72 0d 2d 2d |l SGML p|arser.--|
|00000150| 2d 20 69 74 20 6f 6e 6c | 79 20 70 61 72 73 65 73 |- it onl|y parses|
|00000160| 20 53 47 4d 4c 20 69 6e | 73 6f 66 61 72 20 61 73 | SGML in|sofar as|
|00000170| 20 69 74 20 69 73 20 75 | 73 65 64 20 62 79 20 48 | it is u|sed by H|
|00000180| 54 4d 4c 2c 20 61 6e 64 | 20 74 68 65 20 6d 6f 64 |TML, and| the mod|
|00000190| 75 6c 65 20 6f 6e 6c 79 | 0d 65 78 69 73 74 73 20 |ule only|.exists |
|000001a0| 61 73 20 61 20 62 61 73 | 69 73 20 66 6f 72 20 74 |as a bas|is for t|
|000001b0| 68 65 20 5c 63 6f 64 65 | 7b 68 74 6d 6c 6c 69 62 |he \code|{htmllib|
|000001c0| 7d 20 6d 6f 64 75 6c 65 | 2e 0d 5c 73 74 6d 6f 64 |} module|..\stmod|
|000001d0| 69 6e 64 65 78 7b 68 74 | 6d 6c 6c 69 62 7d 0d 0d |index{ht|mllib}..|
|000001e0| 49 6e 20 70 61 72 74 69 | 63 75 6c 61 72 2c 20 74 |In parti|cular, t|
|000001f0| 68 65 20 70 61 72 73 65 | 72 20 69 73 20 68 61 72 |he parse|r is har|
|00000200| 64 63 6f 64 65 64 20 74 | 6f 20 72 65 63 6f 67 6e |dcoded t|o recogn|
|00000210| 69 7a 65 20 74 68 65 20 | 66 6f 6c 6c 6f 77 69 6e |ize the |followin|
|00000220| 67 0d 65 6c 65 6d 65 6e | 74 73 3a 0d 0d 5c 62 65 |g.elemen|ts:..\be|
|00000230| 67 69 6e 7b 69 74 65 6d | 69 7a 65 7d 0d 0d 5c 69 |gin{item|ize}..\i|
|00000240| 74 65 6d 0d 4f 70 65 6e | 69 6e 67 20 61 6e 64 20 |tem.Open|ing and |
|00000250| 63 6c 6f 73 69 6e 67 20 | 74 61 67 73 20 6f 66 20 |closing |tags of |
|00000260| 74 68 65 20 66 6f 72 6d | 0d 60 60 5c 63 6f 64 65 |the form|.``\code|
|00000270| 7b 3c 5c 76 61 72 7b 74 | 61 67 7d 20 5c 76 61 72 |{<\var{t|ag} \var|
|00000280| 7b 61 74 74 72 7d 3d 22 | 5c 76 61 72 7b 76 61 6c |{attr}="|\var{val|
|00000290| 75 65 7d 22 20 2e 2e 2e | 3e 7d 27 27 20 61 6e 64 |ue}" ...|>}'' and|
|000002a0| 0d 60 60 5c 63 6f 64 65 | 7b 3c 2f 5c 76 61 72 7b |.``\code|{</\var{|
|000002b0| 74 61 67 7d 3e 7d 27 27 | 2c 20 72 65 73 70 65 63 |tag}>}''|, respec|
|000002c0| 74 69 76 65 6c 79 2e 0d | 0d 5c 69 74 65 6d 0d 43 |tively..|.\item.C|
|000002d0| 68 61 72 61 63 74 65 72 | 20 72 65 66 65 72 65 6e |haracter| referen|
|000002e0| 63 65 73 20 6f 66 20 74 | 68 65 20 66 6f 72 6d 20 |ces of t|he form |
|000002f0| 60 60 5c 63 6f 64 65 7b | 5c 26 5c 23 5c 76 61 72 |``\code{|\&\#\var|
|00000300| 7b 6e 61 6d 65 7d 3b 7d | 27 27 2e 0d 0d 5c 69 74 |{name};}|''...\it|
|00000310| 65 6d 0d 45 6e 74 69 74 | 79 20 72 65 66 65 72 65 |em.Entit|y refere|
|00000320| 6e 63 65 73 20 6f 66 20 | 74 68 65 20 66 6f 72 6d |nces of |the form|
|00000330| 20 60 60 5c 63 6f 64 65 | 7b 5c 26 5c 76 61 72 7b | ``\code|{\&\var{|
|00000340| 6e 61 6d 65 7d 3b 7d 27 | 27 2e 0d 0d 5c 69 74 65 |name};}'|'...\ite|
|00000350| 6d 0d 53 47 4d 4c 20 63 | 6f 6d 6d 65 6e 74 73 20 |m.SGML c|omments |
|00000360| 6f 66 20 74 68 65 20 66 | 6f 72 6d 20 60 60 5c 63 |of the f|orm ``\c|
|00000370| 6f 64 65 7b 3c 21 2d 2d | 5c 76 61 72 7b 74 65 78 |ode{<!--|\var{tex|
|00000380| 74 7d 3e 7d 27 27 2e 0d | 0d 5c 65 6e 64 7b 69 74 |t}>}''..|.\end{it|
|00000390| 65 6d 69 7a 65 7d 0d 0d | 54 68 65 20 5c 63 6f 64 |emize}..|The \cod|
|000003a0| 65 7b 53 47 4d 4c 50 61 | 72 73 65 72 7d 20 63 6c |e{SGMLPa|rser} cl|
|000003b0| 61 73 73 20 6d 75 73 74 | 20 62 65 20 69 6e 73 74 |ass must| be inst|
|000003c0| 61 6e 74 69 61 74 65 64 | 20 77 69 74 68 6f 75 74 |antiated| without|
|000003d0| 20 61 72 67 75 6d 65 6e | 74 73 2e 0d 49 74 20 68 | argumen|ts..It h|
|000003e0| 61 73 20 74 68 65 20 66 | 6f 6c 6c 6f 77 69 6e 67 |as the f|ollowing|
|000003f0| 20 69 6e 74 65 72 66 61 | 63 65 20 6d 65 74 68 6f | interfa|ce metho|
|00000400| 64 73 3a 0d 0d 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |ds:..\be|gin{func|
|00000410| 64 65 73 63 7d 7b 72 65 | 73 65 74 7d 7b 7d 0d 52 |desc}{re|set}{}.R|
|00000420| 65 73 65 74 20 74 68 65 | 20 69 6e 73 74 61 6e 63 |eset the| instanc|
|00000430| 65 2e 20 20 4c 6f 73 65 | 73 20 61 6c 6c 20 75 6e |e.  Lose|s all un|
|00000440| 70 72 6f 63 65 73 73 65 | 64 20 64 61 74 61 2e 20 |processe|d data. |
|00000450| 20 54 68 69 73 20 69 73 | 20 63 61 6c 6c 65 64 0d | This is| called.|
|00000460| 69 6d 70 6c 69 63 69 74 | 6c 79 20 61 74 20 69 6e |implicit|ly at in|
|00000470| 73 74 61 6e 74 69 61 74 | 69 6f 6e 20 74 69 6d 65 |stantiat|ion time|
|00000480| 2e 0d 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|00000490| 0d 0d 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|000004a0| 63 7d 7b 73 65 74 6e 6f | 6d 6f 72 65 74 61 67 73 |c}{setno|moretags|
|000004b0| 7d 7b 7d 0d 53 74 6f 70 | 20 70 72 6f 63 65 73 73 |}{}.Stop| process|
|000004c0| 69 6e 67 20 74 61 67 73 | 2e 20 20 54 72 65 61 74 |ing tags|.  Treat|
|000004d0| 20 61 6c 6c 20 66 6f 6c | 6c 6f 77 69 6e 67 20 69 | all fol|lowing i|
|000004e0| 6e 70 75 74 20 61 73 20 | 6c 69 74 65 72 61 6c 20 |nput as |literal |
|000004f0| 69 6e 70 75 74 0d 28 43 | 44 41 54 41 29 2e 20 20 |input.(C|DATA).  |
|00000500| 28 54 68 69 73 20 69 73 | 20 6f 6e 6c 79 20 70 72 |(This is| only pr|
|00000510| 6f 76 69 64 65 64 20 73 | 6f 20 74 68 65 20 48 54 |ovided s|o the HT|
|00000520| 4d 4c 20 74 61 67 20 5c | 63 6f 64 65 7b 3c 50 4c |ML tag \|code{<PL|
|00000530| 41 49 4e 54 45 58 54 3e | 7d 0d 63 61 6e 20 62 65 |AINTEXT>|}.can be|
|00000540| 20 69 6d 70 6c 65 6d 65 | 6e 74 65 64 2e 29 0d 5c | impleme|nted.).\|
|00000550| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0d 0d 5c |end{func|desc}..\|
|00000560| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|00000570| 73 65 74 6c 69 74 65 72 | 61 6c 7d 7b 7d 0d 45 6e |setliter|al}{}.En|
|00000580| 74 65 72 20 6c 69 74 65 | 72 61 6c 20 6d 6f 64 65 |ter lite|ral mode|
|00000590| 20 28 43 44 41 54 41 20 | 6d 6f 64 65 29 2e 0d 5c | (CDATA |mode)..\|
|000005a0| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0d 0d 5c |end{func|desc}..\|
|000005b0| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|000005c0| 66 65 65 64 7d 7b 64 61 | 74 61 7d 0d 46 65 65 64 |feed}{da|ta}.Feed|
|000005d0| 20 73 6f 6d 65 20 74 65 | 78 74 20 74 6f 20 74 68 | some te|xt to th|
|000005e0| 65 20 70 61 72 73 65 72 | 2e 20 20 49 74 20 69 73 |e parser|.  It is|
|000005f0| 20 70 72 6f 63 65 73 73 | 65 64 20 69 6e 73 6f 66 | process|ed insof|
|00000600| 61 72 20 61 73 20 69 74 | 20 63 6f 6e 73 69 73 74 |ar as it| consist|
|00000610| 73 0d 6f 66 20 63 6f 6d | 70 6c 65 74 65 20 65 6c |s.of com|plete el|
|00000620| 65 6d 65 6e 74 73 3b 20 | 69 6e 63 6f 6d 70 6c 65 |ements; |incomple|
|00000630| 74 65 20 64 61 74 61 20 | 69 73 20 62 75 66 66 65 |te data |is buffe|
|00000640| 72 65 64 20 75 6e 74 69 | 6c 20 6d 6f 72 65 20 64 |red unti|l more d|
|00000650| 61 74 61 20 69 73 0d 66 | 65 64 20 6f 72 20 5c 63 |ata is.f|ed or \c|
|00000660| 6f 64 65 7b 63 6c 6f 73 | 65 28 29 7d 20 69 73 20 |ode{clos|e()} is |
|00000670| 63 61 6c 6c 65 64 2e 0d | 5c 65 6e 64 7b 66 75 6e |called..|\end{fun|
|00000680| 63 64 65 73 63 7d 0d 0d | 5c 62 65 67 69 6e 7b 66 |cdesc}..|\begin{f|
|00000690| 75 6e 63 64 65 73 63 7d | 7b 63 6c 6f 73 65 7d 7b |uncdesc}|{close}{|
|000006a0| 7d 0d 46 6f 72 63 65 20 | 70 72 6f 63 65 73 73 69 |}.Force |processi|
|000006b0| 6e 67 20 6f 66 20 61 6c | 6c 20 62 75 66 66 65 72 |ng of al|l buffer|
|000006c0| 65 64 20 64 61 74 61 20 | 61 73 20 69 66 20 69 74 |ed data |as if it|
|000006d0| 20 77 65 72 65 20 66 6f | 6c 6c 6f 77 65 64 20 62 | were fo|llowed b|
|000006e0| 79 20 61 6e 0d 65 6e 64 | 2d 6f 66 2d 66 69 6c 65 |y an.end|-of-file|
|000006f0| 20 6d 61 72 6b 2e 20 20 | 54 68 69 73 20 6d 65 74 | mark.  |This met|
|00000700| 68 6f 64 20 6d 61 79 20 | 62 65 20 72 65 64 65 66 |hod may |be redef|
|00000710| 69 6e 65 64 20 62 79 20 | 61 20 64 65 72 69 76 65 |ined by |a derive|
|00000720| 64 20 63 6c 61 73 73 20 | 74 6f 0d 64 65 66 69 6e |d class |to.defin|
|00000730| 65 20 61 64 64 69 74 69 | 6f 6e 61 6c 20 70 72 6f |e additi|onal pro|
|00000740| 63 65 73 73 69 6e 67 20 | 61 74 20 74 68 65 20 65 |cessing |at the e|
|00000750| 6e 64 20 6f 66 20 74 68 | 65 20 69 6e 70 75 74 2c |nd of th|e input,|
|00000760| 20 62 75 74 20 74 68 65 | 0d 72 65 64 65 66 69 6e | but the|.redefin|
|00000770| 65 64 20 76 65 72 73 69 | 6f 6e 20 73 68 6f 75 6c |ed versi|on shoul|
|00000780| 64 20 61 6c 77 61 79 73 | 20 63 61 6c 6c 20 5c 63 |d always| call \c|
|00000790| 6f 64 65 7b 53 47 4d 4c | 50 61 72 73 65 72 2e 63 |ode{SGML|Parser.c|
|000007a0| 6c 6f 73 65 28 29 7d 2e | 0d 5c 65 6e 64 7b 66 75 |lose()}.|.\end{fu|
|000007b0| 6e 63 64 65 73 63 7d 0d | 0d 5c 62 65 67 69 6e 7b |ncdesc}.|.\begin{|
|000007c0| 66 75 6e 63 64 65 73 63 | 7d 7b 68 61 6e 64 6c 65 |funcdesc|}{handle|
|000007d0| 5f 63 68 61 72 72 65 66 | 7d 7b 72 65 66 7d 0d 54 |_charref|}{ref}.T|
|000007e0| 68 69 73 20 6d 65 74 68 | 6f 64 20 69 73 20 63 61 |his meth|od is ca|
|000007f0| 6c 6c 65 64 20 74 6f 20 | 70 72 6f 63 65 73 73 20 |lled to |process |
|00000800| 61 20 63 68 61 72 61 63 | 74 65 72 20 72 65 66 65 |a charac|ter refe|
|00000810| 72 65 6e 63 65 20 6f 66 | 20 74 68 65 20 66 6f 72 |rence of| the for|
|00000820| 6d 0d 60 60 5c 63 6f 64 | 65 7b 5c 26 5c 23 5c 76 |m.``\cod|e{\&\#\v|
|00000830| 61 72 7b 72 65 66 7d 3b | 7d 27 27 20 77 68 65 72 |ar{ref};|}'' wher|
|00000840| 65 20 5c 76 61 72 7b 72 | 65 66 7d 20 69 73 20 61 |e \var{r|ef} is a|
|00000850| 20 64 65 63 69 6d 61 6c | 20 6e 75 6d 62 65 72 20 | decimal| number |
|00000860| 69 6e 20 74 68 65 0d 72 | 61 6e 67 65 20 30 2d 32 |in the.r|ange 0-2|
|00000870| 35 35 2e 20 20 49 74 20 | 74 72 61 6e 73 6c 61 74 |55.  It |translat|
|00000880| 65 73 20 74 68 65 20 63 | 68 61 72 61 63 74 65 72 |es the c|haracter|
|00000890| 20 74 6f 20 5c 41 53 43 | 49 49 7b 7d 20 61 6e 64 | to \ASC|II{} and|
|000008a0| 20 63 61 6c 6c 73 20 74 | 68 65 0d 6d 65 74 68 6f | calls t|he.metho|
|000008b0| 64 20 5c 63 6f 64 65 7b | 68 61 6e 64 6c 65 5f 64 |d \code{|handle_d|
|000008c0| 61 74 61 28 29 7d 20 77 | 69 74 68 20 74 68 65 20 |ata()} w|ith the |
|000008d0| 63 68 61 72 61 63 74 65 | 72 20 61 73 20 61 72 67 |characte|r as arg|
|000008e0| 75 6d 65 6e 74 2e 20 20 | 49 66 0d 5c 76 61 72 7b |ument.  |If.\var{|
|000008f0| 72 65 66 7d 20 69 73 20 | 69 6e 76 61 6c 69 64 20 |ref} is |invalid |
|00000900| 6f 72 20 6f 75 74 20 6f | 66 20 72 61 6e 67 65 2c |or out o|f range,|
|00000910| 20 74 68 65 20 6d 65 74 | 68 6f 64 0d 5c 63 6f 64 | the met|hod.\cod|
|00000920| 65 7b 75 6e 6b 6e 6f 77 | 6e 5f 63 68 61 72 72 65 |e{unknow|n_charre|
|00000930| 66 28 5c 76 61 72 7b 72 | 65 66 7d 29 7d 20 69 73 |f(\var{r|ef})} is|
|00000940| 20 63 61 6c 6c 65 64 20 | 69 6e 73 74 65 61 64 2e | called |instead.|
|00000950| 0d 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0d |.\end{fu|ncdesc}.|
|00000960| 0d 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|00000970| 7d 7b 68 61 6e 64 6c 65 | 5f 65 6e 74 69 74 79 72 |}{handle|_entityr|
|00000980| 65 66 7d 7b 72 65 66 7d | 0d 54 68 69 73 20 6d 65 |ef}{ref}|.This me|
|00000990| 74 68 6f 64 20 69 73 20 | 63 61 6c 6c 65 64 20 74 |thod is |called t|
|000009a0| 6f 20 70 72 6f 63 65 73 | 73 20 61 6e 20 65 6e 74 |o proces|s an ent|
|000009b0| 69 74 79 20 72 65 66 65 | 72 65 6e 63 65 20 6f 66 |ity refe|rence of|
|000009c0| 20 74 68 65 20 66 6f 72 | 6d 0d 60 60 5c 63 6f 64 | the for|m.``\cod|
|000009d0| 65 7b 5c 26 5c 76 61 72 | 7b 72 65 66 7d 3b 7d 27 |e{\&\var|{ref};}'|
|000009e0| 27 20 77 68 65 72 65 20 | 5c 76 61 72 7b 72 65 66 |' where |\var{ref|
|000009f0| 7d 20 69 73 20 61 6e 20 | 61 6c 70 68 61 62 65 74 |} is an |alphabet|
|00000a00| 69 63 20 65 6e 74 69 74 | 79 0d 72 65 66 65 72 65 |ic entit|y.refere|
|00000a10| 6e 63 65 2e 20 20 49 74 | 20 6c 6f 6f 6b 73 20 66 |nce.  It| looks f|
|00000a20| 6f 72 20 5c 76 61 72 7b | 72 65 66 7d 20 69 6e 20 |or \var{|ref} in |
|00000a30| 74 68 65 20 69 6e 73 74 | 61 6e 63 65 20 28 6f 72 |the inst|ance (or|
|00000a40| 20 63 6c 61 73 73 29 0d | 76 61 72 69 61 62 6c 65 | class).|variable|
|00000a50| 20 5c 63 6f 64 65 7b 65 | 6e 74 69 74 79 64 65 66 | \code{e|ntitydef|
|00000a60| 73 7d 20 77 68 69 63 68 | 20 73 68 6f 75 6c 64 20 |s} which| should |
|00000a70| 67 69 76 65 20 74 68 65 | 20 65 6e 74 69 74 79 27 |give the| entity'|
|00000a80| 73 20 74 72 61 6e 73 6c | 61 74 69 6f 6e 2e 0d 49 |s transl|ation..I|
|00000a90| 66 20 61 20 74 72 61 6e | 73 6c 61 74 69 6f 6e 20 |f a tran|slation |
|00000aa0| 69 73 20 66 6f 75 6e 64 | 2c 20 69 74 20 63 61 6c |is found|, it cal|
|00000ab0| 6c 73 20 74 68 65 20 6d | 65 74 68 6f 64 20 5c 63 |ls the m|ethod \c|
|00000ac0| 6f 64 65 7b 68 61 6e 64 | 6c 65 5f 64 61 74 61 28 |ode{hand|le_data(|
|00000ad0| 29 7d 0d 77 69 74 68 20 | 74 68 65 20 74 72 61 6e |)}.with |the tran|
|00000ae0| 73 6c 61 74 69 6f 6e 3b | 20 6f 74 68 65 72 77 69 |slation;| otherwi|
|00000af0| 73 65 2c 20 69 74 20 63 | 61 6c 6c 73 20 74 68 65 |se, it c|alls the|
|00000b00| 20 6d 65 74 68 6f 64 0d | 5c 63 6f 64 65 7b 75 6e | method.|\code{un|
|00000b10| 6b 6e 6f 77 6e 5f 65 6e | 74 69 74 79 72 65 66 28 |known_en|tityref(|
|00000b20| 5c 76 61 72 7b 72 65 66 | 7d 29 7d 2e 0d 5c 65 6e |\var{ref|})}..\en|
|00000b30| 64 7b 66 75 6e 63 64 65 | 73 63 7d 0d 0d 5c 62 65 |d{funcde|sc}..\be|
|00000b40| 67 69 6e 7b 66 75 6e 63 | 64 65 73 63 7d 7b 68 61 |gin{func|desc}{ha|
|00000b50| 6e 64 6c 65 5f 64 61 74 | 61 7d 7b 64 61 74 61 7d |ndle_dat|a}{data}|
|00000b60| 0d 54 68 69 73 20 6d 65 | 74 68 6f 64 20 69 73 20 |.This me|thod is |
|00000b70| 63 61 6c 6c 65 64 20 74 | 6f 20 70 72 6f 63 65 73 |called t|o proces|
|00000b80| 73 20 61 72 62 69 74 72 | 61 72 79 20 64 61 74 61 |s arbitr|ary data|
|00000b90| 2e 20 20 49 74 20 69 73 | 20 69 6e 74 65 6e 64 65 |.  It is| intende|
|00000ba0| 64 20 74 6f 20 62 65 0d | 6f 76 65 72 72 69 64 64 |d to be.|overridd|
|00000bb0| 65 6e 20 62 79 20 61 20 | 64 65 72 69 76 65 64 20 |en by a |derived |
|00000bc0| 63 6c 61 73 73 3b 20 74 | 68 65 20 62 61 73 65 20 |class; t|he base |
|00000bd0| 63 6c 61 73 73 20 69 6d | 70 6c 65 6d 65 6e 74 61 |class im|plementa|
|00000be0| 74 69 6f 6e 20 64 6f 65 | 73 0d 6e 6f 74 68 69 6e |tion doe|s.nothin|
|00000bf0| 67 2e 0d 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |g..\end{|funcdesc|
|00000c00| 7d 0d 0d 5c 62 65 67 69 | 6e 7b 66 75 6e 63 64 65 |}..\begi|n{funcde|
|00000c10| 73 63 7d 7b 75 6e 6b 6e | 6f 77 6e 5f 73 74 61 72 |sc}{unkn|own_star|
|00000c20| 74 74 61 67 7d 7b 74 61 | 67 5c 2c 20 61 74 74 72 |ttag}{ta|g\, attr|
|00000c30| 69 62 75 74 65 73 7d 0d | 54 68 69 73 20 6d 65 74 |ibutes}.|This met|
|00000c40| 68 6f 64 20 69 73 20 63 | 61 6c 6c 65 64 20 74 6f |hod is c|alled to|
|00000c50| 20 70 72 6f 63 65 73 73 | 20 61 6e 20 75 6e 6b 6e | process| an unkn|
|00000c60| 6f 77 6e 20 73 74 61 72 | 74 20 74 61 67 2e 20 20 |own star|t tag.  |
|00000c70| 49 74 20 69 73 20 69 6e | 74 65 6e 64 65 64 0d 74 |It is in|tended.t|
|00000c80| 6f 20 62 65 20 6f 76 65 | 72 72 69 64 64 65 6e 20 |o be ove|rridden |
|00000c90| 62 79 20 61 20 64 65 72 | 69 76 65 64 20 63 6c 61 |by a der|ived cla|
|00000ca0| 73 73 3b 20 74 68 65 20 | 62 61 73 65 20 63 6c 61 |ss; the |base cla|
|00000cb0| 73 73 20 69 6d 70 6c 65 | 6d 65 6e 74 61 74 69 6f |ss imple|mentatio|
|00000cc0| 6e 0d 64 6f 65 73 20 6e | 6f 74 68 69 6e 67 2e 20 |n.does n|othing. |
|00000cd0| 20 54 68 65 20 5c 76 61 | 72 7b 61 74 74 72 69 62 | The \va|r{attrib|
|00000ce0| 75 74 65 73 7d 20 61 72 | 67 75 6d 65 6e 74 20 69 |utes} ar|gument i|
|00000cf0| 73 20 61 20 6c 69 73 74 | 20 6f 66 0d 28 5c 76 61 |s a list| of.(\va|
|00000d00| 72 7b 6e 61 6d 65 7d 2c | 20 5c 76 61 72 7b 76 61 |r{name},| \var{va|
|00000d10| 6c 75 65 7d 29 20 70 61 | 69 72 73 20 63 6f 6e 74 |lue}) pa|irs cont|
|00000d20| 61 69 6e 69 6e 67 20 74 | 68 65 20 61 74 74 72 69 |aining t|he attri|
|00000d30| 62 75 74 65 73 20 66 6f | 75 6e 64 20 69 6e 73 69 |butes fo|und insi|
|00000d40| 64 65 0d 74 68 65 20 74 | 61 67 27 73 20 5c 63 6f |de.the t|ag's \co|
|00000d50| 64 65 7b 3c 3e 7d 20 62 | 72 61 63 6b 65 74 73 2e |de{<>} b|rackets.|
|00000d60| 20 20 54 68 65 20 5c 76 | 61 72 7b 6e 61 6d 65 7d |  The \v|ar{name}|
|00000d70| 20 68 61 73 20 62 65 65 | 6e 20 74 72 61 6e 73 6c | has bee|n transl|
|00000d80| 61 74 65 64 20 74 6f 0d | 6c 6f 77 65 72 20 63 61 |ated to.|lower ca|
|00000d90| 73 65 20 61 6e 64 20 64 | 6f 75 62 6c 65 20 71 75 |se and d|ouble qu|
|00000da0| 6f 74 65 73 20 61 6e 64 | 20 62 61 63 6b 73 6c 61 |otes and| backsla|
|00000db0| 73 68 65 73 20 69 6e 20 | 74 68 65 20 5c 76 61 72 |shes in |the \var|
|00000dc0| 7b 76 61 6c 75 65 7d 20 | 68 61 76 65 0d 62 65 65 |{value} |have.bee|
|00000dd0| 6e 20 69 6e 74 65 72 70 | 72 65 74 65 64 2e 20 20 |n interp|reted.  |
|00000de0| 46 6f 72 20 69 6e 73 74 | 61 6e 63 65 2c 20 66 6f |For inst|ance, fo|
|00000df0| 72 20 74 68 65 20 74 61 | 67 0d 5c 63 6f 64 65 7b |r the ta|g.\code{|
|00000e00| 3c 41 20 48 52 45 46 3d | 22 68 74 74 70 3a 2f 2f |<A HREF=|"http://|
|00000e10| 77 77 77 2e 63 77 69 2e | 6e 6c 2f 22 3e 7d 2c 20 |www.cwi.|nl/">}, |
|00000e20| 74 68 69 73 20 6d 65 74 | 68 6f 64 20 77 6f 75 6c |this met|hod woul|
|00000e30| 64 20 62 65 0d 63 61 6c | 6c 65 64 20 61 73 20 5c |d be.cal|led as \|
|00000e40| 63 6f 64 65 7b 75 6e 6b | 6e 6f 77 6e 5f 73 74 61 |code{unk|nown_sta|
|00000e50| 72 74 74 61 67 28 27 61 | 27 2c 20 5b 28 27 68 72 |rttag('a|', [('hr|
|00000e60| 65 66 27 2c 20 27 68 74 | 74 70 3a 2f 2f 77 77 77 |ef', 'ht|tp://www|
|00000e70| 2e 63 77 69 2e 6e 6c 2f | 27 29 5d 29 7d 2e 0d 5c |.cwi.nl/|')])}..\|
|00000e80| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0d 0d 5c |end{func|desc}..\|
|00000e90| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|00000ea0| 75 6e 6b 6e 6f 77 6e 5f | 65 6e 64 74 61 67 7d 7b |unknown_|endtag}{|
|00000eb0| 74 61 67 7d 0d 54 68 69 | 73 20 6d 65 74 68 6f 64 |tag}.Thi|s method|
|00000ec0| 20 69 73 20 63 61 6c 6c | 65 64 20 74 6f 20 70 72 | is call|ed to pr|
|00000ed0| 6f 63 65 73 73 20 61 6e | 20 75 6e 6b 6e 6f 77 6e |ocess an| unknown|
|00000ee0| 20 65 6e 64 20 74 61 67 | 2e 20 20 49 74 20 69 73 | end tag|.  It is|
|00000ef0| 20 69 6e 74 65 6e 64 65 | 64 0d 74 6f 20 62 65 20 | intende|d.to be |
|00000f00| 6f 76 65 72 72 69 64 64 | 65 6e 20 62 79 20 61 20 |overridd|en by a |
|00000f10| 64 65 72 69 76 65 64 20 | 63 6c 61 73 73 3b 20 74 |derived |class; t|
|00000f20| 68 65 20 62 61 73 65 20 | 63 6c 61 73 73 20 69 6d |he base |class im|
|00000f30| 70 6c 65 6d 65 6e 74 61 | 74 69 6f 6e 0d 64 6f 65 |plementa|tion.doe|
|00000f40| 73 20 6e 6f 74 68 69 6e | 67 2e 0d 5c 65 6e 64 7b |s nothin|g..\end{|
|00000f50| 66 75 6e 63 64 65 73 63 | 7d 0d 0d 5c 62 65 67 69 |funcdesc|}..\begi|
|00000f60| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 75 6e 6b 6e |n{funcde|sc}{unkn|
|00000f70| 6f 77 6e 5f 63 68 61 72 | 72 65 66 7d 7b 72 65 66 |own_char|ref}{ref|
|00000f80| 7d 0d 54 68 69 73 20 6d | 65 74 68 6f 64 20 69 73 |}.This m|ethod is|
|00000f90| 20 63 61 6c 6c 65 64 20 | 74 6f 20 70 72 6f 63 65 | called |to proce|
|00000fa0| 73 73 20 61 6e 20 75 6e | 6b 6e 6f 77 6e 20 63 68 |ss an un|known ch|
|00000fb0| 61 72 61 63 74 65 72 20 | 72 65 66 65 72 65 6e 63 |aracter |referenc|
|00000fc0| 65 2e 20 20 49 74 0d 69 | 73 20 69 6e 74 65 6e 64 |e.  It.i|s intend|
|00000fd0| 65 64 20 74 6f 20 62 65 | 20 6f 76 65 72 72 69 64 |ed to be| overrid|
|00000fe0| 64 65 6e 20 62 79 20 61 | 20 64 65 72 69 76 65 64 |den by a| derived|
|00000ff0| 20 63 6c 61 73 73 3b 20 | 74 68 65 20 62 61 73 65 | class; |the base|
|00001000| 20 63 6c 61 73 73 0d 69 | 6d 70 6c 65 6d 65 6e 74 | class.i|mplement|
|00001010| 61 74 69 6f 6e 20 64 6f | 65 73 20 6e 6f 74 68 69 |ation do|es nothi|
|00001020| 6e 67 2e 0d 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |ng..\end|{funcdes|
|00001030| 63 7d 0d 0d 5c 62 65 67 | 69 6e 7b 66 75 6e 63 64 |c}..\beg|in{funcd|
|00001040| 65 73 63 7d 7b 75 6e 6b | 6e 6f 77 6e 5f 65 6e 74 |esc}{unk|nown_ent|
|00001050| 69 74 79 72 65 66 7d 7b | 72 65 66 7d 0d 54 68 69 |ityref}{|ref}.Thi|
|00001060| 73 20 6d 65 74 68 6f 64 | 20 69 73 20 63 61 6c 6c |s method| is call|
|00001070| 65 64 20 74 6f 20 70 72 | 6f 63 65 73 73 20 61 6e |ed to pr|ocess an|
|00001080| 20 75 6e 6b 6e 6f 77 6e | 20 65 6e 74 69 74 79 20 | unknown| entity |
|00001090| 72 65 66 65 72 65 6e 63 | 65 2e 20 20 49 74 20 69 |referenc|e.  It i|
|000010a0| 73 0d 69 6e 74 65 6e 64 | 65 64 20 74 6f 20 62 65 |s.intend|ed to be|
|000010b0| 20 6f 76 65 72 72 69 64 | 64 65 6e 20 62 79 20 61 | overrid|den by a|
|000010c0| 20 64 65 72 69 76 65 64 | 20 63 6c 61 73 73 3b 20 | derived| class; |
|000010d0| 74 68 65 20 62 61 73 65 | 20 63 6c 61 73 73 0d 69 |the base| class.i|
|000010e0| 6d 70 6c 65 6d 65 6e 74 | 61 74 69 6f 6e 20 64 6f |mplement|ation do|
|000010f0| 65 73 20 6e 6f 74 68 69 | 6e 67 2e 0d 5c 65 6e 64 |es nothi|ng..\end|
|00001100| 7b 66 75 6e 63 64 65 73 | 63 7d 0d 0d 41 70 61 72 |{funcdes|c}..Apar|
|00001110| 74 20 66 72 6f 6d 20 6f | 76 65 72 72 69 64 69 6e |t from o|verridin|
|00001120| 67 20 6f 72 20 65 78 74 | 65 6e 64 69 6e 67 20 74 |g or ext|ending t|
|00001130| 68 65 20 6d 65 74 68 6f | 64 73 20 6c 69 73 74 65 |he metho|ds liste|
|00001140| 64 20 61 62 6f 76 65 2c | 20 64 65 72 69 76 65 64 |d above,| derived|
|00001150| 0d 63 6c 61 73 73 65 73 | 20 6d 61 79 20 61 6c 73 |.classes| may als|
|00001160| 6f 20 64 65 66 69 6e 65 | 20 6d 65 74 68 6f 64 73 |o define| methods|
|00001170| 20 6f 66 20 74 68 65 20 | 66 6f 6c 6c 6f 77 69 6e | of the |followin|
|00001180| 67 20 66 6f 72 6d 20 74 | 6f 20 64 65 66 69 6e 65 |g form t|o define|
|00001190| 0d 70 72 6f 63 65 73 73 | 69 6e 67 20 6f 66 20 73 |.process|ing of s|
|000011a0| 70 65 63 69 66 69 63 20 | 74 61 67 73 2e 20 20 54 |pecific |tags.  T|
|000011b0| 61 67 20 6e 61 6d 65 73 | 20 69 6e 20 74 68 65 20 |ag names| in the |
|000011c0| 69 6e 70 75 74 20 73 74 | 72 65 61 6d 20 61 72 65 |input st|ream are|
|000011d0| 20 63 61 73 65 0d 69 6e | 64 65 70 65 6e 64 65 6e | case.in|dependen|
|000011e0| 74 3b 20 74 68 65 20 5c | 76 61 72 7b 74 61 67 7d |t; the \|var{tag}|
|000011f0| 20 6f 63 63 75 72 72 69 | 6e 67 20 69 6e 20 6d 65 | occurri|ng in me|
|00001200| 74 68 6f 64 20 6e 61 6d | 65 73 20 6d 75 73 74 20 |thod nam|es must |
|00001210| 62 65 20 69 6e 20 6c 6f | 77 65 72 0d 63 61 73 65 |be in lo|wer.case|
|00001220| 3a 0d 0d 5c 62 65 67 69 | 6e 7b 66 75 6e 63 64 65 |:..\begi|n{funcde|
|00001230| 73 63 7d 7b 73 74 61 72 | 74 5f 5c 76 61 72 7b 74 |sc}{star|t_\var{t|
|00001240| 61 67 7d 7d 7b 61 74 74 | 72 69 62 75 74 65 73 7d |ag}}{att|ributes}|
|00001250| 0d 54 68 69 73 20 6d 65 | 74 68 6f 64 20 69 73 20 |.This me|thod is |
|00001260| 63 61 6c 6c 65 64 20 74 | 6f 20 70 72 6f 63 65 73 |called t|o proces|
|00001270| 73 20 61 6e 20 6f 70 65 | 6e 69 6e 67 20 74 61 67 |s an ope|ning tag|
|00001280| 20 5c 76 61 72 7b 74 61 | 67 7d 2e 20 20 49 74 20 | \var{ta|g}.  It |
|00001290| 68 61 73 0d 70 72 65 66 | 65 72 65 6e 63 65 20 6f |has.pref|erence o|
|000012a0| 76 65 72 20 5c 63 6f 64 | 65 7b 64 6f 5f 5c 76 61 |ver \cod|e{do_\va|
|000012b0| 72 7b 74 61 67 7d 28 29 | 7d 2e 20 20 54 68 65 20 |r{tag}()|}.  The |
|000012c0| 5c 76 61 72 7b 61 74 74 | 72 69 62 75 74 65 73 7d |\var{att|ributes}|
|000012d0| 20 61 72 67 75 6d 65 6e | 74 0d 68 61 73 20 74 68 | argumen|t.has th|
|000012e0| 65 20 73 61 6d 65 20 6d | 65 61 6e 69 6e 67 20 61 |e same m|eaning a|
|000012f0| 73 20 64 65 73 63 72 69 | 62 65 64 20 66 6f 72 20 |s descri|bed for |
|00001300| 5c 63 6f 64 65 7b 75 6e | 6b 6e 6f 77 6e 5f 74 61 |\code{un|known_ta|
|00001310| 67 28 29 7d 20 61 62 6f | 76 65 2e 0d 5c 65 6e 64 |g()} abo|ve..\end|
|00001320| 7b 66 75 6e 63 64 65 73 | 63 7d 0d 0d 5c 62 65 67 |{funcdes|c}..\beg|
|00001330| 69 6e 7b 66 75 6e 63 64 | 65 73 63 7d 7b 64 6f 5f |in{funcd|esc}{do_|
|00001340| 5c 76 61 72 7b 74 61 67 | 7d 7d 7b 61 74 74 72 69 |\var{tag|}}{attri|
|00001350| 62 75 74 65 73 7d 0d 54 | 68 69 73 20 6d 65 74 68 |butes}.T|his meth|
|00001360| 6f 64 20 69 73 20 63 61 | 6c 6c 65 64 20 74 6f 20 |od is ca|lled to |
|00001370| 70 72 6f 63 65 73 73 20 | 61 6e 20 6f 70 65 6e 69 |process |an openi|
|00001380| 6e 67 20 74 61 67 20 5c | 76 61 72 7b 74 61 67 7d |ng tag \|var{tag}|
|00001390| 20 74 68 61 74 20 64 6f | 65 73 0d 6e 6f 74 20 63 | that do|es.not c|
|000013a0| 6f 6d 65 20 77 69 74 68 | 20 61 20 6d 61 74 63 68 |ome with| a match|
|000013b0| 69 6e 67 20 63 6c 6f 73 | 69 6e 67 20 74 61 67 2e |ing clos|ing tag.|
|000013c0| 20 20 54 68 65 20 5c 76 | 61 72 7b 61 74 74 72 69 |  The \v|ar{attri|
|000013d0| 62 75 74 65 73 7d 20 61 | 72 67 75 6d 65 6e 74 0d |butes} a|rgument.|
|000013e0| 68 61 73 20 74 68 65 20 | 73 61 6d 65 20 6d 65 61 |has the |same mea|
|000013f0| 6e 69 6e 67 20 61 73 20 | 64 65 73 63 72 69 62 65 |ning as |describe|
|00001400| 64 20 66 6f 72 20 5c 63 | 6f 64 65 7b 75 6e 6b 6e |d for \c|ode{unkn|
|00001410| 6f 77 6e 5f 74 61 67 28 | 29 7d 20 61 62 6f 76 65 |own_tag(|)} above|
|00001420| 2e 0d 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|00001430| 0d 0d 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00001440| 63 7d 7b 65 6e 64 5f 5c | 76 61 72 7b 74 61 67 7d |c}{end_\|var{tag}|
|00001450| 7d 7b 7d 0d 54 68 69 73 | 20 6d 65 74 68 6f 64 20 |}{}.This| method |
|00001460| 69 73 20 63 61 6c 6c 65 | 64 20 74 6f 20 70 72 6f |is calle|d to pro|
|00001470| 63 65 73 73 20 61 20 63 | 6c 6f 73 69 6e 67 20 74 |cess a c|losing t|
|00001480| 61 67 20 5c 76 61 72 7b | 74 61 67 7d 2e 0d 5c 65 |ag \var{|tag}..\e|
|00001490| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0d 0d 4e 6f |nd{funcd|esc}..No|
|000014a0| 74 65 20 74 68 61 74 20 | 74 68 65 20 70 61 72 73 |te that |the pars|
|000014b0| 65 72 20 6d 61 69 6e 74 | 61 69 6e 73 20 61 20 73 |er maint|ains a s|
|000014c0| 74 61 63 6b 20 6f 66 20 | 6f 70 65 6e 69 6e 67 20 |tack of |opening |
|000014d0| 74 61 67 73 20 66 6f 72 | 20 77 68 69 63 68 20 6e |tags for| which n|
|000014e0| 6f 0d 6d 61 74 63 68 69 | 6e 67 20 63 6c 6f 73 69 |o.matchi|ng closi|
|000014f0| 6e 67 20 74 61 67 20 68 | 61 73 20 62 65 65 6e 20 |ng tag h|as been |
|00001500| 66 6f 75 6e 64 20 79 65 | 74 2e 20 20 4f 6e 6c 79 |found ye|t.  Only|
|00001510| 20 74 61 67 73 20 70 72 | 6f 63 65 73 73 65 64 20 | tags pr|ocessed |
|00001520| 62 79 0d 5c 63 6f 64 65 | 7b 73 74 61 72 74 5f 5c |by.\code|{start_\|
|00001530| 76 61 72 7b 74 61 67 7d | 28 29 7d 20 61 72 65 20 |var{tag}|()} are |
|00001540| 70 75 73 68 65 64 20 6f | 6e 20 74 68 69 73 20 73 |pushed o|n this s|
|00001550| 74 61 63 6b 2e 20 20 44 | 65 66 69 6e 69 74 69 6f |tack.  D|efinitio|
|00001560| 6e 20 6f 66 20 61 0d 5c | 63 6f 64 65 7b 65 6e 64 |n of a.\|code{end|
|00001570| 5f 5c 76 61 72 7b 74 61 | 67 7d 28 29 7d 20 6d 65 |_\var{ta|g}()} me|
|00001580| 74 68 6f 64 20 69 73 20 | 6f 70 74 69 6f 6e 61 6c |thod is |optional|
|00001590| 20 66 6f 72 20 74 68 65 | 73 65 20 74 61 67 73 2e | for the|se tags.|
|000015a0| 20 20 46 6f 72 20 74 61 | 67 73 0d 70 72 6f 63 65 |  For ta|gs.proce|
|000015b0| 73 73 65 64 20 62 79 20 | 5c 63 6f 64 65 7b 64 6f |ssed by |\code{do|
|000015c0| 5f 5c 76 61 72 7b 74 61 | 67 7d 28 29 7d 20 6f 72 |_\var{ta|g}()} or|
|000015d0| 20 62 79 20 5c 63 6f 64 | 65 7b 75 6e 6b 6e 6f 77 | by \cod|e{unknow|
|000015e0| 6e 5f 74 61 67 28 29 7d | 2c 20 6e 6f 0d 5c 63 6f |n_tag()}|, no.\co|
|000015f0| 64 65 7b 65 6e 64 5f 5c | 76 61 72 7b 74 61 67 7d |de{end_\|var{tag}|
|00001600| 28 29 7d 20 6d 65 74 68 | 6f 64 20 6d 75 73 74 20 |()} meth|od must |
|00001610| 62 65 20 64 65 66 69 6e | 65 64 2e 0d             |be defin|ed..    |
+--------+-------------------------+-------------------------+--------+--------+