; TeX output 2001.04.10:1527so~$DtGGcmr17Installation7tDiagnosticswith߆TG cmtt12diagnose.sty7tvqersion0.2XQ cmr12OlivrerCor fd߆T cmtt12corff@zedat.fu-berlin.de%»April10th,2001'5Nff cmbx12Contents5"V cmbx101DIn9troQduction152DTheT'ExX2 b> cmmi10"-packqages-withextensivefunctionalityareideallywrittenwith 5the9suppGorto eredbytheL5ffA͉TU>'ExX2"-Ŭinstallationinmindasitdoesnotmake5senseytoreinventythewheelorcopycoGdefromotherpackqages.2Ifapackqage5makesuseofotherpackqagesinthesystemthereshouldbGeameanstotestfor5theUUpresenceoftherequiredpackqage,orarequiredtoken.DDepGendingontheresultofthistest,severalsituationsarepossible.CEither5thecallingpackqagefailscompletely*,lorfailstoprovidetheintendedservicein5its/ffullscopGe,eorhastocheck/fforsomealternative.Inanycase,eaninforma-5tivemessageshouldbGewrittenintothelog leandpGerhapsalsointothetext5doGcument.DTU>'ExX/andL5ffA͉TU>'EX2".providebasicfunctionalityfortestingtheexistenceof5 lesandtokens;thispackqagegoGesastepfurtherandprovidesmechanismsfor5informingUUthesoftwareUUandtheuserabGoutadetectedcondition.DBesidesprovidingasimplemechanismforrepGeatedreferencestotheexis-5tence*ofa leortoken,3theotherimpGortantapplicationisforcheckingwhether5a9complexapplicationcanbGeusedimmediatelyafterinstallingorwhetherit5requires8additionalsoftware8tobGeinstalled. qF*orthispurpose,1L5ffA͉TU>'ExXpackqages5canvnowbGeaccompaniedbyasimpletextdoGcumentwhich,whencompiled,5checkstheuser'senvironmentandmakessuggestionsabGoutmissingsoftware,Uif5necessary*.qAnUUexampleofthisideaisgiveninthe lemls-diag.tex.1*so52MLTheff߆Tff cmtt12diagnosePackage5TheUUdiagnosepackqageisincludedwiththeusualt}5\usepackage{diagnose}5statement.qThereUUarenooptionsatpresent.qThefourcommandso eredare:t|A81.N\PackageDiagnostics>A82.N\TokenDiagnosticsA83.N\TextMessageYesA84.N\TextMessageNo-5N cmbx122.1S\PackageDiagnosticsuT5\PackageDiagnostics{}?%Testedpackage {}?%Associatedcounter{}?%messageiffileavailable{}?%messageiffilenotavailableQDThis:commandveri eswhethera leisavqailablewithintheTU>'ExXdirectory5structure.r5It$isbasedontheL5ffA͉TU>'ExX2"-Scommand\IfFileExists !", cmsy10fgando ers5theXpGossibilitytocreateacounterwhichisassoGciatedwiththeexistenceofthe5requestedo le.GThecountercanthenbGeusedthroughoutthesoftwarewithout5additional4callsofQ\IfFileExistsfg.[TwomessagetextscanbGegiven;)?onewill5bGeUUprintedifthe leexists,theotherwillbeprintedifthe leisabsent.DBySdefaultthemessagetextsappGearinthelog leandtheterminaloutput5oftherunningcallerprogram;SadditionallyitispGossibletohavethemessages5appGearUUintheoutputtextofthedocument.52.2S\TokenDiagnosticsuT5\TokenDiagnostics{}?%Testedtoken?{}?%Associatedcounter?{}?%messageiftokenavailable?{}?%messageiftokennotavailableQDThisXcommandveri eswhetheratoken(acommandsequence,7etc.)isknown5to}thesystem.DLike\PackageDiagnosticsitacceptsanassoGciatedcounterand5twoUUmessagetextsasarguments.52.3S\TextMessageYesuT5Bysdefault,:messagesgeneratedbythetwodiagnosticscommandsappGearonly5interminaloutputandlog les.hjIfthemessagesshallalsobGedisplayedinthe5outputUUtextthenthecommandt}5\TextMessageYes5is,"tobGeused.d Itisnotfollowed,"byanyargument.d Bydefault,4_messagetextsdo 5notUUappGearintheoutputtext,onlyinlog lesandterminaloutput.2Πso52.4S\TextMessageNouT5IftoutputofdiagnosticsmessagestothemaintexthadbGeenenabledbefore,it 5canUUbGedisabledwiththecommand5\TextMessageNo5whichUUhappGenstobethedefaultofthediagnosticspackqage.!č53MLExamples5Twosexamplesaregivenhere.J!Firsttheusageofthepackqagediagnosticscom-5mandQisshown,and,inQaseparate le,thereaderisinvitedtocompilethe5accompanyingdoGcumentmls-diag.texwhichshowsareal-lifeapplicationof5diagnose.sty.5\PackageDiagnostics{rotating.sty}?%Testedpackage:?{RotatingAvailable}?%Associatedcounter:?{Vertical?textpossible!}%messageiffileavailable:?{rotating.sty?notfound,noverticaltext!}%messageifnot5\ifnum\theRotatingAvailable=1^You?canuseverticaltextinyourdocuments.Nofurther^measure?isrequired.5\else^Without?the\textttt{rotating.sty}packageverticaltext^cannot?betypeset.Ifyouneedthisoption,thenaccess^CTAN?andinstall\texttt{rotating.sty}onyoursystem.^Make?sureyoucanprocessPostScriptoutput.5\fiDThe5actualoutputofthiscommandsequencewilldepGendonthepresenceof5rotating.styUUonthesystemwherethissource leiscompiled:NY*ou7canuseverticaltextinyourdoGcuments.gNofurthermeasureisNrequired.DY*oucanalsoseethatthelog leandtheterminaloutputcontaintheap-5propriateUUmessage.!č54MLLegalffStatus5ThisUUsoftwareisplacedundertheGPL.Usualdisclaimersapply*.DAsthissoftwaretoGolisstillunderdevelopment,suggestionsonhowtoim-5proveUUtheusabilityandversatilityofthispackqagearehighlyappreciated.3;N cmbx12߆Tff cmtt12 cmmi10K`y cmr10ٓRcmr7"