÷ƒ’À;è TeX output 2000.04.12:1542‹ÿÿÿÿ�Ÿò� ƒ3*� şšé�‘GóBÂÖN ¼j cmbx12ëBKpathsea‘Ƨlibrary�‘GŸ 0‰±�¸Ÿ šª�’e'ó2Kñ`y ó3 cmr10İfor–¦fv�²!ersion“3.3.1�Ÿ �’ƒMa�²!y‘¦f1999� �(¤�óTÂÖN ff cmbx12ëTK.–ffBerry“(ó3ßêJust�¡�‘Gseemed–¦flikš²!e“it“w˜as“time.�¦�‘!GDviljk–Xtgot“started“in“Marcš²!h“1994“after“I‘Xb�MŞough˜t“a“Laserjet“4.‘ ô(Kpathsea“w˜ork“got�¡�‘Gsusp�MŞended–â while“Norm“W‘ÿealsh“and“I,“with“Gustaf“Neumann's“help,‘ğóimplemenš²!ted“a“w˜a˜y“for�¡�‘GT�‘ş,³Ÿ[wE�‘B X‘Dùto–Eget“at“all“those“neat“builtin“LJ4“fon•²!ts�‘îö.–§‘.“.�‘öósuc“h–Ea“treat“to“ha•²!v“e–Esomething“to“t�²!yp�MŞeset�¡�‘Gin–¦fb�MŞesides“P�²!alatino!)�¦�‘!GBy–c4spring“of“1995,‘ÒgI‘bÂhad“implemenš²!ted“just“ab�MŞout“all“the“path-searc˜hing“features“in�¡�‘GKpathsea–ŠÑthat“I‘Š–plan“to,‘Ãëdrivš²!en“b�MŞey˜ond“m˜y“initial“goals“b˜y“Thomas“Esser“and“others.‘‹I�¡�‘Gthen–é\started“to“in�²!tegrate“W›ÿeeb2c“with“Kpathsea.‘¦¿After“the“release“of“a“stable“W˜eb2c,‘:I�¡�‘GhopšMŞe–´Jto“b˜e“able“to“stop“dev•²!elopmen“t,‘·Ãand–´Jturn“most“of“mš²!y“atten˜tion“bac˜k“to“making“fon˜ts�¡�‘Gfor–wİGNU.“(Alw•²!a“ys–wİassuming“Micros**t“hasn't“completely“obliterated“Unix“b�²!y“then,‘�,or“that�¡�‘Gsoft•²!w“are›Ípaten“ts˜ha“v“en't˜stopp�MŞed˜soft“w“are˜dev“elopmen“t˜b“y˜an“yb•MŞo“dy˜smaller˜than˜a˜compan�²!y�¡�‘Gwith–ë†a“million-dollar-a-yš²!ear“legal“budget.‘Ÿ“Whic˜h“is“actually“what“I‘ëWthink“is“lik˜ely“to“happ�MŞen,�¡�‘Gbut–¦fthat's“another“story�‘©ä.–§‘.“.�‘lÏ)�¦�‘!G[Olaf–ú1writes.]‘¤vAš²!t“the“end“of“1997,‘¢UNIX‘úis“still“aliv˜e“and“kic˜king,‘¢individuals“still“dev˜elop�¡�‘Gsoft•²!w“are,‘¼and–·ÁW‘ÿeeb2c“dev•²!elopmen“t–·Ástill“con•²!tin“ues.‘íKarl–·Áhad“bšMŞeen“lo˜oking“for“some“time“for�¡�‘Gsomeone–¦fto“takš²!e“up“part“of“the“burden,“and“I“v˜olun˜teered.��Œ‹��Ÿò��‘GİChapter‘¦f2:‘İİInstallation’=¤ 3��� ƒ3*� ı ÌÖ��‘GëK2‘ ¸QInstallation��Ÿø¯�‘!Gİ(A–¦fcopš²!y“of“this“c˜hapter“is“in“the“distribution“ le“`Şkpathsea/INSTALLİ'.)�©u�‘!GThe–^´pro�MŞcedure“for“Kpathsea“(and“W‘ÿeeb2c,‘m etc.)›Å÷con guration“and“installation“follo�²!ws.˜If�¤ 33�‘Gy•²!ou›N@encoun“ter˜trouble,–_ásee˜Section˜2.6.5˜[Common˜problems],“page˜24,“a˜cop•²!y˜of˜whic“h˜is˜in�¡�‘Gthe–¦f le“`Şkpathsea/BUGSİ'.�Ÿ"$’��‘GëT2.1‘™Simple‘f@installation��Ÿu�‘!GİInstalling–I½T�‘ş,³Ÿ[wE�‘B X‘I“and“friends“for“the“ rst“time“can“bšMŞe“a“daun�²!ting“exp˜erience.‘ÇáTh•²!us,‘r’y“ou�¡�‘Gma�²!y–Åprefer“to“skip“this“whole“thing“and“just“get“precompiled“executables:‘°›see“Section“2.5�¡�‘G[unixtex.ftp],–¦fpage“17.�¦�‘!GThis–›êsection“explains“what“to“do“if“yš²!ou“wish“to“tak˜e“the“defaults“for“ev˜erything,‘ÙJand�¡�‘Ggenerally–ªüto“install“in“the“simplest“pšMŞossible“w•²!a“y‘ÿe.‘ë Most–ªüsteps“here“refer“to“corresp˜onding�¡�‘Gsubsection–ôÛin“the“next“section“whicš²!h“explains“ho˜w“to“o˜v˜erride“defaults“and“generally“giv˜es�¡�‘Gmore‘¦fdetails.�¦�‘!GBy–�¥default“evš²!erything“will“b�MŞe“installed“under“`Ş/usr/localİ'“and“the“follo˜wing“discussion�¡�‘Gassumes›™Œthis.‘Ù”Ho•²!w“ev“er,‘œif˜y“ou˜already˜ha“v“e˜T�‘ş,³Ÿ[wE�‘B X‘™‰installed,‘œits˜lo�MŞcation˜is˜used˜to˜deriv“e˜the�¡�‘Gdirectory–¦funder“whicš²!h“ev˜erything“is“to“b�MŞe“installed.�¦��‘-1.�‘'¿«Be–=ssure“yš²!ou“ha˜v˜e“enough“disk“space:‘ öappro˜ximately“8“megab˜ytes“for“the“compressed�¡�‘'¿«arc•²!hiv“es,–rh15MB› for‘hsources,“50MB˜for‘hcompilation,“40MB˜for–hthe“(initial)“installed�¡�‘'¿«system–¦f(including“library“ les).‘İİSee“Section“2.2.1“[Disk“space],“page“4.�ŸÔ��‘-2.�‘'¿«Retrievš²!e–¦fthese“distribution“arc˜hiv˜es:�©u�‘'¿«Şftp://ftp.tug.org/tex/texk.tar.gz�¡�‘a��İThese–¦fare“the“sources,“whicš²!h“y˜ou“will“b�MŞe“compiling.�¦�‘'¿«Şftp://ftp.tug.org/tex/texklib.tar.gz�¡�‘a��İThis–§‹is“a“basic“set“of“input“ les.‘áKY‘ÿeou“should“unpac�²!k“it“in“the“directory�¡�‘a��`Ş/usr/local/shareİ';–¦fdoing“so“will“create“a“`Ştexmfİ'“sub�MŞdirectory“there.�¦�‘'¿«These›¦farc•²!hiv“es˜are˜mirrored˜on˜the˜CT–ÿeAN˜hosts,˜in˜the˜`Şsystems/web2cİ'˜directory“.�¤Ô�‘'¿«See–¦fSection“2.2.2“[Kpathsea“application“distributions],“page“5.�¡��‘-3.�‘'¿«When–&using“the“default“searcš²!h“paths,‘3there“is“no“need“to“edit“an˜y“distribution“ les.‘­ÈSee�© 33�‘'¿«Section–¦f2.2.3“[Changing“searc�²!h“paths],“page“5.�¡��‘-4.�‘'¿«Aš²!t–üşthe“top“lev˜el“of“the“distribution,‘¤run“`Şsh‘¦fconfigureİ'.‘á¦(If“y˜ou“ha˜v˜e“the“GNU‘üèBash�¦�‘'¿«shell–¦finstalled,“run“`Şbash“configureİ'.)‘İİSee“Section“2.2.4“[Running“con gure],“page“7.�¡��‘-5.�‘'¿«`Şmakeİ'.›ğLSee–¬‹Section“2.2.5“[Running“mak�²!e],‘®page“10.˜If“y�²!ou“are“using“a“BSD‘¬‰4.4“system�¦�‘'¿«sucš²!h–[sas“F‘ÿereeBSD‘[or“NetBSD,“y˜ou“ma˜y“ha˜v˜e“to“use“GNU‘[mak˜e“(often“installed“in�¦�‘'¿«`Ş/usr/local/binİ'),–¦fnot“the“BSD“mak�²!e.�¡��‘-6.�‘'¿«`Şmake–¦finstallİ'.‘İİSee“Section“2.2.6“[Installing“ les],“page“10.�¡��‘-7.�‘'¿«`Şmake–¦fdistcleanİ'.‘İİSee“Section“2.2.7“[Cleaning“up],“page“11.�¡��‘-8.�‘'¿«Set–up“a“cron“job“to“rebuild“the“ lename“database“that“makš²!es“searc˜hing“faster.‘ŞThis�¦�‘'¿«line–¦fwill“rebuild“it“evš²!ery“midnigh˜t:��Œ‹%>�Ÿò��‘GİChapter‘¦f2:‘İİInstallation’=¤ 4��� ƒ3*� ı ÌÖ�‘D¨Ş0–¿ª0“*“*“*“cd“/usr/local/share/texmf“&&“á/bindir‘É)Ş/mktexlsr�¤s�‘'¿«İSee– Section“2.2.8“[Filename“database“generation],›6opage“11,˜and“Section“3.4“[Filename�© 33�‘'¿«database],–¦fpage“34.�¡��‘-9.�‘'¿«If–ıíyš²!ou're“installing“Dvips,‘Ïy˜ou“also“need“to“set“up“con guration“ les“for“y˜our“prin˜ters�¦�‘'¿«and–ÉŞmakš²!e“an˜y“additional“P˜ostScript“fon˜ts“a˜v‘ÿdDailable.‘”[See“section“\Installation"“in“áDvips�s‚İ.�¦�‘'¿«If–¦fyš²!ou“ha˜v˜e“an˜y“color“prin˜ters,“see“section“\Color“device“con guration"“in“áDvips�s‚İ.�¡��‘‡“10.�‘'¿«The–]R rst“time“yš²!ou“run“a“D˜VI‘]#driv˜er,‘‹ a“bunc˜h“of“PK‘]#fon˜ts“will“b�MŞe“built“b˜y“Metafon˜t�¦�‘'¿«via–4Şmktexpk“İ(and“added“to“the“ lename“database).›†¼This“will“tak�²!e“some“time.˜Don't�¦�‘'¿«b�MŞe–_Úalarmed;‘w^they“will“created“only“this“ rst“time“(unless“something“is“wrong“with“y�²!our�¦�‘'¿«path‘¦fde nitions).�¡�‘'¿«By–=Mdefault,‘RRŞmktexpk“İwill“create“these“fonš²!ts“in“a“hierarc˜h˜y“under“`Ş/var/tmp/texfontsİ';�¦�‘'¿«it–¿Õsimply“assumes“that“`Ş/var/tmpİ'“exists“and“is“globally“writable.‘‘If“yš²!ou“need“a“di eren˜t�¦�‘'¿«arrangemen�²!t,–¦fsee“Section“2.2.9.1“[mktex“con guration],“page“12.�¡�‘'¿«See–¦fSection“2.2.9“[mktex“scripts],“page“12.�¡��‘‡“11.�‘'¿«F‘ÿeor–÷Isome“simple“tests,‘ �try“`Ştex–¦fstory“\\byeİ'–÷Iand“`Şlatex‘¦fsample2eİ'.‘Ğ…Then“run“`Şxdvi�¦�‘'¿«storyİ'–=or“`Şdvips‘¦fsample2eİ'“on“the“resulting“Dš²!VI‘ les“to“preview/prin˜t“the“do�MŞcumen˜ts.�¦�‘'¿«See–¦fSection“2.2.10“[Installation“testing],“page“14.�ŸsÁ��‘GëT2.2‘™Custom‘f@installation��Ÿs�‘!GİMost–Ï�sites“need“to“mošMŞdify“the“default“installation“pro˜cedure“in“some“w•²!a“y‘ÿe,‘ú†p˜erhaps‘Ï�merely�¦�‘Gc�²!hanging–téthe“pre x“from“`Ş/usr/localİ',‘~Ïp�MŞerhaps“adding“extra“compiler“or“loader“options“to�¦�‘Gwš²!ork–1around“Şconfigure“İbugs.‘}úThis“section“explains“ho˜w“to“o˜v˜erride“default“c˜hoices.‘}úF‘ÿeor�¦�‘Gadditional–¦fdistribution-sp�MŞeci c“information:�¡��‘ Øæ�‘'¿«İ`Şdviljk/INSTALLİ'.�¡��‘ Øæ�‘'¿«İSee–¦fsection“\Installation"“in“áDvips�s‚İ.�¡��‘ Øæ�‘'¿«İSee–¦fsection“\Installation"“in“áW‘ÿeeb2c‘ªİ.�¡��‘ Øæ�‘'¿«İ`Şxdvik/INSTALLİ'.�Ÿ¦ó�‘!GThese–instructions“are“for“Unix“systems.‘;èOther“opšMŞerating-system“sp˜eci c“distributions�¦�‘Gha•²!v“e–¦ftheir“o�²!wn“instructions.‘İİThe“cošMŞde“base“itself“supp˜orts“Amiga,“DOS,“OS/2,“and“VMS.�¡�‘!GF‘ÿeolloš²!wing–’åare“the“same“steps“as“in“the“previous“section“(whic˜h“describ�MŞes“the“simplest�¦�‘Ginstallation),–¦fbut“with“m•²!uc“h–¦fmore“detail.�ŸsÁ��‘Gó]ÂÖN  #× cmbx12ë]2.2.1‘d(Disk‘íMspace��Ÿs�‘!GİHere–ª is“a“table“shoš²!wing“the“disk“space“needed“for“eac˜h“distribution“(describ�MŞed“in“the�¦�‘Gnext–jsection).‘ (ÃThe“`(totals)'“line“re ects“the“`Ştexkİ'“source“distribution“and“`Ştexklibİ';�¦�‘Gthe–kÏindividual“distributions“don't“enš²!ter“in˜to“it.‘.Sizes“are“in“megab˜ytes.‘.All“n˜um˜b�MŞers“are�¦�‘Gappro�²!ximate.�¡����‘GDistribution������‘V !.tar.gz������’€’˜Unpac•²!k“ed������’¹ICompiled������’ïŞZInstalled����¦����‘Gdviljk������‘V !.9������’€’˜3.8����¦����‘Gdvipsk������‘V !.9������’€’˜3.2����¦����‘Gxdvik������‘V !.7������’€’˜2.5����¦����‘Gw�²!eb2c������‘V !1.3������’€’˜5.0�����Œ‹2N�Ÿò��‘GİChapter‘¦f2:‘İİInstallation’=¤ 5��� ƒ3*� ı ÌÖ����‘Gw�²!eb������‘V !1.9������’€’˜6.5������’¹I-������’ïŞZ-����¤ 33����‘Gtexk������‘V !3.8������’€’˜14.1������’¹I43.1������’ïŞZ23.5����¡����‘Gtexklib������‘V !3.8������’€’˜15.0������’¹I-������’ïŞZ15.0����¡����‘G(totals)������‘V !7.6������’€’˜29.1������’¹I43.1������’ïŞZ38.5����ŸÑ0��‘Gë]2.2.2‘d(Kpathsea–íMapplication“distributions��ŸË�‘!GİThe›��arc•²!hiv“e˜Şftp://ftp.tug.org/tex/texk.tar.gz˜İcon“tains˜all˜of˜the˜Kpathsea˜appli-�¡�‘Gcations–‘I‘8main�²!tain,›Wand“the“library“itself.‘ì^F‘ÿeor“example,˜since“NeXT‘8do�MŞes“not“generally�¡�‘Gsupp�MŞort–ºšX11,‘ÿ§yš²!ou'd“probably“w˜an˜t“to“skip“`Şxdvikİ'“(or“simply“remo˜v˜e“it“after“unpac˜king�¡�‘G`Ştexk.tar.gzİ'.‘³ÊIf–C yš²!ou“are“not“in˜terested“in“all“of“them,‘j3y˜ou“can“also“retriev˜e“them“sepa-�¡�‘Grately:�Ÿ�‘G`Şdviljk.tar.gzİ'�¡�‘Kâ:Dš²!VI–¦fto“PCL,“for“LaserJet“prin˜ters.�©Ë�‘G`Şdvipsk.tar.gzİ'�¡�‘Kâ:Dš²!VI–¦fto“P˜ostScript,“for“preview˜ers,“prin˜ters,“or“PDF“generation.�¦�‘G`Şweb2c.tar.gzİ'�¡�‘Kâ:The›¦fsoft•²!w“are˜needed˜to˜compile˜T�‘ş,³Ÿ[wE�‘B X˜and˜friends.�¦�‘G`Şweb.tar.gzİ'�¡�‘Kâ:The–¦foriginal“WEB“source“ les,“also“used“in“compilation.�¦�‘G`Şxdvik.tar.gzİ'�¡�‘Kâ:Dš²!VI–¦fpreviewing“under“the“X“windo˜w“system.�Ÿc�‘!GIf–.³yš²!ou“w˜an˜t“to“use“the“Bab�MŞel“LaT�‘ş,³Ÿ[wE�‘B X‘.•pac˜k‘ÿdDage“for“supp�MŞort“of“non-English“t˜yp�MŞesetting,‘F¤y˜ou�¡�‘Gmaš²!y–¦fneed“to“retriev˜e“additional“ les.‘İİSee“the“ le“`Şinstall.txtİ'“in“the“Bab�MŞel“distribution.�ŸÑ0��‘Gë]2.2.3‘d(Changing–íMsearc�–áh“paths��ŸË�‘!GİIf–hdthe“searcš²!h“paths“for“y˜our“installation“di er“from“the“standard“T�‘ş,³Ÿ[wE�‘B X‘h2directory“struc-�¡�‘Gture–èD(see“section“\In�²!tro�MŞduction"“in“áA›ç°Directory“Structure“for“T�‘ş,³Ÿ[wE�‘B X˜ les�s‚İ),‘x»edit“the“ le�¡�‘G`Şkpathsea/texmf.inİ'–YÜas“desired,›Ƹb�MŞefore“running“Şconfigureİ.‘ ø>F‘ÿeor“example,˜if“yš²!ou“ha˜v˜e�¡�‘Gall–¦fyš²!our“fon˜ts“or“macros“in“one“big“directory‘ÿe.�©Ë�‘!GY‘ÿeou–¾¤ma�²!y“also“wish“to“edit“the“ le“`Şmktex.cnfİ',›³either“b�MŞefore“or“after“installation,˜to�¡�‘Gcon�²!trol–Ív‘ÿdDarious“asp�MŞects“of“Şmktexpk“İand“friends.‘5See“Section“2.2.9.1“[mktex“con guration],�¡�‘Gpage‘¦f12.�¦�‘!GY‘ÿeou–Ÿdo“not“need“to“edit“`Ştexmf.inİ'“to“cš²!hange“the“default“top-lev˜el“or“other“installation�¡�‘Gó5ı': ó3 cmti10àdir–ÿp¹e“ctories‘ø-İ(only–the“paths).‘ ëY‘ÿeou“can“and“should“do“that“when“y�²!ou“run“Şconfigure“İ(next�¡�‘Gstep).�¦�‘!GY‘ÿeou–¹Ëalso“do“not“need“to“edit“`Ştexmf.inİ'“if“y�²!ou“are“willing“to“rely“on“`Ştexmf.cnfİ'“at�¡�‘Grun�²!time–gto“de ne“the“paths,‘=§and“let“the“compile-time“default“paths“b�MŞe“incorrect.‘HáUsually�¡�‘Gthere–¦fis“no“harm“in“doing“this.�¦�‘!GThe–¦fsection“b�MŞelo�²!w“explains“default“generation“in“more“detail.��Œ‹?`�Ÿò��‘GİChapter‘¦f2:‘İİInstallation’=¤ 6��� ƒ3*� ı ÌÖ��‘Gë]2.2.3.1‘d(Default–íMpath“features��ŸP�‘!GİThe–\purp�MŞose“of“haš²!ving“all“the“di eren˜t“ les“describšMŞed“in“the“section“ab˜o•²!v“e–\is“to“a•²!v“oid�¤ 33�‘Ghaš²!ving–6Ùthe“same“information“in“more“than“one“place.‘¸®If“y˜ou“c˜hange“the“installation“directo-�¡�‘Gries–›Øor“top-levš²!el“pre x“at“Şconfigureİ-time,‘�õthose“c˜hanges“will“propagate“through“the“whole�¡�‘Gsequence.‘º[And–;ßif“yš²!ou“c˜hange“the“default“paths“in“`Ştexmf.inİ',‘Q-those“c˜hanges“are“propagated�¡�‘Gto–¦fthe“compile-time“defaults.�©P�‘!GThe–º>Makš²!e“de nitions“are“all“rep�MŞeated“in“sev˜eral“ŞMakefileİ's;‘Ä*but“c˜hanging“the“top-lev˜el�¡�‘G`ŞMakefileİ'–�Æshould“suce,›•as“it“passes“do�²!wn“all“the“v‘ÿdDariable“de nitions,˜thš²!us“o˜v˜erriding“the�¡�‘Gsubmakš²!es.‘2¨(The–ªde nitions“are“rep�MŞeated“so“y˜ou“can“run“Mak˜e“in“the“sub�MŞdirectories,‘É»if“y˜ou�¡�‘Gshould›¦fha•²!v“e˜o�MŞccasion˜to.)�¦�‘!GBy–¶default,›9Ùthe“bitmap“fon�²!t“paths“end“with“`Ş/$MAKETEX_MODEİ',˜th�²!us“including“the“device�¡�‘Gname–$§(usually“a“Metafonš²!t“mo�MŞde“name“suc˜h“as“`Şljfourİ').‘X¡This“distinguishes“t˜w˜o“di eren˜t�¡�‘Gdevices–Šwith“the“same“resolution|a“write/white“from“a“write/blacš²!k“300‘Ó7dpi“prin˜ter,‘Y’for�¡�‘Gexample.�¦�‘!GHo•²!w“ev“er,›\since–íZmost“sites“don't“ha•²!v“e–íZthis“complication,˜Kpathsea“(sp�MŞeci cally‘ÿe,˜the“Şkpse_�¡�‘Ginit_prog–°şİfunction“in“`Şkpathsea/proginit.cİ')“has“a“spšMŞecial“case:‘c*if“the“mo˜de“has“not“b˜een�¡�‘Gexplicitly–KÙset“bš²!y“the“user“(or“in“a“con guration“ le),‘]õit“sets“ŞMAKETEX_MODE“İto“Ş/İ.‘¿®This“mak˜es�¡�‘Gthe–®ldefault“PK‘®(path,›ğmfor“example,˜expand“in�²!to�“Ş...�‘ík/pk//İ,˜so“fonš²!ts“will“b�MŞe“found“ev˜en“if�¡�‘Gthere–FÌis“no“subšMŞdirectory“for“the“mo˜de“(if“yš²!ou“arranged“things“that“w˜a˜y“b�MŞecause“y˜our“site�¡�‘Ghas–¦fonly“one“prinš²!ter,“for“example)“or“if“the“program“is“mo•MŞde-indep“enden˜t–¦f(e.g.,“Şpktypeİ).�¦�‘!GT‘ÿeo–fômakš²!e“the“paths“indep�MŞenden˜t“of“the“mošMŞde,‘s¤simply“edit“`Ştexmf.inİ'“b˜efore“installation,�¡�‘Gor–¦fthe“installed“`Ştexmf.cnfİ',“and“remo•²!v“e–¦fthe“`Ş$MAKETEX_MODEİ'.�¦�‘!GSee–*Section“2.2.9.3“[mktex“script“argumen�²!ts],›šZpage“14,˜for“hoš²!w“this“in˜teracts“with�¡�‘GŞmktexpkİ.�¦�‘!GSee–S?Section“2.4“[T�‘ş,³Ÿ[wE�‘B X‘Sdirectory“structure],›~upage“15,˜for“a“description“of“the“default“ar-�¡�‘Grangemen�²!t–Ú}of“the“input“ les“that“comprise“the“T�‘ş,³Ÿ[wE�‘B X‘Úpsystem.‘z"The“ le“`Şkpathsea/HIERİ'“is“a�¡�‘Gcop�²!y–¦fof“that“section.�Ÿ¨:��‘Gë]2.2.3.2‘d(Default–íMpath“generation��ŸP�‘!GİThis–¦fsection“describ�MŞes“ho�²!w“the“default“paths“are“constructed.�¦�‘!GY‘ÿeou–B¨ma�²!y“wish“to“ignore“the“whole“mess“and“simply“edit“`Ştexmf.cnfİ'“after“it“is“installed,�¡�‘Gp�MŞerhaps–ŠÍevš²!en“cop˜ying“it“in˜to“place“b�MŞeforehand“so“y˜ou“can“complete“the“installation,‘Ãæif“it�¡�‘Gseems‘¦fnecessary‘ÿe.�¦�‘!GT‘ÿeo–¦fsummarize“the“cš²!hain“of“ev˜en˜ts“that“go“in˜to“de ning“the“default“paths:�¦��‘-1.�‘'¿«`Şconfigureİ'–¦fcreates“a“`ŞMakefileİ'“from“eac�²!h“`ŞMakefile.inİ'.�©B��‘-2.�‘'¿«When–ŒûMak�²!e“runs“in“the“`Şkpathseaİ'“directory‘ÿe,‘’it“creates“a“ le“`Ştexmf.sedİ'“that“substi-�¡�‘'¿«tutes–şpthe“Mak�²!e“v›ÿdDalue“of“Ş$(var)“İfor“a“string“Ş@var@İ.‘åúThe“v˜ariables“in“question“are“the�¡�‘'¿«one–¦fthat“de ne“the“installation“directories.�¦��‘-3.�‘'¿«`Ştexmf.sedİ'–±Ú(together“with“a“little“extra“magic|see“`Şkpathsea/Makefileİ')“is“applied�¡�‘'¿«to–Iº`Ştexmf.inİ'“to“generate“`Ştexmf.cnfİ'.‘¾ùThis“is“the“ le“that“will“ev•²!en“tually–Iºb�MŞe“installed�¡�‘'¿«and‘¦fused.��Œ‹JØ�Ÿò��‘GİChapter‘¦f2:‘İİInstallation’=¤ 7��� ƒ3*� ı ÌÖ��‘-4.�‘'¿«The–=Óde nitions“in“`Ştexmf.cnfİ'“are“recast“as“C‘=¬Ş#defineİ's“in“`Şpaths.hİ'.‘¤#These“v‘ÿdDalues�¤ 33�‘'¿«will–¸ùb�MŞe“the“compile-time“defaults;‘ÂBthey“are“not“used“at“run�²!time“unless“no“`Ştexmf.cnfİ'�¡�‘'¿« le–¦fcan“b�MŞe“found.�Ÿ<<�‘'¿«(That's–£ia“lie:‘Ü^the“compile-time“defaults“are“what“an�²!y“extra“Ş:İ's“in“`Ştexmf.cnfİ'“expand�¡�‘'¿«inš²!to;‘Y�but–Íthe“paths“as“distributed“ha˜v˜e“no“extra“Ş:İ's,‘;§and“there's“no“particular“reason�¡�‘'¿«for–¦fthem“to.)�Ÿ$$��‘Gë]2.2.4‘d(Running‘íMó`߆µT #× cmtt12ë`configure��ŸEE�‘!GİRun›‹Şsh–¦fconfigure“áoptions‘ş„İ(in˜the˜top-lev•²!el˜directory‘ÿe,‘�}the˜one˜con“taining˜`Şkpathsea/İ'),�¡�‘Gp�MŞossibly–¦fusing“a“shell“other“than“Şsh“İ(see“Section“2.2.4.1“[con gure“shells],“page“7).�©EE�‘!GŞconfigure–r®İadapts“the“source“distribution“to“the“presen�²!t“system“via“Ş#defineİ's“in�¡�‘G`Ş*/c-auto.hİ',‘{Úwhic�²!h–êÃare“created“from“the“corresp�MŞonding“`Şc-auto.inİ'.‘ ªõIt“also“creates�¡�‘Ga–vS`ŞMakefileİ'“from“the“corresp�MŞonding“`ŞMakefile.inİ',‘*Ndoing“`Ş@áv‘ÿdDar‘É)Ş@İ'“and“`Şac_includeİ'�¡�‘Gsubstitutions).�¦�‘!GŞconfigure–S•İis“the“b�MŞest“place“to“con�²!trol“the“con guration,–¾àcompilation,“and‘S•installed�¡�‘Glo�MŞcation–·of“the“soft•²!w“are,›Keither–·via“command-line“options,˜or“bš²!y“setting“en˜vironmen˜t“v‘ÿdDari-�¡�‘Gables–º†b�MŞefore“in•²!v“oking–º†it.‘>F‘ÿeor“example,‘¿�yš²!ou“can“disable“Şmktexpk“İb˜y“default“with“the“option�¡�‘G`Ş--disable-mktexpkİ'.‘İİSee–¦fSection“2.2.4.2“[con gure“options],“page“7.�Ÿ$$��‘Gë]2.2.4.1‘d(ë`configure‘íMë]shells��ŸEE�‘!GİConsiderable–$+e ort“has“gone“in�²!to“trying“to“ensure“that“the“Şconfigure“İscripts“can“b�MŞe“run�¡�‘Gbš²!y–7 most“Bourne“shell“v‘ÿdDarian˜ts.‘�ÅShould“Şsh“İrun“in˜to“trouble,‘[1y˜our“bšMŞest“b˜et“is“to“use“Bash,�¡�‘Gthe–¦fGNU“shell“(see“section“\T›ÿeop"“in“áBash“F˜eatures�s‚İ).�¦�‘!GBourne–¦fshell“v‘ÿdDarianš²!ts“for“whic˜h“problems“ha˜v˜e“bšMŞeen“rep˜orted“in“the“past“are:�ŸNN�‘GŞksh‘(‘õİOld–$ˆvš²!ersions“of“the“Korn“shell“ma˜y“fail“to“handle“the“scripts.‘XDThe“Korn“shell�¡�‘Kâ:maš²!y–‘b�MŞe“installed“as“`Ş/bin/shİ'“on“AIX,“in“whic˜h“case“`Ş/bin/bshİ'“ma˜y“serv˜e�¡�‘Kâ:instead.�©EE�‘GŞash‘(‘õİOld–/Òv�²!ersions“of“ash“are“unable“to“handle“the“scripts.‘¶VAsh“is“sometimes“installed�¡�‘Kâ:as–S&`Ş/bin/shİ'“on“NetBSD,“F‘ÿereeBSD,“and“Lin�²!ux“systems.‘Â`Ş/bin/bashİ'“should“b�MŞe�¡�‘Kâ:aš²!v‘ÿdDailable–¦ffor“those“systems,“but“migh˜t“not“b�MŞe“part“of“a“default“installation.�¦�‘GUltrix‘¦fŞ/bin/sh�¡�‘Kâ:İ`Ş/bin/shİ'–®öunder“Ultrix“is“a“DEC-groš²!wn“shell“that“is“notably“de cien˜t“in“man˜y�¡�‘Kâ:w•²!a“ys.‘İİ`Ş/bin/sh5İ'›¦fma“y˜b�MŞe˜necessary‘ÿe.�Ÿ$$��‘Gë]2.2.4.2‘d(ë`configure‘íMë]options��ŸEE�‘!GİF‘ÿeor– ›Áa“complete“list“of“all“Şconfigure“İoptions,‘ Yrun“`Şconfigure‘¦f--helpİ'“or�¡�‘Gsee– �Òsection“\Running“Şconfigure“İscripts"“in“áAuto�MŞconf‘{İ,‘ ê(a“cop�²!y“is“in“the“ le�¡�‘G`Şkpathsea/README.CONFIGUREİ').‘ eThe–~#generic“options“are“listed“ rst“in“the“`Ş--helpİ'�¡�‘Goutput,‘Òand–É]the“pacš²!k‘ÿdDage-sp�MŞeci c“options“come“last.‘FÂThe“en˜vironmen˜t“v‘ÿdDariables“Şconfigure�¡�‘Gİpa•²!ys›¦fatten“tion˜to˜are˜listed˜b�MŞelo“w.�ŸEE�‘!GOptions–r“particularly“likš²!ely“to“b�MŞe“useful“are“`Ş--prefixİ',–¥�`Ş--datadirİ',“and–r“the“lik˜e;‘Ø©see�¡�‘GSection–¦f2.2.4.4“[con gure“scenarios],“page“9.��Œ‹Ym�Ÿò��‘GİChapter‘¦f2:‘İİInstallation’=¤ 8��� ƒ3*� ı ÌÖ�‘!GThis–Êösection“givš²!es“p�MŞoin˜ters“to“descriptions“of“the“`Ş--withİ'“and“`Ş--enableİ'“options“to�¤ 33�‘GŞconfigure–¦fİthat“Kpathsea-using“programs“accept.�©’Å�‘G`Ş--without-mktexmf-defaultİ'�¡�‘G`Ş--without-mktexpk-defaultİ'�¡�‘G`Ş--without-mktextfm-defaultİ'�¡�‘G`Ş--with-mktextex-defaultİ'�¡�‘Kâ:Enable–cor“disable“the“dynamic“generation“programs.‘¯2See“Section“2.2.9.1“[mktex�¡�‘Kâ:con guration],–¦fpage“12.�¦�‘G`Ş--enable-sharedİ'�¡�‘Kâ:Build–LpKpathsea“as“a“shared“library‘ÿe,‘uòand“link“against“it.‘ÏúAlso“build“the“usual�¡�‘Kâ:static–¦flibrary‘ÿe.‘İİSee“Section“2.2.4.5“[Shared“library],“page“9.�¦�‘G`Ş--disable-staticİ'�¡�‘Kâ:Build–¦fonly“the“shared“library‘ÿe.‘İİImplies“`Ş--enable-sharedİ'.�¦�‘G`Ş--enable-maintainer-modeİ'�¡�‘Kâ:Enables–tqmakš²!e“targets“that“are“useful“for“the“main˜tainer“and“lik˜ely“to“b�MŞe“a“pain�¡�‘Kâ:for›oan•²!y“one˜else;‘EÁthe˜mak“e les˜created˜when˜this˜option˜is˜enabled˜ma“y˜not˜w“ork�¡�‘Kâ:at–¦fall“for“yš²!ou.‘İİY‘ÿeou“ha˜v˜e“b�MŞeen“w˜arned.�Ÿ\��‘Gë]2.2.4.3‘d(ë`configure‘íMë]en•–ávironmen“t��Ÿâü�‘!GŞconfigure–»Éİuses“the“v‘ÿdDalue“of“the“folloš²!wing“en˜vironmen˜t“v‘ÿdDariables“in“determining“y˜our�¡�‘Gsystem's–¦fc�²!haracteristics,“and“substitutes“for“them“in“ŞMakefileİ's:�¤B��‘G`ŞCCİ'‘(nY‘ÿeou“maš²!y“need“to“set“this“to“something“lik˜e�¡�‘Kâ:`Ş-I/usr/local/include/wwwhateverİ'–[ if“yš²!ou“ha˜v˜e“the“lib˜www“library“installed�¡�‘Kâ:for–¦fh�²!yp�MŞer-xdvik“(see“`Şxdvik/INSTALLİ').�¦�‘G`ŞDEFSİ'‘¼õAdditional–<#prepro�MŞcessor“options,‘¡’but“not“used“bš²!y“Şconfigureİ.‘ ŸPro˜vided“for�¡�‘Kâ:enabling–G2or“disabling“program“features,‘Zcan“compile“on“mš²!ultiple“arc˜hitectures“sim˜ultaneously“either“b˜y“building“sym˜b�MŞolic�¡�‘'¿«link–şOtrees“with“the“Şlndir“İscript“from“the“X11“distribution,‘TIor“with“the“`Ş--srcdirİ'�¡�‘'¿«option:�¦�‘D¨Şconfigure‘¿ª--srcdir=ásrcdir�Ÿ_Ã��‘ Øæ�‘'¿«İIf–Ÿ6yš²!ou“are“installing“binaries“for“m˜ultiple“arc˜hitectures“in˜to“a“single“hierarc˜h˜y‘ÿe,‘ ¦y˜ou“will�¡�‘'¿«probably›¦fw•²!an“t˜to˜o“v“erride˜the˜default˜`Şbinİ'˜and˜`Şlibİ'˜directories,˜something˜lik“e˜this:�¦�‘D¨Şconfigure‘¿ª--prefix=átexmf–Ş%Ş--datadir=átexmf“Ş\�¤ €�‘P'T--bindir=átexmf–{Ş/áarcš²!hŞ/bin‘¿ª--libdir=átexmf“Ş/áarc˜hŞ/lib�¡�‘D¨make‘¿ªtexmf=átexmf�¤_Ã�‘'¿«İ(Unless–…4yš²!ou“mak˜e“pro˜visions“for“arc˜hitecture-sp�MŞeci c“ les“in“other“w˜a˜ys,–¿ e.g.,“with‘…4Dep�MŞot�Ÿ 33�‘'¿«or–¦fan“automoun�²!ter.)�¡��‘ Øæ�‘'¿«İT‘ÿeo–¦fcompile“with“optimization“(to“compile“without“debugging,“remo•²!v“e–¦fthe“`Ş-gİ'):�¦�‘D¨Şenv–¿ªCFLAGS="-g“-O"“sh“configure�“...��¡�‘'¿«İF‘ÿeor–Ñja“p�MŞotenš²!tial“problem“if“y˜ou“optimize,‘Ü+see“Section“2.6.5.4“[T�‘ş,³Ÿ[wE�‘B X‘Ñ_or“Metafon˜t“failing],�¤ 33�‘'¿«page‘¦f26.�Ÿ²@��‘Gë]2.2.4.5‘d(Shared‘íMlibrary��ŸŒS�‘!GİY‘ÿeou– ¡can“compile“Kpathsea“as“a“shared“library“on“a“few“systems,‘*–b�²!y“sp�MŞecifying“the“option�¡�‘G`Ş--enable-sharedİ'–¦fwhen“y�²!ou“run“`Şconfigureİ'.�©ŒS�‘!GThe–§Vmain“adv‘ÿdDanš²!tage“in“doing“this“is“that“the“executables“can“then“share“the“co�MŞde,‘§’th˜us�¡�‘Gdecreasing–¦fmemory“and“disk“space“requiremen�²!ts.�¦�‘!GOn–}>some“systems,›…zy�²!ou“can“record“the“lo�MŞcation“of“shared“libraries“in“a“binary‘ÿe,˜usually“b�²!y�¡�‘Ggiving–Hócertain“options“to“the“link�²!er.‘¾·Then“individual“users“do“not“need“to“set“their“system's�¡�‘Gen•²!vironmen“t–; v‘ÿdDariable“(e.g.,‘`3ŞLD_LIBRARY_PATHİ)“to“ nd“shared“libraries.‘›ÉIf“yš²!ou“w˜an˜t“to“do�¡�‘Gthis,‘ÿ+yš²!ou–Õ\will“need“to“add“the“necessary“options“to“ŞLDFLAGS“İy˜ourself;‘ for“example,‘ÿ+on“Solaris,�¡�‘Ginclude–>Xsomething“likš²!e“`Ş-R${prefix}/libİ',‘S'on“IRIX‘>=or“Lin˜ux,‘S'use“`Ş-rpath${prefix}/libİ'.�¡�‘G(Unfortunately‘ÿe,‘8Mmaking–Çthis“happ�MŞen“bš²!y“default“is“v˜ery“dicult,‘8Mb�MŞecause“of“in˜teractions“with�¡�‘Gan–¦fexisting“installed“shared“library‘ÿe.)�¦�‘!GCurrenš²!tly‘ÿe,‘zÜshared–P^library“supp�MŞort“is“implemen˜ted“only“on“Lin˜ux,‘zÜSunOS‘P34“(Solaris“1),�¡�‘GSunOS›1€5–1�(Solaris“2),–HùIRIX˜5,“and–1�IRIX˜6.‘¶ğIf“yš²!ou're“in˜terested“and“willing“in“adding“supp�MŞort�¡�‘Gfor–—•other“systems,›š‹please“see“the“`Şconfigureİ'“mo�MŞde“in“the“`Şklibtoolİ'“script,˜esp�MŞecially“the�¡�‘Ghost-sp�MŞeci c–¦fcase“statemen�²!t“around“line“250.��Œ‹ sE�Ÿò��‘GİChapter‘¦f2:‘İİInstallation’8*†10��� ƒ3*� ı ÌÖ��‘Gë]2.2.5‘d(Running‘íMë`make��Ÿ1o�‘!GŞmake–ê0İ(still“in“the“top-lev�²!el“directory).‘©;This“also“creates“the“`Ştexmf.cnfİ'“and“`Şpaths.hİ'�¤ 33�‘G les–·that“de ne“the“default“searcš²!h“paths,‘û@and“(b˜y“default)“the“`Şplainİ'“and“`Şlatexİ'“T�‘ş,³Ÿ[wE�‘B X�¡�‘Gformats.�©1o�‘!GY‘ÿeou–p™can“o•²!v“erride–p™directory“names“and“other“v‘ÿdDalues“at“Şmakeİ-time.‘v™`Şmake/paths.makeİ'“lists�¡�‘Gthe–25v‘ÿdDariables“most“commonly“reset.‘�KF‘ÿeor“example,‘U)`Şmake‘¦fdefault_texsizes=600İ'“c�²!hanges�¡�‘Gthe–¦flist“of“fallbac�²!k“resolutions.�¦�‘!GY‘ÿeou–Ïœcan“also“o•²!v“erride›Ïœeac“h˜of˜Şconfigureİ's˜en“vironmen“t˜v‘ÿdDariables˜(see˜Section˜2.2.4.3�¡�‘G[con gure›¦fen•²!vironmen“t],˜page˜8).‘İİThe˜Mak“e˜v‘ÿdDariables˜ha“v“e˜the˜same˜names.�¦�‘!GFinally‘ÿe,‘¥yš²!ou–¤Àcan“supply“additional“options“via“the“follo˜wing“v‘ÿdDariables.‘İP(Şconfigure“İdo�MŞes�¡�‘Gnot–¦fuse“these.)�©-ç�‘G`ŞXCPPFLAGSİ'�¡�‘G`ŞXDEFSİ'‘ıKPrepro�MŞcessor‘¦foptions.�¦�‘G`ŞXCFLAGSİ'‘ }÷Compiler‘¦foptions.�¦�‘G`ŞXLDFLAGSİ'�¡�‘Kâ:Loader–¦foptions“(included“at“b�MŞeginning“of“link“commands).�¦�‘G`ŞXLOADLIBESİ'�¡�‘Kâ:More–¦floader“options“(included“at“end“of“link“commands).�¦�‘G`ŞXMAKEARGSİ'�¡�‘Kâ:Additional–hÀMakš²!e“argumen˜ts“passed“to“all“sub-Şmakeİ's.‘ÉQY‘ÿeou“ma˜y“need“to“include�¡�‘Kâ:assignmen�²!ts–G£to“the“other“v‘ÿdDariables“here“via“ŞXMAKEARGSİ;‘Afor“example:‘ V`Şmake�¡�‘Kâ:XMAKEARGS="CFLAGS=-O‘¦fXDEFS=-DA4"İ'.�¦�‘!GIt's–³Ñgenerally“a“bad“idea“to“use“a“di eren�²!t“compiler“(`ŞCCİ')“or“libraries“(ŞLIBSİ)“for“compi-�¡�‘Glation–°ûthan“yš²!ou“did“for“con guration,‘³ since“the“v‘ÿdDalues“Şconfigure“İdetermined“ma˜y“then“b�MŞe�¡�‘Gincorrect.�©1o�‘!GAdding–{-compiler“options“to“cš²!hange“the“\univ˜erse"“y˜ou“are“using“(t˜ypically“BSD‘{"vs.“sys-�¡�‘Gtem–°uV)‘°7is“generally“a“cause“of“trouble.‘‹âIt's“b�MŞest“to“use“the“nativš²!e“en˜vironmen˜t,‘á¥whatev˜er“that�¡�‘Gis;‘yÊŞconfigure–c|İand“the“soft•²!w“are–c|usually“adapt“b�MŞest“to“that.‘Ç�In“particular,‘pŞunder“Solaris“2.x,�¡�‘Gyš²!ou–âTshould“not“use“the“BSD-compatibilit˜y“library“(`Şlibucbİ')“or“include“ les“(`Şucbincludeİ').�¦�‘!GIf–.³yš²!ou“w˜an˜t“to“use“the“Bab�MŞel“LaT�‘ş,³Ÿ[wE�‘B X‘.•pac˜k‘ÿdDage“for“supp�MŞort“of“non-English“t˜yp�MŞesetting,‘F¤y˜ou�¡�‘Gneed–ã¼to“mošMŞdify“some“ les“b˜efore“making“the“LaT�‘ş,³Ÿ[wE�‘B X‘ã¬format.‘•ŞSee“the“ le“`Şinstall.txtİ'“in�¡�‘Gthe–¦fBab�MŞel“distribution.�Ÿú´��‘Gë]2.2.6‘d(Installing‘íM les��Ÿ1o�‘!GİThe–%`basic“command“is“the“usual“Şmake‘¦finstallİ.‘ ZÊF‘ÿeor“securit�²!y“issues,‘…see“Section“2.3�¡�‘G[Securit�²!y],–¦fpage“15.�¦�‘!GThe–ÌC rst“time“yš²!ou“install“an˜y“man˜ual“in“the“GNU‘Ì Info“system,‘÷äy˜ou“should“add“a“line“(y˜ou�¡�‘Gcš²!ho�MŞose–^²where)“to“the“ le“`Şdirİ'“in“y˜our“`Ş$(infodir)İ'“directory‘ÿe.‘Å÷Sample“text“for“this“is“giv˜en�¡�‘Gnear–Nthe“top“of“the“T‘ÿeexinfo“source“ les“(`Şkpathsea/kpathsea.texiİ',‘&S`Şdvipsk/dvips.texiİ',�¡�‘Gand–˜`Şweb2c/doc/web2c.texiİ').‘ƒÃIf“yš²!ou“ha˜v˜e“a“recen˜t“v˜ersion“of“the“GNU‘—ÑT‘ÿeexinfo“distribution��Œ‹ €£�Ÿò��‘GİChapter‘¦f2:‘İİInstallation’8*†11��� ƒ3*� ı ÌÖ�‘Ginstalled–‘(Şftp://prep.ai.mit.edu/pub/gnu/texinfo-3.9.tar.gz“İor“later),‘\this“should�¤ 33�‘Ghapp�MŞen‘¦fautomatically‘ÿe.�©‰7�‘!GOn– êthe“o cš²!hance“that“this“is“y˜our“ rst“Info“installation,‘%Kthe“`Şdirİ'“ le“I‘ Ğuse“is“included�¡�‘Gin–¦fthe“distribution“as“`Şetc/dir-exampleİ'.�¦�‘!GY‘ÿeou–üîmaš²!y“wish“to“use“one“of“the“follo˜wing“targets,‘R�esp�MŞecially“if“y˜ou“are“installing“on�¡�‘Gm•²!ultiple‘¦farc“hitectures:�¦��‘ Øæ�‘'¿«Şmake‘¦finstall-exec–¶&İto“install“in“arc•²!hitecture-dep�MŞenden“t›¶&directories,–ºi.e.,“ones˜that˜de-�¡�‘'¿«p�MŞend–¨Ion“the“Ş$(exec_prefix)“İMak�²!e“v‘ÿdDariable.‘ã†This“includes“links“to“binaries,‘¨Âlibraries,�¡�‘'¿«etc.,–¦fnot“just“\executables".�¦��‘ Øæ�‘'¿«Şmake‘¦finstall-data–ä­İto“install“in“arc•²!hitecture-indep�MŞenden“t›ä­directories,‘4?suc“h˜as˜do�MŞcu-�¡�‘'¿«men�²!tation,–¦fcon guration“ les,“p•MŞo“ol–¦f les,“etc.�Ÿ5?�‘!GIf–?“y�²!ou“use“the“Andrew“File“System,›T$the“normal“path“(e.g.,˜ápre x‘Á_İ/bin)“only“gets“y�²!ou“to“a�¡�‘Gread-only–�copš²!y“of“the“ les,‘�æand“y˜ou“m˜ust“sp�MŞecify“a“di eren˜t“path“for“installation.‘Ú½The“b�MŞest�¡�‘Gw•²!a“y–Xµto“do“this“is“b�²!y“setting“the“`Şprefixİ'“v‘ÿdDariable“on“the“Şmake“İcommand“line.‘Ã÷The“sequence�¡�‘Gb�MŞecomes–¦fsomething“lik�²!e“this:�ŸÖ�‘.ùœŞconfigure‘¿ª--prefix=/whatever�¤ €�‘.ùœmake�¡�‘.ùœmake–¿ªinstall“prefix=/afs/.ásystem.name‘�Ş/system/1.3/@sys/whatever�¦�‘GİWith–FmAFS,“yš²!ou“will“de nitely“w˜an˜t“to“use“relativ˜e“ lenames“in“`Şls-Rİ'“(see“Section“3.4�¤ 33�‘G[Filename–µdatabase],›(Épage“34),˜not“absolute“ lenames.‘ËThis“is“done“b�²!y“default,˜but“c•²!hec“k�¡�‘Gan•²!yw“a“y‘ÿe.�Ÿ ��‘Gë]2.2.7‘d(Cleaning‘íMup��Ÿ‰7�‘!GİThe–¦fbasic“command“is“Şmake“distcleanİ.‘İİThis“remo•²!v“es–¦fall“ les“created“b�²!y“the“build.�¦�‘!GAlternativ�²!ely‘ÿe,�¦��‘ Øæ�‘'¿«Şmake‘¦fmostlyclean–BWİif“yš²!ou“in˜tend“to“compile“on“another“arc˜hitecture.‘¼ƒF›ÿeor“W˜eb2C,“since�¡�‘'¿«the–Šigenerated“C‘Šb les“are“p�MŞortable,‘�they“are“not“remo•²!v“ed.‘Ô‰If–Šithe“Şlex“İvs.“Şflex“İsituation�¡�‘'¿«is–¦fgoing“to“b�MŞe“di erenš²!t“on“the“next“mac˜hine,“Şrm“web2c/lex.yy.cİ.�¦��‘ Øæ�‘'¿«Şmake‘¦fclean–y½İto“remo•²!v“e–y½ les“created“bš²!y“compiling,‘î’but“lea˜v˜e“con guration“ les“and�¡�‘'¿«Mak�²!e les.�¦��‘ Øæ�‘'¿«Şmake‘¦fmaintainer-clean–·Ìİto“remo•²!v“e›·Ìev“erything˜that˜the˜Mak“e les˜can˜rebuild.‘This�¡�‘'¿«is–ZÕmore“than“`Şdistcleanİ'“remo•²!v“es,‘‡ğand›ZÕy“ou˜should˜only˜use˜it˜if˜y“ou˜are˜thoroughly�¡�‘'¿«con•²!v“ersan“t–¦fwith“(and“ha•²!v“e–¦fthe“necessary“v�²!ersions“of‘Ú)“Auto�MŞconf.�¦��‘ Øæ�‘'¿«Şmake‘¦fextraclean–ÀLİto“remo•²!v“e–ÀLother“junk,–ÆÅe.g.,“core›ÀL les,“log˜ les,“patc�²!h˜rejects.‘+�This˜is�¡�‘'¿«indep�MŞenden�²!t–¦fof“the“other“`Şcleanİ'“targets.�Ÿ ��‘Gë]2.2.8‘d(Filename–íMdatabase“generation��Ÿ‰7�‘!GİY‘ÿeou–fıwill“probably“w•²!an“t–fıto“set“up“a“Şcron“İenš²!try“on“the“appropriate“mac˜hine(s)“to“rebuild�¡�‘Gthe–¦f lename“database“nigh�²!tly“or“so,“as“in:�ŸÖ�‘.ùœŞ0–¿ª0“*“*“*“cd“átexmf‘Ş%Ş&&“á/bindir‘É)Ş/mktexlsr�¦�‘GİSee–¦fSection“3.4“[Filename“database],“page“34.�¦�‘!GAlthough–L™the“Şmktex�...�‘‹˜İscripts“makš²!e“ev˜ery“e ort“to“add“newly-created“ les“on“the“ y‘ÿe,‘^�it�¡�‘Gcan't–¦fhš²!urt“to“mak˜e“sure“y˜ou“get“a“fresh“v˜ersion“ev˜ery“so“often.��Œ‹ �8�Ÿò��‘GİChapter‘¦f2:‘İİInstallation’8*†12��� ƒ3*� ı ÌÖ��‘Gë]2.2.9‘d(`ë`mktexë]'‘íMscripts��©$$�‘!GİIf–5HKpathsea“cannot“otherwise“ nd“a“ le,‘Yfor“some“ le“tš²!yp�MŞes“it“is“con gured“b˜y“default�¤ 33�‘Gto›ôAin•²!v“ok“e˜an˜external˜program˜to˜create˜it˜dynamically˜(see˜Section˜2.2.9.1˜[mktex˜con g-�¡�‘Guration],›_(page–:412).‘™HThis“is“most“useful“for“fon�²!ts“(bitmaps,˜TFM's,˜and“arbitrarily-sizable�¡�‘GMetafonš²!t–9~sources“suc˜h“as“the“Sauter“and“EC‘9bfon˜ts),‘OFsince“an˜y“giv˜en“do�MŞcumen˜t“can“use“fon˜ts�¡�‘Gnevš²!er–‘ b�MŞefore“referenced.‘Ö¿T‘ÿerying“to“build“all“fon˜ts“in“adv‘ÿdDance“is“therefore“impractical,‘•Qif“not�¡�‘Gimp�MŞossible.�Ÿ$$�‘!GThe–äkscript“is“passed“the“name“of“the“ le“to“create“and“p�MŞossibly“other“argumen�²!ts,‘3ìas�¡�‘Gexplained–ƒZb�MŞeloš²!w.‘Ò.It“m˜ust“ec˜ho“the“full“pathname“of“the“ le“it“created“(and“nothing“else)“to�¡�‘Gstandard–¦foutput;“it“can“write“diagnostics“to“standard“error.�ŸÒÒ��‘Gë]2.2.9.1‘d(`ë`mktexë]'‘íMcon guration��¦�‘!GİThe–¨àfolloš²!wing“ le“t˜yp�MŞes“can“run“an“external“program“to“create“missing“ les:‘âĞ`Şpkİ',‘©~`Ştfmİ',�¡�‘G`Şmfİ',–¦f`Ştexİ';“the“scripts“are“named“`Şmktexpkİ',“`Şmktextfmİ',“`Şmktexmfİ',“and“`Şmktextexİ'.�©$$�‘!GIn–·Éthe“absence“of“Şconfigure“İoptions“sp�MŞecifying“otherwise,‘ü!ev�²!erything“but“`Şmktextexİ'�¡�‘Gwill–¦fb�MŞe“enabled“bš²!y“default.‘İİThe“Şconfigure“İoptions“to“c˜hange“the“defaults“are:�Ÿpñ�‘.ùœŞ--without-mktexmf-default�¤ €�‘.ùœ--without-mktexpk-default�¡�‘.ùœ--without-mktextfm-default�¡�‘.ùœ--with-mktextex-default�¦�‘!GİThe–ØŞconfigure“İsetting“is“o•²!v“erridden–Øif“the“en•²!vironmen“t–Øv‘ÿdDariable“or“con guration“ le�¤ 33�‘Gv‘ÿdDalue–ƒ˜named“for“the“script“is“set;‘ò1e.g.,‘ºä`ŞMKTEXPKİ'“(see“Section“2.2.9.3“[mktex“script“argu-�¡�‘Gmen�²!ts],–¦fpage“14).�¦�‘!GAs–�²distributed,›• all“the“scripts“source“a“ le“`Ştexmf/web2c/mktex.cnfİ'“if“it“exists,˜so“y�²!ou�¡�‘Gcan›ËÂo•²!v“erride˜v‘ÿdDarious˜defaults.‘”üSee˜`Şmktex.optİ',–÷}for˜instance,“whic�²!h˜de nes˜the˜default˜mo�MŞde,�¡�‘Gresolution,›V7some–3sp�MŞecial“directory“names,˜etc.‘ƒÔIf“yš²!ou“prefer“not“to“c˜hange“the“distributed�¡�‘Gscripts,‘:yš²!ou–Ócan“simply“create“`Şmktex.cnfİ'“with“the“appropriate“de nitions“(y˜ou“do“not�¡�‘Gneed–è°to“create“it“if“yš²!ou“ha˜v˜e“nothing“to“put“in“it).‘¤»`Şmktex.cnfİ'“has“no“sp�MŞecial“syn˜tax;‘ Õit's�¡�‘Gan–3arbitrary“Bourne“shell“script.‘„The“distribution“conš²!tains“a“sample“`Şmktex.cnfİ'“for“y˜ou�¡�‘Gto–¦fcopš²!y“and“mo�MŞdify“as“y˜ou“please“(it“is“not“installed“an˜ywhere).�¦�‘!GIn–\addition,‘i˜yš²!ou“can“con gure“a“n˜um˜b�MŞer“of“features“with“the“ŞMT_FEATURES“İv‘ÿdDariable,�¡�‘Gwhic•²!h›¦fy“ou˜can˜de ne:�¦��‘ Øæ�‘'¿«İin–¦f`Şmktex.optİ',“as“just“men�²!tioned;�¦��‘ Øæ�‘'¿«İbš²!y–¸�editing“the“ le“`Şmktex.optİ',‘½either“b�MŞefore“`Şmake‘¦finstallİ'“(in“the“source“hierarc˜h˜y)�¡�‘'¿«or–¦fafter“(in“the“installed“hierarc•²!h“y);�¦��‘ Øæ�‘'¿«İor–¦fin“the“en•²!vironmen“t.�Ÿ�‘!GIf–5 none“of“the“options“b�MŞeloš²!w“are“enabled,–X´Şmktexpkİ,“Şmktextfmİ,“and–5 Şmktexmf“İfollo˜w“the�¡�‘Gfolloš²!wing–ä�pro�MŞcedure“to“decide“where“fon˜ts“should“b�MŞe“installed.‘�;Find“the“tree“where“the“fon˜t's�¡�‘Gsources–ôĞare,‘Hjand“test“the“p�MŞermissions“of“the“`Şfontsİ'“directory“of“that“tree“to“determine�¡�‘Gwhether–şÿİ'“scripts“install“ les“with“the“same“read“and“write“p�MŞermissions“as“the�¡�‘Gdirectory–r-they“are“installed“in.‘ A2The“executable,–åsgid,“suid,“and–r-sticš²!ky“bits“are“alw˜a˜ys�¡�‘Gcleared.�¦�‘!GAnš²!y–¶0directories“created“b˜y“the“`Şmktex�...�‘>ÿİ'“scripts“ha˜v˜e“the“same“p�MŞermissions“as“their�¡�‘Gparen�²!t–Ü¥directory‘ÿe,›ê5unless“the“Şappendonlydir“İfeature“is“used,˜in“whicš²!h“case“the“stic˜ky“bit“is�¡�‘Galw•²!a“ys‘¦fset.�Ÿ8ã��‘GëT2.4‘™T�‘ıL¨Ÿ32E�‘èdX–f@directory“structure��ŸIô�‘!GİThis–š8section“describ�MŞes“the“default“installation“hierarc•²!h“y–š8of“the“distribution.‘ÙÎIt“conforms�¡�‘Gto–ãìbšMŞoth“the“GNU‘ãİco˜ding“standards“and“the“T�‘ş,³Ÿ[wE�‘B X›ãİdirectory“structure“(TDS)˜standard.‘–pF‘ÿeor�¡�‘Grationale–P¸and“further“explanation,‘aÛplease“see“those“do�MŞcumenš²!ts.‘ÁNThe“GNU‘P¢standard“is“a˜v‘ÿdDail-�¡�‘Gable–©Ûas“Şftp://prep.ai.mit.edu/pub/gnu/standards/standards.texi“İand“mirrors.‘èşİ(England)��Œ‹ݾ�Ÿò��‘GİChapter‘¦f2:‘İİInstallation’8*†18��� ƒ3*� ı ÌÖ�‘GCT‘ÿeAN‘nhas–�manš²!y“mirrors“w˜orldwide;‘KØsee“the“top-lev˜el“ le“`ŞREADME.mirrorsİ'“from“one“of“the�¤ 33�‘Gsites›­;ab�MŞo•²!v“e,–®ğor˜ nger˜Şctan@ftp.tug.orgİ,“or˜see˜Şhttp://www.tug.org/CTAN.sitesİ.‘ò\A‘­9list�¡�‘Gcurrenš²!t–¦fas“of“the“time“of“distribution“is“in“the“top-lev˜el“ le“`Ş./MIRRORİ'.�©A‰�‘!GY›ÿeou–ãKcan“also“access“CT˜AN‘ã;via“the“W˜orld“Wide“W˜eb,–ò„Gopher,“electronic›ãKmail,“or˜NFS.�¡�‘GThe–¦fsame“`ŞREADME.mirrorsİ'“ le“explains“ho�²!w.�¦�‘!GY‘ÿeou–œØwill“need“to“retrievš²!e“some“or“all“of“the“follo˜wing“arc˜hiv˜es,‘�Ádep�MŞending“on“y˜our“needs�¡�‘G(don't–¦fforget“to“set“binary“mo�MŞde“for“ le“transfers):�ŸÈ´�‘G`áCT‘ÿeAN:�%¥Ş/systems/web2c/texmflib.tar.gzİ'�¡�‘Kâ:A›HŠbasic–Höcollection“of“fon�²!ts“(TFM˜ les“only)“and“macro“pac�²!k‘ÿdDages“(including�¡�‘Kâ:T‘ÿeexinfo–ìTand“LaT�‘ş,³Ÿ[wE�‘B X‘ìB2e).‘¯¦It“unpacš²!ks“in˜to“`Ştexmf/İ';‘Jif“y˜ou“c˜hange“the“structure�¡�‘Kâ:of–êçthis“hierarc•²!h“y‘ÿe,‘<y“ou–êçwill“also“ha•²!v“e–êçto“cš²!hange“the“default“searc˜h“paths“(see�¡�‘Kâ:Section–ÿ^2.2.3“[Changing“searcš²!h“paths],‘ Æpage“5).‘¦0It“is“required“unless“y˜ou“already�¡�‘Kâ:ha•²!v“e–=àthese“ les,‘RÈin“whicš²!h“case“y˜ou“should“c˜hange“the“default“paths“as“necessary�¡�‘Kâ:to–¦f nd“them.�©A‰�‘G`áCT‘ÿeAN:�%¥Ş/systems/web2c/web.tar.gzİ'�¡�‘Kâ:The–y4original“WEB‘y)source“ les,‘‚>written“mostly“bš²!y“Don“Kn˜uth.‘ÎÍRequired“unless�¡�‘Kâ:yš²!ou–@already“ha˜v˜e“this“`Şwebİ'“v˜ersion.‘»Á(The“WEB‘?÷sources“c˜hange“irregularly“with�¡�‘Kâ:resp�MŞect–¦fto“W‘ÿeeb2c“itself.)‘İİUnpacš²!ks“in˜to“`Şweb2c-áv˜ersionİ'.�¦�‘G`áCT‘ÿeAN:�%¥Ş/systems/web2c/web2c.tar.gzİ'�¡�‘Kâ:The–¦fW‘ÿeeb2c“system.–İİRequired.“Also–¦funpacš²!ks“in˜to“`Şweb2c-áv˜ersionİ'.�¦�‘G`áCT‘ÿeAN:�%¥Ş/systems/web2c/web2c-etex.tar.gzİ'�¡�‘Kâ:Additions–Ôèto“the“W‘ÿeeb2c“system“for“building“e-T�‘ş,³Ÿ[wE�‘B X.“Optional.‘icUnpacš²!ks“in˜to�¡�‘Kâ:`Şweb2c-áv�²!ersionİ'.�¦�‘G`áCT‘ÿeAN:�%¥Ş/systems/web2c/etexlib.tar.gzİ'�¡�‘Kâ:Additions–Àto“the“texmf“tree“needed“to“build“e-T�‘ş,³Ÿ[wE�‘B X.“Optional.‘*ÃUnpacš²!ks“in˜to�¡�‘Kâ:`Ştexmf/İ'.�¦�‘G`áCT‘ÿeAN:�%¥Ş/systems/web2c/etexdoc.tar.gzİ'�¡�‘Kâ:Do�MŞcumenš²!tation–iWfor“e-T�‘ş,³Ÿ[wE�‘B X‘iHas“an“addition“to“the“texmf“tree.–ɃOptional.“Unpac˜ks�¡�‘Kâ:in�²!to‘¦f`Ştexmf/İ'.�¦�‘G`áCT‘ÿeAN:�%¥Ş/systems/web2c/web2c-omega.tar.gzİ'�¡�‘Kâ:Additions–@to“the“W‘ÿeeb2c“system“for“building“Omega.–ª°Optional.“Unpac•²!ks‘@in“to�¡�‘Kâ:`Şweb2c-áv�²!ersionİ'.�¦�‘G`áCT‘ÿeAN:�%¥Ş/systems/web2c/omegalib.tar.gzİ'�¡�‘Kâ:Additions–7Øto“the“texmf“tree“needed“to“build“Omega.–’2Optional.“Unpac•²!ks‘7Øin“to�¡�‘Kâ:`Ştexmf/İ'.�¦�‘G`áCT‘ÿeAN:�%¥Ş/systems/web2c/omegadoc.tar.gzİ'�¡�‘Kâ:Do�MŞcumenš²!tation–ğfor“Omega“as“an“addition“to“the“texmf“tree.–¡;Optional.“Unpac˜ks�¡�‘Kâ:in�²!to‘¦f`Ştexmf/İ'.�¦�‘G`áCT‘ÿeAN:�%¥Ş/systems/web2c/web2c-pdftex.tar.gzİ'�¡�‘Kâ:Additions–9,to“the“W‘ÿeeb2c“system“for“building“p�MŞdfT�‘ş,³Ÿ[wE�‘B X.“Optional.‘–/Unpacš²!ks“in˜to�¡�‘Kâ:`Şweb2c-áv�²!ersionİ'.��Œ‹êj�Ÿò��‘GİChapter‘¦f2:‘İİInstallation’8*†19��� ƒ3*� ı ÌÖ�‘G`áCT‘ÿeAN:�%¥Ş/systems/web2c/pdftexlib.tar.gzİ'�¤ 33�‘Kâ:Additions–0Gto“the“texmf“tree“needed“to“build“p�MŞdfT�‘ş,³Ÿ[wE�‘B X.“Optional.‘{€Unpacš²!ks“in˜to�¡�‘Kâ:`Ştexmf/İ'.�©Ñ�‘G`áCT‘ÿeAN:�%¥Ş/systems/web2c/pdftexdoc.tar.gzİ'�¡�‘Kâ:Unpac•²!ks›=Òin“to˜`Ştexmf/İ'.‘»Do�MŞcumen“tation˜for˜p�MŞdfT�‘ş,³Ÿ[wE�‘B X‘=¸as˜an˜addition˜to˜the˜texmf�¡�‘Kâ:tree.–İİOptional.“Unpac•²!ks›¦fin“to˜`Ştexmf/İ'.�¦�‘G`áCT‘ÿeAN:�%¥Ş/systems/web2c/texk.tar.gzİ'�¡�‘Kâ:The–ÂÄwš²!eb“and“w˜eb2c“sources,‘ÉÜplus“the“additions“for“w˜eb2c,‘ÉÜplus“the“dvi“driv˜ers�¡�‘Kâ:men•²!tioned›ÍØb�MŞelo“w,‘ù'plus˜extra˜dvi˜driv“ers˜and˜to�MŞols˜not˜pac“k‘ÿdDaged˜separately‘ÿe.‘•®Rec-�¡�‘Kâ:ommended–yáif“yš²!ou“w˜an˜t“to“build“a“complete“system.‘y±Unpac˜ks“in˜to“`Ştexk-áv˜ersionİ'.�¦�‘G`áCT‘ÿeAN:�%¥Ş/systems/web2c/texklib.tar.gzİ'�¡�‘Kâ:The–Tbasic“texmf“tree,› Ïplus“the“additions“for“e-T�‘ş,³Ÿ[wE�‘B X,“Omega,˜and“p�MŞdfT�‘ş,³Ÿ[wE�‘B X.“The�¡�‘Kâ:matcš²!h–¦ffor“texk.tar.gz.‘İİUnpac˜ks“in˜to“`Ştexmf/İ'.�¦�‘G`áCT‘ÿeAN:�%¥Ş/dviware/dvipsk/dvipsk.tar.gzİ'�¡�‘Kâ:D•²!VI-to-P“ostScript›¦ftranslator.‘İİUnpac“ks˜in“to˜`Şdvipsk-áv“ersionİ'.‘İİOptional.�¦�‘G`áCT‘ÿeAN:�%¥Ş/dviware/xdvik/xdvik.tar.gzİ'�¡�‘Kâ:X–¦fwindoš²!w“system“D˜VI“preview˜er.‘İİUnpac˜ks“in˜to“`Şxdvik-áv˜ersionİ'.‘İİOptional.�¦�‘G`áCT‘ÿeAN:�%¥Ş/dviware/dviljk/dviljk.tar.gzİ'�¡�‘Kâ:Dš²!VI-to-PCL–İÀ(HP“LaserJet)–Ştranslator.‘„ÚUnpac˜ks“in˜to“`Şdviljk-áv˜ersionİ'.‘„ÚOp-�¡�‘Kâ:tional.�¦�‘!GAll–»–that“said,‘áthe“originating“host“for“the“soft•²!w“are›»–ab�MŞo“v“e˜is˜`Şftp.tug.orgİ'.‘lY‘ÿeou˜can�¡�‘Gretrievš²!e–¦fthese“distributions“(but“not“m˜uc˜h“else)“from“the“`Ştex/İ'“directory“on“that“host.�ŸlÍ��‘Gë]2.5.2‘d(CD-R�–áOM‘íMdistribution��Ÿ"�‘!GİNumerous–¦forganizations“distribute“v‘ÿdDarious“T�‘ş,³Ÿ[wE�‘B X“CD-R�²!OM's:�©"��‘ Øæ�‘'¿«İTUG,–�ÉUK‘�‘TUG,“and“GUT›ÿeen�²!b�MŞerg“(F˜renc�²!h-spšMŞeaking“T�‘ş,³Ÿ[wE�‘B X‘�‘user“group)“collab˜orated“to�¡�‘'¿«pro�MŞduce–<›the“áT�‘ş,³Ÿ[wE�›B X‘^y˜ou“can“ftp“them“to“Şftp://ftp.tug.org/incoming“İ(that�¡�‘'¿«directory–¦fis“writable,“but“not“readable).�¦��‘ Øæ�‘'¿«İIf–`İyš²!ou“are“sending“a“patc˜h“(do“so“if“y˜ou“can!),‘nÅplease“do“so“in“the“form“of“a“con˜text“di �¡�‘'¿«(`Şdiff‘¦f-cİ')–1¸against“the“original“distribution“source.‘¶øAn�²!y“other“form“of“di “is“either“not�¡�‘'¿«as–¦fcomplete“or“harder“for“me“to“understand.‘İİPlease“also“include“a“`ŞChangeLogİ'“en�²!try‘ÿe.�¦��‘ Øæ�‘'¿«İIf–�mthe“bug“in•²!v“olv“ed–�mis“an“actual“crash“(i.e.,›ˆÒcore“dump),˜it“is“easy“and“useful“to“include�¡�‘'¿«a–Ğqstac�²!k“trace“from“a“debugger“(I›Ğfrecommend“the“GNU˜debugger“GDB,“a�²!v‘ÿdDailable“from�¡�‘'¿«Şftp://prep.ai.mit.edu/pub/gnuİ).‘•¡If–Ͳthe“cause“is“apparen�²!t“(a“ŞNULL“İv‘ÿdDalue“b�MŞeing“deref-�¡�‘'¿«erenced,–q„for›dKexample),“please˜send˜the˜details˜along.‘ÇÔIf˜the˜program˜in•²!v“olv“ed˜is˜T�‘ş,³Ÿ[wE�‘B X‘d:or�¡�‘'¿«Metafonš²!t,‘QAand–;øthe“crash“is“happ�MŞening“at“apparen˜tly-sound“co�MŞde,–QAho˜w˜ev˜er,“the–;øbug“ma˜y�¡�‘'¿«w�²!ell–Ğßb�MŞe“in“the“compiler,‘Û}rather“than“in“the“program“or“the“library“(see“Section“2.6.5.4�¡�‘'¿«[T�‘ş,³Ÿ[wE�‘B X–¦for“Metafon�²!t“failing],“page“26).�¦��‘ Øæ�‘'¿«İAn�²!y–badditional“information“that“will“bšMŞe“helpful“in“repro˜ducing,–�şdiagnosing,“or‘b xing�¡�‘'¿«the‘¦fbug.��Œ‹q�Ÿò��‘GİChapter‘¦f2:‘İİInstallation’8*†22��� ƒ3*� ı ÌÖ��‘Gë]2.6.2‘d(Mailing‘íMlists��ŸŠF�‘!GİW‘ÿeeb2c–�^and“Kpathsea“in“general“are“discussed“on“the“mailing“list“Ştex-k@mail.tug.orgİ.�© 33�‘GT‘ÿeo–¦fjoin,“email“Ştex-k-request@mail.tug.org“İwith“a“line“consisting“of�Ÿ×�‘.ùœŞsubscribe‘¿ªáy•²!ouŞ@áy“our.preferred.email.address�¤ŠF�‘Gİin–¦fthe“b•MŞo“dy–¦fof“the“message.�¡�‘!GY‘ÿeou–Üdo“not“need“to“join“to“submit“a“rep�MŞort,‘)ƒnor“will“it“a ect“whether“y�²!ou“get“a“re-�¦�‘Gsp�MŞonse.‘ÛŠThere–¥ is“no“Usenet“newsgroup“equiv‘ÿdDalenš²!t“(if“y˜ou“can“b�MŞe“the“one“to“set“this“up,�¦�‘Gemail–_Ù`Ştex-k-requestİ').‘ 6T‘ÿerac“on“the“list“is“fairly“ligh�²!t,‘�6and“is“mainly“bug“rep�MŞorts“and�¦�‘Genhancemenš²!t–†trequests“to“the“soft˜w˜are.‘Ó7The“b�MŞest“w˜a˜y“to“decide“if“y˜ou“w˜an˜t“to“join“or“not“is�¦�‘Gread–¦fsome“of“the“arc•²!hiv“es–¦ffrom“Şftp://ftp.tug.org/mail/archives/tex-k/İ.�¡�‘!GBe› a•²!w“are˜that˜large˜data˜ les˜are˜sometimes˜included˜in˜bug˜rep�MŞorts.‘®pIf˜this˜is˜a˜problem�¦�‘Gfor–¦fy�²!ou,“do“not“join“the“list.�¡�‘!GIf–\’yš²!ou“only“w˜an˜t“announcemen˜ts“of“new“releases,›Šnot“bug“rep�MŞorts“and“discussion,˜join�¦�‘GŞtex-archive@math.utah.edu–¦fİ(via“mail“to“Ştex-archive-request@math.utah.eduİ).�¡�‘!GIf–á]yš²!ou“are“lo�MŞoking“for“general“T�‘ş,³Ÿ[wE�‘B X‘á+help,‘Åsuc˜h“as“ho˜w“to“use“LaT�‘ş,³Ÿ[wE�‘B X,“please“use“the“mailing�¦�‘Glist–ˆÓŞinfo-tex@shsu.edu“İmailing“list,‘Ánwhicš²!h“is“gatew˜a˜y˜ed“to“the“`Şcomp.text.texİ'“Usenet�¦�‘Gnewsgroup–¦f(or“p�MŞost“to“the“newsgroup;“the“gatew•²!a“y–¦fis“bidirectional).�Ÿ®&��‘Gë]2.6.3‘d(Debugging��ŸŠF�‘!GİKpathsea–„™proš²!vides“a“n˜um˜b�MŞer“of“run˜time“debugging“options,‘¾�detailed“b�MŞelo˜w“b˜y“their“names�¦�‘Gand–]:corresp�MŞonding“nš²!umeric“v‘ÿdDalues.‘ÅyWhen“the“ les“y˜ou“expšMŞect“aren't“b˜eing“found,‘kİthe“thing�¦�‘Gto–¦fdo“is“enable“these“options“and“examine“the“output.�¡�‘!GY‘ÿeou–w|can“set“these“with“some“runš²!time“argumen˜t“(e.g.,‘€Ş`Ş-dİ')“to“the“program;‘‡ in“that“case,�¦�‘Gyš²!ou–R¦should“use“the“n˜umeric“v‘ÿdDalues“describšMŞed“in“the“program's“do˜cumenš²!tation“(whic˜h,‘}¶for�¦�‘GDvipsk–Ú@and“Xdvik,‘'6are“di erenš²!t“than“those“b�MŞelo˜w).‘ykIt's“b�MŞest“to“giv˜e“the“`Ş-dİ'“(or“what-�¦�‘Gevš²!er)–‡¦option“ rst,‘�Ìfor“maximal“output.‘Ó�Dvipsk“and“Xdvik“ha˜v˜e“additional“program-sp�MŞeci c�¦�‘Gdebugging–¦foptions“as“w�²!ell.�¡�‘!GY‘ÿeou–΄can“also“set“the“en•²!vironmen“t–΄v‘ÿdDariable“ŞKPATHSEA_DEBUGİ;‘b“in“this“case,‘Œy�²!ou“should�¦�‘Guse–Öthe“n•²!um“b•MŞers›Öb“elo•²!w.‘lãIf˜y“ou˜run˜the˜program˜under˜a˜debugger˜and˜set˜the˜v‘ÿdDariable�¦�‘GŞkpathsea_debugİ,–¦falso“use“the“n•²!um“b•MŞers‘¦fb“elo�²!w.�¡�‘!GIn–fşanš²!y“case,‘—$b˜y“far“the“simplest“v‘ÿdDalue“to“use“is“`Ş-1İ',‘—$whic˜h“will“turn“on“all“debugging�¦�‘Goutput.‘JThis– Šis“usually“b�MŞetter“than“guessing“whic�²!h“particular“v‘ÿdDalues“will“yield“the“output�¦�‘Gy�²!ou‘¦fneed.�¡�‘!GDebugging–Loutput“alw•²!a“ys–Lgo�MŞes“to“standard“error,‘µ}so“y�²!ou“can“redirect“it“easily–ÿe.‘ ÎãF“or�¦�‘Gexample,–¦fin“Bourne-compatible“shells:�Ÿ×�‘.ùœŞdvips–¿ª-d“-1�“...�‘¾S2>/tmp/debug�¡�‘!GİIt–Ô©is“sometimes“helpful“to“run“the“standalone“Kpsewhicš²!h“utilit˜y“(see“Section“3.5“[In˜v˜oking�¦�‘Gkpsewhic�²!h],–¦fpage“36),“instead“of“the“original“program.�¡�‘!GIn–µ�anš²!y“case,‘åºy˜ou“can“ànot‘¿yİuse“the“ànames‘›§İb�MŞelo˜w;‘×y˜ou“m˜ust“alw˜a˜ys“use“someb•MŞo“dy's‘µ�n˜um˜b“ers.�¦�‘G(Sorry–ÿe.)‘İİT“o–¦fset“more“than“one“option,“just“sum“the“correspšMŞonding“n•²!um“b˜ers.��Œ‹#v�Ÿò��‘GİChapter‘¦f2:‘İİInstallation’8*†23��� ƒ3*� ı ÌÖ�‘GŞKPSE_DEBUG_STAT‘¦fİ(1)�¤ 33�‘Kâ:Rep�MŞort–:`Şstatİ'(2)“calls.‘¹¾This“is“useful“for“vš²!erifying“that“y˜our“directory“structure�¡�‘Kâ:is–ô not“forcing“Kpathsea“to“do“man�²!y“additional“ le“tests“(see“Section“2.6.5.2�¡�‘Kâ:[Sloš²!w–“path“searc˜hing],›–ñpage“25,˜and“see“Section“3.3.6“[Sub�MŞdirectory“expansion],�¡�‘Kâ:page–‹_33).‘ÔÛIf“y�²!ou“are“using“an“up-to-date“`Şls-Rİ'“database“(see“Section“3.4“[File-�¡�‘Kâ:name–×Edatabase],›ã}page“34),˜this“should“pro�MŞduce“no“output“unless“a“nonexisten�²!t�¡�‘Kâ: le–¦fthat“mš²!ust“exist“is“searc˜hed“for.�©ÌÌ�‘GŞKPSE_DEBUG_HASH‘¦fİ(2)�¡�‘Kâ:Rep•MŞort›Ô¥lo“okups˜in˜all˜hash˜tables:‘:Z`Şls-Rİ'˜and˜`Şaliasesİ'˜(see˜Section˜3.4˜[File-�¡�‘Kâ:name– database],‘2page“34);‘Mıfonš²!t“aliases“(see“Section“4.3.2“[F‘ÿeon˜tmap],‘2page“44);�¡�‘Kâ:and–•Jcon g“ le“v‘ÿdDalues“(see“Section“3.2.1“[Con g“ les],‘Ñpage“30).‘ª‰Useful“when�¡�‘Kâ:expšMŞected–Ñ/v‘ÿdDalues“are“not“b˜eing“found,–Ûâe.g..,“ le–Ñ/searc�²!hes“are“lo˜oking“at“the“disk�¡�‘Kâ:instead–¦fof“using“`Şls-Rİ'.�¦�‘GŞKPSE_DEBUG_FOPEN‘¦fİ(4)�¡�‘Kâ:RepšMŞort–ï� le“op˜enings“and“closings.‘¹-Esp˜ecially“useful“when“y�²!our“system's“ le�¡�‘Kâ:table–ùcis“full,‘"for“seeing“whicš²!h“ les“ha˜v˜e“bšMŞeen“op˜ened“but“nev�²!er“closed.‘ÖÓIn“case�¡�‘Kâ:y•²!ou›šåw“an“t˜to˜set˜breakp�MŞoin“ts˜in˜a˜debugger:‘ÆÜthis˜w“orks˜b“y˜rede ning˜`Şfopenİ'�¡�‘Kâ:(`Şfcloseİ')–¦fto“b�MŞe“`Şkpse_fopen_traceİ'“(`Şkpse_fclose_traceİ').�¦�‘GŞKPSE_DEBUG_PATHS‘¦fİ(8)�¡�‘Kâ:Rep�MŞort–c®general“path“information“for“eacš²!h“ le“t˜yp�MŞe“Kpathsea“is“ask˜ed“to“searc˜h.�¡�‘Kâ:This–³²is“useful“when“yš²!ou“are“trying“to“trac˜k“do˜wn“ho˜w“a“particular“path“got�¡�‘Kâ:de ned|from›˪`Ştexmf.cnfİ',–÷i`Şconfig.psİ',“an˜en•²!vironmen“t˜v‘ÿdDariable,‘÷ithe˜compile-�¡�‘Kâ:time–Å…default,‘òetc.‘’çThis“is“the“con•²!ten“ts–Å…of“the“Şkpse_format_info_type“İstructure�¡�‘Kâ:de ned–¦fin“`Ştex-file.hİ'.�¦�‘GŞKPSE_DEBUG_EXPAND‘¦fİ(16)�¡�‘Kâ:RepšMŞort–¨±the“directory“list“corresp˜onding“to“eacš²!h“path“elemen˜t“Kpathsea“searc˜hes.�¡�‘Kâ:This–¬*is“only“relev‘ÿdDanš²!t“when“Kpathsea“searc˜hes“the“disk,‘íšsince“`Şls-Rİ'“searc˜hes�¡�‘Kâ:don't–¦flo�MŞok“through“directory“lists“in“this“w•²!a“y‘ÿe.�¦�‘GŞKPSE_DEBUG_SEARCH‘¦fİ(32)�¡�‘Kâ:Rep�MŞort–|ğon“eacš²!h“ le“searc˜h:‘É"the“name“of“the“ le“searc˜hed“for,‘…;the“path“searc˜hed�¡�‘Kâ:in,‘¢+whether–oĞor“not“the“ le“mš²!ust“exist“(when“driv˜ers“searc˜h“for“`Şcmr10.vfİ',‘¢+it�¡�‘Kâ:need–“Qnot“exist),‘—"and“whether“or“not“w�²!e“are“collecting“all“o�MŞccurrences“of“the“ le�¡�‘Kâ:in–J6the“path“(as“with,–s*e.g.,“`Ştexmf.cnfİ'–J6and“`Ştexfonts.mapİ'),‘s*or“just“the“ rst�¡�‘Kâ:(as–Y with“most“lo�MŞokups).‘õÆThis“can“help“y�²!ou“correlate“what“Kpathsea“is“doing�¡�‘Kâ:with–¦fwhat“is“in“y�²!our“input“ le.�¦�‘GŞKPSE_DEBUG_VARS‘¦fİ(64)�¡�‘Kâ:Rep�MŞort–ìåthe“v›ÿdDalue“of“eac�²!h“v˜ariable“Kpathsea“lo�MŞoks“up.‘ This“is“useful“for“v�²!erifying�¡�‘Kâ:that–¦fv›ÿdDariables“do“indeed“obtain“their“correct“v˜alues.�¦�‘GŞGSFTOPK_DEBUG‘¦fİ(128)�¡�‘Kâ:Activ‘ÿdDates–¦fdebugging“prin�²!tout“sp�MŞeci c“to“Şgsftopk“İprogram.�¦�‘GŞMAKETEX_DEBUG‘¦fİ(512)�¡�‘Kâ:If–¶y�²!ou“use“the“optional“Şmktex“İprograms“instead“of“the“traditional“shell“scripts,�¡�‘Kâ:this–e[will“rep�MŞort“the“name“of“the“site“ le“(`Şmktex.cnfİ'“bš²!y“default)“whic˜h“is��Œ‹1¿�Ÿò��‘GİChapter‘¦f2:‘İİInstallation’8*†24��� ƒ3*� ı ÌÖ�‘Kâ:read,›Ãhdirectories–W5created“b�²!y“Şmktexdirİ,˜the“full“path“of“the“`Şls-Rİ'“database�¤ 33�‘Kâ:built–ˆÃbš²!y“Şmktexlsrİ,‘�±fon˜t“map“searc˜hes,›�±ŞMT_FEATURES“İin“e ect,˜parameters“from�¡�‘Kâ:Şmktexnamİ,›*Ê lenames–Padded“b�²!y“Şmktexupdİ,˜and“some“subsidiary“commands“run�¡�‘Kâ:b�²!y–¦fthe“programs.�Ÿ¹ �‘GŞMAKETEX_FINE_DEBUG‘¦fİ(1024)�¡�‘Kâ:When–İçthe“optional“Şmktex“İprograms“are“used,‘ëÇthis“will“prin�²!t“additional“debug-�¡�‘Kâ:ging–¦finfo“from“functions“in�²!ternal“to“these“programs.�Ÿå«�‘!GDebugging–ó×output“from“Kpathsea“is“alw•²!a“ys–ó×written“to“standard“error,‘4and“b�MŞegins“with�¡�‘Gthe–�6string“`Şkdebug:İ'.‘•N(Except“for“hash“table“buc•²!k“ets,‘È*whic“h–�6just“start“with“the“n•²!um“b�MŞer,�¡�‘Gbut– êyš²!ou“can“only“get“that“output“running“under“a“debugger.‘iSee“commen˜ts“at“the“Şhash_�¡�‘Gsummary_only–¦fİv‘ÿdDariable“in“`Şkpathsea/db.cİ'.)�Ÿ²x��‘Gë]2.6.4‘d(Logging��ŸŒo�‘!GİKpathsea–Ìycan“record“the“time“and“ lename“found“for“eacš²!h“successful“searc˜h.‘•9This“ma˜y“b�MŞe�¡�‘Guseful–~åin“ nding“go•MŞo“d–~åcandidates“for“deletion“when“yš²!our“ lesystem“is“full,‘†Ëor“in“disco˜v˜ering�¡�‘Gusage–¦fpatterns“at“y�²!our“site.�©Œo�‘!GT‘ÿeo–�Ado“this,‘È7de ne“the“en•²!vironmen“t–�Aor“con g“ le“v›ÿdDariable“ŞTEXMFLOGİ.‘•mThe“v˜alue“is“the�¡�‘Gname–Knof“the“ le“to“appšMŞend“the“information“to.‘ÌõThe“ le“is“created“if“it“do˜esn't“exist,‘t°and�¡�‘GappšMŞended–¦fto“if“it“do˜es.�¦�‘!GEacš²!h–¡successful“searc˜h“turns“in˜to“one“line“in“the“log“ le:‘”{t˜w˜o“w˜ords“separated“b˜y“a“space.�¡�‘GThe–— rst“wš²!ord“is“the“time“of“the“searc˜h,‘9Áas“the“in˜teger“n˜um˜bšMŞer“of“seconds“since“\the“ep˜o˜c�²!h",�¡�‘Gi.e.,‘3�UTC‘¤midnighš²!t–È1“Jan˜uary“1970“(more“precisely‘ÿe,‘3�the“result“of“the“Ştime“İsystem“call).‘­şThe�¡�‘Gsecond–¦fw�²!ord“is“the“ lename.�¦�‘!GF‘ÿeor–z?example,›ƒafter“Şsetenv–¦fTEXMFLOG“/tmp/logİ,˜running–z?Dvips“on“`Şstory.dviİ'“app�MŞends�¡�‘Gthe–¦ffollo�²!wing“lines:�ŸÙ<�‘.ùœŞ774455887‘¿ª/usr/local/share/texmf/dvips/config.ps�¤ €�‘.ùœ774455887‘¿ª/usr/local/share/texmf/dvips/psfonts.map�¡�‘.ùœ774455888‘¿ª/usr/local/share/texmf/dvips/texc.pro�¡�‘.ùœ774455888‘¿ª/usr/local/share/texmf/fonts/pk/ljfour/public/cm/cmbx10.600pk�¡�‘.ùœ774455889‘¿ª/usr/local/share/texmf/fonts/pk/ljfour/public/cm/cmsl10.600pk�¡�‘.ùœ774455889‘¿ª/usr/local/share/texmf/fonts/pk/ljfour/public/cm/cmr10.600pk�¡�‘.ùœ774455889‘¿ª/usr/local/share/texmf/dvips/texc.pro�¦�‘GİOnly–¦f lenames“that“are“absolute“are“recorded,“to“preservš²!e“some“sem˜blance“of“priv‘ÿdDacy‘ÿe.�¤²x��‘Gë]2.6.5‘d(Common‘íMproblems��©Œo�‘!GİHere–Ù½are“some“common“problems“with“con guration,–&“compilation,“linking,“execution,�Ÿ 33��‘»+.–§‘.“.��¡��‘Gë]2.6.5.1‘d(Unable–íMto“ nd“ les��¦�‘!GİIf–öıa“program“complains“it“cannot“ nd“fonš²!ts“(or“other“input“ les),‘ #an˜y“of“sev˜eral“things�¤ 33�‘Gmighš²!t–!ûb�MŞe“wrong.‘±¹In“an˜y“case,‘ev“en˜if˜it˜is˜a˜leaf.‘Ô7Presumably˜y“ou˜w“ould˜not˜ha“v“e�¡�‘'¿«askš²!ed–¦ffor“the“directory“to“b�MŞe“searc˜hed“for“sub�MŞdirectories“if“y˜ou“didn't“w˜an˜t“it“to“b�MŞe.�¦��‘ Øæ�‘'¿«İIf–¯ïthe“fonš²!ts“(or“whatev˜er)“don't“already“exist,‘²RŞmktexpk“İ(or“Şmktexmf“İor“Şmktextfmİ)“will�¡�‘'¿«try–K@to“create“them.‘ ÌkIf“these“rather“complicated“shell“scripts“fail,‘´vyš²!ou'll“ev˜en˜tually�¡�‘'¿«get–&Ïan“error“message“saš²!ying“something“lik˜e“`ŞCan't–¦ffind“font“áfon˜tname‘�İ'.‘ _The‘&Ïb�MŞest�¡�‘'¿«solution–<"is“to“ x“(or“at“least“rep�MŞort)“the“bug“in“Şmktexpkİ;‘_�the“w�²!ork‘ÿdDaround“is“to“generate�¡�‘'¿«the–m!necessary“fonš²!ts“b˜y“hand“with“Metafon˜t,‘�Ïor“to“grab“them“from“a“CT‘ÿeAN‘lîsite“(see�¡�‘'¿«Section–¦f2.5“[unixtex.ftp],“page“17).�¦��‘ Øæ�‘'¿«İThere–¦fis“a“bug“in“the“library‘ÿe.‘İİSee“Section“2.6“[Rep�MŞorting“bugs],“page“20.�Ÿ°��‘Gë]2.6.5.2‘d(Sloš–áw–íMpath“searc˜hing��ŸÃ3�‘!GİIf–.yš²!our“program“tak˜es“an“excessiv˜ely“long“time“to“ nd“fon˜ts“or“other“input“ les,‘F"but“do�MŞes�¡�‘Gev•²!en“tually–¦fsucceed,“here“are“some“p�MŞossible“culprits:�¦��‘ Øæ�‘'¿«İMost›— lik•²!ely‘ÿe,‘Óîy“ou˜just˜ha“v“e˜a˜lot˜of˜directories˜to˜searc“h,‘Óîand˜that˜tak“es˜a˜noticeable�¡�‘'¿«time.‘¹*The–8Lsolution“is“to“create“and“main�²!tain“a“separate“`Şls-Rİ'“ le“that“lists“all“the“ les�¡�‘'¿«in–îÚyš²!our“main“T�‘ş,³Ÿ[wE�‘B X‘îÇhierarc˜h˜y‘ÿe.›·9See“Section“3.4“[Filename“database],‘÷page“34.˜Kpathsea�¡�‘'¿«alw•²!a“ys–K·uses“`Şls-Rİ'“if“it's“presenš²!t;‘iñthere's“no“need“to“recompile“or“recon gure“an˜y“of“the�¡�‘'¿«programs.�¦��‘ Øæ�‘'¿«İY‘ÿeour›İarecursiv•²!ely-searc“hed˜directories˜(e.g.,–•`Ş/usr/local/share/texmf/fonts//İ'),“con-�¡�‘'¿«tain–Ğva“mixture“of“ les“and“directories.‘\ This“prev•²!en“ts–ĞvKpathsea“from“using“a“useful�¡�‘'¿«optimization–¦f(see“Section“3.3.6“[Sub�MŞdirectory“expansion],“page“33).�¦�‘'¿«It–‡is“bšMŞest“to“ha•²!v“e–‡only“directories“(and“p˜erhaps“a“`ŞREADMEİ')“in“the“upp˜er“lev�²!els“of“the�¡�‘'¿«directory–#structure,‘Bwusing“ŞXmu“İat“all.‘ ¦If“y˜ou“are“compiling“Metafon˜t,‘¤{see“section“\Online“Meta-�¤ 33�‘'¿«fonš²!t–ˆgraphics"“in“áW‘ÿeeb2c‘ªİ.‘ ‚êIf“y˜ou“are“compiling“Xdvi,‘€see“the“Ş-DNOTOOL“İoption“in�¡�‘'¿«`Şxdvik/INSTALLİ'.�©33��‘ Øæ�‘'¿«İIgnore–¦fthe“errors.‘İİThe“binary“runs“ ne“regardless.�Ÿ33�‘!GHere–¦fis“the“information“for“getting“the“t•²!w“o‘¦fpatc“hes:�Ÿ€�‘.ùœP•²!atc“h–¦fID:“100512-02�¤ €�‘.ùœBug–¦fID's:“1086793,“1086912,“1074766�¡�‘.ùœDescription:–¦f4.1.x“Op�MŞenWindoš²!ws“3.0“ŞlibXt“İjum˜b�MŞo“patc˜h�Ÿ�‘.ùœP•²!atc“h–¦fID:“100573-03�¡�‘.ùœBug–¦fID:“1087332�¡�‘.ùœDescription:–¦f4.1.x“Op�MŞenWindoš²!ws“3.0“unde ned“sym˜b�MŞols“when“using“shared“ŞlibXmuİ.�¦�‘!GThe›õÒw•²!a“y˜to˜statically˜link˜with˜ŞlibXmu˜İdep�MŞends˜on˜whether˜y“ou˜are˜using˜a˜Sun˜compiler�¤ 33�‘G(e.g.,–¦fŞccİ)“or“Şgccİ.‘İİIf“the“latter,“alter“the“Şx_libs“İMak�²!e“v‘ÿdDariable“to“include�Ÿ€�‘.ùœŞ-static–¿ª-lXmu“-dynamic�¦�‘!GİIf–¦fy�²!ou“are“using“the“Sun“compiler,“use“`Ş-Bstaticİ'“and“`Ş-Bdynamicİ'.�Ÿ��‘Gë]2.6.5.9‘d(P•–áoin“ter›íMcom“bination˜w“arnings��Ÿ33�‘!GİWhen–şicompiling“with“old“C‘ş?compilers,‘ yš²!ou“ma˜y“get“some“w˜arnings“abšMŞout“\illegal“p˜oin�²!ter�¡�‘Gcom�²!binations".›¤ÕThese–ûOare“spurious;‘4Wjust“ignore“them.˜I‘û#decline“to“clutter“up“the“source“with�¡�‘Gcasts–¦fto“get“rid“of“them.��Œ‹xT�Ÿò��‘GİChapter–¦f3:‘İİPš²!ath“searc˜hing’'Üá29��� ƒ3*� ı ÌÖ��‘GëK3‘ ¸QP–ÿuÂath‘z³searc“hing��ŸzO�‘!GİThis–t¤cš²!hapter“describ�MŞes“the“generic“path“searc˜hing“mec˜hanism“Kpathsea“pro˜vides.‘H–F‘ÿeor�¤ 33�‘Ginformation–Qab�MŞout“searcš²!hing“for“particular“ le“t˜yp�MŞes“(e.g.,–b-T�‘ş,³Ÿ[wE�‘B X‘Q fon˜ts),“see–Qthe“next“c˜hapter.�Ÿ*ª��‘GëT3.1‘™Searc•ŒÌhing‘f@o“v“erview��ŸAl�‘!GİA‘D ásearcš²!h–D"path“İis“a“colon-separated“list“of“ápath“elemen˜tsİ,‘WÉwhic˜h“are“directory“names“with�¡�‘Ga– few“extra“frills.‘¨¾A‘ásearcš²!h“path“can“come“from“(a“com˜bination“of‘Ú)“man˜y“sources;‘<(see“b�MŞelo˜w.�¡�‘GT‘ÿeo–�™lo�MŞok“up“a“ le“`Şfooİ'“along“a“path“`Ş.:/dirİ',‘Ÿ[Kpathsea“c•²!hec“ks›�™eac“h˜elemen“t˜of˜the˜path˜in�¡�‘Gturn:‘İİ rst–¦f`Ş./fooİ',“then“`Ş/dir/fooİ',“returning“the“ rst“matcš²!h“(or“p�MŞossibly“all“matc˜hes).�©Al�‘!GThe–²H\colon"“and“\slash"“men�²!tioned“here“aren't“necessarily“`Ş:İ'“and“`Ş/İ'“on“non-Unix“sys-�¡�‘Gtems.‘İİKpathsea–¦ftries“to“adapt“to“other“op�MŞerating“systems'“con•²!v“en“tions.�¦�‘!GT‘ÿeo›çc•²!hec“k˜a˜particular˜path˜elemen“t˜áeİ,‘7;Kpathsea˜ rst˜sees˜if˜a˜prebuilt˜database˜(see�¡�‘GSection–��3.4“[Filename“database],›’’page“34)“applies“to“áeİ,˜i.e.,˜if“the“database“is“in“a“directory�¡�‘Gthat–†is“a“pre x“of“áeİ.‘|ëIf“so,‘¾the“path“sp�MŞeci cation“is“matcš²!hed“against“the“con˜ten˜ts“of“the�¡�‘Gdatabase.�¦�‘!GIf–Kthe“database“došMŞes“not“exist,‘t-or“do˜es“not“apply“to“this“path“elemenš²!t,‘t-or“con˜tains“no�¡�‘Gmatcš²!hes,‘¡áthe– À lesystem“is“searc˜hed“(if“this“w˜as“not“forbidden“b˜y“the“sp�MŞeci cation“with“`Ş!!İ'�¡�‘Gand–~õif“the“ le“b�MŞeing“searcš²!hed“for“m˜ust“exist).‘g‹Kpathsea“constructs“the“list“of“directories�¡�‘Gthat–F¹corresp�MŞond“to“this“path“elemenš²!t,‘nÍand“then“c˜hec˜ks“in“eac˜h“for“the“ le“b�MŞeing“searc˜hed�¡�‘Gfor.‘:(T‘ÿeo–rhelp“spšMŞeed“future“lo˜okups“of“ les“in“the“same“directory‘ÿe,‘7uthe“directory“in“whic�²!h“a�¡�‘G le–¦fis“found“is“ oated“to“the“top“of“the“directory“list.)�¦�‘!GThe–Vÿ\ le“mš²!ust“exist"“condition“comes“in˜to“pla˜y“with“VF‘Vë les“and“input“ les“read“b˜y“the�¡�‘GT�‘ş,³Ÿ[wE�‘B X‘Œº`Ş\openinİ'–ŒÀcommand.‘ÕPThese“ les“maš²!y“not“exist“(consider“`Şcmr10.vfİ'),‘‘áand“so“it“w˜ould�¡�‘Gb�MŞe–¢�wrong“to“searcš²!h“the“disk“for“them.‘ÒWTherefore,‘á˜if“y˜ou“fail“to“up�MŞdate“`Şls-Rİ'“when“y˜ou�¡�‘Ginstall–¦fa“new“VF“ le,“it“will“nev�²!er“b�MŞe“found.�¦�‘!GEacš²!h–:bpath“elemen˜t“is“c˜hec˜k˜ed“in“turn:‘Ô rst“the“database,‘_`then“the“disk.‘™ĞIf“a“matc˜h“is�¡�‘Gfound,‘÷Cthe–Ëzsearcš²!h“stops“and“the“result“is“returned.‘”äThis“a˜v˜oids“p•MŞossibly-exp“ensiv˜e‘Ëzpro“cessing�¡�‘Gof–±path“sp�MŞeci cations“that“are“nevš²!er“needed“on“a“particular“run.‘Œ(Unless“the“searc˜h“explicitly�¡�‘Grequested–¦fall“matc�²!hes.)�¦�‘!GAlthough–2Åthe“simplest“and“most“common“path“elemen�²!t“is“a“directory“name,‘UİKpathsea�¡�‘Gsupp�MŞorts–!—additional“features“in“searcš²!h“paths:‘Ô?la˜y˜ered“default“v‘ÿdDalues,‘@cen˜vironmen˜t“v‘ÿdDariable�¡�‘Gnames,›Ğ�con g–a° le“v‘ÿdDalues,˜users'“home“directories,˜and“recursivš²!e“sub�MŞdirectory“searc˜hing.�¡�‘GTh•²!us,‘üNw“e›ë sa“y˜that˜Kpathsea˜áexpands‘^¢İa˜path˜elemen“t,‘üNmeaning˜transforming˜all˜the˜magic�¡�‘GspšMŞeci cations–òin�²!to“the“basic“directory“name“or“names.‘ �This“pro˜cess“is“describ˜ed“in“the�¡�‘Gsections–¦fbšMŞelo�²!w.‘İİIt“happ˜ens“in“the“same“order“as“the“sections.�¦�‘!GException–pto“all“of“the“abšMŞo•²!v“e:‘³If–pthe“ lename“b˜eing“searc�²!hed“for“is“absolute“or“explicitly�¡�‘Grelativš²!e,–¦fi.e.,“starts“with“`Ş/İ'“or“`Ş./İ'“or“`Ş../İ',“Kpathsea“simply“c˜hec˜ks“if“that“ le“exists.�¦�‘!GOrdinarily‘ÿe,›’hif–c4Kpathsea“tries“to“access“a“ le“or“directory“that“cannot“b�MŞe“read,˜it“giv�²!es�¡�‘Ga–7wš²!arning.‘QThis“is“so“y˜ou“will“b�MŞe“alerted“to“directories“or“ les“that“acciden˜tally“lac˜k“read�¡�‘Gp�MŞermission–Ï(for“example,‘ÙEa“`Şlost+foundİ').‘WôIf“yš²!ou“prefer“not“to“see“these“w˜arnings,‘ÙEinclude�¡�‘Gthe–¦fv›ÿdDalue“`Şreadableİ'“in“the“ŞTEX_HUSH“İen•²!vironmen“t–¦fv˜ariable“or“con g“ le“v˜alue.�¦�‘!GThis–Í@generic“path“searcš²!hing“algorithm“is“implemen˜ted“in“`Şkpathsea/pathsearch.cİ'.‘RjIt�¡�‘Gis›{emplo•²!y“ed˜b“y˜a˜higher-lev“el˜algorithm˜when˜searc“hing˜for˜a˜ le˜of˜a˜particular˜t“yp�MŞe˜(see�¡�‘GSection–¦f4.2“[File“lošMŞokup],“page“42,“and“Section“4.3“[Glyph“lo˜okup],“page“43).��Œ‹�÷�Ÿò��‘GİChapter–¦f3:‘İİPš²!ath“searc˜hing’'Üá30��� ƒ3*� ı ÌÖ��‘GëT3.2‘™P�ŒÌath‘f@sources��Ÿˆ�‘!GİA‘x¢searcš²!h–x®path“can“come“from“man˜y“sources.‘ΠIn“the“order“in“whic˜h“Kpathsea“uses“them:�Ÿˆ��‘-1.�‘'¿«A‘âEuser-set›âTen•²!vironmen“t˜v‘ÿdDariable,–ñPe.g.,“ŞTEXINPUTSİ.‘‘¨En•²!vironmen“t˜v‘ÿdDariables˜with˜an˜un-�¤ 33�‘'¿«derscore–õ2and“the“program“name“app�MŞended“o•²!v“erride;‘œ˜for‘õ2example,‘HåŞTEXINPUTS_latex�¡�‘'¿«İo•²!v“errides–¦fŞTEXINPUTS“İif“the“program“b�MŞeing“run“is“named“`Şlatexİ'.�©]™��‘-2.�‘'¿«A‘gSprogram-sp�MŞeci c–gccon guration“ le,–sıe.g.,“an–gc`ŞS‘¦f/a:/bİ'“line“in“Dvips'“`Şconfig.psİ'“(see�¡�‘'¿«section–¦f\Con g“ les"“in“áDvips�s‚İ).�¦��‘-3.�‘'¿«A‘�line–·in“a“Kpathsea“con guration“ le“`Ştexmf.cnfİ',–Ëe.g.,“`ŞTEXINPUTS=/c:/dİ'–·(see“b�MŞe-�¡�‘'¿«lo�²!w).�¦��‘-4.�‘'¿«The–¦fcompile-time“default“(sp�MŞeci ed“in“`Şkpathsea/paths.hİ').�Ÿ²f�‘!GY‘ÿeou–~æcan“see“eacš²!h“of“these“v‘ÿdDalues“for“a“giv˜en“searc˜h“path“b˜y“using“the“debugging“options�¡�‘G(see–¦fSection“2.6.3“[Debugging],“page“22).�©ˆ�‘!GThese–Csources“maš²!y“b�MŞe“com˜bined“via“default“expansion“(see“Section“3.3.1“[Default“expan-�¡�‘Gsion],–¦fpage“31).�Ÿ©™��‘Gë]3.2.1‘d(Con g‘íM les��Ÿˆ�‘!GİAs–rÅmenš²!tioned“ab�MŞo˜v˜e,‘}Kpathsea“reads“árun˜time“con guration“ les‘æGİnamed“`Ştexmf.cnfİ'“for�¡�‘Gsearcš²!h–B‡path“and“other“de nitions.‘¼“The“searc˜h“path“used“to“lo�MŞok“for“these“con guration“ les�¡�‘Gis–4ğnamed“ŞTEXMFCNFİ,›X’and“is“constructed“in“the“usual“w•²!a“y‘ÿe,˜as–4ğdescribšMŞed“ab˜o•²!v“e,‘X’except‘4ğthat�¡�‘Gcon guration–´î les“cannot“b�MŞe“used“to“de ne“the“path,–¸�naturally;‘¼2also,“an–´î`Şls-Rİ'“database“is�¡�‘Gnot–¦fused“to“searc�²!h“for“them.�¦�‘!GKpathsea–³ïreads“àal‘�Fl‘Õ™İ`Ştexmf.cnfİ'“ les“in“the“searc�²!h“path,‘÷Pnot“just“the“ rst“one“found;�¡�‘Gde nitions–$ain“earlier“ les“o•²!v“erride–$athose“in“later“ les.‘²†Thš²!us,‘>bif“the“searc˜h“path“is“`Ş.:$TEXMFİ',�¡�‘Gv‘ÿdDalues–¦ffrom“`Ş./texmf.cnfİ'“o•²!v“erride–¦fthose“from“`Ş$TEXMF/texmf.cnfİ'.�¦�‘!GWhile–£’(or“instead“of‘Ú)“reading“this“description,‘âİyš²!ou“ma˜y“ nd“it“helpful“to“lo�MŞok“at“the�¡�‘Gdistributed–à`Ştexmf.cnfİ',‘mıwhicš²!h“uses“or“at“least“men˜tions“most“features.‘ #JThe“format“of�¡�‘G`Ştexmf.cnfİ'–¦f les“follo�²!ws:�¦��‘ Øæ�‘'¿«İCommenš²!ts–¦fstart“with“`Ş%İ'“and“con˜tin˜ue“to“the“end“of“the“line.�¤]™��‘ Øæ�‘'¿«İBlank–¦flines“are“ignored.�¡��‘ Øæ�‘'¿«İA‘Ğ%`Ş\İ'–Ğ\at“the“end“of“a“line“acts“as“a“con•²!tin“uation›Ğ\c“haracter,–û+i.e.,“the˜next˜line˜is˜app�MŞended.�© 33�‘'¿«Whitespace–¦fat“the“b�MŞeginning“of“con•²!tin“uation–¦flines“is“not“ignored.�¡��‘ Øæ�‘'¿«İEacš²!h–¦fremaining“line“m˜ust“lo�MŞok“lik˜e�Ÿªf�‘D¨áv›ÿdDariable‘\±İ[Ş.–¿ªáprogname‘�İ]“[Ş=İ]“áv˜alue�¡�‘'¿«İwhere–¦fthe“`Ş=İ'“and“surrounding“whitespace“is“optional.�¡��‘ Øæ�‘'¿«İThe–>.áv‘ÿdDariable‘Û5İname“maš²!y“con˜tain“an˜y“c˜haracter“other“than“whitespace,–d`Ş=İ',“or‘>.`Ş.İ',“but�¦�‘'¿«stic�²!king–¦fto“`ŞA-Za-z_İ'“is“safest.�¡��‘ Øæ�‘'¿«İIf–£²`Ş.áprogname‘�İ'“is“presen�²!t,‘ãthe“de nition“only“applies“if“the“program“that“is“running�¦�‘'¿«is–é¡named“(i.e.,‘úpthe“last“comp�MŞonen�²!t“of“Şargv[0]“İis)“áprogname‘†¨İor“`áprognameŞ.exeİ'.‘§�This�¦�‘'¿«allo•²!ws›¦fdi eren“t˜ a“v“ors˜of˜T�‘ş,³Ÿ[wE�‘B X˜to˜ha“v“e˜di eren“t˜searc“h˜paths,˜for˜example.�¡��‘ Øæ�‘'¿«áv‘ÿdDalue‘Àİma•²!y›z¹con“tain˜an“y˜c“haracters˜except˜`Ş%İ'˜and˜`Ş@İ'.‘ ZÕ(These˜restrictions˜are˜only�¦�‘'¿«necessary–ÜÏbšMŞecause“of“the“pro˜cessing“done“on“`Ştexmf.cnfİ'“at“build“time,‘*iso“y�²!ou“can��Œ‹“™�Ÿò��‘GİChapter–¦f3:‘İİPš²!ath“searc˜hing’'Üá31��� ƒ3*� ı ÌÖ�‘'¿«sticš²!k–¿those“c˜haracters“in“after“installation“if“y˜ou“ha˜v˜e“to.)‘1èThe“`Ş$áv‘ÿdDarŞ.áprog‘ğİ'“feature“is�¤ 33�‘'¿«not–²daš²!v‘ÿdDailable“on“the“righ˜t-hand“side;‘¸dinstead,‘µdy˜ou“m˜ust“use“an“additional“v‘ÿdDariable“(see�¡�‘'¿«b�MŞelo�²!w–GŸfor“example).‘Á‡A‘Gu`Ş;İ'“in“áv‘ÿdDalue‘ä¦İis“translated“to“`Ş:İ'“if“running“under“Unix;‘˜;this“is�¡�‘'¿«useful–%*to“write“a“single“`Ştexmf.cnfİ'“whic�²!h“can“bšMŞe“used“under“b˜oth“Unix“and“NT.“(If�¡�‘'¿«yš²!ou–º¸really“w˜an˜t“`Ş;İ''s“in“y˜our“ lenames,‘ÿÌadd“`Ş-DALLOW_SEMICOLON_IN_FILENAMESİ'“to�¡�‘'¿«ŞCFLAGSİ.)�©ı���‘ Øæ�‘'¿«İAll–U¡de nitions“are“read“b�MŞefore“anš²!ything“is“expanded,‘�pso“y˜ou“can“use“v‘ÿdDariables“b�MŞefore�¡�‘'¿«they–¦fare“de ned“(likš²!e“Mak˜e,“unlik˜e“most“other“programs).�ŸÇë�‘GHere–¦fis“a“con guration“ le“fragmenš²!t“illustrating“most“of“these“p�MŞoin˜ts:�ŸJ\�‘.ùœŞ%–¿ªTeX“input“files“--“i.e.,“anything“to“be“found“by“\input“or“\openin“...�¤ €�‘.ùœlatex209_inputs–¿ª=“.:$TEXMF/tex/latex209//:$TEXMF/tex//�¡�‘.ùœlatex2e_inputs–¿ª=“.:$TEXMF/tex/latex//:$TEXMF/tex//�¡�‘.ùœTEXINPUTS–¿ª=“.:$TEXMF/tex//�¡�‘.ùœTEXINPUTS.latex209–¿ª=“$latex209_inputs�¡�‘.ùœTEXINPUTS.latex2e–¿ª=“$latex2e_inputs�¡�‘.ùœTEXINPUTS.latex–¿ª=“$latex2e_inputs�¦�‘!GİAlthough–ÏWthis“format“has“obš²!vious“similarities“to“Bourne“shell“scripts|c˜hange“the“com-�¤ 33�‘Gmen•²!t›Zªc“haracter˜to˜Ş#İ,‘‡ºdisallo“w˜spaces˜around˜the˜Ş=İ,‘‡ºand˜get˜rid˜of˜the˜Ş.áname‘÷±İcon“v“en“tion,�¡�‘Gand–Rit“could“b�MŞe“run“through“the“shell.‘­ÖBut“there“seemed“little“adv‘ÿdDan�²!tage“to“doing“this,‘3#since�¡�‘Gall–‹ßthe“information“wš²!ould“ha˜v˜e“to“passed“bac˜k“to“Kpathsea“and“parsed“there“an˜yw˜a˜y‘ÿe,‘‘-since�¡�‘Gthe–¦fŞsh“İpro�MŞcess“couldn't“a ect“its“parenš²!t's“en˜vironmen˜t.�¦�‘!GThe–¦fimplemen�²!tation“of“all“this“is“in“`Şkpathsea/cnf.cİ'.�Ÿ_��‘GëT3.3‘™P�ŒÌath‘f@expansion��©ı��‘!GİKpathsea– ¶recognizes“certain“sp�MŞecial“cš²!haracters“and“constructions“in“searc˜h“paths,‘,@similar�¡�‘Gto–/Óthat“in“shells.‘¶WAs“a“general“example:‘¢”`Ş~$USER/{foo,bar}//bazİ'“expands“to“all“sub�MŞdirec-�¡�‘Gtories–Æ&under“directories“`Şfooİ'“and“`Şbarİ'“in“Ş$USERİ's“home“directory“that“con�²!tain“a“directory�¡�‘Gor–¦f le“`Şbazİ'.‘İİThese“expansions“are“explained“in“the“sections“b�MŞelo�²!w.�Ÿ_��‘Gë]3.3.1‘d(Default‘íMexpansion��¦�‘!GİIf–Ğ�the“highest-prioritš²!y“searc˜h“path“(see“Section“3.2“[P˜ath“sources],‘Û+page“30)“con˜tains“an�¡�‘Gáextra–´³colon“İ(i.e.,–øEleading,“trailing,“or›´³doubled),“Kpathsea˜inserts˜at˜that˜p�MŞoin�²!t˜the˜next-�¡�‘Ghighest-priorit•²!y›6 searc“h˜path˜that˜is˜de ned.‘�‹If˜that˜inserted˜path˜has˜an˜extra˜colon,‘Z®the�¡�‘Gsame–Rkhapp�MŞens“with“the“next-highest.‘Áß(An“extra“colon“in“the“compile-time“default“v‘ÿdDalue“has�¡�‘Gunpredictable–¦fresults,“so“installers“b�MŞew�²!are.)�¤ı��‘!GF‘ÿeor–¦fexample,“givš²!en“an“en˜vironmen˜t“v‘ÿdDariable“setting�©J\�‘.ùœŞsetenv–¿ªTEXINPUTS“/home/karl:�¡�‘Gİand–¦fa“ŞTEXINPUTS“İv‘ÿdDalue“from“`Ştexmf.cnfİ'“of�¦�‘.ùœŞ.:$TEXMF//tex�¡�‘Gİthen–¦fthe“ nal“v‘ÿdDalue“used“for“searc�²!hing“will“b�MŞe:�¦�‘.ùœŞ/home/karl:.:$TEXMF//tex�¡�‘!GİSince–l%Kpathsea“lo�MŞoks“for“mš²!ultiple“con guration“ les,‘İ”it“w˜ould“bšMŞe“natural“to“exp˜ect�Ÿ 33�‘Gthat–CÒ(for“example)“an“extra“colon“in“`Ş./texmf.cnfİ'“w�²!ould“expand“to“the“path“in��Œ‹ ¡é�Ÿò��‘GİChapter–¦f3:‘İİPš²!ath“searc˜hing’'Üá32��� ƒ3*� ı ÌÖ�‘G`Ş$TEXMF/texmf.cnfİ'.‘~îOr,›é�with–ÜDvips'“con guration“ les,˜that“an“extra“colon“in�¤ 33�‘G`Şconfig.$PRINTERİ'–Nœw�²!ould“expand“to“the“path“in“`Şconfig.psİ'.‘Ö€This“došMŞesn't“happ˜en.‘Ö€It's�¡�‘Gnot–Ǿclear“this“wš²!ould“b�MŞe“desirable“in“all“cases,‘and“trying“to“devise“a“w˜a˜y“to“sp�MŞecify“the�¡�‘Gpath–¦fto“whic�²!h“the“extra“colon“should“expand“seemed“truly“baro�MŞque.�©óÏ�‘!GT‘ÿeec•²!hnicalit“y:‘†Since–öµit“w�²!ould“b�MŞe“useless“to“insert“the“default“v‘ÿdDalue“in“more“than“one“place,�¡�‘GKpathsea–f‹cš²!hanges“only“one“extra“`Ş:İ'“and“lea˜v˜es“an˜y“others“in“place“(they“will“ev˜en˜tually“b�MŞe�¡�‘Gignored).‘İİKpathsea›¦fc•²!hec“ks˜ rst˜for˜a˜leading˜`Ş:İ',˜then˜a˜trailing˜`Ş:İ',˜then˜a˜doubled˜`Ş:İ'.�¦�‘!GY‘ÿeou–Üpcan“trace“this“b�²!y“debugging“\paths"“(see“Section“2.6.3“[Debugging],‘éópage“22).‘üDe-�¡�‘Gfault–¦fexpansion“is“implemen�²!ted“in“the“source“ le“`Şkpathsea/kdefault.cİ'.�Ÿ�8��‘Gë]3.3.2‘d(V‘şÄ£ariable‘íMexpansion��ŸóÏ�‘!Gİ`Ş$fooİ'–ìTor“`Ş${foo}İ'“in“a“path“elemenš²!t“is“replaced“b˜y“(1)“the“v‘ÿdDalue“of“an“en˜vironmen˜t�¡�‘Gv›ÿdDariable–&`Şfooİ'“(if“de ned);‘åØ(2)“the“v˜alue“of“`Şfooİ'“from“`Ştexmf.cnfİ'“(if“de ned);‘åØ(3)“the�¡�‘Gempt�²!y‘¦fstring.�¦�‘!GIf–º�the“cš²!haracter“after“the“`Ş$İ'“is“alphan˜umeric“or“`Ş_İ',‘ÿ—the“v‘ÿdDariable“name“consists“of“all�¡�‘Gconsecutiv•²!e›+suc“h˜c“haracters.‘kşIf˜the˜c“haracter˜after˜the˜`Ş$İ'˜is˜a˜`Ş{İ',‘LIthe˜v‘ÿdDariable˜name˜con-�¡�‘Gsists–Mof“evš²!erything“up“to“the“next“`Ş}İ'“(braces“ma˜y“not“b�MŞe“nested“around“v‘ÿdDariable“names).�¡�‘GOtherwise,–¦fKpathsea“givš²!es“a“w˜arning“and“ignores“the“`Ş$İ'“and“its“follo˜wing“c˜haracter.�¦�‘!GY‘ÿeou–ÁFmš²!ust“quote“the“Ş$İ's“and“braces“as“necessary“for“y˜our“shell.‘.|àShel‘�Fl‘âğİv›ÿdDariable“v˜alues�¡�‘Gcannot–D�b�MŞe“seen“bš²!y“Kpathsea,–li.e.,“ones–D�de ned“b˜y“Şset“İin“C‘DYshells“and“without“Şexport“İin�¡�‘GBourne‘¦fshells.�¦�‘!GF‘ÿeor–¦fexample,“giv�²!en�¤@œ�‘.ùœŞsetenv–¿ªtex“/home/texmf�Ÿ €�‘.ùœsetenv–¿ªTEXINPUTS“.:$tex:${tex}prev�¦�‘Gİthe–¦f nal“ŞTEXINPUTS“İpath“is“the“three“directories:�¡�‘.ùœŞ.:/home/texmf:/home/texmfprev�¦�‘!GİThe–é `Ş.áprogname›�İ'“sux“on“v‘ÿdDariables“and“`Ş_áprogname˜İ'“on“en•²!vironmen“t–é v‘ÿdDariable“names“are�¤ 33�‘Gnot–OMimplemenš²!ted“for“general“v‘ÿdDariable“expansions.‘Ø’These“are“only“recognized“when“searc˜h�¡�‘Gpaths–¦fare“initialized“(see“Section“3.2“[P�²!ath“sources],“page“30).�¦�‘!GV‘ÿeariable–¦fexpansion“is“implemen�²!ted“in“the“source“ le“`Şkpathsea/variable.cİ'.�Ÿ�8��‘Gë]3.3.3‘d(Tilde‘íMexpansion��ŸóÏ�‘!GİA‘àleading–àC`Ş~İ'“in“a“path“elemenš²!t“is“replaced“b˜y“the“v‘ÿdDalue“of“the“en˜vironmen˜t“v‘ÿdDariable“ŞHOMEİ,�¡�‘Gor–¦f`Ş.İ'“if“ŞHOME“İis“not“set.�¦�‘!GA‘âleading–`Ş~áuser‘É)İ'“in“a“path“elemenš²!t“is“replaced“b˜y“áuser‘É)İ's“home“directory“from“the“system�¡�‘G`Şpasswdİ'‘¦fdatabase.�¦�‘!GF‘ÿeor‘¦fexample,�Ÿ@œ�‘.ùœŞsetenv–¿ªTEXINPUTS“~/mymacros:�¦�‘Gİwill–¦fprep�MŞend“a“directory“`Şmymacrosİ'“in“y�²!our“home“directory“to“the“default“path.�¦�‘!GAs–­Ya“sp�MŞecial“case,›¯if“a“home“directory“ends“in“`Ş/İ',˜the“trailing“slash“is“dropp�MŞed,˜to“a•²!v“oid�¡�‘Ginadv•²!erten“tly–ÿ creating“a“`Ş//İ'“construct“in“the“path.‘çËF‘ÿeor“example,‘4if“the“home“directory“of��Œ‹!¯€�Ÿò��‘GİChapter–¦f3:‘İİPš²!ath“searc˜hing’'Üá33��� ƒ3*� ı ÌÖ�‘Gthe–_\user“`Şrootİ'“is“`Ş/İ',›m‘the“path“elemen�²!t“`Ş~root/mymacrosİ'“expands“to“just“`Ş/mymacrosİ',˜not�© 33�‘G`Ş//mymacrosİ'.�¤ 7�‘!GTilde–¦fexpansion“is“implemen�²!ted“in“the“source“ le“`Şkpathsea/tilde.cİ'.�Ÿ‚ ��‘Gë]3.3.4‘d(Brace‘íMexpansion��Ÿ 7�‘!Gİ`Şx{áaŞ,ábš=¦Ş}yİ'–¦fexpands“to“`ŞxáaŞy:xáb˜Şyİ'.‘İİF‘ÿeor“example:�ŸV�‘.ùœŞfoo/{1,2}/baz�¡�‘Gİexpands–ø to“`Şfoo/1/baz:foo/2/bazİ'.‘ÒÊ`Ş:İ'“is“the“path“separator“on“the“curren�²!t“system;‘ Üe.g.,�¦�‘Gon–¦fa“DOS“system,“it's“`Ş;İ'.�¡�‘!GBraces–¦fcan“b�MŞe“nested;“for“example,“`Şx{A,B{1,2}}yİ'“expands“to“`ŞxAy:xB1y:xB2yİ'.�¡�‘!GMultiple–ğÅnon-nested“braces“are“expanded“from“righ�²!t“to“left;‘-Qfor“example,‘`Şx{A,B}{1,2}yİ'�¦�‘Gexpands–¦fto“`Şx{A,B}1y:x{A,B}2yİ',“whic�²!h“expands“to“`ŞxA1y:xB1y:xA2y:xB2:yİ'.�¡�‘!GThis–Dhfeature“can“b�MŞe“used“to“implemenš²!t“m˜ultiple“T�‘ş,³Ÿ[wE�‘B X‘D@hierarc˜hies,‘kèb˜y“assigning“a“brace�¦�‘Glist–¦fto“Ş$TEXMFİ,“as“men�²!tioned“in“`Ştexmf.inİ'.�¡�‘!GY‘ÿeou–zcan“also“use“the“path“separator“in“stead“of“the“comma.‘«9The“last“example“could“ha•²!v“e�¦�‘Gb�MŞeen–¦fwritten“`Şx{A:B}{1:2}yİ'.�¡�‘!GBrace–´ÿİ'“scripts“Section“2.2.9“[mktex“scripts],‘^kpage“12,�¦�‘Gb�MŞecause–¦fthese“cš²!hange“the“w˜orking“directory–ÿe.‘İİY“ou–¦fshould“not“ev˜er“de ne“it“y˜ourself.�¡��‘Gë]3.3.6‘d(Sub�idirectory‘íMexpansion��Ÿ 7�‘!GİTwš²!o–6or“more“consecutiv˜e“slashes“in“a“path“elemen˜t“follo˜wing“a“directory“ád‘¤kİis“replaced“b˜y�¦�‘Gall–Í6subšMŞdirectories“of“ád�nRİ:‘qE rst“those“sub˜directories“directly“under“ádİ,‘ø¦then“the“subsub˜directories�¦�‘Gunder–t7those,‘§«and“so“on.‘GPAš²!t“eac˜h“lev˜el,‘§«the“order“in“whic˜h“the“directories“are“searc˜hed“is�¦�‘GunspšMŞeci ed.‘İİ(It's–¦f\directory“order",“and“de nitely“not“alphab˜etical.)�¤ 7�‘!GIf–â yš²!ou“sp�MŞecify“an˜y“ lename“comp�MŞonen˜ts“after“the“`Ş//İ',‘ğöonly“sub�MŞdirectories“whic˜h“matc˜h�¦�‘Gthose–RZcomp�MŞonenš²!ts“are“included.‘ áºF‘ÿeor“example,‘ıV`Ş/a//bİ'“w˜ould“expand“in˜to“directories�¦�‘G`Ş/a/1/bİ',–¦f`Ş/a/2/bİ',“`Ş/a/1/1/bİ',“and“so“on,“but“not“`Ş/a/b/cİ'“or“`Ş/a/1İ'.�¡�‘!GY‘ÿeou–¦fcan“include“m�²!ultiple“`Ş//İ'“constructs“in“the“path.�¡�‘!G`Ş//İ'–É%at“the“b�MŞeginning“of“a“path“is“ignored;‘æyš²!ou“didn't“really“w˜an˜t“to“searc˜h“ev˜ery“directory�¦�‘Gon–¦fthe“system,“did“y�²!ou?�¡�‘!GI‘+Nshould–+ômenš²!tion“one“related“implemen˜tation“tric˜k,‘ÍVwhic˜h“I›+Nto�MŞok“from“GNU˜ nd.�¦�‘GMatthew–¦fF‘ÿearwš²!ell“suggested“it,“and“Da˜vid“MacKenzie“implemen˜ted“it.�¡�‘!GThe–:øtricš²!k“is“that“in“ev˜ery“real“Unix“implemen˜tation“(as“oppšMŞosed“to“the“POSIX‘:İsp˜eci ca-�¦�‘Gtion),‘€Ña–wldirectory“whicš²!h“con˜tains“no“sub�MŞdirectories“will“ha˜v˜e“exactly“t˜w˜o“links“(namely‘ÿe,‘€Ñone�¦�‘Gfor–è)`Ş.İ'“and“one“for“`Ş..İ').‘£&That“is“to“sa�²!y‘ÿe,‘øšthe“Şst_nlink“İ eld“in“the“`Şstatİ'“structure“will“b�MŞe��Œ‹"¼ñ�Ÿò��‘GİChapter–¦f3:‘İİPš²!ath“searc˜hing’'Üá34��� ƒ3*� ı ÌÖ�‘Gt•²!w“o.‘ DTh“us,‘¸æw“e–µ3don't“ha•²!v“e–µ3to“stat“evš²!erything“in“the“b�MŞottom-lev˜el“(leaf‘Ú)“directories|w˜e“can�¤ 33�‘Gjust›¦fc•²!hec“k˜Şst_nlinkİ,˜notice˜it's˜t“w“o,˜and˜do˜no˜more˜w“ork.�©óß�‘!GBut–Ä0if“yš²!ou“ha˜v˜e“a“directory“that“con˜tains“a“single“sub�MŞdirectory“and“500“regular“ les,�¡�‘GŞst_nlink–÷ İwill“b�MŞe“3,‘ 3and“Kpathsea“has“to“stat“evš²!ery“one“of“those“501“en˜tries.‘ÏÊTherein“lies�¡�‘Gslo�²!wness.�¦�‘!GY‘ÿeou–Ycan“disable“the“tricš²!k“b˜y“unde ning“ŞUNIX_ST_LINK“İin“`Şkpathsea/config.hİ'.‘-¶(It“is�¡�‘Gunde ned–¦fb�²!y“default“except“under“Unix.)�¦�‘!GUnfortunately‘ÿe,‘ˆpin–€ósome“cases“ les“in“leaf“directories“are“Şstatİ'd:‘Ë$if“the“path“sp�MŞeci cation�¡�‘Gis,–“Isaš²!y‘ÿe,“`Ş$TEXMF/fonts//pk//İ',“then–�� les“in“a“sub�MŞdirectory“`�Ş...�‘>ÿ/pkİ',‘“Iev˜en“if“it“is“a“leaf,‘“Iare�¡�‘Gc•²!hec“k“ed.‘ѽThe–‚reason“cannot“b�MŞe“explained“without“reference“to“the“implemen�²!tation,‘‰Lso“read�¡�‘G`Şkpathsea/elt-dirs.cİ'–»(searcš²!h“for“`Şmay‘¦fdescendİ')“if“y˜ou“are“curious.‘°And“if“y˜ou“can“ nd�¡�‘Ga›¦fw•²!a“y˜to˜àsolve‘yİthe˜problem,˜please˜let˜me˜kno“w.�¦�‘!GSub�MŞdirectory–¦fexpansion“is“implemen�²!ted“in“the“source“ le“`Şkpathsea/elt-dirs.cİ'.�ŸB��‘GëT3.4‘™Filename–f@database“(ëWls-RëT)��Ÿóß�‘!GİKpathsea–±®go�MŞes“to“some“lengths“to“minimize“disk“accesses“for“searc�²!hes“(see“Section“3.3.6�¡�‘G[Sub�MŞdirectory–ööexpansion],› page“33).‘Ï�Nev�²!ertheless,˜at“installations“with“enough“directories,�¡�‘Gsearc•²!hing›œˆeac“h˜p�MŞossible˜directory˜for˜a˜giv“en˜ le˜can˜tak“e˜an˜excessiv“ely˜long˜time˜(dep�MŞending�¡�‘Gon–¦fthe“sp�MŞeed“of“the“disk,“whether“it's“NFS-mounš²!ted,“ho˜w“patien˜t“y˜ou“are,“etc.).�¦�‘!GIn–éLpractice,‘a“fonš²!t“tree“con˜taining“the“standard“P˜ostScript“and“PCL‘éfon˜ts“is“large“enough�¡�‘Gfor–jsearcš²!hing“to“b�MŞe“noticeably“slo˜w“on“t˜ypical“systems“these“da˜ys.‘ÉÁTherefore,‘v"Kpathsea“can�¡�‘Guse–íÁan“externally-built“\database"“ le“named“`Şls-Rİ'“that“maps“ les“to“directories,‘?—th�²!us�¡�‘Ga•²!v“oiding–¦fthe“need“to“exhaustivš²!ely“searc˜h“the“disk.�¦�‘!GA‘íqsecond–í„database“ le“`Şaliasesİ'“alloš²!ws“y˜ou“to“giv˜e“additional“names“to“the“ les“listed�¡�‘Gin–¦f`Şls-Rİ'.‘İİThis“can“b�MŞe“helpful“to“adapt“to“\8.3"“ lename“con•²!v“en“tions–¦fin“source“ les.�¦�‘!GThe–¦f`Şls-Rİ'“and“`Şaliasesİ'“features“are“implemen�²!ted“in“the“source“ le“`Şkpathsea/db.cİ'.�ŸB��‘Gë]3.4.1‘d(`ë`ls-Rë]'��Ÿóß�‘!GİAs–Emenš²!tioned“ab�MŞo˜v˜e,‘9¼y˜ou“m˜ust“name“the“main“ lename“database“`Şls-Rİ'.‘?zY‘ÿeou“can“put�¡�‘Gone–¼6at“the“ro�MŞot“of“eacš²!h“T�‘ş,³Ÿ[wE�‘B X‘¼0installation“hierarc˜h˜y“y˜ou“wish“to“searc˜h“(Ş$TEXMF“İb˜y“default);�¡�‘Gmost–øõsites“ha•²!v“e–øõonly“one“hierarc•²!h“y‘ÿe.‘¤ Kpathsea–øõlo�MŞoks“for“`Şls-Rİ'“ les“along“the“ŞTEXMFDBS“İpath,�¡�‘Gso–¦fthat“should“presumably“matcš²!h“the“list“of“hierarc˜hies.�¦�‘!GThe–Š�recommended“w•²!a“y–Š�to“create“and“mainš²!tain“`Şls-Rİ'“is“to“run“the“Şmktexlsr“İscript,‘ÃHwhic˜h�¡�‘Gis–ÿxinstalled“in“`Ş$(bindir)İ'“(`Ş/usr/local/binİ'“b�²!y“default).‘¦8That“script“go�MŞes“to“some“trouble�¡�‘Gto–.9folloš²!w“sym˜b�MŞolic“links“as“necessary‘ÿe,‘P-etc.‘uUIt's“also“in˜v˜ok˜ed“b˜y“the“distributed“`Şmktex�...�‘>ÿİ'�¡�‘Gscripts.�¦�‘!GAš²!t–¦fits“simplest,“though,“y˜ou“can“build“`Şls-Rİ'“with“the“command�Ÿ@¬�‘.ùœŞcd–¿ªá/y�²!our/texmf/ro�MŞot‘üªŞ&&“ls“-LAR“./“>ls-R�¦�‘Gİpresuming–±¨yš²!our“Şls“İpro�MŞduces“the“righ˜t“output“format“(see“the“section“b�MŞelo˜w).‘ÿ¤GNU‘±¥Şlsİ,‘´yfor�¡�‘Gexample,‘#”outputs– ‹in“this“format.‘ KAlso“presuming“y�²!our“Şls“İhasn't“b�MŞeen“aliased“in“a“system�¡�‘G le–¼i(e.g.,›Áê`Ş/etc/profileİ')“to“something“problematic,˜e.g.,˜`Şls‘¦f--color=ttyİ'.‘æIn“that“case,�¡�‘Gyš²!ou–“bwill“ha˜v˜e“to“disable“the“alias“b�MŞefore“generating“`Şls-Rİ'.‘׆F‘ÿeor“the“precise“de nition“of“the�¡�‘G le–¦fformat,“see“Section“3.4.3“[Database“format],“page“35.��Œ‹#Ë"�Ÿò��‘GİChapter–¦f3:‘İİPš²!ath“searc˜hing’'Üá35��� ƒ3*� ı ÌÖ�‘!GRegardless–Fbof“whether“yš²!ou“use“the“supplied“script“or“y˜our“o˜wn,‘Y–y˜ou“will“almost“certainly�¤ 33�‘Gw•²!an“t–ªto“in•²!v“ok“e–ªit“via“Şcronİ,‘$6so“when“yš²!ou“mak˜e“c˜hanges“in“the“installed“ les“(sa˜y“if“y˜ou“install�¡�‘Ga–¦fnew“LaT�‘ş,³Ÿ[wE�‘B X“pac�²!k‘ÿdDage),“`Şls-Rİ'“will“bšMŞe“automatically“up˜dated.�© �‘!GThe–±á`Ş-Aİ'“option“to“Şls“İincludes“ les“b�MŞeginning“with“`Ş.İ'“(except“for“`Ş.İ'“and“`Ş..İ'),‘ô¿suc�²!h�¡�‘Gas–Øthe“ le“`Ş.texİ'“included“with“the“LaT�‘ş,³Ÿ[wE�‘B X‘Àto�MŞols“pac�²!k‘ÿdDage.‘ğ2(On“the“other“hand,‘´àdir–ÿp¹e“ctories�¡�‘Gİwhose–¦fnames“b�MŞegin“with“`Ş.İ'“are“alw•²!a“ys‘¦fignored.)�¦�‘!GIf–¦fy�²!our“system“došMŞes“not“supp˜ort“sym�²!b˜olic“links,“omit“the“`Ş-Lİ'.�¦�‘!GŞls–¦f-LAR“á/yš²!our/texmf/ro�MŞot‘5İwill–øalso“w˜ork.‘ÒáBut“using“`Ş./İ'“a˜v˜oids“em˜b�MŞedding“absolute�¡�‘Gpathnames,‘”lso–�îthe“hierarc•²!h“y–�îcan“bšMŞe“easily“transp˜orted.‘Ö`It“also“a•²!v“oids–�îp˜ossible“trouble“with�¡�‘Gautomounš²!ters–¦for“other“net˜w˜ork“ lesystem“con˜v˜en˜tions.�¦�‘!GKpathsea–]Awš²!arns“y˜ou“if“it“ nds“an“`Şls-Rİ'“ le,‘Ê÷but“the“ le“do�MŞes“not“con˜tain“an˜y“us-�¡�‘Gable–âŒen�²!tries.‘’PThe“usual“culprit“is“running“plain“`Şls›¦f-Rİ'“instead“of“`Şls˜-LR˜./İ'“or“`Şls˜-R�¡�‘Gá/yš²!our/texmf/ro•MŞot�=İ'.‘ ĞAnother‘ ·p“ossibilit˜y– ·is“some“system“directory“name“starting“with“a“`Ş.İ'�¡�‘G(p�MŞerhaps–¦fif“yš²!ou“are“using“AFS);“Kpathsea“ignores“ev˜erything“under“suc˜h“directories.�¦�‘!GBecause–Mthe“database“ma�²!y“b�MŞe“out-of-date“for“a“particular“run,‘v¾if“a“ le“is“not“found“in�¡�‘Gthe–àdatabase,‘6¾bš²!y“default“Kpathsea“go�MŞes“ahead“and“searc˜hes“the“disk.‘8JIf“a“particular“path�¡�‘Gelemenš²!t–Ô›b�MŞegins“with“`Ş!!İ',– (ho˜w˜ev˜er,“àonly‘Ìœİthe–Ô›database“will“b�MŞe“searc˜hed“for“that“elemen˜t,�¡�‘Gnev�²!er–õEthe“disk.‘Ê{If“the“database“došMŞes“not“exist,‘ınothing“will“b˜e“searc�²!hed.‘Ê{Because“this“can�¡�‘Gsurprise–Ñ.users“(\I›Ñ#see“the“fon�²!t“`Şfoo.tfmİ'“when“I˜do“an“Şlsİ;‘æ’wh�²!y“can't“Dvips“ nd“it?"),‘Ûàit“is�¡�‘Gnot–¦fin“anš²!y“of“the“default“searc˜h“paths.�ŸÙ™��‘Gë]3.4.2‘d(Filename‘íMaliases��Ÿ �‘!GİIn–wsome“circumstances,‘êúyš²!ou“ma˜y“wish“to“ nd“a“ le“under“sev˜eral“names.‘F‘ÿeor�¡�‘Gexample,‘©{suppšMŞose–Bwa“T�‘ş,³Ÿ[wE�‘B X‘Bdo˜cumenš²!t“w˜as“created“using“a“DOS‘Bsystem“and“tries“to“read�¡�‘G`Şlongtabl.styİ'.‘4bBut–Ã=no�²!w“it's“b�MŞeing“run“on“a“Unix“system,‘ rand“the“ le“has“its“original�¡�‘Gname,‘Áo`Şlongtable.styİ'.› QöThe–"n le“w�²!on't“b�MŞe“found.˜Y‘ÿeou“need“to“giv�²!e“the“actual“ le�¡�‘G`Şlongtable.styİ'–¦fan“alias“`Şlongtabl.styİ'.�¦�‘!GY‘ÿeou–O±can“handle“this“b�²!y“creating“a“ le“`Şaliasesİ'“as“a“companion“to“the“`Şls-Rİ'“for“the�¡�‘Ghierarc•²!h“y›¸¸con“taining˜the˜ le˜in˜question.‘Ó(Y‘ÿeou˜m“ust˜ha“v“e˜an˜`Şls-Rİ'˜for˜the˜alias˜feature˜to�¡�‘Gw�²!ork.)�¦�‘!GThe–w°format“of“`Şaliasesİ'“is“simple:‘€rt•²!w“o–w°whitespace-separated“w�²!ords“p�MŞer“line;‘àUthe“ rst�¡�‘Gis–-ğthe“real“name“`Şlongtable.styİ',‘OÒand“second“is“the“alias“(`Şlongtabl.styİ').‘t{These“m�²!ust�¡�‘GbšMŞe–ààbase“ lenames,‘ï~with“no“directory“comp˜onenš²!ts.‘�K`Şlongtable.styİ'“m˜ust“b�MŞe“in“the“sibling�¡�‘G`Şls-Rİ'.�¦�‘!GAlso,›Ã8blank–½tlines“and“lines“starting“with“`Ş%İ'“or“`Ş#İ'“are“ignored“in“`Şaliasesİ',˜to“allo�²!w“for�¡�‘Gcommen�²!ts.�¦�‘!GIf–¦fa“real“ le“`Şlongtabl.styİ'“exists,“it“is“used“regardless“of“an�²!y“aliases.�ŸÙ™��‘Gë]3.4.3‘d(Database‘íMformat��Ÿ �‘!GİThe–@-\database"“read“bš²!y“Kpathsea“is“a“line-orien˜ted“ le“of“plain“text.‘»ÊThe“format“is“that�¡�‘Ggenerated–¦fbš²!y“GNU“(and“most“other)“Şls“İprograms“giv˜en“the“`Ş-Rİ'“option,“as“follo˜ws.�¦��‘ Øæ�‘'¿«İBlank–¦flines“are“ignored.��Œ‹$Û�Ÿò��‘GİChapter–¦f3:‘İİPš²!ath“searc˜hing’'Üá36��� ƒ3*� ı ÌÖ��‘ Øæ�‘'¿«İIf–úªa“line“b�MŞegins“with“`Ş/İ'“or“`Ş./İ'“or“`Ş../İ'“and“ends“with“a“colon,‘Oºit's“the“name“of“a�¤ 33�‘'¿«directory‘ÿe.‘İİ(`Ş../İ'–¦flines“aren't“useful,“ho•²!w“ev“er,–¦fand“should“not“b�MŞe“generated.)�©*ø��‘ Øæ�‘'¿«İAll–ß½other“lines“de ne“enš²!tries“in“the“most“recen˜tly“seen“directory‘ÿe.‘‰âŞ/İ's“in“suc˜h“lines“will�¡�‘'¿«pro•MŞduce›¦fp“ossibly-strange˜results.�¦��‘ Øæ�‘'¿«İFiles–¦fwith“no“preceding“directory“line“are“ignored.�Ÿƒ�‘!GF‘ÿeor– \example,‘>Úhere's“the“ rst“few“lines“of“`Şls-Rİ'“(whicš²!h“totals“ab�MŞout“30K‘ =b˜ytes)“on“m˜y�¡�‘Gsystem:�Ÿo‹�‘.ùœŞbibtex�¤ €�‘.ùœdvips�¡�‘.ùœfonts�¡�‘.ùœls-R�¡�‘.ùœmetafont�¡�‘.ùœmetapost�¡�‘.ùœtex�¡�‘.ùœweb2c�©�‘.ùœ./bibtex:�¡�‘.ùœbib�¡�‘.ùœbst�¡�‘.ùœdoc�¦�‘.ùœ./bibtex/bib:�¡�‘.ùœasi.bib�¡�‘.ùœbtxdoc.bib�¡��‘.ùœ...��Ÿ#ÖÚ��‘GëT3.5–™ëWkpsewhichëT:“Standalone–f@path“searc�ŒÌhing��©"¾�‘!GİThe–Kpsewhicš²!h“program“exercises“the“path“searc˜hing“functionalit˜y“indep�MŞenden˜t“of“an˜y�¤ 33�‘Gparticular–ìéapplication.‘±eThis“can“also“bšMŞe“useful“as“a“sort“of“Şfind“İprogram“to“lo˜cate“ les“in�¡�‘Gy•²!our›zT�‘ş,³Ÿ[wE�‘B X‘Qhierarc“hies,‘"vp�MŞerhaps˜in˜administrativ“e˜scripts.‘¦äIt˜is˜used˜hea“vily˜in˜the˜distributed�¡�‘G`Şmktex�...�‘>ÿİ'‘¦fscripts.�¤"¾�‘!GSynopsis:�Ÿo‹�‘.ùœŞkpsewhich‘¿ªáoption�Ş...�‘ş©á lename�‘�Ş...��¡�‘!GİThe–&ıoptions“and“ lename(s)“to“lošMŞok“up“can“b˜e“in�²!termixed.‘³eOptions“can“start“with“either�¤ 33�‘G`Ş-İ'–¦for“`Ş--İ',“and“anš²!y“unam˜biguous“abbreviation“is“accepted.�Ÿß��‘Gë]3.5.1‘d(P•–áath›íMsearc“hing˜options��¦�‘!GİKpsewhicš²!h–�Èlo�MŞoks“up“eac˜h“non-option“argumen˜t“on“the“command“line“as“a“ lename,‘Ÿ�and�¡�‘Greturns–the“ rst“ le“found.‘ ,õThere“is“no“option“to“return“all“the“ les“with“a“particular�¡�‘Gname–5Ë(yš²!ou“can“run“the“Unix“`Şfindİ'“utilit˜y“for“that,‘LPsee“section“\In˜v˜oking“ nd"“in“áGNU‘5® nd�¡�‘Gutilities�s‚İ).�Ÿ"¾�‘!GV‘ÿearious–¦foptions“alter“the“path“searcš²!hing“b�MŞeha˜vior:��Œ‹%êN�Ÿò��‘GİChapter–¦f3:‘İİPš²!ath“searc˜hing’'Üá37��� ƒ3*� ı ÌÖ�‘G`Ş--dpi=án�²!umİ'�¤ 33�‘Kâ:Set–ğÕthe“resolution“to“án�²!umİ;‘– this“only“a ects“`Şgfİ'“and“`Şpkİ'“lo�MŞokups.‘½+`Ş-Dİ'“is“a�¡�‘Kâ:synonš²!ym,–¦ffor“compatibilit˜y“with“Dvips.‘İİDefault“is“600.�Ÿ¸O�‘G`Ş--format=áname‘�İ'�¡�‘Kâ:Set– “the“format“for“lo�MŞokup“to“ánameİ.‘ÛìBy“default,‘¡½the“format“is“guessed“from“the�¡�‘Kâ: lename,‘ù/with–µm`Ştexİ'“b�MŞeing“used“if“nothing“else“ ts.‘ óThe“recognized“ lename�¡�‘Kâ:extensions–¦f(including“anš²!y“leading“`Ş.İ')“are“also“allo˜w˜able“áname‘�İs.�©uÁ�‘Kâ:All–lÚformats“also“ha•²!v“e–lÚa“name,‘�wwhicš²!h“is“the“only“w˜a˜y“to“sp�MŞecify“formats“with�¡�‘Kâ:no–õzasso�MŞciated“sux.‘ËF‘ÿeor“example,‘I?for“Dvips“con guration“ les“y�²!ou“can“use�¡�‘Kâ:`Ş--format="dvips–¦fconfig"İ'.‘İİ(The“quotes“are“for“the“sak�²!e“of“the“shell.)�¦�‘Kâ:Here's–ú the“curren�²!t“list“of“recognized“names“and“the“asso�MŞciated“suxes.‘Ù See�¡�‘Kâ:Section–µ4.1“[Supp�MŞorted“ le“formats],›Èpage“40,˜for“more“information“on“eac�²!h“of�¡�‘Kâ:these.�ŸÂ��‘hÊ�Şgf:‘¿ªgf�¤ €�‘hÊ�pk:‘¿ªpk�¡�‘hÊ�bitmap‘¿ªfont�¡�‘hÊ�afm:‘¿ª.afm�¡�‘hÊ�base:‘¿ª.base�¡�‘hÊ�bib:‘¿ª.bib�¡�‘hÊ�bst:‘¿ª.bst�¡�‘hÊ�cnf:‘¿ª.cnf�¡�‘hÊ�ls-R:‘¿ªls-R�¡�‘hÊ�fmt:‘¿ª.fmt�¡�‘hÊ�map:‘¿ª.map�¡�‘hÊ�mem:‘¿ª.mem�¡�‘hÊ�mf:‘¿ª.mf�¡�‘hÊ�mfpool:‘¿ª.pool�¡�‘hÊ�mft:‘¿ª.mft�¡�‘hÊ�mp:‘¿ª.mp�¡�‘hÊ�mppool:‘¿ª.pool�¡�‘hÊ�MetaPost‘¿ªsupport�¡�‘hÊ�ocp:‘¿ª.ocp�¡�‘hÊ�ofm:–¿ª.ofm“.tfm�¡�‘hÊ�opl:‘¿ª.opl�¡�‘hÊ�otp:‘¿ª.otp�¡�‘hÊ�ovf:‘¿ª.ovf�¡�‘hÊ�ovp:‘¿ª.ovp�¡�‘hÊ�graphic/figure:–¿ª.eps“.epsi�¡�‘hÊ�tex:‘¿ª.tex�¡�‘hÊ�TeX–¿ªsystem“documentation�¡�‘hÊ�texpool:‘¿ª.pool�¡�‘hÊ�TeX–¿ªsystem“sources�¡�‘hÊ�PostScript–¿ªheader/font:“.pro�¡�‘hÊ�Troff‘¿ªfonts�¡�‘hÊ�tfm:‘¿ª.tfm�¡�‘hÊ�type1–¿ªfonts:“.pfa“.pfb�¡�‘hÊ�vf:‘¿ª.vf�¡�‘hÊ�dvips‘¿ªconfig��Œ‹&ò—�Ÿò��‘GİChapter–¦f3:‘İİPš²!ath“searc˜hing’'Üá38��� ƒ3*� ı ÌÖ�‘hÊ�Şist:‘¿ª.ist�¤ €�‘hÊ�truetype–¿ªfonts:“.ttf“.ttc�¡�‘hÊ�type42‘¿ªfonts�¡�‘hÊ�web2c‘¿ªfiles�¡�‘hÊ�other–¿ªtext“files�¡�‘hÊ�other–¿ªbinary“files�Ÿ¬…�‘Kâ:İThis–¦foption“and“`Ş--pathİ'“are“mš²!utually“exclusiv˜e.�©%×�‘G`Ş--interactiveİ'�¤ 33�‘Kâ:After–ï3prošMŞcessing“the“command“line,‘fread“additional“ lenames“to“lo˜ok“up“from�¡�‘Kâ:standard‘¦finput.�¦�‘G`Ş-mktex=á let�²!yp�MŞe‘�İ'�¡�‘G`Ş-no-mktex=á let�²!yp�MŞe‘�İ'�¡�‘Kâ:T‘ÿeurn–saon“or“o “the“`Şmktexİ'“script“assošMŞciated“with“á let�²!yp˜eİ.‘ÌÛThe“only“v‘ÿdDalues“that�¡�‘Kâ:makš²!e–‹asense“for“á let˜yp�MŞe‘(hİare“`Şpkİ',–�È`Şmfİ',“`Ştexİ',“and–‹a`Ştfmİ'.‘ÔÛBy“default,‘�Èall“are“o “in�¡�‘Kâ:Kpsewhic�²!h.‘İİSee–¦fSection“2.2.9“[mktex“scripts],“page“12.�¦�‘G`Ş--mode=ástring‘ğİ'�¡�‘Kâ:Set–Ùthe“mošMŞde“name“to“ástring‘ğİ;‘\“this“also“only“a ects“`Şgfİ'“and“`Şpkİ'“lo˜okups.‘J7No�¡�‘Kâ:default:‘Í´an�²!y–†mošMŞde“will“b˜e“found.‘ÓSee“Section“2.2.9.3“[mktex“script“argumen�²!ts],�¡�‘Kâ:page‘¦f14.�¦�‘G`Ş--must-existİ'�¡�‘Kâ:Do–Yevš²!erything“p�MŞossible“to“ nd“the“ les,‘…Ånotably“including“searc˜hing“the“disk.�¡�‘Kâ:By–¦fdefault,“only“the“`Şls-Rİ'“database“is“c•²!hec“k“ed,–¦fin“the“in�²!terest“of“eciency‘ÿe.�¦�‘G`Ş--path=ástring‘ğİ'�¡�‘Kâ:Searc�²!h–)ëalong“the“path“ástring‘İ(colon-separated“as“usual),‘BĞinstead“of“guessing“the�¡�‘Kâ:searc�²!h–]path“from“the“ lename.‘ĞÚ`Ş//İ'“and“all“the“usual“expansions“are“supp�MŞorted�¡�‘Kâ:(see–ŒLSection“3.3“[P�²!ath“expansion],‘ÅÅpage“31).‘��This“option“and“`Ş--formatİ'“are�¡�‘Kâ:m•²!utually›+3exclusiv“e.‘ lDT‘ÿeo˜output˜the˜complete˜directory˜expansion˜of˜a˜path,�¡�‘Kâ:instead–†(of“doing“a“one-shot“lo�MŞokup,‘¿Îsee“`Ş--expand-pathİ'“in“the“follo�²!wing“section.�¦�‘G`Ş--progname=áname‘�İ'�¡�‘Kâ:Set–·8the“program“name“to“áname‘�İ;‘?¡default“is“`Şkpsewhichİ'.‘SThis“can“a ect“the�¡�‘Kâ:searc�²!h–p»paths“via“the“`Ş.áprognamİ'“feature“in“con guration“ les“(see“Section“3.2.1�¡�‘Kâ:[Con g–¦f les],“page“30).�ŸåI��‘Gë]3.5.2‘d(Auxiliary‘íMtasks��Ÿ%Ø�‘!GİKpsewhic•²!h›¦fpro“vides˜some˜additional˜features˜not˜strictly˜related˜to˜path˜lo�MŞokup:�Ÿ%Ø��‘ Øæ�‘'¿«İ`Ş--debug=ánš²!umİ'–%_sets“the“debugging“options“to“án˜umİ.‘ ZÈSee“Section“2.6.3“[Debugging],�¡�‘'¿«page‘¦f22.�©¬…��‘ Øæ�‘'¿«İ`Ş--expand-braces=ástring‘ğİ'–)+outputs“the“v‘ÿdDariable“and“brace“expansion“of“ástringİ.‘ f-See�¡�‘'¿«Section–¦f3.3“[P�²!ath“expansion],“page“31.�¦��‘ Øæ�‘'¿«İ`Ş--expand-var=ástring‘ğİ'–`?outputs“the“v‘ÿdDariable“expansion“of“ástringİ.‘ iF‘ÿeor“example,‘εthe�¡�‘'¿«`Şmktex�...�‘>ÿİ'–Ç™scripts“run“`Şkpsewhich‘¦f--expand-var='$TEXMF'İ'“to“ nd“the“ro�MŞot“of“the�¡�‘'¿«T�‘ş,³Ÿ[wE�‘B X–¦fsystem“hierarc•²!h“y‘ÿe.‘İİSee–¦fSection“3.3“[P�²!ath“expansion],“page“31.��Œ‹'ùû�Ÿò��‘GİChapter–¦f3:‘İİPš²!ath“searc˜hing’'Üá39��� ƒ3*� ı ÌÖ��‘ Øæ�‘'¿«İ`Ş--expand-path=ástring‘ğİ'–-¾outputs“the“complete“expansion“of“ástring‘Öİas“a“colon-separated�¤ 33�‘'¿«path.‘ <}This–Fis“useful“to“construct“a“searc�²!h“path“for“a“program“that“do�MŞesn't“accept�¡�‘'¿«recursiv�²!e–¦fsubšMŞdirectory“sp˜eci cations.�©33�‘'¿«F‘ÿeor–ުone-shot“uses“of“an“arbitrary“(not“built“in“to“Kpathsea)“path,‘ìºsee“`Ş--pathİ'“in“the�¡�‘'¿«previous‘¦fsection.�¦��‘ Øæ�‘'¿«İ`Ş--show-path=áname‘�İ'–i°shoš²!ws“the“path“that“w˜ould“bšMŞe“used“for“ le“lo˜okups“of“ le“t�²!yp˜e�¡�‘'¿«ánameİ.›àuEither–§Ca“ lename“extension“(`Şpkİ',–§{`Ş.vfİ',“etc.)˜or–§Can“in�²!teger“can“b�MŞe“used,‘§{just“as�¡�‘'¿«with–¦f`Ş--formatİ',“describ�MŞed“in“the“previous“section.�Ÿ��‘Gë]3.5.3‘d(Standard‘íMoptions��Ÿ33�‘!GİKpsewhic�²!h–¦faccepts“the“standard“GNU“options:�¦��‘ Øæ�‘'¿«İ`Ş--helpİ'–¦fprin�²!ts“a“help“message“on“standard“output“and“exits.�¦��‘ Øæ�‘'¿«İ`Ş--versionİ'–¦fprinš²!ts“the“Kpathsea“v˜ersion“n˜um˜b�MŞer“and“exits.��Œ‹(H�Ÿò��‘GİChapter–¦f4:‘İİT�‘ş,³Ÿ[wE�‘B X“supp�MŞort’1¿£40��� ƒ3*� ı ÌÖ��‘GëK4‘ ¸QT�‘üÂcŸ× E�‘ŞX‘z³supp‘Š=ort��Ÿ� �‘!GİAlthough–¦(the“basic“features“in“Kpathsea“can“b�MŞe“used“for“anš²!y“t˜yp�MŞe“of“path“searc˜hing,�¤ 33�‘Git–Úcame“abšMŞout“(lik�²!e“all“libraries)“with“a“sp˜eci c“application“in“mind:‘œÆI‘€wrote“Kpathsea�¡�‘Gsp�MŞeci cally–nYfor“T�‘ş,³Ÿ[wE�‘B X›nJsystem“programs.‘Ë.I˜had“b�MŞeen“struggling“with“the“programs“I˜w�²!as“using�¡�‘G(Dvips,–€ÖXdvi,“and–wrT�‘ş,³Ÿ[wE�‘B X‘wfitself‘Ú)“haš²!ving“sligh˜tly“di eren˜t“notions“of“ho˜w“to“sp�MŞecify“paths;‘‡and�¡�‘Gdebugging–¦fwš²!as“painful,“since“no“co�MŞde“w˜as“shared.�©«Ä�‘!GTherefore,›²½Kpathsea–°Epro�²!vides“some“T�‘ş,³Ÿ[wE�‘B X-sp�MŞeci c“formats“and“features.‘û{Indeed,˜man�²!y“of�¡�‘Gthe–1×supp�MŞosedly“generic“path“searcš²!hing“features“w˜ere“pro˜vided“b�MŞecause“they“seemed“useful�¡�‘Gin–¦fthat“conT�‘ş,³Ÿ[wE�‘B Xt“(fon�²!t“lo�MŞokup,“particularly).�¦�‘!GKpathsea–̺proš²!vides“a“standard“w˜a˜y“to“searc˜h“for“ les“of“an˜y“of“the“supp�MŞorted“ le“t˜yp�MŞes;�¡�‘Gglyph––qfonš²!ts“are“a“bit“di eren˜t“than“all“the“rest.‘Ø‹Searc˜hes“are“based“solely“on“ lenames,‘™¢not�¡�‘G le›¦fcon•²!ten“ts|if˜a˜GF˜ le˜is˜named˜`Şcmr10.600pkİ',˜it˜will˜b�MŞe˜found˜as˜a˜PK˜ le.�Ÿi´��‘GëT4.1‘™Supp�s3orted–f@ le“formats��Ÿ«Ä�‘!GİKpathsea–(`has“suppšMŞort“for“a“n•²!um“b˜er–(`of“ le“t•²!yp˜es.‘³ÛEac“h–(` le“t�²!yp˜e“has“a“list“of“en•²!vironmen“t�¡�‘Gand–GGcon g“ le“v‘ÿdDariables“that“are“c•²!hec“k“ed–GGto“de ne“the“searcš²!h“path,‘ZMand“most“ha˜v˜e“a“default�¡�‘Gsux–:Wthat“pla�²!ys“a“role“in“ nding“ les“(see“the“next“section).‘™¯Some“also“de ne“additional�¡�‘Gsuxes,–¦fand/or“a“program“to“b�MŞe“run“to“create“missing“ les“on“the“ y‘ÿe.�¦�‘!GSince›M;en•²!vironmen“t˜v‘ÿdDariables˜con“taining˜p•MŞerio“ds,–¶ğsuc�²!h˜as˜`ŞTEXINPUTS.latexİ',“are˜not�¡�‘Gallo•²!w“ed–·Êon“some“systems,‘ü"Kpathsea“lo�MŞoks“for“en•²!vironmen“t–·Êv‘ÿdDariables“with“an“underscore,�¡�‘Ge.g.,–¦f`ŞTEXINPUTS_latexİ'“(see“Section“3.2.1“[Con g“ les],“page“30).�¦�‘!GThe–¦ffolloš²!wing“table“lists“the“ab�MŞo˜v˜e“information.�¤$U�‘G`Şafmİ'‘"|Ÿ(Adob�MŞe–†Äfon�²!t“metrics,‘ÀKsee“section“\Metric“ les"“in“áDvips�s‚İ)“ŞAFMFONTSİ;‘æ¦sux“`Ş.afmİ'.�¡�‘G`Şbaseİ'‘¼õ(Metafon�²!t–ƒAmemory“dump,‘ºxsee“section“\Memory“dumps"“in“áW‘ÿeeb2c‘ªİ)“ŞMFBASESİ,�© 33�‘Kâ:ŞTEXMFINIİ;–¦fsux“`Ş.baseİ'.�¡�‘G`Şbibİ'‘"|Ÿ(BibT�‘ş,³Ÿ[wE�‘B X‘9tbibliographš²!y–:`source,‘\see“section“\bibtex“in˜v˜o�MŞcation"“in“áW‘ÿeeb2c‘ªİ)�¦�‘Kâ:ŞBIBINPUTSİ,–¦fŞTEXBIBİ;“sux“`Ş.bibİ'.�¡�‘G`Şbstİ'‘"|Ÿ(BibT�‘ş,³Ÿ[wE�›B X‘Ãst�²!yle–è le,‘0hsee“section“\Basic“BibT�‘ş,³Ÿ[wE�˜X‘Ãst�²!yle“ les"“in“áW‘ÿeeb2c‘ªİ)“ŞBSTINPUTSİ;�¦�‘Kâ:sux‘¦f`Ş.bstİ'.�¡�‘G`Şcnfİ'‘"|Ÿ(Run�²!time–&con guration“ les,›%fsee“Section“3.2.1“[Con g“ les],˜page“30)“ŞTEXMFCNFİ;�¦�‘Kâ:sux‘¦f`Ş.cnfİ'.�¡�‘G`Şdvips‘¦fconfigİ'�¦�‘Kâ:(Dvips–µ`Şconfig.*İ'“ les,›åHsuc�²!h“as“`Şconfig.psİ',˜see“section“\Con g“ les"“in“áDvips�s‚İ)�¦�‘Kâ:ŞTEXCONFIGİ.�¡�‘G`Şfmtİ'‘"|Ÿ(T�‘ş,³Ÿ[wE�‘B X‘%ememory–%Èdump,‘… see“section“\Memory“dumps"“in“áW‘ÿeeb2c‘ªİ)“ŞTEXFORMATSİ,�¦�‘Kâ:ŞTEXMFINIİ;–¦fsux“`Ş.fmtİ'.�¡�‘G`Şgfİ'‘([yš²!ou“can“c˜hange“the“p�MŞolicy“b˜y“setting“the“v‘ÿdDariable“áallo˜w�‘¨/‰x³Hø�–ñ'm˜ultiple�‘¨/‰x³Hø�“suxes�¡�‘Gİto–°ÿáfalse‘Nİeither“in“yš²!our“en˜vironmen˜t“or“in“the“ le“`Ştexmf.cnfİ'.‘ı©In“this“case,‘ó¥if“the“name�¡�‘Glo�MŞokš²!ed–^¸for“has“already“a“sux“(dot“plus“three“c˜haracters),‘ŒÌonly“this“name“will“bšMŞe“lo˜ok�²!ed�¡�‘Gfor,›”Uno–�Ğmatter“if“the“sux“is“kno�²!wn“or“not.‘ÖVIf“the“name“has“no“sux,˜the“searcš²!h“rev˜erts“to�¡�‘Gthe–¦fprevious“p�MŞolicy‘ÿe.�©ú&�‘!GThis–‚|is“implemen�²!ted“in“the“routine“Şkpse_find_file“İin“`Şkpathsea/tex-file.cİ'.‘r Y‘ÿeou�¡�‘Gcan›lFw•²!atc“h˜it˜in˜action˜with˜the˜debugging˜options˜(see˜Section˜2.6.3˜[Debugging],‘wæpage˜22).�Ÿ%ñ_��‘GëT4.3‘™Glyph‘f@lo�s3okup��Ÿú&�‘!GİThis–X·section“describ�MŞes“hoš²!w“Kpathsea“searc˜hes“for“a“bitmap“fon˜t“in“GF›X¤or“PK˜format“(or�¡�‘Geither)–¦fgivš²!en“a“fon˜t“name“(e.g.,“`Şcmr10İ')“and“a“resolution“(e.g.,“600).�¦�‘!GHere–©is“an“outline“of“the“searcš²!h“strategy“(details“in“the“sections“b�MŞelo˜w)“for“a“ le“áname�¡�‘Gİat–¦fresolution“ádpiİ.‘İİThe“searc�²!h“stops“at“the“ rst“successful“lo�MŞokup.�¦��‘-1.�‘'¿«LošMŞok–¦ffor“an“existing“ le“ánameİ.ádpi‘”ƒformat‘ãfİin“the“sp˜eci ed“format(s).�¤–¬��‘-2.�‘'¿«If–¦fáname‘Cmİis“an“alias“for“a“ le“áf‘Äáİin“the“fon�²!tmap“ le“`Ştexfonts.mapİ',“lo�MŞok“for“áfİ.ádpiİ.�¡��‘-3.�‘'¿«Run–Uan“external“program“(tš²!ypically“named“`Şmktexpkİ')“to“generate“the“fon˜t“(see“Sec-�© 33�‘'¿«tion–¦f2.2.9“[mktex“scripts],“page“12)�¡��‘-4.�‘'¿«Lo�MŞok–¦ffor“áfallbacš²!kİ.ádpiİ,“where“áfallbac˜k‘Pjİis“some“last-resort“fon˜t“(t˜ypically“`Şcmr10İ').�ŸÁ�‘!GThis–¦fis“implemen�²!ted“in“Şkpse_find_glyph_format“İin“`Şkpathsea/tex-glyph.cİ'.�Ÿ �å��‘Gë]4.3.1‘d(Basic–íMglyph“lo�iokup��Ÿú&�‘!GİWhen–ğ�Kpathsea“lo�MŞoks“for“a“bitmap“fon�²!t“áname‘�”İat“resolution“ádpi‘…İin“a“format“áformatİ,�¦�‘Git–V rst“c•²!hec“ks›V eac“h˜directory˜in˜the˜searc“h˜path˜for˜a˜ le˜`ánameŞ.ádpi‘”ƒformat�=İ';‘­Şfor˜example,�¦�‘G`Şcmr10.600pkİ'.‘İİKpathsea–¦flo�MŞoks“for“a“PK“ le“ rst,“then“a“GF“ le.�¤ú&�‘!GIf–›Îthat“fails,›ÑKpathsea“lo�MŞoks“for“`Şdpiádpi‘”ƒŞ/ánameŞ.áformat�=İ';‘ô¬for“example,˜`Şdpi600/cmr10.pkİ'.�¦�‘GThis–|Xis“hoš²!w“fon˜ts“are“t˜ypically“stored“on“ lesystems“(suc˜h“as“DOS)‘|Nthat“p�MŞermit“only“three-�¦�‘Gc�²!haracter‘¦fextensions.�¡�‘!GIf–G5that“fails,‘¯hKpathsea“lo�MŞoks“for“a“fon�²!t“with“a“close-enough“ádpiİ.‘ ÀJ\Close“enough"“is�¦�‘Gde ned–*b�²!y“the“macro“ŞKPSE_BITMAP_TOLERANCE“İin“`Şkpathsea/tex-glyph.hİ'“to“b�MŞe“ádpi‘:éŞ/�¦�‘G500–¦f+“1İ.‘ Ÿ3This–‘ƒis“slighš²!tly“more“than“the“0.2%“minim˜um“allo˜w˜ed“b˜y“the“D˜VI‘‘standard�¦�‘G(áCT‘ÿeAN:�%¥Ş/dviware/driv-standard/level-0İ).��Œ‹,0%�Ÿò��‘GİChapter–¦f4:‘İİT�‘ş,³Ÿ[wE�‘B X“supp�MŞort’1¿£44��� ƒ3*� ı ÌÖ��‘Gë]4.3.2‘d(F‘şÄ£on�–átmap��Ÿä’�‘!GİIf–Ğ¥a“bitmap“fon�²!t“or“metric“ le“is“not“found“with“the“original“name“(see“the“previous�¤ 33�‘Gsection),‘ÌÏKpathsea–Å lo�MŞoks“through“anš²!y“áfon˜tmap‘!İ les“for“an“áalias‘8¢İfor“the“original“fon˜t“name.�¡�‘GThese–²¶ les“are“named“`Ştexfonts.mapİ'“and“searcš²!hed“for“along“the“ŞTEXFONTMAPS“İen˜viron-�¡�‘Gmen�²!t/con g–´P le“v‘ÿdDariable.‘�+All“`Ştexfonts.mapİ'“ les“that“are“found“are“read;‘earlier“de nitions�¡�‘Go•²!v“erride–¦flater“ones.�¤ä’�‘!GThis–¦ffeature“is“inš²!tended“to“help“in“t˜w˜o“resp�MŞects:�¡��‘-1.�‘'¿«An–+Galias“name“is“limited“in“length“only“bš²!y“a˜v‘ÿdDailable“memory‘ÿe,‘L€not“b˜y“y˜our“ lesystem.�¤ 33�‘'¿«Therefore,‘ÇÛif–�÷yš²!ou“w˜an˜t“to“ask“for“`ŞTimes-Romanİ'“instead“of“`Şptmrİ',‘ÇÛy˜ou“can“(y˜ou“get�¡�‘'¿«`Şptmr8rİ').�©‹â��‘-2.�‘'¿«A‘Ó{few–Ó±fonš²!ts“ha˜v˜e“historically“had“m˜ultiple“names:‘tƒsp�MŞeci cally‘ÿe,‘ıÕLaT�‘ş,³Ÿ[wE�‘B X's“\circle“fon˜t"“has�¡�‘'¿«v‘ÿdDariously–7Eb�MŞeen“knoš²!wn“as“`Şcircle10İ',–M`Şlcircle10İ',“and–7E`Şlcirc10İ'.‘¸ÒAliases“can“mak˜e“all�¡�‘'¿«the–à0names“equiv‘ÿdDalen�²!t,‘î£so“that“it“no“longer“matters“what“the“name“of“the“installed“ le�¡�‘'¿«is;–¦fT�‘ş,³Ÿ[wE�‘B X“do�MŞcumenš²!ts“will“ nd“their“fa˜v˜orite“name.�Ÿ=A�‘!GThe–¦fformat“of“fonš²!tmap“ les“is“straigh˜tforw˜ard:�Ÿî ��‘ Øæ�‘'¿«İCommenš²!ts–¦fstart“with“`Ş%İ'“and“con˜tin˜ue“to“the“end“of“the“line.�¦��‘ Øæ�‘'¿«İBlank–¦flines“are“ignored.�¦��‘ Øæ�‘'¿«İEac•²!h›óinon“blank˜line˜is˜brok“en˜up˜in“to˜a˜series˜of˜áw“ords�s‚İ:‘wâa˜sequence˜of˜non-whitespace�¡�‘'¿«c�²!haracters.�¦��‘ Øæ�‘'¿«İIf–� the“ rst“wš²!ord“is“`Şincludeİ',‘“¶the“second“w˜ord“is“used“as“a“ lename,‘“¶and“it“is“searc˜hed�¡�‘'¿«for–¦fand“read.�¦��‘ Øæ�‘'¿«İOtherwise,–¦fthe“ rst“wš²!ord“on“eac˜h“line“is“the“true“ lename;�¦��‘ Øæ�‘'¿«İthe–¦fsecond“w�²!ord“is“the“alias;�¦��‘ Øæ�‘'¿«İsubsequen•²!t›¦fw“ords˜are˜ignored.�Ÿ=A�‘!GIf–ıòan“alias“has“an“extension,‘Õit“matc�²!hes“only“those“ les“with“that“extension;‘)¸otherwise,�¡�‘Git–à_matcš²!hes“an˜ything“with“the“same“ro�MŞot,›.Üregardless“of“extension.‘‹ÇF‘ÿeor“example,˜an“alias�¡�‘G`Şfoo.tfmİ'–B¹matcš²!hes“only“when“`Şfoo.tfmİ'“is“b�MŞeing“searc˜hed“for;‘�ãbut“an“alias“`Şfooİ'“matc˜hes�¡�‘G`Şfoo.vfİ',–¦f`Şfoo.600pkİ',“etc.�Ÿä’�‘!GAs–äan“example,‘ónhere“is“an“excerpt“from“the“`Ştexfonts.mapİ'“in“the“W‘ÿeeb2c“distribution.�¡�‘GIt–�êmakš²!es“the“circle“fon˜ts“equiv‘ÿdDalen˜t“and“includes“automatically“generated“maps“for“most�¡�‘GP•²!ostScript›¦ffon“ts˜a“v–ÿdDailable˜from˜v“arious˜fon�²!t˜suppliers.�Ÿ1_�‘.ùœŞcircle10‘-ıPlcircle10�¤ €�‘.ùœcircle10‘-ıPlcirc10�¡�‘.ùœlcircle10‘(=¦circle10�¡�‘.ùœlcircle10‘(=¦lcirc10�¡�‘.ùœlcirc10‘3¼úcircle10�¡�‘.ùœlcirc10‘3¼úlcircle10�¡��‘.ùœ...��¡�‘.ùœinclude‘¿ªadobe.map�¡�‘.ùœinclude‘¿ªapple.map�¡�‘.ùœinclude‘¿ªbitstrea.map�¡��‘.ùœ...���Œ‹->�Ÿò��‘GİChapter–¦f4:‘İİT�‘ş,³Ÿ[wE�‘B X“supp�MŞort’1¿£45��� ƒ3*� ı ÌÖ�‘!GF‘ÿeonš²!tmaps–àare“implemen˜ted“in“the“ le“`Şkpathsea/fontmap.cİ'.‘üKThe“F‘ÿeon˜tname“distribu-�¤ 33�‘Gtion–³has“m•²!uc“h–³more“information“on“fonš²!t“naming“(see“section“\In˜tro�MŞduction"“in“áFilenames�¡�‘Gfor–¦fT�‘ş,³Ÿ[wE�‘B X“fon�²!ts�s‚İ).�Ÿ��‘Gë]4.3.3‘d(F‘şÄ£allbac•–ák‘íMfon“t��©33�‘!GİIf–äa“bitmap“fon�²!t“cannot“bšMŞe“found“or“created“at“the“requested“size,‘4dKpathsea“lo˜oks“for“the�¡�‘Gfonš²!t–ÎÉat“a“set“of“áfallbac˜k“resolutionsİ.‘WY‘ÿeou“sp�MŞecify“these“resolutions“as“a“colon-separated“list�¡�‘G(lik•²!e›Ú€searc“h˜paths).‘z+Kpathsea˜lo•MŞoks˜ rst˜for˜a˜program-sp“eci c˜en•²!vironmen“t˜v‘ÿdDariable˜(e.g.,�¡�‘GŞDVIPSSIZES–™2İfor“Dvipsk),››Öthen“the“en•²!vironmen“t–™2v‘ÿdDariable“ŞTEXSIZESİ,˜then“a“default“sp�MŞeci ed�¡�‘Gat–’›compilation“time“(the“Mak�²!e“v‘ÿdDariable“Şdefault_texsizesİ).‘¢|Y‘ÿeou“can“set“this“list“to“b�MŞe�¡�‘Gemptš²!y–¦fif“y˜ou“prefer“to“ nd“fon˜ts“at“their“stated“size“or“not“at“all.�Ÿ33�‘!GFinally‘ÿe,‘¹if–µXthe“fonš²!t“cannot“b�MŞe“found“ev˜en“at“the“fallbac˜k“resolutions,‘¹Kpathsea“lo�MŞoks“for�¡�‘Ga–dÚfallbacš²!k“fon˜t,‘”wt˜ypically“`Şcmr10İ'.‘9Programs“m˜ust“enable“this“feature“b˜y“assigning“to“the�¡�‘Gglobal–NKv‘ÿdDariable“Şkpse_fallback_font“İor“calling“Şkpse_init_prog“İ(see“Section“5.2“[Calling�¡�‘Gsequence],–¦fpage“46);“the“default“is“no“fallbacš²!k“fon˜t.�Ÿ��‘GëT4.4‘™Suppressing‘f@w�ŒÌarnings��¦�‘!GİKpathsea–mproš²!vides“a“w˜a˜y“to“suppress“selected“usually-harmless“w˜arnings;‘Uñthis“is“useful�¡�‘Gat–›Xlarge“sites“where“most“users“are“not“administrators,‘��and“thš²!us“the“w˜arnings“are“merely“a�¡�‘Gsource–·Ãof“confusion,›ç}not“a“help.‘�RT‘ÿeo“do“this,˜yš²!ou“set“the“en˜vironmen˜t“v‘ÿdDariable“or“con guration�¡�‘G le–¦fv›ÿdDalue“ŞTEX_HUSH“İto“a“colon-separated“list“of“v˜alues.‘İİHere“are“the“p�MŞossibilities:�¤33�‘G`Şallİ'‘"|ŸSuppress–¦fev�²!erything“p�MŞossible.�¡�‘G`Şchecksumİ'�© 33�‘Kâ:Suppress–¦fmismatcš²!hed“fon˜t“c˜hec˜ksum“w˜arnings.�¡�‘G`Şlostcharİ'�¦�‘Kâ:Suppress–ôwš²!arnings“when“a“c˜haracter“is“missing“from“a“fon˜t“that“a“D˜VI‘Ûor“VF�¦�‘Kâ: le–¦ftries“to“t�²!yp�MŞeset.�¡�‘G`Şreadableİ'�¦�‘Kâ:Suppress–ÂØw�²!arnings“abšMŞout“attempts“to“access“a“ le“whose“p˜ermissions“render“it�¦�‘Kâ:unreadable.�¡�‘G`Şspecialİ'‘ }÷Suppresses–kwš²!arnings“ab�MŞout“an“unimplemen˜ted“or“unparsable“`Ş\specialİ'“com-�¦�‘Kâ:mand.�Ÿ33�‘G`Ştex-hush.cİ'– mde nes“the“function“that“c•²!hec“ks– mthe“v›ÿdDariable“v˜alue.‘óEacš²!h“driv˜er“implemen˜ts�¦�‘Gits–¦foš²!wn“c˜hec˜ks“where“appropriate.��Œ‹.IØ�Ÿò��‘GİChapter‘¦f5:‘İİProgramming’-^A46��� ƒ3*� ı ÌÖ��‘GëK5‘ ¸QProgramming��Ÿ›]�‘!GİThis–Œ¶cš²!hapter“is“for“programmers“who“wish“to“use“Kpathsea.‘øSee“Chapter“1“[In˜tro�MŞduction],�¤ 33�‘Gpage–¦f1,“for“the“conditions“under“whicš²!h“y˜ou“ma˜y“do“so.�Ÿ ,#��‘GëT5.1‘™Programming‘f@o•ŒÌv“erview��Ÿ«A�‘!GİAside– Âfrom“this“man•²!ual,‘"™y“our– Âb�MŞest“source“of“information“is“the“source“to“the“programs�¡�‘GI'vš²!e–<ïmo�MŞdi ed“to“use“Kpathsea“(see“Chapter“1“[In˜tro�MŞduction],›b‘page“1).‘¡xOf“those,˜Dviljk“is�¡�‘Gprobably–1nthe“simplest,‘T0and“hence“a“go•MŞo“d–1nplace“to“start.‘~öXdvik“adds“VF‘1Ksupp�MŞort“and“the�¡�‘Gcomplication–_´of“X‘_¢resources.›ÆLDvipsk“adds“the“complication“of“its“o�²!wn“con g“ les.˜W‘ÿeeb2c“is�¡�‘Gsource–™co�MŞde“I‘€also“mainš²!tain,‘æso“it“uses“Kpathsea“rather“straigh˜tforw˜ardly‘ÿe,‘æbut“is“of“course�¡�‘Gcomplicated–|Üb�²!y“the“W›ÿeeb“to“C‘|¥translation.‘a>Finally˜,‘²yKpsewhicš²!h“is“a“small“utilit˜y“program�¡�‘Gwhose–¦fsole“purp�MŞose“is“to“exercise“the“main“path-searcš²!hing“functionalit˜y‘ÿe.�©«A�‘!GBeyš²!ond–q`these“examples,‘{ûthe“`Ş.hİ'“ les“in“the“Kpathsea“source“describ�MŞe“the“in˜terfaces“and�¡�‘Gfunctionalitš²!y–�B(and“of“course“the“`Ş.cİ'“ les“de ne“the“actual“routines,‘“ãwhic˜h“are“the“ultimate�¡�‘Gdo�MŞcumenš²!tation).‘#ı`Şpathsearch.hİ'–hqdeclares“the“basic“searc˜hing“routine.‘#ı`Ştex-file.hİ'“and�¡�‘G`Ştex-glyph.hİ'–öŞde ne“the“inš²!terfaces“for“lo�MŞoking“up“particular“kinds“of“ les.‘ÏDY‘ÿeou“ma˜y“wish�¡�‘Gto–¦fuse“Ş#include“İ,“whicš²!h“includes“ev˜ery“Kpathsea“header.�¦�‘!GThe–Ǻlibrary“proš²!vides“no“w˜a˜y“for“an“external“program“to“register“new“ le“t˜yp�MŞes:�¡�‘G`Ştex-file.[ch]İ'–‡m�²!ust“bšMŞe“mo˜di ed“to“do“this.‘ :@F‘ÿeor“example,‘w�Kpathsea“has“supp˜ort“for�¡�‘Glo�MŞoking–ÅĞup“Dvips“con g“ les,‘ ªevš²!en“though“no“program“other“than“Dvips“will“lik˜ely“ev˜er�¡�‘Gw•²!an“t–׿to“do“so.‘qèI‘ײfelt“this“wš²!as“acceptable,‘äsince“along“with“new“ le“t˜yp�MŞes“should“also“come�¡�‘Gnew–Üzdefaults“in“`Ştexmf.cnfİ'“(and“its“descendan�²!t“`Şpaths.hİ'),‘éÿsince“it's“simplest“for“users“if�¡�‘Gthey–¦fcan“mo�MŞdify“one“con guration“ le“for“all“kinds“of“paths.�¦�‘!GKpathsea–Ú došMŞes“not“parse“an�²!y“formats“itself;‘+it“barely“op˜ens“an�²!y“ les.‘™¿Its“primary“purp˜ose�¡�‘Gis–X+to“return“ lenames.‘ÃÉThe“GNU‘Xfonš²!t“utilities“do�MŞes“con˜tain“libraries“to“read“TFM,“GF,“and�¡�‘GPK–¦f les,“as“do“the“programs“ab�MŞo•²!v“e,–¦fof“course.�Ÿ ,#��‘GëT5.2‘™Calling‘f@sequence��Ÿ«A�‘!GİThe–¦ftš²!ypical“w˜a˜y“to“use“Kpathsea“in“y˜our“program“go�MŞes“something“lik˜e“this:�¦��‘-1.�‘'¿«Call–†8Şkpse_set_program_name“İwith“Şargv[0]“İas“the“ rst“argumenš²!t;‘æHthe“second“argumen˜t�¡�‘'¿«is–©a“string“or“ŞNULLİ.‘@¦The“second“argumenš²!t“is“used“b˜y“Kpathsea“as“the“program“name�¡�‘'¿«for–lthe“Ş.áprogram“İfeature“of“con g“ les“(see“Section“3.2.1“[Con g“ les],‘wÂpage“30).‘ÊnIf“the�¡�‘'¿«second–÷óargumenš²!t“is“ŞNULLİ,‘ Vthe“v‘ÿdDalue“of“the“ rst“argumen˜t“is“used.‘Ò…This“function“m˜ust�¡�‘'¿«bšMŞe–¦fcalled“b˜efore“an�²!y“other“use“of“the“Kpathsea“library‘ÿe.�Ÿo:�‘'¿«If–z necessary‘ÿe,‘‚ëŞkpse_set_program_name“İsets“the“global“v‘ÿdDariables“Şprogram_invocation_�¡�‘'¿«name–áÖİand“Şprogram_invocation_short_nameİ.‘ �.These“v‘ÿdDariables“are“used“in“the“er-�¡�‘'¿«ror–ÜÍmessage“macros“de ned“in“`Şkpathsea/lib.hİ'.‘�It“sets“the“global“v‘ÿdDariable“Şkpse_�¡�‘'¿«program_name–@+İto“the“program“name“it“uses.‘»ÉIt“also“initializes“debugging“options“based�¡�‘'¿«on–Ôøthe“en•²!vironmen“t–Ôøv›ÿdDariable“ŞKPATHSEA_DEBUG“İ(if“that“is“set).‘i”Finally‘ÿe,‘à�it“sets“the“v˜ari-�¡�‘'¿«ables– ûŞSELFAUTOLOCİ,›e_ŞSELFAUTODIR“İand“ŞSELFAUTOPARENT“İto“the“lo�MŞcation,˜paren�²!t“and�¡�‘'¿«grandparenš²!t–©directory“of“the“executable,‘3úremo˜ving“`Ş.İ'“and“`Ş..İ'“path“elemen˜ts“and“re-�¡�‘'¿«solving– Ôsymš²!b�MŞolic“links.‘ÜThese“are“used“in“the“default“con guration“ le“to“allo˜w“p�MŞeople��Œ‹/Tn�Ÿò��‘GİChapter‘¦f5:‘İİProgramming’-^A47��� ƒ3*� ı ÌÖ�‘'¿«to›®÷in•²!v“ok“e˜T‘ÿeeX‘®³from˜an“ywhere,‘ñsp�MŞeci cally˜from˜a˜moun“ted˜CD-R“OM.˜(Y‘ÿeou˜can˜use�¤ 33�‘'¿«`Ş--expand-var=\$SELFAUTOLOCİ',–¦fetc.,“to“see“the“v‘ÿdDalues“ nds.)�©µ+��‘-2.�‘'¿«The–&»Şkpse_set_progname“İis“deprecated.‘^ÛA‘&šcall“to“Şkpse_set_progname“İwith“Şargv[0]�¡�‘'¿«İis–°equiv‘ÿdDalenš²!t“to“a“call“of“Şkpse_set_program_name“İwith“ rst“argumen˜t“Şargv[0]“İand�¡�‘'¿«second–qTargumen�²!t“ŞNULLİ.‘ >¦The“function“is“deprecated“b�MŞecause“it“cannot“ensure“that�¡�‘'¿«the–acŞ.áprogram“İfeature“of“con g“ les“will“alw•²!a“ys›acw“ork˜(see˜Section˜3.2.1˜[Con g˜ les],�¡�‘'¿«page‘¦f30).�¦��‘-3.�‘'¿«Set–Şidebugging“options.››3See“Section“2.6.3“[Debugging],‘hpage“22.˜If“y�²!our“program“do�MŞesn't�¡�‘'¿«ha•²!v“e–*)a“debugging“option“already‘ÿe,‘Ky�²!ou“can“de ne“one“and“set“Şkpathsea_debug“İto“the�¡�‘'¿«n•²!um“b�MŞer–Úbthat“the“user“supplies“(as“in“Dviljk“and“W‘ÿeeb2c),‘'aor“y�²!ou“can“just“omit“this�¡�‘'¿«altogether–'5(p�MŞeople“can“alw•²!a“ys–'5set“ŞKPATHSEA_DEBUGİ).‘³xIf“yš²!ou“do“ha˜v˜e“run˜time“debugging�¡�‘'¿«already‘ÿe,–¦fyš²!ou“need“to“merge“Kpathsea's“options“with“y˜ours“(as“in“Dvipsk“and“Xdvik).�¦��‘-4.�‘'¿«If–"wyš²!our“program“has“its“o˜wn“con guration“ les“that“can“de ne“searc˜h“paths,‘<Úy˜ou“should�¡�‘'¿«assign–h6those“paths“to“the“Şclient_path“İmemš²!b�MŞer“in“the“appropriate“elemen˜t“of“the�¡�‘'¿«Şkpse_format_info–ûkİarraš²!y‘ÿe.‘Üí(This“arra˜y“is“indexed“b˜y“ le“t˜yp�MŞe;‘%îsee“`Ştex-file.hİ'.)‘ÜíSee�¡�‘'¿«`Şresident.cİ'–¦fin“Dvipsk“for“an“example.�¦��‘-5.�‘'¿«Call–—œŞkpse_init_prog“İ(see“`Şproginit.cİ').‘ØïIt's“useful“for“the“D•²!VI‘—™driv“ers,–š’at‘—œleast,“but�¡�‘'¿«for–î¨other“programs“it“ma�²!y“b�MŞe“simpler“to“extract“the“parts“of“it“that“actually“apply‘ÿe.‘ �This�¡�‘'¿«došMŞes–£wnot“initialize“an�²!y“paths,‘¤ it“just“lo˜oks“for“(and“sets)“certain“en•²!vironmen“t‘£wv‘ÿdDariables�¡�‘'¿«and–È�other“random“information.‘DU(A‘È…searcš²!h“path“is“alw˜a˜ys“initialized“at“the“ rst“call“to�¡�‘'¿« nd–‡ga“ le“of“that“tš²!yp�MŞe;‘‘¼this“eliminates“m˜uc˜h“useless“w˜ork,–�še.g.,“initializing–‡gthe“BibT�‘ş,³Ÿ[wE�‘B X�¡�‘'¿«searcš²!h–¦fpaths“in“a“D˜VI“driv˜er.)�¦��‘-6.�‘'¿«The–7�routine“to“actually“ nd“a“ le“of“t�²!yp�MŞe“áformat‘t�İis“Şkpse_find_áformat�=İ,‘›Çde ned“in�¡�‘'¿«`Ştex-file.hİ'.›EŞThese–Éare“macros“that“expand“to“a“call“to“`Şkpse_find_fileİ'.˜Y‘ÿeou“can�¡�‘'¿«call,–^Ssaš²!y‘ÿe,“Şkpse_find_tfm–9Šİafter“doing“only“the“ rst“of“the“initialization“steps“ab�MŞo˜v˜e|�¡�‘'¿«Kpathsea–dxautomatically“reads“the“`Ştexmf.cnfİ'“generic“con g“ les,‘“ülo�MŞoks“for“en�²!viron-�¡�‘'¿«men�²!t–¦fv‘ÿdDariables,“and“došMŞes“expansions“at“the“ rst“lo˜okup.�¦��‘-7.�‘'¿«T‘ÿeo–@  nd“PK›@xand/or“GF˜bitmap“fon�²!ts,›g.the“routines“are“Şkpse_find_pkİ,˜Şkpse_find_gf�¡�‘'¿«İand–˜»Şkpse_find_glyphİ,‘ÕPde ned“in“`Ştex-glyph.hİ'.‘´İThese“return“a“structure“in“addi-�¡�‘'¿«tion–@Üto“the“resultanš²!t“ lename,‘gyb�MŞecause“fon˜ts“can“b�MŞe“found“in“so“man˜y“w˜a˜ys.‘­?See“the�¡�‘'¿«do�MŞcumen�²!tation–¦fin“the“source.�¦��‘-8.�‘'¿«T‘ÿeo–>Éactually“op�MŞen“a“ le,›S‚not“just“return“a“ lename,˜call“Şkpse_open_fileİ.‘»TThis“function�¡�‘'¿«takš²!es–5the“name“to“lo�MŞok“up“and“a“Kpathsea“ le“format“as“argumen˜ts,‘+èand“returns“the�¡�‘'¿«usual–tÇŞFILE‘¦f*İ.‘HÿIt“alw•²!a“ys–tÇassumes“the“ le“mš²!ust“exist,‘¨_and“th˜us“will“searc˜h“the“disk“if�¡�‘'¿«necessary–õ�(unless“the“searcš²!h“path“sp�MŞeci ed“`Ş!!İ',‘âetc.).‘¢æIn“other“w˜ords,‘âif“y˜ou“are“lo�MŞoking�¡�‘'¿«up–¦fa“VF“or“some“other“ le“that“need“not“exist,“don't“use“this.�Ÿ;�‘!GKpathsea–22also“proš²!vides“man˜y“utilit˜y“routines.‘�ASome“are“generic:‘õuhash“tables,‘U%memory�¡�‘Gallo�MŞcation,›§.string–sÓconcatenation“and“cop�²!ying,˜string“lists,˜reading“input“lines“of“arbitrary�¡�‘Glength,›‰etc.‘ºşOthers–ğare“ lename-related:‘qIdefault“path,˜tilde,˜and“v‘ÿdDariable“expansion,˜Şstat�¡�‘Gİcalls,–¦fetc.‘İİ(Pš²!erhaps“someda˜y“I'll“mo˜v˜e“the“former“to“a“separate“library‘ÿe.)�Ÿ7#�‘!GThe–IÔ`Şc-*.hİ'“header“ les“can“also“help“yš²!our“program“adapt“to“man˜y“di eren˜t“systems.�¡�‘GY‘ÿeou–N:will“almost“certainly“w•²!an“t–N:to“use“Auto�MŞconf“for“con guring“yš²!our“soft˜w˜are“if“y˜ou�¡�‘Guse–hKpathsea;‘RéI‘Çstrongly“recommend“using“Auto�MŞconf“regardless.‘ 6äIt“is“a�²!v‘ÿdDailable“from�¡�‘GŞftp://prep.ai.mit.edu/pub/gnu/İ.��Œ‹0d^�Ÿò��‘GİChapter‘¦f5:‘İİProgramming’-^A48��� ƒ3*� ı ÌÖ��‘GëT5.3‘™Program-sp�s3eci c‘f@ les��Ÿ33�‘!GİManš²!y–fUprograms“will“need“to“ nd“some“con guration“ les.‘ «Kpathsea“con˜tains“some�¤ 33�‘Gsupp�MŞort–ÿ¡to“makš²!e“it“easy“to“place“them“in“their“o˜wn“directories.‘¦FThe“Standard“T�‘ş,³Ÿ[wE�‘B X‘ÿwdirectory�¡�‘Gstructure–‚á(see“section“\In�²!tro�MŞduction"“in“áA›‚ØDirectory“Structure“for“T�‘ş,³Ÿ[wE�‘B X˜ les�s‚İ),‘‰ûsp�MŞeci es“that�¡�‘Gsucš²!h–¦f les“should“go“in˜to“a“sub�MŞdirectory“named“after“the“program,“lik˜e“`Ştexmf/ttf2pkİ'.�©33�‘!GTw�²!o–nïsp�MŞecial“formats,‘­:`Şkpse_program_text_formatİ'“and“`Şkpse_program_binary_formatİ'Ÿnï„ ™�¡�‘Gexist,‘Û/whicš²!h–7use“Ş.:$TEXMF/áprogramŞ//“İas“their“compiled-in“searc˜h“path.‘ �ÂT‘ÿeo“o˜v˜erride�¡�‘Gthis–Kdefault,‘¯Ãyš²!ou“can“use“the“v‘ÿdDariable“áPR˜OGRAM‘/®ŞINPUTS“İin“the“en˜vironmen˜t“and/or�¡�‘G`Ştexmf.cnfİ'.‘µ'That–î)is“to“saš²!y‘ÿe,‘@the“name“of“the“v‘ÿdDariable“is“constructed“b˜y“con˜v˜erting“the�¡�‘Gname–¦fof“the“program“to“uppšMŞer“case,“and“app˜ending“ŞINPUTSİ.�¦�‘!GThe– Honly“di erence“bšMŞet•²!w“een– Hthese“t•²!w“o– Hformats“is“whether“Şkpse_open_file“İwill“op˜en“the�¡�‘G les–¦fit“ nds“in“text“or“binary“mo�MŞde.�Ÿ��‘GëT5.4‘™Programming–f@with“con g“ les��Ÿ33�‘!GİY‘ÿeou–şäcan“(and“probably“should)“use“the“same“Ştexmf.cnf“İcon guration“ le“that“Kpathsea�¡�‘Guses–¦ffor“yš²!our“program.‘İİThis“helps“installers“b˜y“k˜eeping“all“con guration“in“one“place.�¦�‘!GT‘ÿeo–¦åretriev�²!e“a“v›ÿdDalue“áv˜ar‘pİfrom“con g“ les,‘§the“b�MŞest“w•²!a“y–¦åis“to“call“Şkpse_var_value“İon“the�¡�‘Gstring–Cûáv›ÿdDar‘É)İ.‘½This“will“lo�MŞok“ rst“for“an“en•²!vironmen“t–Cûv˜ariable“áv˜arİ,‘Wªthen“a“con g“ le“v˜alue.‘½The�¡�‘Gresult–„will“b�MŞe“the“v‘ÿdDalue“found“or“`ŞNULLİ'.‘}This“function“is“declared“in“`Şkpathsea/variable.hİ'.�¡�‘GF‘ÿeor–¦fan“example,“see“the“Şshell_escape“İco�MŞde“in“`Şweb2c/lib/texmfmp.cİ'.�¦�‘!GThe–Êroutine“to“do“v‘ÿdDariable“expansion“in“the“conš²!text“of“a“searc˜h“path“(as“opp�MŞosed“to�¡�‘Gsimply–hèretrieving“a“v‘ÿdDalue)“is“Şkpse_var_expandİ,‘™ˆalso“declared“in“`Şkpathsea/variable.hİ'.�¡�‘GIt's–Kgenerally“only“necessary“to“set“the“searcš²!h“path“structure“comp�MŞonen˜ts“as“explained“in�¡�‘Gthe–¦fprevious“section,“rather“than“using“this“y�²!ourself.�¦�‘!GIf–¨”for“some“reason“yš²!ou“w˜an˜t“to“retriev˜e“a“v‘ÿdDalue“àonly‘ •İfrom“a“con g“ le,‘énot“automat-�¡�‘Gically–üClošMŞoking“for“a“corresp˜onding“en•²!vironmen“t–üCv‘ÿdDariable,‘Q¹call“Şkpse_cnf_get“İ(declared“in�¡�‘G`Şkpathsea/cnf.hİ')–¦fwith“the“string“áv‘ÿdDarİ.�¦�‘!GNo–¦finitialization“calls“are“needed.��Œ‹1uì�Ÿò��‘GİIndex’‹ç=49��� ƒ3*� ı ÌÖ��‘GëKIndex��Ÿ+33�‘!Góo´‹Ç cmr9¬(Index–Tis“nonexisten�¾9t)��Œ‹ÿÿÿÿ€ª�Ÿò��’À¥Tİi��� ƒ3*� ı ÌÖ��‘GëKT‘şaGable–z³of“Con–ÿuÂten“ts��Ÿ)33�‘GëT1‘32In�ŒÌtro�s3duction‘¤:�‘32óUF C–ff cmbxti10ëU.�–…�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�‘ �°ëT1�¤ÿ�‘6Gİ1.1‘ ó5History‘ù �‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ Î:İ1�Ÿ33�‘GëT2‘32Installation‘E�‘32ëU.�–…�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�‘0�ëT3�¡�‘6Gİ2.1‘ ó5Simple‘¦finstallation‘lX�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ Aˆİ3�¤ 33�‘6G2.2‘ ó5Custom‘¦finstallation‘� �‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ b:İ4�¡�‘ZG2.2.1‘ ó5Disk‘¦fspace‘Ø�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ ó İ4�¡�‘ZG2.2.2‘ ó5Kpathsea–¦fapplication“distributions‘«ë�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ �İ5�¡�‘ZG2.2.3‘ ó5Changing–¦fsearc�²!h“paths‘¢³�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ wäİ5�¡�‘~G2.2.3.1‘ ó5Default–¦fpath“features‘ÑP�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ ¦�İ6�¡�‘~G2.2.3.2‘ ó5Default–¦fpath“generation‘c�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ 8Cİ6�¡�‘ZG2.2.4‘ ó5Running‘¦fŞconfigure�é�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘êİ7�¡�‘~G2.2.4.1‘ ó5Şconfigure‘¦fİshells‘ıÓ�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ Óİ7�¡�‘~G2.2.4.2‘ ó5Şconfigure‘¦fİoptions‘¤o�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ y İ7�¡�‘~G2.2.4.3‘ ó5Şconfigure‘¦fİen•²!vironmen“t‘KÌ�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ üİ8�¡�‘~G2.2.4.4‘ ó5Şconfigure‘¦fİscenarios�;ç�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ İ9�¡�‘~G2.2.4.5‘ ó5Shared‘¦flibrary‘÷�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ è(İ9�¡�‘ZG2.2.5‘ ó5Running‘¦fŞmake‘Y��‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ .Íİ10�¡�‘ZG2.2.6‘ ó5Installing‘¦f les‘³�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ —ãİ10�¡�‘ZG2.2.7‘ ó5Cleaning‘¦fup‘ ƒ�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ á³İ11�¡�‘ZG2.2.8‘ ó5Filename–¦fdatabase“generation‘Œı�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ b.İ11�¡�‘ZG2.2.9‘ ó5`Şmktexİ'‘¦fscripts�Lû�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ ",İ12�¡�‘~G2.2.9.1‘ ó5`Şmktexİ'‘¦fcon guration‘(��‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ ı¿İ12�¡�‘~G2.2.9.2‘ ó5`Şmktexİ'–¦fscript“names‘Pt�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ %¥İ14�¡�‘~G2.2.9.3‘ ó5`Şmktexİ'–¦fscript“argumen�²!ts�0"�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ Sİ14�¡�‘ZG2.2.10‘ ó5Installation‘¦ftesting�)�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘óZİ14�¡�‘6G2.3‘ ó5Securit�²!y‘Ÿ§�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ t×İ15�¡�‘6G2.4‘ ó5T�‘ş,³Ÿ[wE�‘B X–¦fdirectory“structure�jk�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ ?œİ15�¡�‘6G2.5‘ ó5`Şunixtex.ftpİ':‘İİObtaining‘¦fT�‘ş,³Ÿ[wE�‘B X‘Şw�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ ³§İ17�¡�‘ZG2.5.1‘ ó5Electronic‘¦fdistribution‘â‰�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ ·¹İ17�¡�‘ZG2.5.2‘ ó5CD-R�²!OM‘¦fdistribution�L�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ !Eİ19�¡�‘ZG2.5.3‘ ó5Other–¦fT�‘ş,³Ÿ[wE�‘B X“pac�²!k‘ÿdDages‘Ê�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ òúİ20�¡�‘6G2.6‘ ó5Rep�MŞorting‘¦fbugs‘xÓ�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ Nİ20�¡�‘ZG2.6.1‘ ó5Bug‘¦fc•²!hec“klist‘Ëß�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ ¡İ20�¡�‘ZG2.6.2‘ ó5Mailing‘¦flists‘ˆ#�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ ]Sİ22�¡�‘ZG2.6.3‘ ó5Debugging‘á�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ ¶Iİ22�¡�‘ZG2.6.4‘ ó5Logging‘¤ı�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ z.İ24�¡�‘ZG2.6.5‘ ó5Common‘¦fproblems�n`�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ C‘İ24�¡�‘~G2.6.5.1‘ ó5Unable–¦fto“ nd“ les‘�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ ãAİ24�¡�‘~G2.6.5.2‘ ó5Sloš²!w–¦fpath“searc˜hing‘Y–�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ .Çİ25�¡�‘~G2.6.5.3‘ ó5Unable–¦fto“generate“fon�²!ts‘��‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ rKİ26�¡�‘~G2.6.5.4‘ ó5T�‘ş,³Ÿ[wE�‘B X–¦for“Metafon�²!t“failing‘x$�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ MTİ26�¡�‘~G2.6.5.5‘ ó5Empt•²!y‘¦fMak“e les‘E^�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ �İ27��Œ‹ÿÿÿş�I�Ÿò��’½š©İii��� ƒ3*� ı†ÌÖ�‘~G2.6.5.6‘ ó5ŞXtStrings‘Œ‹�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ a»İ27�¤ 33�‘~G2.6.5.7‘ ó5Şdlopen‘Îb�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ £’İ27�¡�‘~G2.6.5.8‘ ó5ŞShellWidgetClass‘‘��‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ fÎİ28�¡�‘~G2.6.5.9‘ ó5P•²!oin“ter›¦fcom“bination˜w“arnings‘ÛY�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ °Šİ28�©33�‘GëT3‘32P•ŒÌath‘ffsearc“hing� õ�‘32ëU.�–…�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�‘ õjëT29�Ÿÿ�‘6Gİ3.1‘ ó5Searc•²!hing‘¦fo“v“erview‘„L�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ Y|İ29�¡�‘6G3.2‘ ó5P�²!ath‘¦fsources‘�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ ã1İ30�¡�‘ZG3.2.1‘ ó5Con g‘¦f les‘Ü?�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ ±oİ30�¡�‘6G3.3‘ ó5P�²!ath‘¦fexpansion‘UÉ�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ *úİ31�¡�‘ZG3.3.1‘ ó5Default‘¦fexpansion‘Xï�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ . İ31�¡�‘ZG3.3.2‘ ó5V‘ÿeariable‘¦fexpansion�Gr�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ ¢İ32�¡�‘ZG3.3.3‘ ó5Tilde‘¦fexpansion‘iO�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ >€İ32�¡�‘ZG3.3.4‘ ó5Brace‘¦fexpansion‘Aj�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ ›İ33�¡�‘ZG3.3.5‘ ó5ŞKPSE_DOT‘¦fİexpansion‘@Ù�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘  İ33�¡�‘ZG3.3.6‘ ó5Sub�MŞdirectory‘¦fexpansion‘Ei�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ šİ33�¡�‘6G3.4‘ ó5Filename–¦fdatabase“(Şls-Rİ)�R?�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ 'oİ34�¡�‘ZG3.4.1‘ ó5`Şls-Rİ'‘rÉ�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ Gúİ34�¡�‘ZG3.4.2‘ ó5Filename‘¦faliases‘du�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ 9¦İ35�¡�‘ZG3.4.3‘ ó5Database‘¦fformat�WÑ�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ -İ35�¡�‘6G3.5‘ ó5Şkpsewhichİ:‘İİStandalone–¦fpath“searc�²!hing‘®Ô�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ „İ36�¡�‘ZG3.5.1‘ ó5P•²!ath›¦fsearc“hing˜options‘Bê�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ İ36�¡�‘ZG3.5.2‘ ó5Auxiliary‘¦ftasks‘rz�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ G«İ38�¡�‘ZG3.5.3‘ ó5Standard‘¦foptions‘Ë:�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘  kİ39�¦�‘GëT4‘32T�‘ıL¨Ÿ32E�‘èdX‘ffsupp�s3ort��‘32ëU.�–…�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�‘ •ëT40�Ÿÿ�‘6Gİ4.1‘ ó5Supp�MŞorted–¦f le“formats‘3G�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ wİ40�¡�‘6G4.2‘ ó5File‘¦flo�MŞokup‘â•�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ ·Æİ42�¡�‘6G4.3‘ ó5Glyph‘¦flo�MŞokup‘S¬�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ (İİ43�¡�‘ZG4.3.1‘ ó5Basic–¦fglyph“lo�MŞokup‘Z{�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ /«İ43�¡�‘ZG4.3.2‘ ó5F‘ÿeon�²!tmap‘ôh�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ ɘİ44�¡�‘ZG4.3.3‘ ó5F‘ÿeallbac•²!k‘¦ffon“t‘oe�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ D•İ45�¡�‘6G4.4‘ ó5Suppressing‘¦fw�²!arnings‘ÔK�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ ©|İ45�¦�‘GëT5‘32Programming�2ì�‘32ëU.�–…�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�‘ bëT46�Ÿÿ�‘6Gİ5.1‘ ó5Programming‘¦fo•²!v“erview‘5É�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ úİ46�¡�‘6G5.2‘ ó5Calling‘¦fsequence‘ğ�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ ò İ46�¡�‘6G5.3‘ ó5Program-sp�MŞeci c‘¦f les‘dY�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ 9Šİ48�¡�‘6G5.4‘ ó5Programming–¦fwith“con g“ les‘µ�‘é˜à.�–.Ô�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�“�‘é˜.�‘ Øåİ48�¦�‘GëTIndex‘?Ó�‘32ëU.�–…�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�“�‘32.�‘+HëT49��Œø®šƒ’À;è‡ Çïÿ5ó`߆µT #× cmtt12ó]ÂÖN  #× cmbx12óW߆µTff cmtt12óUF C–ff cmbxti10óTÂÖN ff cmbx12óKÂÖN G® cmbx12óBÂÖN ¼j cmbx12ó;!",š ó3 cmsy10ó6p®0J ó3 cmsl10ó5ı': ó3 cmti10ó3ßê