; TeX output 1997.01.23:0041soj,tDtGGcmr17Con guration7toptionsforLdKGXQ cmr12AT[-E;gX`2gG cmmi12"#yٞhcvMH!", cmsy10 7Copryright1995,LDD"|{Ycmr8A_ٺT UE!X3ProjectTVeam.-Allrighrtsreserved.+F8DecemrbSer19951č5Nff cmbx12Contents5"V cmbx10Con guringTL*f$cmbx7AT<8E3sX?25SystemTcon guration/2 Dm#R cmss10texsys.cfgK`y cmr10..................................25Con guringTtheL*AT<8E3sXformat52DF*ontUUcon guration<.............................3Dfonttext.cfg'.................................3Dfontmath.cfg\&.................................3Dpreload.cfg..................................4DHyphenationUUcon guration.........................4Dhyphen.cfg8..................................45Con guringTthefon9tde nition lesU55Con guringTcompatibilit9ymoQde6Dlatex209.cfg&.................................65Con gurationT lesforstandardpac9k\ragesandclassesK,7Dsfonts.cfgq..................................7DltxdoGc.cfgq..................................7Dltxguide.cfg~.................................85Con gurationTforothersuppQortedpac9k\ragesx48Dgraphics.cfg.................................8Dcolor.cfg1...................................85Non-standardTv9ersions09DExamples..................................91*so5Con guringffL++AnTL32EdX5SinceӘoneofthemainaimsofthenewstandardL5ffٓRcmr7A͉TU>'ExXistogiveallusersthe 5freedomprovidedbyareliabledoGcumentproGcessingsystemlinkedtoahighly5pGortableidocumentformat,mthenumbGerofcon gurationpossibilitiesisstrictly5limited.!Thedreasonsforthisareexplainedinmoredetailinthearticle!': cmti10Mo}'difying5L雍Q"t}\cmti7ATKß'E-X"inithe le#'ExXsystemmaybGecon gureddi erently*.5LoGcal%hcon gurationoptionsare,Ymbyconvention,Ymplacedin`con guration les',5whichhaveextension.cfg.mThisdoGcumentdescribGesthepossibilitiesforcon-5 gurationZinthisreleaseofL5ffA͉TU>'ExX;܃italsoexplainshowtocon gurethefont5de nitionUU lestotakeadvqantageoftheavqailablefonts.5TheIlastsectionconsidersbrie yhowtoproGceedifyourequirefurthercustomi-5sationUUoftheformatter.'č5Systemffcon guration5%kAH cmssbx10texsys.cfguT5Thisistheonlycon guration lethatmustrϲbGepresent.Duringinstallation,if5L5ffA͉TU>'ExX[dcannot nda lewiththisnamethenadefault letexsys.cfg,aconsisting5entirelyDofcomments,iswrittenoutandused.ANotethat,untilthis lehasbGeen5read,L5ffA͉TU>'ExXisnotabletotestreliablywhetheragiven leexistsonthesystem.5TheH\contentsofthe letexsys.cfgallowL5ffA͉TU>'ExXtocopGewithvqariousdi er-5ences0bGetweenthebGehavioursofdi erentTU>'ExXsystems,gmainlyinrelationto5 lehandling.[Thedefaultversionofthis lecontains,initscomments,pGossible5settingsthatmaybGeneededforarangeofTU>'ExXsystems.VF*ormoreinformation,5typGesetUUthe leltdirchk.dtx.5IfyouhavecopiedyourL5ffA͉TU>'ExXinstallationfromacomputerthatusedadi erent5opGeratingxsystemthenyoumaywellhaveaversionoftexsys.cfgthatwill5make+itdiculttoinstallL5ffA͉TU>'ExXonyoursystem.cIfthishappGensthenstartthe5proGcessagainwithanemptytexsys.cfg le;thiswillproduceaninstallation5thatshould,"atleast,allowyoutotypGesetthedocumentation.^However,"itis5pGossiblebthatL5ffA͉TU>'ExXcanstill ndonlythose lesthatareinthecurrentdirectory;5inUUthiscaseyoumustsetthemacro\input@pathcorrectlyforyoursystem.'č5Con guringfftheL++AnTL32EdXformat5Therearefourcon guration lesthatenablepGersonalpreferencestobeincorpo-5ratedwintotheL5ffA͉TU>'ExXformat lelatex.fmt.ُTherangeofpreferencesthatcan5bGevcon guredbythese lesisstrictlylimitedasthishelpstoensuredocument5pGortability*.2Dso5AllP]four lesworkinthesameway:gifthe le !", cmsy10h le[i.cfgisfound,itwillbGe 5input( byiniTU>'ExX;7%otherwiseadefault leh le[iv.ltxwillbGeinputinstead.bThus,5providing=oneofthese.cfg lescompletelyoverridesanysettingsinthecorre-5spGondingUUstandard.ltx le.!N5$N cmbx12Fontcon guration75BeforeayoueventhinkabGoutcon guringthefontdeclarationsbyproGducing5a< lefontmath.cfgorfonttext.cfg,youshouldreadthedoGcumented le5fontdef.dtx.Y=This isthesource lefromwhichthedefault lesfonttext.ltx5andfontmath.ltxareproGduced;titcontainsinformationconcerningthecon-5tentsoDofthedefault lesandwhatsortofcustomisationispGossible.%Inparticular,5itdescribGesindetailthee ectsofindividualcustomisationsondocumentporta-5bilityPVincluding:gwhichcustomisationscanbGemadewithoutendangeringthe5ability{utoexchangedoGcumentswithothersites(eveniftheformattingdi ers);5and7whichthingsshouldbGeleftuntouchedbGecausetheywillmakeyoursystem5soUUdi erentfromothersthatthedoGcumentsitproGduceswillbenon-portable.5fonttext.cfg75The_ lefonttext.cfgcancontaindeclarationsrelatingtotheuseoffontsin5textUUmoGdes.㍑5If/itexists,fbitde neswhichfontshapGes,fbfamiliesandencodingsarenormally5usedvBintextmoGde,~}aswellasthebehavioroffontattributecommandssuchas5\textbfUUetc.5ItcouldbGeused,forexample,toproGduceaL5ffA͉TU>'ExXformatthat,bydefault,typGe-5setsUdoGcumentsusingTimesfonts..Bewarned,however,thatUsuchcustomisation5canhaveunfortunateconsequences;sopleasereadcarefullythissectionandthe5 leUUfontdef.dtxbGelowifyouarethinkingofdoingthis.5PleaseUUnotethatuseofthiscon guration lehasthefollowingconsequences.DNSinceٗthecontentٗofthis lemightochangeinthefuture,anyonewritingNsuchacon guration lemustbGepreparedtoupdateitforusewithfutureNreleases.⍍DNDoGcuments[producedonyoursystemarelikely*,atbGest,tobGeportableonlyNinithesenseofbGeingprocessableatadi erentsite|theactualformattingNwillUUnotbGethesameifdi erentfontsareused.DNTheL5ffA͉TU>'ExX3pro8jectteamwillnotbGeabletosupportyouindiagnosingNproblemsifthesecannotbGereproducedwithaformatthatdoesnotuseNanyUUcon guration les.!N5fontmath.cfg75The_ lefontmath.cfgcancontaindeclarationsrelatingtotheuseoffontsin5mathUUmoGde.3'so5If!{itexists,Titde neswhichfontsinwhichsizesareusedinmathmoGde,Tand 5howRtheyareused.\qItalsode nesallthemathmoGdecommandsthat`arelikely5to'depGendonthechoiceofmathfontsused(e.g.commandsthatdepGendonthe5pGositionUUofaglyphinamathfont).H5Thegmainreasonfortheexistenceofthis leistoprovideforfutureupGdates5when:#astandardmathfontencoGdingisavqailable.bRightnowwedonot,encourage5theuseofthiscon guration leotherthanforspGecialapplications.bW*ritinga5propGerUUcon guration leformathmodeneedsexpertknowledge!5PleaseUUnotethatuseofthiscon guration lehasthefollowingconsequences.捍DNSinceTthecontentTofthis leislikely7tochangeinthefuture,anyonewritingNsuchacon guration lemustbGepreparedtoupdateitforusewithfutureNreleases.HDNDoGcuments[producedonyoursystemarelikely*,atbGest,tobGeportableonlyNinithesenseofbGeingprocessableatadi erentsite|theactualformattingNwillUUnotbGethesameifdi erentfontsareused.DNTheL5ffA͉TU>'ExX3pro8jectteamwillnotbGeabletosupportyouindiagnosingNproblemsifthesecannotbGereproducedwithaformatthatdoesnotuseNanyUUcon guration les. 卑5p"reload.cfg5Thecontentsofthe lepreload.cfgcancontrolthepreloadingofcommonly5usedHfonts.*nPreloadingfontsspGeedsuptheprocessingofdocumentsbut,because5fontsqcannotbGe`unloaded',youshouldnotpreloadtoGomany;-otherwiseyoumay5bGeUUunabletoprocessdocumentsrequiringunusualfontfamilies.H5Thedefault lepreload.ltxisproGducedfrompreload.dtx.G&Itloadsonlya5fewbfontsandtheseareagoGodbchoiceifyounormallyusedoGcumentsatthe5default,10pt,size.s-If"younormallyuse11ptor12ptthenthetimeforL5ffA͉TU>'ExX5to}startupmaybGenoticeablydecreasedifyoupreloadthecorrespGondingfonts5forthesizesyouuse.VSimilarly*,ifyounormallyuseadi erentfontfamily*,for5exampleTimesRoman(ptm)thenyoumaywanttopreloadfontsinthisfamily5ratherUUthanthedefaultComputerMoGdernfonts.5Hyphenationcon guration5hyphen.cfg5Infordertohyphenatetext,2TU>'ExXmusthavehyphenationpatternsand,2since5thesepatternscanbGeloadedonlybyiniTU>'ExX,4 thechoiceofwhichpatternsto5loadUUmustbGemadewhentheformatiscreated.H5TheMhyphenationpatternsforAmericanEnglisharestoredinthe lenamed5hyphen.tex;UUL5ffA͉TU>'ExX2.09alwaysUUloadedthis lewhenitsformatwasmade.5Withp L5ffA͉TU>'ExX2 b> cmmi10",3itp ispGossibletocon gurewhichhyphenationpatternsaretobGe5loaded^intotheformat.DuWheniniTU>'ExXisproGcessinglatex.ltx,itlooksfora le44so5calledOhyphen.cfg;Qthis lecanbGeusedtocontrolwhichhyphenationpatterns 5areoloaded.uIfa lehyphen.cfgcannotbGefoundtheniniTU>'ExXwillloadthe le5hyphen.ltx.m5The~ lehyphen.ltxloadsthe lehyphen.texifitcan ndit;#otherwiseit5stopsS"withanerrorsinceaformatwithnohyphenationpatternsisnotvery5useful.gvIt6cthensets\language=0anditsetsthevqalues\lefthyphenmin=2and5\righthyphenmin=3,UUwhichareneededforAmericanEnglish.5Thus,OifYPyouwantanyotherpatternstobGeloadedthenyoushouldcreatea5 leahyphen.cfg.F*oreachlanguageforwhichyouwishtoloadhyphenation5patternsUUthis leshould:HDNsetUU\language=hnumb}'eri(;nDNloadUUthe lewhichcontainsthehyphenationpatternsforthatlanguage.G5IfBthepatternsyouuserequiresomede nitionsorassignmentsthenagroup5shouldUUbGeusedtokeepsuchchangesloGcaltotheir le.5Note.ܼThexhyphenation lesthatarereadinshouldonly[ysetthehyphenation5tablesforthelanguage, usingthecommands\hyphenationand\patterns.SIn5particular4theyshouldmakenoassignmentstothelowercase/uppGercasetables5(\lccodeDzand\uccode)andshouldnotmakeanyglobalcommandde nitions5to2bGeusedafterthe lehasbeenread.]Unfortunatelysomeolderhyphenation5 lesdocontainsuchsettings;thustheyareinc}'ompatibleKTwiththemechanisms5L5ffA͉TU>'ExXUUusestoensureindepGendenceofinputandoutputencodings.5AfterUUthisthe lehyphen.cfgshould:HDNsetUU\languagetoitsdefaultvqalue;nDNset\lefthyphenminand\righthyphenmintothecorrectvqaluesforthisNdefaultUUlanguage.G5ThereTarepackqagesavqailable,Tsuchas`french',Tthatcanhelpyouwiththiscon-5 guration.I,Theۂ`babGel'collectioncontainsmanyexamplesofsettingupamulti-5lingualW-L5ffA͉TU>'ExXformat.wNThedoGcumentationinlthyphen.dtx(thesource lefor5hyphen.ltx)UUalsocontainssomeusefulexamples.5[W*eaintendinafuturereleaseofL5ffA͉TU>'ExXtoprovideasetofstandardcommands5forUUuseincon guringhyphenation.]&5Con guringffthefontde nition les5If!youhavespGecialfontsavqailable(orifsomefontsareunavqailable)atyoursite5thenДyoumayneedtoproGducecustomisedversionsofthefontde nition les;5these4haveextension.fdandarereadbyL5ffA͉TU>'ExXtoobtaininformationabGout5theUUfont lesinstalledatyoursystemandwhentoloadthem.5AlthoughWfwedonotencouragesuchcustomisation,youwill ndinformation5abGoutPfthecontentPfofthese lesanditssyntaxinthedocumentedsource le5Bˠso5cmfonts.fddٲandL雍QATKß'E-X2"-%fontsele}'ction'ExX3pro8jectteamwillnotbGeabletosupportyouindiagnosingNproblemsifthesecannotbGereproducedwithaformatthatdoesnotuseNanyUUcustomisedfontde nition les.!65NotetosystemadministratorsuT5If#youinstallaversionofL5ffA͉TU>'ExXwithaloGcallycon guredfontset-upthenthis5systemislikelytoproGducedocumentsthatarenolonger`formattingcompat-5ible';"Hforexample,ttheuseofdi erentdefaultfontswillmostlikelyproGduce5di erentylineandpagebreaks.Ifyoudoinstall, onamulti-usersystem, asys-5tembthatiscon guredinsuchawaythatitisnot`formattingcompatible'then5youshouldconsidercarefullytheneedsofuserswhoneedtocreatepGortabledoc-5uments.HrA6goGodVwaytoprovidefortheirneedsistomakeavqailable,#inaddition,5astandardformofL5ffA͉TU>'ExXwithoutany`formattingincompatible'customisations.'č5Con guringffcompatibilitymos3de5When-proGcessingdocumentsthatbeginwith\documentstyle,bL5ffA͉TU>'ExX2"-㦲tries5toUUemulatetheoldL5ffA͉TU>'ExX2.09systemasfaraspGossible.5latex209.cfguT5Whenever(aL5ffA͉TU>'ExXdoGcumentstartswith\documentstyle,\ratherthanwith5\documentclass,1L5ffA͉TU>'ExXhassumesthatitisaL5ffATU>'ExX2.09doGcumentandtherefore5proGcessesUUitin`compatibilitymode'.qThisdoesthefollowing:DNsetsUUthe ag\@compatibilitytrue;DNinputsUUthe lelatex209.def;DNinputsUUthe lelatex209.cfgifitexists.5The^L5ffA͉TU>'ExX2.09set-upallowed^theformatitselftobGecustomised.:Whenmaking 5theUUformatwithiniTU>'ExX,theproGcessendedwiththisrequest:NInput?anylocalmodificationshere.6Pso5IfyoursitedidinputanymoGdi cationsatthatpointthentheL5ffA͉TU>'ExX2"*`compat- 5ibilitycmoGde'willnotfullyemulateL5ffA͉TU>'ExX2.09asinstalle}'datyoursite.Incthis5casedyoushouldputallthese`loGcalmodi cations'intoa lecalledlatex209.cfg5andoputthis leinthedefaultinputpathatyoursite.These`loGcalmodi ca-5tions',althoughn}notstoredintheformat,willthenbGeloadedbeforeanyold-style5doGcumentisprocessed.;ThisshouldensurethatyoucancontinuetoproGcessany5oldUUdoGcumentsthatmadeuseofthislocalcustomisation.'č5Con gurationff lesforstandardpackages5andffclasses5MostUQofthepackqagesinthedistributiondonothaveanyassoGciatedcon guration5 les.qTheUUexceptionsarelistedhere.!65sfonts.cfguT5The5 lesfonts.cfgcancontaindeclarationsrelatingtotheuseoffontsinthe5slidesUUclass.qIfitexists,itisreadinsteadofthe lesfonts.def.5PleaseUUnotethatuseofthiscon guration lehasthefollowingconsequences.DNSincejthefontset-upforslideshasnotyetbGeenrevisedto tmodernNusage,thes&contentofthis leshouldbGecompletelyupdatedsometime.NThusGanyonewritingsuchacon guration lemustbGepreparedtoupdateNitUUforusewithfuturereleases.DNDoGcumentsERareportableonlyinthesenseofbeingprocessableatadi erentNsite|theƁactualformattingwillnotbGethesameifdi erentfontsareused.DNTheL5ffA͉TU>'ExX3pro8jectteamwillnotbGeabletosupportyouindiagnosingNproblemsifthesecannotbGereproducedwithaformatthatdoesnotuseNthisUUcon guration le.!65ltxdo]c.cfguT5TheU leltxdoc.cfgcanbGeusedtocustomisesomeaspectsofthebehaviour5ofytheltxdoGcclass; thisclassisusedtotypesetthedocumentedcodeinthe5.dtx> les.xIfthis leispresentthenitisreadinatthebGeginningofthe le5ltxdoc.cls.5As#nthis leisreadbGeforethearticleclassisloaded,Vyoumaypassoptionsto5article.SsF*orYexamplethefollowinglinemightbGeaddedtoltxdoc.cfgtoformat5theUUdoGcumentationforA4paperinsteadofthedefaultUSletterpapersize.N\PassOptionsToClass{a4paper}{article}7\ so5Y*ouIshouldnotehowever,LthatIevenifpapGersizeoptionsarespeci ed,Ltheltxdoc 5classj;alwayssetsthe\textwidthparameterto355pt,ottoenable72columnsof5textttoappGearintheverbatimcodelistings._Ifyoureallyneedtoover-ridethis5youUUcoulduse:N\AtEndOfClass{\setlength{\textwidth}{?...}}5T*oUUsetthe\textwidthtoyourdesiredvqalueattheendoftheltxdoGcclass.5Byedefault,mostofthe.dtxdoGcumentedcode lesinthedistributionwill 5proGducewa`description'sectionfollowedwbyfullsourcelistingofthepackqage.5If,youwishtosuppressthesourcelistingsyoumayaddthefollowinglineto5ltxdoc.cfg:N\AtBeginDocument{\OnlyDescription}5TheAdoGcumentationoftheltxdocpackqage,|whichAmaybGetypGesetfromthe le 5ltxdoc.dtx,UUcontainsmoreexamplesoftheuseofthiscon guration le.!65ltxguide.cfguT5Theqclassltxguideisusedbythe`guide'doGcuments,suchasthisdoGcument,in5the:L5ffA͉TU>'ExXdistribution.wA con guration leltxguide.cfgmaybGeusedwith5thisǜclassinawayǜverysimilartothecustomisationoftheltxdoGcclassdescribed5inUUtheprevioussection.'č5Con gurationffforothersupps3ortedpackages5The~@`graphics'bundleofpackqagesneedstwocon guration les,zprimarilyto5spGecifyRthedriverusedtoprocessthe.dvi lethatL5ffA͉TU>'ExXproduces.More5doGcumentationonthese lescomeswiththegraphicsbundlebutwemention5themUUhereforcompleteness.5graphics.cfguT5Normallythis lejustspGeci esadefaultoption,bycalling\ExecuteOptions,5forUUexample\ExecuteOptions{dvips}or\ExecuteOptions{textures}.5This2 leisreadbythegraphicspackqage,andsoa ectsallthepackqagesinthe5bundleUUthatarebasedongraphics:qgraphicx,eps g,lscapGe.5colo"r.cfguT5Normally*this leisidenticaltographics.cfg.EItspGeci esthedefaultdriver5optionUUforthecolorxpackqage.8 ghso5Non-standardffversions5IfyoufeeltheneedtomakeaversionofL5ffA͉TU>'ExXthatdi ersfromthestandard 5versioninwaysthatarenotpGossibleusingtheabovecon gurationpossibilities,5thenyoushould rstreadMo}'difying-L雍QATKß'E-Xinthe lemodguide.tex;thiswill5probablyUUmakeyourealisethatyoudonothaveanysuchneed.5Thuswwearesurethatyouwillneverneedtocreateanon-standardversionand,5eveniifyoudocreateone,wehopGethatyouwillnotdistributesuchaversion.5Nevertheless,youarepGermittedtodothisprovidedyoutakegreatcaretodo5theUUfollowing:DNrespGect.theconditionsinlegal.txtandindividual lesregardingmodi ca-NtionUUof lesandchangingthename;DNchange-_alltherelevqant`\typeoutbanners':]i.e.thoseproGducedbyalltheNnon-standardUU lesinyourversionandbytheformat;DNensurethatthemethoGdusedtorunyourversionisclearlydistinguishedNfromS"thatusedtorunstandardL5ffA͉TU>'ExX;Se.g.byusingacommandnameorNmenuUUentrythatisclearlydi erentfromlatex(orLaTeXetc).!65ExamplesuT5SincewehavebGeenprompted,Kdespiteourmisgivings,todoGcumenthowtodo5thisbymembGersoftheLeagueforProgrammingF*reedom,Oitseemsappropriate5toP describGehereapossiblemodi cationofL5ffA͉TU>'ExXtoproduceasystemcalled5fsfTU>'ExX.5T*o,dothis,byoushouldcreatea lecalledfsftex.texandthenrunitusing5iniTU>'ExXUUandthestandardL5ffA͉TU>'EXformat.5The5contentsofthe lefsftex.texshouldbGeasshownonpage10. fgThe5particularchangestotheL5ffA͉TU>'ExXkernelthatyouwishtomakeneedtobGeadded5to4#the leatthepGositionindicated.1Y*oucanalsochoosetheextensionsyou5wantUUtousefortheclassandpackqage lesinyoursystem.9 qiso5&Cscmtt8%@fsftex.tex 5%5%@iniTEXSourcecodetomakea`fsftex'format.5%5%@TomakethisformatonUnix:5%5% initex@\&latexfsftex5%5%@Thentoruntheformatonfile.tex:5%5% tex@&fsftexfile5%5%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%5%@***VERYIMPORTANT!!!***5%@Changethetypeoutbannersousersknowthatthey5%are@NOTrunningStandardLaTeX.5\everyjob{\typeout{fsfTeX@1.0basedonLaTeX2e\fmtversion}}5\makeatletter5%@fsfTeXchangessomeLaTeXinternals:5% ...@putwhatyoulikehere...5\def@\fsf@xxxx{Somearbitrary\emph{freelymodifiable}codegoeshere}5%@fsfTeXclassfileshaveextension.fcl(thisweek):5\def@\@clsextension{fcl}5%@fsfTeXpackagefileshaveextension.fsy:5\def@\@pkgextension{fsy}5%@ChangethefilehandlingsothatwhenafsfTeXpackageorclass5%@isnotavailable,thestandardLaTeXfilewillberead.5%5%@Forexample,\documentclass{article}willloadarticle.fclifsuch5%@afileexists,butarticle.clsotherwise.Thisallowsarbitrary5%@processingon`article'documentswithoutchangingthestandard5%@article.clsfile.5\let\fsf@missingfileerror\@missingfileerror5\def\@missingfileerror#1#2{%=\ifx@#2\@clsextensionF\InputIfFileExists@{#1.cls}%N{\wlog@{fsfTeX:loading#1.clsratherthan#1.#2.}}%N{\fsf@missingfileerror@{#1}{#2}}%=\elseF\ifx@#2\@pkgextensionN\InputIfFileExists@{#1.sty}%W {\wlog@{fsfTeX:loading#1.styratherthan#1.#2.}}%W {\fsf@missingfileerror@{#1}{#2}}%F\elseN\fsf@missingfileerror@{#1}{#2}%F\fi=\fi5}5\makeatother5\dump10{5; &Cscmtt8%kAH cmssbx10$N cmbx12# cmmi10K`y cmr10ٓRcmr7