home *** CD-ROM | disk | FTP | other *** search
open in: 
MacOS 8.1
|
Win98
|
DOS
browse contents |
view JSON data
|
view as text
This file was processed as: LaTeX Document
(document/latex).
| Confidence | Program | Detection | Match Type | Support
|
|---|
| 100%
| dexvert
| LaTeX Document (document/latex)
| magic
| Supported |
| 1%
| dexvert
| Text File (text/txt)
| fallback
| Supported |
| 100%
| file
| LaTeX document text
| default
| |
| 99%
| file
| LaTeX document, ASCII text
| default
| |
| 100%
| TrID
| LaTeX 2e document (with rem)
| default
| |
| 100%
| checkBytes
| Printable ASCII
| default
| |
| 100%
| perlTextCheck
| Likely Text (Perl)
| default
| |
| 100%
| detectItEasy
| Format: plain text[LF]
| default (weak)
| |
| 100%
| xdgMime
| text/x-matlab
| default (weak)
|
|
hex view+--------+-------------------------+-------------------------+--------+--------+
|00000000| 25 20 43 6f 70 79 72 69 | 67 68 74 20 28 43 29 20 |% Copyri|ght (C) |
|00000010| 31 39 38 38 2c 20 61 6c | 6c 20 72 69 67 68 74 73 |1988, al|l rights|
|00000020| 20 72 65 73 65 72 76 65 | 64 2e 0a 0a 5c 64 65 66 | reserve|d...\def|
|00000030| 5c 42 69 62 54 65 58 7b | 7b 5c 72 6d 20 42 5c 6b |\BibTeX{|{\rm B\k|
|00000040| 65 72 6e 2d 2e 30 35 65 | 6d 7b 5c 73 63 20 69 5c |ern-.05e|m{\sc i\|
|00000050| 6b 65 72 6e 2d 2e 30 32 | 35 65 6d 20 62 7d 5c 6b |kern-.02|5em b}\k|
|00000060| 65 72 6e 2d 2e 30 38 65 | 6d 0a 20 20 20 20 54 5c |ern-.08e|m. T\|
|00000070| 6b 65 72 6e 2d 2e 31 36 | 36 37 65 6d 5c 6c 6f 77 |kern-.16|67em\low|
|00000080| 65 72 2e 37 65 78 5c 68 | 62 6f 78 7b 45 7d 5c 6b |er.7ex\h|box{E}\k|
|00000090| 65 72 6e 2d 2e 31 32 35 | 65 6d 58 7d 7d 0a 0a 5c |ern-.125|emX}}..\|
|000000a0| 74 69 74 6c 65 7b 44 65 | 73 69 67 6e 69 6e 67 20 |title{De|signing |
|000000b0| 42 5c 6b 65 72 6e 2d 2e | 30 35 65 6d 7b 5c 6c 61 |B\kern-.|05em{\la|
|000000c0| 72 67 65 20 49 7d 5c 6b | 65 72 6e 2d 2e 30 32 35 |rge I}\k|ern-.025|
|000000d0| 65 6d 7b 5c 6c 61 72 67 | 65 20 42 7d 5c 6b 65 72 |em{\larg|e B}\ker|
|000000e0| 6e 2d 2e 30 38 65 6d 5c | 54 65 58 5c 0a 20 20 20 |n-.08em\|TeX\. |
|000000f0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00000100| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00000110| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00000120| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00000130| 20 20 20 20 20 53 74 79 | 6c 65 73 7d 0a 5c 61 75 | Sty|les}.\au|
|00000140| 74 68 6f 72 7b 4f 72 65 | 6e 20 50 61 74 61 73 68 |thor{Ore|n Patash|
|00000150| 6e 69 6b 7d 0a 5c 64 61 | 74 65 7b 4a 61 6e 75 61 |nik}.\da|te{Janua|
|00000160| 72 79 20 33 31 2c 20 31 | 39 38 38 7d 0a 0a 5c 64 |ry 31, 1|988}..\d|
|00000170| 6f 63 75 6d 65 6e 74 73 | 74 79 6c 65 7b 61 72 74 |ocuments|tyle{art|
|00000180| 69 63 6c 65 7d 0a 5c 62 | 65 67 69 6e 7b 64 6f 63 |icle}.\b|egin{doc|
|00000190| 75 6d 65 6e 74 7d 0a 0a | 5c 6d 61 6b 65 74 69 74 |ument}..|\maketit|
|000001a0| 6c 65 0a 0a 5c 73 65 74 | 63 6f 75 6e 74 65 72 7b |le..\set|counter{|
|000001b0| 73 65 63 74 69 6f 6e 7d | 7b 34 7d 0a 5c 73 65 63 |section}|{4}.\sec|
|000001c0| 74 69 6f 6e 7b 42 69 62 | 6c 69 6f 67 72 61 70 68 |tion{Bib|liograph|
|000001d0| 79 2d 73 74 79 6c 65 20 | 68 61 63 6b 69 6e 67 7d |y-style |hacking}|
|000001e0| 0a 5c 6c 61 62 65 6c 7b | 73 74 79 6c 65 7d 0a 0a |.\label{|style}..|
|000001f0| 54 68 69 73 20 64 6f 63 | 75 6d 65 6e 74 20 73 74 |This doc|ument st|
|00000200| 61 72 74 73 20 28 61 6e | 64 20 65 6e 64 73 29 20 |arts (an|d ends) |
|00000210| 77 69 74 68 20 53 65 63 | 74 69 6f 6e 7e 5c 72 65 |with Sec|tion~\re|
|00000220| 66 7b 73 74 79 6c 65 7d | 2c 0a 62 65 63 61 75 73 |f{style}|,.becaus|
|00000230| 65 20 69 6e 20 72 65 61 | 6c 69 74 79 20 69 74 20 |e in rea|lity it |
|00000240| 69 73 20 74 68 65 20 66 | 69 6e 61 6c 20 73 65 63 |is the f|inal sec|
|00000250| 74 69 6f 6e 20 6f 66 20 | 60 60 5c 42 69 62 54 65 |tion of |``\BibTe|
|00000260| 58 20 69 6e 67 27 27 7e | 5c 63 69 74 65 7b 62 74 |X ing''~|\cite{bt|
|00000270| 78 64 6f 63 7d 2c 0a 74 | 68 65 20 67 65 6e 65 72 |xdoc},.t|he gener|
|00000280| 61 6c 20 64 6f 63 75 6d | 65 6e 74 61 74 69 6f 6e |al docum|entation|
|00000290| 20 66 6f 72 20 5c 42 69 | 62 54 65 58 2e 0a 42 75 | for \Bi|bTeX..Bu|
|000002a0| 74 20 74 68 61 74 20 64 | 6f 63 75 6d 65 6e 74 20 |t that d|ocument |
|000002b0| 77 61 73 20 6d 65 61 6e | 74 20 66 6f 72 20 61 6c |was mean|t for al|
|000002c0| 6c 20 5c 42 69 62 54 65 | 58 5c 20 75 73 65 72 73 |l \BibTe|X\ users|
|000002d0| 2c 0a 77 68 69 6c 65 20 | 74 68 69 73 20 6f 6e 65 |,.while |this one|
|000002e0| 20 69 73 20 6a 75 73 74 | 20 66 6f 72 20 73 74 79 | is just| for sty|
|000002f0| 6c 65 20 64 65 73 69 67 | 6e 65 72 73 2c 0a 73 6f |le desig|ners,.so|
|00000300| 20 74 68 65 20 74 77 6f | 20 61 72 65 20 70 68 79 | the two| are phy|
|00000310| 73 69 63 61 6c 6c 79 20 | 73 65 70 61 72 61 74 65 |sically |separate|
|00000320| 2e 0a 53 74 69 6c 6c 2c | 20 79 6f 75 20 73 68 6f |..Still,| you sho|
|00000330| 75 6c 64 20 62 65 20 63 | 6f 6d 70 6c 65 74 65 6c |uld be c|ompletel|
|00000340| 79 20 66 61 6d 69 6c 69 | 61 72 20 77 69 74 68 20 |y famili|ar with |
|00000350| 60 60 5c 42 69 62 54 65 | 58 20 69 6e 67 27 27 2c |``\BibTe|X ing'',|
|00000360| 0a 61 6e 64 20 61 6c 6c | 20 72 65 66 65 72 65 6e |.and all| referen|
|00000370| 63 65 73 20 69 6e 20 74 | 68 69 73 20 64 6f 63 75 |ces in t|his docu|
|00000380| 6d 65 6e 74 0a 74 6f 20 | 73 65 63 74 69 6f 6e 73 |ment.to |sections|
|00000390| 20 61 6e 64 20 73 65 63 | 74 69 6f 6e 20 6e 75 6d | and sec|tion num|
|000003a0| 62 65 72 73 0a 61 73 73 | 75 6d 65 20 74 68 61 74 |bers.ass|ume that|
|000003b0| 20 74 68 65 20 74 77 6f | 20 64 6f 63 75 6d 65 6e | the two| documen|
|000003c0| 74 73 20 61 72 65 20 6f | 6e 65 2e 0a 0a 54 68 69 |ts are o|ne...Thi|
|000003d0| 73 20 73 65 63 74 69 6f | 6e 2c 0a 61 6c 6f 6e 67 |s sectio|n,.along|
|000003e0| 20 77 69 74 68 20 74 68 | 65 20 73 74 61 6e 64 61 | with th|e standa|
|000003f0| 72 64 2d 73 74 79 6c 65 | 20 64 6f 63 75 6d 65 6e |rd-style| documen|
|00000400| 74 61 74 69 6f 6e 20 66 | 69 6c 65 20 5c 68 62 6f |tation f|ile \hbo|
|00000410| 78 7b 5c 74 74 20 62 74 | 78 62 73 74 2e 64 6f 63 |x{\tt bt|xbst.doc|
|00000420| 7d 2c 0a 73 68 6f 75 6c | 64 20 65 78 70 6c 61 69 |},.shoul|d explai|
|00000430| 6e 20 68 6f 77 20 74 6f | 20 6d 6f 64 69 66 79 0a |n how to| modify.|
|00000440| 65 78 69 73 74 69 6e 67 | 20 73 74 79 6c 65 20 66 |existing| style f|
|00000450| 69 6c 65 73 20 61 6e 64 | 20 74 6f 20 70 72 6f 64 |iles and| to prod|
|00000460| 75 63 65 20 6e 65 77 20 | 6f 6e 65 73 2e 0a 49 66 |uce new |ones..If|
|00000470| 20 79 6f 75 27 72 65 20 | 61 20 73 65 72 69 6f 75 | you're |a seriou|
|00000480| 73 20 73 74 79 6c 65 20 | 68 61 63 6b 65 72 20 79 |s style |hacker y|
|00000490| 6f 75 20 73 68 6f 75 6c | 64 20 62 65 20 66 61 6d |ou shoul|d be fam|
|000004a0| 69 6c 69 61 72 0a 77 69 | 74 68 20 76 61 6e 7e 4c |iliar.wi|th van~L|
|000004b0| 65 75 6e 65 6e 7e 5c 63 | 69 74 65 7b 76 61 6e 2d |eunen~\c|ite{van-|
|000004c0| 6c 65 75 6e 65 6e 7d 20 | 66 6f 72 20 70 6f 69 6e |leunen} |for poin|
|000004d0| 74 73 20 6f 66 20 73 74 | 79 6c 65 2c 0a 77 69 74 |ts of st|yle,.wit|
|000004e0| 68 20 4c 61 6d 70 6f 72 | 74 7e 5c 63 69 74 65 7b |h Lampor|t~\cite{|
|000004f0| 6c 61 74 65 78 7d 20 61 | 6e 64 20 4b 6e 75 74 68 |latex} a|nd Knuth|
|00000500| 7e 5c 63 69 74 65 7b 74 | 65 78 62 6f 6f 6b 7d 20 |~\cite{t|exbook} |
|00000510| 66 6f 72 20 66 6f 72 6d | 61 74 74 69 6e 67 20 6d |for form|atting m|
|00000520| 61 74 74 65 72 73 2c 0a | 61 6e 64 20 70 65 72 68 |atters,.|and perh|
|00000530| 61 70 73 20 77 69 74 68 | 20 7b 5c 65 6d 20 53 63 |aps with| {\em Sc|
|00000540| 72 69 62 65 5c 2f 7d 7e | 5c 63 69 74 65 7b 73 63 |ribe\/}~|\cite{sc|
|00000550| 72 69 62 65 7d 20 66 6f | 72 20 63 6f 6d 70 61 74 |ribe} fo|r compat|
|00000560| 69 62 69 6c 69 74 79 20 | 64 65 74 61 69 6c 73 2e |ibility |details.|
|00000570| 0a 41 6e 64 20 77 68 69 | 6c 65 20 79 6f 75 27 72 |.And whi|le you'r|
|00000580| 65 20 61 74 20 69 74 2c | 20 69 66 20 79 6f 75 20 |e at it,| if you |
|00000590| 64 6f 6e 27 74 20 72 65 | 61 64 20 74 68 65 20 67 |don't re|ad the g|
|000005a0| 72 65 61 74 20 6c 69 74 | 74 6c 65 20 62 6f 6f 6b |reat lit|tle book|
|000005b0| 20 62 79 20 53 74 72 75 | 6e 6b 20 61 6e 64 0a 57 | by Stru|nk and.W|
|000005c0| 68 69 74 65 7e 5c 63 69 | 74 65 7b 73 74 72 75 6e |hite~\ci|te{strun|
|000005d0| 6b 2d 61 6e 64 2d 77 68 | 69 74 65 7d 2c 20 79 6f |k-and-wh|ite}, yo|
|000005e0| 75 20 73 68 6f 75 6c 64 | 20 61 74 20 6c 65 61 73 |u should| at leas|
|000005f0| 74 20 6c 6f 6f 6b 20 61 | 74 20 69 74 73 0a 65 6e |t look a|t its.en|
|00000600| 74 72 69 65 73 20 69 6e | 20 74 68 65 20 64 61 74 |tries in| the dat|
|00000610| 61 62 61 73 65 20 61 6e | 64 20 74 68 65 20 72 65 |abase an|d the re|
|00000620| 66 65 72 65 6e 63 65 20 | 6c 69 73 74 0a 74 6f 20 |ference |list.to |
|00000630| 73 65 65 20 68 6f 77 20 | 5c 42 69 62 54 65 58 5c |see how |\BibTeX\|
|00000640| 20 68 61 6e 64 6c 65 73 | 20 6d 75 6c 74 69 70 6c | handles| multipl|
|00000650| 65 20 6e 61 6d 65 73 2e | 0a 0a 54 6f 20 63 72 65 |e names.|..To cre|
|00000660| 61 74 65 20 61 20 6e 65 | 77 20 73 74 79 6c 65 2c |ate a ne|w style,|
|00000670| 0a 69 74 27 73 20 62 65 | 73 74 20 74 6f 20 73 74 |.it's be|st to st|
|00000680| 61 72 74 20 77 69 74 68 | 20 61 6e 20 65 78 69 73 |art with| an exis|
|00000690| 74 69 6e 67 20 73 74 79 | 6c 65 20 74 68 61 74 27 |ting sty|le that'|
|000006a0| 73 20 63 6c 6f 73 65 20 | 74 6f 20 79 6f 75 72 73 |s close |to yours|
|000006b0| 2c 0a 61 6e 64 20 74 68 | 65 6e 20 6d 6f 64 69 66 |,.and th|en modif|
|000006c0| 79 20 74 68 61 74 2e 0a | 54 68 69 73 20 69 73 20 |y that..|This is |
|000006d0| 74 72 75 65 20 65 76 65 | 6e 20 69 66 20 79 6f 75 |true eve|n if you|
|000006e0| 27 72 65 20 73 69 6d 70 | 6c 79 20 75 70 64 61 74 |'re simp|ly updat|
|000006f0| 69 6e 67 20 61 6e 20 6f | 6c 64 20 73 74 79 6c 65 |ing an o|ld style|
|00000700| 0a 66 6f 72 20 5c 42 69 | 62 54 65 58 5c 20 76 65 |.for \Bi|bTeX\ ve|
|00000710| 72 73 69 6f 6e 20 30 2e | 39 39 0a 28 49 27 76 65 |rsion 0.|99.(I've|
|00000720| 20 75 70 64 61 74 65 64 | 20 66 6f 75 72 20 6e 6f | updated| four no|
|00000730| 6e 73 74 61 6e 64 61 72 | 64 20 73 74 79 6c 65 73 |nstandar|d styles|
|00000740| 2c 0a 73 6f 20 49 20 73 | 61 79 20 74 68 69 73 20 |,.so I s|ay this |
|00000750| 77 69 74 68 20 73 6f 6d | 65 20 65 78 70 65 72 69 |with som|e experi|
|00000760| 65 6e 63 65 29 2e 0a 49 | 66 20 79 6f 75 20 77 61 |ence)..I|f you wa|
|00000770| 6e 74 20 74 6f 20 69 6e | 73 65 72 74 20 69 6e 74 |nt to in|sert int|
|00000780| 6f 20 61 20 6e 65 77 20 | 73 74 79 6c 65 0a 73 6f |o a new |style.so|
|00000790| 6d 65 20 66 75 6e 63 74 | 69 6f 6e 20 79 6f 75 27 |me funct|ion you'|
|000007a0| 64 20 77 72 69 74 74 65 | 6e 20 66 6f 72 20 61 6e |d writte|n for an|
|000007b0| 20 6f 6c 64 20 28 76 65 | 72 73 69 6f 6e 20 30 2e | old (ve|rsion 0.|
|000007c0| 39 38 69 29 20 73 74 79 | 6c 65 2c 0a 6b 65 65 70 |98i) sty|le,.keep|
|000007d0| 20 69 6e 20 6d 69 6e 64 | 20 74 68 61 74 20 74 68 | in mind| that th|
|000007e0| 65 20 6f 72 64 65 72 20 | 6f 66 20 74 68 65 20 61 |e order |of the a|
|000007f0| 72 67 75 6d 65 6e 74 73 | 20 74 6f 0a 74 68 65 20 |rguments| to.the |
|00000800| 61 73 73 69 67 6e 6d 65 | 6e 74 20 28 7b 5c 74 74 |assignme|nt ({\tt|
|00000810| 20 3a 3d 7d 29 20 66 75 | 6e 63 74 69 6f 6e 20 68 | :=}) fu|nction h|
|00000820| 61 73 20 62 65 65 6e 20 | 72 65 76 65 72 73 65 64 |as been |reversed|
|00000830| 2e 0a 57 68 65 6e 20 79 | 6f 75 27 72 65 20 66 69 |..When y|ou're fi|
|00000840| 6e 69 73 68 65 64 20 77 | 69 74 68 20 79 6f 75 72 |nished w|ith your|
|00000850| 20 73 74 79 6c 65 2c 0a | 79 6f 75 20 6d 61 79 20 | style,.|you may |
|00000860| 77 61 6e 74 20 74 6f 20 | 74 72 79 20 72 75 6e 6e |want to |try runn|
|00000870| 69 6e 67 20 69 74 20 6f | 6e 20 74 68 65 20 65 6e |ing it o|n the en|
|00000880| 74 69 72 65 20 5c 68 62 | 6f 78 7b 5c 74 74 20 58 |tire \hb|ox{\tt X|
|00000890| 41 4d 50 4c 2e 42 49 42 | 7d 20 64 61 74 61 62 61 |AMPL.BIB|} databa|
|000008a0| 73 65 0a 74 6f 20 6d 61 | 6b 65 20 73 75 72 65 20 |se.to ma|ke sure |
|000008b0| 69 74 20 68 61 6e 64 6c | 65 73 20 61 6c 6c 20 74 |it handl|es all t|
|000008c0| 68 65 20 73 74 61 6e 64 | 61 72 64 20 65 6e 74 72 |he stand|ard entr|
|000008d0| 79 20 74 79 70 65 73 2e | 0a 0a 49 66 20 79 6f 75 |y types.|..If you|
|000008e0| 20 66 69 6e 64 20 61 6e | 79 20 62 75 67 73 20 69 | find an|y bugs i|
|000008f0| 6e 20 74 68 65 20 73 74 | 61 6e 64 61 72 64 20 73 |n the st|andard s|
|00000900| 74 79 6c 65 73 2c 0a 6f | 72 20 69 66 20 74 68 65 |tyles,.o|r if the|
|00000910| 72 65 20 61 72 65 20 74 | 68 69 6e 67 73 20 79 6f |re are t|hings yo|
|00000920| 75 27 64 20 6c 69 6b 65 | 20 74 6f 20 64 6f 0a 77 |u'd like| to do.w|
|00000930| 69 74 68 20 62 69 62 6c | 69 6f 67 72 61 70 68 79 |ith bibl|iography|
|00000940| 2d 73 74 79 6c 65 20 66 | 69 6c 65 73 20 62 75 74 |-style f|iles but|
|00000950| 20 63 61 6e 27 74 2c 0a | 70 6c 65 61 73 65 20 63 | can't,.|please c|
|00000960| 6f 6d 70 6c 61 69 6e 20 | 74 6f 20 4f 72 65 6e 20 |omplain |to Oren |
|00000970| 50 61 74 61 73 68 6e 69 | 6b 2e 0a 0a 0a 5c 73 75 |Patashni|k....\su|
|00000980| 62 73 65 63 74 69 6f 6e | 7b 47 65 6e 65 72 61 6c |bsection|{General|
|00000990| 20 64 65 73 63 72 69 70 | 74 69 6f 6e 7d 0a 0a 59 | descrip|tion}..Y|
|000009a0| 6f 75 20 77 72 69 74 65 | 20 62 69 62 6c 69 6f 67 |ou write| bibliog|
|000009b0| 72 61 70 68 79 20 73 74 | 79 6c 65 73 20 69 6e 20 |raphy st|yles in |
|000009c0| 61 20 70 6f 73 74 66 69 | 78 20 73 74 61 63 6b 20 |a postfi|x stack |
|000009d0| 6c 61 6e 67 75 61 67 65 | 2e 20 20 49 74 27 73 0a |language|. It's.|
|000009e0| 6e 6f 74 20 74 6f 6f 20 | 68 61 72 64 20 74 6f 20 |not too |hard to |
|000009f0| 66 69 67 75 72 65 20 6f | 75 74 20 68 6f 77 20 62 |figure o|ut how b|
|00000a00| 79 20 6c 6f 6f 6b 69 6e | 67 20 61 74 20 74 68 65 |y lookin|g at the|
|00000a10| 20 73 74 61 6e 64 61 72 | 64 2d 73 74 79 6c 65 20 | standar|d-style |
|00000a20| 64 6f 63 75 6d 65 6e 74 | 61 74 69 6f 6e 2c 0a 62 |document|ation,.b|
|00000a30| 75 74 20 74 68 69 73 20 | 64 65 73 63 72 69 70 74 |ut this |descript|
|00000a40| 69 6f 6e 20 66 69 6c 6c | 73 20 69 6e 20 61 20 66 |ion fill|s in a f|
|00000a50| 65 77 20 64 65 74 61 69 | 6c 73 20 28 69 74 20 77 |ew detai|ls (it w|
|00000a60| 69 6c 6c 20 66 69 6c 6c | 20 69 6e 20 6d 6f 72 65 |ill fill| in more|
|00000a70| 0a 64 65 74 61 69 6c 73 | 20 69 66 20 74 68 65 72 |.details| if ther|
|00000a80| 65 27 73 20 61 20 64 65 | 6d 61 6e 64 20 66 6f 72 |e's a de|mand for|
|00000a90| 20 69 74 29 2e 0a 0a 42 | 61 73 69 63 61 6c 6c 79 | it)...B|asically|
|00000aa0| 20 74 68 65 20 73 74 79 | 6c 65 20 66 69 6c 65 20 | the sty|le file |
|00000ab0| 69 73 20 61 20 70 72 6f | 67 72 61 6d 2c 20 77 72 |is a pro|gram, wr|
|00000ac0| 69 74 74 65 6e 20 69 6e | 20 61 6e 20 75 6e 6e 61 |itten in| an unna|
|00000ad0| 6d 65 64 20 6c 61 6e 67 | 75 61 67 65 2c 20 74 68 |med lang|uage, th|
|00000ae0| 61 74 0a 74 65 6c 6c 73 | 20 5c 42 69 62 54 65 58 |at.tells| \BibTeX|
|00000af0| 5c 20 68 6f 77 20 74 6f | 20 66 6f 72 6d 61 74 20 |\ how to| format |
|00000b00| 74 68 65 20 65 6e 74 72 | 69 65 73 20 74 68 61 74 |the entr|ies that|
|00000b10| 20 77 69 6c 6c 20 67 6f | 20 69 6e 20 74 68 65 20 | will go| in the |
|00000b20| 72 65 66 65 72 65 6e 63 | 65 20 6c 69 73 74 0a 28 |referenc|e list.(|
|00000b30| 68 65 6e 63 65 66 6f 72 | 74 68 20 60 60 74 68 65 |hencefor|th ``the|
|00000b40| 20 65 6e 74 72 69 65 73 | 27 27 20 77 69 6c 6c 20 | entries|'' will |
|00000b50| 62 65 20 60 60 74 68 65 | 20 65 6e 74 72 79 20 6c |be ``the| entry l|
|00000b60| 69 73 74 27 27 0a 6f 72 | 20 73 69 6d 70 6c 79 20 |ist''.or| simply |
|00000b70| 60 60 74 68 65 20 6c 69 | 73 74 27 27 24 5c 21 24 |``the li|st''$\!$|
|00000b80| 2c 20 63 6f 6e 74 65 78 | 74 20 70 65 72 6d 69 74 |, contex|t permit|
|00000b90| 74 69 6e 67 29 2e 0a 54 | 68 69 73 20 70 72 6f 67 |ting)..T|his prog|
|00000ba0| 72 61 6d 6d 69 6e 67 20 | 6c 61 6e 67 75 61 67 65 |ramming |language|
|00000bb0| 20 68 61 73 20 74 65 6e | 20 63 6f 6d 6d 61 6e 64 | has ten| command|
|00000bc0| 73 2c 20 64 65 73 63 72 | 69 62 65 64 20 69 6e 20 |s, descr|ibed in |
|00000bd0| 74 68 65 20 6e 65 78 74 | 20 73 75 62 73 65 63 74 |the next| subsect|
|00000be0| 69 6f 6e 2e 0a 54 68 65 | 73 65 20 63 6f 6d 6d 61 |ion..The|se comma|
|00000bf0| 6e 64 73 20 6d 61 6e 69 | 70 75 6c 61 74 65 20 74 |nds mani|pulate t|
|00000c00| 68 65 20 6c 61 6e 67 75 | 61 67 65 27 73 20 6f 62 |he langu|age's ob|
|00000c10| 6a 65 63 74 73 3a 0a 63 | 6f 6e 73 74 61 6e 74 73 |jects:.c|onstants|
|00000c20| 2c 20 76 61 72 69 61 62 | 6c 65 73 2c 20 66 75 6e |, variab|les, fun|
|00000c30| 63 74 69 6f 6e 73 2c 20 | 74 68 65 20 73 74 61 63 |ctions, |the stac|
|00000c40| 6b 2c 20 61 6e 64 20 74 | 68 65 20 65 6e 74 72 79 |k, and t|he entry|
|00000c50| 20 6c 69 73 74 2e 0a 28 | 57 61 72 6e 69 6e 67 3a | list..(|Warning:|
|00000c60| 20 54 68 65 20 74 65 72 | 6d 69 6e 6f 6c 6f 67 79 | The ter|minology|
|00000c70| 20 69 6e 20 74 68 69 73 | 20 64 6f 63 75 6d 65 6e | in this| documen|
|00000c80| 74 61 74 69 6f 6e 2c 0a | 63 68 6f 73 65 6e 20 66 |tation,.|chosen f|
|00000c90| 6f 72 20 65 61 73 65 20 | 6f 66 20 65 78 70 6c 61 |or ease |of expla|
|00000ca0| 6e 61 74 69 6f 6e 2c 20 | 69 73 20 73 6c 69 67 68 |nation, |is sligh|
|00000cb0| 74 6c 79 20 64 69 66 66 | 65 72 65 6e 74 20 66 72 |tly diff|erent fr|
|00000cc0| 6f 6d 20 5c 42 69 62 54 | 65 58 27 73 2e 0a 46 6f |om \BibT|eX's..Fo|
|00000cd0| 72 20 65 78 61 6d 70 6c | 65 2c 20 74 68 69 73 20 |r exampl|e, this |
|00000ce0| 64 6f 63 75 6d 65 6e 74 | 61 74 69 6f 6e 27 73 20 |document|ation's |
|00000cf0| 60 60 76 61 72 69 61 62 | 6c 65 73 27 27 20 61 6e |``variab|les'' an|
|00000d00| 64 20 60 60 66 75 6e 63 | 74 69 6f 6e 73 27 27 0a |d ``func|tions''.|
|00000d10| 61 72 65 20 62 6f 74 68 | 20 60 60 66 75 6e 63 74 |are both| ``funct|
|00000d20| 69 6f 6e 73 27 27 20 74 | 6f 20 5c 42 69 62 54 65 |ions'' t|o \BibTe|
|00000d30| 58 2e 0a 4b 65 65 70 20 | 74 68 69 73 20 69 6e 20 |X..Keep |this in |
|00000d40| 6d 69 6e 64 20 77 68 65 | 6e 20 69 6e 74 65 72 70 |mind whe|n interp|
|00000d50| 72 65 74 69 6e 67 20 5c | 42 69 62 54 65 58 27 73 |reting \|BibTeX's|
|00000d60| 20 65 72 72 6f 72 20 6d | 65 73 73 61 67 65 73 2e | error m|essages.|
|00000d70| 29 0a 0a 54 68 65 72 65 | 20 61 72 65 20 74 77 6f |)..There| are two|
|00000d80| 20 74 79 70 65 73 20 6f | 66 20 66 75 6e 63 74 69 | types o|f functi|
|00000d90| 6f 6e 73 3a 20 7b 5c 69 | 74 20 62 75 69 6c 74 2d |ons: {\i|t built-|
|00000da0| 69 6e 5c 2f 7d 20 6f 6e | 65 73 20 74 68 61 74 20 |in\/} on|es that |
|00000db0| 5c 42 69 62 54 65 58 5c | 20 70 72 6f 76 69 64 65 |\BibTeX\| provide|
|00000dc0| 73 0a 28 74 68 65 73 65 | 20 61 72 65 20 64 65 73 |s.(these| are des|
|00000dd0| 63 72 69 62 65 64 20 69 | 6e 20 53 65 63 74 69 6f |cribed i|n Sectio|
|00000de0| 6e 7e 5c 72 65 66 7b 62 | 75 69 6c 74 2d 69 6e 2d |n~\ref{b|uilt-in-|
|00000df0| 66 6e 73 7d 29 2c 20 61 | 6e 64 20 6f 6e 65 73 20 |fns}), a|nd ones |
|00000e00| 79 6f 75 20 64 65 66 69 | 6e 65 0a 75 73 69 6e 67 |you defi|ne.using|
|00000e10| 20 65 69 74 68 65 72 20 | 74 68 65 20 5c 68 62 6f | either |the \hbo|
|00000e20| 78 7b 5c 74 74 20 4d 41 | 43 52 4f 7d 20 6f 72 20 |x{\tt MA|CRO} or |
|00000e30| 5c 68 62 6f 78 7b 5c 74 | 74 20 46 55 4e 43 54 49 |\hbox{\t|t FUNCTI|
|00000e40| 4f 4e 7d 20 63 6f 6d 6d | 61 6e 64 2e 0a 0a 59 6f |ON} comm|and...Yo|
|00000e50| 75 72 20 6d 6f 73 74 20 | 74 69 6d 65 2d 63 6f 6e |ur most |time-con|
|00000e60| 73 75 6d 69 6e 67 20 74 | 61 73 6b 2c 20 61 73 20 |suming t|ask, as |
|00000e70| 61 20 73 74 79 6c 65 20 | 64 65 73 69 67 6e 65 72 |a style |designer|
|00000e80| 2c 0a 77 69 6c 6c 20 62 | 65 20 63 72 65 61 74 69 |,.will b|e creati|
|00000e90| 6e 67 20 6f 72 20 6d 6f | 64 69 66 79 69 6e 67 20 |ng or mo|difying |
|00000ea0| 66 75 6e 63 74 69 6f 6e | 73 0a 75 73 69 6e 67 20 |function|s.using |
|00000eb0| 74 68 65 20 5c 68 62 6f | 78 7b 5c 74 74 20 46 55 |the \hbo|x{\tt FU|
|00000ec0| 4e 43 54 49 4f 4e 7d 20 | 63 6f 6d 6d 61 6e 64 0a |NCTION} |command.|
|00000ed0| 28 61 63 74 75 61 6c 6c | 79 2c 20 62 65 63 6f 6d |(actuall|y, becom|
|00000ee0| 69 6e 67 20 66 61 6d 69 | 6c 69 61 72 20 77 69 74 |ing fami|liar wit|
|00000ef0| 68 20 74 68 65 20 72 65 | 66 65 72 65 6e 63 65 73 |h the re|ferences|
|00000f00| 20 6c 69 73 74 65 64 20 | 61 62 6f 76 65 20 77 69 | listed |above wi|
|00000f10| 6c 6c 20 62 65 0a 6d 6f | 72 65 20 74 69 6d 65 20 |ll be.mo|re time |
|00000f20| 63 6f 6e 73 75 6d 69 6e | 67 2c 20 62 75 74 20 61 |consumin|g, but a|
|00000f30| 73 73 75 6d 65 20 66 6f | 72 20 74 68 65 20 6d 6f |ssume fo|r the mo|
|00000f40| 6d 65 6e 74 20 74 68 61 | 74 20 74 68 61 74 27 73 |ment tha|t that's|
|00000f50| 20 64 6f 6e 65 29 2e 0a | 0a 4c 65 74 27 73 20 6c | done)..|.Let's l|
|00000f60| 6f 6f 6b 20 61 74 20 61 | 20 73 61 6d 70 6c 65 20 |ook at a| sample |
|00000f70| 66 75 6e 63 74 69 6f 6e | 20 66 72 61 67 6d 65 6e |function| fragmen|
|00000f80| 74 2e 0a 53 75 70 70 6f | 73 65 20 79 6f 75 20 68 |t..Suppo|se you h|
|00000f90| 61 76 65 20 61 20 73 74 | 72 69 6e 67 20 76 61 72 |ave a st|ring var|
|00000fa0| 69 61 62 6c 65 20 6e 61 | 6d 65 64 20 5c 68 62 6f |iable na|med \hbo|
|00000fb0| 78 7b 5c 74 74 20 6c 61 | 62 65 6c 7d 0a 61 6e 64 |x{\tt la|bel}.and|
|00000fc0| 20 61 6e 20 69 6e 74 65 | 67 65 72 20 76 61 72 69 | an inte|ger vari|
|00000fd0| 61 62 6c 65 20 6e 61 6d | 65 64 20 5c 68 62 6f 78 |able nam|ed \hbox|
|00000fe0| 7b 5c 74 74 20 6c 61 62 | 2e 77 69 64 74 68 7d 2c |{\tt lab|.width},|
|00000ff0| 0a 61 6e 64 20 73 75 70 | 70 6f 73 65 20 79 6f 75 |.and sup|pose you|
|00001000| 20 77 61 6e 74 20 74 6f | 20 61 70 70 65 6e 64 20 | want to| append |
|00001010| 74 68 65 20 63 68 61 72 | 61 63 74 65 72 20 60 7b |the char|acter `{|
|00001020| 5c 74 74 20 61 7d 27 20 | 74 6f 20 5c 68 62 6f 78 |\tt a}' |to \hbox|
|00001030| 7b 5c 74 74 20 6c 61 62 | 65 6c 7d 0a 61 6e 64 20 |{\tt lab|el}.and |
|00001040| 74 6f 20 69 6e 63 72 65 | 6d 65 6e 74 20 5c 68 62 |to incre|ment \hb|
|00001050| 6f 78 7b 5c 74 74 20 6c | 61 62 2e 77 69 64 74 68 |ox{\tt l|ab.width|
|00001060| 7d 3a 0a 5c 62 65 67 69 | 6e 7b 76 65 72 62 61 74 |}:.\begi|n{verbat|
|00001070| 69 6d 7d 0a 20 20 20 20 | 2e 20 20 2e 20 20 2e 0a |im}. |. . ..|
|00001080| 20 20 20 20 6c 61 62 65 | 6c 20 22 61 22 20 2a 20 | labe|l "a" * |
|00001090| 27 6c 61 62 65 6c 20 3a | 3d 20 20 20 20 20 20 20 |'label :|= |
|000010a0| 20 20 20 25 20 6c 61 62 | 65 6c 20 3a 3d 20 6c 61 | % lab|el := la|
|000010b0| 62 65 6c 20 2a 20 22 61 | 22 0a 20 20 20 20 6c 61 |bel * "a|". la|
|000010c0| 62 2e 77 69 64 74 68 20 | 23 31 20 2b 20 27 6c 61 |b.width |#1 + 'la|
|000010d0| 62 2e 77 69 64 74 68 20 | 3a 3d 20 20 20 25 20 6c |b.width |:= % l|
|000010e0| 61 62 2e 77 69 64 74 68 | 20 3a 3d 20 6c 61 62 2e |ab.width| := lab.|
|000010f0| 77 69 64 74 68 20 2b 20 | 31 0a 20 20 20 20 2e 20 |width + |1. . |
|00001100| 20 2e 20 20 2e 0a 5c 65 | 6e 64 7b 76 65 72 62 61 | . ..\e|nd{verba|
|00001110| 74 69 6d 7d 0a 49 6e 20 | 74 68 65 20 66 69 72 73 |tim}.In |the firs|
|00001120| 74 20 6c 69 6e 65 2c 0a | 5c 68 62 6f 78 7b 5c 74 |t line,.|\hbox{\t|
|00001130| 74 20 6c 61 62 65 6c 7d | 20 70 75 73 68 65 73 20 |t label}| pushes |
|00001140| 74 68 61 74 20 76 61 72 | 69 61 62 6c 65 27 73 20 |that var|iable's |
|00001150| 76 61 6c 75 65 20 6f 6e | 74 6f 20 74 68 65 20 73 |value on|to the s|
|00001160| 74 61 63 6b 2e 0a 4e 65 | 78 74 2c 20 74 68 65 20 |tack..Ne|xt, the |
|00001170| 7b 5c 74 74 20 22 61 22 | 7d 20 70 75 73 68 65 73 |{\tt "a"|} pushes|
|00001180| 20 74 68 65 20 73 74 72 | 69 6e 67 20 63 6f 6e 73 | the str|ing cons|
|00001190| 74 61 6e 74 20 60 7b 5c | 74 74 20 61 7d 27 20 6f |tant `{\|tt a}' o|
|000011a0| 6e 74 6f 20 74 68 65 20 | 73 74 61 63 6b 2e 0a 54 |nto the |stack..T|
|000011b0| 68 65 6e 20 74 68 65 20 | 62 75 69 6c 74 2d 69 6e |hen the |built-in|
|000011c0| 20 66 75 6e 63 74 69 6f | 6e 20 7b 5c 74 74 20 2a | functio|n {\tt *|
|000011d0| 7d 20 70 6f 70 73 20 74 | 68 65 20 74 6f 70 20 74 |} pops t|he top t|
|000011e0| 77 6f 20 73 74 72 69 6e | 67 73 20 61 6e 64 0a 70 |wo strin|gs and.p|
|000011f0| 75 73 68 65 73 20 74 68 | 65 69 72 20 63 6f 6e 63 |ushes th|eir conc|
|00001200| 61 74 65 6e 61 74 69 6f | 6e 2e 0a 54 68 65 20 5c |atenatio|n..The \|
|00001210| 68 62 6f 78 7b 5c 74 74 | 20 27 6c 61 62 65 6c 7d |hbox{\tt| 'label}|
|00001220| 20 70 75 73 68 65 73 20 | 74 68 61 74 20 76 61 72 | pushes |that var|
|00001230| 69 61 62 6c 65 27 73 20 | 6e 61 6d 65 20 6f 6e 74 |iable's |name ont|
|00001240| 6f 20 74 68 65 20 73 74 | 61 63 6b 2e 0a 41 6e 64 |o the st|ack..And|
|00001250| 20 66 69 6e 61 6c 6c 79 | 2c 20 74 68 65 20 62 75 | finally|, the bu|
|00001260| 69 6c 74 2d 69 6e 20 66 | 75 6e 63 74 69 6f 6e 20 |ilt-in f|unction |
|00001270| 7b 5c 74 74 20 3a 3d 7d | 20 70 6f 70 73 0a 74 68 |{\tt :=}| pops.th|
|00001280| 65 20 76 61 72 69 61 62 | 6c 65 20 6e 61 6d 65 20 |e variab|le name |
|00001290| 61 6e 64 20 74 68 65 20 | 63 6f 6e 63 61 74 65 6e |and the |concaten|
|000012a0| 61 74 69 6f 6e 20 61 6e | 64 20 70 65 72 66 6f 72 |ation an|d perfor|
|000012b0| 6d 73 20 74 68 65 20 61 | 73 73 69 67 6e 6d 65 6e |ms the a|ssignmen|
|000012c0| 74 2e 0a 5c 42 69 62 54 | 65 58 5c 20 74 72 65 61 |t..\BibT|eX\ trea|
|000012d0| 74 73 20 74 68 65 20 73 | 74 75 66 66 20 66 6f 6c |ts the s|tuff fol|
|000012e0| 6c 6f 77 69 6e 67 20 74 | 68 65 20 7b 5c 74 74 20 |lowing t|he {\tt |
|000012f0| 5c 25 7d 20 61 73 20 61 | 20 63 6f 6d 6d 65 6e 74 |\%} as a| comment|
|00001300| 0a 69 6e 20 74 68 65 20 | 73 74 79 6c 65 20 66 69 |.in the |style fi|
|00001310| 6c 65 2e 0a 54 68 65 20 | 73 65 63 6f 6e 64 20 6c |le..The |second l|
|00001320| 69 6e 65 20 69 73 20 73 | 69 6d 69 6c 61 72 20 65 |ine is s|imilar e|
|00001330| 78 63 65 70 74 20 74 68 | 61 74 20 69 74 20 75 73 |xcept th|at it us|
|00001340| 65 73 20 7b 5c 74 74 20 | 5c 23 31 7d 2c 0a 77 69 |es {\tt |\#1},.wi|
|00001350| 74 68 20 6e 6f 20 73 70 | 61 63 65 73 20 69 6e 74 |th no sp|aces int|
|00001360| 65 72 76 65 6e 69 6e 67 | 20 62 65 74 77 65 65 6e |ervening| between|
|00001370| 20 74 68 65 20 60 7b 5c | 74 74 20 5c 23 7d 27 20 | the `{\|tt \#}' |
|00001380| 61 6e 64 20 74 68 65 20 | 60 7b 5c 74 74 20 31 7d |and the |`{\tt 1}|
|00001390| 27 24 5c 21 24 2c 0a 74 | 6f 20 70 75 73 68 20 74 |'$\!$,.t|o push t|
|000013a0| 68 69 73 20 69 6e 74 65 | 67 65 72 20 63 6f 6e 73 |his inte|ger cons|
|000013b0| 74 61 6e 74 2e 0a 0a 54 | 68 65 20 6e 6f 6e 6e 75 |tant...T|he nonnu|
|000013c0| 6c 6c 20 73 70 61 63 69 | 6e 67 20 68 65 72 65 20 |ll spaci|ng here |
|000013d0| 69 73 20 61 72 62 69 74 | 72 61 72 79 3a 20 6d 75 |is arbit|rary: mu|
|000013e0| 6c 74 69 70 6c 65 20 73 | 70 61 63 65 73 2c 20 74 |ltiple s|paces, t|
|000013f0| 61 62 73 2c 20 6f 72 20 | 6e 65 77 6c 69 6e 65 73 |abs, or |newlines|
|00001400| 0a 61 72 65 20 65 71 75 | 69 76 61 6c 65 6e 74 20 |.are equ|ivalent |
|00001410| 74 6f 20 61 20 73 69 6e | 67 6c 65 20 6f 6e 65 20 |to a sin|gle one |
|00001420| 28 65 78 63 65 70 74 20 | 74 68 61 74 20 79 6f 75 |(except |that you|
|00001430| 27 72 65 20 70 72 6f 62 | 61 62 6c 79 20 62 65 74 |'re prob|ably bet|
|00001440| 74 65 72 20 6f 66 66 0a | 6e 6f 74 20 68 61 76 69 |ter off.|not havi|
|00001450| 6e 67 20 62 6c 61 6e 6b | 20 6c 69 6e 65 73 20 77 |ng blank| lines w|
|00001460| 69 74 68 69 6e 20 63 6f | 6d 6d 61 6e 64 73 2c 20 |ithin co|mmands, |
|00001470| 61 73 20 65 78 70 6c 61 | 69 6e 65 64 20 73 68 6f |as expla|ined sho|
|00001480| 72 74 6c 79 29 2e 0a 0a | 46 6f 72 20 73 74 72 69 |rtly)...|For stri|
|00001490| 6e 67 20 63 6f 6e 73 74 | 61 6e 74 73 2c 20 61 62 |ng const|ants, ab|
|000014a0| 73 6f 6c 75 74 65 6c 79 | 20 61 6e 79 20 70 72 69 |solutely| any pri|
|000014b0| 6e 74 69 6e 67 20 63 68 | 61 72 61 63 74 65 72 0a |nting ch|aracter.|
|000014c0| 69 73 20 6c 65 67 61 6c | 20 62 65 74 77 65 65 6e |is legal| between|
|000014d0| 20 74 77 6f 20 63 6f 6e | 73 65 63 75 74 69 76 65 | two con|secutive|
|000014e0| 20 64 6f 75 62 6c 65 20 | 71 75 6f 74 65 73 2c 20 | double |quotes, |
|000014f0| 62 75 74 20 5c 42 69 62 | 54 65 58 5c 20 68 65 72 |but \Bib|TeX\ her|
|00001500| 65 0a 28 61 6e 64 20 6f | 6e 6c 79 20 68 65 72 65 |e.(and o|nly here|
|00001510| 29 20 74 72 65 61 74 73 | 20 75 70 70 65 72 2d 20 |) treats| upper- |
|00001520| 61 6e 64 20 6c 6f 77 65 | 72 2d 63 61 73 65 20 65 |and lowe|r-case e|
|00001530| 71 75 69 76 61 6c 65 6e | 74 73 20 61 73 20 64 69 |quivalen|ts as di|
|00001540| 66 66 65 72 65 6e 74 2e | 0a 46 75 72 74 68 65 72 |fferent.|.Further|
|00001550| 6d 6f 72 65 2c 20 73 70 | 61 63 69 6e 67 20 7b 5c |more, sp|acing {\|
|00001560| 65 6d 20 69 73 5c 2f 7d | 20 72 65 6c 65 76 61 6e |em is\/}| relevan|
|00001570| 74 20 77 69 74 68 69 6e | 20 61 20 73 74 72 69 6e |t within| a strin|
|00001580| 67 20 63 6f 6e 73 74 61 | 6e 74 2c 0a 61 6e 64 20 |g consta|nt,.and |
|00001590| 79 6f 75 20 6d 75 73 74 | 6e 27 74 20 73 70 6c 69 |you must|n't spli|
|000015a0| 74 20 61 20 73 74 72 69 | 6e 67 20 63 6f 6e 73 74 |t a stri|ng const|
|000015b0| 61 6e 74 20 61 63 72 6f | 73 73 20 6c 69 6e 65 73 |ant acro|ss lines|
|000015c0| 0a 28 74 68 61 74 20 69 | 73 2c 20 74 68 65 20 62 |.(that i|s, the b|
|000015d0| 65 67 69 6e 6e 69 6e 67 | 20 61 6e 64 20 65 6e 64 |eginning| and end|
|000015e0| 69 6e 67 20 64 6f 75 62 | 6c 65 20 71 75 6f 74 65 |ing doub|le quote|
|000015f0| 73 20 6d 75 73 74 20 62 | 65 20 6f 6e 20 74 68 65 |s must b|e on the|
|00001600| 20 73 61 6d 65 20 6c 69 | 6e 65 29 2e 0a 0a 56 61 | same li|ne)...Va|
|00001610| 72 69 61 62 6c 65 20 61 | 6e 64 20 66 75 6e 63 74 |riable a|nd funct|
|00001620| 69 6f 6e 20 6e 61 6d 65 | 73 20 6d 61 79 20 6e 6f |ion name|s may no|
|00001630| 74 20 62 65 67 69 6e 20 | 77 69 74 68 20 61 20 6e |t begin |with a n|
|00001640| 75 6d 65 72 61 6c 20 61 | 6e 64 0a 6d 61 79 20 6e |umeral a|nd.may n|
|00001650| 6f 74 20 63 6f 6e 74 61 | 69 6e 20 61 6e 79 20 6f |ot conta|in any o|
|00001660| 66 20 74 68 65 20 74 65 | 6e 20 72 65 73 74 72 69 |f the te|n restri|
|00001670| 63 74 65 64 20 63 68 61 | 72 61 63 74 65 72 73 0a |cted cha|racters.|
|00001680| 6f 6e 20 70 61 67 65 7e | 31 34 33 20 6f 66 20 74 |on page~|143 of t|
|00001690| 68 65 20 5c 4c 61 54 65 | 58 5c 20 62 6f 6f 6b 2c |he \LaTe|X\ book,|
|000016a0| 0a 62 75 74 20 6d 61 79 | 20 6f 74 68 65 72 77 69 |.but may| otherwi|
|000016b0| 73 65 20 63 6f 6e 74 61 | 69 6e 20 61 6e 79 20 70 |se conta|in any p|
|000016c0| 72 69 6e 74 69 6e 67 20 | 63 68 61 72 61 63 74 65 |rinting |characte|
|000016d0| 72 73 2e 0a 41 6c 73 6f | 2c 20 5c 42 69 62 54 65 |rs..Also|, \BibTe|
|000016e0| 58 5c 20 63 6f 6e 73 69 | 64 65 72 73 20 75 70 70 |X\ consi|ders upp|
|000016f0| 65 72 2d 20 61 6e 64 20 | 6c 6f 77 65 72 2d 63 61 |er- and |lower-ca|
|00001700| 73 65 20 65 71 75 69 76 | 61 6c 65 6e 74 73 20 74 |se equiv|alents t|
|00001710| 6f 20 62 65 20 74 68 65 | 20 73 61 6d 65 2e 0a 0a |o be the| same...|
|00001720| 49 6e 74 65 67 65 72 73 | 20 61 6e 64 20 73 74 72 |Integers| and str|
|00001730| 69 6e 67 73 20 61 72 65 | 20 74 68 65 20 6f 6e 6c |ings are| the onl|
|00001740| 79 20 76 61 6c 75 65 20 | 74 79 70 65 73 20 66 6f |y value |types fo|
|00001750| 72 20 63 6f 6e 73 74 61 | 6e 74 73 20 61 6e 64 20 |r consta|nts and |
|00001760| 76 61 72 69 61 62 6c 65 | 73 0a 28 62 6f 6f 6c 65 |variable|s.(boole|
|00001770| 61 6e 73 20 61 72 65 20 | 69 6d 70 6c 65 6d 65 6e |ans are |implemen|
|00001780| 74 65 64 20 73 69 6d 70 | 6c 79 20 61 73 20 30 2d |ted simp|ly as 0-|
|00001790| 6f 72 2d 31 20 69 6e 74 | 65 67 65 72 73 29 2e 0a |or-1 int|egers)..|
|000017a0| 54 68 65 72 65 20 61 72 | 65 20 74 68 72 65 65 20 |There ar|e three |
|000017b0| 6b 69 6e 64 73 20 6f 66 | 20 76 61 72 69 61 62 6c |kinds of| variabl|
|000017c0| 65 73 3a 0a 5c 62 65 67 | 69 6e 7b 64 65 73 63 72 |es:.\beg|in{descr|
|000017d0| 69 70 74 69 6f 6e 7d 0a | 0a 5c 69 74 65 6d 5b 67 |iption}.|.\item[g|
|000017e0| 6c 6f 62 61 6c 20 76 61 | 72 69 61 62 6c 65 73 5c |lobal va|riables\|
|000017f0| 68 66 69 6c 6c 5d 20 54 | 68 65 73 65 20 61 72 65 |hfill] T|hese are|
|00001800| 20 65 69 74 68 65 72 20 | 69 6e 74 65 67 65 72 2d | either |integer-|
|00001810| 20 6f 72 20 73 74 72 69 | 6e 67 2d 76 61 6c 75 65 | or stri|ng-value|
|00001820| 64 2c 0a 64 65 63 6c 61 | 72 65 64 20 75 73 69 6e |d,.decla|red usin|
|00001830| 67 20 61 6e 20 5c 68 62 | 6f 78 7b 5c 74 74 20 49 |g an \hb|ox{\tt I|
|00001840| 4e 54 45 47 45 52 53 7d | 20 6f 72 20 5c 68 62 6f |NTEGERS}| or \hbo|
|00001850| 78 7b 5c 74 74 20 53 54 | 52 49 4e 47 53 7d 20 63 |x{\tt ST|RINGS} c|
|00001860| 6f 6d 6d 61 6e 64 2e 0a | 0a 5c 69 74 65 6d 5b 65 |ommand..|.\item[e|
|00001870| 6e 74 72 79 20 76 61 72 | 69 61 62 6c 65 73 5c 68 |ntry var|iables\h|
|00001880| 66 69 6c 6c 5d 20 54 68 | 65 73 65 20 61 72 65 20 |fill] Th|ese are |
|00001890| 65 69 74 68 65 72 20 69 | 6e 74 65 67 65 72 2d 20 |either i|nteger- |
|000018a0| 6f 72 20 73 74 72 69 6e | 67 2d 76 61 6c 75 65 64 |or strin|g-valued|
|000018b0| 2c 0a 64 65 63 6c 61 72 | 65 64 20 75 73 69 6e 67 |,.declar|ed using|
|000018c0| 20 74 68 65 20 5c 68 62 | 6f 78 7b 5c 74 74 20 45 | the \hb|ox{\tt E|
|000018d0| 4e 54 52 59 7d 20 63 6f | 6d 6d 61 6e 64 2e 0a 45 |NTRY} co|mmand..E|
|000018e0| 61 63 68 20 68 61 73 20 | 61 20 76 61 6c 75 65 20 |ach has |a value |
|000018f0| 66 6f 72 20 65 61 63 68 | 20 65 6e 74 72 79 20 6f |for each| entry o|
|00001900| 6e 20 74 68 65 20 6c 69 | 73 74 0a 28 65 78 61 6d |n the li|st.(exam|
|00001910| 70 6c 65 3a 20 61 20 76 | 61 72 69 61 62 6c 65 20 |ple: a v|ariable |
|00001920| 5c 68 62 6f 78 7b 5c 74 | 74 20 6c 61 62 65 6c 7d |\hbox{\t|t label}|
|00001930| 20 6d 69 67 68 74 20 73 | 74 6f 72 65 0a 74 68 65 | might s|tore.the|
|00001940| 20 6c 61 62 65 6c 20 73 | 74 72 69 6e 67 20 79 6f | label s|tring yo|
|00001950| 75 27 6c 6c 20 75 73 65 | 20 66 6f 72 20 74 68 65 |u'll use| for the|
|00001960| 20 65 6e 74 72 79 29 2e | 0a 0a 5c 69 74 65 6d 5b | entry).|..\item[|
|00001970| 66 69 65 6c 64 73 5c 68 | 66 69 6c 6c 5d 20 54 68 |fields\h|fill] Th|
|00001980| 65 73 65 20 61 72 65 20 | 73 74 72 69 6e 67 2d 76 |ese are |string-v|
|00001990| 61 6c 75 65 64 2c 20 72 | 65 61 64 2d 6f 6e 6c 79 |alued, r|ead-only|
|000019a0| 20 76 61 72 69 61 62 6c | 65 73 0a 74 68 61 74 20 | variabl|es.that |
|000019b0| 73 74 6f 72 65 20 74 68 | 65 20 69 6e 66 6f 72 6d |store th|e inform|
|000019c0| 61 74 69 6f 6e 20 66 72 | 6f 6d 20 74 68 65 20 64 |ation fr|om the d|
|000019d0| 61 74 61 62 61 73 65 20 | 66 69 6c 65 3b 0a 74 68 |atabase |file;.th|
|000019e0| 65 69 72 20 76 61 6c 75 | 65 73 20 61 72 65 20 73 |eir valu|es are s|
|000019f0| 65 74 20 62 79 20 74 68 | 65 20 5c 68 62 6f 78 7b |et by th|e \hbox{|
|00001a00| 5c 74 74 20 52 45 41 44 | 7d 20 63 6f 6d 6d 61 6e |\tt READ|} comman|
|00001a10| 64 2e 0a 41 73 20 77 69 | 74 68 20 65 6e 74 72 79 |d..As wi|th entry|
|00001a20| 20 76 61 72 69 61 62 6c | 65 73 2c 20 65 61 63 68 | variabl|es, each|
|00001a30| 20 68 61 73 20 61 20 76 | 61 6c 75 65 20 66 6f 72 | has a v|alue for|
|00001a40| 20 65 61 63 68 20 65 6e | 74 72 79 2e 0a 5c 65 6e | each en|try..\en|
|00001a50| 64 7b 64 65 73 63 72 69 | 70 74 69 6f 6e 7d 0a 0a |d{descri|ption}..|
|00001a60| 0a 5c 73 75 62 73 65 63 | 74 69 6f 6e 7b 43 6f 6d |.\subsec|tion{Com|
|00001a70| 6d 61 6e 64 73 7d 0a 0a | 54 68 65 72 65 20 61 72 |mands}..|There ar|
|00001a80| 65 20 74 65 6e 20 73 74 | 79 6c 65 2d 66 69 6c 65 |e ten st|yle-file|
|00001a90| 20 63 6f 6d 6d 61 6e 64 | 73 3a 0a 46 69 76 65 20 | command|s:.Five |
|00001aa0| 28 5c 68 62 6f 78 7b 5c | 74 74 20 45 4e 54 52 59 |(\hbox{\|tt ENTRY|
|00001ab0| 7d 2c 20 5c 68 62 6f 78 | 7b 5c 74 74 20 46 55 4e |}, \hbox|{\tt FUN|
|00001ac0| 43 54 49 4f 4e 7d 2c 20 | 5c 68 62 6f 78 7b 5c 74 |CTION}, |\hbox{\t|
|00001ad0| 74 20 49 4e 54 45 47 45 | 52 53 7d 2c 0a 5c 68 62 |t INTEGE|RS},.\hb|
|00001ae0| 6f 78 7b 5c 74 74 20 4d | 41 43 52 4f 7d 2c 20 61 |ox{\tt M|ACRO}, a|
|00001af0| 6e 64 20 5c 68 62 6f 78 | 7b 5c 74 74 20 53 54 52 |nd \hbox|{\tt STR|
|00001b00| 49 4e 47 53 7d 29 0a 64 | 65 63 6c 61 72 65 20 61 |INGS}).d|eclare a|
|00001b10| 6e 64 20 64 65 66 69 6e | 65 20 76 61 72 69 61 62 |nd defin|e variab|
|00001b20| 6c 65 73 20 61 6e 64 20 | 66 75 6e 63 74 69 6f 6e |les and |function|
|00001b30| 73 3b 0a 6f 6e 65 20 28 | 5c 68 62 6f 78 7b 5c 74 |s;.one (|\hbox{\t|
|00001b40| 74 20 52 45 41 44 7d 29 | 20 72 65 61 64 73 20 69 |t READ})| reads i|
|00001b50| 6e 20 74 68 65 20 64 61 | 74 61 62 61 73 65 20 69 |n the da|tabase i|
|00001b60| 6e 66 6f 72 6d 61 74 69 | 6f 6e 3b 0a 61 6e 64 20 |nformati|on;.and |
|00001b70| 66 6f 75 72 20 28 5c 68 | 62 6f 78 7b 5c 74 74 20 |four (\h|box{\tt |
|00001b80| 45 58 45 43 55 54 45 7d | 2c 20 5c 68 62 6f 78 7b |EXECUTE}|, \hbox{|
|00001b90| 5c 74 74 20 49 54 45 52 | 41 54 45 7d 2c 20 5c 68 |\tt ITER|ATE}, \h|
|00001ba0| 62 6f 78 7b 5c 74 74 20 | 52 45 56 45 52 53 45 7d |box{\tt |REVERSE}|
|00001bb0| 2c 0a 61 6e 64 20 5c 68 | 62 6f 78 7b 5c 74 74 20 |,.and \h|box{\tt |
|00001bc0| 53 4f 52 54 7d 29 20 6d | 61 6e 69 70 75 6c 61 74 |SORT}) m|anipulat|
|00001bd0| 65 20 74 68 65 20 65 6e | 74 72 69 65 73 20 61 6e |e the en|tries an|
|00001be0| 64 20 70 72 6f 64 75 63 | 65 20 6f 75 74 70 75 74 |d produc|e output|
|00001bf0| 2e 0a 41 6c 74 68 6f 75 | 67 68 20 74 68 65 20 63 |..Althou|gh the c|
|00001c00| 6f 6d 6d 61 6e 64 20 6e | 61 6d 65 73 20 61 70 70 |ommand n|ames app|
|00001c10| 65 61 72 20 68 65 72 65 | 20 69 6e 20 75 70 70 65 |ear here| in uppe|
|00001c20| 72 20 63 61 73 65 2c 0a | 5c 42 69 62 54 65 58 5c |r case,.|\BibTeX\|
|00001c30| 20 69 67 6e 6f 72 65 73 | 20 63 61 73 65 20 64 69 | ignores| case di|
|00001c40| 66 66 65 72 65 6e 63 65 | 73 2e 0a 0a 53 6f 6d 65 |fference|s...Some|
|00001c50| 20 72 65 73 74 72 69 63 | 74 69 6f 6e 73 3a 0a 54 | restric|tions:.T|
|00001c60| 68 65 72 65 20 6d 75 73 | 74 20 62 65 20 65 78 61 |here mus|t be exa|
|00001c70| 63 74 6c 79 20 6f 6e 65 | 20 5c 68 62 6f 78 7b 5c |ctly one| \hbox{\|
|00001c80| 74 74 20 45 4e 54 52 59 | 7d 20 61 6e 64 20 6f 6e |tt ENTRY|} and on|
|00001c90| 65 20 5c 68 62 6f 78 7b | 5c 74 74 20 52 45 41 44 |e \hbox{|\tt READ|
|00001ca0| 7d 20 63 6f 6d 6d 61 6e | 64 3b 0a 74 68 65 20 5c |} comman|d;.the \|
|00001cb0| 68 62 6f 78 7b 5c 74 74 | 20 45 4e 54 52 59 7d 20 |hbox{\tt| ENTRY} |
|00001cc0| 63 6f 6d 6d 61 6e 64 2c | 20 61 6c 6c 20 5c 68 62 |command,| all \hb|
|00001cd0| 6f 78 7b 5c 74 74 20 4d | 41 43 52 4f 7d 20 63 6f |ox{\tt M|ACRO} co|
|00001ce0| 6d 6d 61 6e 64 73 2c 0a | 61 6e 64 20 63 65 72 74 |mmands,.|and cert|
|00001cf0| 61 69 6e 20 5c 68 62 6f | 78 7b 5c 74 74 20 46 55 |ain \hbo|x{\tt FU|
|00001d00| 4e 43 54 49 4f 4e 7d 20 | 63 6f 6d 6d 61 6e 64 73 |NCTION} |commands|
|00001d10| 0a 28 73 65 65 20 6e 65 | 78 74 20 73 75 62 73 65 |.(see ne|xt subse|
|00001d20| 63 74 69 6f 6e 27 73 20 | 64 65 73 63 72 69 70 74 |ction's |descript|
|00001d30| 69 6f 6e 20 6f 66 20 5c | 68 62 6f 78 7b 5c 74 74 |ion of \|hbox{\tt|
|00001d40| 20 63 61 6c 6c 2e 74 79 | 70 65 5c 24 7d 29 0a 6d | call.ty|pe\$}).m|
|00001d50| 75 73 74 20 70 72 65 63 | 65 64 65 20 74 68 65 20 |ust prec|ede the |
|00001d60| 5c 68 62 6f 78 7b 5c 74 | 74 20 52 45 41 44 7d 20 |\hbox{\t|t READ} |
|00001d70| 63 6f 6d 6d 61 6e 64 3b | 0a 61 6e 64 20 74 68 65 |command;|.and the|
|00001d80| 20 5c 68 62 6f 78 7b 5c | 74 74 20 52 45 41 44 7d | \hbox{\|tt READ}|
|00001d90| 20 63 6f 6d 6d 61 6e 64 | 20 6d 75 73 74 20 70 72 | command| must pr|
|00001da0| 65 63 65 64 65 20 74 68 | 65 20 66 6f 75 72 20 74 |ecede th|e four t|
|00001db0| 68 61 74 0a 6d 61 6e 69 | 70 75 6c 61 74 65 20 74 |hat.mani|pulate t|
|00001dc0| 68 65 20 65 6e 74 72 69 | 65 73 20 61 6e 64 20 70 |he entri|es and p|
|00001dd0| 72 6f 64 75 63 65 20 6f | 75 74 70 75 74 2e 0a 0a |roduce o|utput...|
|00001de0| 41 6c 73 6f 20 69 74 27 | 73 20 62 65 73 74 20 28 |Also it'|s best (|
|00001df0| 62 75 74 20 6e 6f 74 20 | 65 73 73 65 6e 74 69 61 |but not |essentia|
|00001e00| 6c 29 20 74 6f 20 6c 65 | 61 76 65 20 61 74 20 6c |l) to le|ave at l|
|00001e10| 65 61 73 74 20 6f 6e 65 | 20 62 6c 61 6e 6b 20 6c |east one| blank l|
|00001e20| 69 6e 65 0a 62 65 74 77 | 65 65 6e 20 63 6f 6d 6d |ine.betw|een comm|
|00001e30| 61 6e 64 73 20 61 6e 64 | 20 74 6f 20 6c 65 61 76 |ands and| to leav|
|00001e40| 65 20 6e 6f 20 62 6c 61 | 6e 6b 20 6c 69 6e 65 73 |e no bla|nk lines|
|00001e50| 20 77 69 74 68 69 6e 20 | 61 20 63 6f 6d 6d 61 6e | within |a comman|
|00001e60| 64 3b 0a 74 68 69 73 20 | 68 65 6c 70 73 20 5c 42 |d;.this |helps \B|
|00001e70| 69 62 54 65 58 5c 20 72 | 65 63 6f 76 65 72 20 66 |ibTeX\ r|ecover f|
|00001e80| 72 6f 6d 20 61 6e 79 20 | 73 79 6e 74 61 78 20 65 |rom any |syntax e|
|00001e90| 72 72 6f 72 73 20 79 6f | 75 20 6d 61 6b 65 2e 0a |rrors yo|u make..|
|00001ea0| 0a 59 6f 75 20 6d 75 73 | 74 20 65 6e 63 6c 6f 73 |.You mus|t enclos|
|00001eb0| 65 20 65 61 63 68 20 61 | 72 67 75 6d 65 6e 74 20 |e each a|rgument |
|00001ec0| 6f 66 20 65 76 65 72 79 | 20 63 6f 6d 6d 61 6e 64 |of every| command|
|00001ed0| 20 69 6e 20 62 72 61 63 | 65 73 2e 0a 4c 6f 6f 6b | in brac|es..Look|
|00001ee0| 20 61 74 20 74 68 65 20 | 73 74 61 6e 64 61 72 64 | at the |standard|
|00001ef0| 2d 73 74 79 6c 65 20 64 | 6f 63 75 6d 65 6e 74 61 |-style d|ocumenta|
|00001f00| 74 69 6f 6e 0a 66 6f 72 | 20 73 79 6e 74 61 63 74 |tion.for| syntact|
|00001f10| 69 63 20 69 73 73 75 65 | 73 20 6e 6f 74 20 64 65 |ic issue|s not de|
|00001f20| 73 63 72 69 62 65 64 20 | 69 6e 20 74 68 69 73 20 |scribed |in this |
|00001f30| 73 65 63 74 69 6f 6e 2e | 0a 48 65 72 65 20 61 72 |section.|.Here ar|
|00001f40| 65 20 74 68 65 20 74 65 | 6e 20 63 6f 6d 6d 61 6e |e the te|n comman|
|00001f50| 64 73 3a 0a 5c 62 65 67 | 69 6e 7b 64 65 73 63 72 |ds:.\beg|in{descr|
|00001f60| 69 70 74 69 6f 6e 7d 0a | 0a 5c 69 74 65 6d 5b 5c |iption}.|.\item[\|
|00001f70| 68 62 6f 78 7b 5c 74 74 | 20 45 4e 54 52 59 7d 5c |hbox{\tt| ENTRY}\|
|00001f80| 68 66 69 6c 6c 5d 0a 44 | 65 63 6c 61 72 65 73 20 |hfill].D|eclares |
|00001f90| 74 68 65 20 66 69 65 6c | 64 73 20 61 6e 64 20 65 |the fiel|ds and e|
|00001fa0| 6e 74 72 79 20 76 61 72 | 69 61 62 6c 65 73 2e 0a |ntry var|iables..|
|00001fb0| 49 74 20 68 61 73 20 74 | 68 72 65 65 20 61 72 67 |It has t|hree arg|
|00001fc0| 75 6d 65 6e 74 73 2c 20 | 65 61 63 68 20 61 20 28 |uments, |each a (|
|00001fd0| 70 6f 73 73 69 62 6c 79 | 20 65 6d 70 74 79 29 20 |possibly| empty) |
|00001fe0| 6c 69 73 74 20 6f 66 20 | 76 61 72 69 61 62 6c 65 |list of |variable|
|00001ff0| 20 6e 61 6d 65 73 2e 0a | 54 68 65 20 74 68 72 65 | names..|The thre|
|00002000| 65 20 6c 69 73 74 73 20 | 61 72 65 20 6f 66 3a 0a |e lists |are of:.|
|00002010| 66 69 65 6c 64 73 2c 20 | 69 6e 74 65 67 65 72 20 |fields, |integer |
|00002020| 65 6e 74 72 79 20 76 61 | 72 69 61 62 6c 65 73 2c |entry va|riables,|
|00002030| 20 61 6e 64 20 73 74 72 | 69 6e 67 20 65 6e 74 72 | and str|ing entr|
|00002040| 79 20 76 61 72 69 61 62 | 6c 65 73 2e 0a 54 68 65 |y variab|les..The|
|00002050| 72 65 20 69 73 20 61 6e | 20 61 64 64 69 74 69 6f |re is an| additio|
|00002060| 6e 61 6c 20 66 69 65 6c | 64 20 74 68 61 74 20 5c |nal fiel|d that \|
|00002070| 42 69 62 54 65 58 5c 20 | 61 75 74 6f 6d 61 74 69 |BibTeX\ |automati|
|00002080| 63 61 6c 6c 79 0a 64 65 | 63 6c 61 72 65 73 2c 20 |cally.de|clares, |
|00002090| 5c 68 62 6f 78 7b 5c 74 | 74 20 63 72 6f 73 73 72 |\hbox{\t|t crossr|
|000020a0| 65 66 7d 2c 20 75 73 65 | 64 20 66 6f 72 20 63 72 |ef}, use|d for cr|
|000020b0| 6f 73 73 20 72 65 66 65 | 72 65 6e 63 69 6e 67 2e |oss refe|rencing.|
|000020c0| 0a 41 6e 64 20 74 68 65 | 72 65 20 69 73 20 61 6e |.And the|re is an|
|000020d0| 20 61 64 64 69 74 69 6f | 6e 61 6c 20 73 74 72 69 | additio|nal stri|
|000020e0| 6e 67 20 65 6e 74 72 79 | 20 76 61 72 69 61 62 6c |ng entry| variabl|
|000020f0| 65 20 61 75 74 6f 6d 61 | 74 69 63 61 6c 6c 79 20 |e automa|tically |
|00002100| 64 65 63 6c 61 72 65 64 | 2c 0a 5c 68 62 6f 78 7b |declared|,.\hbox{|
|00002110| 5c 74 74 20 73 6f 72 74 | 2e 6b 65 79 5c 24 7d 2c |\tt sort|.key\$},|
|00002120| 20 75 73 65 64 20 62 79 | 20 74 68 65 20 5c 68 62 | used by| the \hb|
|00002130| 6f 78 7b 5c 74 74 20 53 | 4f 52 54 7d 20 63 6f 6d |ox{\tt S|ORT} com|
|00002140| 6d 61 6e 64 2e 0a 45 61 | 63 68 20 6f 66 20 74 68 |mand..Ea|ch of th|
|00002150| 65 73 65 20 76 61 72 69 | 61 62 6c 65 73 20 68 61 |ese vari|ables ha|
|00002160| 73 20 61 20 76 61 6c 75 | 65 20 66 6f 72 20 65 61 |s a valu|e for ea|
|00002170| 63 68 20 65 6e 74 72 79 | 20 6f 6e 20 74 68 65 20 |ch entry| on the |
|00002180| 6c 69 73 74 2e 0a 0a 5c | 69 74 65 6d 5b 5c 68 62 |list...\|item[\hb|
|00002190| 6f 78 7b 5c 74 74 20 45 | 58 45 43 55 54 45 7d 5c |ox{\tt E|XECUTE}\|
|000021a0| 68 66 69 6c 6c 5d 0a 45 | 78 65 63 75 74 65 73 20 |hfill].E|xecutes |
|000021b0| 61 20 73 69 6e 67 6c 65 | 20 66 75 6e 63 74 69 6f |a single| functio|
|000021c0| 6e 2e 0a 49 74 20 68 61 | 73 20 6f 6e 65 20 61 72 |n..It ha|s one ar|
|000021d0| 67 75 6d 65 6e 74 2c 20 | 74 68 65 20 66 75 6e 63 |gument, |the func|
|000021e0| 74 69 6f 6e 20 6e 61 6d | 65 2e 0a 0a 5c 69 74 65 |tion nam|e...\ite|
|000021f0| 6d 5b 5c 68 62 6f 78 7b | 5c 74 74 20 46 55 4e 43 |m[\hbox{|\tt FUNC|
|00002200| 54 49 4f 4e 7d 5c 68 66 | 69 6c 6c 5d 0a 44 65 66 |TION}\hf|ill].Def|
|00002210| 69 6e 65 73 20 61 20 6e | 65 77 20 66 75 6e 63 74 |ines a n|ew funct|
|00002220| 69 6f 6e 2e 0a 49 74 20 | 68 61 73 20 74 77 6f 20 |ion..It |has two |
|00002230| 61 72 67 75 6d 65 6e 74 | 73 3b 20 74 68 65 20 66 |argument|s; the f|
|00002240| 69 72 73 74 20 69 73 20 | 74 68 65 20 66 75 6e 63 |irst is |the func|
|00002250| 74 69 6f 6e 27 73 20 6e | 61 6d 65 20 61 6e 64 20 |tion's n|ame and |
|00002260| 74 68 65 0a 73 65 63 6f | 6e 64 20 69 73 20 69 74 |the.seco|nd is it|
|00002270| 73 20 64 65 66 69 6e 69 | 74 69 6f 6e 2e 0a 59 6f |s defini|tion..Yo|
|00002280| 75 20 6d 75 73 74 20 64 | 65 66 69 6e 65 20 61 20 |u must d|efine a |
|00002290| 66 75 6e 63 74 69 6f 6e | 20 62 65 66 6f 72 65 20 |function| before |
|000022a0| 75 73 69 6e 67 20 69 74 | 3b 0a 72 65 63 75 72 73 |using it|;.recurs|
|000022b0| 69 76 65 20 66 75 6e 63 | 74 69 6f 6e 73 20 61 72 |ive func|tions ar|
|000022c0| 65 20 74 68 75 73 20 69 | 6c 6c 65 67 61 6c 2e 0a |e thus i|llegal..|
|000022d0| 0a 5c 69 74 65 6d 5b 5c | 68 62 6f 78 7b 5c 74 74 |.\item[\|hbox{\tt|
|000022e0| 20 49 4e 54 45 47 45 52 | 53 7d 5c 68 66 69 6c 6c | INTEGER|S}\hfill|
|000022f0| 5d 0a 44 65 63 6c 61 72 | 65 73 20 67 6c 6f 62 61 |].Declar|es globa|
|00002300| 6c 20 69 6e 74 65 67 65 | 72 20 76 61 72 69 61 62 |l intege|r variab|
|00002310| 6c 65 73 2e 0a 49 74 20 | 68 61 73 20 6f 6e 65 20 |les..It |has one |
|00002320| 61 72 67 75 6d 65 6e 74 | 2c 20 61 20 6c 69 73 74 |argument|, a list|
|00002330| 20 6f 66 20 76 61 72 69 | 61 62 6c 65 20 6e 61 6d | of vari|able nam|
|00002340| 65 73 2e 0a 54 68 65 72 | 65 20 61 72 65 20 74 77 |es..Ther|e are tw|
|00002350| 6f 20 73 75 63 68 20 61 | 75 74 6f 6d 61 74 69 63 |o such a|utomatic|
|00002360| 61 6c 6c 79 2d 64 65 63 | 6c 61 72 65 64 20 76 61 |ally-dec|lared va|
|00002370| 72 69 61 62 6c 65 73 2c | 0a 5c 68 62 6f 78 7b 5c |riables,|.\hbox{\|
|00002380| 74 74 20 65 6e 74 72 79 | 2e 6d 61 78 5c 24 7d 20 |tt entry|.max\$} |
|00002390| 61 6e 64 20 5c 68 62 6f | 78 7b 5c 74 74 20 67 6c |and \hbo|x{\tt gl|
|000023a0| 6f 62 61 6c 2e 6d 61 78 | 5c 24 7d 2c 0a 75 73 65 |obal.max|\$},.use|
|000023b0| 64 20 66 6f 72 20 6c 69 | 6d 69 74 69 6e 67 20 74 |d for li|miting t|
|000023c0| 68 65 20 6c 65 6e 67 74 | 68 73 20 6f 66 20 73 74 |he lengt|hs of st|
|000023d0| 72 69 6e 67 20 76 61 72 | 69 61 62 6c 65 73 2e 0a |ring var|iables..|
|000023e0| 59 6f 75 20 6d 61 79 20 | 68 61 76 65 20 61 6e 79 |You may |have any|
|000023f0| 20 6e 75 6d 62 65 72 20 | 6f 66 20 74 68 65 73 65 | number |of these|
|00002400| 20 63 6f 6d 6d 61 6e 64 | 73 2c 20 62 75 74 20 61 | command|s, but a|
|00002410| 20 76 61 72 69 61 62 6c | 65 27 73 20 64 65 63 6c | variabl|e's decl|
|00002420| 61 72 61 74 69 6f 6e 0a | 6d 75 73 74 20 70 72 65 |aration.|must pre|
|00002430| 63 65 64 65 20 69 74 73 | 20 75 73 65 2e 0a 0a 5c |cede its| use...\|
|00002440| 69 74 65 6d 5b 5c 68 62 | 6f 78 7b 5c 74 74 20 49 |item[\hb|ox{\tt I|
|00002450| 54 45 52 41 54 45 7d 5c | 68 66 69 6c 6c 5d 0a 45 |TERATE}\|hfill].E|
|00002460| 78 65 63 75 74 65 73 20 | 61 20 73 69 6e 67 6c 65 |xecutes |a single|
|00002470| 20 66 75 6e 63 74 69 6f | 6e 2c 20 6f 6e 63 65 0a | functio|n, once.|
|00002480| 66 6f 72 20 65 61 63 68 | 20 65 6e 74 72 79 20 69 |for each| entry i|
|00002490| 6e 20 74 68 65 20 6c 69 | 73 74 2c 20 69 6e 20 74 |n the li|st, in t|
|000024a0| 68 65 20 6c 69 73 74 27 | 73 20 63 75 72 72 65 6e |he list'|s curren|
|000024b0| 74 20 6f 72 64 65 72 0a | 28 69 6e 69 74 69 61 6c |t order.|(initial|
|000024c0| 6c 79 20 74 68 65 20 6c | 69 73 74 20 69 73 20 69 |ly the l|ist is i|
|000024d0| 6e 20 63 69 74 61 74 69 | 6f 6e 20 6f 72 64 65 72 |n citati|on order|
|000024e0| 2c 20 62 75 74 20 74 68 | 65 20 5c 68 62 6f 78 7b |, but th|e \hbox{|
|000024f0| 5c 74 74 20 53 4f 52 54 | 7d 0a 63 6f 6d 6d 61 6e |\tt SORT|}.comman|
|00002500| 64 20 6d 61 79 20 63 68 | 61 6e 67 65 20 74 68 69 |d may ch|ange thi|
|00002510| 73 29 2e 0a 49 74 20 68 | 61 73 20 6f 6e 65 20 61 |s)..It h|as one a|
|00002520| 72 67 75 6d 65 6e 74 2c | 20 74 68 65 20 66 75 6e |rgument,| the fun|
|00002530| 63 74 69 6f 6e 20 6e 61 | 6d 65 2e 0a 0a 5c 69 74 |ction na|me...\it|
|00002540| 65 6d 5b 5c 68 62 6f 78 | 7b 5c 74 74 20 4d 41 43 |em[\hbox|{\tt MAC|
|00002550| 52 4f 7d 5c 68 66 69 6c | 6c 5d 0a 44 65 66 69 6e |RO}\hfil|l].Defin|
|00002560| 65 73 20 61 20 73 74 72 | 69 6e 67 20 6d 61 63 72 |es a str|ing macr|
|00002570| 6f 2e 0a 49 74 20 68 61 | 73 20 74 77 6f 20 61 72 |o..It ha|s two ar|
|00002580| 67 75 6d 65 6e 74 73 3b | 20 74 68 65 20 66 69 72 |guments;| the fir|
|00002590| 73 74 20 69 73 20 74 68 | 65 20 6d 61 63 72 6f 27 |st is th|e macro'|
|000025a0| 73 20 6e 61 6d 65 2c 20 | 77 68 69 63 68 20 69 73 |s name, |which is|
|000025b0| 20 74 72 65 61 74 65 64 | 20 6c 69 6b 65 0a 61 6e | treated| like.an|
|000025c0| 79 20 6f 74 68 65 72 20 | 76 61 72 69 61 62 6c 65 |y other |variable|
|000025d0| 20 6f 72 20 66 75 6e 63 | 74 69 6f 6e 20 6e 61 6d | or func|tion nam|
|000025e0| 65 2c 0a 61 6e 64 20 74 | 68 65 20 73 65 63 6f 6e |e,.and t|he secon|
|000025f0| 64 20 69 73 20 69 74 73 | 20 64 65 66 69 6e 69 74 |d is its| definit|
|00002600| 69 6f 6e 2c 20 77 68 69 | 63 68 20 6d 75 73 74 20 |ion, whi|ch must |
|00002610| 62 65 20 64 6f 75 62 6c | 65 2d 71 75 6f 74 65 2d |be doubl|e-quote-|
|00002620| 64 65 6c 69 6d 69 74 65 | 64 2e 0a 59 6f 75 20 6d |delimite|d..You m|
|00002630| 75 73 74 20 68 61 76 65 | 20 6f 6e 65 20 66 6f 72 |ust have| one for|
|00002640| 20 65 61 63 68 20 74 68 | 72 65 65 2d 6c 65 74 74 | each th|ree-lett|
|00002650| 65 72 20 6d 6f 6e 74 68 | 20 61 62 62 72 65 76 69 |er month| abbrevi|
|00002660| 61 74 69 6f 6e 3b 0a 69 | 6e 20 61 64 64 69 74 69 |ation;.i|n additi|
|00002670| 6f 6e 2c 20 79 6f 75 20 | 73 68 6f 75 6c 64 20 68 |on, you |should h|
|00002680| 61 76 65 20 6f 6e 65 20 | 66 6f 72 20 63 6f 6d 6d |ave one |for comm|
|00002690| 6f 6e 20 6a 6f 75 72 6e | 61 6c 20 6e 61 6d 65 73 |on journ|al names|
|000026a0| 2e 0a 54 68 65 20 75 73 | 65 72 27 73 20 64 61 74 |..The us|er's dat|
|000026b0| 61 62 61 73 65 20 6d 61 | 79 20 6f 76 65 72 72 69 |abase ma|y overri|
|000026c0| 64 65 20 61 6e 79 20 64 | 65 66 69 6e 69 74 69 6f |de any d|efinitio|
|000026d0| 6e 20 79 6f 75 20 64 65 | 66 69 6e 65 20 75 73 69 |n you de|fine usi|
|000026e0| 6e 67 20 74 68 69 73 20 | 63 6f 6d 6d 61 6e 64 2e |ng this |command.|
|000026f0| 0a 49 66 20 79 6f 75 20 | 77 61 6e 74 20 74 6f 20 |.If you |want to |
|00002700| 64 65 66 69 6e 65 20 61 | 20 73 74 72 69 6e 67 20 |define a| string |
|00002710| 74 68 65 20 75 73 65 72 | 20 63 61 6e 27 74 20 74 |the user| can't t|
|00002720| 6f 75 63 68 2c 0a 75 73 | 65 20 74 68 65 20 5c 68 |ouch,.us|e the \h|
|00002730| 62 6f 78 7b 5c 74 74 20 | 46 55 4e 43 54 49 4f 4e |box{\tt |FUNCTION|
|00002740| 7d 20 63 6f 6d 6d 61 6e | 64 2c 20 77 68 69 63 68 |} comman|d, which|
|00002750| 20 68 61 73 20 61 20 63 | 6f 6d 70 61 74 69 62 6c | has a c|ompatibl|
|00002760| 65 20 73 79 6e 74 61 78 | 2e 0a 0a 5c 69 74 65 6d |e syntax|...\item|
|00002770| 5b 5c 68 62 6f 78 7b 5c | 74 74 20 52 45 41 44 7d |[\hbox{\|tt READ}|
|00002780| 5c 68 66 69 6c 6c 5d 0a | 44 72 65 64 67 65 73 20 |\hfill].|Dredges |
|00002790| 75 70 20 66 72 6f 6d 20 | 74 68 65 20 64 61 74 61 |up from |the data|
|000027a0| 62 61 73 65 20 66 69 6c | 65 0a 74 68 65 20 66 69 |base fil|e.the fi|
|000027b0| 65 6c 64 20 76 61 6c 75 | 65 73 20 66 6f 72 20 65 |eld valu|es for e|
|000027c0| 61 63 68 20 65 6e 74 72 | 79 20 69 6e 20 74 68 65 |ach entr|y in the|
|000027d0| 20 6c 69 73 74 2e 0a 49 | 74 20 68 61 73 20 6e 6f | list..I|t has no|
|000027e0| 20 61 72 67 75 6d 65 6e | 74 73 2e 0a 49 66 20 61 | argumen|ts..If a|
|000027f0| 20 64 61 74 61 62 61 73 | 65 20 65 6e 74 72 79 20 | databas|e entry |
|00002800| 64 6f 65 73 6e 27 74 20 | 68 61 76 65 20 61 20 76 |doesn't |have a v|
|00002810| 61 6c 75 65 20 66 6f 72 | 20 61 20 66 69 65 6c 64 |alue for| a field|
|00002820| 0a 28 61 6e 64 20 70 72 | 6f 62 61 62 6c 79 20 6e |.(and pr|obably n|
|00002830| 6f 20 64 61 74 61 62 61 | 73 65 20 65 6e 74 72 79 |o databa|se entry|
|00002840| 20 77 69 6c 6c 20 68 61 | 76 65 20 61 20 76 61 6c | will ha|ve a val|
|00002850| 75 65 20 66 6f 72 20 65 | 76 65 72 79 20 66 69 65 |ue for e|very fie|
|00002860| 6c 64 29 2c 0a 74 68 61 | 74 20 66 69 65 6c 64 20 |ld),.tha|t field |
|00002870| 76 61 72 69 61 62 6c 65 | 20 69 73 20 6d 61 72 6b |variable| is mark|
|00002880| 65 64 20 61 73 20 6d 69 | 73 73 69 6e 67 20 66 6f |ed as mi|ssing fo|
|00002890| 72 20 74 68 65 20 65 6e | 74 72 79 2e 0a 0a 5c 69 |r the en|try...\i|
|000028a0| 74 65 6d 5b 5c 68 62 6f | 78 7b 5c 74 74 20 52 45 |tem[\hbo|x{\tt RE|
|000028b0| 56 45 52 53 45 7d 5c 68 | 66 69 6c 6c 5d 0a 45 78 |VERSE}\h|fill].Ex|
|000028c0| 61 63 74 6c 79 20 74 68 | 65 20 73 61 6d 65 20 61 |actly th|e same a|
|000028d0| 73 20 74 68 65 0a 5c 68 | 62 6f 78 7b 5c 74 74 20 |s the.\h|box{\tt |
|000028e0| 49 54 45 52 41 54 45 7d | 20 63 6f 6d 6d 61 6e 64 |ITERATE}| command|
|000028f0| 20 65 78 63 65 70 74 20 | 74 68 61 74 20 69 74 20 | except |that it |
|00002900| 65 78 65 63 75 74 65 73 | 20 74 68 65 20 66 75 6e |executes| the fun|
|00002910| 63 74 69 6f 6e 0a 6f 6e | 20 74 68 65 20 65 6e 74 |ction.on| the ent|
|00002920| 72 79 20 6c 69 73 74 20 | 69 6e 20 72 65 76 65 72 |ry list |in rever|
|00002930| 73 65 20 6f 72 64 65 72 | 2e 0a 0a 5c 69 74 65 6d |se order|...\item|
|00002940| 5b 5c 68 62 6f 78 7b 5c | 74 74 20 53 4f 52 54 7d |[\hbox{\|tt SORT}|
|00002950| 5c 68 66 69 6c 6c 5d 0a | 53 6f 72 74 73 20 74 68 |\hfill].|Sorts th|
|00002960| 65 20 65 6e 74 72 79 20 | 6c 69 73 74 20 75 73 69 |e entry |list usi|
|00002970| 6e 67 0a 74 68 65 20 76 | 61 6c 75 65 73 20 6f 66 |ng.the v|alues of|
|00002980| 20 74 68 65 20 73 74 72 | 69 6e 67 20 65 6e 74 72 | the str|ing entr|
|00002990| 79 20 76 61 72 69 61 62 | 6c 65 20 5c 68 62 6f 78 |y variab|le \hbox|
|000029a0| 7b 5c 74 74 20 73 6f 72 | 74 2e 6b 65 79 5c 24 7d |{\tt sor|t.key\$}|
|000029b0| 2e 0a 49 74 20 68 61 73 | 20 6e 6f 20 61 72 67 75 |..It has| no argu|
|000029c0| 6d 65 6e 74 73 2e 0a 0a | 5c 69 74 65 6d 5b 5c 68 |ments...|\item[\h|
|000029d0| 62 6f 78 7b 5c 74 74 20 | 53 54 52 49 4e 47 53 7d |box{\tt |STRINGS}|
|000029e0| 5c 68 66 69 6c 6c 5d 0a | 44 65 63 6c 61 72 65 73 |\hfill].|Declares|
|000029f0| 20 67 6c 6f 62 61 6c 20 | 73 74 72 69 6e 67 20 76 | global |string v|
|00002a00| 61 72 69 61 62 6c 65 73 | 2e 0a 49 74 20 68 61 73 |ariables|..It has|
|00002a10| 20 6f 6e 65 20 61 72 67 | 75 6d 65 6e 74 2c 20 61 | one arg|ument, a|
|00002a20| 20 6c 69 73 74 20 6f 66 | 20 76 61 72 69 61 62 6c | list of| variabl|
|00002a30| 65 20 6e 61 6d 65 73 2e | 0a 59 6f 75 20 6d 61 79 |e names.|.You may|
|00002a40| 20 68 61 76 65 20 61 6e | 79 20 6e 75 6d 62 65 72 | have an|y number|
|00002a50| 20 6f 66 20 74 68 65 73 | 65 20 63 6f 6d 6d 61 6e | of thes|e comman|
|00002a60| 64 73 2c 20 62 75 74 20 | 61 20 76 61 72 69 61 62 |ds, but |a variab|
|00002a70| 6c 65 27 73 20 64 65 63 | 6c 61 72 61 74 69 6f 6e |le's dec|laration|
|00002a80| 0a 6d 75 73 74 20 70 72 | 65 63 65 64 65 20 69 74 |.must pr|ecede it|
|00002a90| 73 20 75 73 65 2e 0a 5c | 65 6e 64 7b 64 65 73 63 |s use..\|end{desc|
|00002aa0| 72 69 70 74 69 6f 6e 7d | 0a 0a 0a 5c 73 75 62 73 |ription}|...\subs|
|00002ab0| 65 63 74 69 6f 6e 7b 54 | 68 65 20 62 75 69 6c 74 |ection{T|he built|
|00002ac0| 2d 69 6e 20 66 75 6e 63 | 74 69 6f 6e 73 7d 0a 5c |-in func|tions}.\|
|00002ad0| 6c 61 62 65 6c 7b 62 75 | 69 6c 74 2d 69 6e 2d 66 |label{bu|ilt-in-f|
|00002ae0| 6e 73 7d 0a 0a 42 65 66 | 6f 72 65 20 77 65 20 67 |ns}..Bef|ore we g|
|00002af0| 65 74 20 74 6f 20 74 68 | 65 20 62 75 69 6c 74 2d |et to th|e built-|
|00002b00| 69 6e 20 66 75 6e 63 74 | 69 6f 6e 73 2c 0a 61 20 |in funct|ions,.a |
|00002b10| 66 65 77 20 77 6f 72 64 | 73 20 61 62 6f 75 74 20 |few word|s about |
|00002b20| 73 6f 6d 65 20 6f 74 68 | 65 72 20 62 75 69 6c 74 |some oth|er built|
|00002b30| 2d 69 6e 20 6f 62 6a 65 | 63 74 73 2e 0a 54 68 65 |-in obje|cts..The|
|00002b40| 72 65 20 69 73 20 6f 6e | 65 20 62 75 69 6c 74 2d |re is on|e built-|
|00002b50| 69 6e 20 73 74 72 69 6e | 67 20 65 6e 74 72 79 20 |in strin|g entry |
|00002b60| 76 61 72 69 61 62 6c 65 | 2c 20 5c 68 62 6f 78 7b |variable|, \hbox{|
|00002b70| 5c 74 74 20 73 6f 72 74 | 2e 6b 65 79 5c 24 7d 2c |\tt sort|.key\$},|
|00002b80| 0a 77 68 69 63 68 20 74 | 68 65 20 73 74 79 6c 65 |.which t|he style|
|00002b90| 20 70 72 6f 67 72 61 6d | 20 6d 75 73 74 20 73 65 | program| must se|
|00002ba0| 74 20 69 66 20 74 68 65 | 20 73 74 79 6c 65 20 69 |t if the| style i|
|00002bb0| 73 20 74 6f 20 64 6f 20 | 73 6f 72 74 69 6e 67 2e |s to do |sorting.|
|00002bc0| 0a 54 68 65 72 65 20 69 | 73 20 6f 6e 65 20 62 75 |.There i|s one bu|
|00002bd0| 69 6c 74 2d 69 6e 20 66 | 69 65 6c 64 2c 20 5c 68 |ilt-in f|ield, \h|
|00002be0| 62 6f 78 7b 5c 74 74 20 | 63 72 6f 73 73 72 65 66 |box{\tt |crossref|
|00002bf0| 7d 2c 0a 75 73 65 64 20 | 66 6f 72 20 74 68 65 20 |},.used |for the |
|00002c00| 63 72 6f 73 73 20 72 65 | 66 65 72 65 6e 63 69 6e |cross re|ferencin|
|00002c10| 67 20 66 65 61 74 75 72 | 65 0a 64 65 73 63 72 69 |g featur|e.descri|
|00002c20| 62 65 64 20 69 6e 20 53 | 65 63 74 69 6f 6e 7e 34 |bed in S|ection~4|
|00002c30| 2e 0a 41 6e 64 20 74 68 | 65 72 65 20 61 72 65 20 |..And th|ere are |
|00002c40| 74 77 6f 20 62 75 69 6c | 74 2d 69 6e 20 69 6e 74 |two buil|t-in int|
|00002c50| 65 67 65 72 20 67 6c 6f | 62 61 6c 20 76 61 72 69 |eger glo|bal vari|
|00002c60| 61 62 6c 65 73 2c 0a 5c | 68 62 6f 78 7b 5c 74 74 |ables,.\|hbox{\tt|
|00002c70| 20 65 6e 74 72 79 2e 6d | 61 78 5c 24 7d 20 61 6e | entry.m|ax\$} an|
|00002c80| 64 20 5c 68 62 6f 78 7b | 5c 74 74 20 67 6c 6f 62 |d \hbox{|\tt glob|
|00002c90| 61 6c 2e 6d 61 78 5c 24 | 7d 2c 0a 77 68 69 63 68 |al.max\$|},.which|
|00002ca0| 20 61 72 65 20 73 65 74 | 20 62 79 20 64 65 66 61 | are set| by defa|
|00002cb0| 75 6c 74 20 74 6f 20 73 | 6f 6d 65 20 69 6e 74 65 |ult to s|ome inte|
|00002cc0| 72 6e 61 6c 20 5c 42 69 | 62 54 65 58 5c 20 63 6f |rnal \Bi|bTeX\ co|
|00002cd0| 6e 73 74 61 6e 74 73 3b | 0a 79 6f 75 20 73 68 6f |nstants;|.you sho|
|00002ce0| 75 6c 64 20 74 72 75 6e | 63 61 74 65 20 73 74 72 |uld trun|cate str|
|00002cf0| 69 6e 67 73 20 74 6f 20 | 74 68 65 73 65 20 6c 65 |ings to |these le|
|00002d00| 6e 67 74 68 73 20 62 65 | 66 6f 72 65 0a 79 6f 75 |ngths be|fore.you|
|00002d10| 20 61 73 73 69 67 6e 20 | 74 6f 20 73 74 72 69 6e | assign |to strin|
|00002d20| 67 20 76 61 72 69 61 62 | 6c 65 73 2c 0a 73 6f 20 |g variab|les,.so |
|00002d30| 61 73 20 74 6f 20 6e 6f | 74 20 67 65 6e 65 72 61 |as to no|t genera|
|00002d40| 74 65 20 61 6e 79 20 5c | 42 69 62 54 65 58 5c 20 |te any \|BibTeX\ |
|00002d50| 77 61 72 6e 69 6e 67 20 | 6d 65 73 73 61 67 65 73 |warning |messages|
|00002d60| 2e 0a 0a 54 68 65 72 65 | 20 61 72 65 20 63 75 72 |...There| are cur|
|00002d70| 72 65 6e 74 6c 79 20 33 | 37 20 62 75 69 6c 74 2d |rently 3|7 built-|
|00002d80| 69 6e 20 66 75 6e 63 74 | 69 6f 6e 73 2e 0a 45 76 |in funct|ions..Ev|
|00002d90| 65 72 79 20 62 75 69 6c | 74 2d 69 6e 20 66 75 6e |ery buil|t-in fun|
|00002da0| 63 74 69 6f 6e 20 77 69 | 74 68 20 61 20 6c 65 74 |ction wi|th a let|
|00002db0| 74 65 72 20 69 6e 20 69 | 74 73 20 6e 61 6d 65 20 |ter in i|ts name |
|00002dc0| 65 6e 64 73 20 77 69 74 | 68 20 61 20 60 7b 5c 74 |ends wit|h a `{\t|
|00002dd0| 74 20 5c 24 7d 27 24 5c | 21 24 2e 0a 49 6e 20 77 |t \$}'$\|!$..In w|
|00002de0| 68 61 74 20 66 6f 6c 6c | 6f 77 73 2c 20 60 60 66 |hat foll|ows, ``f|
|00002df0| 69 72 73 74 27 27 24 5c | 21 24 2c 20 60 60 73 65 |irst''$\|!$, ``se|
|00002e00| 63 6f 6e 64 27 27 24 5c | 21 24 2c 0a 61 6e 64 20 |cond''$\|!$,.and |
|00002e10| 73 6f 20 6f 6e 20 72 65 | 66 65 72 20 74 6f 20 74 |so on re|fer to t|
|00002e20| 68 65 20 6f 72 64 65 72 | 20 70 6f 70 70 65 64 2e |he order| popped.|
|00002e30| 0a 41 20 60 60 6c 69 74 | 65 72 61 6c 27 27 20 69 |.A ``lit|eral'' i|
|00002e40| 73 20 61 6e 20 65 6c 65 | 6d 65 6e 74 20 6f 6e 20 |s an ele|ment on |
|00002e50| 74 68 65 20 73 74 61 63 | 6b 2c 20 61 6e 64 20 69 |the stac|k, and i|
|00002e60| 74 20 77 69 6c 6c 20 62 | 65 20 65 69 74 68 65 72 |t will b|e either|
|00002e70| 0a 61 6e 20 69 6e 74 65 | 67 65 72 20 76 61 6c 75 |.an inte|ger valu|
|00002e80| 65 2c 20 61 20 73 74 72 | 69 6e 67 20 76 61 6c 75 |e, a str|ing valu|
|00002e90| 65 2c 20 61 20 76 61 72 | 69 61 62 6c 65 20 6f 72 |e, a var|iable or|
|00002ea0| 20 66 75 6e 63 74 69 6f | 6e 20 6e 61 6d 65 2c 0a | functio|n name,.|
|00002eb0| 6f 72 20 61 20 73 70 65 | 63 69 61 6c 20 76 61 6c |or a spe|cial val|
|00002ec0| 75 65 20 64 65 6e 6f 74 | 69 6e 67 20 61 20 6d 69 |ue denot|ing a mi|
|00002ed0| 73 73 69 6e 67 20 66 69 | 65 6c 64 2e 0a 49 66 20 |ssing fi|eld..If |
|00002ee0| 61 6e 79 20 70 6f 70 70 | 65 64 20 6c 69 74 65 72 |any popp|ed liter|
|00002ef0| 61 6c 20 68 61 73 20 61 | 6e 20 69 6e 63 6f 72 72 |al has a|n incorr|
|00002f00| 65 63 74 20 74 79 70 65 | 2c 20 5c 42 69 62 54 65 |ect type|, \BibTe|
|00002f10| 58 5c 20 63 6f 6d 70 6c | 61 69 6e 73 20 61 6e 64 |X\ compl|ains and|
|00002f20| 20 70 75 73 68 65 73 0a | 74 68 65 20 69 6e 74 65 | pushes.|the inte|
|00002f30| 67 65 72 20 30 20 6f 72 | 20 74 68 65 20 6e 75 6c |ger 0 or| the nul|
|00002f40| 6c 20 73 74 72 69 6e 67 | 2c 20 64 65 70 65 6e 64 |l string|, depend|
|00002f50| 69 6e 67 20 6f 6e 20 77 | 68 65 74 68 65 72 20 74 |ing on w|hether t|
|00002f60| 68 65 20 66 75 6e 63 74 | 69 6f 6e 0a 77 61 73 20 |he funct|ion.was |
|00002f70| 73 75 70 70 6f 73 65 64 | 20 74 6f 20 70 75 73 68 |supposed| to push|
|00002f80| 20 61 6e 20 69 6e 74 65 | 67 65 72 20 6f 72 20 73 | an inte|ger or s|
|00002f90| 74 72 69 6e 67 2e 0a 5c | 62 65 67 69 6e 7b 64 65 |tring..\|begin{de|
|00002fa0| 73 63 72 69 70 74 69 6f | 6e 7d 0a 0a 5c 69 74 65 |scriptio|n}..\ite|
|00002fb0| 6d 5b 5c 68 62 6f 78 7b | 5c 74 74 20 3e 7d 5c 68 |m[\hbox{|\tt >}\h|
|00002fc0| 66 69 6c 6c 5d 0a 50 6f | 70 73 20 74 68 65 20 74 |fill].Po|ps the t|
|00002fd0| 6f 70 20 74 77 6f 20 28 | 69 6e 74 65 67 65 72 29 |op two (|integer)|
|00002fe0| 20 6c 69 74 65 72 61 6c | 73 2c 0a 63 6f 6d 70 61 | literal|s,.compa|
|00002ff0| 72 65 73 20 74 68 65 6d | 2c 20 61 6e 64 20 70 75 |res them|, and pu|
|00003000| 73 68 65 73 20 74 68 65 | 20 69 6e 74 65 67 65 72 |shes the| integer|
|00003010| 20 31 20 69 66 20 74 68 | 65 20 73 65 63 6f 6e 64 | 1 if th|e second|
|00003020| 20 69 73 20 67 72 65 61 | 74 65 72 20 74 68 61 6e | is grea|ter than|
|00003030| 0a 74 68 65 20 66 69 72 | 73 74 2c 20 30 20 6f 74 |.the fir|st, 0 ot|
|00003040| 68 65 72 77 69 73 65 2e | 0a 0a 5c 69 74 65 6d 5b |herwise.|..\item[|
|00003050| 5c 68 62 6f 78 7b 5c 74 | 74 20 3c 7d 5c 68 66 69 |\hbox{\t|t <}\hfi|
|00003060| 6c 6c 5d 0a 41 6e 61 6c | 6f 67 6f 75 73 2e 0a 0a |ll].Anal|ogous...|
|00003070| 5c 69 74 65 6d 5b 5c 68 | 62 6f 78 7b 5c 74 74 20 |\item[\h|box{\tt |
|00003080| 3d 7d 5c 68 66 69 6c 6c | 5d 0a 50 6f 70 73 20 74 |=}\hfill|].Pops t|
|00003090| 68 65 20 74 6f 70 20 74 | 77 6f 20 28 62 6f 74 68 |he top t|wo (both|
|000030a0| 20 69 6e 74 65 67 65 72 | 20 6f 72 20 62 6f 74 68 | integer| or both|
|000030b0| 20 73 74 72 69 6e 67 29 | 20 6c 69 74 65 72 61 6c | string)| literal|
|000030c0| 73 2c 0a 63 6f 6d 70 61 | 72 65 73 20 74 68 65 6d |s,.compa|res them|
|000030d0| 2c 0a 61 6e 64 20 70 75 | 73 68 65 73 20 74 68 65 |,.and pu|shes the|
|000030e0| 20 69 6e 74 65 67 65 72 | 20 31 20 69 66 20 74 68 | integer| 1 if th|
|000030f0| 65 79 27 72 65 20 65 71 | 75 61 6c 2c 20 30 20 6f |ey're eq|ual, 0 o|
|00003100| 74 68 65 72 77 69 73 65 | 2e 0a 0a 5c 69 74 65 6d |therwise|...\item|
|00003110| 5b 5c 68 62 6f 78 7b 5c | 74 74 20 2b 7d 5c 68 66 |[\hbox{\|tt +}\hf|
|00003120| 69 6c 6c 5d 0a 50 6f 70 | 73 20 74 68 65 20 74 6f |ill].Pop|s the to|
|00003130| 70 20 74 77 6f 20 28 69 | 6e 74 65 67 65 72 29 20 |p two (i|nteger) |
|00003140| 6c 69 74 65 72 61 6c 73 | 20 61 6e 64 20 70 75 73 |literals| and pus|
|00003150| 68 65 73 20 74 68 65 69 | 72 20 73 75 6d 2e 0a 0a |hes thei|r sum...|
|00003160| 5c 69 74 65 6d 5b 5c 68 | 62 6f 78 7b 5c 74 74 20 |\item[\h|box{\tt |
|00003170| 2d 7d 5c 68 66 69 6c 6c | 5d 0a 50 6f 70 73 20 74 |-}\hfill|].Pops t|
|00003180| 68 65 20 74 6f 70 20 74 | 77 6f 20 28 69 6e 74 65 |he top t|wo (inte|
|00003190| 67 65 72 29 20 6c 69 74 | 65 72 61 6c 73 20 61 6e |ger) lit|erals an|
|000031a0| 64 20 70 75 73 68 65 73 | 20 74 68 65 69 72 20 64 |d pushes| their d|
|000031b0| 69 66 66 65 72 65 6e 63 | 65 0a 28 74 68 65 20 66 |ifferenc|e.(the f|
|000031c0| 69 72 73 74 20 73 75 62 | 74 72 61 63 74 65 64 20 |irst sub|tracted |
|000031d0| 66 72 6f 6d 20 74 68 65 | 20 73 65 63 6f 6e 64 29 |from the| second)|
|000031e0| 2e 0a 0a 5c 69 74 65 6d | 5b 5c 68 62 6f 78 7b 5c |...\item|[\hbox{\|
|000031f0| 74 74 20 2a 7d 5c 68 66 | 69 6c 6c 5d 0a 50 6f 70 |tt *}\hf|ill].Pop|
|00003200| 73 20 74 68 65 20 74 6f | 70 20 74 77 6f 20 28 73 |s the to|p two (s|
|00003210| 74 72 69 6e 67 29 20 6c | 69 74 65 72 61 6c 73 2c |tring) l|iterals,|
|00003220| 0a 63 6f 6e 63 61 74 65 | 6e 61 74 65 73 20 74 68 |.concate|nates th|
|00003230| 65 6d 20 28 69 6e 20 72 | 65 76 65 72 73 65 20 6f |em (in r|everse o|
|00003240| 72 64 65 72 2c 20 74 68 | 61 74 20 69 73 2c 20 74 |rder, th|at is, t|
|00003250| 68 65 20 6f 72 64 65 72 | 20 69 6e 20 77 68 69 63 |he order| in whic|
|00003260| 68 0a 70 75 73 68 65 64 | 29 2c 20 61 6e 64 20 70 |h.pushed|), and p|
|00003270| 75 73 68 65 73 20 74 68 | 65 20 72 65 73 75 6c 74 |ushes th|e result|
|00003280| 69 6e 67 20 73 74 72 69 | 6e 67 2e 0a 0a 5c 69 74 |ing stri|ng...\it|
|00003290| 65 6d 5b 5c 68 62 6f 78 | 7b 5c 74 74 20 3a 3d 7d |em[\hbox|{\tt :=}|
|000032a0| 5c 68 66 69 6c 6c 5d 0a | 50 6f 70 73 20 74 68 65 |\hfill].|Pops the|
|000032b0| 20 74 6f 70 20 74 77 6f | 20 6c 69 74 65 72 61 6c | top two| literal|
|000032c0| 73 20 61 6e 64 20 61 73 | 73 69 67 6e 73 0a 74 6f |s and as|signs.to|
|000032d0| 20 74 68 65 20 66 69 72 | 73 74 20 28 77 68 69 63 | the fir|st (whic|
|000032e0| 68 20 6d 75 73 74 20 62 | 65 20 61 20 67 6c 6f 62 |h must b|e a glob|
|000032f0| 61 6c 20 6f 72 20 65 6e | 74 72 79 20 76 61 72 69 |al or en|try vari|
|00003300| 61 62 6c 65 29 0a 74 68 | 65 20 76 61 6c 75 65 20 |able).th|e value |
|00003310| 6f 66 20 74 68 65 20 73 | 65 63 6f 6e 64 2e 0a 0a |of the s|econd...|
|00003320| 5c 69 74 65 6d 5b 5c 68 | 62 6f 78 7b 5c 74 74 20 |\item[\h|box{\tt |
|00003330| 61 64 64 2e 70 65 72 69 | 6f 64 5c 24 7d 5c 68 66 |add.peri|od\$}\hf|
|00003340| 69 6c 6c 5d 0a 50 6f 70 | 73 20 74 68 65 20 74 6f |ill].Pop|s the to|
|00003350| 70 20 28 73 74 72 69 6e | 67 29 20 6c 69 74 65 72 |p (strin|g) liter|
|00003360| 61 6c 2c 0a 61 64 64 73 | 20 61 20 60 7b 5c 74 74 |al,.adds| a `{\tt|
|00003370| 20 2e 7d 27 20 74 6f 20 | 69 74 20 69 66 20 74 68 | .}' to |it if th|
|00003380| 65 20 6c 61 73 74 20 6e | 6f 6e 60 7b 5c 74 74 20 |e last n|on`{\tt |
|00003390| 5c 7d 7d 27 20 63 68 61 | 72 61 63 74 65 72 0a 69 |\}}' cha|racter.i|
|000033a0| 73 6e 27 74 20 61 20 60 | 7b 5c 74 74 20 2e 7d 27 |sn't a `|{\tt .}'|
|000033b0| 24 5c 21 24 2c 20 60 7b | 5c 74 74 20 3f 7d 27 2c |$\!$, `{|\tt ?}',|
|000033c0| 20 6f 72 20 60 7b 5c 74 | 74 20 21 7d 27 24 5c 21 | or `{\t|t !}'$\!|
|000033d0| 24 2c 0a 61 6e 64 20 70 | 75 73 68 65 73 20 74 68 |$,.and p|ushes th|
|000033e0| 69 73 20 72 65 73 75 6c | 74 69 6e 67 20 73 74 72 |is resul|ting str|
|000033f0| 69 6e 67 2e 0a 0a 5c 69 | 74 65 6d 5b 5c 68 62 6f |ing...\i|tem[\hbo|
|00003400| 78 7b 5c 74 74 20 63 61 | 6c 6c 2e 74 79 70 65 5c |x{\tt ca|ll.type\|
|00003410| 24 7d 5c 68 66 69 6c 6c | 5d 0a 45 78 65 63 75 74 |$}\hfill|].Execut|
|00003420| 65 73 20 74 68 65 20 66 | 75 6e 63 74 69 6f 6e 20 |es the f|unction |
|00003430| 77 68 6f 73 65 20 6e 61 | 6d 65 20 69 73 20 74 68 |whose na|me is th|
|00003440| 65 20 65 6e 74 72 79 20 | 74 79 70 65 20 6f 66 20 |e entry |type of |
|00003450| 61 6e 20 65 6e 74 72 79 | 2e 0a 46 6f 72 20 65 78 |an entry|..For ex|
|00003460| 61 6d 70 6c 65 20 69 66 | 20 61 6e 20 65 6e 74 72 |ample if| an entr|
|00003470| 79 20 69 73 20 6f 66 20 | 74 79 70 65 20 7b 5c 74 |y is of |type {\t|
|00003480| 74 20 62 6f 6f 6b 7d 2c | 20 74 68 69 73 20 66 75 |t book},| this fu|
|00003490| 6e 63 74 69 6f 6e 20 65 | 78 65 63 75 74 65 73 0a |nction e|xecutes.|
|000034a0| 74 68 65 20 7b 5c 74 74 | 20 62 6f 6f 6b 7d 20 66 |the {\tt| book} f|
|000034b0| 75 6e 63 74 69 6f 6e 2e | 0a 57 68 65 6e 20 67 69 |unction.|.When gi|
|000034c0| 76 65 6e 20 61 73 20 61 | 6e 20 61 72 67 75 6d 65 |ven as a|n argume|
|000034d0| 6e 74 20 74 6f 20 74 68 | 65 20 5c 68 62 6f 78 7b |nt to th|e \hbox{|
|000034e0| 5c 74 74 20 49 54 45 52 | 41 54 45 7d 20 63 6f 6d |\tt ITER|ATE} com|
|000034f0| 6d 61 6e 64 2c 0a 5c 68 | 62 6f 78 7b 5c 74 74 20 |mand,.\h|box{\tt |
|00003500| 63 61 6c 6c 2e 74 79 70 | 65 5c 24 7d 20 61 63 74 |call.typ|e\$} act|
|00003510| 75 61 6c 6c 79 20 70 72 | 6f 64 75 63 65 73 20 74 |ually pr|oduces t|
|00003520| 68 65 20 6f 75 74 70 75 | 74 20 66 6f 72 20 74 68 |he outpu|t for th|
|00003530| 65 20 65 6e 74 72 69 65 | 73 2e 0a 46 6f 72 20 61 |e entrie|s..For a|
|00003540| 6e 20 65 6e 74 72 79 20 | 77 69 74 68 20 61 6e 20 |n entry |with an |
|00003550| 75 6e 6b 6e 6f 77 6e 20 | 74 79 70 65 2c 0a 69 74 |unknown |type,.it|
|00003560| 20 65 78 65 63 75 74 65 | 73 20 74 68 65 20 66 75 | execute|s the fu|
|00003570| 6e 63 74 69 6f 6e 20 5c | 68 62 6f 78 7b 5c 74 74 |nction \|hbox{\tt|
|00003580| 20 64 65 66 61 75 6c 74 | 2e 74 79 70 65 7d 2e 0a | default|.type}..|
|00003590| 54 68 75 73 20 79 6f 75 | 20 73 68 6f 75 6c 64 20 |Thus you| should |
|000035a0| 64 65 66 69 6e 65 20 28 | 62 65 66 6f 72 65 20 74 |define (|before t|
|000035b0| 68 65 20 5c 68 62 6f 78 | 7b 5c 74 74 20 52 45 41 |he \hbox|{\tt REA|
|000035c0| 44 7d 20 63 6f 6d 6d 61 | 6e 64 29 20 6f 6e 65 20 |D} comma|nd) one |
|000035d0| 66 75 6e 63 74 69 6f 6e | 0a 66 6f 72 20 65 61 63 |function|.for eac|
|000035e0| 68 20 73 74 61 6e 64 61 | 72 64 20 65 6e 74 72 79 |h standa|rd entry|
|000035f0| 20 74 79 70 65 20 61 73 | 20 77 65 6c 6c 20 61 73 | type as| well as|
|00003600| 20 61 20 5c 68 62 6f 78 | 7b 5c 74 74 20 64 65 66 | a \hbox|{\tt def|
|00003610| 61 75 6c 74 2e 74 79 70 | 65 7d 20 66 75 6e 63 74 |ault.typ|e} funct|
|00003620| 69 6f 6e 2e 0a 0a 5c 69 | 74 65 6d 5b 5c 68 62 6f |ion...\i|tem[\hbo|
|00003630| 78 7b 5c 74 74 20 63 68 | 61 6e 67 65 2e 63 61 73 |x{\tt ch|ange.cas|
|00003640| 65 5c 24 7d 5c 68 66 69 | 6c 6c 5d 0a 50 6f 70 73 |e\$}\hfi|ll].Pops|
|00003650| 20 74 68 65 20 74 6f 70 | 20 74 77 6f 20 28 73 74 | the top| two (st|
|00003660| 72 69 6e 67 29 20 6c 69 | 74 65 72 61 6c 73 3b 0a |ring) li|terals;.|
|00003670| 69 74 20 63 68 61 6e 67 | 65 73 20 74 68 65 20 63 |it chang|es the c|
|00003680| 61 73 65 20 6f 66 20 74 | 68 65 20 73 65 63 6f 6e |ase of t|he secon|
|00003690| 64 20 61 63 63 6f 72 64 | 69 6e 67 20 74 6f 20 74 |d accord|ing to t|
|000036a0| 68 65 0a 73 70 65 63 69 | 66 69 63 61 74 69 6f 6e |he.speci|fication|
|000036b0| 73 20 6f 66 20 74 68 65 | 20 66 69 72 73 74 2c 20 |s of the| first, |
|000036c0| 61 73 20 66 6f 6c 6c 6f | 77 73 2e 20 20 28 4e 6f |as follo|ws. (No|
|000036d0| 74 65 3a 20 54 68 65 20 | 77 6f 72 64 20 60 6c 65 |te: The |word `le|
|000036e0| 74 74 65 72 73 27 20 69 | 6e 0a 74 68 65 20 6e 65 |tters' i|n.the ne|
|000036f0| 78 74 20 73 65 6e 74 65 | 6e 63 65 20 72 65 66 65 |xt sente|nce refe|
|00003700| 72 73 20 6f 6e 6c 79 20 | 74 6f 20 74 68 6f 73 65 |rs only |to those|
|00003710| 20 61 74 20 62 72 61 63 | 65 2d 6c 65 76 65 6c 7e | at brac|e-level~|
|00003720| 30 2c 20 74 68 65 20 74 | 6f 70 2d 6d 6f 73 74 0a |0, the t|op-most.|
|00003730| 62 72 61 63 65 20 6c 65 | 76 65 6c 3b 20 6e 6f 20 |brace le|vel; no |
|00003740| 6f 74 68 65 72 20 63 68 | 61 72 61 63 74 65 72 73 |other ch|aracters|
|00003750| 20 61 72 65 20 63 68 61 | 6e 67 65 64 2c 20 65 78 | are cha|nged, ex|
|00003760| 63 65 70 74 20 70 65 72 | 68 61 70 73 20 66 6f 72 |cept per|haps for|
|00003770| 0a 60 60 73 70 65 63 69 | 61 6c 20 63 68 61 72 61 |.``speci|al chara|
|00003780| 63 74 65 72 73 27 27 24 | 5c 21 24 2c 20 64 65 73 |cters''$|\!$, des|
|00003790| 63 72 69 62 65 64 20 69 | 6e 20 53 65 63 74 69 6f |cribed i|n Sectio|
|000037a0| 6e 7e 34 2e 29 0a 49 66 | 20 74 68 65 20 66 69 72 |n~4.).If| the fir|
|000037b0| 73 74 20 6c 69 74 65 72 | 61 6c 20 69 73 20 74 68 |st liter|al is th|
|000037c0| 65 0a 73 74 72 69 6e 67 | 7e 60 7b 5c 74 74 20 74 |e.string|~`{\tt t|
|000037d0| 7d 27 24 5c 21 24 2c 20 | 69 74 20 63 6f 6e 76 65 |}'$\!$, |it conve|
|000037e0| 72 74 73 20 74 6f 20 6c | 6f 77 65 72 20 63 61 73 |rts to l|ower cas|
|000037f0| 65 20 61 6c 6c 20 6c 65 | 74 74 65 72 73 20 65 78 |e all le|tters ex|
|00003800| 63 65 70 74 20 74 68 65 | 20 76 65 72 79 0a 66 69 |cept the| very.fi|
|00003810| 72 73 74 20 63 68 61 72 | 61 63 74 65 72 20 69 6e |rst char|acter in|
|00003820| 20 74 68 65 20 73 74 72 | 69 6e 67 2c 20 77 68 69 | the str|ing, whi|
|00003830| 63 68 20 69 74 20 6c 65 | 61 76 65 73 20 61 6c 6f |ch it le|aves alo|
|00003840| 6e 65 2c 20 61 6e 64 20 | 65 78 63 65 70 74 20 74 |ne, and |except t|
|00003850| 68 65 0a 66 69 72 73 74 | 20 63 68 61 72 61 63 74 |he.first| charact|
|00003860| 65 72 20 66 6f 6c 6c 6f | 77 69 6e 67 20 61 6e 79 |er follo|wing any|
|00003870| 20 63 6f 6c 6f 6e 20 61 | 6e 64 20 74 68 65 6e 20 | colon a|nd then |
|00003880| 6e 6f 6e 6e 75 6c 6c 20 | 77 68 69 74 65 20 73 70 |nonnull |white sp|
|00003890| 61 63 65 2c 0a 77 68 69 | 63 68 20 69 74 20 61 6c |ace,.whi|ch it al|
|000038a0| 73 6f 20 6c 65 61 76 65 | 73 20 61 6c 6f 6e 65 3b |so leave|s alone;|
|000038b0| 20 69 66 20 69 74 27 73 | 20 74 68 65 20 73 74 72 | if it's| the str|
|000038c0| 69 6e 67 7e 60 7b 5c 74 | 74 20 6c 7d 27 24 5c 21 |ing~`{\t|t l}'$\!|
|000038d0| 24 2c 20 69 74 20 63 6f | 6e 76 65 72 74 73 20 61 |$, it co|nverts a|
|000038e0| 6c 6c 0a 6c 65 74 74 65 | 72 73 20 74 6f 20 6c 6f |ll.lette|rs to lo|
|000038f0| 77 65 72 20 63 61 73 65 | 3b 20 61 6e 64 20 69 66 |wer case|; and if|
|00003900| 20 69 74 27 73 20 74 68 | 65 20 73 74 72 69 6e 67 | it's th|e string|
|00003910| 7e 60 7b 5c 74 74 20 75 | 7d 27 24 5c 21 24 2c 20 |~`{\tt u|}'$\!$, |
|00003920| 69 74 20 63 6f 6e 76 65 | 72 74 73 20 61 6c 6c 0a |it conve|rts all.|
|00003930| 6c 65 74 74 65 72 73 20 | 74 6f 20 75 70 70 65 72 |letters |to upper|
|00003940| 20 63 61 73 65 2e 0a 49 | 74 20 74 68 65 6e 20 70 | case..I|t then p|
|00003950| 75 73 68 65 73 20 74 68 | 69 73 20 72 65 73 75 6c |ushes th|is resul|
|00003960| 74 69 6e 67 20 73 74 72 | 69 6e 67 2e 20 20 49 66 |ting str|ing. If|
|00003970| 20 65 69 74 68 65 72 0a | 74 79 70 65 20 69 73 20 | either.|type is |
|00003980| 69 6e 63 6f 72 72 65 63 | 74 2c 20 69 74 20 63 6f |incorrec|t, it co|
|00003990| 6d 70 6c 61 69 6e 73 20 | 61 6e 64 20 70 75 73 68 |mplains |and push|
|000039a0| 65 73 20 74 68 65 20 6e | 75 6c 6c 20 73 74 72 69 |es the n|ull stri|
|000039b0| 6e 67 3b 20 68 6f 77 65 | 76 65 72 2c 0a 69 66 20 |ng; howe|ver,.if |
|000039c0| 62 6f 74 68 20 74 79 70 | 65 73 20 61 72 65 20 63 |both typ|es are c|
|000039d0| 6f 72 72 65 63 74 20 62 | 75 74 20 74 68 65 20 73 |orrect b|ut the s|
|000039e0| 70 65 63 69 66 69 63 61 | 74 69 6f 6e 20 73 74 72 |pecifica|tion str|
|000039f0| 69 6e 67 20 28 69 2e 65 | 2e 2c 20 74 68 65 0a 66 |ing (i.e|., the.f|
|00003a00| 69 72 73 74 20 73 74 72 | 69 6e 67 29 20 69 73 6e |irst str|ing) isn|
|00003a10| 27 74 20 6f 6e 65 20 6f | 66 20 74 68 65 20 6c 65 |'t one o|f the le|
|00003a20| 67 61 6c 20 6f 6e 65 73 | 2c 20 69 74 20 6d 65 72 |gal ones|, it mer|
|00003a30| 65 6c 79 20 70 75 73 68 | 65 73 20 74 68 65 20 73 |ely push|es the s|
|00003a40| 65 63 6f 6e 64 0a 62 61 | 63 6b 20 6f 6e 74 6f 20 |econd.ba|ck onto |
|00003a50| 74 68 65 20 73 74 61 63 | 6b 2c 20 61 66 74 65 72 |the stac|k, after|
|00003a60| 20 63 6f 6d 70 6c 61 69 | 6e 69 6e 67 2e 20 20 28 | complai|ning. (|
|00003a70| 41 6e 6f 74 68 65 72 20 | 6e 6f 74 65 3a 20 49 74 |Another |note: It|
|00003a80| 20 69 67 6e 6f 72 65 73 | 0a 63 61 73 65 20 64 69 | ignores|.case di|
|00003a90| 66 66 65 72 65 6e 63 65 | 73 20 69 6e 20 74 68 65 |fference|s in the|
|00003aa0| 20 73 70 65 63 69 66 69 | 63 61 74 69 6f 6e 20 73 | specifi|cation s|
|00003ab0| 74 72 69 6e 67 3b 20 66 | 6f 72 20 65 78 61 6d 70 |tring; f|or examp|
|00003ac0| 6c 65 2c 20 74 68 65 20 | 73 74 72 69 6e 67 73 0a |le, the |strings.|
|00003ad0| 7b 5c 74 74 20 74 7d 20 | 61 6e 64 20 7b 5c 74 74 |{\tt t} |and {\tt|
|00003ae0| 20 54 7d 20 61 72 65 20 | 65 71 75 69 76 61 6c 65 | T} are |equivale|
|00003af0| 6e 74 20 66 6f 72 20 74 | 68 65 20 70 75 72 70 6f |nt for t|he purpo|
|00003b00| 73 65 73 20 6f 66 20 74 | 68 69 73 20 62 75 69 6c |ses of t|his buil|
|00003b10| 74 2d 69 6e 0a 66 75 6e | 63 74 69 6f 6e 2e 29 0a |t-in.fun|ction.).|
|00003b20| 0a 5c 69 74 65 6d 5b 5c | 68 62 6f 78 7b 5c 74 74 |.\item[\|hbox{\tt|
|00003b30| 20 63 68 72 2e 74 6f 2e | 69 6e 74 5c 24 7d 5c 68 | chr.to.|int\$}\h|
|00003b40| 66 69 6c 6c 5d 0a 50 6f | 70 73 20 74 68 65 20 74 |fill].Po|ps the t|
|00003b50| 6f 70 20 28 73 74 72 69 | 6e 67 29 20 6c 69 74 65 |op (stri|ng) lite|
|00003b60| 72 61 6c 2c 0a 6d 61 6b | 65 73 20 73 75 72 65 20 |ral,.mak|es sure |
|00003b70| 69 74 27 73 20 61 20 73 | 69 6e 67 6c 65 20 63 68 |it's a s|ingle ch|
|00003b80| 61 72 61 63 74 65 72 2c | 20 63 6f 6e 76 65 72 74 |aracter,| convert|
|00003b90| 73 20 69 74 20 74 6f 20 | 74 68 65 0a 63 6f 72 72 |s it to |the.corr|
|00003ba0| 65 73 70 6f 6e 64 69 6e | 67 20 41 53 43 49 49 20 |espondin|g ASCII |
|00003bb0| 69 6e 74 65 67 65 72 2c | 20 61 6e 64 20 70 75 73 |integer,| and pus|
|00003bc0| 68 65 73 20 74 68 69 73 | 20 69 6e 74 65 67 65 72 |hes this| integer|
|00003bd0| 2e 0a 0a 5c 69 74 65 6d | 5b 5c 68 62 6f 78 7b 5c |...\item|[\hbox{\|
|00003be0| 74 74 20 63 69 74 65 5c | 24 7d 5c 68 66 69 6c 6c |tt cite\|$}\hfill|
|00003bf0| 5d 0a 50 75 73 68 65 73 | 20 74 68 65 20 73 74 72 |].Pushes| the str|
|00003c00| 69 6e 67 20 74 68 61 74 | 20 77 61 73 20 74 68 65 |ing that| was the|
|00003c10| 0a 5c 68 62 6f 78 7b 5c | 76 65 72 62 7c 5c 63 69 |.\hbox{\|verb|\ci|
|00003c20| 74 65 7c 7d 2d 63 6f 6d | 6d 61 6e 64 20 61 72 67 |te|}-com|mand arg|
|00003c30| 75 6d 65 6e 74 20 66 6f | 72 20 74 68 69 73 20 65 |ument fo|r this e|
|00003c40| 6e 74 72 79 2e 0a 0a 5c | 69 74 65 6d 5b 5c 68 62 |ntry...\|item[\hb|
|00003c50| 6f 78 7b 5c 74 74 20 64 | 75 70 6c 69 63 61 74 65 |ox{\tt d|uplicate|
|00003c60| 5c 24 7d 5c 68 66 69 6c | 6c 5d 0a 50 6f 70 73 20 |\$}\hfil|l].Pops |
|00003c70| 74 68 65 20 74 6f 70 20 | 6c 69 74 65 72 61 6c 20 |the top |literal |
|00003c80| 66 72 6f 6d 20 74 68 65 | 20 73 74 61 63 6b 20 61 |from the| stack a|
|00003c90| 6e 64 20 70 75 73 68 65 | 73 20 74 77 6f 20 63 6f |nd pushe|s two co|
|00003ca0| 70 69 65 73 20 6f 66 20 | 69 74 2e 0a 0a 5c 69 74 |pies of |it...\it|
|00003cb0| 65 6d 5b 5c 68 62 6f 78 | 7b 5c 74 74 20 65 6d 70 |em[\hbox|{\tt emp|
|00003cc0| 74 79 5c 24 7d 5c 68 66 | 69 6c 6c 5d 0a 50 6f 70 |ty\$}\hf|ill].Pop|
|00003cd0| 73 20 74 68 65 20 74 6f | 70 20 6c 69 74 65 72 61 |s the to|p litera|
|00003ce0| 6c 20 61 6e 64 20 70 75 | 73 68 65 73 0a 74 68 65 |l and pu|shes.the|
|00003cf0| 20 69 6e 74 65 67 65 72 | 20 31 20 69 66 20 69 74 | integer| 1 if it|
|00003d00| 27 73 20 61 20 6d 69 73 | 73 69 6e 67 20 66 69 65 |'s a mis|sing fie|
|00003d10| 6c 64 20 6f 72 20 61 20 | 73 74 72 69 6e 67 20 68 |ld or a |string h|
|00003d20| 61 76 69 6e 67 20 6e 6f | 0a 6e 6f 6e 2d 77 68 69 |aving no|.non-whi|
|00003d30| 74 65 2d 73 70 61 63 65 | 20 63 68 61 72 61 63 74 |te-space| charact|
|00003d40| 65 72 73 2c 20 30 20 6f | 74 68 65 72 77 69 73 65 |ers, 0 o|therwise|
|00003d50| 2e 0a 0a 5c 69 74 65 6d | 5b 5c 68 62 6f 78 7b 5c |...\item|[\hbox{\|
|00003d60| 74 74 20 66 6f 72 6d 61 | 74 2e 6e 61 6d 65 5c 24 |tt forma|t.name\$|
|00003d70| 7d 5c 68 66 69 6c 6c 5d | 0a 50 6f 70 73 20 74 68 |}\hfill]|.Pops th|
|00003d80| 65 20 74 6f 70 20 74 68 | 72 65 65 20 6c 69 74 65 |e top th|ree lite|
|00003d90| 72 61 6c 73 0a 28 74 68 | 65 79 20 61 72 65 20 61 |rals.(th|ey are a|
|00003da0| 20 73 74 72 69 6e 67 2c | 20 61 6e 20 69 6e 74 65 | string,| an inte|
|00003db0| 67 65 72 2c 20 61 6e 64 | 20 61 20 73 74 72 69 6e |ger, and| a strin|
|00003dc0| 67 20 6c 69 74 65 72 61 | 6c 29 2e 0a 54 68 65 20 |g litera|l)..The |
|00003dd0| 6c 61 73 74 20 73 74 72 | 69 6e 67 20 6c 69 74 65 |last str|ing lite|
|00003de0| 72 61 6c 20 72 65 70 72 | 65 73 65 6e 74 73 20 61 |ral repr|esents a|
|00003df0| 20 6e 61 6d 65 20 6c 69 | 73 74 20 28 65 61 63 68 | name li|st (each|
|00003e00| 20 6e 61 6d 65 0a 63 6f | 72 72 65 73 70 6f 6e 64 | name.co|rrespond|
|00003e10| 69 6e 67 20 74 6f 20 61 | 20 70 65 72 73 6f 6e 29 |ing to a| person)|
|00003e20| 2c 20 74 68 65 20 69 6e | 74 65 67 65 72 20 6c 69 |, the in|teger li|
|00003e30| 74 65 72 61 6c 20 73 70 | 65 63 69 66 69 65 73 20 |teral sp|ecifies |
|00003e40| 77 68 69 63 68 20 6e 61 | 6d 65 0a 74 6f 20 70 69 |which na|me.to pi|
|00003e50| 63 6b 20 66 72 6f 6d 20 | 74 68 69 73 20 6c 69 73 |ck from |this lis|
|00003e60| 74 2c 20 61 6e 64 20 74 | 68 65 20 66 69 72 73 74 |t, and t|he first|
|00003e70| 20 73 74 72 69 6e 67 20 | 6c 69 74 65 72 61 6c 20 | string |literal |
|00003e80| 73 70 65 63 69 66 69 65 | 73 20 68 6f 77 20 74 6f |specifie|s how to|
|00003e90| 0a 66 6f 72 6d 61 74 20 | 74 68 69 73 20 6e 61 6d |.format |this nam|
|00003ea0| 65 2c 20 61 73 20 65 78 | 70 6c 61 69 6e 65 64 20 |e, as ex|plained |
|00003eb0| 69 6e 20 74 68 65 20 6e | 65 78 74 20 73 75 62 73 |in the n|ext subs|
|00003ec0| 65 63 74 69 6f 6e 2e 0a | 46 69 6e 61 6c 6c 79 2c |ection..|Finally,|
|00003ed0| 20 74 68 69 73 20 66 75 | 6e 63 74 69 6f 6e 20 70 | this fu|nction p|
|00003ee0| 75 73 68 65 73 20 74 68 | 65 20 66 6f 72 6d 61 74 |ushes th|e format|
|00003ef0| 74 65 64 20 6e 61 6d 65 | 2e 0a 0a 5c 69 74 65 6d |ted name|...\item|
|00003f00| 5b 5c 68 62 6f 78 7b 5c | 74 74 20 69 66 5c 24 7d |[\hbox{\|tt if\$}|
|00003f10| 5c 68 66 69 6c 6c 5d 0a | 50 6f 70 73 20 74 68 65 |\hfill].|Pops the|
|00003f20| 20 74 6f 70 20 74 68 72 | 65 65 20 6c 69 74 65 72 | top thr|ee liter|
|00003f30| 61 6c 73 20 28 74 68 65 | 79 0a 61 72 65 20 74 77 |als (the|y.are tw|
|00003f40| 6f 20 66 75 6e 63 74 69 | 6f 6e 20 6c 69 74 65 72 |o functi|on liter|
|00003f50| 61 6c 73 20 61 6e 64 20 | 61 6e 20 69 6e 74 65 67 |als and |an integ|
|00003f60| 65 72 20 6c 69 74 65 72 | 61 6c 2c 20 69 6e 20 74 |er liter|al, in t|
|00003f70| 68 61 74 20 6f 72 64 65 | 72 29 3b 0a 69 66 20 74 |hat orde|r);.if t|
|00003f80| 68 65 20 69 6e 74 65 67 | 65 72 20 69 73 20 67 72 |he integ|er is gr|
|00003f90| 65 61 74 65 72 20 74 68 | 61 6e 20 30 2c 20 69 74 |eater th|an 0, it|
|00003fa0| 20 65 78 65 63 75 74 65 | 73 20 74 68 65 20 73 65 | execute|s the se|
|00003fb0| 63 6f 6e 64 20 6c 69 74 | 65 72 61 6c 2c 0a 65 6c |cond lit|eral,.el|
|00003fc0| 73 65 20 69 74 20 65 78 | 65 63 75 74 65 73 20 74 |se it ex|ecutes t|
|00003fd0| 68 65 20 66 69 72 73 74 | 2e 0a 0a 5c 69 74 65 6d |he first|...\item|
|00003fe0| 5b 5c 68 62 6f 78 7b 5c | 74 74 20 69 6e 74 2e 74 |[\hbox{\|tt int.t|
|00003ff0| 6f 2e 63 68 72 5c 24 7d | 5c 68 66 69 6c 6c 5d 0a |o.chr\$}|\hfill].|
|00004000| 50 6f 70 73 20 74 68 65 | 20 74 6f 70 20 28 69 6e |Pops the| top (in|
|00004010| 74 65 67 65 72 29 20 6c | 69 74 65 72 61 6c 2c 0a |teger) l|iteral,.|
|00004020| 69 6e 74 65 72 70 72 65 | 74 65 64 20 61 73 20 74 |interpre|ted as t|
|00004030| 68 65 20 41 53 43 49 49 | 20 69 6e 74 65 67 65 72 |he ASCII| integer|
|00004040| 20 76 61 6c 75 65 20 6f | 66 20 61 20 73 69 6e 67 | value o|f a sing|
|00004050| 6c 65 20 63 68 61 72 61 | 63 74 65 72 2c 0a 63 6f |le chara|cter,.co|
|00004060| 6e 76 65 72 74 73 20 69 | 74 20 74 6f 20 74 68 65 |nverts i|t to the|
|00004070| 20 63 6f 72 72 65 73 70 | 6f 6e 64 69 6e 67 20 73 | corresp|onding s|
|00004080| 69 6e 67 6c 65 2d 63 68 | 61 72 61 63 74 65 72 20 |ingle-ch|aracter |
|00004090| 73 74 72 69 6e 67 2c 20 | 61 6e 64 20 70 75 73 68 |string, |and push|
|000040a0| 65 73 0a 74 68 69 73 20 | 73 74 72 69 6e 67 2e 0a |es.this |string..|
|000040b0| 0a 5c 69 74 65 6d 5b 5c | 68 62 6f 78 7b 5c 74 74 |.\item[\|hbox{\tt|
|000040c0| 20 69 6e 74 2e 74 6f 2e | 73 74 72 5c 24 7d 5c 68 | int.to.|str\$}\h|
|000040d0| 66 69 6c 6c 5d 0a 50 6f | 70 73 20 74 68 65 20 74 |fill].Po|ps the t|
|000040e0| 6f 70 20 28 69 6e 74 65 | 67 65 72 29 20 6c 69 74 |op (inte|ger) lit|
|000040f0| 65 72 61 6c 2c 0a 63 6f | 6e 76 65 72 74 73 20 69 |eral,.co|nverts i|
|00004100| 74 20 74 6f 20 69 74 73 | 20 28 75 6e 69 71 75 65 |t to its| (unique|
|00004110| 29 20 73 74 72 69 6e 67 | 20 65 71 75 69 76 61 6c |) string| equival|
|00004120| 65 6e 74 2c 20 61 6e 64 | 20 70 75 73 68 65 73 20 |ent, and| pushes |
|00004130| 74 68 69 73 20 73 74 72 | 69 6e 67 2e 0a 0a 5c 69 |this str|ing...\i|
|00004140| 74 65 6d 5b 5c 68 62 6f | 78 7b 5c 74 74 20 6d 69 |tem[\hbo|x{\tt mi|
|00004150| 73 73 69 6e 67 5c 24 7d | 5c 68 66 69 6c 6c 5d 0a |ssing\$}|\hfill].|
|00004160| 50 6f 70 73 20 74 68 65 | 20 74 6f 70 20 6c 69 74 |Pops the| top lit|
|00004170| 65 72 61 6c 20 61 6e 64 | 0a 70 75 73 68 65 73 20 |eral and|.pushes |
|00004180| 74 68 65 20 69 6e 74 65 | 67 65 72 20 31 20 69 66 |the inte|ger 1 if|
|00004190| 20 69 74 27 73 20 61 20 | 6d 69 73 73 69 6e 67 20 | it's a |missing |
|000041a0| 66 69 65 6c 64 2c 20 30 | 7e 6f 74 68 65 72 77 69 |field, 0|~otherwi|
|000041b0| 73 65 2e 0a 0a 5c 69 74 | 65 6d 5b 5c 68 62 6f 78 |se...\it|em[\hbox|
|000041c0| 7b 5c 74 74 20 6e 65 77 | 6c 69 6e 65 5c 24 7d 5c |{\tt new|line\$}\|
|000041d0| 68 66 69 6c 6c 5d 0a 57 | 72 69 74 65 73 20 6f 6e |hfill].W|rites on|
|000041e0| 74 6f 20 74 68 65 20 7b | 5c 74 74 20 62 62 6c 7d |to the {|\tt bbl}|
|000041f0| 20 66 69 6c 65 0a 77 68 | 61 74 27 73 20 61 63 63 | file.wh|at's acc|
|00004200| 75 6d 75 6c 61 74 65 64 | 20 69 6e 20 74 68 65 20 |umulated| in the |
|00004210| 6f 75 74 70 75 74 20 62 | 75 66 66 65 72 2e 0a 49 |output b|uffer..I|
|00004220| 74 20 77 72 69 74 65 73 | 20 61 20 62 6c 61 6e 6b |t writes| a blank|
|00004230| 20 6c 69 6e 65 20 69 66 | 20 61 6e 64 20 6f 6e 6c | line if| and onl|
|00004240| 79 20 69 66 20 74 68 65 | 20 6f 75 74 70 75 74 20 |y if the| output |
|00004250| 62 75 66 66 65 72 20 69 | 73 20 65 6d 70 74 79 2e |buffer i|s empty.|
|00004260| 0a 53 69 6e 63 65 20 5c | 68 62 6f 78 7b 5c 74 74 |.Since \|hbox{\tt|
|00004270| 20 77 72 69 74 65 5c 24 | 7d 20 64 6f 65 73 20 72 | write\$|} does r|
|00004280| 65 61 73 6f 6e 61 62 6c | 65 20 6c 69 6e 65 20 62 |easonabl|e line b|
|00004290| 72 65 61 6b 69 6e 67 2c | 20 79 6f 75 20 73 68 6f |reaking,| you sho|
|000042a0| 75 6c 64 20 75 73 65 0a | 74 68 69 73 20 66 75 6e |uld use.|this fun|
|000042b0| 63 74 69 6f 6e 20 6f 6e | 6c 79 20 77 68 65 6e 20 |ction on|ly when |
|000042c0| 79 6f 75 20 77 61 6e 74 | 20 61 20 62 6c 61 6e 6b |you want| a blank|
|000042d0| 20 6c 69 6e 65 20 6f 72 | 20 61 6e 20 65 78 70 6c | line or| an expl|
|000042e0| 69 63 69 74 20 6c 69 6e | 65 20 62 72 65 61 6b 2e |icit lin|e break.|
|000042f0| 0a 0a 5c 69 74 65 6d 5b | 5c 68 62 6f 78 7b 5c 74 |..\item[|\hbox{\t|
|00004300| 74 20 6e 75 6d 2e 6e 61 | 6d 65 73 5c 24 7d 5c 68 |t num.na|mes\$}\h|
|00004310| 66 69 6c 6c 5d 0a 50 6f | 70 73 20 74 68 65 20 74 |fill].Po|ps the t|
|00004320| 6f 70 20 28 73 74 72 69 | 6e 67 29 20 6c 69 74 65 |op (stri|ng) lite|
|00004330| 72 61 6c 0a 61 6e 64 20 | 70 75 73 68 65 73 20 74 |ral.and |pushes t|
|00004340| 68 65 20 6e 75 6d 62 65 | 72 20 6f 66 20 6e 61 6d |he numbe|r of nam|
|00004350| 65 73 20 74 68 65 20 73 | 74 72 69 6e 67 20 72 65 |es the s|tring re|
|00004360| 70 72 65 73 65 6e 74 73 | 2d 2d 2d 6f 6e 65 20 70 |presents|---one p|
|00004370| 6c 75 73 0a 74 68 65 20 | 6e 75 6d 62 65 72 20 6f |lus.the |number o|
|00004380| 66 20 6f 63 63 75 72 72 | 65 6e 63 65 73 20 6f 66 |f occurr|ences of|
|00004390| 20 74 68 65 20 73 75 62 | 73 74 72 69 6e 67 20 60 | the sub|string `|
|000043a0| 60 61 6e 64 27 27 20 28 | 69 67 6e 6f 72 69 6e 67 |`and'' (|ignoring|
|000043b0| 20 63 61 73 65 20 64 69 | 66 66 65 72 65 6e 63 65 | case di|fference|
|000043c0| 73 29 0a 73 75 72 72 6f | 75 6e 64 65 64 20 62 79 |s).surro|unded by|
|000043d0| 20 6e 6f 6e 6e 75 6c 6c | 20 77 68 69 74 65 2d 73 | nonnull| white-s|
|000043e0| 70 61 63 65 20 61 74 20 | 74 68 65 20 74 6f 70 20 |pace at |the top |
|000043f0| 62 72 61 63 65 20 6c 65 | 76 65 6c 2e 0a 0a 5c 69 |brace le|vel...\i|
|00004400| 74 65 6d 5b 5c 68 62 6f | 78 7b 5c 74 74 20 70 6f |tem[\hbo|x{\tt po|
|00004410| 70 5c 24 7d 5c 68 66 69 | 6c 6c 5d 0a 50 6f 70 73 |p\$}\hfi|ll].Pops|
|00004420| 20 74 68 65 20 74 6f 70 | 20 6f 66 20 74 68 65 20 | the top| of the |
|00004430| 73 74 61 63 6b 20 62 75 | 74 0a 64 6f 65 73 6e 27 |stack bu|t.doesn'|
|00004440| 74 20 70 72 69 6e 74 20 | 69 74 3b 20 74 68 69 73 |t print |it; this|
|00004450| 20 67 65 74 73 20 72 69 | 64 20 6f 66 20 61 6e 20 | gets ri|d of an |
|00004460| 75 6e 77 61 6e 74 65 64 | 20 73 74 61 63 6b 20 6c |unwanted| stack l|
|00004470| 69 74 65 72 61 6c 2e 0a | 0a 5c 69 74 65 6d 5b 5c |iteral..|.\item[\|
|00004480| 68 62 6f 78 7b 5c 74 74 | 20 70 72 65 61 6d 62 6c |hbox{\tt| preambl|
|00004490| 65 5c 24 7d 5c 68 66 69 | 6c 6c 5d 0a 50 75 73 68 |e\$}\hfi|ll].Push|
|000044a0| 65 73 20 6f 6e 74 6f 20 | 74 68 65 20 73 74 61 63 |es onto |the stac|
|000044b0| 6b 20 74 68 65 20 63 6f | 6e 63 61 74 65 6e 61 74 |k the co|ncatenat|
|000044c0| 69 6f 6e 20 6f 66 20 61 | 6c 6c 20 74 68 65 0a 5c |ion of a|ll the.\|
|000044d0| 68 62 6f 78 7b 5c 74 74 | 20 40 50 52 45 41 4d 42 |hbox{\tt| @PREAMB|
|000044e0| 4c 45 7d 20 73 74 72 69 | 6e 67 73 20 72 65 61 64 |LE} stri|ngs read|
|000044f0| 20 66 72 6f 6d 20 74 68 | 65 20 64 61 74 61 62 61 | from th|e databa|
|00004500| 73 65 20 66 69 6c 65 73 | 2e 0a 0a 5c 69 74 65 6d |se files|...\item|
|00004510| 5b 5c 68 62 6f 78 7b 5c | 74 74 20 70 75 72 69 66 |[\hbox{\|tt purif|
|00004520| 79 5c 24 7d 5c 68 66 69 | 6c 6c 5d 0a 50 6f 70 73 |y\$}\hfi|ll].Pops|
|00004530| 20 74 68 65 20 74 6f 70 | 20 28 73 74 72 69 6e 67 | the top| (string|
|00004540| 29 20 6c 69 74 65 72 61 | 6c 2c 0a 72 65 6d 6f 76 |) litera|l,.remov|
|00004550| 65 73 20 6e 6f 6e 61 6c | 70 68 61 6e 75 6d 65 72 |es nonal|phanumer|
|00004560| 69 63 20 63 68 61 72 61 | 63 74 65 72 73 20 65 78 |ic chara|cters ex|
|00004570| 63 65 70 74 20 66 6f 72 | 20 77 68 69 74 65 2d 73 |cept for| white-s|
|00004580| 70 61 63 65 20 63 68 61 | 72 61 63 74 65 72 73 20 |pace cha|racters |
|00004590| 61 6e 64 0a 68 79 70 68 | 65 6e 73 20 61 6e 64 20 |and.hyph|ens and |
|000045a0| 74 69 65 73 20 28 74 68 | 65 73 65 20 61 6c 6c 20 |ties (th|ese all |
|000045b0| 67 65 74 20 63 6f 6e 76 | 65 72 74 65 64 20 74 6f |get conv|erted to|
|000045c0| 20 61 20 73 70 61 63 65 | 29 2c 20 72 65 6d 6f 76 | a space|), remov|
|000045d0| 65 73 0a 63 65 72 74 61 | 69 6e 20 61 6c 70 68 61 |es.certa|in alpha|
|000045e0| 62 65 74 69 63 20 63 68 | 61 72 61 63 74 65 72 73 |betic ch|aracters|
|000045f0| 20 63 6f 6e 74 61 69 6e | 65 64 20 69 6e 20 74 68 | contain|ed in th|
|00004600| 65 20 63 6f 6e 74 72 6f | 6c 20 73 65 71 75 65 6e |e contro|l sequen|
|00004610| 63 65 73 0a 61 73 73 6f | 63 69 61 74 65 64 20 77 |ces.asso|ciated w|
|00004620| 69 74 68 20 61 20 60 60 | 73 70 65 63 69 61 6c 20 |ith a ``|special |
|00004630| 63 68 61 72 61 63 74 65 | 72 27 27 24 5c 21 24 2c |characte|r''$\!$,|
|00004640| 20 61 6e 64 20 70 75 73 | 68 65 73 20 74 68 65 20 | and pus|hes the |
|00004650| 72 65 73 75 6c 74 69 6e | 67 20 73 74 72 69 6e 67 |resultin|g string|
|00004660| 2e 0a 0a 5c 69 74 65 6d | 5b 5c 68 62 6f 78 7b 5c |...\item|[\hbox{\|
|00004670| 74 74 20 71 75 6f 74 65 | 5c 24 7d 5c 68 66 69 6c |tt quote|\$}\hfil|
|00004680| 6c 5d 0a 50 75 73 68 65 | 73 20 74 68 65 20 73 74 |l].Pushe|s the st|
|00004690| 72 69 6e 67 20 63 6f 6e | 73 69 73 74 69 6e 67 20 |ring con|sisting |
|000046a0| 6f 66 20 74 68 65 20 64 | 6f 75 62 6c 65 2d 71 75 |of the d|ouble-qu|
|000046b0| 6f 74 65 20 63 68 61 72 | 61 63 74 65 72 2e 0a 0a |ote char|acter...|
|000046c0| 5c 69 74 65 6d 5b 5c 68 | 62 6f 78 7b 5c 74 74 20 |\item[\h|box{\tt |
|000046d0| 73 6b 69 70 5c 24 7d 5c | 68 66 69 6c 6c 5d 0a 49 |skip\$}\|hfill].I|
|000046e0| 73 20 61 20 6e 6f 2d 6f | 70 2e 0a 0a 5c 69 74 65 |s a no-o|p...\ite|
|000046f0| 6d 5b 5c 68 62 6f 78 7b | 5c 74 74 20 73 74 61 63 |m[\hbox{|\tt stac|
|00004700| 6b 5c 24 7d 5c 68 66 69 | 6c 6c 5d 0a 50 6f 70 73 |k\$}\hfi|ll].Pops|
|00004710| 20 61 6e 64 20 70 72 69 | 6e 74 73 20 74 68 65 20 | and pri|nts the |
|00004720| 77 68 6f 6c 65 20 73 74 | 61 63 6b 3b 0a 69 74 27 |whole st|ack;.it'|
|00004730| 73 20 6d 65 61 6e 74 20 | 74 6f 20 62 65 20 75 73 |s meant |to be us|
|00004740| 65 64 20 66 6f 72 20 73 | 74 79 6c 65 20 64 65 73 |ed for s|tyle des|
|00004750| 69 67 6e 65 72 73 20 77 | 68 69 6c 65 20 64 65 62 |igners w|hile deb|
|00004760| 75 67 67 69 6e 67 2e 0a | 0a 5c 69 74 65 6d 5b 5c |ugging..|.\item[\|
|00004770| 68 62 6f 78 7b 5c 74 74 | 20 73 75 62 73 74 72 69 |hbox{\tt| substri|
|00004780| 6e 67 5c 24 7d 5c 68 66 | 69 6c 6c 5d 0a 50 6f 70 |ng\$}\hf|ill].Pop|
|00004790| 73 20 74 68 65 20 74 6f | 70 20 74 68 72 65 65 20 |s the to|p three |
|000047a0| 6c 69 74 65 72 61 6c 73 | 0a 28 74 68 65 79 20 61 |literals|.(they a|
|000047b0| 72 65 20 74 68 65 20 74 | 77 6f 20 69 6e 74 65 67 |re the t|wo integ|
|000047c0| 65 72 73 20 6c 69 74 65 | 72 61 6c 73 20 7b 5c 69 |ers lite|rals {\i|
|000047d0| 74 20 6c 65 6e 5c 2f 7d | 20 61 6e 64 20 7b 5c 69 |t len\/}| and {\i|
|000047e0| 74 20 73 74 61 72 74 7d | 2c 20 61 6e 64 20 61 0a |t start}|, and a.|
|000047f0| 73 74 72 69 6e 67 20 6c | 69 74 65 72 61 6c 2c 20 |string l|iteral, |
|00004800| 69 6e 20 74 68 61 74 20 | 6f 72 64 65 72 29 2e 0a |in that |order)..|
|00004810| 49 74 20 70 75 73 68 65 | 73 20 74 68 65 20 73 75 |It pushe|s the su|
|00004820| 62 73 74 72 69 6e 67 20 | 6f 66 20 74 68 65 20 28 |bstring |of the (|
|00004830| 61 74 20 6d 6f 73 74 29 | 20 7b 5c 69 74 20 6c 65 |at most)| {\it le|
|00004840| 6e 5c 2f 7d 20 63 6f 6e | 73 65 63 75 74 69 76 65 |n\/} con|secutive|
|00004850| 20 63 68 61 72 61 63 74 | 65 72 73 0a 73 74 61 72 | charact|ers.star|
|00004860| 74 69 6e 67 20 61 74 20 | 74 68 65 20 7b 5c 69 74 |ting at |the {\it|
|00004870| 20 73 74 61 72 74 5c 2f | 7d 74 68 20 63 68 61 72 | start\/|}th char|
|00004880| 61 63 74 65 72 20 28 61 | 73 73 75 6d 69 6e 67 20 |acter (a|ssuming |
|00004890| 31 2d 62 61 73 65 64 20 | 69 6e 64 65 78 69 6e 67 |1-based |indexing|
|000048a0| 29 0a 69 66 20 7b 5c 69 | 74 20 73 74 61 72 74 5c |).if {\i|t start\|
|000048b0| 2f 7d 20 69 73 20 70 6f | 73 69 74 69 76 65 2c 20 |/} is po|sitive, |
|000048c0| 61 6e 64 20 65 6e 64 69 | 6e 67 20 61 74 20 74 68 |and endi|ng at th|
|000048d0| 65 20 24 2d 24 7b 5c 69 | 74 20 73 74 61 72 74 5c |e $-${\i|t start\|
|000048e0| 2f 7d 74 68 20 63 68 61 | 72 61 63 74 65 72 0a 66 |/}th cha|racter.f|
|000048f0| 72 6f 6d 20 74 68 65 20 | 65 6e 64 20 69 66 20 7b |rom the |end if {|
|00004900| 5c 69 74 20 73 74 61 72 | 74 5c 2f 7d 20 69 73 20 |\it star|t\/} is |
|00004910| 6e 65 67 61 74 69 76 65 | 0a 28 77 68 65 72 65 20 |negative|.(where |
|00004920| 74 68 65 20 66 69 72 73 | 74 20 63 68 61 72 61 63 |the firs|t charac|
|00004930| 74 65 72 20 66 72 6f 6d | 20 74 68 65 20 65 6e 64 |ter from| the end|
|00004940| 20 69 73 20 74 68 65 20 | 6c 61 73 74 20 63 68 61 | is the |last cha|
|00004950| 72 61 63 74 65 72 29 2e | 0a 0a 5c 69 74 65 6d 5b |racter).|..\item[|
|00004960| 5c 68 62 6f 78 7b 5c 74 | 74 20 73 77 61 70 5c 24 |\hbox{\t|t swap\$|
|00004970| 7d 5c 68 66 69 6c 6c 5d | 0a 53 77 61 70 73 20 74 |}\hfill]|.Swaps t|
|00004980| 68 65 20 74 6f 70 20 74 | 77 6f 20 6c 69 74 65 72 |he top t|wo liter|
|00004990| 61 6c 73 20 6f 6e 20 74 | 68 65 20 73 74 61 63 6b |als on t|he stack|
|000049a0| 2e 0a 0a 5c 69 74 65 6d | 5b 5c 68 62 6f 78 7b 5c |...\item|[\hbox{\|
|000049b0| 74 74 20 74 65 78 74 2e | 6c 65 6e 67 74 68 5c 24 |tt text.|length\$|
|000049c0| 7d 5c 68 66 69 6c 6c 5d | 0a 50 6f 70 73 20 74 68 |}\hfill]|.Pops th|
|000049d0| 65 20 74 6f 70 20 28 73 | 74 72 69 6e 67 29 20 6c |e top (s|tring) l|
|000049e0| 69 74 65 72 61 6c 2c 0a | 61 6e 64 20 70 75 73 68 |iteral,.|and push|
|000049f0| 65 73 20 74 68 65 20 6e | 75 6d 62 65 72 20 6f 66 |es the n|umber of|
|00004a00| 20 63 68 61 72 61 63 74 | 65 72 73 20 69 74 20 63 | charact|ers it c|
|00004a10| 6f 6e 74 61 69 6e 73 2c | 20 77 68 65 72 65 20 61 |ontains,| where a|
|00004a20| 6e 0a 61 63 63 65 6e 74 | 65 64 20 63 68 61 72 61 |n.accent|ed chara|
|00004a30| 63 74 65 72 20 28 6d 6f | 72 65 20 70 72 65 63 69 |cter (mo|re preci|
|00004a40| 73 65 6c 79 2c 20 61 20 | 60 60 73 70 65 63 69 61 |sely, a |``specia|
|00004a50| 6c 20 63 68 61 72 61 63 | 74 65 72 27 27 24 5c 21 |l charac|ter''$\!|
|00004a60| 24 2c 0a 64 65 66 69 6e | 65 64 20 69 6e 20 53 65 |$,.defin|ed in Se|
|00004a70| 63 74 69 6f 6e 7e 34 29 | 0a 63 6f 75 6e 74 73 20 |ction~4)|.counts |
|00004a80| 61 73 20 61 20 73 69 6e | 67 6c 65 20 63 68 61 72 |as a sin|gle char|
|00004a90| 61 63 74 65 72 2c 20 65 | 76 65 6e 20 69 66 20 69 |acter, e|ven if i|
|00004aa0| 74 27 73 20 6d 69 73 73 | 69 6e 67 0a 69 74 73 20 |t's miss|ing.its |
|00004ab0| 6d 61 74 63 68 69 6e 67 | 20 72 69 67 68 74 20 62 |matching| right b|
|00004ac0| 72 61 63 65 2e 0a 0a 5c | 69 74 65 6d 5b 5c 68 62 |race...\|item[\hb|
|00004ad0| 6f 78 7b 5c 74 74 20 74 | 65 78 74 2e 70 72 65 66 |ox{\tt t|ext.pref|
|00004ae0| 69 78 5c 24 7d 5c 68 66 | 69 6c 6c 5d 0a 50 6f 70 |ix\$}\hf|ill].Pop|
|00004af0| 73 20 74 68 65 20 74 6f | 70 20 74 77 6f 20 6c 69 |s the to|p two li|
|00004b00| 74 65 72 61 6c 73 0a 28 | 74 68 65 20 69 6e 74 65 |terals.(|the inte|
|00004b10| 67 65 72 20 6c 69 74 65 | 72 61 6c 20 7b 5c 69 74 |ger lite|ral {\it|
|00004b20| 20 6c 65 6e 5c 2f 7d 20 | 61 6e 64 20 61 20 73 74 | len\/} |and a st|
|00004b30| 72 69 6e 67 20 6c 69 74 | 65 72 61 6c 2c 20 69 6e |ring lit|eral, in|
|00004b40| 20 74 68 61 74 20 6f 72 | 64 65 72 29 2e 0a 49 74 | that or|der)..It|
|00004b50| 20 70 75 73 68 20 74 68 | 65 20 73 75 62 73 74 72 | push th|e substr|
|00004b60| 69 6e 67 20 6f 66 20 74 | 68 65 20 28 61 74 20 6d |ing of t|he (at m|
|00004b70| 6f 73 74 29 20 7b 5c 69 | 74 20 6c 65 6e 5c 2f 7d |ost) {\i|t len\/}|
|00004b80| 20 63 6f 6e 73 65 63 75 | 74 69 76 65 0a 63 68 61 | consecu|tive.cha|
|00004b90| 72 61 63 74 65 72 73 20 | 73 74 61 72 74 69 6e 67 |racters |starting|
|00004ba0| 20 66 72 6f 6d 20 74 68 | 65 20 62 65 67 69 6e 6e | from th|e beginn|
|00004bb0| 69 6e 67 20 6f 66 20 74 | 68 65 20 73 74 72 69 6e |ing of t|he strin|
|00004bc0| 67 2e 20 20 54 68 69 73 | 20 66 75 6e 63 74 69 6f |g. This| functio|
|00004bd0| 6e 0a 69 73 20 73 69 6d | 69 6c 61 72 20 74 6f 20 |n.is sim|ilar to |
|00004be0| 5c 68 62 6f 78 7b 5c 74 | 74 20 73 75 62 73 74 72 |\hbox{\t|t substr|
|00004bf0| 69 6e 67 5c 24 7d 2c 20 | 62 75 74 20 74 68 69 73 |ing\$}, |but this|
|00004c00| 20 6f 6e 65 20 63 6f 6e | 73 69 64 65 72 73 0a 61 | one con|siders.a|
|00004c10| 20 60 60 73 70 65 63 69 | 61 6c 20 63 68 61 72 61 | ``speci|al chara|
|00004c20| 63 74 65 72 27 27 24 5c | 21 24 2c 20 65 76 65 6e |cter''$\|!$, even|
|00004c30| 20 69 66 0a 69 74 27 73 | 20 6d 69 73 73 69 6e 67 | if.it's| missing|
|00004c40| 20 69 74 73 20 6d 61 74 | 63 68 69 6e 67 20 72 69 | its mat|ching ri|
|00004c50| 67 68 74 2d 62 72 61 63 | 65 2c 20 74 6f 20 62 65 |ght-brac|e, to be|
|00004c60| 20 61 20 73 69 6e 67 6c | 65 20 63 68 61 72 61 63 | a singl|e charac|
|00004c70| 74 65 72 0a 28 72 61 74 | 68 65 72 20 74 68 61 6e |ter.(rat|her than|
|00004c80| 20 68 6f 77 65 76 65 72 | 20 6d 61 6e 79 20 41 53 | however| many AS|
|00004c90| 43 49 49 20 63 68 61 72 | 61 63 74 65 72 73 20 69 |CII char|acters i|
|00004ca0| 74 20 61 63 74 75 61 6c | 6c 79 20 63 6f 6d 70 72 |t actual|ly compr|
|00004cb0| 69 73 65 73 29 2e 0a 0a | 5c 69 74 65 6d 5b 5c 68 |ises)...|\item[\h|
|00004cc0| 62 6f 78 7b 5c 74 74 20 | 74 6f 70 5c 24 7d 5c 68 |box{\tt |top\$}\h|
|00004cd0| 66 69 6c 6c 5d 0a 50 6f | 70 73 20 61 6e 64 20 70 |fill].Po|ps and p|
|00004ce0| 72 69 6e 74 73 20 74 68 | 65 20 74 6f 70 20 6f 66 |rints th|e top of|
|00004cf0| 20 74 68 65 20 73 74 61 | 63 6b 20 6f 6e 20 74 68 | the sta|ck on th|
|00004d00| 65 20 74 65 72 6d 69 6e | 61 6c 20 61 6e 64 20 6c |e termin|al and l|
|00004d10| 6f 67 20 66 69 6c 65 2e | 0a 49 74 27 73 20 75 73 |og file.|.It's us|
|00004d20| 65 66 75 6c 20 66 6f 72 | 20 64 65 62 75 67 67 69 |eful for| debuggi|
|00004d30| 6e 67 2e 0a 0a 5c 69 74 | 65 6d 5b 5c 68 62 6f 78 |ng...\it|em[\hbox|
|00004d40| 7b 5c 74 74 20 74 79 70 | 65 5c 24 7d 5c 68 66 69 |{\tt typ|e\$}\hfi|
|00004d50| 6c 6c 5d 0a 50 75 73 68 | 65 73 20 74 68 65 20 63 |ll].Push|es the c|
|00004d60| 75 72 72 65 6e 74 20 65 | 6e 74 72 79 27 73 20 74 |urrent e|ntry's t|
|00004d70| 79 70 65 20 28 62 6f 6f | 6b 2c 20 61 72 74 69 63 |ype (boo|k, artic|
|00004d80| 6c 65 2c 20 65 74 63 2e | 29 2c 0a 62 75 74 20 70 |le, etc.|),.but p|
|00004d90| 75 73 68 65 73 20 74 68 | 65 20 6e 75 6c 6c 20 73 |ushes th|e null s|
|00004da0| 74 72 69 6e 67 0a 69 66 | 20 74 68 65 20 74 79 70 |tring.if| the typ|
|00004db0| 65 20 69 73 20 65 69 74 | 68 65 72 20 75 6e 6b 6e |e is eit|her unkn|
|00004dc0| 6f 77 6e 20 6f 72 20 75 | 6e 64 65 66 69 6e 65 64 |own or u|ndefined|
|00004dd0| 2e 0a 0a 5c 69 74 65 6d | 5b 5c 68 62 6f 78 7b 5c |...\item|[\hbox{\|
|00004de0| 74 74 20 77 61 72 6e 69 | 6e 67 5c 24 7d 5c 68 66 |tt warni|ng\$}\hf|
|00004df0| 69 6c 6c 5d 0a 50 6f 70 | 73 20 74 68 65 20 74 6f |ill].Pop|s the to|
|00004e00| 70 20 28 73 74 72 69 6e | 67 29 20 6c 69 74 65 72 |p (strin|g) liter|
|00004e10| 61 6c 0a 61 6e 64 20 70 | 72 69 6e 74 73 20 69 74 |al.and p|rints it|
|00004e20| 20 66 6f 6c 6c 6f 77 69 | 6e 67 20 61 20 77 61 72 | followi|ng a war|
|00004e30| 6e 69 6e 67 20 6d 65 73 | 73 61 67 65 2e 0a 54 68 |ning mes|sage..Th|
|00004e40| 69 73 20 61 6c 73 6f 20 | 69 6e 63 72 65 6d 65 6e |is also |incremen|
|00004e50| 74 73 20 61 20 63 6f 75 | 6e 74 20 6f 66 20 74 68 |ts a cou|nt of th|
|00004e60| 65 20 6e 75 6d 62 65 72 | 20 6f 66 20 77 61 72 6e |e number| of warn|
|00004e70| 69 6e 67 20 6d 65 73 73 | 61 67 65 73 20 69 73 73 |ing mess|ages iss|
|00004e80| 75 65 64 2e 0a 0a 5c 69 | 74 65 6d 5b 5c 68 62 6f |ued...\i|tem[\hbo|
|00004e90| 78 7b 5c 74 74 20 77 68 | 69 6c 65 5c 24 7d 5c 68 |x{\tt wh|ile\$}\h|
|00004ea0| 66 69 6c 6c 5d 0a 50 6f | 70 73 20 74 68 65 20 74 |fill].Po|ps the t|
|00004eb0| 6f 70 20 74 77 6f 20 28 | 66 75 6e 63 74 69 6f 6e |op two (|function|
|00004ec0| 29 20 6c 69 74 65 72 61 | 6c 73 2c 0a 61 6e 64 20 |) litera|ls,.and |
|00004ed0| 6b 65 65 70 73 20 65 78 | 65 63 75 74 69 6e 67 20 |keeps ex|ecuting |
|00004ee0| 74 68 65 20 73 65 63 6f | 6e 64 20 61 73 20 6c 6f |the seco|nd as lo|
|00004ef0| 6e 67 20 61 73 20 74 68 | 65 20 28 69 6e 74 65 67 |ng as th|e (integ|
|00004f00| 65 72 29 0a 6c 69 74 65 | 72 61 6c 20 6c 65 66 74 |er).lite|ral left|
|00004f10| 20 6f 6e 20 74 68 65 20 | 73 74 61 63 6b 20 62 79 | on the |stack by|
|00004f20| 20 65 78 65 63 75 74 69 | 6e 67 20 74 68 65 20 66 | executi|ng the f|
|00004f30| 69 72 73 74 20 69 73 20 | 67 72 65 61 74 65 72 20 |irst is |greater |
|00004f40| 74 68 61 6e 20 30 2e 0a | 0a 5c 69 74 65 6d 5b 5c |than 0..|.\item[\|
|00004f50| 68 62 6f 78 7b 5c 74 74 | 20 77 69 64 74 68 5c 24 |hbox{\tt| width\$|
|00004f60| 7d 5c 68 66 69 6c 6c 5d | 0a 50 6f 70 73 20 74 68 |}\hfill]|.Pops th|
|00004f70| 65 20 74 6f 70 20 28 73 | 74 72 69 6e 67 29 20 6c |e top (s|tring) l|
|00004f80| 69 74 65 72 61 6c 0a 61 | 6e 64 20 70 75 73 68 65 |iteral.a|nd pushe|
|00004f90| 73 20 74 68 65 20 69 6e | 74 65 67 65 72 20 74 68 |s the in|teger th|
|00004fa0| 61 74 20 72 65 70 72 65 | 73 65 6e 74 73 20 69 74 |at repre|sents it|
|00004fb0| 73 20 77 69 64 74 68 20 | 69 6e 20 73 6f 6d 65 20 |s width |in some |
|00004fc0| 72 65 6c 61 74 69 76 65 | 20 75 6e 69 74 73 0a 28 |relative| units.(|
|00004fd0| 63 75 72 72 65 6e 74 6c | 79 2c 20 68 75 6e 64 72 |currentl|y, hundr|
|00004fe0| 65 64 74 68 73 20 6f 66 | 20 61 20 70 6f 69 6e 74 |edths of| a point|
|00004ff0| 2c 20 61 73 20 73 70 65 | 63 69 66 69 65 64 20 62 |, as spe|cified b|
|00005000| 79 20 74 68 65 20 4a 75 | 6e 65 20 31 39 38 37 20 |y the Ju|ne 1987 |
|00005010| 76 65 72 73 69 6f 6e 0a | 6f 66 20 74 68 65 20 24 |version.|of the $|
|00005020| 63 6d 72 31 30 24 20 66 | 6f 6e 74 3b 20 74 68 65 |cmr10$ f|ont; the|
|00005030| 20 6f 6e 6c 79 20 77 68 | 69 74 65 2d 73 70 61 63 | only wh|ite-spac|
|00005040| 65 20 63 68 61 72 61 63 | 74 65 72 20 77 69 74 68 |e charac|ter with|
|00005050| 20 6e 6f 6e 7a 65 72 6f | 20 77 69 64 74 68 0a 69 | nonzero| width.i|
|00005060| 73 20 74 68 65 20 73 70 | 61 63 65 29 2e 0a 54 68 |s the sp|ace)..Th|
|00005070| 69 73 20 66 75 6e 63 74 | 69 6f 6e 20 74 61 6b 65 |is funct|ion take|
|00005080| 73 20 74 68 65 20 6c 69 | 74 65 72 61 6c 20 6c 69 |s the li|teral li|
|00005090| 74 65 72 61 6c 6c 79 3b | 0a 74 68 61 74 20 69 73 |terally;|.that is|
|000050a0| 2c 20 69 74 20 61 73 73 | 75 6d 65 73 20 65 61 63 |, it ass|umes eac|
|000050b0| 68 20 63 68 61 72 61 63 | 74 65 72 20 69 6e 20 74 |h charac|ter in t|
|000050c0| 68 65 20 73 74 72 69 6e | 67 20 69 73 20 74 6f 20 |he strin|g is to |
|000050d0| 62 65 20 70 72 69 6e 74 | 65 64 20 61 73 0a 69 73 |be print|ed as.is|
|000050e0| 2c 20 72 65 67 61 72 64 | 6c 65 73 73 20 6f 66 20 |, regard|less of |
|000050f0| 77 68 65 74 68 65 72 20 | 74 68 65 20 63 68 61 72 |whether |the char|
|00005100| 61 63 74 65 72 20 68 61 | 73 20 61 20 73 70 65 63 |acter ha|s a spec|
|00005110| 69 61 6c 20 6d 65 61 6e | 69 6e 67 20 74 6f 20 5c |ial mean|ing to \|
|00005120| 54 65 58 2c 0a 65 78 63 | 65 70 74 20 74 68 61 74 |TeX,.exc|ept that|
|00005130| 20 60 60 73 70 65 63 69 | 61 6c 20 63 68 61 72 61 | ``speci|al chara|
|00005140| 63 74 65 72 73 27 27 20 | 28 65 76 65 6e 20 77 69 |cters'' |(even wi|
|00005150| 74 68 6f 75 74 20 74 68 | 65 69 72 20 72 69 67 68 |thout th|eir righ|
|00005160| 74 20 62 72 61 63 65 73 | 29 20 61 72 65 0a 68 61 |t braces|) are.ha|
|00005170| 6e 64 6c 65 64 20 73 70 | 65 63 69 61 6c 6c 79 2e |ndled sp|ecially.|
|00005180| 0a 54 68 69 73 20 69 73 | 20 6d 65 61 6e 74 20 74 |.This is| meant t|
|00005190| 6f 20 62 65 20 75 73 65 | 64 20 66 6f 72 20 63 6f |o be use|d for co|
|000051a0| 6d 70 61 72 69 6e 67 20 | 77 69 64 74 68 73 20 6f |mparing |widths o|
|000051b0| 66 20 6c 61 62 65 6c 20 | 73 74 72 69 6e 67 73 2e |f label |strings.|
|000051c0| 0a 0a 5c 69 74 65 6d 5b | 5c 68 62 6f 78 7b 5c 74 |..\item[|\hbox{\t|
|000051d0| 74 20 77 72 69 74 65 5c | 24 7d 5c 68 66 69 6c 6c |t write\|$}\hfill|
|000051e0| 5d 0a 50 6f 70 73 20 74 | 68 65 20 74 6f 70 20 28 |].Pops t|he top (|
|000051f0| 73 74 72 69 6e 67 29 20 | 6c 69 74 65 72 61 6c 0a |string) |literal.|
|00005200| 61 6e 64 20 77 72 69 74 | 65 73 20 69 74 20 6f 6e |and writ|es it on|
|00005210| 20 74 68 65 20 6f 75 74 | 70 75 74 20 62 75 66 66 | the out|put buff|
|00005220| 65 72 20 28 77 68 69 63 | 68 20 77 69 6c 6c 20 72 |er (whic|h will r|
|00005230| 65 73 75 6c 74 20 69 6e | 0a 73 74 75 66 66 20 62 |esult in|.stuff b|
|00005240| 65 69 6e 67 20 77 72 69 | 74 74 65 6e 20 6f 6e 74 |eing wri|tten ont|
|00005250| 6f 20 74 68 65 20 7b 5c | 74 74 20 62 62 6c 7d 20 |o the {\|tt bbl} |
|00005260| 66 69 6c 65 20 77 68 65 | 6e 20 74 68 65 20 62 75 |file whe|n the bu|
|00005270| 66 66 65 72 20 66 69 6c | 6c 73 20 75 70 29 2e 0a |ffer fil|ls up)..|
|00005280| 0a 5c 65 6e 64 7b 64 65 | 73 63 72 69 70 74 69 6f |.\end{de|scriptio|
|00005290| 6e 7d 0a 0a 4e 6f 74 65 | 20 74 68 61 74 20 74 68 |n}..Note| that th|
|000052a0| 65 20 62 75 69 6c 74 2d | 69 6e 20 66 75 6e 63 74 |e built-|in funct|
|000052b0| 69 6f 6e 73 20 5c 68 62 | 6f 78 7b 5c 74 74 20 77 |ions \hb|ox{\tt w|
|000052c0| 68 69 6c 65 5c 24 7d 20 | 61 6e 64 20 5c 68 62 6f |hile\$} |and \hbo|
|000052d0| 78 7b 5c 74 74 20 69 66 | 5c 24 7d 0a 72 65 71 75 |x{\tt if|\$}.requ|
|000052e0| 69 72 65 20 74 77 6f 20 | 66 75 6e 63 74 69 6f 6e |ire two |function|
|000052f0| 20 6c 69 74 65 72 61 6c | 73 20 6f 6e 20 74 68 65 | literal|s on the|
|00005300| 20 73 74 61 63 6b 2e 0a | 59 6f 75 20 67 65 74 20 | stack..|You get |
|00005310| 74 68 65 6d 20 74 68 65 | 72 65 20 65 69 74 68 65 |them the|re eithe|
|00005320| 72 20 62 79 20 69 6d 6d | 65 64 69 61 74 65 6c 79 |r by imm|ediately|
|00005330| 20 70 72 65 63 65 64 69 | 6e 67 20 74 68 65 20 6e | precedi|ng the n|
|00005340| 61 6d 65 20 6f 66 20 61 | 20 66 75 6e 63 74 69 6f |ame of a| functio|
|00005350| 6e 0a 62 79 20 61 20 73 | 69 6e 67 6c 65 20 71 75 |n.by a s|ingle qu|
|00005360| 6f 74 65 2c 20 6f 72 2c | 20 69 66 20 79 6f 75 20 |ote, or,| if you |
|00005370| 64 6f 6e 27 74 20 66 65 | 65 6c 20 6c 69 6b 65 20 |don't fe|el like |
|00005380| 64 65 66 69 6e 69 6e 67 | 20 61 20 6e 65 77 20 66 |defining| a new f|
|00005390| 75 6e 63 74 69 6f 6e 20 | 77 69 74 68 0a 74 68 65 |unction |with.the|
|000053a0| 20 5c 68 62 6f 78 7b 5c | 74 74 20 46 55 4e 43 54 | \hbox{\|tt FUNCT|
|000053b0| 49 4f 4e 7d 20 63 6f 6d | 6d 61 6e 64 2c 0a 62 79 |ION} com|mand,.by|
|000053c0| 20 73 69 6d 70 6c 79 20 | 67 69 76 69 6e 67 20 69 | simply |giving i|
|000053d0| 74 73 20 64 65 66 69 6e | 69 74 69 6f 6e 20 28 74 |ts defin|ition (t|
|000053e0| 68 61 74 20 69 73 2c 20 | 67 69 76 69 6e 67 20 77 |hat is, |giving w|
|000053f0| 68 61 74 20 77 6f 75 6c | 64 20 62 65 20 74 68 65 |hat woul|d be the|
|00005400| 20 73 65 63 6f 6e 64 0a | 61 72 67 75 6d 65 6e 74 | second.|argument|
|00005410| 20 74 6f 20 74 68 65 20 | 5c 68 62 6f 78 7b 5c 74 | to the |\hbox{\t|
|00005420| 74 20 46 55 4e 43 54 49 | 4f 4e 7d 20 63 6f 6d 6d |t FUNCTI|ON} comm|
|00005430| 61 6e 64 2c 20 69 6e 63 | 6c 75 64 69 6e 67 20 74 |and, inc|luding t|
|00005440| 68 65 20 73 75 72 72 6f | 75 6e 64 69 6e 67 20 62 |he surro|unding b|
|00005450| 72 61 63 65 73 29 2e 0a | 46 6f 72 20 65 78 61 6d |races)..|For exam|
|00005460| 70 6c 65 20 74 68 65 20 | 66 6f 6c 6c 6f 77 69 6e |ple the |followin|
|00005470| 67 20 66 75 6e 63 74 69 | 6f 6e 20 66 72 61 67 6d |g functi|on fragm|
|00005480| 65 6e 74 20 61 70 70 65 | 6e 64 73 20 74 68 65 20 |ent appe|nds the |
|00005490| 63 68 61 72 61 63 74 65 | 72 20 60 7b 5c 74 74 20 |characte|r `{\tt |
|000054a0| 61 7d 27 0a 69 66 20 74 | 68 65 20 73 74 72 69 6e |a}'.if t|he strin|
|000054b0| 67 20 76 61 72 69 61 62 | 6c 65 20 6e 61 6d 65 64 |g variab|le named|
|000054c0| 20 5c 68 62 6f 78 7b 5c | 74 74 20 6c 61 62 65 6c | \hbox{\|tt label|
|000054d0| 7d 20 69 73 20 6e 6f 6e | 6e 75 6c 6c 3a 0a 5c 62 |} is non|null:.\b|
|000054e0| 65 67 69 6e 7b 76 65 72 | 62 61 74 69 6d 7d 0a 20 |egin{ver|batim}. |
|000054f0| 20 20 20 2e 20 20 2e 20 | 20 2e 0a 20 20 20 20 6c | . . | .. l|
|00005500| 61 62 65 6c 20 22 22 20 | 3d 0a 20 20 20 20 20 20 |abel "" |=. |
|00005510| 27 73 6b 69 70 24 0a 20 | 20 20 20 20 20 7b 20 6c |'skip$. | { l|
|00005520| 61 62 65 6c 20 22 61 22 | 20 2a 20 27 6c 61 62 65 |abel "a"| * 'labe|
|00005530| 6c 20 3a 3d 20 7d 0a 20 | 20 20 20 69 66 24 0a 20 |l := }. | if$. |
|00005540| 20 20 20 2e 20 20 2e 20 | 20 2e 0a 5c 65 6e 64 7b | . . | ..\end{|
|00005550| 76 65 72 62 61 74 69 6d | 7d 0a 41 20 66 75 6e 63 |verbatim|}.A func|
|00005560| 74 69 6f 6e 20 77 68 6f | 73 65 20 6e 61 6d 65 20 |tion who|se name |
|00005570| 79 6f 75 20 71 75 6f 74 | 65 20 6e 65 65 64 6e 27 |you quot|e needn'|
|00005580| 74 20 62 65 20 62 75 69 | 6c 74 20 69 6e 0a 6c 69 |t be bui|lt in.li|
|00005590| 6b 65 20 5c 68 62 6f 78 | 7b 5c 74 74 20 73 6b 69 |ke \hbox|{\tt ski|
|000055a0| 70 5c 24 7d 20 61 62 6f | 76 65 2d 2d 2d 69 74 20 |p\$} abo|ve---it |
|000055b0| 6d 61 79 2c 20 66 6f 72 | 20 65 78 61 6d 70 6c 65 |may, for| example|
|000055c0| 2c 0a 62 65 20 61 20 66 | 69 65 6c 64 20 6e 61 6d |,.be a f|ield nam|
|000055d0| 65 20 6f 72 20 61 20 66 | 75 6e 63 74 69 6f 6e 20 |e or a f|unction |
|000055e0| 79 6f 75 27 76 65 20 64 | 65 66 69 6e 65 64 20 65 |you've d|efined e|
|000055f0| 61 72 6c 69 65 72 2e 0a | 0a 0a 5c 73 75 62 73 65 |arlier..|..\subse|
|00005600| 63 74 69 6f 6e 7b 4e 61 | 6d 65 20 66 6f 72 6d 61 |ction{Na|me forma|
|00005610| 74 74 69 6e 67 7d 0a 0a | 57 68 61 74 27 73 20 69 |tting}..|What's i|
|00005620| 6e 20 61 20 6e 61 6d 65 | 3f 0a 53 65 63 74 69 6f |n a name|?.Sectio|
|00005630| 6e 7e 34 20 70 72 65 74 | 74 79 20 6d 75 63 68 20 |n~4 pret|ty much |
|00005640| 64 65 73 63 72 69 62 65 | 73 20 74 68 69 73 2e 0a |describe|s this..|
|00005650| 45 61 63 68 20 6e 61 6d | 65 20 63 6f 6e 73 69 73 |Each nam|e consis|
|00005660| 74 73 20 6f 66 20 66 6f | 75 72 20 70 61 72 74 73 |ts of fo|ur parts|
|00005670| 3a 20 46 69 72 73 74 2c | 20 76 6f 6e 2c 20 4c 61 |: First,| von, La|
|00005680| 73 74 2c 20 61 6e 64 20 | 4a 72 3b 0a 65 61 63 68 |st, and |Jr;.each|
|00005690| 20 63 6f 6e 73 69 73 74 | 73 20 6f 66 20 61 20 6c | consist|s of a l|
|000056a0| 69 73 74 20 6f 66 20 6e | 61 6d 65 2d 74 6f 6b 65 |ist of n|ame-toke|
|000056b0| 6e 73 2c 0a 61 6e 64 20 | 61 6e 79 20 6c 69 73 74 |ns,.and |any list|
|000056c0| 20 62 75 74 20 4c 61 73 | 74 27 73 20 6d 61 79 20 | but Las|t's may |
|000056d0| 62 65 20 65 6d 70 74 79 | 20 66 6f 72 20 61 20 6e |be empty| for a n|
|000056e0| 6f 6e 6e 75 6c 6c 20 6e | 61 6d 65 2e 0a 54 68 69 |onnull n|ame..Thi|
|000056f0| 73 20 73 75 62 73 65 63 | 74 69 6f 6e 20 64 65 73 |s subsec|tion des|
|00005700| 63 72 69 62 65 73 20 74 | 68 65 20 66 6f 72 6d 61 |cribes t|he forma|
|00005710| 74 20 73 74 72 69 6e 67 | 20 79 6f 75 20 6d 75 73 |t string| you mus|
|00005720| 74 20 73 75 70 70 6c 79 | 20 74 6f 0a 74 68 65 20 |t supply| to.the |
|00005730| 62 75 69 6c 74 2d 69 6e | 20 66 75 6e 63 74 69 6f |built-in| functio|
|00005740| 6e 20 5c 68 62 6f 78 7b | 5c 74 74 20 66 6f 72 6d |n \hbox{|\tt form|
|00005750| 61 74 2e 6e 61 6d 65 5c | 24 7d 2e 0a 0a 4c 65 74 |at.name\|$}...Let|
|00005760| 27 73 20 6c 6f 6f 6b 20 | 61 74 20 61 6e 20 65 78 |'s look |at an ex|
|00005770| 61 6d 70 6c 65 20 6f 66 | 20 61 20 76 65 72 79 20 |ample of| a very |
|00005780| 6c 6f 6e 67 20 6e 61 6d | 65 2e 0a 53 75 70 70 6f |long nam|e..Suppo|
|00005790| 73 65 20 61 20 64 61 74 | 61 62 61 73 65 20 65 6e |se a dat|abase en|
|000057a0| 74 72 79 7e 5c 63 69 74 | 65 7b 70 72 69 6d 65 2d |try~\cit|e{prime-|
|000057b0| 6e 75 6d 62 65 72 2d 74 | 68 65 6f 72 65 6d 7d 20 |number-t|heorem} |
|000057c0| 68 61 73 20 74 68 65 20 | 66 69 65 6c 64 0a 5c 62 |has the |field.\b|
|000057d0| 65 67 69 6e 7b 76 65 72 | 62 61 74 69 6d 7d 0a 20 |egin{ver|batim}. |
|000057e0| 20 61 75 74 68 6f 72 20 | 3d 20 22 43 68 61 72 6c | author |= "Charl|
|000057f0| 65 73 20 4c 6f 75 69 73 | 20 58 61 76 69 65 72 20 |es Louis| Xavier |
|00005800| 4a 6f 73 65 70 68 20 64 | 65 20 6c 61 20 56 61 6c |Joseph d|e la Val|
|00005810| 6c 7b 5c 27 65 7d 65 20 | 50 6f 75 73 73 69 6e 22 |l{\'e}e |Poussin"|
|00005820| 0a 5c 65 6e 64 7b 76 65 | 72 62 61 74 69 6d 7d 0a |.\end{ve|rbatim}.|
|00005830| 61 6e 64 20 73 75 70 70 | 6f 73 65 20 79 6f 75 20 |and supp|ose you |
|00005840| 77 61 6e 74 20 74 68 69 | 73 20 66 6f 72 6d 61 74 |want thi|s format|
|00005850| 74 65 64 20 60 60 6c 61 | 73 74 20 6e 61 6d 65 20 |ted ``la|st name |
|00005860| 63 6f 6d 6d 61 20 69 6e | 69 74 69 61 6c 73 27 27 |comma in|itials''|
|00005870| 24 5c 21 24 2e 0a 49 66 | 20 79 6f 75 20 75 73 65 |$\!$..If| you use|
|00005880| 20 74 68 65 20 66 6f 72 | 6d 61 74 20 73 74 72 69 | the for|mat stri|
|00005890| 6e 67 0a 5c 62 65 67 69 | 6e 7b 76 65 72 62 61 74 |ng.\begi|n{verbat|
|000058a0| 69 6d 7d 0a 20 20 20 20 | 22 7b 76 76 7e 7d 7b 6c |im}. |"{vv~}{l|
|000058b0| 6c 7d 7b 2c 20 6a 6a 7d | 7b 2c 20 66 7d 3f 22 0a |l}{, jj}|{, f}?".|
|000058c0| 5c 65 6e 64 7b 76 65 72 | 62 61 74 69 6d 7d 0a 5c |\end{ver|batim}.\|
|000058d0| 42 69 62 54 65 58 5c 20 | 77 69 6c 6c 20 70 72 6f |BibTeX\ |will pro|
|000058e0| 64 75 63 65 0a 5c 62 65 | 67 69 6e 7b 76 65 72 62 |duce.\be|gin{verb|
|000058f0| 61 74 69 6d 7d 0a 20 20 | 20 20 64 65 7e 6c 61 20 |atim}. | de~la |
|00005900| 56 61 6c 6c 7b 5c 27 65 | 7d 65 7e 50 6f 75 73 73 |Vall{\'e|}e~Pouss|
|00005910| 69 6e 2c 20 43 2e 7e 4c | 2e 20 58 2e 7e 4a 3f 0a |in, C.~L|. X.~J?.|
|00005920| 5c 65 6e 64 7b 76 65 72 | 62 61 74 69 6d 7d 0a 61 |\end{ver|batim}.a|
|00005930| 73 20 74 68 65 20 66 6f | 72 6d 61 74 74 65 64 20 |s the fo|rmatted |
|00005940| 73 74 72 69 6e 67 2e 0a | 0a 4c 65 74 27 73 20 6c |string..|.Let's l|
|00005950| 6f 6f 6b 20 61 74 20 74 | 68 69 73 20 65 78 61 6d |ook at t|his exam|
|00005960| 70 6c 65 20 69 6e 20 64 | 65 74 61 69 6c 2e 0a 54 |ple in d|etail..T|
|00005970| 68 65 72 65 20 61 72 65 | 20 66 6f 75 72 20 62 72 |here are| four br|
|00005980| 61 63 65 2d 6c 65 76 65 | 6c 7e 31 20 7b 5c 65 6d |ace-leve|l~1 {\em|
|00005990| 20 70 69 65 63 65 73 5c | 2f 7d 20 74 6f 20 74 68 | pieces\|/} to th|
|000059a0| 69 73 20 66 6f 72 6d 61 | 74 20 73 74 72 69 6e 67 |is forma|t string|
|000059b0| 2c 0a 6f 6e 65 20 66 6f | 72 20 65 61 63 68 20 70 |,.one fo|r each p|
|000059c0| 61 72 74 20 6f 66 20 61 | 20 6e 61 6d 65 2e 0a 49 |art of a| name..I|
|000059d0| 66 20 74 68 65 20 63 6f | 72 72 65 73 70 6f 6e 64 |f the co|rrespond|
|000059e0| 69 6e 67 20 70 61 72 74 | 20 6f 66 20 61 20 6e 61 |ing part| of a na|
|000059f0| 6d 65 20 69 73 6e 27 74 | 20 70 72 65 73 65 6e 74 |me isn't| present|
|00005a00| 20 28 74 68 65 20 4a 72 | 20 70 61 72 74 20 66 6f | (the Jr| part fo|
|00005a10| 72 20 74 68 69 73 20 6e | 61 6d 65 29 2c 0a 65 76 |r this n|ame),.ev|
|00005a20| 65 72 79 74 68 69 6e 67 | 20 69 6e 20 74 68 61 74 |erything| in that|
|00005a30| 20 70 69 65 63 65 20 69 | 73 20 69 67 6e 6f 72 65 | piece i|s ignore|
|00005a40| 64 2e 0a 41 6e 79 74 68 | 69 6e 67 20 61 74 20 62 |d..Anyth|ing at b|
|00005a50| 72 61 63 65 2d 6c 65 76 | 65 6c 7e 30 20 69 73 20 |race-lev|el~0 is |
|00005a60| 6f 75 74 70 75 74 20 76 | 65 72 62 61 74 69 6d 0a |output v|erbatim.|
|00005a70| 28 74 68 65 20 70 72 65 | 73 75 6d 65 64 20 74 79 |(the pre|sumed ty|
|00005a80| 70 6f 20 60 7b 5c 74 74 | 20 3f 7d 27 20 66 6f 72 |po `{\tt| ?}' for|
|00005a90| 20 74 68 69 73 20 6e 61 | 6d 65 20 69 73 20 61 74 | this na|me is at|
|00005aa0| 20 62 72 61 63 65 2d 6c | 65 76 65 6c 7e 30 29 2c | brace-l|evel~0),|
|00005ab0| 0a 62 75 74 20 79 6f 75 | 20 70 72 6f 62 61 62 6c |.but you| probabl|
|00005ac0| 79 20 77 6f 6e 27 74 20 | 75 73 65 20 74 68 69 73 |y won't |use this|
|00005ad0| 20 66 65 61 74 75 72 65 | 20 6d 75 63 68 2e 0a 0a | feature| much...|
|00005ae0| 57 69 74 68 69 6e 20 65 | 61 63 68 20 70 69 65 63 |Within e|ach piec|
|00005af0| 65 20 61 20 64 6f 75 62 | 6c 65 20 6c 65 74 74 65 |e a doub|le lette|
|00005b00| 72 20 74 65 6c 6c 73 20 | 5c 42 69 62 54 65 58 5c |r tells |\BibTeX\|
|00005b10| 20 74 6f 20 75 73 65 20 | 77 68 6f 6c 65 20 74 6f | to use |whole to|
|00005b20| 6b 65 6e 73 2c 20 61 6e | 64 0a 61 20 73 69 6e 67 |kens, an|d.a sing|
|00005b30| 6c 65 20 6c 65 74 74 65 | 72 2c 20 74 6f 20 61 62 |le lette|r, to ab|
|00005b40| 62 72 65 76 69 61 74 65 | 20 74 68 65 6d 20 28 74 |breviate| them (t|
|00005b50| 68 65 73 65 20 6c 65 74 | 74 65 72 73 20 6d 75 73 |hese let|ters mus|
|00005b60| 74 20 62 65 20 61 74 20 | 62 72 61 63 65 2d 6c 65 |t be at |brace-le|
|00005b70| 76 65 6c 7e 31 29 3b 0a | 65 76 65 72 79 74 68 69 |vel~1);.|everythi|
|00005b80| 6e 67 20 65 6c 73 65 20 | 77 69 74 68 69 6e 20 74 |ng else |within t|
|00005b90| 68 65 20 70 69 65 63 65 | 20 69 73 20 75 73 65 64 |he piece| is used|
|00005ba0| 20 76 65 72 62 61 74 69 | 6d 0a 28 77 65 6c 6c 2c | verbati|m.(well,|
|00005bb0| 20 61 6c 6d 6f 73 74 20 | 65 76 65 72 79 74 68 69 | almost |everythi|
|00005bc0| 6e 67 2d 2d 2d 72 65 61 | 64 20 6f 6e 29 2e 0a 54 |ng---rea|d on)..T|
|00005bd0| 68 65 20 74 69 65 20 61 | 74 20 74 68 65 20 65 6e |he tie a|t the en|
|00005be0| 64 20 6f 66 20 74 68 65 | 20 76 6f 6e 20 70 61 72 |d of the| von par|
|00005bf0| 74 20 28 69 6e 20 5c 68 | 62 6f 78 7b 5c 76 65 72 |t (in \h|box{\ver|
|00005c00| 62 7c 7b 76 76 7e 7d 7c | 7d 29 0a 69 73 20 61 20 |b|{vv~}||}).is a |
|00005c10| 64 69 73 63 72 65 74 69 | 6f 6e 61 72 79 20 74 69 |discreti|onary ti|
|00005c20| 65 2d 2d 2d 5c 42 69 62 | 54 65 58 5c 20 77 69 6c |e---\Bib|TeX\ wil|
|00005c30| 6c 20 6f 75 74 70 75 74 | 20 61 20 74 69 65 20 61 |l output| a tie a|
|00005c40| 74 20 74 68 61 74 20 70 | 6f 69 6e 74 0a 69 66 20 |t that p|oint.if |
|00005c50| 69 74 20 74 68 69 6e 6b | 73 20 74 68 65 72 65 27 |it think|s there'|
|00005c60| 73 20 61 20 6e 65 65 64 | 20 66 6f 72 20 6f 6e 65 |s a need| for one|
|00005c70| 3b 0a 6f 74 68 65 72 77 | 69 73 65 20 69 74 20 77 |;.otherw|ise it w|
|00005c80| 69 6c 6c 20 6f 75 74 70 | 75 74 20 61 20 73 70 61 |ill outp|ut a spa|
|00005c90| 63 65 2e 0a 49 66 20 79 | 6f 75 20 72 65 61 6c 6c |ce..If y|ou reall|
|00005ca0| 79 2c 20 72 65 61 6c 6c | 79 2c 20 77 61 6e 74 20 |y, reall|y, want |
|00005cb0| 61 20 74 69 65 20 74 68 | 65 72 65 2c 0a 72 65 67 |a tie th|ere,.reg|
|00005cc0| 61 72 64 6c 65 73 73 20 | 6f 66 20 77 68 61 74 20 |ardless |of what |
|00005cd0| 5c 42 69 62 54 65 58 5c | 20 74 68 69 6e 6b 73 2c |\BibTeX\| thinks,|
|00005ce0| 20 75 73 65 20 74 77 6f | 20 6f 66 20 74 68 65 6d | use two| of them|
|00005cf0| 0a 28 6f 6e 6c 79 20 6f | 6e 65 20 77 69 6c 6c 20 |.(only o|ne will |
|00005d00| 62 65 20 6f 75 74 70 75 | 74 29 3b 20 74 68 61 74 |be outpu|t); that|
|00005d10| 20 69 73 2c 20 75 73 65 | 20 5c 68 62 6f 78 7b 5c | is, use| \hbox{\|
|00005d20| 76 65 72 62 7c 7b 76 76 | 7e 7e 7d 7c 7d 2e 0a 41 |verb|{vv|~~}|}..A|
|00005d30| 20 74 69 65 20 69 73 20 | 64 69 73 63 72 65 74 69 | tie is |discreti|
|00005d40| 6f 6e 61 72 79 20 6f 6e | 6c 79 20 69 66 20 69 74 |onary on|ly if it|
|00005d50| 27 73 20 74 68 65 20 6c | 61 73 74 20 63 68 61 72 |'s the l|ast char|
|00005d60| 61 63 74 65 72 20 6f 66 | 20 74 68 65 20 70 69 65 |acter of| the pie|
|00005d70| 63 65 3b 0a 61 6e 79 77 | 68 65 72 65 20 65 6c 73 |ce;.anyw|here els|
|00005d80| 65 20 69 74 27 73 20 74 | 72 65 61 74 65 64 20 61 |e it's t|reated a|
|00005d90| 73 20 61 6e 20 6f 72 64 | 69 6e 61 72 79 20 63 68 |s an ord|inary ch|
|00005da0| 61 72 61 63 74 65 72 2e | 0a 0a 5c 42 69 62 54 65 |aracter.|..\BibTe|
|00005db0| 58 5c 20 70 75 74 73 20 | 64 65 66 61 75 6c 74 20 |X\ puts |default |
|00005dc0| 73 74 72 69 6e 67 73 20 | 7b 5c 65 6d 20 62 65 74 |strings |{\em bet|
|00005dd0| 77 65 65 6e 5c 2f 7d 20 | 74 6f 6b 65 6e 73 20 6f |ween\/} |tokens o|
|00005de0| 66 20 61 20 6e 61 6d 65 | 20 70 61 72 74 3a 0a 46 |f a name| part:.F|
|00005df0| 6f 72 20 77 68 6f 6c 65 | 20 74 6f 6b 65 6e 73 20 |or whole| tokens |
|00005e00| 69 74 20 75 73 65 73 20 | 65 69 74 68 65 72 20 61 |it uses |either a|
|00005e10| 20 73 70 61 63 65 20 6f | 72 20 61 20 74 69 65 2c | space o|r a tie,|
|00005e20| 0a 64 65 70 65 6e 64 69 | 6e 67 20 6f 6e 20 77 68 |.dependi|ng on wh|
|00005e30| 69 63 68 20 6f 6e 65 20 | 69 74 20 74 68 69 6e 6b |ich one |it think|
|00005e40| 73 20 69 73 20 62 65 73 | 74 2c 0a 61 6e 64 20 66 |s is bes|t,.and f|
|00005e50| 6f 72 20 61 62 62 72 65 | 76 69 61 74 65 64 20 74 |or abbre|viated t|
|00005e60| 6f 6b 65 6e 73 20 69 74 | 20 75 73 65 73 20 61 20 |okens it| uses a |
|00005e70| 70 65 72 69 6f 64 20 66 | 6f 6c 6c 6f 77 65 64 20 |period f|ollowed |
|00005e80| 62 79 0a 65 69 74 68 65 | 72 20 61 20 73 70 61 63 |by.eithe|r a spac|
|00005e90| 65 20 6f 72 20 61 20 74 | 69 65 2e 0a 48 6f 77 65 |e or a t|ie..Howe|
|00005ea0| 76 65 72 20 69 74 20 64 | 6f 65 73 6e 27 74 20 75 |ver it d|oesn't u|
|00005eb0| 73 65 20 74 68 69 73 20 | 64 65 66 61 75 6c 74 20 |se this |default |
|00005ec0| 73 74 72 69 6e 67 20 61 | 66 74 65 72 20 74 68 65 |string a|fter the|
|00005ed0| 20 6c 61 73 74 20 74 6f | 6b 65 6e 20 69 6e 20 61 | last to|ken in a|
|00005ee0| 20 6c 69 73 74 3b 0a 68 | 65 6e 63 65 20 74 68 65 | list;.h|ence the|
|00005ef0| 72 65 27 73 20 6e 6f 20 | 70 65 72 69 6f 64 20 66 |re's no |period f|
|00005f00| 6f 6c 6c 6f 77 69 6e 67 | 20 74 68 65 20 60 4a 27 |ollowing| the `J'|
|00005f10| 20 66 6f 72 20 6f 75 72 | 20 65 78 61 6d 70 6c 65 | for our| example|
|00005f20| 2e 0a 59 6f 75 20 73 68 | 6f 75 6c 64 20 68 61 76 |..You sh|ould hav|
|00005f30| 65 20 75 73 65 64 0a 5c | 62 65 67 69 6e 7b 76 65 |e used.\|begin{ve|
|00005f40| 72 62 61 74 69 6d 7d 0a | 20 20 20 20 22 7b 76 76 |rbatim}.| "{vv|
|00005f50| 7e 7d 7b 6c 6c 7d 7b 2c | 20 6a 6a 7d 7b 2c 20 66 |~}{ll}{,| jj}{, f|
|00005f60| 2e 7d 22 0a 5c 65 6e 64 | 7b 76 65 72 62 61 74 69 |.}".\end|{verbati|
|00005f70| 6d 7d 0a 74 6f 20 67 65 | 74 20 5c 42 69 62 54 65 |m}.to ge|t \BibTe|
|00005f80| 58 5c 20 74 6f 20 70 72 | 6f 64 75 63 65 20 74 68 |X\ to pr|oduce th|
|00005f90| 65 20 73 61 6d 65 20 66 | 6f 72 6d 61 74 74 65 64 |e same f|ormatted|
|00005fa0| 20 73 74 72 69 6e 67 20 | 62 75 74 20 77 69 74 68 | string |but with|
|00005fb0| 20 74 68 65 20 71 75 65 | 73 74 69 6f 6e 0a 6d 61 | the que|stion.ma|
|00005fc0| 72 6b 20 72 65 70 6c 61 | 63 65 64 20 62 79 20 61 |rk repla|ced by a|
|00005fd0| 20 70 65 72 69 6f 64 2e | 0a 4e 6f 74 65 20 74 68 | period.|.Note th|
|00005fe0| 61 74 20 74 68 65 20 70 | 65 72 69 6f 64 20 73 68 |at the p|eriod sh|
|00005ff0| 6f 75 6c 64 20 67 6f 20 | 69 6e 73 69 64 65 20 74 |ould go |inside t|
|00006000| 68 65 20 46 69 72 73 74 | 2d 6e 61 6d 65 20 70 69 |he First|-name pi|
|00006010| 65 63 65 2c 0a 72 61 74 | 68 65 72 20 74 68 61 6e |ece,.rat|her than|
|00006020| 20 77 68 65 72 65 20 74 | 68 65 20 71 75 65 73 74 | where t|he quest|
|00006030| 69 6f 6e 20 6d 61 72 6b | 20 77 61 73 2c 20 69 6e |ion mark| was, in|
|00006040| 20 63 61 73 65 20 61 20 | 6e 61 6d 65 20 68 61 73 | case a |name has|
|00006050| 20 6e 6f 20 46 69 72 73 | 74 20 70 61 72 74 2e 0a | no Firs|t part..|
|00006060| 0a 49 66 20 79 6f 75 20 | 77 61 6e 74 20 74 6f 20 |.If you |want to |
|00006070| 6f 76 65 72 72 69 64 65 | 20 5c 42 69 62 54 65 58 |override| \BibTeX|
|00006080| 27 73 20 64 65 66 61 75 | 6c 74 20 62 65 74 77 65 |'s defau|lt betwe|
|00006090| 65 6e 2d 74 6f 6b 65 6e | 20 73 74 72 69 6e 67 73 |en-token| strings|
|000060a0| 2c 20 79 6f 75 0a 6d 75 | 73 74 20 65 78 70 6c 69 |, you.mu|st expli|
|000060b0| 63 69 74 6c 79 20 73 70 | 65 63 69 66 79 20 61 20 |citly sp|ecify a |
|000060c0| 73 74 72 69 6e 67 2e 0a | 46 6f 72 20 65 78 61 6d |string..|For exam|
|000060d0| 70 6c 65 20 73 75 70 70 | 6f 73 65 20 79 6f 75 20 |ple supp|ose you |
|000060e0| 77 61 6e 74 20 61 20 6c | 61 62 65 6c 20 74 6f 20 |want a l|abel to |
|000060f0| 63 6f 6e 74 61 69 6e 20 | 74 68 65 20 66 69 72 73 |contain |the firs|
|00006100| 74 20 6c 65 74 74 65 72 | 20 66 72 6f 6d 20 65 61 |t letter| from ea|
|00006110| 63 68 0a 74 6f 6b 65 6e | 20 69 6e 20 74 68 65 20 |ch.token| in the |
|00006120| 76 6f 6e 20 61 6e 64 20 | 4c 61 73 74 20 70 61 72 |von and |Last par|
|00006130| 74 73 2c 20 77 69 74 68 | 20 6e 6f 20 73 70 61 63 |ts, with| no spac|
|00006140| 65 73 3b 0a 79 6f 75 20 | 73 68 6f 75 6c 64 20 75 |es;.you |should u|
|00006150| 73 65 20 74 68 65 20 66 | 6f 72 6d 61 74 20 73 74 |se the f|ormat st|
|00006160| 72 69 6e 67 0a 5c 62 65 | 67 69 6e 7b 76 65 72 62 |ring.\be|gin{verb|
|00006170| 61 74 69 6d 7d 0a 20 20 | 20 20 22 7b 76 7b 7d 7d |atim}. | "{v{}}|
|00006180| 7b 6c 7b 7d 7d 22 0a 5c | 65 6e 64 7b 76 65 72 62 |{l{}}".\|end{verb|
|00006190| 61 74 69 6d 7d 0a 73 6f | 20 74 68 61 74 20 5c 42 |atim}.so| that \B|
|000061a0| 69 62 54 65 58 5c 20 77 | 69 6c 6c 20 70 72 6f 64 |ibTeX\ w|ill prod|
|000061b0| 75 63 65 20 60 7b 5c 74 | 74 20 64 6c 56 50 7d 27 |uce `{\t|t dlVP}'|
|000061c0| 20 61 73 20 74 68 65 20 | 66 6f 72 6d 61 74 74 65 | as the |formatte|
|000061d0| 64 20 73 74 72 69 6e 67 | 2e 0a 59 6f 75 20 6d 75 |d string|..You mu|
|000061e0| 73 74 20 67 69 76 65 20 | 61 20 73 74 72 69 6e 67 |st give |a string|
|000061f0| 20 66 6f 72 20 65 61 63 | 68 20 70 69 65 63 65 20 | for eac|h piece |
|00006200| 77 68 6f 73 65 20 64 65 | 66 61 75 6c 74 20 79 6f |whose de|fault yo|
|00006210| 75 20 77 61 6e 74 20 6f | 76 65 72 72 69 64 64 65 |u want o|verridde|
|00006220| 6e 0a 28 74 68 65 20 65 | 78 61 6d 70 6c 65 20 68 |n.(the e|xample h|
|00006230| 65 72 65 20 75 73 65 73 | 20 74 68 65 20 6e 75 6c |ere uses| the nul|
|00006240| 6c 20 73 74 72 69 6e 67 | 20 66 6f 72 20 62 6f 74 |l string| for bot|
|00006250| 68 20 70 69 65 63 65 73 | 29 2c 20 61 6e 64 20 74 |h pieces|), and t|
|00006260| 68 69 73 20 73 74 72 69 | 6e 67 0a 6d 75 73 74 20 |his stri|ng.must |
|00006270| 69 6d 6d 65 64 69 61 74 | 65 6c 79 20 66 6f 6c 6c |immediat|ely foll|
|00006280| 6f 77 20 65 69 74 68 65 | 72 20 74 68 65 20 73 69 |ow eithe|r the si|
|00006290| 6e 67 6c 65 20 6f 72 20 | 64 6f 75 62 6c 65 20 6c |ngle or |double l|
|000062a0| 65 74 74 65 72 20 66 6f | 72 20 74 68 65 20 70 69 |etter fo|r the pi|
|000062b0| 65 63 65 2e 0a 59 6f 75 | 20 6d 61 79 20 6e 6f 74 |ece..You| may not|
|000062c0| 20 68 61 76 65 20 61 6e | 79 20 6f 74 68 65 72 20 | have an|y other |
|000062d0| 6c 65 74 74 65 72 73 20 | 61 74 20 62 72 61 63 65 |letters |at brace|
|000062e0| 2d 6c 65 76 65 6c 7e 31 | 20 69 6e 20 74 68 65 20 |-level~1| in the |
|000062f0| 66 6f 72 6d 61 74 20 73 | 74 72 69 6e 67 2e 0a 0a |format s|tring...|
|00006300| 5c 62 69 62 6c 69 6f 67 | 72 61 70 68 79 7b 62 74 |\bibliog|raphy{bt|
|00006310| 78 64 6f 63 7d 0a 5c 62 | 69 62 6c 69 6f 67 72 61 |xdoc}.\b|ibliogra|
|00006320| 70 68 79 73 74 79 6c 65 | 7b 70 6c 61 69 6e 7d 0a |phystyle|{plain}.|
|00006330| 5c 65 6e 64 7b 64 6f 63 | 75 6d 65 6e 74 7d 0a |\end{doc|ument}. |
+--------+-------------------------+-------------------------+--------+--------+
