home *** CD-ROM | disk | FTP | other *** search
open in: 
MacOS 8.1
|
Win98
|
DOS
view JSON data
|
view as text
This file was processed as: LaTeX Document
(document/latex).
You can browse this item here: btxhak.tex
| Confidence | Program | Detection | Match Type | Support
|
|---|
| 100%
| dexvert
| LaTeX Document (document/latex)
| magic
| Supported |
| 1%
| dexvert
| Corel 10 Texture (image/corel10Texture)
| ext
| Unsupported |
| 1%
| dexvert
| Croteam texture file (image/croteamTextureFile)
| ext
| Unsupported |
| 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%
| siegfried
| fmt/281 LaTeX (Subdocument)
| 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 09 09 09 |n-.08em\|TeX\....|
|000000f0| 09 09 09 09 09 09 53 74 | 79 6c 65 73 7d 0a 5c 61 |......St|yles}.\a|
|00000100| 75 74 68 6f 72 7b 4f 72 | 65 6e 20 50 61 74 61 73 |uthor{Or|en Patas|
|00000110| 68 6e 69 6b 7d 0a 5c 64 | 61 74 65 7b 46 65 62 72 |hnik}.\d|ate{Febr|
|00000120| 75 61 72 79 20 38 2c 20 | 31 39 38 38 7d 0a 0a 5c |uary 8, |1988}..\|
|00000130| 64 6f 63 75 6d 65 6e 74 | 73 74 79 6c 65 7b 61 72 |document|style{ar|
|00000140| 74 69 63 6c 65 7d 0a 5c | 62 65 67 69 6e 7b 64 6f |ticle}.\|begin{do|
|00000150| 63 75 6d 65 6e 74 7d 0a | 0a 5c 6d 61 6b 65 74 69 |cument}.|.\maketi|
|00000160| 74 6c 65 0a 0a 5c 73 65 | 74 63 6f 75 6e 74 65 72 |tle..\se|tcounter|
|00000170| 7b 73 65 63 74 69 6f 6e | 7d 7b 34 7d 0a 5c 73 65 |{section|}{4}.\se|
|00000180| 63 74 69 6f 6e 7b 42 69 | 62 6c 69 6f 67 72 61 70 |ction{Bi|bliograp|
|00000190| 68 79 2d 73 74 79 6c 65 | 20 68 61 63 6b 69 6e 67 |hy-style| hacking|
|000001a0| 7d 0a 5c 6c 61 62 65 6c | 7b 73 74 79 6c 65 7d 0a |}.\label|{style}.|
|000001b0| 0a 54 68 69 73 20 64 6f | 63 75 6d 65 6e 74 20 73 |.This do|cument s|
|000001c0| 74 61 72 74 73 20 28 61 | 6e 64 20 65 6e 64 73 29 |tarts (a|nd ends)|
|000001d0| 20 77 69 74 68 20 53 65 | 63 74 69 6f 6e 7e 5c 72 | with Se|ction~\r|
|000001e0| 65 66 7b 73 74 79 6c 65 | 7d 2c 0a 62 65 63 61 75 |ef{style|},.becau|
|000001f0| 73 65 20 69 6e 20 72 65 | 61 6c 69 74 79 20 69 74 |se in re|ality it|
|00000200| 20 69 73 20 74 68 65 20 | 66 69 6e 61 6c 20 73 65 | is the |final se|
|00000210| 63 74 69 6f 6e 20 6f 66 | 20 60 60 5c 42 69 62 54 |ction of| ``\BibT|
|00000220| 65 58 20 69 6e 67 27 27 | 7e 5c 63 69 74 65 7b 62 |eX ing''|~\cite{b|
|00000230| 74 78 64 6f 63 7d 2c 0a | 74 68 65 20 67 65 6e 65 |txdoc},.|the gene|
|00000240| 72 61 6c 20 64 6f 63 75 | 6d 65 6e 74 61 74 69 6f |ral docu|mentatio|
|00000250| 6e 20 66 6f 72 20 5c 42 | 69 62 54 65 58 2e 0a 42 |n for \B|ibTeX..B|
|00000260| 75 74 20 74 68 61 74 20 | 64 6f 63 75 6d 65 6e 74 |ut that |document|
|00000270| 20 77 61 73 20 6d 65 61 | 6e 74 20 66 6f 72 20 61 | was mea|nt for a|
|00000280| 6c 6c 20 5c 42 69 62 54 | 65 58 5c 20 75 73 65 72 |ll \BibT|eX\ user|
|00000290| 73 2c 0a 77 68 69 6c 65 | 20 74 68 69 73 20 6f 6e |s,.while| this on|
|000002a0| 65 20 69 73 20 6a 75 73 | 74 20 66 6f 72 20 73 74 |e is jus|t for st|
|000002b0| 79 6c 65 20 64 65 73 69 | 67 6e 65 72 73 2c 0a 73 |yle desi|gners,.s|
|000002c0| 6f 20 74 68 65 20 74 77 | 6f 20 61 72 65 20 70 68 |o the tw|o are ph|
|000002d0| 79 73 69 63 61 6c 6c 79 | 20 73 65 70 61 72 61 74 |ysically| separat|
|000002e0| 65 2e 0a 53 74 69 6c 6c | 2c 20 79 6f 75 20 73 68 |e..Still|, you sh|
|000002f0| 6f 75 6c 64 20 62 65 20 | 63 6f 6d 70 6c 65 74 65 |ould be |complete|
|00000300| 6c 79 20 66 61 6d 69 6c | 69 61 72 20 77 69 74 68 |ly famil|iar with|
|00000310| 20 60 60 5c 42 69 62 54 | 65 58 20 69 6e 67 27 27 | ``\BibT|eX ing''|
|00000320| 24 5c 21 24 2c 0a 61 6e | 64 20 61 6c 6c 20 72 65 |$\!$,.an|d all re|
|00000330| 66 65 72 65 6e 63 65 73 | 20 69 6e 20 74 68 69 73 |ferences| in this|
|00000340| 20 64 6f 63 75 6d 65 6e | 74 0a 74 6f 20 73 65 63 | documen|t.to sec|
|00000350| 74 69 6f 6e 73 20 61 6e | 64 20 73 65 63 74 69 6f |tions an|d sectio|
|00000360| 6e 20 6e 75 6d 62 65 72 | 73 0a 61 73 73 75 6d 65 |n number|s.assume|
|00000370| 20 74 68 61 74 20 74 68 | 65 20 74 77 6f 20 64 6f | that th|e two do|
|00000380| 63 75 6d 65 6e 74 73 20 | 61 72 65 20 6f 6e 65 2e |cuments |are one.|
|00000390| 0a 0a 54 68 69 73 20 73 | 65 63 74 69 6f 6e 2c 0a |..This s|ection,.|
|000003a0| 61 6c 6f 6e 67 20 77 69 | 74 68 20 74 68 65 20 73 |along wi|th the s|
|000003b0| 74 61 6e 64 61 72 64 2d | 73 74 79 6c 65 20 64 6f |tandard-|style do|
|000003c0| 63 75 6d 65 6e 74 61 74 | 69 6f 6e 20 66 69 6c 65 |cumentat|ion file|
|000003d0| 20 5c 68 62 6f 78 7b 5c | 74 74 20 62 74 78 62 73 | \hbox{\|tt btxbs|
|000003e0| 74 2e 64 6f 63 7d 2c 0a | 73 68 6f 75 6c 64 20 65 |t.doc},.|should e|
|000003f0| 78 70 6c 61 69 6e 20 68 | 6f 77 20 74 6f 20 6d 6f |xplain h|ow to mo|
|00000400| 64 69 66 79 0a 65 78 69 | 73 74 69 6e 67 20 73 74 |dify.exi|sting st|
|00000410| 79 6c 65 20 66 69 6c 65 | 73 20 61 6e 64 20 74 6f |yle file|s and to|
|00000420| 20 70 72 6f 64 75 63 65 | 20 6e 65 77 20 6f 6e 65 | produce| new one|
|00000430| 73 2e 0a 49 66 20 79 6f | 75 27 72 65 20 61 20 73 |s..If yo|u're a s|
|00000440| 65 72 69 6f 75 73 20 73 | 74 79 6c 65 20 68 61 63 |erious s|tyle hac|
|00000450| 6b 65 72 20 79 6f 75 20 | 73 68 6f 75 6c 64 20 62 |ker you |should b|
|00000460| 65 20 66 61 6d 69 6c 69 | 61 72 0a 77 69 74 68 20 |e famili|ar.with |
|00000470| 76 61 6e 7e 4c 65 75 6e | 65 6e 7e 5c 63 69 74 65 |van~Leun|en~\cite|
|00000480| 7b 76 61 6e 2d 6c 65 75 | 6e 65 6e 7d 20 66 6f 72 |{van-leu|nen} for|
|00000490| 20 70 6f 69 6e 74 73 20 | 6f 66 20 73 74 79 6c 65 | points |of style|
|000004a0| 2c 0a 77 69 74 68 20 4c | 61 6d 70 6f 72 74 7e 5c |,.with L|amport~\|
|000004b0| 63 69 74 65 7b 6c 61 74 | 65 78 7d 20 61 6e 64 20 |cite{lat|ex} and |
|000004c0| 4b 6e 75 74 68 7e 5c 63 | 69 74 65 7b 74 65 78 62 |Knuth~\c|ite{texb|
|000004d0| 6f 6f 6b 7d 20 66 6f 72 | 20 66 6f 72 6d 61 74 74 |ook} for| formatt|
|000004e0| 69 6e 67 20 6d 61 74 74 | 65 72 73 2c 0a 61 6e 64 |ing matt|ers,.and|
|000004f0| 20 70 65 72 68 61 70 73 | 20 77 69 74 68 20 7b 5c | perhaps| with {\|
|00000500| 65 6d 20 53 63 72 69 62 | 65 5c 2f 7d 7e 5c 63 69 |em Scrib|e\/}~\ci|
|00000510| 74 65 7b 73 63 72 69 62 | 65 7d 20 66 6f 72 20 63 |te{scrib|e} for c|
|00000520| 6f 6d 70 61 74 69 62 69 | 6c 69 74 79 20 64 65 74 |ompatibi|lity det|
|00000530| 61 69 6c 73 2e 0a 41 6e | 64 20 77 68 69 6c 65 20 |ails..An|d while |
|00000540| 79 6f 75 27 72 65 20 61 | 74 20 69 74 2c 20 69 66 |you're a|t it, if|
|00000550| 20 79 6f 75 20 64 6f 6e | 27 74 20 72 65 61 64 20 | you don|'t read |
|00000560| 74 68 65 20 67 72 65 61 | 74 20 6c 69 74 74 6c 65 |the grea|t little|
|00000570| 20 62 6f 6f 6b 20 62 79 | 20 53 74 72 75 6e 6b 20 | book by| Strunk |
|00000580| 61 6e 64 0a 57 68 69 74 | 65 7e 5c 63 69 74 65 7b |and.Whit|e~\cite{|
|00000590| 73 74 72 75 6e 6b 2d 61 | 6e 64 2d 77 68 69 74 65 |strunk-a|nd-white|
|000005a0| 7d 2c 20 79 6f 75 20 73 | 68 6f 75 6c 64 20 61 74 |}, you s|hould at|
|000005b0| 20 6c 65 61 73 74 20 6c | 6f 6f 6b 20 61 74 20 69 | least l|ook at i|
|000005c0| 74 73 0a 65 6e 74 72 69 | 65 73 20 69 6e 20 74 68 |ts.entri|es in th|
|000005d0| 65 20 64 61 74 61 62 61 | 73 65 20 61 6e 64 20 74 |e databa|se and t|
|000005e0| 68 65 20 72 65 66 65 72 | 65 6e 63 65 20 6c 69 73 |he refer|ence lis|
|000005f0| 74 0a 74 6f 20 73 65 65 | 20 68 6f 77 20 5c 42 69 |t.to see| how \Bi|
|00000600| 62 54 65 58 5c 20 68 61 | 6e 64 6c 65 73 20 6d 75 |bTeX\ ha|ndles mu|
|00000610| 6c 74 69 70 6c 65 20 6e | 61 6d 65 73 2e 0a 0a 54 |ltiple n|ames...T|
|00000620| 6f 20 63 72 65 61 74 65 | 20 61 20 6e 65 77 20 73 |o create| a new s|
|00000630| 74 79 6c 65 2c 0a 69 74 | 27 73 20 62 65 73 74 20 |tyle,.it|'s best |
|00000640| 74 6f 20 73 74 61 72 74 | 20 77 69 74 68 20 61 6e |to start| with an|
|00000650| 20 65 78 69 73 74 69 6e | 67 20 73 74 79 6c 65 20 | existin|g style |
|00000660| 74 68 61 74 27 73 20 63 | 6c 6f 73 65 20 74 6f 20 |that's c|lose to |
|00000670| 79 6f 75 72 73 2c 0a 61 | 6e 64 20 74 68 65 6e 20 |yours,.a|nd then |
|00000680| 6d 6f 64 69 66 79 20 74 | 68 61 74 2e 0a 54 68 69 |modify t|hat..Thi|
|00000690| 73 20 69 73 20 74 72 75 | 65 20 65 76 65 6e 20 69 |s is tru|e even i|
|000006a0| 66 20 79 6f 75 27 72 65 | 20 73 69 6d 70 6c 79 20 |f you're| simply |
|000006b0| 75 70 64 61 74 69 6e 67 | 20 61 6e 20 6f 6c 64 20 |updating| an old |
|000006c0| 73 74 79 6c 65 0a 66 6f | 72 20 5c 42 69 62 54 65 |style.fo|r \BibTe|
|000006d0| 58 5c 20 76 65 72 73 69 | 6f 6e 20 30 2e 39 39 0a |X\ versi|on 0.99.|
|000006e0| 28 49 27 76 65 20 75 70 | 64 61 74 65 64 20 66 6f |(I've up|dated fo|
|000006f0| 75 72 20 6e 6f 6e 73 74 | 61 6e 64 61 72 64 20 73 |ur nonst|andard s|
|00000700| 74 79 6c 65 73 2c 0a 73 | 6f 20 49 20 73 61 79 20 |tyles,.s|o I say |
|00000710| 74 68 69 73 20 77 69 74 | 68 20 73 6f 6d 65 20 65 |this wit|h some e|
|00000720| 78 70 65 72 69 65 6e 63 | 65 29 2e 0a 49 66 20 79 |xperienc|e)..If y|
|00000730| 6f 75 20 77 61 6e 74 20 | 74 6f 20 69 6e 73 65 72 |ou want |to inser|
|00000740| 74 20 69 6e 74 6f 20 61 | 20 6e 65 77 20 73 74 79 |t into a| new sty|
|00000750| 6c 65 0a 73 6f 6d 65 20 | 66 75 6e 63 74 69 6f 6e |le.some |function|
|00000760| 20 79 6f 75 27 64 20 77 | 72 69 74 74 65 6e 20 66 | you'd w|ritten f|
|00000770| 6f 72 20 61 6e 20 6f 6c | 64 20 28 76 65 72 73 69 |or an ol|d (versi|
|00000780| 6f 6e 20 30 2e 39 38 69 | 29 20 73 74 79 6c 65 2c |on 0.98i|) style,|
|00000790| 0a 6b 65 65 70 20 69 6e | 20 6d 69 6e 64 20 74 68 |.keep in| mind th|
|000007a0| 61 74 20 74 68 65 20 6f | 72 64 65 72 20 6f 66 20 |at the o|rder of |
|000007b0| 74 68 65 20 61 72 67 75 | 6d 65 6e 74 73 20 74 6f |the argu|ments to|
|000007c0| 0a 74 68 65 20 61 73 73 | 69 67 6e 6d 65 6e 74 20 |.the ass|ignment |
|000007d0| 28 7b 5c 74 74 20 3a 3d | 7d 29 20 66 75 6e 63 74 |({\tt :=|}) funct|
|000007e0| 69 6f 6e 20 68 61 73 20 | 62 65 65 6e 20 72 65 76 |ion has |been rev|
|000007f0| 65 72 73 65 64 2e 0a 57 | 68 65 6e 20 79 6f 75 27 |ersed..W|hen you'|
|00000800| 72 65 20 66 69 6e 69 73 | 68 65 64 20 77 69 74 68 |re finis|hed with|
|00000810| 20 79 6f 75 72 20 73 74 | 79 6c 65 2c 0a 79 6f 75 | your st|yle,.you|
|00000820| 20 6d 61 79 20 77 61 6e | 74 20 74 6f 20 74 72 79 | may wan|t to try|
|00000830| 20 72 75 6e 6e 69 6e 67 | 20 69 74 20 6f 6e 20 74 | running| it on t|
|00000840| 68 65 20 65 6e 74 69 72 | 65 20 5c 68 62 6f 78 7b |he entir|e \hbox{|
|00000850| 5c 74 74 20 58 41 4d 50 | 4c 2e 42 49 42 7d 20 64 |\tt XAMP|L.BIB} d|
|00000860| 61 74 61 62 61 73 65 0a | 74 6f 20 6d 61 6b 65 20 |atabase.|to make |
|00000870| 73 75 72 65 20 69 74 20 | 68 61 6e 64 6c 65 73 20 |sure it |handles |
|00000880| 61 6c 6c 20 74 68 65 20 | 73 74 61 6e 64 61 72 64 |all the |standard|
|00000890| 20 65 6e 74 72 79 20 74 | 79 70 65 73 2e 0a 0a 49 | entry t|ypes...I|
|000008a0| 66 20 79 6f 75 20 66 69 | 6e 64 20 61 6e 79 20 62 |f you fi|nd any b|
|000008b0| 75 67 73 20 69 6e 20 74 | 68 65 20 73 74 61 6e 64 |ugs in t|he stand|
|000008c0| 61 72 64 20 73 74 79 6c | 65 73 2c 0a 6f 72 20 69 |ard styl|es,.or i|
|000008d0| 66 20 74 68 65 72 65 20 | 61 72 65 20 74 68 69 6e |f there |are thin|
|000008e0| 67 73 20 79 6f 75 27 64 | 20 6c 69 6b 65 20 74 6f |gs you'd| like to|
|000008f0| 20 64 6f 0a 77 69 74 68 | 20 62 69 62 6c 69 6f 67 | do.with| bibliog|
|00000900| 72 61 70 68 79 2d 73 74 | 79 6c 65 20 66 69 6c 65 |raphy-st|yle file|
|00000910| 73 20 62 75 74 20 63 61 | 6e 27 74 2c 0a 70 6c 65 |s but ca|n't,.ple|
|00000920| 61 73 65 20 63 6f 6d 70 | 6c 61 69 6e 20 74 6f 20 |ase comp|lain to |
|00000930| 4f 72 65 6e 20 50 61 74 | 61 73 68 6e 69 6b 2e 0a |Oren Pat|ashnik..|
|00000940| 0a 0a 5c 73 75 62 73 65 | 63 74 69 6f 6e 7b 47 65 |..\subse|ction{Ge|
|00000950| 6e 65 72 61 6c 20 64 65 | 73 63 72 69 70 74 69 6f |neral de|scriptio|
|00000960| 6e 7d 0a 0a 59 6f 75 20 | 77 72 69 74 65 20 62 69 |n}..You |write bi|
|00000970| 62 6c 69 6f 67 72 61 70 | 68 79 20 73 74 79 6c 65 |bliograp|hy style|
|00000980| 73 20 69 6e 20 61 20 70 | 6f 73 74 66 69 78 20 73 |s in a p|ostfix s|
|00000990| 74 61 63 6b 20 6c 61 6e | 67 75 61 67 65 2e 20 20 |tack lan|guage. |
|000009a0| 49 74 27 73 0a 6e 6f 74 | 20 74 6f 6f 20 68 61 72 |It's.not| too har|
|000009b0| 64 20 74 6f 20 66 69 67 | 75 72 65 20 6f 75 74 20 |d to fig|ure out |
|000009c0| 68 6f 77 20 62 79 20 6c | 6f 6f 6b 69 6e 67 20 61 |how by l|ooking a|
|000009d0| 74 20 74 68 65 20 73 74 | 61 6e 64 61 72 64 2d 73 |t the st|andard-s|
|000009e0| 74 79 6c 65 20 64 6f 63 | 75 6d 65 6e 74 61 74 69 |tyle doc|umentati|
|000009f0| 6f 6e 2c 0a 62 75 74 20 | 74 68 69 73 20 64 65 73 |on,.but |this des|
|00000a00| 63 72 69 70 74 69 6f 6e | 20 66 69 6c 6c 73 20 69 |cription| fills i|
|00000a10| 6e 20 61 20 66 65 77 20 | 64 65 74 61 69 6c 73 20 |n a few |details |
|00000a20| 28 69 74 20 77 69 6c 6c | 20 66 69 6c 6c 20 69 6e |(it will| fill in|
|00000a30| 20 6d 6f 72 65 0a 64 65 | 74 61 69 6c 73 20 69 66 | more.de|tails if|
|00000a40| 20 74 68 65 72 65 27 73 | 20 61 20 64 65 6d 61 6e | there's| a deman|
|00000a50| 64 20 66 6f 72 20 69 74 | 29 2e 0a 0a 42 61 73 69 |d for it|)...Basi|
|00000a60| 63 61 6c 6c 79 20 74 68 | 65 20 73 74 79 6c 65 20 |cally th|e style |
|00000a70| 66 69 6c 65 20 69 73 20 | 61 20 70 72 6f 67 72 61 |file is |a progra|
|00000a80| 6d 2c 20 77 72 69 74 74 | 65 6e 20 69 6e 20 61 6e |m, writt|en in an|
|00000a90| 20 75 6e 6e 61 6d 65 64 | 20 6c 61 6e 67 75 61 67 | unnamed| languag|
|00000aa0| 65 2c 20 74 68 61 74 0a | 74 65 6c 6c 73 20 5c 42 |e, that.|tells \B|
|00000ab0| 69 62 54 65 58 5c 20 68 | 6f 77 20 74 6f 20 66 6f |ibTeX\ h|ow to fo|
|00000ac0| 72 6d 61 74 20 74 68 65 | 20 65 6e 74 72 69 65 73 |rmat the| entries|
|00000ad0| 20 74 68 61 74 20 77 69 | 6c 6c 20 67 6f 20 69 6e | that wi|ll go in|
|00000ae0| 20 74 68 65 20 72 65 66 | 65 72 65 6e 63 65 20 6c | the ref|erence l|
|00000af0| 69 73 74 0a 28 68 65 6e | 63 65 66 6f 72 74 68 20 |ist.(hen|ceforth |
|00000b00| 60 60 74 68 65 20 65 6e | 74 72 69 65 73 27 27 20 |``the en|tries'' |
|00000b10| 77 69 6c 6c 20 62 65 20 | 60 60 74 68 65 20 65 6e |will be |``the en|
|00000b20| 74 72 79 20 6c 69 73 74 | 27 27 0a 6f 72 20 73 69 |try list|''.or si|
|00000b30| 6d 70 6c 79 20 60 60 74 | 68 65 20 6c 69 73 74 27 |mply ``t|he list'|
|00000b40| 27 24 5c 21 24 2c 20 63 | 6f 6e 74 65 78 74 20 70 |'$\!$, c|ontext p|
|00000b50| 65 72 6d 69 74 74 69 6e | 67 29 2e 0a 54 68 69 73 |ermittin|g)..This|
|00000b60| 20 70 72 6f 67 72 61 6d | 6d 69 6e 67 20 6c 61 6e | program|ming lan|
|00000b70| 67 75 61 67 65 20 68 61 | 73 20 74 65 6e 20 63 6f |guage ha|s ten co|
|00000b80| 6d 6d 61 6e 64 73 2c 20 | 64 65 73 63 72 69 62 65 |mmands, |describe|
|00000b90| 64 20 69 6e 20 74 68 65 | 20 6e 65 78 74 20 73 75 |d in the| next su|
|00000ba0| 62 73 65 63 74 69 6f 6e | 2e 0a 54 68 65 73 65 20 |bsection|..These |
|00000bb0| 63 6f 6d 6d 61 6e 64 73 | 20 6d 61 6e 69 70 75 6c |commands| manipul|
|00000bc0| 61 74 65 20 74 68 65 20 | 6c 61 6e 67 75 61 67 65 |ate the |language|
|00000bd0| 27 73 20 6f 62 6a 65 63 | 74 73 3a 0a 63 6f 6e 73 |'s objec|ts:.cons|
|00000be0| 74 61 6e 74 73 2c 20 76 | 61 72 69 61 62 6c 65 73 |tants, v|ariables|
|00000bf0| 2c 20 66 75 6e 63 74 69 | 6f 6e 73 2c 20 74 68 65 |, functi|ons, the|
|00000c00| 20 73 74 61 63 6b 2c 20 | 61 6e 64 20 74 68 65 20 | stack, |and the |
|00000c10| 65 6e 74 72 79 20 6c 69 | 73 74 2e 0a 28 57 61 72 |entry li|st..(War|
|00000c20| 6e 69 6e 67 3a 20 54 68 | 65 20 74 65 72 6d 69 6e |ning: Th|e termin|
|00000c30| 6f 6c 6f 67 79 20 69 6e | 20 74 68 69 73 20 64 6f |ology in| this do|
|00000c40| 63 75 6d 65 6e 74 61 74 | 69 6f 6e 2c 0a 63 68 6f |cumentat|ion,.cho|
|00000c50| 73 65 6e 20 66 6f 72 20 | 65 61 73 65 20 6f 66 20 |sen for |ease of |
|00000c60| 65 78 70 6c 61 6e 61 74 | 69 6f 6e 2c 20 69 73 20 |explanat|ion, is |
|00000c70| 73 6c 69 67 68 74 6c 79 | 20 64 69 66 66 65 72 65 |slightly| differe|
|00000c80| 6e 74 20 66 72 6f 6d 20 | 5c 42 69 62 54 65 58 27 |nt from |\BibTeX'|
|00000c90| 73 2e 0a 46 6f 72 20 65 | 78 61 6d 70 6c 65 2c 20 |s..For e|xample, |
|00000ca0| 74 68 69 73 20 64 6f 63 | 75 6d 65 6e 74 61 74 69 |this doc|umentati|
|00000cb0| 6f 6e 27 73 20 60 60 76 | 61 72 69 61 62 6c 65 73 |on's ``v|ariables|
|00000cc0| 27 27 20 61 6e 64 20 60 | 60 66 75 6e 63 74 69 6f |'' and `|`functio|
|00000cd0| 6e 73 27 27 0a 61 72 65 | 20 62 6f 74 68 20 60 60 |ns''.are| both ``|
|00000ce0| 66 75 6e 63 74 69 6f 6e | 73 27 27 20 74 6f 20 5c |function|s'' to \|
|00000cf0| 42 69 62 54 65 58 2e 0a | 4b 65 65 70 20 74 68 69 |BibTeX..|Keep thi|
|00000d00| 73 20 69 6e 20 6d 69 6e | 64 20 77 68 65 6e 20 69 |s in min|d when i|
|00000d10| 6e 74 65 72 70 72 65 74 | 69 6e 67 20 5c 42 69 62 |nterpret|ing \Bib|
|00000d20| 54 65 58 27 73 20 65 72 | 72 6f 72 20 6d 65 73 73 |TeX's er|ror mess|
|00000d30| 61 67 65 73 2e 29 0a 0a | 54 68 65 72 65 20 61 72 |ages.)..|There ar|
|00000d40| 65 20 74 77 6f 20 74 79 | 70 65 73 20 6f 66 20 66 |e two ty|pes of f|
|00000d50| 75 6e 63 74 69 6f 6e 73 | 3a 20 7b 5c 69 74 20 62 |unctions|: {\it b|
|00000d60| 75 69 6c 74 2d 69 6e 5c | 2f 7d 20 6f 6e 65 73 20 |uilt-in\|/} ones |
|00000d70| 74 68 61 74 20 5c 42 69 | 62 54 65 58 5c 20 70 72 |that \Bi|bTeX\ pr|
|00000d80| 6f 76 69 64 65 73 0a 28 | 74 68 65 73 65 20 61 72 |ovides.(|these ar|
|00000d90| 65 20 64 65 73 63 72 69 | 62 65 64 20 69 6e 20 53 |e descri|bed in S|
|00000da0| 65 63 74 69 6f 6e 7e 5c | 72 65 66 7b 62 75 69 6c |ection~\|ref{buil|
|00000db0| 74 2d 69 6e 2d 66 6e 73 | 7d 29 2c 20 61 6e 64 20 |t-in-fns|}), and |
|00000dc0| 6f 6e 65 73 20 79 6f 75 | 20 64 65 66 69 6e 65 0a |ones you| define.|
|00000dd0| 75 73 69 6e 67 20 65 69 | 74 68 65 72 20 74 68 65 |using ei|ther the|
|00000de0| 20 5c 68 62 6f 78 7b 5c | 74 74 20 4d 41 43 52 4f | \hbox{\|tt MACRO|
|00000df0| 7d 20 6f 72 20 5c 68 62 | 6f 78 7b 5c 74 74 20 46 |} or \hb|ox{\tt F|
|00000e00| 55 4e 43 54 49 4f 4e 7d | 20 63 6f 6d 6d 61 6e 64 |UNCTION}| command|
|00000e10| 2e 0a 0a 59 6f 75 72 20 | 6d 6f 73 74 20 74 69 6d |...Your |most tim|
|00000e20| 65 2d 63 6f 6e 73 75 6d | 69 6e 67 20 74 61 73 6b |e-consum|ing task|
|00000e30| 2c 20 61 73 20 61 20 73 | 74 79 6c 65 20 64 65 73 |, as a s|tyle des|
|00000e40| 69 67 6e 65 72 2c 0a 77 | 69 6c 6c 20 62 65 20 63 |igner,.w|ill be c|
|00000e50| 72 65 61 74 69 6e 67 20 | 6f 72 20 6d 6f 64 69 66 |reating |or modif|
|00000e60| 79 69 6e 67 20 66 75 6e | 63 74 69 6f 6e 73 0a 75 |ying fun|ctions.u|
|00000e70| 73 69 6e 67 20 74 68 65 | 20 5c 68 62 6f 78 7b 5c |sing the| \hbox{\|
|00000e80| 74 74 20 46 55 4e 43 54 | 49 4f 4e 7d 20 63 6f 6d |tt FUNCT|ION} com|
|00000e90| 6d 61 6e 64 0a 28 61 63 | 74 75 61 6c 6c 79 2c 20 |mand.(ac|tually, |
|00000ea0| 62 65 63 6f 6d 69 6e 67 | 20 66 61 6d 69 6c 69 61 |becoming| familia|
|00000eb0| 72 20 77 69 74 68 20 74 | 68 65 20 72 65 66 65 72 |r with t|he refer|
|00000ec0| 65 6e 63 65 73 20 6c 69 | 73 74 65 64 20 61 62 6f |ences li|sted abo|
|00000ed0| 76 65 20 77 69 6c 6c 20 | 62 65 0a 6d 6f 72 65 20 |ve will |be.more |
|00000ee0| 74 69 6d 65 20 63 6f 6e | 73 75 6d 69 6e 67 2c 20 |time con|suming, |
|00000ef0| 62 75 74 20 61 73 73 75 | 6d 65 20 66 6f 72 20 74 |but assu|me for t|
|00000f00| 68 65 20 6d 6f 6d 65 6e | 74 20 74 68 61 74 20 74 |he momen|t that t|
|00000f10| 68 61 74 27 73 20 64 6f | 6e 65 29 2e 0a 0a 4c 65 |hat's do|ne)...Le|
|00000f20| 74 27 73 20 6c 6f 6f 6b | 20 61 74 20 61 20 73 61 |t's look| at a sa|
|00000f30| 6d 70 6c 65 20 66 75 6e | 63 74 69 6f 6e 20 66 72 |mple fun|ction fr|
|00000f40| 61 67 6d 65 6e 74 2e 0a | 53 75 70 70 6f 73 65 20 |agment..|Suppose |
|00000f50| 79 6f 75 20 68 61 76 65 | 20 61 20 73 74 72 69 6e |you have| a strin|
|00000f60| 67 20 76 61 72 69 61 62 | 6c 65 20 6e 61 6d 65 64 |g variab|le named|
|00000f70| 20 5c 68 62 6f 78 7b 5c | 74 74 20 6c 61 62 65 6c | \hbox{\|tt label|
|00000f80| 7d 0a 61 6e 64 20 61 6e | 20 69 6e 74 65 67 65 72 |}.and an| integer|
|00000f90| 20 76 61 72 69 61 62 6c | 65 20 6e 61 6d 65 64 20 | variabl|e named |
|00000fa0| 5c 68 62 6f 78 7b 5c 74 | 74 20 6c 61 62 2e 77 69 |\hbox{\t|t lab.wi|
|00000fb0| 64 74 68 7d 2c 0a 61 6e | 64 20 73 75 70 70 6f 73 |dth},.an|d suppos|
|00000fc0| 65 20 79 6f 75 20 77 61 | 6e 74 20 74 6f 20 61 70 |e you wa|nt to ap|
|00000fd0| 70 65 6e 64 20 74 68 65 | 20 63 68 61 72 61 63 74 |pend the| charact|
|00000fe0| 65 72 20 60 7b 5c 74 74 | 20 61 7d 27 20 74 6f 20 |er `{\tt| a}' to |
|00000ff0| 5c 68 62 6f 78 7b 5c 74 | 74 20 6c 61 62 65 6c 7d |\hbox{\t|t label}|
|00001000| 0a 61 6e 64 20 74 6f 20 | 69 6e 63 72 65 6d 65 6e |.and to |incremen|
|00001010| 74 20 5c 68 62 6f 78 7b | 5c 74 74 20 6c 61 62 2e |t \hbox{|\tt lab.|
|00001020| 77 69 64 74 68 7d 3a 0a | 5c 62 65 67 69 6e 7b 76 |width}:.|\begin{v|
|00001030| 65 72 62 61 74 69 6d 7d | 0a 20 20 20 20 2e 20 20 |erbatim}|. . |
|00001040| 2e 20 20 2e 0a 20 20 20 | 20 6c 61 62 65 6c 20 22 |. .. | label "|
|00001050| 61 22 20 2a 20 27 6c 61 | 62 65 6c 20 3a 3d 20 20 |a" * 'la|bel := |
|00001060| 20 20 20 20 20 20 20 20 | 25 20 6c 61 62 65 6c 20 | |% label |
|00001070| 3a 3d 20 6c 61 62 65 6c | 20 2a 20 22 61 22 0a 20 |:= label| * "a". |
|00001080| 20 20 20 6c 61 62 2e 77 | 69 64 74 68 20 23 31 20 | lab.w|idth #1 |
|00001090| 2b 20 27 6c 61 62 2e 77 | 69 64 74 68 20 3a 3d 20 |+ 'lab.w|idth := |
|000010a0| 20 20 25 20 6c 61 62 2e | 77 69 64 74 68 20 3a 3d | % lab.|width :=|
|000010b0| 20 6c 61 62 2e 77 69 64 | 74 68 20 2b 20 31 0a 20 | lab.wid|th + 1. |
|000010c0| 20 20 20 2e 20 20 2e 20 | 20 2e 0a 5c 65 6e 64 7b | . . | ..\end{|
|000010d0| 76 65 72 62 61 74 69 6d | 7d 0a 49 6e 20 74 68 65 |verbatim|}.In the|
|000010e0| 20 66 69 72 73 74 20 6c | 69 6e 65 2c 0a 5c 68 62 | first l|ine,.\hb|
|000010f0| 6f 78 7b 5c 74 74 20 6c | 61 62 65 6c 7d 20 70 75 |ox{\tt l|abel} pu|
|00001100| 73 68 65 73 20 74 68 61 | 74 20 76 61 72 69 61 62 |shes tha|t variab|
|00001110| 6c 65 27 73 20 76 61 6c | 75 65 20 6f 6e 74 6f 20 |le's val|ue onto |
|00001120| 74 68 65 20 73 74 61 63 | 6b 2e 0a 4e 65 78 74 2c |the stac|k..Next,|
|00001130| 20 74 68 65 20 7b 5c 74 | 74 20 22 61 22 7d 20 70 | the {\t|t "a"} p|
|00001140| 75 73 68 65 73 20 74 68 | 65 20 73 74 72 69 6e 67 |ushes th|e string|
|00001150| 20 63 6f 6e 73 74 61 6e | 74 20 60 7b 5c 74 74 20 | constan|t `{\tt |
|00001160| 61 7d 27 20 6f 6e 74 6f | 20 74 68 65 20 73 74 61 |a}' onto| the sta|
|00001170| 63 6b 2e 0a 54 68 65 6e | 20 74 68 65 20 62 75 69 |ck..Then| the bui|
|00001180| 6c 74 2d 69 6e 20 66 75 | 6e 63 74 69 6f 6e 20 7b |lt-in fu|nction {|
|00001190| 5c 74 74 20 2a 7d 20 70 | 6f 70 73 20 74 68 65 20 |\tt *} p|ops the |
|000011a0| 74 6f 70 20 74 77 6f 20 | 73 74 72 69 6e 67 73 20 |top two |strings |
|000011b0| 61 6e 64 0a 70 75 73 68 | 65 73 20 74 68 65 69 72 |and.push|es their|
|000011c0| 20 63 6f 6e 63 61 74 65 | 6e 61 74 69 6f 6e 2e 0a | concate|nation..|
|000011d0| 54 68 65 20 5c 68 62 6f | 78 7b 5c 74 74 20 27 6c |The \hbo|x{\tt 'l|
|000011e0| 61 62 65 6c 7d 20 70 75 | 73 68 65 73 20 74 68 61 |abel} pu|shes tha|
|000011f0| 74 20 76 61 72 69 61 62 | 6c 65 27 73 20 6e 61 6d |t variab|le's nam|
|00001200| 65 20 6f 6e 74 6f 20 74 | 68 65 20 73 74 61 63 6b |e onto t|he stack|
|00001210| 2e 0a 41 6e 64 20 66 69 | 6e 61 6c 6c 79 2c 20 74 |..And fi|nally, t|
|00001220| 68 65 20 62 75 69 6c 74 | 2d 69 6e 20 66 75 6e 63 |he built|-in func|
|00001230| 74 69 6f 6e 20 7b 5c 74 | 74 20 3a 3d 7d 20 70 6f |tion {\t|t :=} po|
|00001240| 70 73 0a 74 68 65 20 76 | 61 72 69 61 62 6c 65 20 |ps.the v|ariable |
|00001250| 6e 61 6d 65 20 61 6e 64 | 20 74 68 65 20 63 6f 6e |name and| the con|
|00001260| 63 61 74 65 6e 61 74 69 | 6f 6e 20 61 6e 64 20 70 |catenati|on and p|
|00001270| 65 72 66 6f 72 6d 73 20 | 74 68 65 20 61 73 73 69 |erforms |the assi|
|00001280| 67 6e 6d 65 6e 74 2e 0a | 5c 42 69 62 54 65 58 5c |gnment..|\BibTeX\|
|00001290| 20 74 72 65 61 74 73 20 | 74 68 65 20 73 74 75 66 | treats |the stuf|
|000012a0| 66 20 66 6f 6c 6c 6f 77 | 69 6e 67 20 74 68 65 20 |f follow|ing the |
|000012b0| 7b 5c 74 74 20 5c 25 7d | 20 61 73 20 61 20 63 6f |{\tt \%}| as a co|
|000012c0| 6d 6d 65 6e 74 0a 69 6e | 20 74 68 65 20 73 74 79 |mment.in| the sty|
|000012d0| 6c 65 20 66 69 6c 65 2e | 0a 54 68 65 20 73 65 63 |le file.|.The sec|
|000012e0| 6f 6e 64 20 6c 69 6e 65 | 20 69 73 20 73 69 6d 69 |ond line| is simi|
|000012f0| 6c 61 72 20 65 78 63 65 | 70 74 20 74 68 61 74 20 |lar exce|pt that |
|00001300| 69 74 20 75 73 65 73 20 | 7b 5c 74 74 20 5c 23 31 |it uses |{\tt \#1|
|00001310| 7d 2c 0a 77 69 74 68 20 | 6e 6f 20 73 70 61 63 65 |},.with |no space|
|00001320| 73 20 69 6e 74 65 72 76 | 65 6e 69 6e 67 20 62 65 |s interv|ening be|
|00001330| 74 77 65 65 6e 20 74 68 | 65 20 60 7b 5c 74 74 20 |tween th|e `{\tt |
|00001340| 5c 23 7d 27 20 61 6e 64 | 20 74 68 65 20 60 7b 5c |\#}' and| the `{\|
|00001350| 74 74 20 31 7d 27 24 5c | 21 24 2c 0a 74 6f 20 70 |tt 1}'$\|!$,.to p|
|00001360| 75 73 68 20 74 68 69 73 | 20 69 6e 74 65 67 65 72 |ush this| integer|
|00001370| 20 63 6f 6e 73 74 61 6e | 74 2e 0a 0a 54 68 65 20 | constan|t...The |
|00001380| 6e 6f 6e 6e 75 6c 6c 20 | 73 70 61 63 69 6e 67 20 |nonnull |spacing |
|00001390| 68 65 72 65 20 69 73 20 | 61 72 62 69 74 72 61 72 |here is |arbitrar|
|000013a0| 79 3a 20 6d 75 6c 74 69 | 70 6c 65 20 73 70 61 63 |y: multi|ple spac|
|000013b0| 65 73 2c 20 74 61 62 73 | 2c 20 6f 72 20 6e 65 77 |es, tabs|, or new|
|000013c0| 6c 69 6e 65 73 0a 61 72 | 65 20 65 71 75 69 76 61 |lines.ar|e equiva|
|000013d0| 6c 65 6e 74 20 74 6f 20 | 61 20 73 69 6e 67 6c 65 |lent to |a single|
|000013e0| 20 6f 6e 65 20 28 65 78 | 63 65 70 74 20 74 68 61 | one (ex|cept tha|
|000013f0| 74 20 79 6f 75 27 72 65 | 20 70 72 6f 62 61 62 6c |t you're| probabl|
|00001400| 79 20 62 65 74 74 65 72 | 20 6f 66 66 0a 6e 6f 74 |y better| off.not|
|00001410| 20 68 61 76 69 6e 67 20 | 62 6c 61 6e 6b 20 6c 69 | having |blank li|
|00001420| 6e 65 73 20 77 69 74 68 | 69 6e 20 63 6f 6d 6d 61 |nes with|in comma|
|00001430| 6e 64 73 2c 20 61 73 20 | 65 78 70 6c 61 69 6e 65 |nds, as |explaine|
|00001440| 64 20 73 68 6f 72 74 6c | 79 29 2e 0a 0a 46 6f 72 |d shortl|y)...For|
|00001450| 20 73 74 72 69 6e 67 20 | 63 6f 6e 73 74 61 6e 74 | string |constant|
|00001460| 73 2c 20 61 62 73 6f 6c | 75 74 65 6c 79 20 61 6e |s, absol|utely an|
|00001470| 79 20 70 72 69 6e 74 69 | 6e 67 20 63 68 61 72 61 |y printi|ng chara|
|00001480| 63 74 65 72 0a 69 73 20 | 6c 65 67 61 6c 20 62 65 |cter.is |legal be|
|00001490| 74 77 65 65 6e 20 74 77 | 6f 20 63 6f 6e 73 65 63 |tween tw|o consec|
|000014a0| 75 74 69 76 65 20 64 6f | 75 62 6c 65 20 71 75 6f |utive do|uble quo|
|000014b0| 74 65 73 2c 20 62 75 74 | 20 5c 42 69 62 54 65 58 |tes, but| \BibTeX|
|000014c0| 5c 20 68 65 72 65 0a 28 | 61 6e 64 20 6f 6e 6c 79 |\ here.(|and only|
|000014d0| 20 68 65 72 65 29 20 74 | 72 65 61 74 73 20 75 70 | here) t|reats up|
|000014e0| 70 65 72 2d 20 61 6e 64 | 20 6c 6f 77 65 72 2d 63 |per- and| lower-c|
|000014f0| 61 73 65 20 65 71 75 69 | 76 61 6c 65 6e 74 73 20 |ase equi|valents |
|00001500| 61 73 20 64 69 66 66 65 | 72 65 6e 74 2e 0a 46 75 |as diffe|rent..Fu|
|00001510| 72 74 68 65 72 6d 6f 72 | 65 2c 20 73 70 61 63 69 |rthermor|e, spaci|
|00001520| 6e 67 20 7b 5c 65 6d 20 | 69 73 5c 2f 7d 20 72 65 |ng {\em |is\/} re|
|00001530| 6c 65 76 61 6e 74 20 77 | 69 74 68 69 6e 20 61 20 |levant w|ithin a |
|00001540| 73 74 72 69 6e 67 20 63 | 6f 6e 73 74 61 6e 74 2c |string c|onstant,|
|00001550| 0a 61 6e 64 20 79 6f 75 | 20 6d 75 73 74 6e 27 74 |.and you| mustn't|
|00001560| 20 73 70 6c 69 74 20 61 | 20 73 74 72 69 6e 67 20 | split a| string |
|00001570| 63 6f 6e 73 74 61 6e 74 | 20 61 63 72 6f 73 73 20 |constant| across |
|00001580| 6c 69 6e 65 73 0a 28 74 | 68 61 74 20 69 73 2c 20 |lines.(t|hat is, |
|00001590| 74 68 65 20 62 65 67 69 | 6e 6e 69 6e 67 20 61 6e |the begi|nning an|
|000015a0| 64 20 65 6e 64 69 6e 67 | 20 64 6f 75 62 6c 65 20 |d ending| double |
|000015b0| 71 75 6f 74 65 73 20 6d | 75 73 74 20 62 65 20 6f |quotes m|ust be o|
|000015c0| 6e 20 74 68 65 20 73 61 | 6d 65 20 6c 69 6e 65 29 |n the sa|me line)|
|000015d0| 2e 0a 0a 56 61 72 69 61 | 62 6c 65 20 61 6e 64 20 |...Varia|ble and |
|000015e0| 66 75 6e 63 74 69 6f 6e | 20 6e 61 6d 65 73 20 6d |function| names m|
|000015f0| 61 79 20 6e 6f 74 20 62 | 65 67 69 6e 20 77 69 74 |ay not b|egin wit|
|00001600| 68 20 61 20 6e 75 6d 65 | 72 61 6c 20 61 6e 64 0a |h a nume|ral and.|
|00001610| 6d 61 79 20 6e 6f 74 20 | 63 6f 6e 74 61 69 6e 20 |may not |contain |
|00001620| 61 6e 79 20 6f 66 20 74 | 68 65 20 74 65 6e 20 72 |any of t|he ten r|
|00001630| 65 73 74 72 69 63 74 65 | 64 20 63 68 61 72 61 63 |estricte|d charac|
|00001640| 74 65 72 73 0a 6f 6e 20 | 70 61 67 65 7e 31 34 33 |ters.on |page~143|
|00001650| 20 6f 66 20 74 68 65 20 | 5c 4c 61 54 65 58 5c 20 | of the |\LaTeX\ |
|00001660| 62 6f 6f 6b 2c 0a 62 75 | 74 20 6d 61 79 20 6f 74 |book,.bu|t may ot|
|00001670| 68 65 72 77 69 73 65 20 | 63 6f 6e 74 61 69 6e 20 |herwise |contain |
|00001680| 61 6e 79 20 70 72 69 6e | 74 69 6e 67 20 63 68 61 |any prin|ting cha|
|00001690| 72 61 63 74 65 72 73 2e | 0a 41 6c 73 6f 2c 20 5c |racters.|.Also, \|
|000016a0| 42 69 62 54 65 58 5c 20 | 63 6f 6e 73 69 64 65 72 |BibTeX\ |consider|
|000016b0| 73 20 75 70 70 65 72 2d | 20 61 6e 64 20 6c 6f 77 |s upper-| and low|
|000016c0| 65 72 2d 63 61 73 65 20 | 65 71 75 69 76 61 6c 65 |er-case |equivale|
|000016d0| 6e 74 73 20 74 6f 20 62 | 65 20 74 68 65 20 73 61 |nts to b|e the sa|
|000016e0| 6d 65 2e 0a 0a 49 6e 74 | 65 67 65 72 73 20 61 6e |me...Int|egers an|
|000016f0| 64 20 73 74 72 69 6e 67 | 73 20 61 72 65 20 74 68 |d string|s are th|
|00001700| 65 20 6f 6e 6c 79 20 76 | 61 6c 75 65 20 74 79 70 |e only v|alue typ|
|00001710| 65 73 20 66 6f 72 20 63 | 6f 6e 73 74 61 6e 74 73 |es for c|onstants|
|00001720| 20 61 6e 64 20 76 61 72 | 69 61 62 6c 65 73 0a 28 | and var|iables.(|
|00001730| 62 6f 6f 6c 65 61 6e 73 | 20 61 72 65 20 69 6d 70 |booleans| are imp|
|00001740| 6c 65 6d 65 6e 74 65 64 | 20 73 69 6d 70 6c 79 20 |lemented| simply |
|00001750| 61 73 20 30 2d 6f 72 2d | 31 20 69 6e 74 65 67 65 |as 0-or-|1 intege|
|00001760| 72 73 29 2e 0a 54 68 65 | 72 65 20 61 72 65 20 74 |rs)..The|re are t|
|00001770| 68 72 65 65 20 6b 69 6e | 64 73 20 6f 66 20 76 61 |hree kin|ds of va|
|00001780| 72 69 61 62 6c 65 73 3a | 0a 5c 62 65 67 69 6e 7b |riables:|.\begin{|
|00001790| 64 65 73 63 72 69 70 74 | 69 6f 6e 7d 0a 0a 5c 69 |descript|ion}..\i|
|000017a0| 74 65 6d 5b 67 6c 6f 62 | 61 6c 20 76 61 72 69 61 |tem[glob|al varia|
|000017b0| 62 6c 65 73 5c 68 66 69 | 6c 6c 5d 20 54 68 65 73 |bles\hfi|ll] Thes|
|000017c0| 65 20 61 72 65 20 65 69 | 74 68 65 72 20 69 6e 74 |e are ei|ther int|
|000017d0| 65 67 65 72 2d 20 6f 72 | 20 73 74 72 69 6e 67 2d |eger- or| string-|
|000017e0| 76 61 6c 75 65 64 2c 0a | 64 65 63 6c 61 72 65 64 |valued,.|declared|
|000017f0| 20 75 73 69 6e 67 20 61 | 6e 20 5c 68 62 6f 78 7b | using a|n \hbox{|
|00001800| 5c 74 74 20 49 4e 54 45 | 47 45 52 53 7d 20 6f 72 |\tt INTE|GERS} or|
|00001810| 20 5c 68 62 6f 78 7b 5c | 74 74 20 53 54 52 49 4e | \hbox{\|tt STRIN|
|00001820| 47 53 7d 20 63 6f 6d 6d | 61 6e 64 2e 0a 0a 5c 69 |GS} comm|and...\i|
|00001830| 74 65 6d 5b 65 6e 74 72 | 79 20 76 61 72 69 61 62 |tem[entr|y variab|
|00001840| 6c 65 73 5c 68 66 69 6c | 6c 5d 20 54 68 65 73 65 |les\hfil|l] These|
|00001850| 20 61 72 65 20 65 69 74 | 68 65 72 20 69 6e 74 65 | are eit|her inte|
|00001860| 67 65 72 2d 20 6f 72 20 | 73 74 72 69 6e 67 2d 76 |ger- or |string-v|
|00001870| 61 6c 75 65 64 2c 0a 64 | 65 63 6c 61 72 65 64 20 |alued,.d|eclared |
|00001880| 75 73 69 6e 67 20 74 68 | 65 20 5c 68 62 6f 78 7b |using th|e \hbox{|
|00001890| 5c 74 74 20 45 4e 54 52 | 59 7d 20 63 6f 6d 6d 61 |\tt ENTR|Y} comma|
|000018a0| 6e 64 2e 0a 45 61 63 68 | 20 68 61 73 20 61 20 76 |nd..Each| has a v|
|000018b0| 61 6c 75 65 20 66 6f 72 | 20 65 61 63 68 20 65 6e |alue for| each en|
|000018c0| 74 72 79 20 6f 6e 20 74 | 68 65 20 6c 69 73 74 0a |try on t|he list.|
|000018d0| 28 65 78 61 6d 70 6c 65 | 3a 20 61 20 76 61 72 69 |(example|: a vari|
|000018e0| 61 62 6c 65 20 5c 68 62 | 6f 78 7b 5c 74 74 20 6c |able \hb|ox{\tt l|
|000018f0| 61 62 65 6c 7d 20 6d 69 | 67 68 74 20 73 74 6f 72 |abel} mi|ght stor|
|00001900| 65 0a 74 68 65 20 6c 61 | 62 65 6c 20 73 74 72 69 |e.the la|bel stri|
|00001910| 6e 67 20 79 6f 75 27 6c | 6c 20 75 73 65 20 66 6f |ng you'l|l use fo|
|00001920| 72 20 74 68 65 20 65 6e | 74 72 79 29 2e 0a 0a 5c |r the en|try)...\|
|00001930| 69 74 65 6d 5b 66 69 65 | 6c 64 73 5c 68 66 69 6c |item[fie|lds\hfil|
|00001940| 6c 5d 20 54 68 65 73 65 | 20 61 72 65 20 73 74 72 |l] These| are str|
|00001950| 69 6e 67 2d 76 61 6c 75 | 65 64 2c 20 72 65 61 64 |ing-valu|ed, read|
|00001960| 2d 6f 6e 6c 79 20 76 61 | 72 69 61 62 6c 65 73 0a |-only va|riables.|
|00001970| 74 68 61 74 20 73 74 6f | 72 65 20 74 68 65 20 69 |that sto|re the i|
|00001980| 6e 66 6f 72 6d 61 74 69 | 6f 6e 20 66 72 6f 6d 20 |nformati|on from |
|00001990| 74 68 65 20 64 61 74 61 | 62 61 73 65 20 66 69 6c |the data|base fil|
|000019a0| 65 3b 0a 74 68 65 69 72 | 20 76 61 6c 75 65 73 20 |e;.their| values |
|000019b0| 61 72 65 20 73 65 74 20 | 62 79 20 74 68 65 20 5c |are set |by the \|
|000019c0| 68 62 6f 78 7b 5c 74 74 | 20 52 45 41 44 7d 20 63 |hbox{\tt| READ} c|
|000019d0| 6f 6d 6d 61 6e 64 2e 0a | 41 73 20 77 69 74 68 20 |ommand..|As with |
|000019e0| 65 6e 74 72 79 20 76 61 | 72 69 61 62 6c 65 73 2c |entry va|riables,|
|000019f0| 20 65 61 63 68 20 68 61 | 73 20 61 20 76 61 6c 75 | each ha|s a valu|
|00001a00| 65 20 66 6f 72 20 65 61 | 63 68 20 65 6e 74 72 79 |e for ea|ch entry|
|00001a10| 2e 0a 5c 65 6e 64 7b 64 | 65 73 63 72 69 70 74 69 |..\end{d|escripti|
|00001a20| 6f 6e 7d 0a 0a 0a 5c 73 | 75 62 73 65 63 74 69 6f |on}...\s|ubsectio|
|00001a30| 6e 7b 43 6f 6d 6d 61 6e | 64 73 7d 0a 0a 54 68 65 |n{Comman|ds}..The|
|00001a40| 72 65 20 61 72 65 20 74 | 65 6e 20 73 74 79 6c 65 |re are t|en style|
|00001a50| 2d 66 69 6c 65 20 63 6f | 6d 6d 61 6e 64 73 3a 0a |-file co|mmands:.|
|00001a60| 46 69 76 65 20 28 5c 68 | 62 6f 78 7b 5c 74 74 20 |Five (\h|box{\tt |
|00001a70| 45 4e 54 52 59 7d 2c 20 | 5c 68 62 6f 78 7b 5c 74 |ENTRY}, |\hbox{\t|
|00001a80| 74 20 46 55 4e 43 54 49 | 4f 4e 7d 2c 20 5c 68 62 |t FUNCTI|ON}, \hb|
|00001a90| 6f 78 7b 5c 74 74 20 49 | 4e 54 45 47 45 52 53 7d |ox{\tt I|NTEGERS}|
|00001aa0| 2c 0a 5c 68 62 6f 78 7b | 5c 74 74 20 4d 41 43 52 |,.\hbox{|\tt MACR|
|00001ab0| 4f 7d 2c 20 61 6e 64 20 | 5c 68 62 6f 78 7b 5c 74 |O}, and |\hbox{\t|
|00001ac0| 74 20 53 54 52 49 4e 47 | 53 7d 29 0a 64 65 63 6c |t STRING|S}).decl|
|00001ad0| 61 72 65 20 61 6e 64 20 | 64 65 66 69 6e 65 20 76 |are and |define v|
|00001ae0| 61 72 69 61 62 6c 65 73 | 20 61 6e 64 20 66 75 6e |ariables| and fun|
|00001af0| 63 74 69 6f 6e 73 3b 0a | 6f 6e 65 20 28 5c 68 62 |ctions;.|one (\hb|
|00001b00| 6f 78 7b 5c 74 74 20 52 | 45 41 44 7d 29 20 72 65 |ox{\tt R|EAD}) re|
|00001b10| 61 64 73 20 69 6e 20 74 | 68 65 20 64 61 74 61 62 |ads in t|he datab|
|00001b20| 61 73 65 20 69 6e 66 6f | 72 6d 61 74 69 6f 6e 3b |ase info|rmation;|
|00001b30| 0a 61 6e 64 20 66 6f 75 | 72 20 28 5c 68 62 6f 78 |.and fou|r (\hbox|
|00001b40| 7b 5c 74 74 20 45 58 45 | 43 55 54 45 7d 2c 20 5c |{\tt EXE|CUTE}, \|
|00001b50| 68 62 6f 78 7b 5c 74 74 | 20 49 54 45 52 41 54 45 |hbox{\tt| ITERATE|
|00001b60| 7d 2c 20 5c 68 62 6f 78 | 7b 5c 74 74 20 52 45 56 |}, \hbox|{\tt REV|
|00001b70| 45 52 53 45 7d 2c 0a 61 | 6e 64 20 5c 68 62 6f 78 |ERSE},.a|nd \hbox|
|00001b80| 7b 5c 74 74 20 53 4f 52 | 54 7d 29 20 6d 61 6e 69 |{\tt SOR|T}) mani|
|00001b90| 70 75 6c 61 74 65 20 74 | 68 65 20 65 6e 74 72 69 |pulate t|he entri|
|00001ba0| 65 73 20 61 6e 64 20 70 | 72 6f 64 75 63 65 20 6f |es and p|roduce o|
|00001bb0| 75 74 70 75 74 2e 0a 41 | 6c 74 68 6f 75 67 68 20 |utput..A|lthough |
|00001bc0| 74 68 65 20 63 6f 6d 6d | 61 6e 64 20 6e 61 6d 65 |the comm|and name|
|00001bd0| 73 20 61 70 70 65 61 72 | 20 68 65 72 65 20 69 6e |s appear| here in|
|00001be0| 20 75 70 70 65 72 20 63 | 61 73 65 2c 0a 5c 42 69 | upper c|ase,.\Bi|
|00001bf0| 62 54 65 58 5c 20 69 67 | 6e 6f 72 65 73 20 63 61 |bTeX\ ig|nores ca|
|00001c00| 73 65 20 64 69 66 66 65 | 72 65 6e 63 65 73 2e 0a |se diffe|rences..|
|00001c10| 0a 53 6f 6d 65 20 72 65 | 73 74 72 69 63 74 69 6f |.Some re|strictio|
|00001c20| 6e 73 3a 0a 54 68 65 72 | 65 20 6d 75 73 74 20 62 |ns:.Ther|e must b|
|00001c30| 65 20 65 78 61 63 74 6c | 79 20 6f 6e 65 20 5c 68 |e exactl|y one \h|
|00001c40| 62 6f 78 7b 5c 74 74 20 | 45 4e 54 52 59 7d 20 61 |box{\tt |ENTRY} a|
|00001c50| 6e 64 20 6f 6e 65 20 5c | 68 62 6f 78 7b 5c 74 74 |nd one \|hbox{\tt|
|00001c60| 20 52 45 41 44 7d 20 63 | 6f 6d 6d 61 6e 64 3b 0a | READ} c|ommand;.|
|00001c70| 74 68 65 20 5c 68 62 6f | 78 7b 5c 74 74 20 45 4e |the \hbo|x{\tt EN|
|00001c80| 54 52 59 7d 20 63 6f 6d | 6d 61 6e 64 2c 20 61 6c |TRY} com|mand, al|
|00001c90| 6c 20 5c 68 62 6f 78 7b | 5c 74 74 20 4d 41 43 52 |l \hbox{|\tt MACR|
|00001ca0| 4f 7d 20 63 6f 6d 6d 61 | 6e 64 73 2c 0a 61 6e 64 |O} comma|nds,.and|
|00001cb0| 20 63 65 72 74 61 69 6e | 20 5c 68 62 6f 78 7b 5c | certain| \hbox{\|
|00001cc0| 74 74 20 46 55 4e 43 54 | 49 4f 4e 7d 20 63 6f 6d |tt FUNCT|ION} com|
|00001cd0| 6d 61 6e 64 73 0a 28 73 | 65 65 20 6e 65 78 74 20 |mands.(s|ee next |
|00001ce0| 73 75 62 73 65 63 74 69 | 6f 6e 27 73 20 64 65 73 |subsecti|on's des|
|00001cf0| 63 72 69 70 74 69 6f 6e | 20 6f 66 20 5c 68 62 6f |cription| of \hbo|
|00001d00| 78 7b 5c 74 74 20 63 61 | 6c 6c 2e 74 79 70 65 5c |x{\tt ca|ll.type\|
|00001d10| 24 7d 29 0a 6d 75 73 74 | 20 70 72 65 63 65 64 65 |$}).must| precede|
|00001d20| 20 74 68 65 20 5c 68 62 | 6f 78 7b 5c 74 74 20 52 | the \hb|ox{\tt R|
|00001d30| 45 41 44 7d 20 63 6f 6d | 6d 61 6e 64 3b 0a 61 6e |EAD} com|mand;.an|
|00001d40| 64 20 74 68 65 20 5c 68 | 62 6f 78 7b 5c 74 74 20 |d the \h|box{\tt |
|00001d50| 52 45 41 44 7d 20 63 6f | 6d 6d 61 6e 64 20 6d 75 |READ} co|mmand mu|
|00001d60| 73 74 20 70 72 65 63 65 | 64 65 20 74 68 65 20 66 |st prece|de the f|
|00001d70| 6f 75 72 20 74 68 61 74 | 0a 6d 61 6e 69 70 75 6c |our that|.manipul|
|00001d80| 61 74 65 20 74 68 65 20 | 65 6e 74 72 69 65 73 20 |ate the |entries |
|00001d90| 61 6e 64 20 70 72 6f 64 | 75 63 65 20 6f 75 74 70 |and prod|uce outp|
|00001da0| 75 74 2e 0a 0a 41 6c 73 | 6f 20 69 74 27 73 20 62 |ut...Als|o it's b|
|00001db0| 65 73 74 20 28 62 75 74 | 20 6e 6f 74 20 65 73 73 |est (but| not ess|
|00001dc0| 65 6e 74 69 61 6c 29 20 | 74 6f 20 6c 65 61 76 65 |ential) |to leave|
|00001dd0| 20 61 74 20 6c 65 61 73 | 74 20 6f 6e 65 20 62 6c | at leas|t one bl|
|00001de0| 61 6e 6b 20 6c 69 6e 65 | 0a 62 65 74 77 65 65 6e |ank line|.between|
|00001df0| 20 63 6f 6d 6d 61 6e 64 | 73 20 61 6e 64 20 74 6f | command|s and to|
|00001e00| 20 6c 65 61 76 65 20 6e | 6f 20 62 6c 61 6e 6b 20 | leave n|o blank |
|00001e10| 6c 69 6e 65 73 20 77 69 | 74 68 69 6e 20 61 20 63 |lines wi|thin a c|
|00001e20| 6f 6d 6d 61 6e 64 3b 0a | 74 68 69 73 20 68 65 6c |ommand;.|this hel|
|00001e30| 70 73 20 5c 42 69 62 54 | 65 58 5c 20 72 65 63 6f |ps \BibT|eX\ reco|
|00001e40| 76 65 72 20 66 72 6f 6d | 20 61 6e 79 20 73 79 6e |ver from| any syn|
|00001e50| 74 61 78 20 65 72 72 6f | 72 73 20 79 6f 75 20 6d |tax erro|rs you m|
|00001e60| 61 6b 65 2e 0a 0a 59 6f | 75 20 6d 75 73 74 20 65 |ake...Yo|u must e|
|00001e70| 6e 63 6c 6f 73 65 20 65 | 61 63 68 20 61 72 67 75 |nclose e|ach argu|
|00001e80| 6d 65 6e 74 20 6f 66 20 | 65 76 65 72 79 20 63 6f |ment of |every co|
|00001e90| 6d 6d 61 6e 64 20 69 6e | 20 62 72 61 63 65 73 2e |mmand in| braces.|
|00001ea0| 0a 4c 6f 6f 6b 20 61 74 | 20 74 68 65 20 73 74 61 |.Look at| the sta|
|00001eb0| 6e 64 61 72 64 2d 73 74 | 79 6c 65 20 64 6f 63 75 |ndard-st|yle docu|
|00001ec0| 6d 65 6e 74 61 74 69 6f | 6e 0a 66 6f 72 20 73 79 |mentatio|n.for sy|
|00001ed0| 6e 74 61 63 74 69 63 20 | 69 73 73 75 65 73 20 6e |ntactic |issues n|
|00001ee0| 6f 74 20 64 65 73 63 72 | 69 62 65 64 20 69 6e 20 |ot descr|ibed in |
|00001ef0| 74 68 69 73 20 73 65 63 | 74 69 6f 6e 2e 0a 48 65 |this sec|tion..He|
|00001f00| 72 65 20 61 72 65 20 74 | 68 65 20 74 65 6e 20 63 |re are t|he ten c|
|00001f10| 6f 6d 6d 61 6e 64 73 3a | 0a 5c 62 65 67 69 6e 7b |ommands:|.\begin{|
|00001f20| 64 65 73 63 72 69 70 74 | 69 6f 6e 7d 0a 0a 5c 69 |descript|ion}..\i|
|00001f30| 74 65 6d 5b 5c 68 62 6f | 78 7b 5c 74 74 20 45 4e |tem[\hbo|x{\tt EN|
|00001f40| 54 52 59 7d 5c 68 66 69 | 6c 6c 5d 0a 44 65 63 6c |TRY}\hfi|ll].Decl|
|00001f50| 61 72 65 73 20 74 68 65 | 20 66 69 65 6c 64 73 20 |ares the| fields |
|00001f60| 61 6e 64 20 65 6e 74 72 | 79 20 76 61 72 69 61 62 |and entr|y variab|
|00001f70| 6c 65 73 2e 0a 49 74 20 | 68 61 73 20 74 68 72 65 |les..It |has thre|
|00001f80| 65 20 61 72 67 75 6d 65 | 6e 74 73 2c 20 65 61 63 |e argume|nts, eac|
|00001f90| 68 20 61 20 28 70 6f 73 | 73 69 62 6c 79 20 65 6d |h a (pos|sibly em|
|00001fa0| 70 74 79 29 20 6c 69 73 | 74 20 6f 66 20 76 61 72 |pty) lis|t of var|
|00001fb0| 69 61 62 6c 65 20 6e 61 | 6d 65 73 2e 0a 54 68 65 |iable na|mes..The|
|00001fc0| 20 74 68 72 65 65 20 6c | 69 73 74 73 20 61 72 65 | three l|ists are|
|00001fd0| 20 6f 66 3a 0a 66 69 65 | 6c 64 73 2c 20 69 6e 74 | of:.fie|lds, int|
|00001fe0| 65 67 65 72 20 65 6e 74 | 72 79 20 76 61 72 69 61 |eger ent|ry varia|
|00001ff0| 62 6c 65 73 2c 20 61 6e | 64 20 73 74 72 69 6e 67 |bles, an|d string|
|00002000| 20 65 6e 74 72 79 20 76 | 61 72 69 61 62 6c 65 73 | entry v|ariables|
|00002010| 2e 0a 54 68 65 72 65 20 | 69 73 20 61 6e 20 61 64 |..There |is an ad|
|00002020| 64 69 74 69 6f 6e 61 6c | 20 66 69 65 6c 64 20 74 |ditional| field t|
|00002030| 68 61 74 20 5c 42 69 62 | 54 65 58 5c 20 61 75 74 |hat \Bib|TeX\ aut|
|00002040| 6f 6d 61 74 69 63 61 6c | 6c 79 0a 64 65 63 6c 61 |omatical|ly.decla|
|00002050| 72 65 73 2c 20 5c 68 62 | 6f 78 7b 5c 74 74 20 63 |res, \hb|ox{\tt c|
|00002060| 72 6f 73 73 72 65 66 7d | 2c 20 75 73 65 64 20 66 |rossref}|, used f|
|00002070| 6f 72 20 63 72 6f 73 73 | 20 72 65 66 65 72 65 6e |or cross| referen|
|00002080| 63 69 6e 67 2e 0a 41 6e | 64 20 74 68 65 72 65 20 |cing..An|d there |
|00002090| 69 73 20 61 6e 20 61 64 | 64 69 74 69 6f 6e 61 6c |is an ad|ditional|
|000020a0| 20 73 74 72 69 6e 67 20 | 65 6e 74 72 79 20 76 61 | string |entry va|
|000020b0| 72 69 61 62 6c 65 20 61 | 75 74 6f 6d 61 74 69 63 |riable a|utomatic|
|000020c0| 61 6c 6c 79 20 64 65 63 | 6c 61 72 65 64 2c 0a 5c |ally dec|lared,.\|
|000020d0| 68 62 6f 78 7b 5c 74 74 | 20 73 6f 72 74 2e 6b 65 |hbox{\tt| sort.ke|
|000020e0| 79 5c 24 7d 2c 20 75 73 | 65 64 20 62 79 20 74 68 |y\$}, us|ed by th|
|000020f0| 65 20 5c 68 62 6f 78 7b | 5c 74 74 20 53 4f 52 54 |e \hbox{|\tt SORT|
|00002100| 7d 20 63 6f 6d 6d 61 6e | 64 2e 0a 45 61 63 68 20 |} comman|d..Each |
|00002110| 6f 66 20 74 68 65 73 65 | 20 76 61 72 69 61 62 6c |of these| variabl|
|00002120| 65 73 20 68 61 73 20 61 | 20 76 61 6c 75 65 20 66 |es has a| value f|
|00002130| 6f 72 20 65 61 63 68 20 | 65 6e 74 72 79 20 6f 6e |or each |entry on|
|00002140| 20 74 68 65 20 6c 69 73 | 74 2e 0a 0a 5c 69 74 65 | the lis|t...\ite|
|00002150| 6d 5b 5c 68 62 6f 78 7b | 5c 74 74 20 45 58 45 43 |m[\hbox{|\tt EXEC|
|00002160| 55 54 45 7d 5c 68 66 69 | 6c 6c 5d 0a 45 78 65 63 |UTE}\hfi|ll].Exec|
|00002170| 75 74 65 73 20 61 20 73 | 69 6e 67 6c 65 20 66 75 |utes a s|ingle fu|
|00002180| 6e 63 74 69 6f 6e 2e 0a | 49 74 20 68 61 73 20 6f |nction..|It has o|
|00002190| 6e 65 20 61 72 67 75 6d | 65 6e 74 2c 20 74 68 65 |ne argum|ent, the|
|000021a0| 20 66 75 6e 63 74 69 6f | 6e 20 6e 61 6d 65 2e 0a | functio|n name..|
|000021b0| 0a 5c 69 74 65 6d 5b 5c | 68 62 6f 78 7b 5c 74 74 |.\item[\|hbox{\tt|
|000021c0| 20 46 55 4e 43 54 49 4f | 4e 7d 5c 68 66 69 6c 6c | FUNCTIO|N}\hfill|
|000021d0| 5d 0a 44 65 66 69 6e 65 | 73 20 61 20 6e 65 77 20 |].Define|s a new |
|000021e0| 66 75 6e 63 74 69 6f 6e | 2e 0a 49 74 20 68 61 73 |function|..It has|
|000021f0| 20 74 77 6f 20 61 72 67 | 75 6d 65 6e 74 73 3b 20 | two arg|uments; |
|00002200| 74 68 65 20 66 69 72 73 | 74 20 69 73 20 74 68 65 |the firs|t is the|
|00002210| 20 66 75 6e 63 74 69 6f | 6e 27 73 20 6e 61 6d 65 | functio|n's name|
|00002220| 20 61 6e 64 20 74 68 65 | 0a 73 65 63 6f 6e 64 20 | and the|.second |
|00002230| 69 73 20 69 74 73 20 64 | 65 66 69 6e 69 74 69 6f |is its d|efinitio|
|00002240| 6e 2e 0a 59 6f 75 20 6d | 75 73 74 20 64 65 66 69 |n..You m|ust defi|
|00002250| 6e 65 20 61 20 66 75 6e | 63 74 69 6f 6e 20 62 65 |ne a fun|ction be|
|00002260| 66 6f 72 65 20 75 73 69 | 6e 67 20 69 74 3b 0a 72 |fore usi|ng it;.r|
|00002270| 65 63 75 72 73 69 76 65 | 20 66 75 6e 63 74 69 6f |ecursive| functio|
|00002280| 6e 73 20 61 72 65 20 74 | 68 75 73 20 69 6c 6c 65 |ns are t|hus ille|
|00002290| 67 61 6c 2e 0a 0a 5c 69 | 74 65 6d 5b 5c 68 62 6f |gal...\i|tem[\hbo|
|000022a0| 78 7b 5c 74 74 20 49 4e | 54 45 47 45 52 53 7d 5c |x{\tt IN|TEGERS}\|
|000022b0| 68 66 69 6c 6c 5d 0a 44 | 65 63 6c 61 72 65 73 20 |hfill].D|eclares |
|000022c0| 67 6c 6f 62 61 6c 20 69 | 6e 74 65 67 65 72 20 76 |global i|nteger v|
|000022d0| 61 72 69 61 62 6c 65 73 | 2e 0a 49 74 20 68 61 73 |ariables|..It has|
|000022e0| 20 6f 6e 65 20 61 72 67 | 75 6d 65 6e 74 2c 20 61 | one arg|ument, a|
|000022f0| 20 6c 69 73 74 20 6f 66 | 20 76 61 72 69 61 62 6c | list of| variabl|
|00002300| 65 20 6e 61 6d 65 73 2e | 0a 54 68 65 72 65 20 61 |e names.|.There a|
|00002310| 72 65 20 74 77 6f 20 73 | 75 63 68 20 61 75 74 6f |re two s|uch auto|
|00002320| 6d 61 74 69 63 61 6c 6c | 79 2d 64 65 63 6c 61 72 |maticall|y-declar|
|00002330| 65 64 20 76 61 72 69 61 | 62 6c 65 73 2c 0a 5c 68 |ed varia|bles,.\h|
|00002340| 62 6f 78 7b 5c 74 74 20 | 65 6e 74 72 79 2e 6d 61 |box{\tt |entry.ma|
|00002350| 78 5c 24 7d 20 61 6e 64 | 20 5c 68 62 6f 78 7b 5c |x\$} and| \hbox{\|
|00002360| 74 74 20 67 6c 6f 62 61 | 6c 2e 6d 61 78 5c 24 7d |tt globa|l.max\$}|
|00002370| 2c 0a 75 73 65 64 20 66 | 6f 72 20 6c 69 6d 69 74 |,.used f|or limit|
|00002380| 69 6e 67 20 74 68 65 20 | 6c 65 6e 67 74 68 73 20 |ing the |lengths |
|00002390| 6f 66 20 73 74 72 69 6e | 67 20 76 61 72 69 61 62 |of strin|g variab|
|000023a0| 6c 65 73 2e 0a 59 6f 75 | 20 6d 61 79 20 68 61 76 |les..You| may hav|
|000023b0| 65 20 61 6e 79 20 6e 75 | 6d 62 65 72 20 6f 66 20 |e any nu|mber of |
|000023c0| 74 68 65 73 65 20 63 6f | 6d 6d 61 6e 64 73 2c 20 |these co|mmands, |
|000023d0| 62 75 74 20 61 20 76 61 | 72 69 61 62 6c 65 27 73 |but a va|riable's|
|000023e0| 20 64 65 63 6c 61 72 61 | 74 69 6f 6e 0a 6d 75 73 | declara|tion.mus|
|000023f0| 74 20 70 72 65 63 65 64 | 65 20 69 74 73 20 75 73 |t preced|e its us|
|00002400| 65 2e 0a 0a 5c 69 74 65 | 6d 5b 5c 68 62 6f 78 7b |e...\ite|m[\hbox{|
|00002410| 5c 74 74 20 49 54 45 52 | 41 54 45 7d 5c 68 66 69 |\tt ITER|ATE}\hfi|
|00002420| 6c 6c 5d 0a 45 78 65 63 | 75 74 65 73 20 61 20 73 |ll].Exec|utes a s|
|00002430| 69 6e 67 6c 65 20 66 75 | 6e 63 74 69 6f 6e 2c 20 |ingle fu|nction, |
|00002440| 6f 6e 63 65 0a 66 6f 72 | 20 65 61 63 68 20 65 6e |once.for| each en|
|00002450| 74 72 79 20 69 6e 20 74 | 68 65 20 6c 69 73 74 2c |try in t|he list,|
|00002460| 20 69 6e 20 74 68 65 20 | 6c 69 73 74 27 73 20 63 | in the |list's c|
|00002470| 75 72 72 65 6e 74 20 6f | 72 64 65 72 0a 28 69 6e |urrent o|rder.(in|
|00002480| 69 74 69 61 6c 6c 79 20 | 74 68 65 20 6c 69 73 74 |itially |the list|
|00002490| 20 69 73 20 69 6e 20 63 | 69 74 61 74 69 6f 6e 20 | is in c|itation |
|000024a0| 6f 72 64 65 72 2c 20 62 | 75 74 20 74 68 65 20 5c |order, b|ut the \|
|000024b0| 68 62 6f 78 7b 5c 74 74 | 20 53 4f 52 54 7d 0a 63 |hbox{\tt| SORT}.c|
|000024c0| 6f 6d 6d 61 6e 64 20 6d | 61 79 20 63 68 61 6e 67 |ommand m|ay chang|
|000024d0| 65 20 74 68 69 73 29 2e | 0a 49 74 20 68 61 73 20 |e this).|.It has |
|000024e0| 6f 6e 65 20 61 72 67 75 | 6d 65 6e 74 2c 20 74 68 |one argu|ment, th|
|000024f0| 65 20 66 75 6e 63 74 69 | 6f 6e 20 6e 61 6d 65 2e |e functi|on name.|
|00002500| 0a 0a 5c 69 74 65 6d 5b | 5c 68 62 6f 78 7b 5c 74 |..\item[|\hbox{\t|
|00002510| 74 20 4d 41 43 52 4f 7d | 5c 68 66 69 6c 6c 5d 0a |t MACRO}|\hfill].|
|00002520| 44 65 66 69 6e 65 73 20 | 61 20 73 74 72 69 6e 67 |Defines |a string|
|00002530| 20 6d 61 63 72 6f 2e 0a | 49 74 20 68 61 73 20 74 | macro..|It has t|
|00002540| 77 6f 20 61 72 67 75 6d | 65 6e 74 73 3b 20 74 68 |wo argum|ents; th|
|00002550| 65 20 66 69 72 73 74 20 | 69 73 20 74 68 65 20 6d |e first |is the m|
|00002560| 61 63 72 6f 27 73 20 6e | 61 6d 65 2c 20 77 68 69 |acro's n|ame, whi|
|00002570| 63 68 20 69 73 20 74 72 | 65 61 74 65 64 20 6c 69 |ch is tr|eated li|
|00002580| 6b 65 0a 61 6e 79 20 6f | 74 68 65 72 20 76 61 72 |ke.any o|ther var|
|00002590| 69 61 62 6c 65 20 6f 72 | 20 66 75 6e 63 74 69 6f |iable or| functio|
|000025a0| 6e 20 6e 61 6d 65 2c 0a | 61 6e 64 20 74 68 65 20 |n name,.|and the |
|000025b0| 73 65 63 6f 6e 64 20 69 | 73 20 69 74 73 20 64 65 |second i|s its de|
|000025c0| 66 69 6e 69 74 69 6f 6e | 2c 20 77 68 69 63 68 20 |finition|, which |
|000025d0| 6d 75 73 74 20 62 65 20 | 64 6f 75 62 6c 65 2d 71 |must be |double-q|
|000025e0| 75 6f 74 65 2d 64 65 6c | 69 6d 69 74 65 64 2e 0a |uote-del|imited..|
|000025f0| 59 6f 75 20 6d 75 73 74 | 20 68 61 76 65 20 6f 6e |You must| have on|
|00002600| 65 20 66 6f 72 20 65 61 | 63 68 20 74 68 72 65 65 |e for ea|ch three|
|00002610| 2d 6c 65 74 74 65 72 20 | 6d 6f 6e 74 68 20 61 62 |-letter |month ab|
|00002620| 62 72 65 76 69 61 74 69 | 6f 6e 3b 0a 69 6e 20 61 |breviati|on;.in a|
|00002630| 64 64 69 74 69 6f 6e 2c | 20 79 6f 75 20 73 68 6f |ddition,| you sho|
|00002640| 75 6c 64 20 68 61 76 65 | 20 6f 6e 65 20 66 6f 72 |uld have| one for|
|00002650| 20 63 6f 6d 6d 6f 6e 20 | 6a 6f 75 72 6e 61 6c 20 | common |journal |
|00002660| 6e 61 6d 65 73 2e 0a 54 | 68 65 20 75 73 65 72 27 |names..T|he user'|
|00002670| 73 20 64 61 74 61 62 61 | 73 65 20 6d 61 79 20 6f |s databa|se may o|
|00002680| 76 65 72 72 69 64 65 20 | 61 6e 79 20 64 65 66 69 |verride |any defi|
|00002690| 6e 69 74 69 6f 6e 20 79 | 6f 75 20 64 65 66 69 6e |nition y|ou defin|
|000026a0| 65 20 75 73 69 6e 67 20 | 74 68 69 73 20 63 6f 6d |e using |this com|
|000026b0| 6d 61 6e 64 2e 0a 49 66 | 20 79 6f 75 20 77 61 6e |mand..If| you wan|
|000026c0| 74 20 74 6f 20 64 65 66 | 69 6e 65 20 61 20 73 74 |t to def|ine a st|
|000026d0| 72 69 6e 67 20 74 68 65 | 20 75 73 65 72 20 63 61 |ring the| user ca|
|000026e0| 6e 27 74 20 74 6f 75 63 | 68 2c 0a 75 73 65 20 74 |n't touc|h,.use t|
|000026f0| 68 65 20 5c 68 62 6f 78 | 7b 5c 74 74 20 46 55 4e |he \hbox|{\tt FUN|
|00002700| 43 54 49 4f 4e 7d 20 63 | 6f 6d 6d 61 6e 64 2c 20 |CTION} c|ommand, |
|00002710| 77 68 69 63 68 20 68 61 | 73 20 61 20 63 6f 6d 70 |which ha|s a comp|
|00002720| 61 74 69 62 6c 65 20 73 | 79 6e 74 61 78 2e 0a 0a |atible s|yntax...|
|00002730| 5c 69 74 65 6d 5b 5c 68 | 62 6f 78 7b 5c 74 74 20 |\item[\h|box{\tt |
|00002740| 52 45 41 44 7d 5c 68 66 | 69 6c 6c 5d 0a 44 72 65 |READ}\hf|ill].Dre|
|00002750| 64 67 65 73 20 75 70 20 | 66 72 6f 6d 20 74 68 65 |dges up |from the|
|00002760| 20 64 61 74 61 62 61 73 | 65 20 66 69 6c 65 0a 74 | databas|e file.t|
|00002770| 68 65 20 66 69 65 6c 64 | 20 76 61 6c 75 65 73 20 |he field| values |
|00002780| 66 6f 72 20 65 61 63 68 | 20 65 6e 74 72 79 20 69 |for each| entry i|
|00002790| 6e 20 74 68 65 20 6c 69 | 73 74 2e 0a 49 74 20 68 |n the li|st..It h|
|000027a0| 61 73 20 6e 6f 20 61 72 | 67 75 6d 65 6e 74 73 2e |as no ar|guments.|
|000027b0| 0a 49 66 20 61 20 64 61 | 74 61 62 61 73 65 20 65 |.If a da|tabase e|
|000027c0| 6e 74 72 79 20 64 6f 65 | 73 6e 27 74 20 68 61 76 |ntry doe|sn't hav|
|000027d0| 65 20 61 20 76 61 6c 75 | 65 20 66 6f 72 20 61 20 |e a valu|e for a |
|000027e0| 66 69 65 6c 64 0a 28 61 | 6e 64 20 70 72 6f 62 61 |field.(a|nd proba|
|000027f0| 62 6c 79 20 6e 6f 20 64 | 61 74 61 62 61 73 65 20 |bly no d|atabase |
|00002800| 65 6e 74 72 79 20 77 69 | 6c 6c 20 68 61 76 65 20 |entry wi|ll have |
|00002810| 61 20 76 61 6c 75 65 20 | 66 6f 72 20 65 76 65 72 |a value |for ever|
|00002820| 79 20 66 69 65 6c 64 29 | 2c 0a 74 68 61 74 20 66 |y field)|,.that f|
|00002830| 69 65 6c 64 20 76 61 72 | 69 61 62 6c 65 20 69 73 |ield var|iable is|
|00002840| 20 6d 61 72 6b 65 64 20 | 61 73 20 6d 69 73 73 69 | marked |as missi|
|00002850| 6e 67 20 66 6f 72 20 74 | 68 65 20 65 6e 74 72 79 |ng for t|he entry|
|00002860| 2e 0a 0a 5c 69 74 65 6d | 5b 5c 68 62 6f 78 7b 5c |...\item|[\hbox{\|
|00002870| 74 74 20 52 45 56 45 52 | 53 45 7d 5c 68 66 69 6c |tt REVER|SE}\hfil|
|00002880| 6c 5d 0a 45 78 61 63 74 | 6c 79 20 74 68 65 20 73 |l].Exact|ly the s|
|00002890| 61 6d 65 20 61 73 20 74 | 68 65 0a 5c 68 62 6f 78 |ame as t|he.\hbox|
|000028a0| 7b 5c 74 74 20 49 54 45 | 52 41 54 45 7d 20 63 6f |{\tt ITE|RATE} co|
|000028b0| 6d 6d 61 6e 64 20 65 78 | 63 65 70 74 20 74 68 61 |mmand ex|cept tha|
|000028c0| 74 20 69 74 20 65 78 65 | 63 75 74 65 73 20 74 68 |t it exe|cutes th|
|000028d0| 65 20 66 75 6e 63 74 69 | 6f 6e 0a 6f 6e 20 74 68 |e functi|on.on th|
|000028e0| 65 20 65 6e 74 72 79 20 | 6c 69 73 74 20 69 6e 20 |e entry |list in |
|000028f0| 72 65 76 65 72 73 65 20 | 6f 72 64 65 72 2e 0a 0a |reverse |order...|
|00002900| 5c 69 74 65 6d 5b 5c 68 | 62 6f 78 7b 5c 74 74 20 |\item[\h|box{\tt |
|00002910| 53 4f 52 54 7d 5c 68 66 | 69 6c 6c 5d 0a 53 6f 72 |SORT}\hf|ill].Sor|
|00002920| 74 73 20 74 68 65 20 65 | 6e 74 72 79 20 6c 69 73 |ts the e|ntry lis|
|00002930| 74 20 75 73 69 6e 67 0a | 74 68 65 20 76 61 6c 75 |t using.|the valu|
|00002940| 65 73 20 6f 66 20 74 68 | 65 20 73 74 72 69 6e 67 |es of th|e string|
|00002950| 20 65 6e 74 72 79 20 76 | 61 72 69 61 62 6c 65 20 | entry v|ariable |
|00002960| 5c 68 62 6f 78 7b 5c 74 | 74 20 73 6f 72 74 2e 6b |\hbox{\t|t sort.k|
|00002970| 65 79 5c 24 7d 2e 0a 49 | 74 20 68 61 73 20 6e 6f |ey\$}..I|t has no|
|00002980| 20 61 72 67 75 6d 65 6e | 74 73 2e 0a 0a 5c 69 74 | argumen|ts...\it|
|00002990| 65 6d 5b 5c 68 62 6f 78 | 7b 5c 74 74 20 53 54 52 |em[\hbox|{\tt STR|
|000029a0| 49 4e 47 53 7d 5c 68 66 | 69 6c 6c 5d 0a 44 65 63 |INGS}\hf|ill].Dec|
|000029b0| 6c 61 72 65 73 20 67 6c | 6f 62 61 6c 20 73 74 72 |lares gl|obal str|
|000029c0| 69 6e 67 20 76 61 72 69 | 61 62 6c 65 73 2e 0a 49 |ing vari|ables..I|
|000029d0| 74 20 68 61 73 20 6f 6e | 65 20 61 72 67 75 6d 65 |t has on|e argume|
|000029e0| 6e 74 2c 20 61 20 6c 69 | 73 74 20 6f 66 20 76 61 |nt, a li|st of va|
|000029f0| 72 69 61 62 6c 65 20 6e | 61 6d 65 73 2e 0a 59 6f |riable n|ames..Yo|
|00002a00| 75 20 6d 61 79 20 68 61 | 76 65 20 61 6e 79 20 6e |u may ha|ve any n|
|00002a10| 75 6d 62 65 72 20 6f 66 | 20 74 68 65 73 65 20 63 |umber of| these c|
|00002a20| 6f 6d 6d 61 6e 64 73 2c | 20 62 75 74 20 61 20 76 |ommands,| but a v|
|00002a30| 61 72 69 61 62 6c 65 27 | 73 20 64 65 63 6c 61 72 |ariable'|s declar|
|00002a40| 61 74 69 6f 6e 0a 6d 75 | 73 74 20 70 72 65 63 65 |ation.mu|st prece|
|00002a50| 64 65 20 69 74 73 20 75 | 73 65 2e 0a 5c 65 6e 64 |de its u|se..\end|
|00002a60| 7b 64 65 73 63 72 69 70 | 74 69 6f 6e 7d 0a 0a 0a |{descrip|tion}...|
|00002a70| 5c 73 75 62 73 65 63 74 | 69 6f 6e 7b 54 68 65 20 |\subsect|ion{The |
|00002a80| 62 75 69 6c 74 2d 69 6e | 20 66 75 6e 63 74 69 6f |built-in| functio|
|00002a90| 6e 73 7d 0a 5c 6c 61 62 | 65 6c 7b 62 75 69 6c 74 |ns}.\lab|el{built|
|00002aa0| 2d 69 6e 2d 66 6e 73 7d | 0a 0a 42 65 66 6f 72 65 |-in-fns}|..Before|
|00002ab0| 20 77 65 20 67 65 74 20 | 74 6f 20 74 68 65 20 62 | we get |to the b|
|00002ac0| 75 69 6c 74 2d 69 6e 20 | 66 75 6e 63 74 69 6f 6e |uilt-in |function|
|00002ad0| 73 2c 0a 61 20 66 65 77 | 20 77 6f 72 64 73 20 61 |s,.a few| words a|
|00002ae0| 62 6f 75 74 20 73 6f 6d | 65 20 6f 74 68 65 72 20 |bout som|e other |
|00002af0| 62 75 69 6c 74 2d 69 6e | 20 6f 62 6a 65 63 74 73 |built-in| objects|
|00002b00| 2e 0a 54 68 65 72 65 20 | 69 73 20 6f 6e 65 20 62 |..There |is one b|
|00002b10| 75 69 6c 74 2d 69 6e 20 | 73 74 72 69 6e 67 20 65 |uilt-in |string e|
|00002b20| 6e 74 72 79 20 76 61 72 | 69 61 62 6c 65 2c 20 5c |ntry var|iable, \|
|00002b30| 68 62 6f 78 7b 5c 74 74 | 20 73 6f 72 74 2e 6b 65 |hbox{\tt| sort.ke|
|00002b40| 79 5c 24 7d 2c 0a 77 68 | 69 63 68 20 74 68 65 20 |y\$},.wh|ich the |
|00002b50| 73 74 79 6c 65 20 70 72 | 6f 67 72 61 6d 20 6d 75 |style pr|ogram mu|
|00002b60| 73 74 20 73 65 74 20 69 | 66 20 74 68 65 20 73 74 |st set i|f the st|
|00002b70| 79 6c 65 20 69 73 20 74 | 6f 20 64 6f 20 73 6f 72 |yle is t|o do sor|
|00002b80| 74 69 6e 67 2e 0a 54 68 | 65 72 65 20 69 73 20 6f |ting..Th|ere is o|
|00002b90| 6e 65 20 62 75 69 6c 74 | 2d 69 6e 20 66 69 65 6c |ne built|-in fiel|
|00002ba0| 64 2c 20 5c 68 62 6f 78 | 7b 5c 74 74 20 63 72 6f |d, \hbox|{\tt cro|
|00002bb0| 73 73 72 65 66 7d 2c 0a | 75 73 65 64 20 66 6f 72 |ssref},.|used for|
|00002bc0| 20 74 68 65 20 63 72 6f | 73 73 20 72 65 66 65 72 | the cro|ss refer|
|00002bd0| 65 6e 63 69 6e 67 20 66 | 65 61 74 75 72 65 0a 64 |encing f|eature.d|
|00002be0| 65 73 63 72 69 62 65 64 | 20 69 6e 20 53 65 63 74 |escribed| in Sect|
|00002bf0| 69 6f 6e 7e 34 2e 0a 41 | 6e 64 20 74 68 65 72 65 |ion~4..A|nd there|
|00002c00| 20 61 72 65 20 74 77 6f | 20 62 75 69 6c 74 2d 69 | are two| built-i|
|00002c10| 6e 20 69 6e 74 65 67 65 | 72 20 67 6c 6f 62 61 6c |n intege|r global|
|00002c20| 20 76 61 72 69 61 62 6c | 65 73 2c 0a 5c 68 62 6f | variabl|es,.\hbo|
|00002c30| 78 7b 5c 74 74 20 65 6e | 74 72 79 2e 6d 61 78 5c |x{\tt en|try.max\|
|00002c40| 24 7d 20 61 6e 64 20 5c | 68 62 6f 78 7b 5c 74 74 |$} and \|hbox{\tt|
|00002c50| 20 67 6c 6f 62 61 6c 2e | 6d 61 78 5c 24 7d 2c 0a | global.|max\$},.|
|00002c60| 77 68 69 63 68 20 61 72 | 65 20 73 65 74 20 62 79 |which ar|e set by|
|00002c70| 20 64 65 66 61 75 6c 74 | 20 74 6f 20 73 6f 6d 65 | default| to some|
|00002c80| 20 69 6e 74 65 72 6e 61 | 6c 20 5c 42 69 62 54 65 | interna|l \BibTe|
|00002c90| 58 5c 20 63 6f 6e 73 74 | 61 6e 74 73 3b 0a 79 6f |X\ const|ants;.yo|
|00002ca0| 75 20 73 68 6f 75 6c 64 | 20 74 72 75 6e 63 61 74 |u should| truncat|
|00002cb0| 65 20 73 74 72 69 6e 67 | 73 20 74 6f 20 74 68 65 |e string|s to the|
|00002cc0| 73 65 20 6c 65 6e 67 74 | 68 73 20 62 65 66 6f 72 |se lengt|hs befor|
|00002cd0| 65 0a 79 6f 75 20 61 73 | 73 69 67 6e 20 74 6f 20 |e.you as|sign to |
|00002ce0| 73 74 72 69 6e 67 20 76 | 61 72 69 61 62 6c 65 73 |string v|ariables|
|00002cf0| 2c 0a 73 6f 20 61 73 20 | 74 6f 20 6e 6f 74 20 67 |,.so as |to not g|
|00002d00| 65 6e 65 72 61 74 65 20 | 61 6e 79 20 5c 42 69 62 |enerate |any \Bib|
|00002d10| 54 65 58 5c 20 77 61 72 | 6e 69 6e 67 20 6d 65 73 |TeX\ war|ning mes|
|00002d20| 73 61 67 65 73 2e 0a 0a | 54 68 65 72 65 20 61 72 |sages...|There ar|
|00002d30| 65 20 63 75 72 72 65 6e | 74 6c 79 20 33 37 20 62 |e curren|tly 37 b|
|00002d40| 75 69 6c 74 2d 69 6e 20 | 66 75 6e 63 74 69 6f 6e |uilt-in |function|
|00002d50| 73 2e 0a 45 76 65 72 79 | 20 62 75 69 6c 74 2d 69 |s..Every| built-i|
|00002d60| 6e 20 66 75 6e 63 74 69 | 6f 6e 20 77 69 74 68 20 |n functi|on with |
|00002d70| 61 20 6c 65 74 74 65 72 | 20 69 6e 20 69 74 73 20 |a letter| in its |
|00002d80| 6e 61 6d 65 20 65 6e 64 | 73 20 77 69 74 68 20 61 |name end|s with a|
|00002d90| 20 60 7b 5c 74 74 20 5c | 24 7d 27 24 5c 21 24 2e | `{\tt \|$}'$\!$.|
|00002da0| 0a 49 6e 20 77 68 61 74 | 20 66 6f 6c 6c 6f 77 73 |.In what| follows|
|00002db0| 2c 20 60 60 66 69 72 73 | 74 27 27 24 5c 21 24 2c |, ``firs|t''$\!$,|
|00002dc0| 20 60 60 73 65 63 6f 6e | 64 27 27 24 5c 21 24 2c | ``secon|d''$\!$,|
|00002dd0| 0a 61 6e 64 20 73 6f 20 | 6f 6e 20 72 65 66 65 72 |.and so |on refer|
|00002de0| 20 74 6f 20 74 68 65 20 | 6f 72 64 65 72 20 70 6f | to the |order po|
|00002df0| 70 70 65 64 2e 0a 41 20 | 60 60 6c 69 74 65 72 61 |pped..A |``litera|
|00002e00| 6c 27 27 20 69 73 20 61 | 6e 20 65 6c 65 6d 65 6e |l'' is a|n elemen|
|00002e10| 74 20 6f 6e 20 74 68 65 | 20 73 74 61 63 6b 2c 20 |t on the| stack, |
|00002e20| 61 6e 64 20 69 74 20 77 | 69 6c 6c 20 62 65 20 65 |and it w|ill be e|
|00002e30| 69 74 68 65 72 0a 61 6e | 20 69 6e 74 65 67 65 72 |ither.an| integer|
|00002e40| 20 76 61 6c 75 65 2c 20 | 61 20 73 74 72 69 6e 67 | value, |a string|
|00002e50| 20 76 61 6c 75 65 2c 20 | 61 20 76 61 72 69 61 62 | value, |a variab|
|00002e60| 6c 65 20 6f 72 20 66 75 | 6e 63 74 69 6f 6e 20 6e |le or fu|nction n|
|00002e70| 61 6d 65 2c 0a 6f 72 20 | 61 20 73 70 65 63 69 61 |ame,.or |a specia|
|00002e80| 6c 20 76 61 6c 75 65 20 | 64 65 6e 6f 74 69 6e 67 |l value |denoting|
|00002e90| 20 61 20 6d 69 73 73 69 | 6e 67 20 66 69 65 6c 64 | a missi|ng field|
|00002ea0| 2e 0a 49 66 20 61 6e 79 | 20 70 6f 70 70 65 64 20 |..If any| popped |
|00002eb0| 6c 69 74 65 72 61 6c 20 | 68 61 73 20 61 6e 20 69 |literal |has an i|
|00002ec0| 6e 63 6f 72 72 65 63 74 | 20 74 79 70 65 2c 20 5c |ncorrect| type, \|
|00002ed0| 42 69 62 54 65 58 5c 20 | 63 6f 6d 70 6c 61 69 6e |BibTeX\ |complain|
|00002ee0| 73 20 61 6e 64 20 70 75 | 73 68 65 73 0a 74 68 65 |s and pu|shes.the|
|00002ef0| 20 69 6e 74 65 67 65 72 | 20 30 20 6f 72 20 74 68 | integer| 0 or th|
|00002f00| 65 20 6e 75 6c 6c 20 73 | 74 72 69 6e 67 2c 20 64 |e null s|tring, d|
|00002f10| 65 70 65 6e 64 69 6e 67 | 20 6f 6e 20 77 68 65 74 |epending| on whet|
|00002f20| 68 65 72 20 74 68 65 20 | 66 75 6e 63 74 69 6f 6e |her the |function|
|00002f30| 0a 77 61 73 20 73 75 70 | 70 6f 73 65 64 20 74 6f |.was sup|posed to|
|00002f40| 20 70 75 73 68 20 61 6e | 20 69 6e 74 65 67 65 72 | push an| integer|
|00002f50| 20 6f 72 20 73 74 72 69 | 6e 67 2e 0a 5c 62 65 67 | or stri|ng..\beg|
|00002f60| 69 6e 7b 64 65 73 63 72 | 69 70 74 69 6f 6e 7d 0a |in{descr|iption}.|
|00002f70| 0a 5c 69 74 65 6d 5b 5c | 68 62 6f 78 7b 5c 74 74 |.\item[\|hbox{\tt|
|00002f80| 20 3e 7d 5c 68 66 69 6c | 6c 5d 0a 50 6f 70 73 20 | >}\hfil|l].Pops |
|00002f90| 74 68 65 20 74 6f 70 20 | 74 77 6f 20 28 69 6e 74 |the top |two (int|
|00002fa0| 65 67 65 72 29 20 6c 69 | 74 65 72 61 6c 73 2c 0a |eger) li|terals,.|
|00002fb0| 63 6f 6d 70 61 72 65 73 | 20 74 68 65 6d 2c 20 61 |compares| them, a|
|00002fc0| 6e 64 20 70 75 73 68 65 | 73 20 74 68 65 20 69 6e |nd pushe|s the in|
|00002fd0| 74 65 67 65 72 20 31 20 | 69 66 20 74 68 65 20 73 |teger 1 |if the s|
|00002fe0| 65 63 6f 6e 64 20 69 73 | 20 67 72 65 61 74 65 72 |econd is| greater|
|00002ff0| 20 74 68 61 6e 0a 74 68 | 65 20 66 69 72 73 74 2c | than.th|e first,|
|00003000| 20 30 20 6f 74 68 65 72 | 77 69 73 65 2e 0a 0a 5c | 0 other|wise...\|
|00003010| 69 74 65 6d 5b 5c 68 62 | 6f 78 7b 5c 74 74 20 3c |item[\hb|ox{\tt <|
|00003020| 7d 5c 68 66 69 6c 6c 5d | 0a 41 6e 61 6c 6f 67 6f |}\hfill]|.Analogo|
|00003030| 75 73 2e 0a 0a 5c 69 74 | 65 6d 5b 5c 68 62 6f 78 |us...\it|em[\hbox|
|00003040| 7b 5c 74 74 20 3d 7d 5c | 68 66 69 6c 6c 5d 0a 50 |{\tt =}\|hfill].P|
|00003050| 6f 70 73 20 74 68 65 20 | 74 6f 70 20 74 77 6f 20 |ops the |top two |
|00003060| 28 62 6f 74 68 20 69 6e | 74 65 67 65 72 20 6f 72 |(both in|teger or|
|00003070| 20 62 6f 74 68 20 73 74 | 72 69 6e 67 29 20 6c 69 | both st|ring) li|
|00003080| 74 65 72 61 6c 73 2c 0a | 63 6f 6d 70 61 72 65 73 |terals,.|compares|
|00003090| 20 74 68 65 6d 2c 0a 61 | 6e 64 20 70 75 73 68 65 | them,.a|nd pushe|
|000030a0| 73 20 74 68 65 20 69 6e | 74 65 67 65 72 20 31 20 |s the in|teger 1 |
|000030b0| 69 66 20 74 68 65 79 27 | 72 65 20 65 71 75 61 6c |if they'|re equal|
|000030c0| 2c 20 30 20 6f 74 68 65 | 72 77 69 73 65 2e 0a 0a |, 0 othe|rwise...|
|000030d0| 5c 69 74 65 6d 5b 5c 68 | 62 6f 78 7b 5c 74 74 20 |\item[\h|box{\tt |
|000030e0| 2b 7d 5c 68 66 69 6c 6c | 5d 0a 50 6f 70 73 20 74 |+}\hfill|].Pops t|
|000030f0| 68 65 20 74 6f 70 20 74 | 77 6f 20 28 69 6e 74 65 |he top t|wo (inte|
|00003100| 67 65 72 29 20 6c 69 74 | 65 72 61 6c 73 20 61 6e |ger) lit|erals an|
|00003110| 64 20 70 75 73 68 65 73 | 20 74 68 65 69 72 20 73 |d pushes| their s|
|00003120| 75 6d 2e 0a 0a 5c 69 74 | 65 6d 5b 5c 68 62 6f 78 |um...\it|em[\hbox|
|00003130| 7b 5c 74 74 20 2d 7d 5c | 68 66 69 6c 6c 5d 0a 50 |{\tt -}\|hfill].P|
|00003140| 6f 70 73 20 74 68 65 20 | 74 6f 70 20 74 77 6f 20 |ops the |top two |
|00003150| 28 69 6e 74 65 67 65 72 | 29 20 6c 69 74 65 72 61 |(integer|) litera|
|00003160| 6c 73 20 61 6e 64 20 70 | 75 73 68 65 73 20 74 68 |ls and p|ushes th|
|00003170| 65 69 72 20 64 69 66 66 | 65 72 65 6e 63 65 0a 28 |eir diff|erence.(|
|00003180| 74 68 65 20 66 69 72 73 | 74 20 73 75 62 74 72 61 |the firs|t subtra|
|00003190| 63 74 65 64 20 66 72 6f | 6d 20 74 68 65 20 73 65 |cted fro|m the se|
|000031a0| 63 6f 6e 64 29 2e 0a 0a | 5c 69 74 65 6d 5b 5c 68 |cond)...|\item[\h|
|000031b0| 62 6f 78 7b 5c 74 74 20 | 2a 7d 5c 68 66 69 6c 6c |box{\tt |*}\hfill|
|000031c0| 5d 0a 50 6f 70 73 20 74 | 68 65 20 74 6f 70 20 74 |].Pops t|he top t|
|000031d0| 77 6f 20 28 73 74 72 69 | 6e 67 29 20 6c 69 74 65 |wo (stri|ng) lite|
|000031e0| 72 61 6c 73 2c 0a 63 6f | 6e 63 61 74 65 6e 61 74 |rals,.co|ncatenat|
|000031f0| 65 73 20 74 68 65 6d 20 | 28 69 6e 20 72 65 76 65 |es them |(in reve|
|00003200| 72 73 65 20 6f 72 64 65 | 72 2c 20 74 68 61 74 20 |rse orde|r, that |
|00003210| 69 73 2c 20 74 68 65 20 | 6f 72 64 65 72 20 69 6e |is, the |order in|
|00003220| 20 77 68 69 63 68 0a 70 | 75 73 68 65 64 29 2c 20 | which.p|ushed), |
|00003230| 61 6e 64 20 70 75 73 68 | 65 73 20 74 68 65 20 72 |and push|es the r|
|00003240| 65 73 75 6c 74 69 6e 67 | 20 73 74 72 69 6e 67 2e |esulting| string.|
|00003250| 0a 0a 5c 69 74 65 6d 5b | 5c 68 62 6f 78 7b 5c 74 |..\item[|\hbox{\t|
|00003260| 74 20 3a 3d 7d 5c 68 66 | 69 6c 6c 5d 0a 50 6f 70 |t :=}\hf|ill].Pop|
|00003270| 73 20 74 68 65 20 74 6f | 70 20 74 77 6f 20 6c 69 |s the to|p two li|
|00003280| 74 65 72 61 6c 73 20 61 | 6e 64 20 61 73 73 69 67 |terals a|nd assig|
|00003290| 6e 73 0a 74 6f 20 74 68 | 65 20 66 69 72 73 74 20 |ns.to th|e first |
|000032a0| 28 77 68 69 63 68 20 6d | 75 73 74 20 62 65 20 61 |(which m|ust be a|
|000032b0| 20 67 6c 6f 62 61 6c 20 | 6f 72 20 65 6e 74 72 79 | global |or entry|
|000032c0| 20 76 61 72 69 61 62 6c | 65 29 0a 74 68 65 20 76 | variabl|e).the v|
|000032d0| 61 6c 75 65 20 6f 66 20 | 74 68 65 20 73 65 63 6f |alue of |the seco|
|000032e0| 6e 64 2e 0a 0a 5c 69 74 | 65 6d 5b 5c 68 62 6f 78 |nd...\it|em[\hbox|
|000032f0| 7b 5c 74 74 20 61 64 64 | 2e 70 65 72 69 6f 64 5c |{\tt add|.period\|
|00003300| 24 7d 5c 68 66 69 6c 6c | 5d 0a 50 6f 70 73 20 74 |$}\hfill|].Pops t|
|00003310| 68 65 20 74 6f 70 20 28 | 73 74 72 69 6e 67 29 20 |he top (|string) |
|00003320| 6c 69 74 65 72 61 6c 2c | 0a 61 64 64 73 20 61 20 |literal,|.adds a |
|00003330| 60 7b 5c 74 74 20 2e 7d | 27 20 74 6f 20 69 74 20 |`{\tt .}|' to it |
|00003340| 69 66 20 74 68 65 20 6c | 61 73 74 20 6e 6f 6e 60 |if the l|ast non`|
|00003350| 7b 5c 74 74 20 5c 7d 7d | 27 20 63 68 61 72 61 63 |{\tt \}}|' charac|
|00003360| 74 65 72 0a 69 73 6e 27 | 74 20 61 20 60 7b 5c 74 |ter.isn'|t a `{\t|
|00003370| 74 20 2e 7d 27 24 5c 21 | 24 2c 20 60 7b 5c 74 74 |t .}'$\!|$, `{\tt|
|00003380| 20 3f 7d 27 2c 20 6f 72 | 20 60 7b 5c 74 74 20 21 | ?}', or| `{\tt !|
|00003390| 7d 27 24 5c 21 24 2c 0a | 61 6e 64 20 70 75 73 68 |}'$\!$,.|and push|
|000033a0| 65 73 20 74 68 69 73 20 | 72 65 73 75 6c 74 69 6e |es this |resultin|
|000033b0| 67 20 73 74 72 69 6e 67 | 2e 0a 0a 5c 69 74 65 6d |g string|...\item|
|000033c0| 5b 5c 68 62 6f 78 7b 5c | 74 74 20 63 61 6c 6c 2e |[\hbox{\|tt call.|
|000033d0| 74 79 70 65 5c 24 7d 5c | 68 66 69 6c 6c 5d 0a 45 |type\$}\|hfill].E|
|000033e0| 78 65 63 75 74 65 73 20 | 74 68 65 20 66 75 6e 63 |xecutes |the func|
|000033f0| 74 69 6f 6e 20 77 68 6f | 73 65 20 6e 61 6d 65 20 |tion who|se name |
|00003400| 69 73 20 74 68 65 20 65 | 6e 74 72 79 20 74 79 70 |is the e|ntry typ|
|00003410| 65 20 6f 66 20 61 6e 20 | 65 6e 74 72 79 2e 0a 46 |e of an |entry..F|
|00003420| 6f 72 20 65 78 61 6d 70 | 6c 65 20 69 66 20 61 6e |or examp|le if an|
|00003430| 20 65 6e 74 72 79 20 69 | 73 20 6f 66 20 74 79 70 | entry i|s of typ|
|00003440| 65 20 7b 5c 74 74 20 62 | 6f 6f 6b 7d 2c 20 74 68 |e {\tt b|ook}, th|
|00003450| 69 73 20 66 75 6e 63 74 | 69 6f 6e 20 65 78 65 63 |is funct|ion exec|
|00003460| 75 74 65 73 0a 74 68 65 | 20 7b 5c 74 74 20 62 6f |utes.the| {\tt bo|
|00003470| 6f 6b 7d 20 66 75 6e 63 | 74 69 6f 6e 2e 0a 57 68 |ok} func|tion..Wh|
|00003480| 65 6e 20 67 69 76 65 6e | 20 61 73 20 61 6e 20 61 |en given| as an a|
|00003490| 72 67 75 6d 65 6e 74 20 | 74 6f 20 74 68 65 20 5c |rgument |to the \|
|000034a0| 68 62 6f 78 7b 5c 74 74 | 20 49 54 45 52 41 54 45 |hbox{\tt| ITERATE|
|000034b0| 7d 20 63 6f 6d 6d 61 6e | 64 2c 0a 5c 68 62 6f 78 |} comman|d,.\hbox|
|000034c0| 7b 5c 74 74 20 63 61 6c | 6c 2e 74 79 70 65 5c 24 |{\tt cal|l.type\$|
|000034d0| 7d 20 61 63 74 75 61 6c | 6c 79 20 70 72 6f 64 75 |} actual|ly produ|
|000034e0| 63 65 73 20 74 68 65 20 | 6f 75 74 70 75 74 20 66 |ces the |output f|
|000034f0| 6f 72 20 74 68 65 20 65 | 6e 74 72 69 65 73 2e 0a |or the e|ntries..|
|00003500| 46 6f 72 20 61 6e 20 65 | 6e 74 72 79 20 77 69 74 |For an e|ntry wit|
|00003510| 68 20 61 6e 20 75 6e 6b | 6e 6f 77 6e 20 74 79 70 |h an unk|nown typ|
|00003520| 65 2c 0a 69 74 20 65 78 | 65 63 75 74 65 73 20 74 |e,.it ex|ecutes t|
|00003530| 68 65 20 66 75 6e 63 74 | 69 6f 6e 20 5c 68 62 6f |he funct|ion \hbo|
|00003540| 78 7b 5c 74 74 20 64 65 | 66 61 75 6c 74 2e 74 79 |x{\tt de|fault.ty|
|00003550| 70 65 7d 2e 0a 54 68 75 | 73 20 79 6f 75 20 73 68 |pe}..Thu|s you sh|
|00003560| 6f 75 6c 64 20 64 65 66 | 69 6e 65 20 28 62 65 66 |ould def|ine (bef|
|00003570| 6f 72 65 20 74 68 65 20 | 5c 68 62 6f 78 7b 5c 74 |ore the |\hbox{\t|
|00003580| 74 20 52 45 41 44 7d 20 | 63 6f 6d 6d 61 6e 64 29 |t READ} |command)|
|00003590| 20 6f 6e 65 20 66 75 6e | 63 74 69 6f 6e 0a 66 6f | one fun|ction.fo|
|000035a0| 72 20 65 61 63 68 20 73 | 74 61 6e 64 61 72 64 20 |r each s|tandard |
|000035b0| 65 6e 74 72 79 20 74 79 | 70 65 20 61 73 20 77 65 |entry ty|pe as we|
|000035c0| 6c 6c 20 61 73 20 61 20 | 5c 68 62 6f 78 7b 5c 74 |ll as a |\hbox{\t|
|000035d0| 74 20 64 65 66 61 75 6c | 74 2e 74 79 70 65 7d 20 |t defaul|t.type} |
|000035e0| 66 75 6e 63 74 69 6f 6e | 2e 0a 0a 5c 69 74 65 6d |function|...\item|
|000035f0| 5b 5c 68 62 6f 78 7b 5c | 74 74 20 63 68 61 6e 67 |[\hbox{\|tt chang|
|00003600| 65 2e 63 61 73 65 5c 24 | 7d 5c 68 66 69 6c 6c 5d |e.case\$|}\hfill]|
|00003610| 0a 50 6f 70 73 20 74 68 | 65 20 74 6f 70 20 74 77 |.Pops th|e top tw|
|00003620| 6f 20 28 73 74 72 69 6e | 67 29 20 6c 69 74 65 72 |o (strin|g) liter|
|00003630| 61 6c 73 3b 0a 69 74 20 | 63 68 61 6e 67 65 73 20 |als;.it |changes |
|00003640| 74 68 65 20 63 61 73 65 | 20 6f 66 20 74 68 65 20 |the case| of the |
|00003650| 73 65 63 6f 6e 64 20 61 | 63 63 6f 72 64 69 6e 67 |second a|ccording|
|00003660| 20 74 6f 20 74 68 65 0a | 73 70 65 63 69 66 69 63 | to the.|specific|
|00003670| 61 74 69 6f 6e 73 20 6f | 66 20 74 68 65 20 66 69 |ations o|f the fi|
|00003680| 72 73 74 2c 20 61 73 20 | 66 6f 6c 6c 6f 77 73 2e |rst, as |follows.|
|00003690| 20 20 28 4e 6f 74 65 3a | 20 54 68 65 20 77 6f 72 | (Note:| The wor|
|000036a0| 64 20 60 6c 65 74 74 65 | 72 73 27 20 69 6e 0a 74 |d `lette|rs' in.t|
|000036b0| 68 65 20 6e 65 78 74 20 | 73 65 6e 74 65 6e 63 65 |he next |sentence|
|000036c0| 20 72 65 66 65 72 73 20 | 6f 6e 6c 79 20 74 6f 20 | refers |only to |
|000036d0| 74 68 6f 73 65 20 61 74 | 20 62 72 61 63 65 2d 6c |those at| brace-l|
|000036e0| 65 76 65 6c 7e 30 2c 20 | 74 68 65 20 74 6f 70 2d |evel~0, |the top-|
|000036f0| 6d 6f 73 74 0a 62 72 61 | 63 65 20 6c 65 76 65 6c |most.bra|ce level|
|00003700| 3b 20 6e 6f 20 6f 74 68 | 65 72 20 63 68 61 72 61 |; no oth|er chara|
|00003710| 63 74 65 72 73 20 61 72 | 65 20 63 68 61 6e 67 65 |cters ar|e change|
|00003720| 64 2c 20 65 78 63 65 70 | 74 20 70 65 72 68 61 70 |d, excep|t perhap|
|00003730| 73 20 66 6f 72 0a 60 60 | 73 70 65 63 69 61 6c 20 |s for.``|special |
|00003740| 63 68 61 72 61 63 74 65 | 72 73 27 27 24 5c 21 24 |characte|rs''$\!$|
|00003750| 2c 20 64 65 73 63 72 69 | 62 65 64 20 69 6e 20 53 |, descri|bed in S|
|00003760| 65 63 74 69 6f 6e 7e 34 | 2e 29 0a 49 66 20 74 68 |ection~4|.).If th|
|00003770| 65 20 66 69 72 73 74 20 | 6c 69 74 65 72 61 6c 20 |e first |literal |
|00003780| 69 73 20 74 68 65 0a 73 | 74 72 69 6e 67 7e 60 7b |is the.s|tring~`{|
|00003790| 5c 74 74 20 74 7d 27 24 | 5c 21 24 2c 20 69 74 20 |\tt t}'$|\!$, it |
|000037a0| 63 6f 6e 76 65 72 74 73 | 20 74 6f 20 6c 6f 77 65 |converts| to lowe|
|000037b0| 72 20 63 61 73 65 20 61 | 6c 6c 20 6c 65 74 74 65 |r case a|ll lette|
|000037c0| 72 73 20 65 78 63 65 70 | 74 20 74 68 65 20 76 65 |rs excep|t the ve|
|000037d0| 72 79 0a 66 69 72 73 74 | 20 63 68 61 72 61 63 74 |ry.first| charact|
|000037e0| 65 72 20 69 6e 20 74 68 | 65 20 73 74 72 69 6e 67 |er in th|e string|
|000037f0| 2c 20 77 68 69 63 68 20 | 69 74 20 6c 65 61 76 65 |, which |it leave|
|00003800| 73 20 61 6c 6f 6e 65 2c | 20 61 6e 64 20 65 78 63 |s alone,| and exc|
|00003810| 65 70 74 20 74 68 65 0a | 66 69 72 73 74 20 63 68 |ept the.|first ch|
|00003820| 61 72 61 63 74 65 72 20 | 66 6f 6c 6c 6f 77 69 6e |aracter |followin|
|00003830| 67 20 61 6e 79 20 63 6f | 6c 6f 6e 20 61 6e 64 20 |g any co|lon and |
|00003840| 74 68 65 6e 20 6e 6f 6e | 6e 75 6c 6c 20 77 68 69 |then non|null whi|
|00003850| 74 65 20 73 70 61 63 65 | 2c 0a 77 68 69 63 68 20 |te space|,.which |
|00003860| 69 74 20 61 6c 73 6f 20 | 6c 65 61 76 65 73 20 61 |it also |leaves a|
|00003870| 6c 6f 6e 65 3b 20 69 66 | 20 69 74 27 73 20 74 68 |lone; if| it's th|
|00003880| 65 20 73 74 72 69 6e 67 | 7e 60 7b 5c 74 74 20 6c |e string|~`{\tt l|
|00003890| 7d 27 24 5c 21 24 2c 20 | 69 74 20 63 6f 6e 76 65 |}'$\!$, |it conve|
|000038a0| 72 74 73 20 61 6c 6c 0a | 6c 65 74 74 65 72 73 20 |rts all.|letters |
|000038b0| 74 6f 20 6c 6f 77 65 72 | 20 63 61 73 65 3b 20 61 |to lower| case; a|
|000038c0| 6e 64 20 69 66 20 69 74 | 27 73 20 74 68 65 20 73 |nd if it|'s the s|
|000038d0| 74 72 69 6e 67 7e 60 7b | 5c 74 74 20 75 7d 27 24 |tring~`{|\tt u}'$|
|000038e0| 5c 21 24 2c 20 69 74 20 | 63 6f 6e 76 65 72 74 73 |\!$, it |converts|
|000038f0| 20 61 6c 6c 0a 6c 65 74 | 74 65 72 73 20 74 6f 20 | all.let|ters to |
|00003900| 75 70 70 65 72 20 63 61 | 73 65 2e 0a 49 74 20 74 |upper ca|se..It t|
|00003910| 68 65 6e 20 70 75 73 68 | 65 73 20 74 68 69 73 20 |hen push|es this |
|00003920| 72 65 73 75 6c 74 69 6e | 67 20 73 74 72 69 6e 67 |resultin|g string|
|00003930| 2e 20 20 49 66 20 65 69 | 74 68 65 72 0a 74 79 70 |. If ei|ther.typ|
|00003940| 65 20 69 73 20 69 6e 63 | 6f 72 72 65 63 74 2c 20 |e is inc|orrect, |
|00003950| 69 74 20 63 6f 6d 70 6c | 61 69 6e 73 20 61 6e 64 |it compl|ains and|
|00003960| 20 70 75 73 68 65 73 20 | 74 68 65 20 6e 75 6c 6c | pushes |the null|
|00003970| 20 73 74 72 69 6e 67 3b | 20 68 6f 77 65 76 65 72 | string;| however|
|00003980| 2c 0a 69 66 20 62 6f 74 | 68 20 74 79 70 65 73 20 |,.if bot|h types |
|00003990| 61 72 65 20 63 6f 72 72 | 65 63 74 20 62 75 74 20 |are corr|ect but |
|000039a0| 74 68 65 20 73 70 65 63 | 69 66 69 63 61 74 69 6f |the spec|ificatio|
|000039b0| 6e 20 73 74 72 69 6e 67 | 20 28 69 2e 65 2e 2c 20 |n string| (i.e., |
|000039c0| 74 68 65 0a 66 69 72 73 | 74 20 73 74 72 69 6e 67 |the.firs|t string|
|000039d0| 29 20 69 73 6e 27 74 20 | 6f 6e 65 20 6f 66 20 74 |) isn't |one of t|
|000039e0| 68 65 20 6c 65 67 61 6c | 20 6f 6e 65 73 2c 20 69 |he legal| ones, i|
|000039f0| 74 20 6d 65 72 65 6c 79 | 20 70 75 73 68 65 73 20 |t merely| pushes |
|00003a00| 74 68 65 20 73 65 63 6f | 6e 64 0a 62 61 63 6b 20 |the seco|nd.back |
|00003a10| 6f 6e 74 6f 20 74 68 65 | 20 73 74 61 63 6b 2c 20 |onto the| stack, |
|00003a20| 61 66 74 65 72 20 63 6f | 6d 70 6c 61 69 6e 69 6e |after co|mplainin|
|00003a30| 67 2e 20 20 28 41 6e 6f | 74 68 65 72 20 6e 6f 74 |g. (Ano|ther not|
|00003a40| 65 3a 20 49 74 20 69 67 | 6e 6f 72 65 73 0a 63 61 |e: It ig|nores.ca|
|00003a50| 73 65 20 64 69 66 66 65 | 72 65 6e 63 65 73 20 69 |se diffe|rences i|
|00003a60| 6e 20 74 68 65 20 73 70 | 65 63 69 66 69 63 61 74 |n the sp|ecificat|
|00003a70| 69 6f 6e 20 73 74 72 69 | 6e 67 3b 20 66 6f 72 20 |ion stri|ng; for |
|00003a80| 65 78 61 6d 70 6c 65 2c | 20 74 68 65 20 73 74 72 |example,| the str|
|00003a90| 69 6e 67 73 0a 7b 5c 74 | 74 20 74 7d 20 61 6e 64 |ings.{\t|t t} and|
|00003aa0| 20 7b 5c 74 74 20 54 7d | 20 61 72 65 20 65 71 75 | {\tt T}| are equ|
|00003ab0| 69 76 61 6c 65 6e 74 20 | 66 6f 72 20 74 68 65 20 |ivalent |for the |
|00003ac0| 70 75 72 70 6f 73 65 73 | 20 6f 66 20 74 68 69 73 |purposes| of this|
|00003ad0| 20 62 75 69 6c 74 2d 69 | 6e 0a 66 75 6e 63 74 69 | built-i|n.functi|
|00003ae0| 6f 6e 2e 29 0a 0a 5c 69 | 74 65 6d 5b 5c 68 62 6f |on.)..\i|tem[\hbo|
|00003af0| 78 7b 5c 74 74 20 63 68 | 72 2e 74 6f 2e 69 6e 74 |x{\tt ch|r.to.int|
|00003b00| 5c 24 7d 5c 68 66 69 6c | 6c 5d 0a 50 6f 70 73 20 |\$}\hfil|l].Pops |
|00003b10| 74 68 65 20 74 6f 70 20 | 28 73 74 72 69 6e 67 29 |the top |(string)|
|00003b20| 20 6c 69 74 65 72 61 6c | 2c 0a 6d 61 6b 65 73 20 | literal|,.makes |
|00003b30| 73 75 72 65 20 69 74 27 | 73 20 61 20 73 69 6e 67 |sure it'|s a sing|
|00003b40| 6c 65 20 63 68 61 72 61 | 63 74 65 72 2c 20 63 6f |le chara|cter, co|
|00003b50| 6e 76 65 72 74 73 20 69 | 74 20 74 6f 20 74 68 65 |nverts i|t to the|
|00003b60| 0a 63 6f 72 72 65 73 70 | 6f 6e 64 69 6e 67 20 41 |.corresp|onding A|
|00003b70| 53 43 49 49 20 69 6e 74 | 65 67 65 72 2c 20 61 6e |SCII int|eger, an|
|00003b80| 64 20 70 75 73 68 65 73 | 20 74 68 69 73 20 69 6e |d pushes| this in|
|00003b90| 74 65 67 65 72 2e 0a 0a | 5c 69 74 65 6d 5b 5c 68 |teger...|\item[\h|
|00003ba0| 62 6f 78 7b 5c 74 74 20 | 63 69 74 65 5c 24 7d 5c |box{\tt |cite\$}\|
|00003bb0| 68 66 69 6c 6c 5d 0a 50 | 75 73 68 65 73 20 74 68 |hfill].P|ushes th|
|00003bc0| 65 20 73 74 72 69 6e 67 | 20 74 68 61 74 20 77 61 |e string| that wa|
|00003bd0| 73 20 74 68 65 0a 5c 68 | 62 6f 78 7b 5c 76 65 72 |s the.\h|box{\ver|
|00003be0| 62 7c 5c 63 69 74 65 7c | 7d 2d 63 6f 6d 6d 61 6e |b|\cite||}-comman|
|00003bf0| 64 20 61 72 67 75 6d 65 | 6e 74 20 66 6f 72 20 74 |d argume|nt for t|
|00003c00| 68 69 73 20 65 6e 74 72 | 79 2e 0a 0a 5c 69 74 65 |his entr|y...\ite|
|00003c10| 6d 5b 5c 68 62 6f 78 7b | 5c 74 74 20 64 75 70 6c |m[\hbox{|\tt dupl|
|00003c20| 69 63 61 74 65 5c 24 7d | 5c 68 66 69 6c 6c 5d 0a |icate\$}|\hfill].|
|00003c30| 50 6f 70 73 20 74 68 65 | 20 74 6f 70 20 6c 69 74 |Pops the| top lit|
|00003c40| 65 72 61 6c 20 66 72 6f | 6d 20 74 68 65 20 73 74 |eral fro|m the st|
|00003c50| 61 63 6b 20 61 6e 64 20 | 70 75 73 68 65 73 20 74 |ack and |pushes t|
|00003c60| 77 6f 20 63 6f 70 69 65 | 73 20 6f 66 20 69 74 2e |wo copie|s of it.|
|00003c70| 0a 0a 5c 69 74 65 6d 5b | 5c 68 62 6f 78 7b 5c 74 |..\item[|\hbox{\t|
|00003c80| 74 20 65 6d 70 74 79 5c | 24 7d 5c 68 66 69 6c 6c |t empty\|$}\hfill|
|00003c90| 5d 0a 50 6f 70 73 20 74 | 68 65 20 74 6f 70 20 6c |].Pops t|he top l|
|00003ca0| 69 74 65 72 61 6c 20 61 | 6e 64 20 70 75 73 68 65 |iteral a|nd pushe|
|00003cb0| 73 0a 74 68 65 20 69 6e | 74 65 67 65 72 20 31 20 |s.the in|teger 1 |
|00003cc0| 69 66 20 69 74 27 73 20 | 61 20 6d 69 73 73 69 6e |if it's |a missin|
|00003cd0| 67 20 66 69 65 6c 64 20 | 6f 72 20 61 20 73 74 72 |g field |or a str|
|00003ce0| 69 6e 67 20 68 61 76 69 | 6e 67 20 6e 6f 0a 6e 6f |ing havi|ng no.no|
|00003cf0| 6e 2d 77 68 69 74 65 2d | 73 70 61 63 65 20 63 68 |n-white-|space ch|
|00003d00| 61 72 61 63 74 65 72 73 | 2c 20 30 20 6f 74 68 65 |aracters|, 0 othe|
|00003d10| 72 77 69 73 65 2e 0a 0a | 5c 69 74 65 6d 5b 5c 68 |rwise...|\item[\h|
|00003d20| 62 6f 78 7b 5c 74 74 20 | 66 6f 72 6d 61 74 2e 6e |box{\tt |format.n|
|00003d30| 61 6d 65 5c 24 7d 5c 68 | 66 69 6c 6c 5d 0a 50 6f |ame\$}\h|fill].Po|
|00003d40| 70 73 20 74 68 65 20 74 | 6f 70 20 74 68 72 65 65 |ps the t|op three|
|00003d50| 20 6c 69 74 65 72 61 6c | 73 0a 28 74 68 65 79 20 | literal|s.(they |
|00003d60| 61 72 65 20 61 20 73 74 | 72 69 6e 67 2c 20 61 6e |are a st|ring, an|
|00003d70| 20 69 6e 74 65 67 65 72 | 2c 20 61 6e 64 20 61 20 | integer|, and a |
|00003d80| 73 74 72 69 6e 67 20 6c | 69 74 65 72 61 6c 29 2e |string l|iteral).|
|00003d90| 0a 54 68 65 20 6c 61 73 | 74 20 73 74 72 69 6e 67 |.The las|t string|
|00003da0| 20 6c 69 74 65 72 61 6c | 20 72 65 70 72 65 73 65 | literal| represe|
|00003db0| 6e 74 73 20 61 20 6e 61 | 6d 65 20 6c 69 73 74 20 |nts a na|me list |
|00003dc0| 28 65 61 63 68 20 6e 61 | 6d 65 0a 63 6f 72 72 65 |(each na|me.corre|
|00003dd0| 73 70 6f 6e 64 69 6e 67 | 20 74 6f 20 61 20 70 65 |sponding| to a pe|
|00003de0| 72 73 6f 6e 29 2c 20 74 | 68 65 20 69 6e 74 65 67 |rson), t|he integ|
|00003df0| 65 72 20 6c 69 74 65 72 | 61 6c 20 73 70 65 63 69 |er liter|al speci|
|00003e00| 66 69 65 73 20 77 68 69 | 63 68 20 6e 61 6d 65 0a |fies whi|ch name.|
|00003e10| 74 6f 20 70 69 63 6b 20 | 66 72 6f 6d 20 74 68 69 |to pick |from thi|
|00003e20| 73 20 6c 69 73 74 2c 20 | 61 6e 64 20 74 68 65 20 |s list, |and the |
|00003e30| 66 69 72 73 74 20 73 74 | 72 69 6e 67 20 6c 69 74 |first st|ring lit|
|00003e40| 65 72 61 6c 20 73 70 65 | 63 69 66 69 65 73 20 68 |eral spe|cifies h|
|00003e50| 6f 77 20 74 6f 0a 66 6f | 72 6d 61 74 20 74 68 69 |ow to.fo|rmat thi|
|00003e60| 73 20 6e 61 6d 65 2c 20 | 61 73 20 65 78 70 6c 61 |s name, |as expla|
|00003e70| 69 6e 65 64 20 69 6e 20 | 74 68 65 20 6e 65 78 74 |ined in |the next|
|00003e80| 20 73 75 62 73 65 63 74 | 69 6f 6e 2e 0a 46 69 6e | subsect|ion..Fin|
|00003e90| 61 6c 6c 79 2c 20 74 68 | 69 73 20 66 75 6e 63 74 |ally, th|is funct|
|00003ea0| 69 6f 6e 20 70 75 73 68 | 65 73 20 74 68 65 20 66 |ion push|es the f|
|00003eb0| 6f 72 6d 61 74 74 65 64 | 20 6e 61 6d 65 2e 0a 0a |ormatted| name...|
|00003ec0| 5c 69 74 65 6d 5b 5c 68 | 62 6f 78 7b 5c 74 74 20 |\item[\h|box{\tt |
|00003ed0| 69 66 5c 24 7d 5c 68 66 | 69 6c 6c 5d 0a 50 6f 70 |if\$}\hf|ill].Pop|
|00003ee0| 73 20 74 68 65 20 74 6f | 70 20 74 68 72 65 65 20 |s the to|p three |
|00003ef0| 6c 69 74 65 72 61 6c 73 | 20 28 74 68 65 79 0a 61 |literals| (they.a|
|00003f00| 72 65 20 74 77 6f 20 66 | 75 6e 63 74 69 6f 6e 20 |re two f|unction |
|00003f10| 6c 69 74 65 72 61 6c 73 | 20 61 6e 64 20 61 6e 20 |literals| and an |
|00003f20| 69 6e 74 65 67 65 72 20 | 6c 69 74 65 72 61 6c 2c |integer |literal,|
|00003f30| 20 69 6e 20 74 68 61 74 | 20 6f 72 64 65 72 29 3b | in that| order);|
|00003f40| 0a 69 66 20 74 68 65 20 | 69 6e 74 65 67 65 72 20 |.if the |integer |
|00003f50| 69 73 20 67 72 65 61 74 | 65 72 20 74 68 61 6e 20 |is great|er than |
|00003f60| 30 2c 20 69 74 20 65 78 | 65 63 75 74 65 73 20 74 |0, it ex|ecutes t|
|00003f70| 68 65 20 73 65 63 6f 6e | 64 20 6c 69 74 65 72 61 |he secon|d litera|
|00003f80| 6c 2c 0a 65 6c 73 65 20 | 69 74 20 65 78 65 63 75 |l,.else |it execu|
|00003f90| 74 65 73 20 74 68 65 20 | 66 69 72 73 74 2e 0a 0a |tes the |first...|
|00003fa0| 5c 69 74 65 6d 5b 5c 68 | 62 6f 78 7b 5c 74 74 20 |\item[\h|box{\tt |
|00003fb0| 69 6e 74 2e 74 6f 2e 63 | 68 72 5c 24 7d 5c 68 66 |int.to.c|hr\$}\hf|
|00003fc0| 69 6c 6c 5d 0a 50 6f 70 | 73 20 74 68 65 20 74 6f |ill].Pop|s the to|
|00003fd0| 70 20 28 69 6e 74 65 67 | 65 72 29 20 6c 69 74 65 |p (integ|er) lite|
|00003fe0| 72 61 6c 2c 0a 69 6e 74 | 65 72 70 72 65 74 65 64 |ral,.int|erpreted|
|00003ff0| 20 61 73 20 74 68 65 20 | 41 53 43 49 49 20 69 6e | as the |ASCII in|
|00004000| 74 65 67 65 72 20 76 61 | 6c 75 65 20 6f 66 20 61 |teger va|lue of a|
|00004010| 20 73 69 6e 67 6c 65 20 | 63 68 61 72 61 63 74 65 | single |characte|
|00004020| 72 2c 0a 63 6f 6e 76 65 | 72 74 73 20 69 74 20 74 |r,.conve|rts it t|
|00004030| 6f 20 74 68 65 20 63 6f | 72 72 65 73 70 6f 6e 64 |o the co|rrespond|
|00004040| 69 6e 67 20 73 69 6e 67 | 6c 65 2d 63 68 61 72 61 |ing sing|le-chara|
|00004050| 63 74 65 72 20 73 74 72 | 69 6e 67 2c 20 61 6e 64 |cter str|ing, and|
|00004060| 20 70 75 73 68 65 73 0a | 74 68 69 73 20 73 74 72 | pushes.|this str|
|00004070| 69 6e 67 2e 0a 0a 5c 69 | 74 65 6d 5b 5c 68 62 6f |ing...\i|tem[\hbo|
|00004080| 78 7b 5c 74 74 20 69 6e | 74 2e 74 6f 2e 73 74 72 |x{\tt in|t.to.str|
|00004090| 5c 24 7d 5c 68 66 69 6c | 6c 5d 0a 50 6f 70 73 20 |\$}\hfil|l].Pops |
|000040a0| 74 68 65 20 74 6f 70 20 | 28 69 6e 74 65 67 65 72 |the top |(integer|
|000040b0| 29 20 6c 69 74 65 72 61 | 6c 2c 0a 63 6f 6e 76 65 |) litera|l,.conve|
|000040c0| 72 74 73 20 69 74 20 74 | 6f 20 69 74 73 20 28 75 |rts it t|o its (u|
|000040d0| 6e 69 71 75 65 29 20 73 | 74 72 69 6e 67 20 65 71 |nique) s|tring eq|
|000040e0| 75 69 76 61 6c 65 6e 74 | 2c 20 61 6e 64 20 70 75 |uivalent|, and pu|
|000040f0| 73 68 65 73 20 74 68 69 | 73 20 73 74 72 69 6e 67 |shes thi|s string|
|00004100| 2e 0a 0a 5c 69 74 65 6d | 5b 5c 68 62 6f 78 7b 5c |...\item|[\hbox{\|
|00004110| 74 74 20 6d 69 73 73 69 | 6e 67 5c 24 7d 5c 68 66 |tt missi|ng\$}\hf|
|00004120| 69 6c 6c 5d 0a 50 6f 70 | 73 20 74 68 65 20 74 6f |ill].Pop|s the to|
|00004130| 70 20 6c 69 74 65 72 61 | 6c 20 61 6e 64 0a 70 75 |p litera|l and.pu|
|00004140| 73 68 65 73 20 74 68 65 | 20 69 6e 74 65 67 65 72 |shes the| integer|
|00004150| 20 31 20 69 66 20 69 74 | 27 73 20 61 20 6d 69 73 | 1 if it|'s a mis|
|00004160| 73 69 6e 67 20 66 69 65 | 6c 64 2c 20 30 7e 6f 74 |sing fie|ld, 0~ot|
|00004170| 68 65 72 77 69 73 65 2e | 0a 0a 5c 69 74 65 6d 5b |herwise.|..\item[|
|00004180| 5c 68 62 6f 78 7b 5c 74 | 74 20 6e 65 77 6c 69 6e |\hbox{\t|t newlin|
|00004190| 65 5c 24 7d 5c 68 66 69 | 6c 6c 5d 0a 57 72 69 74 |e\$}\hfi|ll].Writ|
|000041a0| 65 73 20 6f 6e 74 6f 20 | 74 68 65 20 7b 5c 74 74 |es onto |the {\tt|
|000041b0| 20 62 62 6c 7d 20 66 69 | 6c 65 0a 77 68 61 74 27 | bbl} fi|le.what'|
|000041c0| 73 20 61 63 63 75 6d 75 | 6c 61 74 65 64 20 69 6e |s accumu|lated in|
|000041d0| 20 74 68 65 20 6f 75 74 | 70 75 74 20 62 75 66 66 | the out|put buff|
|000041e0| 65 72 2e 0a 49 74 20 77 | 72 69 74 65 73 20 61 20 |er..It w|rites a |
|000041f0| 62 6c 61 6e 6b 20 6c 69 | 6e 65 20 69 66 20 61 6e |blank li|ne if an|
|00004200| 64 20 6f 6e 6c 79 20 69 | 66 20 74 68 65 20 6f 75 |d only i|f the ou|
|00004210| 74 70 75 74 20 62 75 66 | 66 65 72 20 69 73 20 65 |tput buf|fer is e|
|00004220| 6d 70 74 79 2e 0a 53 69 | 6e 63 65 20 5c 68 62 6f |mpty..Si|nce \hbo|
|00004230| 78 7b 5c 74 74 20 77 72 | 69 74 65 5c 24 7d 20 64 |x{\tt wr|ite\$} d|
|00004240| 6f 65 73 20 72 65 61 73 | 6f 6e 61 62 6c 65 20 6c |oes reas|onable l|
|00004250| 69 6e 65 20 62 72 65 61 | 6b 69 6e 67 2c 20 79 6f |ine brea|king, yo|
|00004260| 75 20 73 68 6f 75 6c 64 | 20 75 73 65 0a 74 68 69 |u should| use.thi|
|00004270| 73 20 66 75 6e 63 74 69 | 6f 6e 20 6f 6e 6c 79 20 |s functi|on only |
|00004280| 77 68 65 6e 20 79 6f 75 | 20 77 61 6e 74 20 61 20 |when you| want a |
|00004290| 62 6c 61 6e 6b 20 6c 69 | 6e 65 20 6f 72 20 61 6e |blank li|ne or an|
|000042a0| 20 65 78 70 6c 69 63 69 | 74 20 6c 69 6e 65 20 62 | explici|t line b|
|000042b0| 72 65 61 6b 2e 0a 0a 5c | 69 74 65 6d 5b 5c 68 62 |reak...\|item[\hb|
|000042c0| 6f 78 7b 5c 74 74 20 6e | 75 6d 2e 6e 61 6d 65 73 |ox{\tt n|um.names|
|000042d0| 5c 24 7d 5c 68 66 69 6c | 6c 5d 0a 50 6f 70 73 20 |\$}\hfil|l].Pops |
|000042e0| 74 68 65 20 74 6f 70 20 | 28 73 74 72 69 6e 67 29 |the top |(string)|
|000042f0| 20 6c 69 74 65 72 61 6c | 0a 61 6e 64 20 70 75 73 | literal|.and pus|
|00004300| 68 65 73 20 74 68 65 20 | 6e 75 6d 62 65 72 20 6f |hes the |number o|
|00004310| 66 20 6e 61 6d 65 73 20 | 74 68 65 20 73 74 72 69 |f names |the stri|
|00004320| 6e 67 20 72 65 70 72 65 | 73 65 6e 74 73 2d 2d 2d |ng repre|sents---|
|00004330| 6f 6e 65 20 70 6c 75 73 | 0a 74 68 65 20 6e 75 6d |one plus|.the num|
|00004340| 62 65 72 20 6f 66 20 6f | 63 63 75 72 72 65 6e 63 |ber of o|ccurrenc|
|00004350| 65 73 20 6f 66 20 74 68 | 65 20 73 75 62 73 74 72 |es of th|e substr|
|00004360| 69 6e 67 20 60 60 61 6e | 64 27 27 20 28 69 67 6e |ing ``an|d'' (ign|
|00004370| 6f 72 69 6e 67 20 63 61 | 73 65 20 64 69 66 66 65 |oring ca|se diffe|
|00004380| 72 65 6e 63 65 73 29 0a | 73 75 72 72 6f 75 6e 64 |rences).|surround|
|00004390| 65 64 20 62 79 20 6e 6f | 6e 6e 75 6c 6c 20 77 68 |ed by no|nnull wh|
|000043a0| 69 74 65 2d 73 70 61 63 | 65 20 61 74 20 74 68 65 |ite-spac|e at the|
|000043b0| 20 74 6f 70 20 62 72 61 | 63 65 20 6c 65 76 65 6c | top bra|ce level|
|000043c0| 2e 0a 0a 5c 69 74 65 6d | 5b 5c 68 62 6f 78 7b 5c |...\item|[\hbox{\|
|000043d0| 74 74 20 70 6f 70 5c 24 | 7d 5c 68 66 69 6c 6c 5d |tt pop\$|}\hfill]|
|000043e0| 0a 50 6f 70 73 20 74 68 | 65 20 74 6f 70 20 6f 66 |.Pops th|e top of|
|000043f0| 20 74 68 65 20 73 74 61 | 63 6b 20 62 75 74 0a 64 | the sta|ck but.d|
|00004400| 6f 65 73 6e 27 74 20 70 | 72 69 6e 74 20 69 74 3b |oesn't p|rint it;|
|00004410| 20 74 68 69 73 20 67 65 | 74 73 20 72 69 64 20 6f | this ge|ts rid o|
|00004420| 66 20 61 6e 20 75 6e 77 | 61 6e 74 65 64 20 73 74 |f an unw|anted st|
|00004430| 61 63 6b 20 6c 69 74 65 | 72 61 6c 2e 0a 0a 5c 69 |ack lite|ral...\i|
|00004440| 74 65 6d 5b 5c 68 62 6f | 78 7b 5c 74 74 20 70 72 |tem[\hbo|x{\tt pr|
|00004450| 65 61 6d 62 6c 65 5c 24 | 7d 5c 68 66 69 6c 6c 5d |eamble\$|}\hfill]|
|00004460| 0a 50 75 73 68 65 73 20 | 6f 6e 74 6f 20 74 68 65 |.Pushes |onto the|
|00004470| 20 73 74 61 63 6b 20 74 | 68 65 20 63 6f 6e 63 61 | stack t|he conca|
|00004480| 74 65 6e 61 74 69 6f 6e | 20 6f 66 20 61 6c 6c 20 |tenation| of all |
|00004490| 74 68 65 0a 5c 68 62 6f | 78 7b 5c 74 74 20 40 50 |the.\hbo|x{\tt @P|
|000044a0| 52 45 41 4d 42 4c 45 7d | 20 73 74 72 69 6e 67 73 |REAMBLE}| strings|
|000044b0| 20 72 65 61 64 20 66 72 | 6f 6d 20 74 68 65 20 64 | read fr|om the d|
|000044c0| 61 74 61 62 61 73 65 20 | 66 69 6c 65 73 2e 0a 0a |atabase |files...|
|000044d0| 5c 69 74 65 6d 5b 5c 68 | 62 6f 78 7b 5c 74 74 20 |\item[\h|box{\tt |
|000044e0| 70 75 72 69 66 79 5c 24 | 7d 5c 68 66 69 6c 6c 5d |purify\$|}\hfill]|
|000044f0| 0a 50 6f 70 73 20 74 68 | 65 20 74 6f 70 20 28 73 |.Pops th|e top (s|
|00004500| 74 72 69 6e 67 29 20 6c | 69 74 65 72 61 6c 2c 0a |tring) l|iteral,.|
|00004510| 72 65 6d 6f 76 65 73 20 | 6e 6f 6e 61 6c 70 68 61 |removes |nonalpha|
|00004520| 6e 75 6d 65 72 69 63 20 | 63 68 61 72 61 63 74 65 |numeric |characte|
|00004530| 72 73 20 65 78 63 65 70 | 74 20 66 6f 72 20 77 68 |rs excep|t for wh|
|00004540| 69 74 65 2d 73 70 61 63 | 65 20 63 68 61 72 61 63 |ite-spac|e charac|
|00004550| 74 65 72 73 20 61 6e 64 | 0a 68 79 70 68 65 6e 73 |ters and|.hyphens|
|00004560| 20 61 6e 64 20 74 69 65 | 73 20 28 74 68 65 73 65 | and tie|s (these|
|00004570| 20 61 6c 6c 20 67 65 74 | 20 63 6f 6e 76 65 72 74 | all get| convert|
|00004580| 65 64 20 74 6f 20 61 20 | 73 70 61 63 65 29 2c 20 |ed to a |space), |
|00004590| 72 65 6d 6f 76 65 73 0a | 63 65 72 74 61 69 6e 20 |removes.|certain |
|000045a0| 61 6c 70 68 61 62 65 74 | 69 63 20 63 68 61 72 61 |alphabet|ic chara|
|000045b0| 63 74 65 72 73 20 63 6f | 6e 74 61 69 6e 65 64 20 |cters co|ntained |
|000045c0| 69 6e 20 74 68 65 20 63 | 6f 6e 74 72 6f 6c 20 73 |in the c|ontrol s|
|000045d0| 65 71 75 65 6e 63 65 73 | 0a 61 73 73 6f 63 69 61 |equences|.associa|
|000045e0| 74 65 64 20 77 69 74 68 | 20 61 20 60 60 73 70 65 |ted with| a ``spe|
|000045f0| 63 69 61 6c 20 63 68 61 | 72 61 63 74 65 72 27 27 |cial cha|racter''|
|00004600| 24 5c 21 24 2c 20 61 6e | 64 20 70 75 73 68 65 73 |$\!$, an|d pushes|
|00004610| 20 74 68 65 20 72 65 73 | 75 6c 74 69 6e 67 20 73 | the res|ulting s|
|00004620| 74 72 69 6e 67 2e 0a 0a | 5c 69 74 65 6d 5b 5c 68 |tring...|\item[\h|
|00004630| 62 6f 78 7b 5c 74 74 20 | 71 75 6f 74 65 5c 24 7d |box{\tt |quote\$}|
|00004640| 5c 68 66 69 6c 6c 5d 0a | 50 75 73 68 65 73 20 74 |\hfill].|Pushes t|
|00004650| 68 65 20 73 74 72 69 6e | 67 20 63 6f 6e 73 69 73 |he strin|g consis|
|00004660| 74 69 6e 67 20 6f 66 20 | 74 68 65 20 64 6f 75 62 |ting of |the doub|
|00004670| 6c 65 2d 71 75 6f 74 65 | 20 63 68 61 72 61 63 74 |le-quote| charact|
|00004680| 65 72 2e 0a 0a 5c 69 74 | 65 6d 5b 5c 68 62 6f 78 |er...\it|em[\hbox|
|00004690| 7b 5c 74 74 20 73 6b 69 | 70 5c 24 7d 5c 68 66 69 |{\tt ski|p\$}\hfi|
|000046a0| 6c 6c 5d 0a 49 73 20 61 | 20 6e 6f 2d 6f 70 2e 0a |ll].Is a| no-op..|
|000046b0| 0a 5c 69 74 65 6d 5b 5c | 68 62 6f 78 7b 5c 74 74 |.\item[\|hbox{\tt|
|000046c0| 20 73 74 61 63 6b 5c 24 | 7d 5c 68 66 69 6c 6c 5d | stack\$|}\hfill]|
|000046d0| 0a 50 6f 70 73 20 61 6e | 64 20 70 72 69 6e 74 73 |.Pops an|d prints|
|000046e0| 20 74 68 65 20 77 68 6f | 6c 65 20 73 74 61 63 6b | the who|le stack|
|000046f0| 3b 0a 69 74 27 73 20 6d | 65 61 6e 74 20 74 6f 20 |;.it's m|eant to |
|00004700| 62 65 20 75 73 65 64 20 | 66 6f 72 20 73 74 79 6c |be used |for styl|
|00004710| 65 20 64 65 73 69 67 6e | 65 72 73 20 77 68 69 6c |e design|ers whil|
|00004720| 65 20 64 65 62 75 67 67 | 69 6e 67 2e 0a 0a 5c 69 |e debugg|ing...\i|
|00004730| 74 65 6d 5b 5c 68 62 6f | 78 7b 5c 74 74 20 73 75 |tem[\hbo|x{\tt su|
|00004740| 62 73 74 72 69 6e 67 5c | 24 7d 5c 68 66 69 6c 6c |bstring\|$}\hfill|
|00004750| 5d 0a 50 6f 70 73 20 74 | 68 65 20 74 6f 70 20 74 |].Pops t|he top t|
|00004760| 68 72 65 65 20 6c 69 74 | 65 72 61 6c 73 0a 28 74 |hree lit|erals.(t|
|00004770| 68 65 79 20 61 72 65 20 | 74 68 65 20 74 77 6f 20 |hey are |the two |
|00004780| 69 6e 74 65 67 65 72 73 | 20 6c 69 74 65 72 61 6c |integers| literal|
|00004790| 73 20 7b 5c 69 74 20 6c | 65 6e 5c 2f 7d 20 61 6e |s {\it l|en\/} an|
|000047a0| 64 20 7b 5c 69 74 20 73 | 74 61 72 74 7d 2c 20 61 |d {\it s|tart}, a|
|000047b0| 6e 64 20 61 0a 73 74 72 | 69 6e 67 20 6c 69 74 65 |nd a.str|ing lite|
|000047c0| 72 61 6c 2c 20 69 6e 20 | 74 68 61 74 20 6f 72 64 |ral, in |that ord|
|000047d0| 65 72 29 2e 0a 49 74 20 | 70 75 73 68 65 73 20 74 |er)..It |pushes t|
|000047e0| 68 65 20 73 75 62 73 74 | 72 69 6e 67 20 6f 66 20 |he subst|ring of |
|000047f0| 74 68 65 20 28 61 74 20 | 6d 6f 73 74 29 20 7b 5c |the (at |most) {\|
|00004800| 69 74 20 6c 65 6e 5c 2f | 7d 20 63 6f 6e 73 65 63 |it len\/|} consec|
|00004810| 75 74 69 76 65 20 63 68 | 61 72 61 63 74 65 72 73 |utive ch|aracters|
|00004820| 0a 73 74 61 72 74 69 6e | 67 20 61 74 20 74 68 65 |.startin|g at the|
|00004830| 20 7b 5c 69 74 20 73 74 | 61 72 74 5c 2f 7d 74 68 | {\it st|art\/}th|
|00004840| 20 63 68 61 72 61 63 74 | 65 72 20 28 61 73 73 75 | charact|er (assu|
|00004850| 6d 69 6e 67 20 31 2d 62 | 61 73 65 64 20 69 6e 64 |ming 1-b|ased ind|
|00004860| 65 78 69 6e 67 29 0a 69 | 66 20 7b 5c 69 74 20 73 |exing).i|f {\it s|
|00004870| 74 61 72 74 5c 2f 7d 20 | 69 73 20 70 6f 73 69 74 |tart\/} |is posit|
|00004880| 69 76 65 2c 20 61 6e 64 | 20 65 6e 64 69 6e 67 20 |ive, and| ending |
|00004890| 61 74 20 74 68 65 20 24 | 2d 24 7b 5c 69 74 20 73 |at the $|-${\it s|
|000048a0| 74 61 72 74 5c 2f 7d 74 | 68 20 63 68 61 72 61 63 |tart\/}t|h charac|
|000048b0| 74 65 72 0a 66 72 6f 6d | 20 74 68 65 20 65 6e 64 |ter.from| the end|
|000048c0| 20 69 66 20 7b 5c 69 74 | 20 73 74 61 72 74 5c 2f | if {\it| start\/|
|000048d0| 7d 20 69 73 20 6e 65 67 | 61 74 69 76 65 0a 28 77 |} is neg|ative.(w|
|000048e0| 68 65 72 65 20 74 68 65 | 20 66 69 72 73 74 20 63 |here the| first c|
|000048f0| 68 61 72 61 63 74 65 72 | 20 66 72 6f 6d 20 74 68 |haracter| from th|
|00004900| 65 20 65 6e 64 20 69 73 | 20 74 68 65 20 6c 61 73 |e end is| the las|
|00004910| 74 20 63 68 61 72 61 63 | 74 65 72 29 2e 0a 0a 5c |t charac|ter)...\|
|00004920| 69 74 65 6d 5b 5c 68 62 | 6f 78 7b 5c 74 74 20 73 |item[\hb|ox{\tt s|
|00004930| 77 61 70 5c 24 7d 5c 68 | 66 69 6c 6c 5d 0a 53 77 |wap\$}\h|fill].Sw|
|00004940| 61 70 73 20 74 68 65 20 | 74 6f 70 20 74 77 6f 20 |aps the |top two |
|00004950| 6c 69 74 65 72 61 6c 73 | 20 6f 6e 20 74 68 65 20 |literals| on the |
|00004960| 73 74 61 63 6b 2e 0a 0a | 5c 69 74 65 6d 5b 5c 68 |stack...|\item[\h|
|00004970| 62 6f 78 7b 5c 74 74 20 | 74 65 78 74 2e 6c 65 6e |box{\tt |text.len|
|00004980| 67 74 68 5c 24 7d 5c 68 | 66 69 6c 6c 5d 0a 50 6f |gth\$}\h|fill].Po|
|00004990| 70 73 20 74 68 65 20 74 | 6f 70 20 28 73 74 72 69 |ps the t|op (stri|
|000049a0| 6e 67 29 20 6c 69 74 65 | 72 61 6c 2c 0a 61 6e 64 |ng) lite|ral,.and|
|000049b0| 20 70 75 73 68 65 73 20 | 74 68 65 20 6e 75 6d 62 | pushes |the numb|
|000049c0| 65 72 20 6f 66 20 74 65 | 78 74 20 63 68 61 72 61 |er of te|xt chara|
|000049d0| 63 74 65 72 73 20 69 74 | 20 63 6f 6e 74 61 69 6e |cters it| contain|
|000049e0| 73 2c 20 77 68 65 72 65 | 20 61 6e 0a 61 63 63 65 |s, where| an.acce|
|000049f0| 6e 74 65 64 20 63 68 61 | 72 61 63 74 65 72 20 28 |nted cha|racter (|
|00004a00| 6d 6f 72 65 20 70 72 65 | 63 69 73 65 6c 79 2c 20 |more pre|cisely, |
|00004a10| 61 20 60 60 73 70 65 63 | 69 61 6c 20 63 68 61 72 |a ``spec|ial char|
|00004a20| 61 63 74 65 72 27 27 24 | 5c 21 24 2c 0a 64 65 66 |acter''$|\!$,.def|
|00004a30| 69 6e 65 64 20 69 6e 20 | 53 65 63 74 69 6f 6e 7e |ined in |Section~|
|00004a40| 34 29 0a 63 6f 75 6e 74 | 73 20 61 73 20 61 20 73 |4).count|s as a s|
|00004a50| 69 6e 67 6c 65 20 74 65 | 78 74 20 63 68 61 72 61 |ingle te|xt chara|
|00004a60| 63 74 65 72 2c 20 65 76 | 65 6e 20 69 66 20 69 74 |cter, ev|en if it|
|00004a70| 27 73 20 6d 69 73 73 69 | 6e 67 0a 69 74 73 20 6d |'s missi|ng.its m|
|00004a80| 61 74 63 68 69 6e 67 20 | 72 69 67 68 74 20 62 72 |atching |right br|
|00004a90| 61 63 65 2c 20 61 6e 64 | 20 77 68 65 72 65 20 62 |ace, and| where b|
|00004aa0| 72 61 63 65 73 20 64 6f | 6e 27 74 20 63 6f 75 6e |races do|n't coun|
|00004ab0| 74 20 61 73 0a 74 65 78 | 74 20 63 68 61 72 61 63 |t as.tex|t charac|
|00004ac0| 74 65 72 73 2e 0a 0a 5c | 69 74 65 6d 5b 5c 68 62 |ters...\|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 65 73 20 | 74 68 65 20 73 75 62 73 | pushes |the subs|
|00004b60| 74 72 69 6e 67 20 6f 66 | 20 74 68 65 20 28 61 74 |tring of| the (at|
|00004b70| 20 6d 6f 73 74 29 20 7b | 5c 69 74 20 6c 65 6e 5c | most) {|\it len\|
|00004b80| 2f 7d 20 63 6f 6e 73 65 | 63 75 74 69 76 65 20 74 |/} conse|cutive t|
|00004b90| 65 78 74 0a 63 68 61 72 | 61 63 74 65 72 73 20 73 |ext.char|acters s|
|00004ba0| 74 61 72 74 69 6e 67 20 | 66 72 6f 6d 20 74 68 65 |tarting |from the|
|00004bb0| 20 62 65 67 69 6e 6e 69 | 6e 67 20 6f 66 20 74 68 | beginni|ng of th|
|00004bc0| 65 20 73 74 72 69 6e 67 | 2e 20 20 54 68 69 73 20 |e string|. This |
|00004bd0| 66 75 6e 63 74 69 6f 6e | 0a 69 73 20 73 69 6d 69 |function|.is simi|
|00004be0| 6c 61 72 20 74 6f 20 5c | 68 62 6f 78 7b 5c 74 74 |lar to \|hbox{\tt|
|00004bf0| 20 73 75 62 73 74 72 69 | 6e 67 5c 24 7d 2c 20 62 | substri|ng\$}, b|
|00004c00| 75 74 20 74 68 69 73 20 | 6f 6e 65 20 63 6f 6e 73 |ut this |one cons|
|00004c10| 69 64 65 72 73 0a 61 20 | 60 60 73 70 65 63 69 61 |iders.a |``specia|
|00004c20| 6c 20 63 68 61 72 61 63 | 74 65 72 27 27 24 5c 21 |l charac|ter''$\!|
|00004c30| 24 2c 20 65 76 65 6e 20 | 69 66 0a 69 74 27 73 20 |$, even |if.it's |
|00004c40| 6d 69 73 73 69 6e 67 20 | 69 74 73 20 6d 61 74 63 |missing |its matc|
|00004c50| 68 69 6e 67 20 72 69 67 | 68 74 20 62 72 61 63 65 |hing rig|ht brace|
|00004c60| 2c 20 74 6f 20 62 65 20 | 61 20 73 69 6e 67 6c 65 |, to be |a single|
|00004c70| 20 74 65 78 74 20 63 68 | 61 72 61 63 74 65 72 0a | text ch|aracter.|
|00004c80| 28 72 61 74 68 65 72 20 | 74 68 61 6e 20 68 6f 77 |(rather |than how|
|00004c90| 65 76 65 72 20 6d 61 6e | 79 20 41 53 43 49 49 20 |ever man|y ASCII |
|00004ca0| 63 68 61 72 61 63 74 65 | 72 73 20 69 74 20 61 63 |characte|rs it ac|
|00004cb0| 74 75 61 6c 6c 79 20 63 | 6f 6d 70 72 69 73 65 73 |tually c|omprises|
|00004cc0| 29 2c 0a 61 6e 64 20 74 | 68 69 73 20 66 75 6e 63 |),.and t|his func|
|00004cd0| 74 69 6f 6e 20 64 6f 65 | 73 6e 27 74 20 63 6f 6e |tion doe|sn't con|
|00004ce0| 73 69 64 65 72 20 62 72 | 61 63 65 73 20 74 6f 20 |sider br|aces to |
|00004cf0| 62 65 20 74 65 78 74 20 | 63 68 61 72 61 63 74 65 |be text |characte|
|00004d00| 72 73 3b 0a 66 75 72 74 | 68 65 72 6d 6f 72 65 2c |rs;.furt|hermore,|
|00004d10| 20 74 68 69 73 20 66 75 | 6e 63 74 69 6f 6e 20 61 | this fu|nction a|
|00004d20| 70 70 65 6e 64 73 20 61 | 6e 79 20 6e 65 65 64 65 |ppends a|ny neede|
|00004d30| 64 20 6d 61 74 63 68 69 | 6e 67 20 72 69 67 68 74 |d matchi|ng right|
|00004d40| 20 62 72 61 63 65 73 2e | 0a 0a 5c 69 74 65 6d 5b | braces.|..\item[|
|00004d50| 5c 68 62 6f 78 7b 5c 74 | 74 20 74 6f 70 5c 24 7d |\hbox{\t|t top\$}|
|00004d60| 5c 68 66 69 6c 6c 5d 0a | 50 6f 70 73 20 61 6e 64 |\hfill].|Pops and|
|00004d70| 20 70 72 69 6e 74 73 20 | 74 68 65 20 74 6f 70 20 | prints |the top |
|00004d80| 6f 66 20 74 68 65 20 73 | 74 61 63 6b 20 6f 6e 20 |of the s|tack on |
|00004d90| 74 68 65 20 74 65 72 6d | 69 6e 61 6c 20 61 6e 64 |the term|inal and|
|00004da0| 20 6c 6f 67 20 66 69 6c | 65 2e 0a 49 74 27 73 20 | log fil|e..It's |
|00004db0| 75 73 65 66 75 6c 20 66 | 6f 72 20 64 65 62 75 67 |useful f|or debug|
|00004dc0| 67 69 6e 67 2e 0a 0a 5c | 69 74 65 6d 5b 5c 68 62 |ging...\|item[\hb|
|00004dd0| 6f 78 7b 5c 74 74 20 74 | 79 70 65 5c 24 7d 5c 68 |ox{\tt t|ype\$}\h|
|00004de0| 66 69 6c 6c 5d 0a 50 75 | 73 68 65 73 20 74 68 65 |fill].Pu|shes the|
|00004df0| 20 63 75 72 72 65 6e 74 | 20 65 6e 74 72 79 27 73 | current| entry's|
|00004e00| 20 74 79 70 65 20 28 62 | 6f 6f 6b 2c 20 61 72 74 | type (b|ook, art|
|00004e10| 69 63 6c 65 2c 20 65 74 | 63 2e 29 2c 0a 62 75 74 |icle, et|c.),.but|
|00004e20| 20 70 75 73 68 65 73 20 | 74 68 65 20 6e 75 6c 6c | pushes |the null|
|00004e30| 20 73 74 72 69 6e 67 0a | 69 66 20 74 68 65 20 74 | string.|if the t|
|00004e40| 79 70 65 20 69 73 20 65 | 69 74 68 65 72 20 75 6e |ype is e|ither un|
|00004e50| 6b 6e 6f 77 6e 20 6f 72 | 20 75 6e 64 65 66 69 6e |known or| undefin|
|00004e60| 65 64 2e 0a 0a 5c 69 74 | 65 6d 5b 5c 68 62 6f 78 |ed...\it|em[\hbox|
|00004e70| 7b 5c 74 74 20 77 61 72 | 6e 69 6e 67 5c 24 7d 5c |{\tt war|ning\$}\|
|00004e80| 68 66 69 6c 6c 5d 0a 50 | 6f 70 73 20 74 68 65 20 |hfill].P|ops the |
|00004e90| 74 6f 70 20 28 73 74 72 | 69 6e 67 29 20 6c 69 74 |top (str|ing) lit|
|00004ea0| 65 72 61 6c 0a 61 6e 64 | 20 70 72 69 6e 74 73 20 |eral.and| prints |
|00004eb0| 69 74 20 66 6f 6c 6c 6f | 77 69 6e 67 20 61 20 77 |it follo|wing a w|
|00004ec0| 61 72 6e 69 6e 67 20 6d | 65 73 73 61 67 65 2e 0a |arning m|essage..|
|00004ed0| 54 68 69 73 20 61 6c 73 | 6f 20 69 6e 63 72 65 6d |This als|o increm|
|00004ee0| 65 6e 74 73 20 61 20 63 | 6f 75 6e 74 20 6f 66 20 |ents a c|ount of |
|00004ef0| 74 68 65 20 6e 75 6d 62 | 65 72 20 6f 66 20 77 61 |the numb|er of wa|
|00004f00| 72 6e 69 6e 67 20 6d 65 | 73 73 61 67 65 73 20 69 |rning me|ssages i|
|00004f10| 73 73 75 65 64 2e 0a 0a | 5c 69 74 65 6d 5b 5c 68 |ssued...|\item[\h|
|00004f20| 62 6f 78 7b 5c 74 74 20 | 77 68 69 6c 65 5c 24 7d |box{\tt |while\$}|
|00004f30| 5c 68 66 69 6c 6c 5d 0a | 50 6f 70 73 20 74 68 65 |\hfill].|Pops the|
|00004f40| 20 74 6f 70 20 74 77 6f | 20 28 66 75 6e 63 74 69 | top two| (functi|
|00004f50| 6f 6e 29 20 6c 69 74 65 | 72 61 6c 73 2c 0a 61 6e |on) lite|rals,.an|
|00004f60| 64 20 6b 65 65 70 73 20 | 65 78 65 63 75 74 69 6e |d keeps |executin|
|00004f70| 67 20 74 68 65 20 73 65 | 63 6f 6e 64 20 61 73 20 |g the se|cond as |
|00004f80| 6c 6f 6e 67 20 61 73 20 | 74 68 65 20 28 69 6e 74 |long as |the (int|
|00004f90| 65 67 65 72 29 0a 6c 69 | 74 65 72 61 6c 20 6c 65 |eger).li|teral le|
|00004fa0| 66 74 20 6f 6e 20 74 68 | 65 20 73 74 61 63 6b 20 |ft on th|e stack |
|00004fb0| 62 79 20 65 78 65 63 75 | 74 69 6e 67 20 74 68 65 |by execu|ting the|
|00004fc0| 20 66 69 72 73 74 20 69 | 73 20 67 72 65 61 74 65 | first i|s greate|
|00004fd0| 72 20 74 68 61 6e 20 30 | 2e 0a 0a 5c 69 74 65 6d |r than 0|...\item|
|00004fe0| 5b 5c 68 62 6f 78 7b 5c | 74 74 20 77 69 64 74 68 |[\hbox{\|tt width|
|00004ff0| 5c 24 7d 5c 68 66 69 6c | 6c 5d 0a 50 6f 70 73 20 |\$}\hfil|l].Pops |
|00005000| 74 68 65 20 74 6f 70 20 | 28 73 74 72 69 6e 67 29 |the top |(string)|
|00005010| 20 6c 69 74 65 72 61 6c | 0a 61 6e 64 20 70 75 73 | literal|.and pus|
|00005020| 68 65 73 20 74 68 65 20 | 69 6e 74 65 67 65 72 20 |hes the |integer |
|00005030| 74 68 61 74 20 72 65 70 | 72 65 73 65 6e 74 73 20 |that rep|resents |
|00005040| 69 74 73 20 77 69 64 74 | 68 20 69 6e 20 73 6f 6d |its widt|h in som|
|00005050| 65 20 72 65 6c 61 74 69 | 76 65 20 75 6e 69 74 73 |e relati|ve units|
|00005060| 0a 28 63 75 72 72 65 6e | 74 6c 79 2c 20 68 75 6e |.(curren|tly, hun|
|00005070| 64 72 65 64 74 68 73 20 | 6f 66 20 61 20 70 6f 69 |dredths |of a poi|
|00005080| 6e 74 2c 20 61 73 20 73 | 70 65 63 69 66 69 65 64 |nt, as s|pecified|
|00005090| 20 62 79 20 74 68 65 20 | 4a 75 6e 65 20 31 39 38 | by the |June 198|
|000050a0| 37 20 76 65 72 73 69 6f | 6e 0a 6f 66 20 74 68 65 |7 versio|n.of the|
|000050b0| 20 24 63 6d 72 31 30 24 | 20 66 6f 6e 74 3b 20 74 | $cmr10$| font; t|
|000050c0| 68 65 20 6f 6e 6c 79 20 | 77 68 69 74 65 2d 73 70 |he only |white-sp|
|000050d0| 61 63 65 20 63 68 61 72 | 61 63 74 65 72 20 77 69 |ace char|acter wi|
|000050e0| 74 68 20 6e 6f 6e 7a 65 | 72 6f 20 77 69 64 74 68 |th nonze|ro width|
|000050f0| 0a 69 73 20 74 68 65 20 | 73 70 61 63 65 29 2e 0a |.is the |space)..|
|00005100| 54 68 69 73 20 66 75 6e | 63 74 69 6f 6e 20 74 61 |This fun|ction ta|
|00005110| 6b 65 73 20 74 68 65 20 | 6c 69 74 65 72 61 6c 20 |kes the |literal |
|00005120| 6c 69 74 65 72 61 6c 6c | 79 3b 0a 74 68 61 74 20 |literall|y;.that |
|00005130| 69 73 2c 20 69 74 20 61 | 73 73 75 6d 65 73 20 65 |is, it a|ssumes e|
|00005140| 61 63 68 20 63 68 61 72 | 61 63 74 65 72 20 69 6e |ach char|acter in|
|00005150| 20 74 68 65 20 73 74 72 | 69 6e 67 20 69 73 20 74 | the str|ing is t|
|00005160| 6f 20 62 65 20 70 72 69 | 6e 74 65 64 20 61 73 0a |o be pri|nted as.|
|00005170| 69 73 2c 20 72 65 67 61 | 72 64 6c 65 73 73 20 6f |is, rega|rdless o|
|00005180| 66 20 77 68 65 74 68 65 | 72 20 74 68 65 20 63 68 |f whethe|r the ch|
|00005190| 61 72 61 63 74 65 72 20 | 68 61 73 20 61 20 73 70 |aracter |has a sp|
|000051a0| 65 63 69 61 6c 20 6d 65 | 61 6e 69 6e 67 20 74 6f |ecial me|aning to|
|000051b0| 20 5c 54 65 58 2c 0a 65 | 78 63 65 70 74 20 74 68 | \TeX,.e|xcept th|
|000051c0| 61 74 20 60 60 73 70 65 | 63 69 61 6c 20 63 68 61 |at ``spe|cial cha|
|000051d0| 72 61 63 74 65 72 73 27 | 27 20 28 65 76 65 6e 20 |racters'|' (even |
|000051e0| 77 69 74 68 6f 75 74 20 | 74 68 65 69 72 20 72 69 |without |their ri|
|000051f0| 67 68 74 20 62 72 61 63 | 65 73 29 20 61 72 65 0a |ght brac|es) are.|
|00005200| 68 61 6e 64 6c 65 64 20 | 73 70 65 63 69 61 6c 6c |handled |speciall|
|00005210| 79 2e 0a 54 68 69 73 20 | 69 73 20 6d 65 61 6e 74 |y..This |is meant|
|00005220| 20 74 6f 20 62 65 20 75 | 73 65 64 20 66 6f 72 20 | to be u|sed for |
|00005230| 63 6f 6d 70 61 72 69 6e | 67 20 77 69 64 74 68 73 |comparin|g widths|
|00005240| 20 6f 66 20 6c 61 62 65 | 6c 20 73 74 72 69 6e 67 | of labe|l string|
|00005250| 73 2e 0a 0a 5c 69 74 65 | 6d 5b 5c 68 62 6f 78 7b |s...\ite|m[\hbox{|
|00005260| 5c 74 74 20 77 72 69 74 | 65 5c 24 7d 5c 68 66 69 |\tt writ|e\$}\hfi|
|00005270| 6c 6c 5d 0a 50 6f 70 73 | 20 74 68 65 20 74 6f 70 |ll].Pops| the top|
|00005280| 20 28 73 74 72 69 6e 67 | 29 20 6c 69 74 65 72 61 | (string|) litera|
|00005290| 6c 0a 61 6e 64 20 77 72 | 69 74 65 73 20 69 74 20 |l.and wr|ites it |
|000052a0| 6f 6e 20 74 68 65 20 6f | 75 74 70 75 74 20 62 75 |on the o|utput bu|
|000052b0| 66 66 65 72 20 28 77 68 | 69 63 68 20 77 69 6c 6c |ffer (wh|ich will|
|000052c0| 20 72 65 73 75 6c 74 20 | 69 6e 0a 73 74 75 66 66 | result |in.stuff|
|000052d0| 20 62 65 69 6e 67 20 77 | 72 69 74 74 65 6e 20 6f | being w|ritten o|
|000052e0| 6e 74 6f 20 74 68 65 20 | 7b 5c 74 74 20 62 62 6c |nto the |{\tt bbl|
|000052f0| 7d 20 66 69 6c 65 20 77 | 68 65 6e 20 74 68 65 20 |} file w|hen the |
|00005300| 62 75 66 66 65 72 20 66 | 69 6c 6c 73 20 75 70 29 |buffer f|ills up)|
|00005310| 2e 0a 0a 5c 65 6e 64 7b | 64 65 73 63 72 69 70 74 |...\end{|descript|
|00005320| 69 6f 6e 7d 0a 0a 4e 6f | 74 65 20 74 68 61 74 20 |ion}..No|te that |
|00005330| 74 68 65 20 62 75 69 6c | 74 2d 69 6e 20 66 75 6e |the buil|t-in fun|
|00005340| 63 74 69 6f 6e 73 20 5c | 68 62 6f 78 7b 5c 74 74 |ctions \|hbox{\tt|
|00005350| 20 77 68 69 6c 65 5c 24 | 7d 20 61 6e 64 20 5c 68 | while\$|} and \h|
|00005360| 62 6f 78 7b 5c 74 74 20 | 69 66 5c 24 7d 0a 72 65 |box{\tt |if\$}.re|
|00005370| 71 75 69 72 65 20 74 77 | 6f 20 66 75 6e 63 74 69 |quire tw|o functi|
|00005380| 6f 6e 20 6c 69 74 65 72 | 61 6c 73 20 6f 6e 20 74 |on liter|als on t|
|00005390| 68 65 20 73 74 61 63 6b | 2e 0a 59 6f 75 20 67 65 |he stack|..You ge|
|000053a0| 74 20 74 68 65 6d 20 74 | 68 65 72 65 20 65 69 74 |t them t|here eit|
|000053b0| 68 65 72 20 62 79 20 69 | 6d 6d 65 64 69 61 74 65 |her by i|mmediate|
|000053c0| 6c 79 20 70 72 65 63 65 | 64 69 6e 67 20 74 68 65 |ly prece|ding the|
|000053d0| 20 6e 61 6d 65 20 6f 66 | 20 61 20 66 75 6e 63 74 | name of| a funct|
|000053e0| 69 6f 6e 0a 62 79 20 61 | 20 73 69 6e 67 6c 65 20 |ion.by a| single |
|000053f0| 71 75 6f 74 65 2c 20 6f | 72 2c 20 69 66 20 79 6f |quote, o|r, if yo|
|00005400| 75 20 64 6f 6e 27 74 20 | 66 65 65 6c 20 6c 69 6b |u don't |feel lik|
|00005410| 65 20 64 65 66 69 6e 69 | 6e 67 20 61 20 6e 65 77 |e defini|ng a new|
|00005420| 20 66 75 6e 63 74 69 6f | 6e 20 77 69 74 68 0a 74 | functio|n with.t|
|00005430| 68 65 20 5c 68 62 6f 78 | 7b 5c 74 74 20 46 55 4e |he \hbox|{\tt FUN|
|00005440| 43 54 49 4f 4e 7d 20 63 | 6f 6d 6d 61 6e 64 2c 0a |CTION} c|ommand,.|
|00005450| 62 79 20 73 69 6d 70 6c | 79 20 67 69 76 69 6e 67 |by simpl|y giving|
|00005460| 20 69 74 73 20 64 65 66 | 69 6e 69 74 69 6f 6e 20 | its def|inition |
|00005470| 28 74 68 61 74 20 69 73 | 2c 20 67 69 76 69 6e 67 |(that is|, giving|
|00005480| 20 77 68 61 74 20 77 6f | 75 6c 64 20 62 65 20 74 | what wo|uld be t|
|00005490| 68 65 20 73 65 63 6f 6e | 64 0a 61 72 67 75 6d 65 |he secon|d.argume|
|000054a0| 6e 74 20 74 6f 20 74 68 | 65 20 5c 68 62 6f 78 7b |nt to th|e \hbox{|
|000054b0| 5c 74 74 20 46 55 4e 43 | 54 49 4f 4e 7d 20 63 6f |\tt FUNC|TION} co|
|000054c0| 6d 6d 61 6e 64 2c 20 69 | 6e 63 6c 75 64 69 6e 67 |mmand, i|ncluding|
|000054d0| 20 74 68 65 20 73 75 72 | 72 6f 75 6e 64 69 6e 67 | the sur|rounding|
|000054e0| 20 62 72 61 63 65 73 29 | 2e 0a 46 6f 72 20 65 78 | braces)|..For ex|
|000054f0| 61 6d 70 6c 65 20 74 68 | 65 20 66 6f 6c 6c 6f 77 |ample th|e follow|
|00005500| 69 6e 67 20 66 75 6e 63 | 74 69 6f 6e 20 66 72 61 |ing func|tion fra|
|00005510| 67 6d 65 6e 74 20 61 70 | 70 65 6e 64 73 20 74 68 |gment ap|pends th|
|00005520| 65 20 63 68 61 72 61 63 | 74 65 72 20 60 7b 5c 74 |e charac|ter `{\t|
|00005530| 74 20 61 7d 27 0a 69 66 | 20 74 68 65 20 73 74 72 |t a}'.if| the str|
|00005540| 69 6e 67 20 76 61 72 69 | 61 62 6c 65 20 6e 61 6d |ing vari|able nam|
|00005550| 65 64 20 5c 68 62 6f 78 | 7b 5c 74 74 20 6c 61 62 |ed \hbox|{\tt lab|
|00005560| 65 6c 7d 20 69 73 20 6e | 6f 6e 6e 75 6c 6c 3a 0a |el} is n|onnull:.|
|00005570| 5c 62 65 67 69 6e 7b 76 | 65 72 62 61 74 69 6d 7d |\begin{v|erbatim}|
|00005580| 0a 20 20 20 20 2e 20 20 | 2e 20 20 2e 0a 20 20 20 |. . |. .. |
|00005590| 20 6c 61 62 65 6c 20 22 | 22 20 3d 0a 20 20 20 20 | label "|" =. |
|000055a0| 20 20 27 73 6b 69 70 24 | 0a 20 20 20 20 20 20 7b | 'skip$|. {|
|000055b0| 20 6c 61 62 65 6c 20 22 | 61 22 20 2a 20 27 6c 61 | label "|a" * 'la|
|000055c0| 62 65 6c 20 3a 3d 20 7d | 0a 20 20 20 20 69 66 24 |bel := }|. if$|
|000055d0| 0a 20 20 20 20 2e 20 20 | 2e 20 20 2e 0a 5c 65 6e |. . |. ..\en|
|000055e0| 64 7b 76 65 72 62 61 74 | 69 6d 7d 0a 41 20 66 75 |d{verbat|im}.A fu|
|000055f0| 6e 63 74 69 6f 6e 20 77 | 68 6f 73 65 20 6e 61 6d |nction w|hose nam|
|00005600| 65 20 79 6f 75 20 71 75 | 6f 74 65 20 6e 65 65 64 |e you qu|ote need|
|00005610| 6e 27 74 20 62 65 20 62 | 75 69 6c 74 20 69 6e 0a |n't be b|uilt in.|
|00005620| 6c 69 6b 65 20 5c 68 62 | 6f 78 7b 5c 74 74 20 73 |like \hb|ox{\tt s|
|00005630| 6b 69 70 5c 24 7d 20 61 | 62 6f 76 65 2d 2d 2d 69 |kip\$} a|bove---i|
|00005640| 74 20 6d 61 79 2c 20 66 | 6f 72 20 65 78 61 6d 70 |t may, f|or examp|
|00005650| 6c 65 2c 0a 62 65 20 61 | 20 66 69 65 6c 64 20 6e |le,.be a| field n|
|00005660| 61 6d 65 20 6f 72 20 61 | 20 66 75 6e 63 74 69 6f |ame or a| functio|
|00005670| 6e 20 79 6f 75 27 76 65 | 20 64 65 66 69 6e 65 64 |n you've| defined|
|00005680| 20 65 61 72 6c 69 65 72 | 2e 0a 0a 0a 5c 73 75 62 | earlier|....\sub|
|00005690| 73 65 63 74 69 6f 6e 7b | 4e 61 6d 65 20 66 6f 72 |section{|Name for|
|000056a0| 6d 61 74 74 69 6e 67 7d | 0a 0a 57 68 61 74 27 73 |matting}|..What's|
|000056b0| 20 69 6e 20 61 20 6e 61 | 6d 65 3f 0a 53 65 63 74 | in a na|me?.Sect|
|000056c0| 69 6f 6e 7e 34 20 70 72 | 65 74 74 79 20 6d 75 63 |ion~4 pr|etty muc|
|000056d0| 68 20 64 65 73 63 72 69 | 62 65 73 20 74 68 69 73 |h descri|bes this|
|000056e0| 2e 0a 45 61 63 68 20 6e | 61 6d 65 20 63 6f 6e 73 |..Each n|ame cons|
|000056f0| 69 73 74 73 20 6f 66 20 | 66 6f 75 72 20 70 61 72 |ists of |four par|
|00005700| 74 73 3a 20 46 69 72 73 | 74 2c 20 76 6f 6e 2c 20 |ts: Firs|t, von, |
|00005710| 4c 61 73 74 2c 20 61 6e | 64 20 4a 72 3b 0a 65 61 |Last, an|d Jr;.ea|
|00005720| 63 68 20 63 6f 6e 73 69 | 73 74 73 20 6f 66 20 61 |ch consi|sts of a|
|00005730| 20 6c 69 73 74 20 6f 66 | 20 6e 61 6d 65 2d 74 6f | list of| name-to|
|00005740| 6b 65 6e 73 2c 0a 61 6e | 64 20 61 6e 79 20 6c 69 |kens,.an|d any li|
|00005750| 73 74 20 62 75 74 20 4c | 61 73 74 27 73 20 6d 61 |st but L|ast's ma|
|00005760| 79 20 62 65 20 65 6d 70 | 74 79 20 66 6f 72 20 61 |y be emp|ty for a|
|00005770| 20 6e 6f 6e 6e 75 6c 6c | 20 6e 61 6d 65 2e 0a 54 | nonnull| name..T|
|00005780| 68 69 73 20 73 75 62 73 | 65 63 74 69 6f 6e 20 64 |his subs|ection d|
|00005790| 65 73 63 72 69 62 65 73 | 20 74 68 65 20 66 6f 72 |escribes| the for|
|000057a0| 6d 61 74 20 73 74 72 69 | 6e 67 20 79 6f 75 20 6d |mat stri|ng you m|
|000057b0| 75 73 74 20 73 75 70 70 | 6c 79 20 74 6f 0a 74 68 |ust supp|ly to.th|
|000057c0| 65 20 62 75 69 6c 74 2d | 69 6e 20 66 75 6e 63 74 |e built-|in funct|
|000057d0| 69 6f 6e 20 5c 68 62 6f | 78 7b 5c 74 74 20 66 6f |ion \hbo|x{\tt fo|
|000057e0| 72 6d 61 74 2e 6e 61 6d | 65 5c 24 7d 2e 0a 0a 4c |rmat.nam|e\$}...L|
|000057f0| 65 74 27 73 20 6c 6f 6f | 6b 20 61 74 20 61 6e 20 |et's loo|k at an |
|00005800| 65 78 61 6d 70 6c 65 20 | 6f 66 20 61 20 76 65 72 |example |of a ver|
|00005810| 79 20 6c 6f 6e 67 20 6e | 61 6d 65 2e 0a 53 75 70 |y long n|ame..Sup|
|00005820| 70 6f 73 65 20 61 20 64 | 61 74 61 62 61 73 65 20 |pose a d|atabase |
|00005830| 65 6e 74 72 79 7e 5c 63 | 69 74 65 7b 70 72 69 6d |entry~\c|ite{prim|
|00005840| 65 2d 6e 75 6d 62 65 72 | 2d 74 68 65 6f 72 65 6d |e-number|-theorem|
|00005850| 7d 20 68 61 73 20 74 68 | 65 20 66 69 65 6c 64 0a |} has th|e field.|
|00005860| 5c 62 65 67 69 6e 7b 76 | 65 72 62 61 74 69 6d 7d |\begin{v|erbatim}|
|00005870| 0a 20 20 61 75 74 68 6f | 72 20 3d 20 22 43 68 61 |. autho|r = "Cha|
|00005880| 72 6c 65 73 20 4c 6f 75 | 69 73 20 58 61 76 69 65 |rles Lou|is Xavie|
|00005890| 72 20 4a 6f 73 65 70 68 | 20 64 65 20 6c 61 20 56 |r Joseph| de la V|
|000058a0| 61 6c 6c 7b 5c 27 65 7d | 65 20 50 6f 75 73 73 69 |all{\'e}|e Poussi|
|000058b0| 6e 22 0a 5c 65 6e 64 7b | 76 65 72 62 61 74 69 6d |n".\end{|verbatim|
|000058c0| 7d 0a 61 6e 64 20 73 75 | 70 70 6f 73 65 20 79 6f |}.and su|ppose yo|
|000058d0| 75 20 77 61 6e 74 20 74 | 68 69 73 20 66 6f 72 6d |u want t|his form|
|000058e0| 61 74 74 65 64 20 60 60 | 6c 61 73 74 20 6e 61 6d |atted ``|last nam|
|000058f0| 65 20 63 6f 6d 6d 61 20 | 69 6e 69 74 69 61 6c 73 |e comma |initials|
|00005900| 27 27 24 5c 21 24 2e 0a | 49 66 20 79 6f 75 20 75 |''$\!$..|If you u|
|00005910| 73 65 20 74 68 65 20 66 | 6f 72 6d 61 74 20 73 74 |se the f|ormat st|
|00005920| 72 69 6e 67 0a 5c 62 65 | 67 69 6e 7b 76 65 72 62 |ring.\be|gin{verb|
|00005930| 61 74 69 6d 7d 0a 20 20 | 20 20 22 7b 76 76 7e 7d |atim}. | "{vv~}|
|00005940| 7b 6c 6c 7d 7b 2c 20 6a | 6a 7d 7b 2c 20 66 7d 3f |{ll}{, j|j}{, f}?|
|00005950| 22 0a 5c 65 6e 64 7b 76 | 65 72 62 61 74 69 6d 7d |".\end{v|erbatim}|
|00005960| 0a 5c 42 69 62 54 65 58 | 5c 20 77 69 6c 6c 20 70 |.\BibTeX|\ will p|
|00005970| 72 6f 64 75 63 65 0a 5c | 62 65 67 69 6e 7b 76 65 |roduce.\|begin{ve|
|00005980| 72 62 61 74 69 6d 7d 0a | 20 20 20 20 64 65 7e 6c |rbatim}.| de~l|
|00005990| 61 20 56 61 6c 6c 7b 5c | 27 65 7d 65 7e 50 6f 75 |a Vall{\|'e}e~Pou|
|000059a0| 73 73 69 6e 2c 20 43 2e | 7e 4c 2e 20 58 2e 7e 4a |ssin, C.|~L. X.~J|
|000059b0| 3f 0a 5c 65 6e 64 7b 76 | 65 72 62 61 74 69 6d 7d |?.\end{v|erbatim}|
|000059c0| 0a 61 73 20 74 68 65 20 | 66 6f 72 6d 61 74 74 65 |.as the |formatte|
|000059d0| 64 20 73 74 72 69 6e 67 | 2e 0a 0a 4c 65 74 27 73 |d string|...Let's|
|000059e0| 20 6c 6f 6f 6b 20 61 74 | 20 74 68 69 73 20 65 78 | look at| this ex|
|000059f0| 61 6d 70 6c 65 20 69 6e | 20 64 65 74 61 69 6c 2e |ample in| detail.|
|00005a00| 0a 54 68 65 72 65 20 61 | 72 65 20 66 6f 75 72 20 |.There a|re four |
|00005a10| 62 72 61 63 65 2d 6c 65 | 76 65 6c 7e 31 20 7b 5c |brace-le|vel~1 {\|
|00005a20| 65 6d 20 70 69 65 63 65 | 73 5c 2f 7d 20 74 6f 20 |em piece|s\/} to |
|00005a30| 74 68 69 73 20 66 6f 72 | 6d 61 74 20 73 74 72 69 |this for|mat stri|
|00005a40| 6e 67 2c 0a 6f 6e 65 20 | 66 6f 72 20 65 61 63 68 |ng,.one |for each|
|00005a50| 20 70 61 72 74 20 6f 66 | 20 61 20 6e 61 6d 65 2e | part of| a name.|
|00005a60| 0a 49 66 20 74 68 65 20 | 63 6f 72 72 65 73 70 6f |.If the |correspo|
|00005a70| 6e 64 69 6e 67 20 70 61 | 72 74 20 6f 66 20 61 20 |nding pa|rt of a |
|00005a80| 6e 61 6d 65 20 69 73 6e | 27 74 20 70 72 65 73 65 |name isn|'t prese|
|00005a90| 6e 74 20 28 74 68 65 20 | 4a 72 20 70 61 72 74 20 |nt (the |Jr part |
|00005aa0| 66 6f 72 20 74 68 69 73 | 20 6e 61 6d 65 29 2c 0a |for this| name),.|
|00005ab0| 65 76 65 72 79 74 68 69 | 6e 67 20 69 6e 20 74 68 |everythi|ng in th|
|00005ac0| 61 74 20 70 69 65 63 65 | 20 69 73 20 69 67 6e 6f |at piece| is igno|
|00005ad0| 72 65 64 2e 0a 41 6e 79 | 74 68 69 6e 67 20 61 74 |red..Any|thing at|
|00005ae0| 20 62 72 61 63 65 2d 6c | 65 76 65 6c 7e 30 20 69 | brace-l|evel~0 i|
|00005af0| 73 20 6f 75 74 70 75 74 | 20 76 65 72 62 61 74 69 |s output| verbati|
|00005b00| 6d 0a 28 74 68 65 20 70 | 72 65 73 75 6d 65 64 20 |m.(the p|resumed |
|00005b10| 74 79 70 6f 20 60 7b 5c | 74 74 20 3f 7d 27 20 66 |typo `{\|tt ?}' f|
|00005b20| 6f 72 20 74 68 69 73 20 | 6e 61 6d 65 20 69 73 20 |or this |name is |
|00005b30| 61 74 20 62 72 61 63 65 | 2d 6c 65 76 65 6c 7e 30 |at brace|-level~0|
|00005b40| 29 2c 0a 62 75 74 20 79 | 6f 75 20 70 72 6f 62 61 |),.but y|ou proba|
|00005b50| 62 6c 79 20 77 6f 6e 27 | 74 20 75 73 65 20 74 68 |bly won'|t use th|
|00005b60| 69 73 20 66 65 61 74 75 | 72 65 20 6d 75 63 68 2e |is featu|re much.|
|00005b70| 0a 0a 57 69 74 68 69 6e | 20 65 61 63 68 20 70 69 |..Within| each pi|
|00005b80| 65 63 65 20 61 20 64 6f | 75 62 6c 65 20 6c 65 74 |ece a do|uble let|
|00005b90| 74 65 72 20 74 65 6c 6c | 73 20 5c 42 69 62 54 65 |ter tell|s \BibTe|
|00005ba0| 58 5c 20 74 6f 20 75 73 | 65 20 77 68 6f 6c 65 20 |X\ to us|e whole |
|00005bb0| 74 6f 6b 65 6e 73 2c 20 | 61 6e 64 0a 61 20 73 69 |tokens, |and.a si|
|00005bc0| 6e 67 6c 65 20 6c 65 74 | 74 65 72 2c 20 74 6f 20 |ngle let|ter, to |
|00005bd0| 61 62 62 72 65 76 69 61 | 74 65 20 74 68 65 6d 20 |abbrevia|te them |
|00005be0| 28 74 68 65 73 65 20 6c | 65 74 74 65 72 73 20 6d |(these l|etters m|
|00005bf0| 75 73 74 20 62 65 20 61 | 74 20 62 72 61 63 65 2d |ust be a|t brace-|
|00005c00| 6c 65 76 65 6c 7e 31 29 | 3b 0a 65 76 65 72 79 74 |level~1)|;.everyt|
|00005c10| 68 69 6e 67 20 65 6c 73 | 65 20 77 69 74 68 69 6e |hing els|e within|
|00005c20| 20 74 68 65 20 70 69 65 | 63 65 20 69 73 20 75 73 | the pie|ce is us|
|00005c30| 65 64 20 76 65 72 62 61 | 74 69 6d 0a 28 77 65 6c |ed verba|tim.(wel|
|00005c40| 6c 2c 20 61 6c 6d 6f 73 | 74 20 65 76 65 72 79 74 |l, almos|t everyt|
|00005c50| 68 69 6e 67 2d 2d 2d 72 | 65 61 64 20 6f 6e 29 2e |hing---r|ead on).|
|00005c60| 0a 54 68 65 20 74 69 65 | 20 61 74 20 74 68 65 20 |.The tie| at the |
|00005c70| 65 6e 64 20 6f 66 20 74 | 68 65 20 76 6f 6e 20 70 |end of t|he von p|
|00005c80| 61 72 74 20 28 69 6e 20 | 5c 68 62 6f 78 7b 5c 76 |art (in |\hbox{\v|
|00005c90| 65 72 62 7c 7b 76 76 7e | 7d 7c 7d 29 0a 69 73 20 |erb|{vv~|}|}).is |
|00005ca0| 61 20 64 69 73 63 72 65 | 74 69 6f 6e 61 72 79 20 |a discre|tionary |
|00005cb0| 74 69 65 2d 2d 2d 5c 42 | 69 62 54 65 58 5c 20 77 |tie---\B|ibTeX\ w|
|00005cc0| 69 6c 6c 20 6f 75 74 70 | 75 74 20 61 20 74 69 65 |ill outp|ut a tie|
|00005cd0| 20 61 74 20 74 68 61 74 | 20 70 6f 69 6e 74 0a 69 | at that| point.i|
|00005ce0| 66 20 69 74 20 74 68 69 | 6e 6b 73 20 74 68 65 72 |f it thi|nks ther|
|00005cf0| 65 27 73 20 61 20 6e 65 | 65 64 20 66 6f 72 20 6f |e's a ne|ed for o|
|00005d00| 6e 65 3b 0a 6f 74 68 65 | 72 77 69 73 65 20 69 74 |ne;.othe|rwise it|
|00005d10| 20 77 69 6c 6c 20 6f 75 | 74 70 75 74 20 61 20 73 | will ou|tput a s|
|00005d20| 70 61 63 65 2e 0a 49 66 | 20 79 6f 75 20 72 65 61 |pace..If| you rea|
|00005d30| 6c 6c 79 2c 20 72 65 61 | 6c 6c 79 2c 20 77 61 6e |lly, rea|lly, wan|
|00005d40| 74 20 61 20 74 69 65 20 | 74 68 65 72 65 2c 0a 72 |t a tie |there,.r|
|00005d50| 65 67 61 72 64 6c 65 73 | 73 20 6f 66 20 77 68 61 |egardles|s of wha|
|00005d60| 74 20 5c 42 69 62 54 65 | 58 5c 20 74 68 69 6e 6b |t \BibTe|X\ think|
|00005d70| 73 2c 20 75 73 65 20 74 | 77 6f 20 6f 66 20 74 68 |s, use t|wo of th|
|00005d80| 65 6d 0a 28 6f 6e 6c 79 | 20 6f 6e 65 20 77 69 6c |em.(only| one wil|
|00005d90| 6c 20 62 65 20 6f 75 74 | 70 75 74 29 3b 20 74 68 |l be out|put); th|
|00005da0| 61 74 20 69 73 2c 20 75 | 73 65 20 5c 68 62 6f 78 |at is, u|se \hbox|
|00005db0| 7b 5c 76 65 72 62 7c 7b | 76 76 7e 7e 7d 7c 7d 2e |{\verb|{|vv~~}|}.|
|00005dc0| 0a 41 20 74 69 65 20 69 | 73 20 64 69 73 63 72 65 |.A tie i|s discre|
|00005dd0| 74 69 6f 6e 61 72 79 20 | 6f 6e 6c 79 20 69 66 20 |tionary |only if |
|00005de0| 69 74 27 73 20 74 68 65 | 20 6c 61 73 74 20 63 68 |it's the| last ch|
|00005df0| 61 72 61 63 74 65 72 20 | 6f 66 20 74 68 65 20 70 |aracter |of the p|
|00005e00| 69 65 63 65 3b 0a 61 6e | 79 77 68 65 72 65 20 65 |iece;.an|ywhere e|
|00005e10| 6c 73 65 20 69 74 27 73 | 20 74 72 65 61 74 65 64 |lse it's| treated|
|00005e20| 20 61 73 20 61 6e 20 6f | 72 64 69 6e 61 72 79 20 | as an o|rdinary |
|00005e30| 63 68 61 72 61 63 74 65 | 72 2e 0a 0a 5c 42 69 62 |characte|r...\Bib|
|00005e40| 54 65 58 5c 20 70 75 74 | 73 20 64 65 66 61 75 6c |TeX\ put|s defaul|
|00005e50| 74 20 73 74 72 69 6e 67 | 73 20 7b 5c 65 6d 20 62 |t string|s {\em b|
|00005e60| 65 74 77 65 65 6e 5c 2f | 7d 20 74 6f 6b 65 6e 73 |etween\/|} tokens|
|00005e70| 20 6f 66 20 61 20 6e 61 | 6d 65 20 70 61 72 74 3a | of a na|me part:|
|00005e80| 0a 46 6f 72 20 77 68 6f | 6c 65 20 74 6f 6b 65 6e |.For who|le token|
|00005e90| 73 20 69 74 20 75 73 65 | 73 20 65 69 74 68 65 72 |s it use|s either|
|00005ea0| 20 61 20 73 70 61 63 65 | 20 6f 72 20 61 20 74 69 | a space| or a ti|
|00005eb0| 65 2c 0a 64 65 70 65 6e | 64 69 6e 67 20 6f 6e 20 |e,.depen|ding on |
|00005ec0| 77 68 69 63 68 20 6f 6e | 65 20 69 74 20 74 68 69 |which on|e it thi|
|00005ed0| 6e 6b 73 20 69 73 20 62 | 65 73 74 2c 0a 61 6e 64 |nks is b|est,.and|
|00005ee0| 20 66 6f 72 20 61 62 62 | 72 65 76 69 61 74 65 64 | for abb|reviated|
|00005ef0| 20 74 6f 6b 65 6e 73 20 | 69 74 20 75 73 65 73 20 | tokens |it uses |
|00005f00| 61 20 70 65 72 69 6f 64 | 20 66 6f 6c 6c 6f 77 65 |a period| followe|
|00005f10| 64 20 62 79 0a 65 69 74 | 68 65 72 20 61 20 73 70 |d by.eit|her a sp|
|00005f20| 61 63 65 20 6f 72 20 61 | 20 74 69 65 2e 0a 48 6f |ace or a| tie..Ho|
|00005f30| 77 65 76 65 72 20 69 74 | 20 64 6f 65 73 6e 27 74 |wever it| doesn't|
|00005f40| 20 75 73 65 20 74 68 69 | 73 20 64 65 66 61 75 6c | use thi|s defaul|
|00005f50| 74 20 73 74 72 69 6e 67 | 20 61 66 74 65 72 20 74 |t string| after t|
|00005f60| 68 65 20 6c 61 73 74 20 | 74 6f 6b 65 6e 20 69 6e |he last |token in|
|00005f70| 20 61 20 6c 69 73 74 3b | 0a 68 65 6e 63 65 20 74 | a list;|.hence t|
|00005f80| 68 65 72 65 27 73 20 6e | 6f 20 70 65 72 69 6f 64 |here's n|o period|
|00005f90| 20 66 6f 6c 6c 6f 77 69 | 6e 67 20 74 68 65 20 60 | followi|ng the `|
|00005fa0| 4a 27 20 66 6f 72 20 6f | 75 72 20 65 78 61 6d 70 |J' for o|ur examp|
|00005fb0| 6c 65 2e 0a 59 6f 75 20 | 73 68 6f 75 6c 64 20 68 |le..You |should h|
|00005fc0| 61 76 65 20 75 73 65 64 | 0a 5c 62 65 67 69 6e 7b |ave used|.\begin{|
|00005fd0| 76 65 72 62 61 74 69 6d | 7d 0a 20 20 20 20 22 7b |verbatim|}. "{|
|00005fe0| 76 76 7e 7d 7b 6c 6c 7d | 7b 2c 20 6a 6a 7d 7b 2c |vv~}{ll}|{, jj}{,|
|00005ff0| 20 66 2e 7d 22 0a 5c 65 | 6e 64 7b 76 65 72 62 61 | f.}".\e|nd{verba|
|00006000| 74 69 6d 7d 0a 74 6f 20 | 67 65 74 20 5c 42 69 62 |tim}.to |get \Bib|
|00006010| 54 65 58 5c 20 74 6f 20 | 70 72 6f 64 75 63 65 20 |TeX\ to |produce |
|00006020| 74 68 65 20 73 61 6d 65 | 20 66 6f 72 6d 61 74 74 |the same| formatt|
|00006030| 65 64 20 73 74 72 69 6e | 67 20 62 75 74 20 77 69 |ed strin|g but wi|
|00006040| 74 68 20 74 68 65 20 71 | 75 65 73 74 69 6f 6e 0a |th the q|uestion.|
|00006050| 6d 61 72 6b 20 72 65 70 | 6c 61 63 65 64 20 62 79 |mark rep|laced by|
|00006060| 20 61 20 70 65 72 69 6f | 64 2e 0a 4e 6f 74 65 20 | a perio|d..Note |
|00006070| 74 68 61 74 20 74 68 65 | 20 70 65 72 69 6f 64 20 |that the| period |
|00006080| 73 68 6f 75 6c 64 20 67 | 6f 20 69 6e 73 69 64 65 |should g|o inside|
|00006090| 20 74 68 65 20 46 69 72 | 73 74 2d 6e 61 6d 65 20 | the Fir|st-name |
|000060a0| 70 69 65 63 65 2c 0a 72 | 61 74 68 65 72 20 74 68 |piece,.r|ather th|
|000060b0| 61 6e 20 77 68 65 72 65 | 20 74 68 65 20 71 75 65 |an where| the que|
|000060c0| 73 74 69 6f 6e 20 6d 61 | 72 6b 20 77 61 73 2c 20 |stion ma|rk was, |
|000060d0| 69 6e 20 63 61 73 65 20 | 61 20 6e 61 6d 65 20 68 |in case |a name h|
|000060e0| 61 73 20 6e 6f 20 46 69 | 72 73 74 20 70 61 72 74 |as no Fi|rst part|
|000060f0| 2e 0a 0a 49 66 20 79 6f | 75 20 77 61 6e 74 20 74 |...If yo|u want t|
|00006100| 6f 20 6f 76 65 72 72 69 | 64 65 20 5c 42 69 62 54 |o overri|de \BibT|
|00006110| 65 58 27 73 20 64 65 66 | 61 75 6c 74 20 62 65 74 |eX's def|ault bet|
|00006120| 77 65 65 6e 2d 74 6f 6b | 65 6e 20 73 74 72 69 6e |ween-tok|en strin|
|00006130| 67 73 2c 20 79 6f 75 0a | 6d 75 73 74 20 65 78 70 |gs, you.|must exp|
|00006140| 6c 69 63 69 74 6c 79 20 | 73 70 65 63 69 66 79 20 |licitly |specify |
|00006150| 61 20 73 74 72 69 6e 67 | 2e 0a 46 6f 72 20 65 78 |a string|..For ex|
|00006160| 61 6d 70 6c 65 20 73 75 | 70 70 6f 73 65 20 79 6f |ample su|ppose yo|
|00006170| 75 20 77 61 6e 74 20 61 | 20 6c 61 62 65 6c 20 74 |u want a| label t|
|00006180| 6f 20 63 6f 6e 74 61 69 | 6e 20 74 68 65 20 66 69 |o contai|n the fi|
|00006190| 72 73 74 20 6c 65 74 74 | 65 72 20 66 72 6f 6d 20 |rst lett|er from |
|000061a0| 65 61 63 68 0a 74 6f 6b | 65 6e 20 69 6e 20 74 68 |each.tok|en in th|
|000061b0| 65 20 76 6f 6e 20 61 6e | 64 20 4c 61 73 74 20 70 |e von an|d Last p|
|000061c0| 61 72 74 73 2c 20 77 69 | 74 68 20 6e 6f 20 73 70 |arts, wi|th no sp|
|000061d0| 61 63 65 73 3b 0a 79 6f | 75 20 73 68 6f 75 6c 64 |aces;.yo|u should|
|000061e0| 20 75 73 65 20 74 68 65 | 20 66 6f 72 6d 61 74 20 | use the| format |
|000061f0| 73 74 72 69 6e 67 0a 5c | 62 65 67 69 6e 7b 76 65 |string.\|begin{ve|
|00006200| 72 62 61 74 69 6d 7d 0a | 20 20 20 20 22 7b 76 7b |rbatim}.| "{v{|
|00006210| 7d 7d 7b 6c 7b 7d 7d 22 | 0a 5c 65 6e 64 7b 76 65 |}}{l{}}"|.\end{ve|
|00006220| 72 62 61 74 69 6d 7d 0a | 73 6f 20 74 68 61 74 20 |rbatim}.|so that |
|00006230| 5c 42 69 62 54 65 58 5c | 20 77 69 6c 6c 20 70 72 |\BibTeX\| will pr|
|00006240| 6f 64 75 63 65 20 60 7b | 5c 74 74 20 64 6c 56 50 |oduce `{|\tt dlVP|
|00006250| 7d 27 20 61 73 20 74 68 | 65 20 66 6f 72 6d 61 74 |}' as th|e format|
|00006260| 74 65 64 20 73 74 72 69 | 6e 67 2e 0a 59 6f 75 20 |ted stri|ng..You |
|00006270| 6d 75 73 74 20 67 69 76 | 65 20 61 20 73 74 72 69 |must giv|e a stri|
|00006280| 6e 67 20 66 6f 72 20 65 | 61 63 68 20 70 69 65 63 |ng for e|ach piec|
|00006290| 65 20 77 68 6f 73 65 20 | 64 65 66 61 75 6c 74 20 |e whose |default |
|000062a0| 79 6f 75 20 77 61 6e 74 | 20 6f 76 65 72 72 69 64 |you want| overrid|
|000062b0| 64 65 6e 0a 28 74 68 65 | 20 65 78 61 6d 70 6c 65 |den.(the| example|
|000062c0| 20 68 65 72 65 20 75 73 | 65 73 20 74 68 65 20 6e | here us|es the n|
|000062d0| 75 6c 6c 20 73 74 72 69 | 6e 67 20 66 6f 72 20 62 |ull stri|ng for b|
|000062e0| 6f 74 68 20 70 69 65 63 | 65 73 29 2c 20 61 6e 64 |oth piec|es), and|
|000062f0| 20 74 68 69 73 20 73 74 | 72 69 6e 67 0a 6d 75 73 | this st|ring.mus|
|00006300| 74 20 69 6d 6d 65 64 69 | 61 74 65 6c 79 20 66 6f |t immedi|ately fo|
|00006310| 6c 6c 6f 77 20 65 69 74 | 68 65 72 20 74 68 65 20 |llow eit|her the |
|00006320| 73 69 6e 67 6c 65 20 6f | 72 20 64 6f 75 62 6c 65 |single o|r double|
|00006330| 20 6c 65 74 74 65 72 20 | 66 6f 72 20 74 68 65 20 | letter |for the |
|00006340| 70 69 65 63 65 2e 0a 59 | 6f 75 20 6d 61 79 20 6e |piece..Y|ou may n|
|00006350| 6f 74 20 68 61 76 65 20 | 61 6e 79 20 6f 74 68 65 |ot have |any othe|
|00006360| 72 20 6c 65 74 74 65 72 | 73 20 61 74 20 62 72 61 |r letter|s at bra|
|00006370| 63 65 2d 6c 65 76 65 6c | 7e 31 20 69 6e 20 74 68 |ce-level|~1 in th|
|00006380| 65 20 66 6f 72 6d 61 74 | 20 73 74 72 69 6e 67 2e |e format| string.|
|00006390| 0a 0a 5c 62 69 62 6c 69 | 6f 67 72 61 70 68 79 7b |..\bibli|ography{|
|000063a0| 62 74 78 64 6f 63 7d 0a | 5c 62 69 62 6c 69 6f 67 |btxdoc}.|\bibliog|
|000063b0| 72 61 70 68 79 73 74 79 | 6c 65 7b 70 6c 61 69 6e |raphysty|le{plain|
|000063c0| 7d 0a 5c 65 6e 64 7b 64 | 6f 63 75 6d 65 6e 74 7d |}.\end{d|ocument}|
|000063d0| 0a | |. | |
+--------+-------------------------+-------------------------+--------+--------+
