÷ƒ’À;è TeX output 1994.10.13:2153‹ÿÿÿÿ mÌÜ ý¹3$ (ÌÜ þ'Ž‘R¢ó›»ˆ@G® cmti12»MakeIndex‘vóDÓítG®G®cmr17º:‘¬An–7tIndex“ProsŽcessor“F‘þ¥Vor“LŸüdú‘úKGóX«Q cmr12¼AŽŽ‘¹”ºT‘ý[™Ÿ¸-EŽ‘;gXŽŸlÏ’Ã!+¼Leslie‘ê¨LampSŽortŽŽŽŽŽŸŒÏ’½^*17–ê¨F‘ÿVebruary“1987ŽŸ-‘6ó?ÂÖN ff cmbx12ê1Ž‘NLËHoŒÌw–ffto“Use“ó@›»ˆ@ff cmti12ë@MakeIndexŽŸq‹‘6óAý': ó3 cmti10ëAMakeIndex‘hóKñ`y ó3 cmr10¹is–KÛa“program“for“making“an“index“in“a“doMÞcumen²!t“generated“withŽ¤ ™š‘6LŸýûó‘üÙó*|{Ycmr8ÕAŽŽ‘ÈG¹T‘þ,³Ÿ[wEŽ‘B X.‘ÈaThe–eò rst“step“in“proMÞducing“the“index“is“to“put“the“necessary“óFßêand“regenerating“the“ëFind“¹ le.‘¸dIf“there“are“problems“that“cannotŽŽŸ’çC31ŽŽŒ‹* mÌÜ ý¹3$ (ÌÜ ýû3$‘6¹bMÞe–m corrected“in“this“w•²!a“y›ÿe,‘x‚y“ou–m can“alw•²!a“ys–m edit“the“ëFind“¹ 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Ž‘NLËHošŒÌw–ffto“Generate“Index“En˜triesŽŸ×ñ‘6óÂÖ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˜ëAIndexing–Ž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–§°ëC“¹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˜ëFdelatex˜¹program,‘€‘then˜the˜follo“wing˜UnixŽ¡‘6command–—Ígenerates“suc²!h“a“list“from“the“ le“ëFmyfile.tex“¹and“puts“it“on“theŽ¡‘6 le‘¦fëFfoo¹:Ž¤™š‘Q`ëFdelatex–¿ª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.ŽŸR…‘6Â2.2Ž‘TÀThe‘€BasicsŽ¦‘6¹Eacš²!h–ˆ­ëF\index“¹command“causes“LŸýûó‘üÙÕAŽŽ‘ÈG¹T‘þ,³Ÿ[wEŽ‘B X“to“write“an“en˜try“on“the“ëFidx“¹ le.‘ÓõTheŽ¡‘6folloš²!wing–ÆÎexample“sho˜ws“some“simple“ëF\index“¹commands“and“the“index“en-ŽŽŸ’çC32ŽŽŒ‹ › mÌÜ ý¹3$ (ÌÜ ýû3$‘6¹tries–mthat“they“prošMÞduce.‘ÊÄThe“page“n•²!um“b˜er–mrefers“to“the“page“con²!taining“theŽ¤ ™š‘6text–¦fwhere“the“ëF\index“¹command“appMÞears.Ÿü¾Õ1ŽŽŽ©™š‘Q`¹P²!age‘¦fiiŽ’‰ï~ëF\index{Alpha}‘ËuŸ}„ ™™ff‘™š„ ™™ffŽŽ¤ ™™‘Q`¹P²!age‘¦fviii:Ž’‰ï~ëF\index{alpha}‘ËuŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`¹P²!age‘¦fix:Ž’‰ï~ëF\index{alpha}‘ËuŸ}„ ™™ff‘™š„ ™™ffŽŽ¡’‰ï~\index{Alphabet}‘ ŒwŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`¹P²!age‘¦f22:Ž’‰ï~ëF\index{alpha}‘ËuŸ}„ ™™ff‘™š„ ™™ffŽŽ¡’‰ï~\index{alphas}‘ ËŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`¹P²!age‘¦f23:Ž’‰ï~ëF\index{alphabet}‘ ŒwŸ}„ ™™ff‘™š„ ™™ffŽŽ¡’‰ï~\index{alphabet}‘ ŒwŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`¹P²!age‘¦f24:Ž’‰ï~ëF\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“ëF\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“ëF\index“¹command“shouldŽ¡‘6conš²!tain–¦fbMÞoth“the“main“en˜try“and“the“subMÞen˜try‘ÿe,“separated“b˜y“a“ëF!“¹c˜haracter.Ž¦‘Q`P²!age‘¦f7:Ž’…û8ëF\index{gnat!size‘¿ªof}‘ÌÍŸ}„ ™™ff‘™š„ ™™ffŽŽ¤ ™™‘Q`¹P²!age‘¦f32:Ž’…û8ëF\index{gnat}‘3ÊŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`¹P²!age‘¦f35:Ž’…û8ëF\index{gnat!anatomy}‘ÌÍŸ}„ ™™ff‘™š„ ™™ffŽŽ¡’…û8\index{gnus!good}‘ ËŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`¹P²!age‘¦f38:Ž’…û8ëF\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:Ž’‰¡žëF\index{bites!animal!gnats}‘ÌÍŸ}„ ™™ff‘™š„ ™™ffŽŽ¤ ™™‘Q`¹P²!age‘¦f10:Ž’‰¡žëF\index{bites!animal!gnus}‘ ŒwŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`¹P²!age–¦f12“:Ž’‰¡žëF\index{bites!vegetable}‘ ËŸ}„ ™™ff‘™š„ ™™ffŽŽ¡’$察}„ ™™ff‘™š„ ™™ffŽŽ¡’$察}„ ™™ff‘™š„ ™™ffŽŽŽŽ’=2¹bitesŽŽ¡’Q2animalŽŽ¡’[2gnats,‘¦f8ŽŽ¡’[2gn²!us,‘¦f10ŽŽ¡’Q2v²!egetable,‘¦f12ŽŽŽŽŸL‘6LŸýûó‘üÙÕAŽŽ‘ÈG¹T‘þ,³Ÿ[wEŽ‘B X–— and“ëAMakeIndex‘é-¹suppMÞort“only“three“levš²!els“of“indexing;‘œŒy˜ou“can't“ha˜v˜eŽ¡‘6subsubsubMÞen²!tries.Ž¡‘GT‘ÿeo–¿ëspšMÞecify“a“page“range,‘Lput“an“ëF\index{...|(}“¹command“at“the“b˜e-Ž¡‘6ginning–ÜUof“the“range“and“an“ëF\index{...|)}“¹command“at“the“end“of“theŽ¡‘6range.Ž‘6Ÿ ‡w‰ffÿpŸ LÍ‘ {ºŸü-=ó+¹Aa¨cmr6Ö1ŽŽŽ‘¦aóJo´‹Ç cmr9ëJT‘ÿ:«o›ºwa•¾9v“oid˜an“y˜am“biguit“y˜if˜a˜page˜break˜oAÇccurs˜righ“t˜at˜an˜óQߤN cmtt9ëQ\index˜ëJcommand,‘ã¿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ŽŽŒ‹„ mÌÜ ý¹3$ (ÌÜ ýû3$‘Q`¹P²!age‘¦fvi:Ž’…û8ëF\index{gnat|(}‘"‹Ÿ}„ ™™ff‘™š„ ™™ffŽŽ¤ ™™‘Q`¹P²!age‘¦fx:Ž’…û8ëF\index{gnat|)}‘"‹Ÿ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`¹P²!age‘¦f22:Ž’…û8ëF\index{gnat}‘. sŸ}„ ™™ff‘™š„ ™™ffŽŽ¡’…û8\index{gnus!bad|(}‘ ŒwŸ}„ ™™ff‘™š„ ™™ffŽŽ¡’…û8\index{gnus!bad|)}‘ ŒwŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`¹P²!age‘¦f28:Ž’…û8ëF\index{gnus!good|(}‘ÌÍŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`¹P²!age‘¦f30:Ž’…û8ëF\index{gnus!good}‘L!Ÿ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`¹P²!age‘¦f32:Ž’…û8ëF\index{gnus!good|)}‘ÌÍŸ}„ ™™ff‘™š„ ™™ffŽŽŽŽ’Ns¹gnat,–¦fvi{x,“22ŽŽ¤ ™š’Nsgn²!usŽŽ¡’%Nsbad,‘¦f22ŽŽ¡’%Nsgo•MÞo“d,‘¦f28{32ŽŽŽŽŸs`‘6Note–”¶that“ëAMakeIndex‘æ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;Ž©T‘Q`P²!age‘¦f2:Ž’€žëF\index{at}‘g‡Ÿ}„ ™™ff‘™š„ ™™ffŽŽŸ ™™‘Q`¹P²!age‘¦f2:Ž’€žëF\index{at!bat|see{bat,‘¿ªat}}‘ÌÍŸ}„ ™™ff‘™š„ ™™ffŽŽŽŽ’9Ò)¹at,‘¦f2ŽŽ¡’MÒ)bat,–¦fëAse‘ÿp¹e‘y¹bat,“atŽŽŽŽŸ!Æ{‘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“ëF\index{...|see{...}}“¹command“goMÞes,‘:so“long“as“it“follo²!wsŽ¡‘6the–† ëF\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  b> ó3 cmmi10ëBd“ëF@ëB‘=O¹,‘Y„the“string“ëB‘g¹determines“theŽ¡‘6alphab•MÞetical›p×p“osition˜of˜the˜en²!try‘ÿe,‘£rwhile˜the˜string˜ëB‘®&¹pro“duces˜the˜text˜ofŽ¡‘6the‘¦fen²!try‘ÿe.Ž¦‘Q`P²!age‘¦f44:Ž’…û8ëF\index{twenty}‘ËuŸ}„ ™™ff‘™š„ ™™ffŽŽ¤ ™™‘Q`¹P²!age‘¦f46:Ž’…û8ëF\index{twenty-one}‘ÌÍŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`¹P²!age‘¦f55:Ž’…û8ëF\index{twenty@xx}‘ ŒwŸ}„ ™™ff‘™š„ ™™ffŽŽŽŽ’ ŽÉ¹t•²!w“en“t“y‘ÿe,‘¦f44ŽŽ¡’ ŽÉxx,‘¦f55ŽŽ¡’ ŽÉt•²!w“en“t“y-one,‘¦f46ŽŽŽŽŸ/`‘6This–˜mfeature“is“useful“bMÞecause“the“argumenš²!t“of“the“ëF\index“¹command“pro˜videsŽ¡‘6the–Ø.actual“input“string“that“LŸýûó‘üÙÕAŽŽ‘ÈG¹T‘þ,³Ÿ[wEŽ‘B X“uses“to“generate“the“index“en²!try‘ÿe.‘s5In“theŽ¡‘6folloš²!wing–¦fexample,“the“input“ëF$\alpha$“¹proMÞduces“the“sym˜bMÞol“ëB `¹,Ž¦‘Q`P²!age‘¦f12:Ž’…û8ëF\index{alphas}‘3ÊŸ}„ ™™ff‘™š„ ™™ffŽŽ¤ ™™‘Q`¹P²!age‘¦f13:Ž’…û8ëF\index{alpha}‘9‰ÇŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`¹P²!age‘¦f14:Ž’…û8ëF\index{alpha@$\alpha$}‘ÌÍŸ}„ ™™ff‘™š„ ™™ffŽŽŽŽ’"q¹alpha,‘¦f13ŽŽ¡’"qëB `¹,‘¦f14ŽŽ¡’"qalphas,‘¦f12ŽŽŽŽŸ/`‘6Similarly‘ÿe,‘£Ëthe–£$command“ëF\index{gnu@{\bf‘¿ªgnu}}“¹prošMÞduces“a“b˜oldface“óDò"V ó3 cmbx10ëDgn¦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Ÿìô‰ffÿpŸ LÍ‘ {ºŸü-=Ö2ŽŽŽ‘¦aëJThe–Tuse“of“\28 ."‘prather“than“\28{32"“is“froš¾9wned“upAÇon“b˜y“the“expAÇerts.ŽŽŸ’çC3¹4ŽŽŒ‹!¯ mÌÜ ý¹3$ (ÌÜ ýû3$‘6ëAn‘ÜR¹after–Ga“page“n•²!um“bMÞer›Gma“y˜denote˜that˜the˜item˜app•MÞears˜in˜a˜fo“otnote˜onŽ¤ ™š‘6that–ä¼page.‘˜ßëAMakeIndex‘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“ëBd“¹,‘nÌthe“commandŽ¡‘6ëF\index{...|ëBd“ëF}–l^¹prošMÞduces“a“page“n•²!um“b˜er–l^of“the“form“ëF\ëBd“ëF{ëBnëF}¹.‘ /ÄSimilarly‘ÿe,Ž¡‘6the–ëcommand“ëF\index{...|(ëBd“ëF}“¹maš²!y“proMÞduce“a“page“n˜um˜bMÞer“of“the“formŽ¡‘6ëF\ëBd“ëF{ëBn¹{ëBmëF}¹.‘çTh²!us,‘üsuppšMÞose–·¿the“do˜cumenš²!t“con˜tains“the“follo˜wing“commandŽ¡‘6de nitions:Ž© ‘Q`ëF\newcommand{\ii}[1]{{\it‘¿ª#1}}Ž¡‘Q`\newcommand{\nn}[1]{#1n}Ž¦‘6¹W‘ÿee–¦fcould“then“ha•²!v“e:Ž¦‘Q`P²!age‘¦f3:Ž’…û8ëF\index{gnat|ii}‘ÌÍŸ}„ ™™ff‘™š„ ™™ffŽŽ¤ ™™‘Q`¹P²!age‘¦f4:Ž’…û8ëF\index{gnat|nn}‘ÌÍŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`¹P²!age‘¦f5:Ž’…û8ëF\index{gnu}‘ËuŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`¹P²!age‘¦f44:Ž’…û8ëF\index{gnu|(ii}‘ÌÍŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`¹P²!age‘¦f46:Ž’…û8ëF\index{gnu|)}‘L!Ÿ}„ ™™ff‘™š„ ™™ffŽŽŽŽ’úO˹gnat,–¦fëA3¹,“4nŽŽ¡’úOËgn²!u,–¦f5,“ëA44{46ŽŽŽŽŸJ‰‘6¹The–«v\see"“option“is“a“spMÞecial“case“of“this“facilit²!y‘ÿe,‘¬ºwhere“the“ëF\see“¹commandŽ¡‘6is–¦fprede ned“bš²!y“the“ëFmakeidx“¹doMÞcumen˜t-st˜yle“option.ŽŸ¾‘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“ëFidx“¹ le“is“written.‘ëHence,‘Áìthe“command“ëF\index{\gnu}“¹proMÞducesŽ¡‘6an–2«enš²!try“that“is“alphabMÞetized“b˜y“ëF\gnu¹,‘IÑregardless“of“ho˜w“the“ëF\gnu“¹commandŽ¡‘6is‘¦fde ned.Ž¡‘GRecall–nÆthat“spMÞecial“cš²!haracters“lik˜e“ëF\“¹ma˜y“appMÞear“in“the“argumen˜t“ofŽ¡‘6an–ÜRëF\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“\ëF@¹"“part“of“an“en²!try‘ÿe,›ÆHas“in“ëF\index{gnu@{\it‘¿ªgnu}}¹,˜and“fragileŽ¡‘6commands–¦fcan“bMÞe“used“if“protected“with“the“ëF\protect“¹command.Ÿü¾Õ3ŽŽŽ¡‘G¹Rememš²!bMÞer–YÞthat“the“argumen˜t“of“an“ëF\index“¹command“m˜ust“alw˜a˜ys“ha˜v˜eŽ¡‘6matcš²!hing–¦fbraces,“where“the“brace“in“a“ëF\{“¹or“ëF\}“¹command“coun˜ts.Ž¡‘GëAMakeIndex‘Ö¹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.Ž‘6ŸèÚ‰ffÿpŸ LÍ‘ {ºŸü-=Ö3ŽŽŽ‘¦aëJIn––vš¾9ersions“of“LŸýó5‘ü«‡ÖAŽŽ‘© ëJT‘þuAŸïÿEŽ‘˜ŸX“released“bAÇefore“3“F‘ÿ:«ebruary“1987,‘ö0y˜ou“m˜ust“use“the“ëQ\stringŽŸ ëJcommand–Tinstead“of“ëQ\protectëJ.ŽŽŸ’çC3¹5ŽŽŒ‹.› mÌÜ ý¹3$ (ÌÜ ýû3$‘G¹T‘ÿeo–< put“a“ëF!¹,–QRëF@¹,“or–< ëF|“¹cš²!haracter“in“an“index“en˜try‘ÿe,‘QRëAquote‘­¹it“b˜y“preceding“theŽ¤ ™š‘6cš²!haracter–aQwith“a“ëF"¹.‘ÆÖMore“precisely‘ÿe,‘o"an˜y“a“c˜haracter“is“said“to“bMÞe“quoted“if“itŽ¡‘6follo²!ws–žaan“unquoted“ëF"“¹that“is“not“part“of“a“ëF\"“¹command.‘Û1A‘ž_quoted“ëF!¹,–ŸüëF@¹,“orŽ¡‘6ëF|– µ¹cš²!haracter“is“treated“lik˜e“an“ordinary“c˜haracter“rather“than“ha˜ving“its“usualŽ¡‘6meaning.‘.üThe–ÆëF"“¹preceding“a“quoted“cš²!haracter“is“deleted“bMÞefore“the“en˜triesŽ¡‘6are‘¦falphabMÞetized.ŽŸ™š‘Q`P²!age‘¦f2:Ž’€žëF\index{exclaim‘¿ª("!)}‘. sŸ}„ ™™ff‘™š„ ™™ffŽŽ¤ ™™‘Q`¹P²!age‘¦f3:Ž’€žëF\index{exclaim‘¿ª("!)!loudly}‘ÌÍŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`¹P²!age‘¦f4:Ž’€žëF\index{fur@f\"{u}r}‘3ÊŸ}„ ™™ff‘™š„ ™™ffŽŽ¡‘Q`¹P²!age‘¦f5:Ž’€žëF\index{quote‘¿ª(\verb+""+)}‘L!Ÿ}„ ™™ff‘™š„ ™™ffŽŽŽŽ’9Ò)¹exclaim–¦f(!),“2ŽŽ¡’MÒ)loudly‘ÿe,‘¦f3ŽŽ¡’9Ò)fMÞ‘ú8ˆur,‘¦f4ŽŽ¡’9Ò)quote–¦f(ëF""¹),“5ŽŽŽŽŸ>{õ‘GëAMakeIndex‘«…¹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\ëF ¹"–©Àdenote“a“space“c²!haracter,›ª—the“commands“ëF\index{gnu}¹,˜ëF\index{ gnu}¹,Ž¡‘6and–ÜÎëF\index{gnu }“¹prošMÞduce“three“separate“en²!tries,‘êhthe“ rst“app˜earing“nearŽ¡‘6the–ßEbšMÞeginning“of“the“index,‘í}since“ëF “¹comes“b˜efore“an²!y“letter“in“ëAMakeIndex‘Q¹'sŽ¡‘6\alphabšMÞetical"–rorder.‘oAll“three“en²!tries“lo˜ok“the“same“when“prin²!ted,‘¸5sinceŽ¡‘6LŸýûó‘üÙÕAŽŽ‘ÈG¹T‘þ,³Ÿ[wEŽ‘B X–[ignores“extra“spaces“in“the“input.‘û¬Similarly‘ÿe,‘ˆ'ëF\index{a space}“¹andŽ¡‘6ëF\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“ëF\index“¹command“across“lines“inŽ¡‘6the–¦finput“ le.ŽŸ"€A‘6ê3Ž‘NLËError‘ffMessagesŽŸq‹‘6ëAMakeIndex‘ï¹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“ëFilg¹.‘ÏThere“are“t•²!w“o–öÌphases“in“whic²!h“ëAMakeIndexŽ¡‘6¹can–™åproMÞduce“error“messages:‘ÄÜwhen“it“is“reading“the“ëFidx“¹ le,‘ÖÅand“when“itŽ¡‘6is–“owriting“the“ëFind“¹ 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“ëFidx“¹ le;‘Lbin“the“writingŽ¡‘6phase,–¦fit“refers“to“the“ëFind“¹ le.ŽŸR…‘6Â3.1Ž‘TÀErrors–€in“Reading“PhaseŽ¤«ÿ‘6ëFExtra–¿ª`!'‘ Tat“position“...Ž¡‘6¹The–·ëF\index“¹command's“argumenš²!t“has“more“than“t˜w˜o“unquoted“ëF!“¹c˜haracters.ŽŸ ™š‘6P²!erhaps–¦fsome“of“them“should“bMÞe“quoted.ŽŽŸ’çC36ŽŽŒ‹:\ mÌÜ ý¹3$ (ÌÜ ýû3$‘6ëFExtra–¿ª`@'“at“position“...Ž¤«ÿ‘6¹The–ø ëF\index“¹command“argumenš²!t“has“t˜w˜o“or“more“unquoted“ëF@“¹c˜haractersŽ© ™š‘6with–¦fno“in•²!terv“ening›¦fëF!¹.‘ÝÝP“erhaps˜one˜of˜the˜ëF@˜¹c“haracters˜should˜bMÞe˜quoted.ŽŸì‘6ëFExtra–¿ª`|'“at“position“...Ž¡‘6¹The–Æ ëF\index“¹command's“argumenš²!t“has“more“than“one“unquoted“ëF!“¹c˜haracters.Ž¦‘6P²!erhaps–¦fthe“extras“should“bMÞe“quoted.ŽŸì‘6ëFIllegal–¿ªnull“fieldŽ¡‘6¹The–“jëF\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“ëF\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ëF\index{@big}–¿ ¹is“incorrect“bšMÞecause“it“sp˜eci es“a“n²!ull“string“for“alphab˜etizing.ŽŸì‘6ëFArgument–¿ª...‘ Ttoo“long“(max“1024).Ž¡‘6¹Y‘ÿeour–‰doMÞcumenš²!t“con˜tained“an“ëF\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ëDOther‘2errorsŽ¡‘6ëAMakeIndex‘ ö¹can–ºiproMÞduce“a“v‘ÿdDariet²!y“of“other“error“messages“indicating“thatŽ¦‘6something– Mis“seriously“wrong“with“the“ëFidx“¹ le.‘ ‘If“y²!ou“get“one,‘$†it“probablyŽ¦‘6means–¶Rthat“the“ëFidx“¹ le“wš²!as“corrupted“in“some“w˜a˜y‘ÿe.‘×If“LŸýûó‘üÙÕAŽŽ‘ÈG¹T‘þ,³Ÿ[wEŽ‘B X“did“not“generateŽ¦‘6anš²!y–œ¡errors“when“it“created“the“ëFidx“¹ le,‘Ú/then“it“is“highly“unlik˜ely“to“ha˜v˜eŽ¦‘6proMÞduced–žóa“bad“ëFidx“¹ le.‘Ç„If“it“did,‘Ýyš²!ou'll“ha˜v˜e“to“examine“the“ëFidx“¹ le“toŽ¦‘6 gure–¦fout“what“w•²!en“t‘¦fwrong.ŽŸR…‘6Â3.2Ž‘TÀErrors–€in“W‘þàriting“PhaseŽ¡‘6ëFUnmatched–¿ªrange“opening“operatorŽ¡‘6¹An– x1ëF\index{...|(}“¹command“wš²!as“not“follo˜w˜ed“b˜y“a“matc˜hingŽ¦‘6ëF\index{...|)}–ÅP¹command.‘:œThe“\ëF...¹"“in“the“t•²!w“o–ÅPcommands“m²!ust“bMÞe“com-Ž¦‘6pletely‘¦fiden²!tical.ŽŽŸ’çC37ŽŽŒ‹F3 mÌÜ ý¹3$ (ÌÜ ýû3$‘6ëFUnmatched–¿ªrange“closing“operatorŽ¤«ÿ‘6¹An– 'ëF\index{...|(}“¹command“wš²!as“not“preceded“b˜y“a“matc˜hingŽ© ™š‘6ëF\index{...|)}‘¦f¹command.ŽŸì‘6ëFExtra–¿ªrange“opening“operatorŽ¡‘6¹Tw²!o–¦ÚëF\index{...|(}“¹commands“appšMÞear“in“the“do˜cumenš²!t“with“no“in˜terv˜eningŽ¦‘6ëF\index{...|)}‘¦f¹command.ŽŸì‘6ëFInconsistent–¿ªpage“encapsulator“...‘ Twithin“rangeŽ¡‘6ëAMakeIndex‘¹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˜ëF\index{gnu|ii}˜¹command˜bMÞet“w“een˜a˜ëF\index{gnu|(}Ž¦‘6¹and–¦fa“ëF\index{gnu|)}“¹command.ŽŸì‘6ëFConflicting‘¿ªentriesŽ¡‘6ëAMakeIndex‘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“ëF\index{gnu}Ž¦‘6¹and–¦fëF\index{gnu|(see{...}}“¹appMÞearing“on“the“same“page.ŽŸ"€A‘6êAc•ŒÌkno“wledgemen“tsŽŸq‹‘6ëAMakeIndex‘Ź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“ëAMakeIndex‘÷ó¹in“W‘ÿeeb,“making“it“a²!v‘ÿdDailable“to“all“LŸýûó‘üÙÕAŽŽ‘ÈG¹T‘þ,³Ÿ[wEŽ‘B X“users.ŽŽŸ’çC38ŽŽŒøNIƒ’À;èmÌÜžóQߤN cmtt9óJo´‹Ç cmr9óFßê ó3 cmmi10óAý': ó3 cmti10ó@›»ˆ@ff cmti12ó?ÂÖN ff cmbx12ó+¹Aa¨cmr6ó*|{Ycmr8óÂÖN  cmbx12óX«Q cmr12󛻈@G® cmti12óDÓítG®G®cmr17óKñ`y ó3 cmr10ùTCßßßß