÷ƒ’À;è TeX output 1994.10.13:2153‹ÿÿÿÿ mÌÜ� ý¹3$ (ÌÜ� þ'Ž�‘R¢ó›»ˆ@G® cmti12»MakeIndex‘vóDÓítG®G®cmr17º:‘¬An–7tIndex“Pro�sŽcessor“F‘þ¥Vor“L�Ÿüdú�‘úKGóX«Q cmr12¼AŽŽ‘¹”ºT�‘ý[™Ÿ¸-EŽ‘;gXŽŸlÏ�����’Ã!+¼Leslie‘ê¨Lamp�SŽ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“do�MÞcumen�²!t“generated“withޤ ™š�‘6L�Ÿýûó�‘üÙó*|{Ycmr8ÕAŽŽ‘ÈG¹T�‘þ,³Ÿ[wEŽ‘B X.‘ÈaThe–eò rst“step“in“pro�MÞ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¹b�MÞ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“b�MÞe“a˜v˜oided“b�MÞ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“do�MÞcumen˜t.‘éØResist“theŽ¡�‘6temptation.‘ÔùIt–‹¹is“virtually“imp�MÞ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“lo�MÞoking“for.‘;3WithŽ¡�‘6this–ÅTin“mind,‘Ícommon“sense“can“help“in“ guring“out“what“should“b�MÞe“in“theŽ¡�‘6index–#áand“ho�²!w“it“should“b�MÞ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–Fb�MÞeen“written“whenŽ¡�‘6high–®tecš²!h“mean˜t“using“a“ball-p�MÞoin˜t“p�MÞ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“metho�MÞd“of“using“theŽ¡�‘6computer–L{to“lighš²!ten“the“c˜hore.‘ÐAn“alphab�MÞetical“list“of“ev˜ery“w˜ord“in“y˜ourŽ¡�‘6do�MÞ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“to�MÞ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“imp�MÞortan˜t“and“mec˜hanically“generate“anŽ¡�‘6index–”êciting“evš²!ery“o�MÞccurrence“of“those“w˜ords,‘Ћbut“the“resulting“index“willŽ¡�‘6not–¦fb�MÞ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“app�MÞ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–¦fb�MÞet,“24ŽŽ¡��’ ÃeAlphab�MÞet,‘¦fixŽŽ¡��’ Ãealphab�MÞet,‘¦f23ŽŽ¡��’ Ãealphas,‘¦f22ŽŽŽŽ ‚{ï�‘6Note–­àthat“the“duplicate“ëF\index{alphabet}“¹commands“on“page“23“pro�MÞ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–¦fb�MÞoth“the“main“en˜try“and“the“sub�MÞ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‘¦fsubsub�MÞ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‘é-¹supp�MÞort“only“three“levš²!els“of“indexing;‘œŒy˜ou“can't“ha˜v˜eŽ¡�‘6subsubsub�MÞ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˜o�AÇ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“b�AÇ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“b�MÞ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“do�MÞes“not“prin˜t“an˜y“page“n˜um˜bšMÞer,‘‚it“do˜esn't“mat-Ž¡�‘6ter–ïwhere“the“ëF\index{...|see{...}}“¹command“go�MÞ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“sp�MÞecify“an“en˜try“of“the“form“óB  b> ó3 cmmi10ëB�d“ë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“b�MÞ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$“¹pro�MÞduces“the“sym˜b�MÞ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“b�MÞ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“up�AÇon“b˜y“the“exp�AÇerts.ŽŽŸ�’çC3¹4ŽŽŒ‹!¯ mÌÜ� ý¹3$ (ÌÜ� ýû3$�‘6ëAn‘ÜR¹after–Ga“page“n•²!um“b�MÞ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-Ž¡�‘6b�MÞer–àRanš²!y“w˜a˜y“y˜ou“w˜an˜t.‘ ‹ F‘ÿeor“an˜y“string“of“c˜haracters“ëB�d“¹,‘nÌthe“commandŽ¡�‘6ëF\index{...|ëB�d“ëF}–l^¹prošMÞduces“a“page“n•²!um“b˜er–l^of“the“form“ëF\ëB�d“ëF{ëBnëF}¹.‘ /ÄSimilarly‘ÿe,Ž¡�‘6the–ëcommand“ëF\index{...|(ëB�d“ëF}“¹maš²!y“pro�MÞduce“a“page“n˜um˜b�MÞer“of“the“formŽ¡�‘6ëF\ëB�d“ë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“sp�MÞecial“case“of“this“facilit�²!y‘ÿe,‘¬ºwhere“the“ëF\see“¹commandŽ¡�‘6is–¦fprede ned“bš²!y“the“ëFmakeidx“¹do�MÞ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˜yp�MÞeset,‘­notŽ¡�‘6when–¼kthe“ëFidx“¹ le“is“written.‘ëHence,‘Áìthe“command“ëF\index{\gnu}“¹pro�MÞducesŽ¡�‘6an–2«enš²!try“that“is“alphab�MÞetized“b˜y“ëF\gnu¹,‘IÑregardless“of“ho˜w“the“ëF\gnu“¹commandŽ¡�‘6is‘¦fde ned.Ž¡�‘GRecall–nÆthat“sp�MÞecial“cš²!haracters“lik˜e“ëF\“¹ma˜y“app�MÞ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“b�MÞ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“b�MÞe“used“if“protected“with“the“ëF\protect“¹command.��Ÿü¾Õ3ŽŽŽ¡�‘G¹Rememš²!b�MÞ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“b�MÞers–ÉIare“either“arabic“or“lo•²!w“er-Ž¡�‘6case–ú�roman“nš²!umerals;‘3Îit“assumes“that“pages“n˜um˜b�MÞered“with“roman“n˜umeralsŽ¡�‘6precede–¦fthose“n•²!um“b�MÞered–¦fwith“arabic“n�²!umerals.Ž‘6ŸèÚ‰ff�ÿpŸ LÍ����‘ {ºŸü-=Ö3ŽŽŽ‘¦aëJIn––vš¾9ersions“of“L�Ÿýó5�‘ü«‡ÖAŽŽ‘© ëJT�‘þuAŸïÿEŽ‘˜ŸX“released“b�AÇ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“b�MÞ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“b�MÞefore“the“en˜triesŽ¡�‘6are‘¦falphab�MÞ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Ò)f�MÞ‘ú8ˆur,‘¦f4ŽŽ¡��’9Ò)quote–¦f(ëF""¹),“5ŽŽŽŽŸ>{õ�‘GëAMakeIndex‘«…¹regards–Yøspaces“as“ordinary“c�²!haracters“when“alphab�MÞ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عpro�MÞduce“t•²!w“o›4Ødi eren“t˜en“tries˜that˜lo�MÞ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š²!yp�MÞes–²bout“on“the“terminal“the“n˜um˜b�MÞ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–™åpro�MÞ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“b�MÞer,‘9¸iden“tifying˜where˜in˜the˜ le˜the˜error˜o�MÞccurs.Ž¡�‘6In–the“reading“phase,‘0¸the“line“n•²!um“b�MÞ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“b�MÞ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˜b�MÞ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“b�MÞe“quoted.ŽŸì�‘6ëFIllegal–¿ªnull“fieldŽ¡�‘6¹The–“jëF\index“¹command“argumenš²!t“do�MÞesn't“mak˜e“sense“b�MÞ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–�‰do�MÞ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“supp�MÞosed“to“delimit“the“argu-ަ�‘6men�²!t.ŽŸì�‘6ëDOther‘2�errorsŽ¡�‘6ëAMakeIndex‘ ö¹can–ºipro�MÞ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ަ�‘6pro�MÞ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“b�MÞ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–¯sb�MÞeen“instructed“to“include“a“page“range“for“an“en�²!try“andަ�‘6a–•$single“page“n•²!um“b�MÞer–•$within“that“range“that“is“formatted“di eren�²!tly|forަ�‘6example,‘Êb•²!y›ëbha“ving˜a˜ëF\index{gnu|ii}˜¹command˜b�MÞet“w“een˜a˜ëF\index{gnu|(}ަ�‘6¹and–¦fa“ëF\index{gnu|)}“¹command.ŽŸì�‘6ëFConflicting‘¿ªentriesŽ¡�‘6ëAMakeIndex‘3J¹thinks–á½it“has“b�MÞeen“instructed“to“prinš²!t“the“same“page“n˜um˜b�MÞ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{...}}“¹app�MÞ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ßßßß