/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / p / python / pytexdoc / ext / lib / lib1 / sgmllib / tex

MacOS 8.1

Win98

DOS

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 0a 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 0a 5c 69 6e 64 65 78 | 7b 53 47 4d 4c 7d 0a 0a |}.\index|{SGML}..|
|00000050| 54 68 69 73 20 6d 6f 64 | 75 6c 65 20 64 65 66 69 |This mod|ule defi|
|00000060| 6e 65 73 20 61 20 63 6c | 61 73 73 20 5c 63 6f 64 |nes a cl|ass \cod|
|00000070| 65 7b 53 47 4d 4c 50 61 | 72 73 65 72 7d 20 77 68 |e{SGMLPa|rser} wh|
|00000080| 69 63 68 20 73 65 72 76 | 65 73 20 61 73 20 74 68 |ich serv|es as th|
|00000090| 65 0a 62 61 73 69 73 20 | 66 6f 72 20 70 61 72 73 |e.basis |for pars|
|000000a0| 69 6e 67 20 74 65 78 74 | 20 66 69 6c 65 73 20 66 |ing text| files f|
|000000b0| 6f 72 6d 61 74 74 65 64 | 20 69 6e 20 53 47 4d 4c |ormatted| in SGML|
|000000c0| 20 28 53 74 61 6e 64 61 | 72 64 20 47 65 6e 65 72 | (Standa|rd Gener|
|000000d0| 61 6c 69 7a 65 64 0a 4d | 61 72 6b 2d 75 70 20 4c |alized.M|ark-up L|
|000000e0| 61 6e 67 75 61 67 65 29 | 2e 20 20 49 6e 20 66 61 |anguage)|.  In fa|
|000000f0| 63 74 2c 20 69 74 20 64 | 6f 65 73 20 6e 6f 74 20 |ct, it d|oes not |
|00000100| 70 72 6f 76 69 64 65 20 | 61 20 66 75 6c 6c 20 53 |provide |a full S|
|00000110| 47 4d 4c 20 70 61 72 73 | 65 72 0a 2d 2d 2d 20 69 |GML pars|er.--- i|
|00000120| 74 20 6f 6e 6c 79 20 70 | 61 72 73 65 73 20 53 47 |t only p|arses SG|
|00000130| 4d 4c 20 69 6e 73 6f 66 | 61 72 20 61 73 20 69 74 |ML insof|ar as it|
|00000140| 20 69 73 20 75 73 65 64 | 20 62 79 20 48 54 4d 4c | is used| by HTML|
|00000150| 2c 20 61 6e 64 20 74 68 | 65 20 6d 6f 64 75 6c 65 |, and th|e module|
|00000160| 0a 6f 6e 6c 79 20 65 78 | 69 73 74 73 20 61 73 20 |.only ex|ists as |
|00000170| 61 20 62 61 73 65 20 66 | 6f 72 20 74 68 65 20 5c |a base f|or the \|
|00000180| 63 6f 64 65 7b 68 74 6d | 6c 6c 69 62 7d 20 6d 6f |code{htm|llib} mo|
|00000190| 64 75 6c 65 2e 0a 5c 73 | 74 6d 6f 64 69 6e 64 65 |dule..\s|tmodinde|
|000001a0| 78 7b 68 74 6d 6c 6c 69 | 62 7d 0a 0a 49 6e 20 70 |x{htmlli|b}..In p|
|000001b0| 61 72 74 69 63 75 6c 61 | 72 2c 20 74 68 65 20 70 |articula|r, the p|
|000001c0| 61 72 73 65 72 20 69 73 | 20 68 61 72 64 63 6f 64 |arser is| hardcod|
|000001d0| 65 64 20 74 6f 20 72 65 | 63 6f 67 6e 69 7a 65 20 |ed to re|cognize |
|000001e0| 74 68 65 20 66 6f 6c 6c | 6f 77 69 6e 67 0a 63 6f |the foll|owing.co|
|000001f0| 6e 73 74 72 75 63 74 73 | 3a 0a 0a 5c 62 65 67 69 |nstructs|:..\begi|
|00000200| 6e 7b 69 74 65 6d 69 7a | 65 7d 0a 0a 5c 69 74 65 |n{itemiz|e}..\ite|
|00000210| 6d 0a 4f 70 65 6e 69 6e | 67 20 61 6e 64 20 63 6c |m.Openin|g and cl|
|00000220| 6f 73 69 6e 67 20 74 61 | 67 73 20 6f 66 20 74 68 |osing ta|gs of th|
|00000230| 65 20 66 6f 72 6d 0a 60 | 60 5c 63 6f 64 65 7b 3c |e form.`|`\code{<|
|00000240| 5c 76 61 72 7b 74 61 67 | 7d 20 5c 76 61 72 7b 61 |\var{tag|} \var{a|
|00000250| 74 74 72 7d 3d 22 5c 76 | 61 72 7b 76 61 6c 75 65 |ttr}="\v|ar{value|
|00000260| 7d 22 20 2e 2e 2e 3e 7d | 27 27 20 61 6e 64 0a 60 |}" ...>}|'' and.`|
|00000270| 60 5c 63 6f 64 65 7b 3c | 2f 5c 76 61 72 7b 74 61 |`\code{<|/\var{ta|
|00000280| 67 7d 3e 7d 27 27 2c 20 | 72 65 73 70 65 63 74 69 |g}>}'', |respecti|
|00000290| 76 65 6c 79 2e 0a 0a 5c | 69 74 65 6d 0a 4e 75 6d |vely...\|item.Num|
|000002a0| 65 72 69 63 20 63 68 61 | 72 61 63 74 65 72 20 72 |eric cha|racter r|
|000002b0| 65 66 65 72 65 6e 63 65 | 73 20 6f 66 20 74 68 65 |eference|s of the|
|000002c0| 20 66 6f 72 6d 20 60 60 | 5c 63 6f 64 65 7b 5c 26 | form ``|\code{\&|
|000002d0| 5c 23 5c 76 61 72 7b 6e | 61 6d 65 7d 3b 7d 27 27 |\#\var{n|ame};}''|
|000002e0| 2e 0a 0a 5c 69 74 65 6d | 0a 45 6e 74 69 74 79 20 |...\item|.Entity |
|000002f0| 72 65 66 65 72 65 6e 63 | 65 73 20 6f 66 20 74 68 |referenc|es of th|
|00000300| 65 20 66 6f 72 6d 20 60 | 60 5c 63 6f 64 65 7b 5c |e form `|`\code{\|
|00000310| 26 5c 76 61 72 7b 6e 61 | 6d 65 7d 3b 7d 27 27 2e |&\var{na|me};}''.|
|00000320| 0a 0a 5c 69 74 65 6d 0a | 53 47 4d 4c 20 63 6f 6d |..\item.|SGML com|
|00000330| 6d 65 6e 74 73 20 6f 66 | 20 74 68 65 20 66 6f 72 |ments of| the for|
|00000340| 6d 20 60 60 5c 63 6f 64 | 65 7b 3c 21 2d 2d 5c 76 |m ``\cod|e{<!--\v|
|00000350| 61 72 7b 74 65 78 74 7d | 2d 2d 3e 7d 27 27 2e 20 |ar{text}|-->}''. |
|00000360| 20 4e 6f 74 65 20 74 68 | 61 74 0a 73 70 61 63 65 | Note th|at.space|
|00000370| 73 2c 20 74 61 62 73 2c | 20 61 6e 64 20 6e 65 77 |s, tabs,| and new|
|00000380| 6c 69 6e 65 73 20 61 72 | 65 20 61 6c 6c 6f 77 65 |lines ar|e allowe|
|00000390| 64 20 62 65 74 77 65 65 | 6e 20 74 68 65 20 74 72 |d betwee|n the tr|
|000003a0| 61 69 6c 69 6e 67 0a 60 | 60 5c 63 6f 64 65 7b 3e |ailing.`|`\code{>|
|000003b0| 7d 27 27 20 61 6e 64 20 | 74 68 65 20 69 6d 6d 65 |}'' and |the imme|
|000003c0| 64 69 61 74 65 6c 79 20 | 70 72 65 63 65 65 64 69 |diately |preceedi|
|000003d0| 6e 67 20 60 60 5c 63 6f | 64 65 7b 2d 2d 7d 27 27 |ng ``\co|de{--}''|
|000003e0| 2e 0a 0a 5c 65 6e 64 7b | 69 74 65 6d 69 7a 65 7d |...\end{|itemize}|
|000003f0| 0a 0a 54 68 65 20 5c 63 | 6f 64 65 7b 53 47 4d 4c |..The \c|ode{SGML|
|00000400| 50 61 72 73 65 72 7d 20 | 63 6c 61 73 73 20 6d 75 |Parser} |class mu|
|00000410| 73 74 20 62 65 20 69 6e | 73 74 61 6e 74 69 61 74 |st be in|stantiat|
|00000420| 65 64 20 77 69 74 68 6f | 75 74 20 61 72 67 75 6d |ed witho|ut argum|
|00000430| 65 6e 74 73 2e 0a 49 74 | 20 68 61 73 20 74 68 65 |ents..It| has the|
|00000440| 20 66 6f 6c 6c 6f 77 69 | 6e 67 20 69 6e 74 65 72 | followi|ng inter|
|00000450| 66 61 63 65 20 6d 65 74 | 68 6f 64 73 3a 0a 0a 5c |face met|hods:..\|
|00000460| 72 65 6e 65 77 63 6f 6d | 6d 61 6e 64 7b 5c 69 6e |renewcom|mand{\in|
|00000470| 64 65 78 73 75 62 69 74 | 65 6d 7d 7b 28 7b 5c 74 |dexsubit|em}{({\t|
|00000480| 74 20 53 47 4d 4c 50 61 | 72 73 65 72 7d 20 6d 65 |t SGMLPa|rser} me|
|00000490| 74 68 6f 64 29 7d 0a 0a | 5c 62 65 67 69 6e 7b 66 |thod)}..|\begin{f|
|000004a0| 75 6e 63 64 65 73 63 7d | 7b 72 65 73 65 74 7d 7b |uncdesc}|{reset}{|
|000004b0| 7d 0a 52 65 73 65 74 20 | 74 68 65 20 69 6e 73 74 |}.Reset |the inst|
|000004c0| 61 6e 63 65 2e 20 20 4c | 6f 73 65 73 20 61 6c 6c |ance.  L|oses all|
|000004d0| 20 75 6e 70 72 6f 63 65 | 73 73 65 64 20 64 61 74 | unproce|ssed dat|
|000004e0| 61 2e 20 20 54 68 69 73 | 20 69 73 20 63 61 6c 6c |a.  This| is call|
|000004f0| 65 64 0a 69 6d 70 6c 69 | 63 69 74 6c 79 20 61 74 |ed.impli|citly at|
|00000500| 20 69 6e 73 74 61 6e 74 | 69 61 74 69 6f 6e 20 74 | instant|iation t|
|00000510| 69 6d 65 2e 0a 5c 65 6e | 64 7b 66 75 6e 63 64 65 |ime..\en|d{funcde|
|00000520| 73 63 7d 0a 0a 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|00000530| 64 65 73 63 7d 7b 73 65 | 74 6e 6f 6d 6f 72 65 74 |desc}{se|tnomoret|
|00000540| 61 67 73 7d 7b 7d 0a 53 | 74 6f 70 20 70 72 6f 63 |ags}{}.S|top proc|
|00000550| 65 73 73 69 6e 67 20 74 | 61 67 73 2e 20 20 54 72 |essing t|ags.  Tr|
|00000560| 65 61 74 20 61 6c 6c 20 | 66 6f 6c 6c 6f 77 69 6e |eat all |followin|
|00000570| 67 20 69 6e 70 75 74 20 | 61 73 20 6c 69 74 65 72 |g input |as liter|
|00000580| 61 6c 20 69 6e 70 75 74 | 0a 28 43 44 41 54 41 29 |al input|.(CDATA)|
|00000590| 2e 20 20 28 54 68 69 73 | 20 69 73 20 6f 6e 6c 79 |.  (This| is only|
|000005a0| 20 70 72 6f 76 69 64 65 | 64 20 73 6f 20 74 68 65 | provide|d so the|
|000005b0| 20 48 54 4d 4c 20 74 61 | 67 20 5c 63 6f 64 65 7b | HTML ta|g \code{|
|000005c0| 3c 50 4c 41 49 4e 54 45 | 58 54 3e 7d 0a 63 61 6e |<PLAINTE|XT>}.can|
|000005d0| 20 62 65 20 69 6d 70 6c | 65 6d 65 6e 74 65 64 2e | be impl|emented.|
|000005e0| 29 0a 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |).\end{f|uncdesc}|
|000005f0| 0a 0a 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00000600| 63 7d 7b 73 65 74 6c 69 | 74 65 72 61 6c 7d 7b 7d |c}{setli|teral}{}|
|00000610| 0a 45 6e 74 65 72 20 6c | 69 74 65 72 61 6c 20 6d |.Enter l|iteral m|
|00000620| 6f 64 65 20 28 43 44 41 | 54 41 20 6d 6f 64 65 29 |ode (CDA|TA mode)|
|00000630| 2e 0a 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|00000640| 0a 0a 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00000650| 63 7d 7b 66 65 65 64 7d | 7b 64 61 74 61 7d 0a 46 |c}{feed}|{data}.F|
|00000660| 65 65 64 20 73 6f 6d 65 | 20 74 65 78 74 20 74 6f |eed some| text to|
|00000670| 20 74 68 65 20 70 61 72 | 73 65 72 2e 20 20 49 74 | the par|ser.  It|
|00000680| 20 69 73 20 70 72 6f 63 | 65 73 73 65 64 20 69 6e | is proc|essed in|
|00000690| 73 6f 66 61 72 20 61 73 | 20 69 74 20 63 6f 6e 73 |sofar as| it cons|
|000006a0| 69 73 74 73 0a 6f 66 20 | 63 6f 6d 70 6c 65 74 65 |ists.of |complete|
|000006b0| 20 65 6c 65 6d 65 6e 74 | 73 3b 20 69 6e 63 6f 6d | element|s; incom|
|000006c0| 70 6c 65 74 65 20 64 61 | 74 61 20 69 73 20 62 75 |plete da|ta is bu|
|000006d0| 66 66 65 72 65 64 20 75 | 6e 74 69 6c 20 6d 6f 72 |ffered u|ntil mor|
|000006e0| 65 20 64 61 74 61 20 69 | 73 0a 66 65 64 20 6f 72 |e data i|s.fed or|
|000006f0| 20 5c 63 6f 64 65 7b 63 | 6c 6f 73 65 28 29 7d 20 | \code{c|lose()} |
|00000700| 69 73 20 63 61 6c 6c 65 | 64 2e 0a 5c 65 6e 64 7b |is calle|d..\end{|
|00000710| 66 75 6e 63 64 65 73 63 | 7d 0a 0a 5c 62 65 67 69 |funcdesc|}..\begi|
|00000720| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 63 6c 6f 73 |n{funcde|sc}{clos|
|00000730| 65 7d 7b 7d 0a 46 6f 72 | 63 65 20 70 72 6f 63 65 |e}{}.For|ce proce|
|00000740| 73 73 69 6e 67 20 6f 66 | 20 61 6c 6c 20 62 75 66 |ssing of| all buf|
|00000750| 66 65 72 65 64 20 64 61 | 74 61 20 61 73 20 69 66 |fered da|ta as if|
|00000760| 20 69 74 20 77 65 72 65 | 20 66 6f 6c 6c 6f 77 65 | it were| followe|
|00000770| 64 20 62 79 20 61 6e 0a | 65 6e 64 2d 6f 66 2d 66 |d by an.|end-of-f|
|00000780| 69 6c 65 20 6d 61 72 6b | 2e 20 20 54 68 69 73 20 |ile mark|.  This |
|00000790| 6d 65 74 68 6f 64 20 6d | 61 79 20 62 65 20 72 65 |method m|ay be re|
|000007a0| 64 65 66 69 6e 65 64 20 | 62 79 20 61 20 64 65 72 |defined |by a der|
|000007b0| 69 76 65 64 20 63 6c 61 | 73 73 20 74 6f 0a 64 65 |ived cla|ss to.de|
|000007c0| 66 69 6e 65 20 61 64 64 | 69 74 69 6f 6e 61 6c 20 |fine add|itional |
|000007d0| 70 72 6f 63 65 73 73 69 | 6e 67 20 61 74 20 74 68 |processi|ng at th|
|000007e0| 65 20 65 6e 64 20 6f 66 | 20 74 68 65 20 69 6e 70 |e end of| the inp|
|000007f0| 75 74 2c 20 62 75 74 20 | 74 68 65 0a 72 65 64 65 |ut, but |the.rede|
|00000800| 66 69 6e 65 64 20 76 65 | 72 73 69 6f 6e 20 73 68 |fined ve|rsion sh|
|00000810| 6f 75 6c 64 20 61 6c 77 | 61 79 73 20 63 61 6c 6c |ould alw|ays call|
|00000820| 20 5c 63 6f 64 65 7b 53 | 47 4d 4c 50 61 72 73 65 | \code{S|GMLParse|
|00000830| 72 2e 63 6c 6f 73 65 28 | 29 7d 2e 0a 5c 65 6e 64 |r.close(|)}..\end|
|00000840| 7b 66 75 6e 63 64 65 73 | 63 7d 0a 0a 5c 62 65 67 |{funcdes|c}..\beg|
|00000850| 69 6e 7b 66 75 6e 63 64 | 65 73 63 7d 7b 68 61 6e |in{funcd|esc}{han|
|00000860| 64 6c 65 5f 73 74 61 72 | 74 74 61 67 7d 7b 74 61 |dle_star|ttag}{ta|
|00000870| 67 5c 2c 20 6d 65 74 68 | 6f 64 5c 2c 20 61 74 74 |g\, meth|od\, att|
|00000880| 72 69 62 75 74 65 73 7d | 0a 54 68 69 73 20 6d 65 |ributes}|.This me|
|00000890| 74 68 6f 64 20 69 73 20 | 63 61 6c 6c 65 64 20 74 |thod is |called t|
|000008a0| 6f 20 68 61 6e 64 6c 65 | 20 73 74 61 72 74 20 74 |o handle| start t|
|000008b0| 61 67 73 20 66 6f 72 20 | 77 68 69 63 68 20 65 69 |ags for |which ei|
|000008c0| 74 68 65 72 20 61 0a 5c | 63 6f 64 65 7b 73 74 61 |ther a.\|code{sta|
|000008d0| 72 74 5f 5c 76 61 72 7b | 74 61 67 7d 28 29 7d 20 |rt_\var{|tag}()} |
|000008e0| 6f 72 20 5c 63 6f 64 65 | 7b 64 6f 5f 5c 76 61 72 |or \code|{do_\var|
|000008f0| 7b 74 61 67 7d 28 29 7d | 20 6d 65 74 68 6f 64 20 |{tag}()}| method |
|00000900| 68 61 73 20 62 65 65 6e | 0a 64 65 66 69 6e 65 64 |has been|.defined|
|00000910| 2e 20 20 54 68 65 20 5c | 63 6f 64 65 7b 74 61 67 |.  The \|code{tag|
|00000920| 7d 20 61 72 67 75 6d 65 | 6e 74 20 69 73 20 74 68 |} argume|nt is th|
|00000930| 65 20 6e 61 6d 65 20 6f | 66 20 74 68 65 20 74 61 |e name o|f the ta|
|00000940| 67 20 63 6f 6e 76 65 72 | 74 65 64 20 74 6f 0a 6c |g conver|ted to.l|
|00000950| 6f 77 65 72 20 63 61 73 | 65 2c 20 61 6e 64 20 74 |ower cas|e, and t|
|00000960| 68 65 20 5c 63 6f 64 65 | 7b 6d 65 74 68 6f 64 7d |he \code|{method}|
|00000970| 20 61 72 67 75 6d 65 6e | 74 20 69 73 20 74 68 65 | argumen|t is the|
|00000980| 20 62 6f 75 6e 64 20 6d | 65 74 68 6f 64 20 77 68 | bound m|ethod wh|
|00000990| 69 63 68 0a 73 68 6f 75 | 6c 64 20 62 65 20 75 73 |ich.shou|ld be us|
|000009a0| 65 64 20 74 6f 20 73 75 | 70 70 6f 72 74 20 73 65 |ed to su|pport se|
|000009b0| 6d 61 6e 74 69 63 20 69 | 6e 74 65 72 70 72 65 74 |mantic i|nterpret|
|000009c0| 61 74 69 6f 6e 20 6f 66 | 20 74 68 65 20 73 74 61 |ation of| the sta|
|000009d0| 72 74 20 74 61 67 2e 0a | 54 68 65 20 5c 76 61 72 |rt tag..|The \var|
|000009e0| 7b 61 74 74 72 69 62 75 | 74 65 73 7d 20 61 72 67 |{attribu|tes} arg|
|000009f0| 75 6d 65 6e 74 20 69 73 | 20 61 20 6c 69 73 74 20 |ument is| a list |
|00000a00| 6f 66 20 28 5c 76 61 72 | 7b 6e 61 6d 65 7d 2c 20 |of (\var|{name}, |
|00000a10| 5c 76 61 72 7b 76 61 6c | 75 65 7d 29 0a 70 61 69 |\var{val|ue}).pai|
|00000a20| 72 73 20 63 6f 6e 74 61 | 69 6e 69 6e 67 20 74 68 |rs conta|ining th|
|00000a30| 65 20 61 74 74 72 69 62 | 75 74 65 73 20 66 6f 75 |e attrib|utes fou|
|00000a40| 6e 64 20 69 6e 73 69 64 | 65 20 74 68 65 20 74 61 |nd insid|e the ta|
|00000a50| 67 27 73 20 5c 63 6f 64 | 65 7b 3c 3e 7d 0a 62 72 |g's \cod|e{<>}.br|
|00000a60| 61 63 6b 65 74 73 2e 20 | 20 54 68 65 20 5c 76 61 |ackets. | The \va|
|00000a70| 72 7b 6e 61 6d 65 7d 20 | 68 61 73 20 62 65 65 6e |r{name} |has been|
|00000a80| 20 74 72 61 6e 73 6c 61 | 74 65 64 20 74 6f 20 6c | transla|ted to l|
|00000a90| 6f 77 65 72 20 63 61 73 | 65 20 61 6e 64 20 64 6f |ower cas|e and do|
|00000aa0| 75 62 6c 65 0a 71 75 6f | 74 65 73 20 61 6e 64 20 |uble.quo|tes and |
|00000ab0| 62 61 63 6b 73 6c 61 73 | 68 65 73 20 69 6e 20 74 |backslas|hes in t|
|00000ac0| 68 65 20 5c 76 61 72 7b | 76 61 6c 75 65 7d 20 68 |he \var{|value} h|
|00000ad0| 61 76 65 20 62 65 65 6e | 20 69 6e 74 65 72 70 72 |ave been| interpr|
|00000ae0| 65 74 65 64 2e 20 20 46 | 6f 72 0a 69 6e 73 74 61 |eted.  F|or.insta|
|00000af0| 6e 63 65 2c 20 66 6f 72 | 20 74 68 65 20 74 61 67 |nce, for| the tag|
|00000b00| 20 5c 63 6f 64 65 7b 3c | 41 20 48 52 45 46 3d 22 | \code{<|A HREF="|
|00000b10| 68 74 74 70 3a 2f 2f 77 | 77 77 2e 63 77 69 2e 6e |http://w|ww.cwi.n|
|00000b20| 6c 2f 22 3e 7d 2c 20 74 | 68 69 73 0a 6d 65 74 68 |l/">}, t|his.meth|
|00000b30| 6f 64 20 77 6f 75 6c 64 | 20 62 65 20 63 61 6c 6c |od would| be call|
|00000b40| 65 64 20 61 73 20 5c 63 | 6f 64 65 7b 75 6e 6b 6e |ed as \c|ode{unkn|
|00000b50| 6f 77 6e 5f 73 74 61 72 | 74 74 61 67 28 27 61 27 |own_star|ttag('a'|
|00000b60| 2c 20 5b 28 27 68 72 65 | 66 27 2c 0a 27 68 74 74 |, [('hre|f',.'htt|
|00000b70| 70 3a 2f 2f 77 77 77 2e | 63 77 69 2e 6e 6c 2f 27 |p://www.|cwi.nl/'|
|00000b80| 29 5d 29 7d 2e 20 20 54 | 68 65 20 62 61 73 65 20 |)])}.  T|he base |
|00000b90| 69 6d 70 6c 65 6d 65 6e | 74 61 74 69 6f 6e 20 73 |implemen|tation s|
|00000ba0| 69 6d 70 6c 79 20 63 61 | 6c 6c 73 0a 5c 63 6f 64 |imply ca|lls.\cod|
|00000bb0| 65 7b 6d 65 74 68 6f 64 | 7d 20 77 69 74 68 20 5c |e{method|} with \|
|00000bc0| 63 6f 64 65 7b 61 74 74 | 72 69 62 75 74 65 73 7d |code{att|ributes}|
|00000bd0| 20 61 73 20 74 68 65 20 | 6f 6e 6c 79 20 61 72 67 | as the |only arg|
|00000be0| 75 6d 65 6e 74 2e 0a 5c | 65 6e 64 7b 66 75 6e 63 |ument..\|end{func|
|00000bf0| 64 65 73 63 7d 0a 0a 5c | 62 65 67 69 6e 7b 66 75 |desc}..\|begin{fu|
|00000c00| 6e 63 64 65 73 63 7d 7b | 68 61 6e 64 6c 65 5f 65 |ncdesc}{|handle_e|
|00000c10| 6e 64 74 61 67 7d 7b 74 | 61 67 5c 2c 20 6d 65 74 |ndtag}{t|ag\, met|
|00000c20| 68 6f 64 7d 0a 0a 54 68 | 69 73 20 6d 65 74 68 6f |hod}..Th|is metho|
|00000c30| 64 20 69 73 20 63 61 6c | 6c 65 64 20 74 6f 20 68 |d is cal|led to h|
|00000c40| 61 6e 64 6c 65 20 65 6e | 64 74 61 67 73 20 66 6f |andle en|dtags fo|
|00000c50| 72 20 77 68 69 63 68 20 | 61 6e 0a 5c 63 6f 64 65 |r which |an.\code|
|00000c60| 7b 65 6e 64 5f 5c 76 61 | 72 7b 74 61 67 7d 28 29 |{end_\va|r{tag}()|
|00000c70| 7d 20 6d 65 74 68 6f 64 | 20 68 61 73 20 62 65 65 |} method| has bee|
|00000c80| 6e 20 64 65 66 69 6e 65 | 64 2e 20 20 54 68 65 20 |n define|d.  The |
|00000c90| 5c 63 6f 64 65 7b 74 61 | 67 7d 0a 61 72 67 75 6d |\code{ta|g}.argum|
|00000ca0| 65 6e 74 20 69 73 20 74 | 68 65 20 6e 61 6d 65 20 |ent is t|he name |
|00000cb0| 6f 66 20 74 68 65 20 74 | 61 67 20 63 6f 6e 76 65 |of the t|ag conve|
|00000cc0| 72 74 65 64 20 74 6f 20 | 6c 6f 77 65 72 20 63 61 |rted to |lower ca|
|00000cd0| 73 65 2c 20 61 6e 64 20 | 74 68 65 0a 5c 63 6f 64 |se, and |the.\cod|
|00000ce0| 65 7b 6d 65 74 68 6f 64 | 7d 20 61 72 67 75 6d 65 |e{method|} argume|
|00000cf0| 6e 74 20 69 73 20 74 68 | 65 20 62 6f 75 6e 64 20 |nt is th|e bound |
|00000d00| 6d 65 74 68 6f 64 20 77 | 68 69 63 68 20 73 68 6f |method w|hich sho|
|00000d10| 75 6c 64 20 62 65 20 75 | 73 65 64 20 74 6f 0a 73 |uld be u|sed to.s|
|00000d20| 75 70 70 6f 72 74 20 73 | 65 6d 61 6e 74 69 63 20 |upport s|emantic |
|00000d30| 69 6e 74 65 72 70 72 65 | 74 61 74 69 6f 6e 20 6f |interpre|tation o|
|00000d40| 66 20 74 68 65 20 65 6e | 64 20 74 61 67 2e 20 20 |f the en|d tag.  |
|00000d50| 49 66 20 6e 6f 0a 5c 63 | 6f 64 65 7b 65 6e 64 5f |If no.\c|ode{end_|
|00000d60| 5c 76 61 72 7b 74 61 67 | 7d 28 29 7d 20 6d 65 74 |\var{tag|}()} met|
|00000d70| 68 6f 64 20 69 73 20 64 | 65 66 69 6e 65 64 20 66 |hod is d|efined f|
|00000d80| 6f 72 20 74 68 65 20 63 | 6c 6f 73 69 6e 67 20 65 |or the c|losing e|
|00000d90| 6c 65 6d 65 6e 74 2c 20 | 74 68 69 73 0a 68 61 6e |lement, |this.han|
|00000da0| 64 6c 65 72 20 69 73 20 | 6e 6f 74 20 63 61 6c 6c |dler is |not call|
|00000db0| 65 64 2e 20 20 54 68 65 | 20 62 61 73 65 20 69 6d |ed.  The| base im|
|00000dc0| 70 6c 65 6d 65 6e 74 61 | 74 69 6f 6e 20 73 69 6d |plementa|tion sim|
|00000dd0| 70 6c 79 20 63 61 6c 6c | 73 0a 5c 63 6f 64 65 7b |ply call|s.\code{|
|00000de0| 6d 65 74 68 6f 64 7d 2e | 0a 5c 65 6e 64 7b 66 75 |method}.|.\end{fu|
|00000df0| 6e 63 64 65 73 63 7d 0a | 0a 5c 62 65 67 69 6e 7b |ncdesc}.|.\begin{|
|00000e00| 66 75 6e 63 64 65 73 63 | 7d 7b 68 61 6e 64 6c 65 |funcdesc|}{handle|
|00000e10| 5f 64 61 74 61 7d 7b 64 | 61 74 61 7d 0a 54 68 69 |_data}{d|ata}.Thi|
|00000e20| 73 20 6d 65 74 68 6f 64 | 20 69 73 20 63 61 6c 6c |s method| is call|
|00000e30| 65 64 20 74 6f 20 70 72 | 6f 63 65 73 73 20 61 72 |ed to pr|ocess ar|
|00000e40| 62 69 74 72 61 72 79 20 | 64 61 74 61 2e 20 20 49 |bitrary |data.  I|
|00000e50| 74 20 69 73 20 69 6e 74 | 65 6e 64 65 64 20 74 6f |t is int|ended to|
|00000e60| 20 62 65 0a 6f 76 65 72 | 72 69 64 64 65 6e 20 62 | be.over|ridden b|
|00000e70| 79 20 61 20 64 65 72 69 | 76 65 64 20 63 6c 61 73 |y a deri|ved clas|
|00000e80| 73 3b 20 74 68 65 20 62 | 61 73 65 20 63 6c 61 73 |s; the b|ase clas|
|00000e90| 73 20 69 6d 70 6c 65 6d | 65 6e 74 61 74 69 6f 6e |s implem|entation|
|00000ea0| 20 64 6f 65 73 0a 6e 6f | 74 68 69 6e 67 2e 0a 5c | does.no|thing..\|
|00000eb0| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0a 0a 5c |end{func|desc}..\|
|00000ec0| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|00000ed0| 68 61 6e 64 6c 65 5f 63 | 68 61 72 72 65 66 7d 7b |handle_c|harref}{|
|00000ee0| 72 65 66 7d 0a 54 68 69 | 73 20 6d 65 74 68 6f 64 |ref}.Thi|s method|
|00000ef0| 20 69 73 20 63 61 6c 6c | 65 64 20 74 6f 20 70 72 | is call|ed to pr|
|00000f00| 6f 63 65 73 73 20 61 20 | 63 68 61 72 61 63 74 65 |ocess a |characte|
|00000f10| 72 20 72 65 66 65 72 65 | 6e 63 65 20 6f 66 20 74 |r refere|nce of t|
|00000f20| 68 65 20 66 6f 72 6d 0a | 60 60 5c 63 6f 64 65 7b |he form.|``\code{|
|00000f30| 5c 26 5c 23 5c 76 61 72 | 7b 72 65 66 7d 3b 7d 27 |\&\#\var|{ref};}'|
|00000f40| 27 2e 20 20 49 6e 20 74 | 68 65 20 62 61 73 65 20 |'.  In t|he base |
|00000f50| 69 6d 70 6c 65 6d 65 6e | 74 61 74 69 6f 6e 2c 20 |implemen|tation, |
|00000f60| 5c 76 61 72 7b 72 65 66 | 7d 20 6d 75 73 74 0a 62 |\var{ref|} must.b|
|00000f70| 65 20 61 20 64 65 63 69 | 6d 61 6c 20 6e 75 6d 62 |e a deci|mal numb|
|00000f80| 65 72 20 69 6e 20 74 68 | 65 0a 72 61 6e 67 65 20 |er in th|e.range |
|00000f90| 30 2d 32 35 35 2e 20 20 | 49 74 20 74 72 61 6e 73 |0-255.  |It trans|
|00000fa0| 6c 61 74 65 73 20 74 68 | 65 20 63 68 61 72 61 63 |lates th|e charac|
|00000fb0| 74 65 72 20 74 6f 20 5c | 41 53 43 49 49 7b 7d 20 |ter to \|ASCII{} |
|00000fc0| 61 6e 64 20 63 61 6c 6c | 73 20 74 68 65 0a 6d 65 |and call|s the.me|
|00000fd0| 74 68 6f 64 20 5c 63 6f | 64 65 7b 68 61 6e 64 6c |thod \co|de{handl|
|00000fe0| 65 5f 64 61 74 61 28 29 | 7d 20 77 69 74 68 20 74 |e_data()|} with t|
|00000ff0| 68 65 20 63 68 61 72 61 | 63 74 65 72 20 61 73 20 |he chara|cter as |
|00001000| 61 72 67 75 6d 65 6e 74 | 2e 20 20 49 66 0a 5c 76 |argument|.  If.\v|
|00001010| 61 72 7b 72 65 66 7d 20 | 69 73 20 69 6e 76 61 6c |ar{ref} |is inval|
|00001020| 69 64 20 6f 72 20 6f 75 | 74 20 6f 66 20 72 61 6e |id or ou|t of ran|
|00001030| 67 65 2c 20 74 68 65 20 | 6d 65 74 68 6f 64 0a 5c |ge, the |method.\|
|00001040| 63 6f 64 65 7b 75 6e 6b | 6e 6f 77 6e 5f 63 68 61 |code{unk|nown_cha|
|00001050| 72 72 65 66 28 5c 76 61 | 72 7b 72 65 66 7d 29 7d |rref(\va|r{ref})}|
|00001060| 20 69 73 20 63 61 6c 6c | 65 64 20 74 6f 20 68 61 | is call|ed to ha|
|00001070| 6e 64 6c 65 20 74 68 65 | 20 65 72 72 6f 72 2e 20 |ndle the| error. |
|00001080| 20 41 0a 73 75 62 63 6c | 61 73 73 20 6d 75 73 74 | A.subcl|ass must|
|00001090| 20 6f 76 65 72 72 69 64 | 65 20 74 68 69 73 20 6d | overrid|e this m|
|000010a0| 65 74 68 6f 64 20 74 6f | 20 70 72 6f 76 69 64 65 |ethod to| provide|
|000010b0| 20 73 75 70 70 6f 72 74 | 20 66 6f 72 20 6e 61 6d | support| for nam|
|000010c0| 65 64 0a 63 68 61 72 61 | 63 74 65 72 20 65 6e 74 |ed.chara|cter ent|
|000010d0| 69 74 69 65 73 2e 0a 5c | 65 6e 64 7b 66 75 6e 63 |ities..\|end{func|
|000010e0| 64 65 73 63 7d 0a 0a 5c | 62 65 67 69 6e 7b 66 75 |desc}..\|begin{fu|
|000010f0| 6e 63 64 65 73 63 7d 7b | 68 61 6e 64 6c 65 5f 65 |ncdesc}{|handle_e|
|00001100| 6e 74 69 74 79 72 65 66 | 7d 7b 72 65 66 7d 0a 54 |ntityref|}{ref}.T|
|00001110| 68 69 73 20 6d 65 74 68 | 6f 64 20 69 73 20 63 61 |his meth|od is ca|
|00001120| 6c 6c 65 64 20 74 6f 20 | 70 72 6f 63 65 73 73 20 |lled to |process |
|00001130| 61 20 67 65 6e 65 72 61 | 6c 20 65 6e 74 69 74 79 |a genera|l entity|
|00001140| 20 72 65 66 65 72 65 6e | 63 65 20 6f 66 20 74 68 | referen|ce of th|
|00001150| 65 20 66 6f 72 6d 0a 60 | 60 5c 63 6f 64 65 7b 5c |e form.`|`\code{\|
|00001160| 26 5c 76 61 72 7b 72 65 | 66 7d 3b 7d 27 27 20 77 |&\var{re|f};}'' w|
|00001170| 68 65 72 65 20 5c 76 61 | 72 7b 72 65 66 7d 20 69 |here \va|r{ref} i|
|00001180| 73 20 61 6e 20 67 65 6e | 65 72 61 6c 20 65 6e 74 |s an gen|eral ent|
|00001190| 69 74 79 0a 72 65 66 65 | 72 65 6e 63 65 2e 20 20 |ity.refe|rence.  |
|000011a0| 49 74 20 6c 6f 6f 6b 73 | 20 66 6f 72 20 5c 76 61 |It looks| for \va|
|000011b0| 72 7b 72 65 66 7d 20 69 | 6e 20 74 68 65 20 69 6e |r{ref} i|n the in|
|000011c0| 73 74 61 6e 63 65 20 28 | 6f 72 20 63 6c 61 73 73 |stance (|or class|
|000011d0| 29 0a 76 61 72 69 61 62 | 6c 65 20 5c 63 6f 64 65 |).variab|le \code|
|000011e0| 7b 65 6e 74 69 74 79 64 | 65 66 73 7d 20 77 68 69 |{entityd|efs} whi|
|000011f0| 63 68 20 73 68 6f 75 6c | 64 20 62 65 20 61 20 6d |ch shoul|d be a m|
|00001200| 61 70 70 69 6e 67 20 66 | 72 6f 6d 20 65 6e 74 69 |apping f|rom enti|
|00001210| 74 79 20 6e 61 6d 65 73 | 0a 74 6f 20 63 6f 72 72 |ty names|.to corr|
|00001220| 65 73 70 6f 6e 64 69 6e | 67 20 74 72 61 6e 73 6c |espondin|g transl|
|00001230| 61 74 69 6f 6e 73 2e 0a | 49 66 20 61 20 74 72 61 |ations..|If a tra|
|00001240| 6e 73 6c 61 74 69 6f 6e | 20 69 73 20 66 6f 75 6e |nslation| is foun|
|00001250| 64 2c 20 69 74 20 63 61 | 6c 6c 73 20 74 68 65 20 |d, it ca|lls the |
|00001260| 6d 65 74 68 6f 64 20 5c | 63 6f 64 65 7b 68 61 6e |method \|code{han|
|00001270| 64 6c 65 5f 64 61 74 61 | 28 29 7d 0a 77 69 74 68 |dle_data|()}.with|
|00001280| 20 74 68 65 20 74 72 61 | 6e 73 6c 61 74 69 6f 6e | the tra|nslation|
|00001290| 3b 20 6f 74 68 65 72 77 | 69 73 65 2c 20 69 74 20 |; otherw|ise, it |
|000012a0| 63 61 6c 6c 73 20 74 68 | 65 20 6d 65 74 68 6f 64 |calls th|e method|
|000012b0| 0a 5c 63 6f 64 65 7b 75 | 6e 6b 6e 6f 77 6e 5f 65 |.\code{u|nknown_e|
|000012c0| 6e 74 69 74 79 72 65 66 | 28 5c 76 61 72 7b 72 65 |ntityref|(\var{re|
|000012d0| 66 7d 29 7d 2e 20 20 54 | 68 65 20 64 65 66 61 75 |f})}.  T|he defau|
|000012e0| 6c 74 20 5c 63 6f 64 65 | 7b 65 6e 74 69 74 79 64 |lt \code|{entityd|
|000012f0| 65 66 73 7d 0a 64 65 66 | 69 6e 65 73 20 74 72 61 |efs}.def|ines tra|
|00001300| 6e 73 6c 61 74 69 6f 6e | 73 20 66 6f 72 20 5c 63 |nslation|s for \c|
|00001310| 6f 64 65 7b 5c 26 61 6d | 70 3b 7d 2c 20 5c 63 6f |ode{\&am|p;}, \co|
|00001320| 64 65 7b 5c 26 61 70 6f | 73 7d 2c 20 5c 63 6f 64 |de{\&apo|s}, \cod|
|00001330| 65 7b 5c 26 67 74 3b 7d | 2c 0a 5c 63 6f 64 65 7b |e{\&gt;}|,.\code{|
|00001340| 5c 26 6c 74 3b 7d 2c 20 | 61 6e 64 20 5c 63 6f 64 |\&lt;}, |and \cod|
|00001350| 65 7b 5c 26 71 75 6f 74 | 3b 7d 2e 0a 5c 65 6e 64 |e{\&quot|;}..\end|
|00001360| 7b 66 75 6e 63 64 65 73 | 63 7d 0a 0a 5c 62 65 67 |{funcdes|c}..\beg|
|00001370| 69 6e 7b 66 75 6e 63 64 | 65 73 63 7d 7b 68 61 6e |in{funcd|esc}{han|
|00001380| 64 6c 65 5f 63 6f 6d 6d | 65 6e 74 7d 7b 63 6f 6d |dle_comm|ent}{com|
|00001390| 6d 65 6e 74 7d 0a 54 68 | 69 73 20 6d 65 74 68 6f |ment}.Th|is metho|
|000013a0| 64 20 69 73 20 63 61 6c | 6c 65 64 20 77 68 65 6e |d is cal|led when|
|000013b0| 20 61 20 63 6f 6d 6d 65 | 6e 74 20 69 73 20 65 6e | a comme|nt is en|
|000013c0| 63 6f 75 6e 74 65 72 65 | 64 2e 20 20 54 68 65 0a |countere|d.  The.|
|000013d0| 5c 63 6f 64 65 7b 63 6f | 6d 6d 65 6e 74 7d 20 61 |\code{co|mment} a|
|000013e0| 72 67 75 6d 65 6e 74 20 | 69 73 20 61 20 73 74 72 |rgument |is a str|
|000013f0| 69 6e 67 20 63 6f 6e 74 | 61 69 6e 69 6e 67 20 74 |ing cont|aining t|
|00001400| 68 65 20 74 65 78 74 20 | 62 65 74 77 65 65 6e 20 |he text |between |
|00001410| 74 68 65 0a 60 60 5c 63 | 6f 64 65 7b 3c 21 2d 2d |the.``\c|ode{<!--|
|00001420| 7d 27 27 20 61 6e 64 20 | 60 60 5c 63 6f 64 65 7b |}'' and |``\code{|
|00001430| 2d 2d 3e 7d 27 27 20 64 | 65 6c 69 6d 69 74 65 72 |-->}'' d|elimiter|
|00001440| 73 2c 20 62 75 74 20 6e | 6f 74 20 74 68 65 20 64 |s, but n|ot the d|
|00001450| 65 6c 69 6d 69 74 65 72 | 73 0a 74 68 65 6d 73 65 |elimiter|s.themse|
|00001460| 6c 76 65 73 2e 20 20 46 | 6f 72 20 65 78 61 6d 70 |lves.  F|or examp|
|00001470| 6c 65 2c 20 74 68 65 20 | 63 6f 6d 6d 65 6e 74 20 |le, the |comment |
|00001480| 60 60 5c 63 6f 64 65 7b | 3c 21 2d 2d 74 65 78 74 |``\code{|<!--text|
|00001490| 2d 2d 3e 7d 27 27 20 77 | 69 6c 6c 0a 63 61 75 73 |-->}'' w|ill.caus|
|000014a0| 65 20 74 68 69 73 20 6d | 65 74 68 6f 64 20 74 6f |e this m|ethod to|
|000014b0| 20 62 65 20 63 61 6c 6c | 65 64 20 77 69 74 68 20 | be call|ed with |
|000014c0| 74 68 65 20 61 72 67 75 | 6d 65 6e 74 20 5c 63 6f |the argu|ment \co|
|000014d0| 64 65 7b 27 74 65 78 74 | 27 7d 2e 20 20 54 68 65 |de{'text|'}.  The|
|000014e0| 0a 64 65 66 61 75 6c 74 | 20 6d 65 74 68 6f 64 20 |.default| method |
|000014f0| 64 6f 65 73 20 6e 6f 74 | 68 69 6e 67 2e 0a 5c 65 |does not|hing..\e|
|00001500| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0a 0a 5c 62 |nd{funcd|esc}..\b|
|00001510| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 72 |egin{fun|cdesc}{r|
|00001520| 65 70 6f 72 74 5f 75 6e | 62 61 6c 61 6e 63 65 64 |eport_un|balanced|
|00001530| 7d 7b 74 61 67 7d 0a 54 | 68 69 73 20 6d 65 74 68 |}{tag}.T|his meth|
|00001540| 6f 64 20 69 73 20 63 61 | 6c 6c 65 64 20 77 68 65 |od is ca|lled whe|
|00001550| 6e 20 61 6e 20 65 6e 64 | 20 74 61 67 20 69 73 20 |n an end| tag is |
|00001560| 66 6f 75 6e 64 20 77 68 | 69 63 68 20 64 6f 65 73 |found wh|ich does|
|00001570| 20 6e 6f 74 0a 63 6f 72 | 72 65 73 70 6f 6e 64 20 | not.cor|respond |
|00001580| 74 6f 20 61 6e 79 20 6f | 70 65 6e 20 65 6c 65 6d |to any o|pen elem|
|00001590| 65 6e 74 2e 0a 5c 65 6e | 64 7b 66 75 6e 63 64 65 |ent..\en|d{funcde|
|000015a0| 73 63 7d 0a 0a 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|000015b0| 64 65 73 63 7d 7b 75 6e | 6b 6e 6f 77 6e 5f 73 74 |desc}{un|known_st|
|000015c0| 61 72 74 74 61 67 7d 7b | 74 61 67 5c 2c 20 61 74 |arttag}{|tag\, at|
|000015d0| 74 72 69 62 75 74 65 73 | 7d 0a 54 68 69 73 20 6d |tributes|}.This m|
|000015e0| 65 74 68 6f 64 20 69 73 | 20 63 61 6c 6c 65 64 20 |ethod is| called |
|000015f0| 74 6f 20 70 72 6f 63 65 | 73 73 20 61 6e 20 75 6e |to proce|ss an un|
|00001600| 6b 6e 6f 77 6e 20 73 74 | 61 72 74 20 74 61 67 2e |known st|art tag.|
|00001610| 20 20 49 74 20 69 73 20 | 69 6e 74 65 6e 64 65 64 |  It is |intended|
|00001620| 0a 74 6f 20 62 65 20 6f | 76 65 72 72 69 64 64 65 |.to be o|verridde|
|00001630| 6e 20 62 79 20 61 20 64 | 65 72 69 76 65 64 20 63 |n by a d|erived c|
|00001640| 6c 61 73 73 3b 20 74 68 | 65 20 62 61 73 65 20 63 |lass; th|e base c|
|00001650| 6c 61 73 73 20 69 6d 70 | 6c 65 6d 65 6e 74 61 74 |lass imp|lementat|
|00001660| 69 6f 6e 0a 64 6f 65 73 | 20 6e 6f 74 68 69 6e 67 |ion.does| nothing|
|00001670| 2e 0a 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|00001680| 0a 0a 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00001690| 63 7d 7b 75 6e 6b 6e 6f | 77 6e 5f 65 6e 64 74 61 |c}{unkno|wn_endta|
|000016a0| 67 7d 7b 74 61 67 7d 0a | 54 68 69 73 20 6d 65 74 |g}{tag}.|This met|
|000016b0| 68 6f 64 20 69 73 20 63 | 61 6c 6c 65 64 20 74 6f |hod is c|alled to|
|000016c0| 20 70 72 6f 63 65 73 73 | 20 61 6e 20 75 6e 6b 6e | process| an unkn|
|000016d0| 6f 77 6e 20 65 6e 64 20 | 74 61 67 2e 20 20 49 74 |own end |tag.  It|
|000016e0| 20 69 73 20 69 6e 74 65 | 6e 64 65 64 0a 74 6f 20 | is inte|nded.to |
|000016f0| 62 65 20 6f 76 65 72 72 | 69 64 64 65 6e 20 62 79 |be overr|idden by|
|00001700| 20 61 20 64 65 72 69 76 | 65 64 20 63 6c 61 73 73 | a deriv|ed class|
|00001710| 3b 20 74 68 65 20 62 61 | 73 65 20 63 6c 61 73 73 |; the ba|se class|
|00001720| 20 69 6d 70 6c 65 6d 65 | 6e 74 61 74 69 6f 6e 0a | impleme|ntation.|
|00001730| 64 6f 65 73 20 6e 6f 74 | 68 69 6e 67 2e 0a 5c 65 |does not|hing..\e|
|00001740| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0a 0a 5c 62 |nd{funcd|esc}..\b|
|00001750| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 75 |egin{fun|cdesc}{u|
|00001760| 6e 6b 6e 6f 77 6e 5f 63 | 68 61 72 72 65 66 7d 7b |nknown_c|harref}{|
|00001770| 72 65 66 7d 0a 54 68 69 | 73 20 6d 65 74 68 6f 64 |ref}.Thi|s method|
|00001780| 20 69 73 20 63 61 6c 6c | 65 64 20 74 6f 20 70 72 | is call|ed to pr|
|00001790| 6f 63 65 73 73 20 75 6e | 72 65 73 6f 6c 76 61 62 |ocess un|resolvab|
|000017a0| 6c 65 20 6e 75 6d 65 72 | 69 63 20 63 68 61 72 61 |le numer|ic chara|
|000017b0| 63 74 65 72 0a 72 65 66 | 65 72 65 6e 63 65 73 2e |cter.ref|erences.|
|000017c0| 20 20 49 74 20 69 73 20 | 69 6e 74 65 6e 64 65 64 |  It is |intended|
|000017d0| 20 74 6f 20 62 65 20 6f | 76 65 72 72 69 64 64 65 | to be o|verridde|
|000017e0| 6e 20 62 79 20 61 20 64 | 65 72 69 76 65 64 20 63 |n by a d|erived c|
|000017f0| 6c 61 73 73 3b 20 74 68 | 65 0a 62 61 73 65 20 63 |lass; th|e.base c|
|00001800| 6c 61 73 73 20 69 6d 70 | 6c 65 6d 65 6e 74 61 74 |lass imp|lementat|
|00001810| 69 6f 6e 20 64 6f 65 73 | 20 6e 6f 74 68 69 6e 67 |ion does| nothing|
|00001820| 2e 0a 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|00001830| 0a 0a 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00001840| 63 7d 7b 75 6e 6b 6e 6f | 77 6e 5f 65 6e 74 69 74 |c}{unkno|wn_entit|
|00001850| 79 72 65 66 7d 7b 72 65 | 66 7d 0a 54 68 69 73 20 |yref}{re|f}.This |
|00001860| 6d 65 74 68 6f 64 20 69 | 73 20 63 61 6c 6c 65 64 |method i|s called|
|00001870| 20 74 6f 20 70 72 6f 63 | 65 73 73 20 61 6e 20 75 | to proc|ess an u|
|00001880| 6e 6b 6e 6f 77 6e 20 65 | 6e 74 69 74 79 20 72 65 |nknown e|ntity re|
|00001890| 66 65 72 65 6e 63 65 2e | 20 20 49 74 20 69 73 0a |ference.|  It is.|
|000018a0| 69 6e 74 65 6e 64 65 64 | 20 74 6f 20 62 65 20 6f |intended| to be o|
|000018b0| 76 65 72 72 69 64 64 65 | 6e 20 62 79 20 61 20 64 |verridde|n by a d|
|000018c0| 65 72 69 76 65 64 20 63 | 6c 61 73 73 3b 20 74 68 |erived c|lass; th|
|000018d0| 65 20 62 61 73 65 20 63 | 6c 61 73 73 0a 69 6d 70 |e base c|lass.imp|
|000018e0| 6c 65 6d 65 6e 74 61 74 | 69 6f 6e 20 64 6f 65 73 |lementat|ion does|
|000018f0| 20 6e 6f 74 68 69 6e 67 | 2e 0a 5c 65 6e 64 7b 66 | nothing|..\end{f|
|00001900| 75 6e 63 64 65 73 63 7d | 0a 0a 41 70 61 72 74 20 |uncdesc}|..Apart |
|00001910| 66 72 6f 6d 20 6f 76 65 | 72 72 69 64 69 6e 67 20 |from ove|rriding |
|00001920| 6f 72 20 65 78 74 65 6e | 64 69 6e 67 20 74 68 65 |or exten|ding the|
|00001930| 20 6d 65 74 68 6f 64 73 | 20 6c 69 73 74 65 64 20 | methods| listed |
|00001940| 61 62 6f 76 65 2c 20 64 | 65 72 69 76 65 64 0a 63 |above, d|erived.c|
|00001950| 6c 61 73 73 65 73 20 6d | 61 79 20 61 6c 73 6f 20 |lasses m|ay also |
|00001960| 64 65 66 69 6e 65 20 6d | 65 74 68 6f 64 73 20 6f |define m|ethods o|
|00001970| 66 20 74 68 65 20 66 6f | 6c 6c 6f 77 69 6e 67 20 |f the fo|llowing |
|00001980| 66 6f 72 6d 20 74 6f 20 | 64 65 66 69 6e 65 0a 70 |form to |define.p|
|00001990| 72 6f 63 65 73 73 69 6e | 67 20 6f 66 20 73 70 65 |rocessin|g of spe|
|000019a0| 63 69 66 69 63 20 74 61 | 67 73 2e 20 20 54 61 67 |cific ta|gs.  Tag|
|000019b0| 20 6e 61 6d 65 73 20 69 | 6e 20 74 68 65 20 69 6e | names i|n the in|
|000019c0| 70 75 74 20 73 74 72 65 | 61 6d 20 61 72 65 20 63 |put stre|am are c|
|000019d0| 61 73 65 0a 69 6e 64 65 | 70 65 6e 64 65 6e 74 3b |ase.inde|pendent;|
|000019e0| 20 74 68 65 20 5c 76 61 | 72 7b 74 61 67 7d 20 6f | the \va|r{tag} o|
|000019f0| 63 63 75 72 72 69 6e 67 | 20 69 6e 20 6d 65 74 68 |ccurring| in meth|
|00001a00| 6f 64 20 6e 61 6d 65 73 | 20 6d 75 73 74 20 62 65 |od names| must be|
|00001a10| 20 69 6e 20 6c 6f 77 65 | 72 0a 63 61 73 65 3a 0a | in lowe|r.case:.|
|00001a20| 0a 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|00001a30| 7d 7b 73 74 61 72 74 5f | 5c 76 61 72 7b 74 61 67 |}{start_|\var{tag|
|00001a40| 7d 7d 7b 61 74 74 72 69 | 62 75 74 65 73 7d 0a 54 |}}{attri|butes}.T|
|00001a50| 68 69 73 20 6d 65 74 68 | 6f 64 20 69 73 20 63 61 |his meth|od is ca|
|00001a60| 6c 6c 65 64 20 74 6f 20 | 70 72 6f 63 65 73 73 20 |lled to |process |
|00001a70| 61 6e 20 6f 70 65 6e 69 | 6e 67 20 74 61 67 20 5c |an openi|ng tag \|
|00001a80| 76 61 72 7b 74 61 67 7d | 2e 20 20 49 74 20 68 61 |var{tag}|.  It ha|
|00001a90| 73 0a 70 72 65 66 65 72 | 65 6e 63 65 20 6f 76 65 |s.prefer|ence ove|
|00001aa0| 72 20 5c 63 6f 64 65 7b | 64 6f 5f 5c 76 61 72 7b |r \code{|do_\var{|
|00001ab0| 74 61 67 7d 28 29 7d 2e | 20 20 54 68 65 20 5c 76 |tag}()}.|  The \v|
|00001ac0| 61 72 7b 61 74 74 72 69 | 62 75 74 65 73 7d 20 61 |ar{attri|butes} a|
|00001ad0| 72 67 75 6d 65 6e 74 0a | 68 61 73 20 74 68 65 20 |rgument.|has the |
|00001ae0| 73 61 6d 65 20 6d 65 61 | 6e 69 6e 67 20 61 73 20 |same mea|ning as |
|00001af0| 64 65 73 63 72 69 62 65 | 64 20 66 6f 72 20 5c 63 |describe|d for \c|
|00001b00| 6f 64 65 7b 68 61 6e 64 | 6c 65 5f 73 74 61 72 74 |ode{hand|le_start|
|00001b10| 74 61 67 28 29 7d 20 61 | 62 6f 76 65 2e 0a 5c 65 |tag()} a|bove..\e|
|00001b20| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0a 0a 5c 62 |nd{funcd|esc}..\b|
|00001b30| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 64 |egin{fun|cdesc}{d|
|00001b40| 6f 5f 5c 76 61 72 7b 74 | 61 67 7d 7d 7b 61 74 74 |o_\var{t|ag}}{att|
|00001b50| 72 69 62 75 74 65 73 7d | 0a 54 68 69 73 20 6d 65 |ributes}|.This me|
|00001b60| 74 68 6f 64 20 69 73 20 | 63 61 6c 6c 65 64 20 74 |thod is |called t|
|00001b70| 6f 20 70 72 6f 63 65 73 | 73 20 61 6e 20 6f 70 65 |o proces|s an ope|
|00001b80| 6e 69 6e 67 20 74 61 67 | 20 5c 76 61 72 7b 74 61 |ning tag| \var{ta|
|00001b90| 67 7d 20 74 68 61 74 20 | 64 6f 65 73 0a 6e 6f 74 |g} that |does.not|
|00001ba0| 20 63 6f 6d 65 20 77 69 | 74 68 20 61 20 6d 61 74 | come wi|th a mat|
|00001bb0| 63 68 69 6e 67 20 63 6c | 6f 73 69 6e 67 20 74 61 |ching cl|osing ta|
|00001bc0| 67 2e 20 20 54 68 65 20 | 5c 76 61 72 7b 61 74 74 |g.  The |\var{att|
|00001bd0| 72 69 62 75 74 65 73 7d | 20 61 72 67 75 6d 65 6e |ributes}| argumen|
|00001be0| 74 0a 68 61 73 20 74 68 | 65 20 73 61 6d 65 20 6d |t.has th|e same m|
|00001bf0| 65 61 6e 69 6e 67 20 61 | 73 20 64 65 73 63 72 69 |eaning a|s descri|
|00001c00| 62 65 64 20 66 6f 72 20 | 5c 63 6f 64 65 7b 68 61 |bed for |\code{ha|
|00001c10| 6e 64 6c 65 5f 73 74 61 | 72 74 74 61 67 28 29 7d |ndle_sta|rttag()}|
|00001c20| 20 61 62 6f 76 65 2e 0a | 5c 65 6e 64 7b 66 75 6e | above..|\end{fun|
|00001c30| 63 64 65 73 63 7d 0a 0a | 5c 62 65 67 69 6e 7b 66 |cdesc}..|\begin{f|
|00001c40| 75 6e 63 64 65 73 63 7d | 7b 65 6e 64 5f 5c 76 61 |uncdesc}|{end_\va|
|00001c50| 72 7b 74 61 67 7d 7d 7b | 7d 0a 54 68 69 73 20 6d |r{tag}}{|}.This m|
|00001c60| 65 74 68 6f 64 20 69 73 | 20 63 61 6c 6c 65 64 20 |ethod is| called |
|00001c70| 74 6f 20 70 72 6f 63 65 | 73 73 20 61 20 63 6c 6f |to proce|ss a clo|
|00001c80| 73 69 6e 67 20 74 61 67 | 20 5c 76 61 72 7b 74 61 |sing tag| \var{ta|
|00001c90| 67 7d 2e 0a 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |g}..\end|{funcdes|
|00001ca0| 63 7d 0a 0a 4e 6f 74 65 | 20 74 68 61 74 20 74 68 |c}..Note| that th|
|00001cb0| 65 20 70 61 72 73 65 72 | 20 6d 61 69 6e 74 61 69 |e parser| maintai|
|00001cc0| 6e 73 20 61 20 73 74 61 | 63 6b 20 6f 66 20 6f 70 |ns a sta|ck of op|
|00001cd0| 65 6e 20 65 6c 65 6d 65 | 6e 74 73 20 66 6f 72 20 |en eleme|nts for |
|00001ce0| 77 68 69 63 68 20 6e 6f | 0a 65 6e 64 20 74 61 67 |which no|.end tag|
|00001cf0| 20 68 61 73 20 62 65 65 | 6e 20 66 6f 75 6e 64 20 | has bee|n found |
|00001d00| 79 65 74 2e 20 20 4f 6e | 6c 79 20 74 61 67 73 20 |yet.  On|ly tags |
|00001d10| 70 72 6f 63 65 73 73 65 | 64 20 62 79 0a 5c 63 6f |processe|d by.\co|
|00001d20| 64 65 7b 73 74 61 72 74 | 5f 5c 76 61 72 7b 74 61 |de{start|_\var{ta|
|00001d30| 67 7d 28 29 7d 20 61 72 | 65 20 70 75 73 68 65 64 |g}()} ar|e pushed|
|00001d40| 20 6f 6e 20 74 68 69 73 | 20 73 74 61 63 6b 2e 20 | on this| stack. |
|00001d50| 20 44 65 66 69 6e 69 74 | 69 6f 6e 20 6f 66 20 61 | Definit|ion of a|
|00001d60| 6e 0a 5c 63 6f 64 65 7b | 65 6e 64 5f 5c 76 61 72 |n.\code{|end_\var|
|00001d70| 7b 74 61 67 7d 28 29 7d | 20 6d 65 74 68 6f 64 20 |{tag}()}| method |
|00001d80| 69 73 20 6f 70 74 69 6f | 6e 61 6c 20 66 6f 72 20 |is optio|nal for |
|00001d90| 74 68 65 73 65 20 74 61 | 67 73 2e 20 20 46 6f 72 |these ta|gs.  For|
|00001da0| 20 74 61 67 73 0a 70 72 | 6f 63 65 73 73 65 64 20 | tags.pr|ocessed |
|00001db0| 62 79 20 5c 63 6f 64 65 | 7b 64 6f 5f 5c 76 61 72 |by \code|{do_\var|
|00001dc0| 7b 74 61 67 7d 28 29 7d | 20 6f 72 20 62 79 20 5c |{tag}()}| or by \|
|00001dd0| 63 6f 64 65 7b 75 6e 6b | 6e 6f 77 6e 5f 74 61 67 |code{unk|nown_tag|
|00001de0| 28 29 7d 2c 20 6e 6f 0a | 5c 63 6f 64 65 7b 65 6e |()}, no.|\code{en|
|00001df0| 64 5f 5c 76 61 72 7b 74 | 61 67 7d 28 29 7d 20 6d |d_\var{t|ag}()} m|
|00001e00| 65 74 68 6f 64 20 6d 75 | 73 74 20 62 65 20 64 65 |ethod mu|st be de|
|00001e10| 66 69 6e 65 64 3b 20 69 | 66 20 64 65 66 69 6e 65 |fined; i|f define|
|00001e20| 64 2c 20 69 74 20 77 69 | 6c 6c 20 6e 6f 74 0a 62 |d, it wi|ll not.b|
|00001e30| 65 20 75 73 65 64 2e 20 | 20 49 66 20 62 6f 74 68 |e used. | If both|
|00001e40| 20 5c 63 6f 64 65 7b 73 | 74 61 72 74 5f 5c 76 61 | \code{s|tart_\va|
|00001e50| 72 7b 74 61 67 7d 28 29 | 7d 20 61 6e 64 20 5c 63 |r{tag}()|} and \c|
|00001e60| 6f 64 65 7b 64 6f 5f 5c | 76 61 72 7b 74 61 67 7d |ode{do_\|var{tag}|
|00001e70| 28 29 7d 0a 6d 65 74 68 | 6f 64 73 20 65 78 69 73 |()}.meth|ods exis|
|00001e80| 74 20 66 6f 72 20 61 20 | 74 61 67 2c 20 74 68 65 |t for a |tag, the|
|00001e90| 20 5c 63 6f 64 65 7b 73 | 74 61 72 74 5f 5c 76 61 | \code{s|tart_\va|
|00001ea0| 72 7b 74 61 67 7d 28 29 | 7d 20 6d 65 74 68 6f 64 |r{tag}()|} method|
|00001eb0| 20 74 61 6b 65 73 0a 70 | 72 65 63 65 64 65 6e 63 | takes.p|recedenc|
|00001ec0| 65 2e 0a                |                         |e..     |        |
+--------+-------------------------+-------------------------+--------+--------+