÷ƒ’À;è TeX output 1991.11.23:1331‹ÿÿÿÿ lÌÜ ýº3$ 'ÌÜ þ'Ž‘PÐ-óHý':G® cmti10ëHMakeIndex‘¯ó9DÓítG®G®cmr17ä:‘¬An–7tIndex“ProsŽcessor“F‘þ¥Vor“L‘úKGŸýıóIŒ-øG® cmcsc10ëIaŽ‘ƒÙäT‘ý[™Ÿ5 EŽ‘;gXŽŸ%N ’Ã!+ó+X«Q cmr12ÖLeslie‘ê¨LampSŽortŽŽŽŽŽŸŒÏ’½^*17–ê¨F‘ÿVebruary“1987ŽŸ.€A‘6ó7ò"Vff cmbx10â1Ž‘NÖÿHoŠ=w–…to“Use“óJý':ff cmti10ëJMakeIndexŽŸq‹‘6ó%ý': ó3 cmti10ÐMakeIndex‘hó"Kñ`y ó3 cmr10Íis–KÛa“program“for“making“an“index“in“a“doMÞcumen²!t“generated“withŽ¤ ™š‘6L‘üÙŸþ•ëóKŒ-ø ó3 cmcsc10ëKaŽ‘!­ÍT‘þ,³ŸLØEŽ‘B X.–zUThe“ rst“step“in“proMÞducing“the“index“is“to“put“the“necessary“ó(ßêand“regenerating“the“Óind“Í le.‘¸dIf“there“are“problems“that“cannotŽ¡‘6bMÞe–m corrected“in“this“w•²!a“y›ÿe,‘x‚y“ou–m can“alw•²!a“ys–m edit“the“Óind“Í le“directly˜.‘ʾHo•²!w“ev“er,Ž¡‘6sucš²!h–uhediting“is“to“bMÞe“a˜v˜oided“bMÞecause“it“m˜ust“bšMÞe“rep˜eated“evš²!ery“time“y˜ouŽ¡‘6generate–¦fa“new“v²!ersion“of“the“index.ŽŸ"€A‘6â2Ž‘NÖÿHošŠ=w–…to“Generate“Index“En˜triesŽŸ×ñ‘6ó0ÂÖN  cmbx12Û2.1Ž‘TÀWhen,–€Whš y‘þà,“What,“and“Ho˜w“to“IndexŽŸ«ÿ‘6ÍIt's–ÿºtempting“to“generate“the“index“as“yš²!ou“write“the“doMÞcumen˜t.‘éØResist“theŽ¡‘6temptation.‘ÔùIt–‹¹is“virtually“impMÞossible“to“obtain“an²!y“consistency“in“an“indexŽ¡‘6that–¦fis“generated“in“this“w•²!a“y‘ÿe.Ž¡‘GAn–p-index“is“there“to“help“the“reader“ nd“what“he's“loMÞoking“for.‘;3WithŽ¡‘6this–ÅTin“mind,‘Ícommon“sense“can“help“in“ guring“out“what“should“bMÞe“in“theŽ¡‘6index–#áand“ho²!w“it“should“bMÞe“organized.‘VMSince“it's“often“hard“to“distinguishŽ¡‘6common–KËsense“from“equally“common“nonsense,‘]êprofessional“advice“is“useful.Ž¡‘6Man•²!y›W»st“yle˜guides˜discuss˜indexing;‘°ethe˜pamphlet˜ÐIndexing–ŽY‘ÿ)our“Bo‘ÿp¹ok‘…vÍb²!yŽ¡‘6Sina–X6Spikš²!er“(The“Univ˜ersit˜y“of“Wisconsin“Press,›„©1954)“is,˜according“to“itsŽ¡‘6subtitle,–¦f\A“Practical“Guide“for“Authors".Ž¡‘GUnfortunately‘ÿe,‘YKthese–Fguides“to“indexing“seem“to“ha•²!v“e–FbMÞeen“written“whenŽ¡‘6high–®tecš²!h“mean˜t“using“a“ball-pMÞoin˜t“pMÞen“instead“of“a“quill,‘ïñso“their“adviceŽ¡‘6on–âÍthe“mecš²!hanics“of“creating“an“index“rev˜olv˜e“around“ho˜w“to“stac˜k“y˜ourŽ¡‘63–§°Ï“Í5–ûŒindex“cards.‘ÝPY‘ÿeou'll“ha•²!v“e–ûŒto“ gure“out“yš²!our“o˜wn“methoMÞd“of“using“theŽ¡‘6computer–L{to“lighš²!ten“the“c˜hore.‘ÐAn“alphabMÞetical“list“of“ev˜ery“w˜ord“in“y˜ourŽ¡‘6doMÞcumenš²!t,‘6áwith–æÈduplicates“remo˜v˜ed,‘6áis“not“a“bad“place“to“start.‘ŸIf“y˜ourŽ¡‘6system–!¼has“Ho•²!w“ard›!¼T‘ÿeric“k“ey's˜Ódelatex˜Íprogram,‘€‘then˜the˜follo“wing˜UnixŽ¡‘6command–—Ígenerates“suc²!h“a“list“from“the“ le“Ómyfile.tex“Íand“puts“it“on“theŽ¡‘6 le‘¦fÓfooÍ:Ž¤™š‘Q`Ódelatex–¿ªmyfile.tex“|“sort“-uf“>“fooŽ¡‘GÍThe–€Icomputer“is“only“a“toMÞol;‘í:it“can't“write“the“index“for“yš²!ou.‘k…It“ma˜yŽ¤ ™š‘6bšMÞe–åeasy“to“c²!ho˜ose“whicš²!h“w˜ords“are“impMÞortan˜t“and“mec˜hanically“generate“anŽ¡‘6index–”êciting“evš²!ery“oMÞccurrence“of“those“w˜ords,‘Ћbut“the“resulting“index“willŽ¡‘6not–¦fbMÞe“as“useful“to“the“reader“as“one“prepared“with“more“care.ŽŽŸ’çC32ŽŽŒ‹ ‰ lÌÜ ýº3$ 'ÌÜ ýû3$‘6Û2.2Ž‘TÀThe‘€BasicsŽŸ«ÿ‘6ÍEacš²!h–zˆÓ\index“Ícommand“causes“L‘üÙŸþ•ëëKaŽ‘!­ÍT‘þ,³ŸLØEŽ‘B X“to“write“an“en˜try“on“the“Óidx“Í le.Ž¤ ™š‘6The–YËfolloš²!wing“example“sho˜ws“some“simple“Ó\index“Ícommands“and“the“indexŽ¡‘6enš²!tries–,that“they“proMÞduce.‘-.The“page“n˜um˜bMÞer“refers“to“the“page“con˜tainingŽ¡‘6the–¦ftext“where“the“Ó\index“Ícommand“appMÞears.Ÿü¾ó |{Ycmr8¸1ŽŽŽ©™š‘Q`ÍP²!age‘¦fiiŽ’‰ï~Ó\index{Alpha}‘ËuŸ}„ ™™ff‘™š„ ™™ffŽŽ¤ ™™‘Q`ÍP²!age‘¦fviii:Ž’‰ï~Ó\index{alpha}‘ËuŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`ÍP²!age‘¦fix:Ž’‰ï~Ó\index{alpha}‘ËuŸ}„ ™™ff‘™š„ ™™ffŽŽ¡’‰ï~\index{Alphabet}‘ ŒwŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`ÍP²!age‘¦f22:Ž’‰ï~Ó\index{alpha}‘ËuŸ}„ ™™ff‘™š„ ™™ffŽŽ¡’‰ï~\index{alphas}‘ ËŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`ÍP²!age‘¦f23:Ž’‰ï~Ó\index{alphabet}‘ ŒwŸ}„ ™™ff‘™š„ ™™ffŽŽ¡’‰ï~\index{alphabet}‘ ŒwŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`ÍP²!age‘¦f24:Ž’‰ï~Ó\index{alpha‘¿ªbet}‘ÌÍŸ}„ ™™ff‘™š„ ™™ffŽŽŽŽ’ ÃeÍAlpha,‘¦fiiŽŽ¡’ Ãealpha,–¦fviii,“ix,“22ŽŽ¡’ Ãealpha–¦fbMÞet,“24ŽŽ¡’ ÃeAlphabMÞet,‘¦fixŽŽ¡’ ÃealphabMÞet,‘¦f23ŽŽ¡’ Ãealphas,‘¦f22ŽŽŽŽ ‚{ï‘6Note–­àthat“the“duplicate“Ó\index{alphabet}“Ícommands“on“page“23“proMÞduceŽ¡‘6only–¦fone“\23"“in“the“index.Ž¡‘GT‘ÿeo–¥oprošMÞduce“a“sub˜enš²!try‘ÿe,‘å1the“argumen˜t“of“the“Ó\index“Ícommand“shouldŽ¡‘6conš²!tain–¦fbMÞoth“the“main“en˜try“and“the“subMÞen˜try‘ÿe,“separated“b˜y“a“Ó!“Íc˜haracter.Ž¦‘Q`P²!age‘¦f7:Ž’…û8Ó\index{gnat!size‘¿ªof}‘ÌÍŸ}„ ™™ff‘™š„ ™™ffŽŽ¤ ™™‘Q`ÍP²!age‘¦f32:Ž’…û8Ó\index{gnat}‘3ÊŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`ÍP²!age‘¦f35:Ž’…û8Ó\index{gnat!anatomy}‘ÌÍŸ}„ ™™ff‘™š„ ™™ffŽŽ¡’…û8\index{gnus!good}‘ ËŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`ÍP²!age‘¦f38:Ž’…û8Ó\index{gnus!bad}‘ËuŸ}„ ™™ff‘™š„ ™™ffŽŽ¡’þÁMŸ}„ ™™ff‘™š„ ™™ffŽŽŽŽ’Ígnat,‘¦f32ŽŽ¡’+anatom²!y‘ÿe,‘¦f35ŽŽ¡’+size–¦fof,“7ŽŽ¡’gn²!usŽŽ¡’+bad,‘¦f38ŽŽ¡’+go•MÞo“d,‘¦f35ŽŽŽŽŸY¯)‘6Y‘ÿeou–¦fcan“also“ha•²!v“e‘¦fsubsubMÞen“tries.Ž¦‘Q`P²!age‘¦f8:Ž’‰¡žÓ\index{bites!animal!gnats}‘ÌÍŸ}„ ™™ff‘™š„ ™™ffŽŽ¤ ™™‘Q`ÍP²!age‘¦f10:Ž’‰¡žÓ\index{bites!animal!gnus}‘ ŒwŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`ÍP²!age–¦f12“:Ž’‰¡žÓ\index{bites!vegetable}‘ ËŸ}„ ™™ff‘™š„ ™™ffŽŽ¡’$察}„ ™™ff‘™š„ ™™ffŽŽ¡’$察}„ ™™ff‘™š„ ™™ffŽŽŽŽ’=2ÍbitesŽŽ¡’Q2animalŽŽ¡’[2gnats,‘¦f8ŽŽ¡’[2gn²!us,‘¦f10ŽŽ¡’Q2v²!egetable,‘¦f12ŽŽŽŽŸL‘6L‘üÙŸþ•ëëKaŽ‘!­ÍT‘þ,³ŸLØEŽ‘B X–>and“ÐMakeIndex‘àËÍsuppMÞort“only“three“levš²!els“of“indexing;‘–öy˜ou“can't“ha˜v˜eŽ¡‘6subsubsubMÞen²!tries.Ž‘6Ÿff‰ffÿpŸ LÍ‘ {ºŸü-=ó¹Aa¨cmr6¯1ŽŽ‘¦aóo´‹Ç cmr9½T‘ÿ:«o›ºwa•¾9v“oid˜an“y˜am“biguit“y˜if˜a˜page˜break˜oAÇccurs˜righ“t˜at˜an˜óߤN cmtt9Â\index˜½command,‘ã¿it's˜aŽŸ go•AÇo“d–Tidea“to“attacš¾9h“the“command“to“a“w˜ord“instead“of“putting“it“bAÇet˜w˜een“w˜ords.ŽŽŸ’çC3Í3ŽŽŒ‹„ lÌÜ ýº3$ 'ÌÜ ýû3$‘GÍT‘ÿeo–¿ëspšMÞecify“a“page“range,‘Lput“an“Ó\index{...|(}“Ícommand“at“the“b˜e-Ž¤ ™š‘6ginning–ÜUof“the“range“and“an“Ó\index{...|)}“Ícommand“at“the“end“of“theŽ¡‘6range.Ž©Š¤‘Q`P²!age‘¦fvi:Ž’…û8Ó\index{gnat|(}‘"‹Ÿ}„ ™™ff‘™š„ ™™ffŽŽ¤ ™™‘Q`ÍP²!age‘¦fx:Ž’…û8Ó\index{gnat|)}‘"‹Ÿ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`ÍP²!age‘¦f22:Ž’…û8Ó\index{gnat}‘. sŸ}„ ™™ff‘™š„ ™™ffŽŽ¡’…û8\index{gnus!bad|(}‘ ŒwŸ}„ ™™ff‘™š„ ™™ffŽŽ¡’…û8\index{gnus!bad|)}‘ ŒwŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`ÍP²!age‘¦f28:Ž’…û8Ó\index{gnus!good|(}‘ÌÍŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`ÍP²!age‘¦f30:Ž’…û8Ó\index{gnus!good}‘L!Ÿ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`ÍP²!age‘¦f32:Ž’…û8Ó\index{gnus!good|)}‘ÌÍŸ}„ ™™ff‘™š„ ™™ffŽŽŽŽ’NsÍgnat,–¦fvi{x,“22ŽŽ¡’Nsgn²!usŽŽ¡’%Nsbad,‘¦f22ŽŽ¡’%Nsgo•MÞo“d,‘¦f28{32ŽŽŽŽŸtÓ`‘6Note–”¶that“ÐMakeIndex‘æCÍdošMÞes“the“righ²!t“thing“when“b˜oth“ends“of“the“range“fallŽ¡‘6on–¦fthe“same“page.Ÿü¾¸2ŽŽŽ¡‘GÍSometimes,‘ØHy•²!ou›¤Àw“an“t˜to˜add˜a˜cross-reference˜with˜no˜page˜n“um“bMÞer.‘‡ûThisŽ¡‘6is–¦fdone“as“follo²!ws;Ž¦‘Q`P²!age‘¦f2:Ž’€žÓ\index{at}‘g‡Ÿ}„ ™™ff‘™š„ ™™ffŽŽŸ ™™‘Q`ÍP²!age‘¦f2:Ž’€žÓ\index{at!bat|see{bat,‘¿ªat}}‘ÌÍŸ}„ ™™ff‘™š„ ™™ffŽŽŽŽ’9Ò)Íat,‘¦f2ŽŽ¡’MÒ)bat,–¦fÐse‘ÿp¹e‘yÍbat,“atŽŽŽŽŸ#9Ë‘6Since–±the“\see"“enš²!try“doMÞes“not“prin˜t“an˜y“page“n˜um˜bšMÞer,‘‚it“do˜esn't“mat-Ž¡‘6ter–ïwhere“the“Ó\index{...|see{...}}“Ícommand“goMÞes,‘:so“long“as“it“follo²!wsŽ¡‘6the–† Ó\begin{document}“Ícommand.‘|ÅY‘ÿeou“mighš²!t“w˜an˜t“to“put“all“suc˜h“cross-Ž¡‘6referencing–¦fcommands“in“one“place.Ž¡‘GIf–yš²!ou“spMÞecify“an“en˜try“of“the“form“ó#  b> ó3 cmmi10Îd“Ó@Α=OÍ,‘Y„the“string“ΑgÍdetermines“theŽ¡‘6alphab•MÞetical›p×p“osition˜of˜the˜en²!try‘ÿe,‘£rwhile˜the˜string˜Î‘®&Ípro“duces˜the˜text˜ofŽ¡‘6the‘¦fen²!try‘ÿe.Ž¦‘Q`P²!age‘¦f44:Ž’…û8Ó\index{twenty}‘ËuŸ}„ ™™ff‘™š„ ™™ffŽŽ¤ ™™‘Q`ÍP²!age‘¦f46:Ž’…û8Ó\index{twenty-one}‘ÌÍŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`ÍP²!age‘¦f55:Ž’…û8Ó\index{twenty@xx}‘ ŒwŸ}„ ™™ff‘™š„ ™™ffŽŽŽŽ’ ŽÉÍt•²!w“en“t“y‘ÿe,‘¦f44ŽŽ¡’ ŽÉxx,‘¦f55ŽŽ¡’ ŽÉt•²!w“en“t“y-one,‘¦f46ŽŽŽŽŸ0Óe‘6This–˜mfeature“is“useful“bMÞecause“the“argumenš²!t“of“the“Ó\index“Ícommand“pro˜videsŽ¡‘6the–Ò8actual“input“string“that“L‘üÙŸþ•ëëKaŽ‘!­ÍT‘þ,³ŸLØEŽ‘B X“uses“to“generate“the“index“en²!try‘ÿe.‘aTIn“theŽ¡‘6folloš²!wing–¦fexample,“the“input“Ó$\alpha$“ÍproMÞduces“the“sym˜bMÞol“Î `Í,Ž¦‘Q`P²!age‘¦f12:Ž’…û8Ó\index{alphas}‘3ÊŸ}„ ™™ff‘™š„ ™™ffŽŽ¤ ™™‘Q`ÍP²!age‘¦f13:Ž’…û8Ó\index{alpha}‘9‰ÇŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`ÍP²!age‘¦f14:Ž’…û8Ó\index{alpha@$\alpha$}‘ÌÍŸ}„ ™™ff‘™š„ ™™ffŽŽŽŽ’"qÍalpha,‘¦f13ŽŽ¡’"qÎ `Í,‘¦f14ŽŽ¡’"qalphas,‘¦f12ŽŽŽŽ‘6Ÿ&¨‰ffÿpŸ LÍ‘ {ºŸü-=¯2ŽŽ‘¦a½The–Tuse“of“\28 ."‘prather“than“\28{32"“is“froš¾9wned“upAÇon“b˜y“the“expAÇerts.ŽŽŸ’çC3Í4ŽŽŒ‹ ß lÌÜ ýº3$ 'ÌÜ ýû3$‘6ÍSimilarly‘ÿe,‘£Ëthe–£$command“Ó\index{gnu@{\bf‘¿ªgnu}}“ÍprošMÞduces“a“b˜oldface“ó'ò"V ó3 cmbx10Ògn¦tuŽ¤ ™š‘6Íindex‘¦fen²!try‘ÿe.Ž¡‘GIn–Üsome“indexes,‘émcertain“page“n•²!um“bšMÞers–Üare“sp˜ecially“formatted|for“ex-Ž¡‘6ample,‘¤Óan–qðitalic“page“n•²!um“bMÞer›qðma“y˜indicate˜the˜primary˜reference,‘¤Óand˜anŽ¡‘6Ðn‘ÜRÍafter–Ga“page“n•²!um“bMÞer›Gma“y˜denote˜that˜the˜item˜app•MÞears˜in˜a˜fo“otnote˜onŽ¡‘6that–ä¼page.‘˜ßÐMakeIndex‘6IÍmakš²!es“it“easy“to“format“an“individual“page“n˜um-Ž¡‘6bMÞer–àRanš²!y“w˜a˜y“y˜ou“w˜an˜t.‘ ‹ F‘ÿeor“an˜y“string“of“c˜haracters“Îd“Í,‘nÌthe“commandŽ¡‘6Ó\index{...|Îd“Ó}–l^ÍprošMÞduces“a“page“n•²!um“b˜er–l^of“the“form“Ó\Îd“Ó{ÎnÓ}Í.‘ /ÄSimilarly‘ÿe,Ž¡‘6the–ëcommand“Ó\index{...|(Îd“Ó}“Ímaš²!y“proMÞduce“a“page“n˜um˜bMÞer“of“the“formŽ¡‘6Ó\Îd“Ó{ÎnÍ{ÎmÓ}Í.‘çTh²!us,‘üsuppšMÞose–·¿the“do˜cumenš²!t“con˜tains“the“follo˜wing“commandŽ¡‘6de nitions:Ž©™š‘Q`Ó\newcommand{\ii}[1]{{\it‘¿ª#1}}Ž¡‘Q`\newcommand{\nn}[1]{#1n}Ž¦‘6ÍW‘ÿee–¦fcould“then“ha•²!v“e:Ž¦‘Q`P²!age‘¦f3:Ž’…û8Ó\index{gnat|ii}‘ÌÍŸ}„ ™™ff‘™š„ ™™ffŽŽ¤ ™™‘Q`ÍP²!age‘¦f4:Ž’…û8Ó\index{gnat|nn}‘ÌÍŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`ÍP²!age‘¦f5:Ž’…û8Ó\index{gnu}‘ËuŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`ÍP²!age‘¦f44:Ž’…û8Ó\index{gnu|(ii}‘ÌÍŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`ÍP²!age‘¦f46:Ž’…û8Ó\index{gnu|)}‘L!Ÿ}„ ™™ff‘™š„ ™™ffŽŽŽŽ’úOËÍgnat,–¦fÐ3Í,“4nŽŽ¡’úOËgn²!u,–¦f5,“Ð44{46ŽŽŽŽŸL‹‘6ÍThe–«v\see"“option“is“a“spMÞecial“case“of“this“facilit²!y‘ÿe,‘¬ºwhere“the“Ó\see“ÍcommandŽ¡‘6is–¦fprede ned“bš²!y“the“Ómakeidx“ÍdoMÞcumen˜t-st˜yle“option.ŽŸR…‘6Û2.3Ž‘TÀThe–€Fine“Prin tŽŸ«ÿ‘6ÍCommands–9in“an“index“enš²!try“are“expanded“when“the“index“is“t˜ypMÞeset,‘­notŽ¡‘6when–¼kthe“Óidx“Í le“is“written.‘ëHence,‘Áìthe“command“Ó\index{\gnu}“ÍproMÞducesŽ¡‘6an–2«enš²!try“that“is“alphabMÞetized“b˜y“Ó\gnuÍ,‘IÑregardless“of“ho˜w“the“Ó\gnu“ÍcommandŽ¡‘6is‘¦fde ned.Ž¡‘GRecall–nÆthat“spMÞecial“cš²!haracters“lik˜e“Ó\“Íma˜y“appMÞear“in“the“argumen˜t“ofŽ¡‘6an–ÜRÓ\index“Ícommand“only“if“that“command“is“not“itself“con²!tained“in“theŽ¡‘6argumenš²!t–/of“another“command.‘yWThis“is“most“lik˜ely“to“bMÞe“a“problem“whenŽ¡‘6indexing–U items“in“a“fošMÞotnote.‘éËEv²!en“in“this“case,‘€³robust“commands“can“b˜eŽ¡‘6placed–Ž@in“the“\Ó@Í"“part“of“an“en²!try‘ÿe,›ÆHas“in“Ó\index{gnu@{\it‘¿ªgnu}}Í,˜and“fragileŽ¡‘6commands–¦fcan“bMÞe“used“if“protected“with“the“Ó\protect“Ícommand.Ÿü¾¸3ŽŽŽ‘6Ÿ ÕU‰ffÿpŸ LÍ‘ {ºŸü-=¯3ŽŽ‘¦a½In–“Dvš¾9ersions“of“L‘ü«‡ŸþÖfóLŒ-ø cmcsc10ëLaŽ‘Ív½T‘þuAŸ¶dEŽ‘˜ŸX“released“bAÇefore“3“F‘ÿ:«ebruary“1987,‘òÀy˜ou“m˜ust“use“the“Â\stringŽŸ ½command–Tinstead“of“Â\protect½.ŽŽŸ’çC3Í5ŽŽŒ‹- lÌÜ ýº3$ 'ÌÜ ýû3$‘GÍRememš²!bMÞer–YÞthat“the“argumen˜t“of“an“Ó\index“Ícommand“m˜ust“alw˜a˜ys“ha˜v˜eŽ¤ ™š‘6matcš²!hing–¦fbraces,“where“the“brace“in“a“Ó\{“Íor“Ó\}“Ícommand“coun˜ts.Ž¡‘GÐMakeIndex‘ÖÍassumes–ÉIthat“all“page“n•²!um“bMÞers–ÉIare“either“arabic“or“lo•²!w“er-Ž¡‘6case–úroman“nš²!umerals;‘3Îit“assumes“that“pages“n˜um˜bMÞered“with“roman“n˜umeralsŽ¡‘6precede–¦fthose“n•²!um“bMÞered–¦fwith“arabic“n²!umerals.Ž¡‘GT‘ÿeo–< put“a“Ó!Í,–QRÓ@Í,“or–< Ó|“Ícš²!haracter“in“an“index“en˜try‘ÿe,‘QRÐquote‘­Íit“b˜y“preceding“theŽ¡‘6cš²!haracter–aQwith“a“Ó"Í.‘ÆÖMore“precisely‘ÿe,‘o"an˜y“a“c˜haracter“is“said“to“bMÞe“quoted“if“itŽ¡‘6follo²!ws–žaan“unquoted“Ó"“Íthat“is“not“part“of“a“Ó\"“Ícommand.‘Û1A‘ž_quoted“Ó!Í,–ŸüÓ@Í,“orŽ¡‘6Ó|– µÍcš²!haracter“is“treated“lik˜e“an“ordinary“c˜haracter“rather“than“ha˜ving“its“usualŽ¡‘6meaning.‘.üThe–ÆÓ"“Ípreceding“a“quoted“cš²!haracter“is“deleted“bMÞefore“the“en˜triesŽ¡‘6are‘¦falphabMÞetized.ŽŸ™š‘Q`P²!age‘¦f2:Ž’€žÓ\index{exclaim‘¿ª("!)}‘. sŸ}„ ™™ff‘™š„ ™™ffŽŽ¤ ™™‘Q`ÍP²!age‘¦f3:Ž’€žÓ\index{exclaim‘¿ª("!)!loudly}‘ÌÍŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`ÍP²!age‘¦f4:Ž’€žÓ\index{fur@f\"{u}r}‘3ÊŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`ÍP²!age‘¦f5:Ž’€žÓ\index{quote‘¿ª(\verb+""+)}‘L!Ÿ}„ ™™ff‘™š„ ™™ffŽŽŽŽ’9Ò)Íexclaim–¦f(!),“2ŽŽ¡’MÒ)loudly‘ÿe,‘¦f3ŽŽ¡’9Ò)fMÞ‘ú8ˆur,‘¦f4ŽŽ¡’9Ò)quote–¦f(Ó""Í),“5ŽŽŽŽŸ>{õ‘GÐMakeIndex‘«…Íregards–Yøspaces“as“ordinary“c²!haracters“when“alphabMÞetizingŽ¡‘6the–¥8enš²!tries“and“deciding“whether“t˜w˜o“en˜tries“are“the“same.‘ÚSTh˜us,‘äìlettingŽ¡‘6\Ó Í"–©Àdenote“a“space“c²!haracter,›ª—the“commands“Ó\index{gnu}Í,˜Ó\index{ gnu}Í,Ž¡‘6and–ÜÎÓ\index{gnu }“ÍprošMÞduce“three“separate“en²!tries,‘êhthe“ rst“app˜earing“nearŽ¡‘6the–ßEbšMÞeginning“of“the“index,‘í}since“Ó “Ícomes“b˜efore“an²!y“letter“in“ÐMakeIndex‘QÍ'sŽ¡‘6\alphabšMÞetical"–rorder.‘oAll“three“en²!tries“lo˜ok“the“same“when“prin²!ted,‘¸5sinceŽ¡‘6L‘üÙŸþ•ëëKaŽ‘!­ÍT‘þ,³ŸLØEŽ‘B X–Signores“extra“spaces“in“the“input.‘ãÕSimilarly‘ÿe,‘~8Ó\index{a space}“ÍandŽ¡‘6Ó\index{a space}–4ØÍproMÞduce“t•²!w“o›4Ødi eren“t˜en“tries˜that˜loMÞok˜the˜same˜whenŽ¡‘6prinš²!ted.‘4ôDo–Ãnot“split“the“argumen˜t“of“an“Ó\index“Ícommand“across“lines“inŽ¡‘6the–¦finput“ le.ŽŸ"€A‘6â3Ž‘NÖÿError‘…MessagesŽŸq‹‘6ÐMakeIndex‘ïÍtš²!ypMÞes–²bout“on“the“terminal“the“n˜um˜bMÞer“of“lines“read“and“writtenŽ¡‘6and–Ÿòhoš²!w“man˜y“errors“w˜ere“found.‘Û¶Message“to“iden˜tify“the“error“are“writtenŽ¡‘6on–öÌa“ le“with“extension“ÓilgÍ.‘ÏThere“are“t•²!w“o–öÌphases“in“whic²!h“ÐMakeIndexŽ¡‘6Ícan–™åproMÞduce“error“messages:‘ÄÜwhen“it“is“reading“the“Óidx“Í le,‘ÖÅand“when“itŽ¡‘6is–“owriting“the“Óind“Í le.‘¤÷Eacš²!h“error“message“prin˜ts“the“nature“of“the“errorŽ¡‘6follo•²!w“ed›éb“y˜a˜line˜n“um“bMÞer,‘9¸iden“tifying˜where˜in˜the˜ le˜the˜error˜oMÞccurs.Ž¡‘6In–the“reading“phase,‘0¸the“line“n•²!um“bMÞer–refers“to“the“Óidx“Í le;‘Lbin“the“writingŽ¡‘6phase,–¦fit“refers“to“the“Óind“Í le.ŽŽŸ’çC36ŽŽŒ‹8S lÌÜ ýº3$ 'ÌÜ ýû3$‘6Û3.1Ž‘TÀErrors–€in“Reading“PhaseŽ¤«ÿ‘6ÓExtra–¿ª`!'‘ Tat“position“...Ž¡‘6ÍThe–·Ó\index“Ícommand's“argumenš²!t“has“more“than“t˜w˜o“unquoted“Ó!“Íc˜haracters.Ž© ™š‘6P²!erhaps–¦fsome“of“them“should“bMÞe“quoted.ŽŸì‘6ÓExtra–¿ª`@'“at“position“...Ž¡‘6ÍThe–ø Ó\index“Ícommand“argumenš²!t“has“t˜w˜o“or“more“unquoted“Ó@“Íc˜haractersŽ¦‘6with–¦fno“in•²!terv“ening›¦fÓ!Í.‘ÝÝP“erhaps˜one˜of˜the˜Ó@˜Íc“haracters˜should˜bMÞe˜quoted.ŽŸì‘6ÓExtra–¿ª`|'“at“position“...Ž¡‘6ÍThe–Æ Ó\index“Ícommand's“argumenš²!t“has“more“than“one“unquoted“Ó!“Íc˜haracters.Ž¦‘6P²!erhaps–¦fthe“extras“should“bMÞe“quoted.ŽŸì‘6ÓIllegal–¿ªnull“fieldŽ¡‘6ÍThe–“jÓ\index“Ícommand“argumenš²!t“doMÞesn't“mak˜e“sense“bMÞecause“some“string“isŽ¦‘6n²!ull–Õ…that“shouldn't“bšMÞe.‘˜=The“command“Ó\index{!big}“Íwill“pro˜duce“this“error,Ž¦‘6since–k it“spšMÞeci es“a“sub˜enš²!try“\big"“with“no“en˜try–ÿe.‘+ÇSimilarly“,‘œ2the‘k commandŽ¦‘6Ó\index{@big}–¿ Íis“incorrect“bšMÞecause“it“sp˜eci es“a“n²!ull“string“for“alphab˜etizing.ŽŸì‘6ÓArgument–¿ª...‘ Ttoo“long“(max“1024).Ž¡‘6ÍY‘ÿeour–‰doMÞcumenš²!t“con˜tained“an“Ó\index“Ícommand“with“a“v˜ery“long“argumen˜t.Ž¦‘6Y‘ÿeou–ˆñprobably“forgot“the“righš²!t“brace“that“w˜as“suppMÞosed“to“delimit“the“argu-Ž¦‘6men²!t.ŽŸì‘6ÒOther‘2errorsŽ¡‘6ÐMakeIndex‘ öÍcan–ºiproMÞduce“a“v‘ÿdDariet²!y“of“other“error“messages“indicating“thatŽ¦‘6something– Mis“seriously“wrong“with“the“Óidx“Í le.‘ ‘If“y²!ou“get“one,‘$†it“probablyŽ¦‘6means–¯that“the“Óidx“Í le“wš²!as“corrupted“in“some“w˜a˜y‘ÿe.‘‹šIf“L‘üÙŸþ•ëëKaŽ‘!­ÍT‘þ,³ŸLØEŽ‘B X“did“not“generateŽ¦‘6anš²!y–œ¡errors“when“it“created“the“Óidx“Í le,‘Ú/then“it“is“highly“unlik˜ely“to“ha˜v˜eŽ¦‘6proMÞduced–žóa“bad“Óidx“Í le.‘Ç„If“it“did,‘Ýyš²!ou'll“ha˜v˜e“to“examine“the“Óidx“Í le“toŽ¦‘6 gure–¦fout“what“w•²!en“t‘¦fwrong.ŽŽŸ’çC37ŽŽŒ‹DÁ lÌÜ ýº3$ 'ÌÜ ýû3$‘6Û3.2Ž‘TÀErrors–€in“W‘þàriting“PhaseŽ¤«ÿ‘6ÓUnmatched–¿ªrange“opening“operatorŽ¡‘6ÍAn– x1Ó\index{...|(}“Ícommand“wš²!as“not“follo˜w˜ed“b˜y“a“matc˜hingŽ¤ ™š‘6Ó\index{...|)}–ÅPÍcommand.‘:œThe“\Ó...Í"“in“the“t•²!w“o–ÅPcommands“m²!ust“bMÞe“com-Ž¡‘6pletely‘¦fiden²!tical.Ž©ì‘6ÓUnmatched–¿ªrange“closing“operatorŽŸ«ÿ‘6ÍAn– 'Ó\index{...|(}“Ícommand“wš²!as“not“preceded“b˜y“a“matc˜hingŽ¡‘6Ó\index{...|)}‘¦fÍcommand.Ž¦‘6ÓExtra–¿ªrange“opening“operatorŽŸ«ÿ‘6ÍTw²!o–¦ÚÓ\index{...|(}“Ícommands“appšMÞear“in“the“do˜cumenš²!t“with“no“in˜terv˜eningŽ¡‘6Ó\index{...|)}‘¦fÍcommand.Ž¦‘6ÓInconsistent–¿ªpage“encapsulator“...‘ Twithin“rangeŽŸ«ÿ‘6ÐMakeIndex‘Íhas–¯sbMÞeen“instructed“to“include“a“page“range“for“an“en²!try“andŽ¡‘6a–•$single“page“n•²!um“bMÞer–•$within“that“range“that“is“formatted“di eren²!tly|forŽ¡‘6example,‘Êb•²!y›ëbha“ving˜a˜Ó\index{gnu|ii}˜Ícommand˜bMÞet“w“een˜a˜Ó\index{gnu|(}Ž¡‘6Íand–¦fa“Ó\index{gnu|)}“Ícommand.Ž¦‘6ÓConflicting‘¿ªentriesŽŸ«ÿ‘6ÐMakeIndex‘3JÍthinks–á½it“has“bMÞeen“instructed“to“prinš²!t“the“same“page“n˜um˜bMÞerŽ¡‘6tš²!wice–h‹in“t˜w˜o“di eren˜t“w˜a˜ys|for“example,‘™b˜y“the“commands“Ó\index{gnu}Ž¡‘6Íand–¦fÓ\index{gnu|(see{...}}“ÍappMÞearing“on“the“same“page.ŽŸ"€A‘6âAc•Š=kno“wledgemen“tsŽŸq‹‘6ÐMakeIndex‘ÅÍis–Â8a“C‘Áïprogram“written“bš²!y“P˜ehong“Chen,‘ ,with“a“little“adviceŽ¡‘6from–àhme.‘‹ãIt“wš²!as“inspired“b˜y“a“program“written“b˜y“Mik˜e“Urban,‘îèwhic˜h“w˜asŽ¡‘6based–Îon“a“program“written“bš²!y“Marshall“Rose.‘&P˜erhaps“someda˜y“someoneŽ¡‘6will–¦frewrite“ÐMakeIndex‘÷óÍin“W‘ÿeeb,“making“it“a²!v‘ÿdDailable“to“all“L‘üÙŸþ•ëëKaŽ‘!­ÍT‘þ,³ŸLØEŽ‘B X“users.ŽŽŸ’çC38ŽŽŒøL}ƒ’À;èlÌÜžóLŒ-ø cmcsc10óKŒ-ø ó3 cmcsc10óJý':ff cmti10óIŒ-øG® cmcsc10óHý':G® cmti10ó9DÓítG®G®cmr17ó7ò"Vff cmbx10ó0ÂÖN  cmbx12ó+X«Q cmr12ó(ßê ó3 cmmi10ó"Kñ`y ó3 cmr10óߤN cmtt9óo´‹Ç cmr9ó |{Ycmr8ó¹Aa¨cmr6ùSŽßßßß