=nRhDOCTOR User's Guiden DOCTOR { Contents   Examples  Figures  Tables  ;Index/ EXAMPLESEXAMPLES|(<#=A3-1GlossaryentryforDOCTOR/GLOSSARY3- 1 Glossary entry for DOCTOR/GLOSSARYxdl ,,=@4-1SampleMessagesourcefile4- 1 Sample Message source fileo"5%=@4-2SampleDOCTOR/MESSAGEoutput4- 2 Sample DOCTOR/MESSAGE outputHl=A5-1Originalfile5- 1 Original fileH\=A5-2Modifiedfile5- 2 Modified files$7%=A6-1 Conformant PostScriptskeleton6- 1 Conformant PostScript skeleton,A,=@7-1 Hierarchylistproducedby DOCTOR/SDML7- 1 Hierarchy list produced by DOCTOR/SDML&x&:,=A7-2ExampleDEC/MMS descriptionfile7- 2 Example DEC/MMS description file:m!4=@7-3OutputofDOCTOR/SDML/INDEX7- 3 Output of DOCTOR/SDML/INDEXT~)='=A8-1SampleDOCTOR/TAG_COUNToutputfile8- 1 Sample DOCTOR/TAG_COUNT output file`_l))=@9-1Sample .SDML_XREFoutput9- 1 Sample .SDML_XREF output{-FIGURESFIGURES]l((=@6-1Saddlestichedprinting6- 1 Saddle stiched printingl+TABLESTABLESUl$$=A6-1FONTkeywordvalues6- 1 FONT keyword valuesll$00=A6-2 Extractingorremovingfigures6- 2 Extracting or removing figures0H2=A7-1Tagsthatcauseotherfilestobeincluded7- 1 Tags that cause other files to be included!|(<+=@7-2 DOCTOR/SDML qualifiersforDEC/MMS7- 2 DOCTOR/SDML qualifiers for DEC/MMS6dl ,,=A9-1 Alphabeticlistofsymbols9- 1 Alphabetic list of symbols-C&=A9-2Chaptersymbols-in alphabeticalorder9- 2 Chapter symbols - in alphabetical order*@&=@9-3Chaptersymbols-in numericalorder9- 3 Chapter symbols - in numerical order-/ CONTENTSCONTENTS8 E[TitlePageTitle Page@E\ CopyrightPageCopyright Page1xE\PrefacePreface |&>,$L1DOCTORataglance-Quick Overview1 DOCTOR at a glance - Quick Overview$>g$K1.1 Questions1.1 Questions%:g $L1.2Answers1.2 Answers++C5$A1.2.1Addblankpagestoa PostScriptpfile1.2.1 Add blank pages to a PostScript file,.E+$A1.2.2Extractpagerangefromp PostScriptfile1.2.2 Extract page range from PostScript file02I.$@1.2.3Addingdiagonalwordingtop PostScriptpages1.2.3 Adding diagonal wording to PostScript pages6)?0$A1.2.4Addingfootersto PostScriptppages1.2.4 Adding footers to PostScript pages87P2$A1.2.5Addingheaderstopagesofap PostScriptdocument1.2.5 Adding headers to pages of a PostScript document=1H*$A1.2.6Extractfiguresfromap PostScriptdocument1.2.6 Extract figures from a PostScript document?2H'$@1.2.7 Re-arrangepagesfor!p saddle-stitchprinting1.2.7 Re-arrange pages for saddle-stitch printingC+B-$A1.2.8ListofanSDMLdocumentp composition1.2.8 List of an SDML document compositionF-C/$A1.2.9Automatedocument generationpusingMMS1.2.9 Automate document generation using MMSI~(>*$@1.2.10PrepareSDMLfileforp Bookreader1.2.10 Prepare SDML file for BookreaderM/X+$@1.2.11Producealistofall @@indexpentries1.2.11 Produce a list of all index entriesQ-E4$A1.2.12Producealistofallsymbolspdefined1.2.12 Produce a list of all symbols definedU+@-$A1.2.13Cross referencingbetweenp documents1.2.13 Cross referencing between documents[cl,,$@1.2.14SortaGlossarysection1.2.14 Sort a Glossary section_[l(($A1.2.15Countalltagsused1.2.15 Count all tags usedb=]$A1.2.16CreateSDMLp$pfromVMSMessagesource1.2.16 Create SDML from VMS Message sourcee\l(($A1.2.17Definedummysymbols1.2.17 Define dummy symbolsiOw!!$L2DOCTOR's components2 DOCTOR's componentsm1H$$K3 DOCTORingSDMLfiles:$ Sortingglossaryentries3 DOCTORing SDML files: Sorting glossary entriesq<g $L3.1Overview3.1 OverviewrKw$K3.2Sortingprocess3.2 Sorting processvAg$K3.3Sortorder3.3 Sort ordery:w $L3.4Options3.4 Optionsx%;$$K4 DOCTORingVMSMessage sourcefiles4 DOCTORing VMS Message source files<g $L4.1Overview4.1 Overview/F,$K4.2 Commenting requirementsfor&amessagefile4.2 Commenting requirements for a message fileu$9"$L4.3Includeresultin& documentation4.3 Include result in documentation-C'$K4.4DOCTOR/MESSAGEFeatures&onMessageFiles4.4 DOCTOR/MESSAGE Features on Message Files-D($K5 DOCTORingSDMLfilesfor  Bookreaderoutput5 DOCTORing SDML files for Bookreader output<g $K5.1Overview5.1 Overviewo!6"$K5.2ExampleofONLINE& conversion5.2 Example of ONLINE conversionfw!--$K5.3 Including predefinedsymbols5.3 Including predefined symbolsp"6%$K5.4 Generating additional&symbols5.4 Generating additional symbolsRw##$K5.5Thingstoremember5.5 Things to rememberKl$@5.5.1Using/OUTPUT5.5.1 Using /OUTPUTQl""$A5.5.2Using /VERSION_15.5.2 Using /VERSION_1Iw$K5.6Addingsymbols5.6 Adding symbolsOw!!$K5.7Adding references5.7 Adding referencesTw$$$K5.8Addingfigurefiles5.8 Adding figure filesQw##$K5.9Whatmustyoudo?5.9 What must you do?~(>-$K5.10mRemovingorrenewingadded&symbols5.10 Removing or renewing added symbols^w))$K6 DOCTORing PostScriptfiles6 DOCTORing PostScript files<g $K6.1Overview6.1 OverviewRw##$K6.2Addingblankpages6.2 Adding blank pagesVw%%$L6.3 Replacingtheprolog6.3 Replacing the prologOw!!$K6.4 Extractingranges6.4 Extracting rangesgw!..$K6.5Removingorre-usingfigures6.5 Removing or re-using figuresQl""$@6.5.1Removingfigures6.5.1 Removing figuresUl$$$@6.5.2 Extractingfigures6.5.2 Extracting figuresXw&&$K6.6Saddlestichprinting6.6 Saddle stich printingvl'77$@6.6.1UsinganLPS40toprintthefile6.6.1 Using an LPS40 to print the filevl'77$A6.6.2UsinganLPS20toprintthefile6.6.2 Using an LPS20 to print the file^g))$K6.7Minimal conformantfiles6.7 Minimal conformant files lS$$L7 DOCTORingSDMLfiles:/  hierarchyoffileswithinabook<g $K7.1Overview7.1 Overviewcw,,$L7.2Listingallincludedfiles7.2 Listing all included filesew --$K7.3 ProducingMMSrebuildfiles7.3 Producing MMS rebuild files+t#9+$K7.4UsingtheMMS description&file7.4 Using the MMS description file>Y\''$A7.4.1Whatfiletobuild?7.4.1 What file to build??ol%22$A7.4.2Anotherdoctypethan specified7.4.2 Another doctype than specifiedD)>+$@7.4.3Another destinationthanp specified7.4.3 Another destination than specifiedGv%9)$A7.4.4UsingDOCUMENT/GRAPHICSp(Rags)7.4.4 Using DOCUMENT/GRAPHICS (Rags)Jcg,,$K7.5Retrieveallindexentries7.5 Retrieve all index entriesO+B$$L8 DOCTORingSDMLfiles: Countingtagsused8 DOCTORing SDML files: Counting tags usedZ<g $K8.1Overview8.1 Overview[:w $L8.2Options8.2 Options]Gw$K8.3Outputformat8.3 Output format^6w $K8.4Usage8.4 UsageaRw##$K9 DOCTORingXREFfiles9 DOCTORing XREF filesb<g $K9.1Overview9.1 OverviewcXw&&$K9.2Buildsymbollistings9.2 Build symbol listingsgz&<.$K9.3Buildcross referencesymbol&file9.3 Build cross reference symbol filemIw$K9.4Exampleoutput9.4 Example outputvVl%%$@9.4.1Symbolfileoutput9.4.1 Symbol file outputyRl##$A9.4.2Listfileoutput9.4.2 List file output|al++$A9.4.3Sortedlistfileoutput9.4.3 Sorted list file outputBx\CommandSectionCommand SectionAgEKDOCTOR/GLOSSARYDOCTOR/GLOSSARY?gELDOCTOR/MESSAGEDOCTOR/MESSAGE=gEK DOCTOR/ONLINEDOCTOR/ONLINE5g EK DOCTOR/PSDOCTOR/PS9g EL DOCTOR/SDMLDOCTOR/SDMLCwEKDOCTOR/TAG_COUNTDOCTOR/TAG_COUNT9g EK DOCTOR/XREFDOCTOR/XREFE$\AMErrormessagesA Error messagesKw$KA.1DOCMSGMessagesA.1 DOCMSG MessagesKw$LA.2DOCTORMessagesA.2 DOCTOR MessagesQw""$KA.3 DTAGCOUNTMessagesA.3 DTAGCOUNT MessagesOw!!$KA.4GLOSSARYMessagesA.4 GLOSSARY MessagesKw$LA.5MARFINMessagesA.5 MARFIN Messages'Kw$KA.6ONLINEMessagesA.6 ONLINE Messages3Kw$KA.7PSSCANMessagesA.7 PSSCAN Messages=Kw$KA.8SADDLEMessagesA.8 SADDLE MessagesTGw$LA.9XREFMessagesA.9 XREF Messagesg/ EXAMPLESEXAMPLES|(<#=A3-1GlossaryentryforDOCTOR/GLOSSARY3- 1 Glossary entry for DOCTOR/GLOSSARYxdl ,,=@4-1SampleMessagesourcefile4- 1 Sample Message source fileo"5%=@4-2SampleDOCTOR/MESSAGEoutput4- 2 Sample DOCTOR/MESSAGE outputHl=A5-1Originalfile5- 1 Original fileH\=A5-2Modifiedfile5- 2 Modified files$7%=A6-1 Conformant PostScriptskeleton6- 1 Conformant PostScript skeleton,A,=@7-1 Hierarchylistproducedby DOCTOR/SDML7- 1 Hierarchy list produced by DOCTOR/SDML&x&:,=A7-2ExampleDEC/MMS descriptionfile7- 2 Example DEC/MMS description file:m!4=@7-3OutputofDOCTOR/SDML/INDEX7- 3 Output of DOCTOR/SDML/INDEXT~)='=A8-1SampleDOCTOR/TAG_COUNToutputfile8- 1 Sample DOCTOR/TAG_COUNT output file`_l))=@9-1Sample .SDML_XREFoutput9- 1 Sample .SDML_XREF output{-FIGURESFIGURES]l((=@6-1Saddlestichedprinting6- 1 Saddle stiched printing+TABLESTABLESUl$$=A6-1FONTkeywordvalues6- 1 FONT keyword valuesll$00=A6-2 Extractingorremovingfigures6- 2 Extracting or removing figures0H2=A7-1Tagsthatcauseotherfilestobeincluded7- 1 Tags that cause other files to be included!|(<+=@7-2 DOCTOR/SDML qualifiersforDEC/MMS7- 2 DOCTOR/SDML qualifiers for DEC/MMS6dl ,,=A9-1 Alphabeticlistofsymbols9- 1 Alphabetic list of symbols-C&=A9-2Chaptersymbols-in alphabeticalorder9- 2 Chapter symbols - in alphabetical order*@&=@9-3Chaptersymbols-in numericalorder9- 3 Chapter symbols - in numerical orderB9* Copyright1990,1994Digital Equipmentbv ~AllRights Reserved.&)DigitalInternalUseOnlyQS'ODOCTORO:User'sGuide5  ODon'tPanicWOJThisdocument describesthe functionalityoftheDOCTORutilitythatVOallows manipulationofseveralVAXDOCUMENTrelatedinputoroutputHOfilesaswellas (minimal) conformant PostScriptfiles. /]O{Althoughitssizehasgrownovertheyears,itiseasyreadingandyou\Omayonlyneedtoreadasinglechapterifyou'reonly interestedina&OsinglefeatureofDOCTOR.g='ORevision/Update Information:^DOCTORV3.3lB!ODocumentreleasedate!x 3-JAN-1994 17:24:16.39^44SDOCTORis proprietaryDigitalsoftware P&&DigitalInternalUseOnly%    O OO January1994 OeOThe informationinthisdocumentissubjecttochangewithoutnoticeandshould^O?notbe construedasa commitmentbyDigital Equipment Corporation.-DigitalfO Equipment CorporationassumesnoresponsibilityforanyerrorsthatmayappearinOthis document.fO_Thesoftware describedinthisdocumentis furnishedunderalicenseandmaybeVOusedorcopiedonlyin accordancewiththetermsofsuchlicense.lO=Noresponsibilityisassumedfortheuseor reliabilityofsoftwareon equipmentthataOisnotsuppliedbyDigital Equipment Corporationorits affiliated companies.iO RestrictedRights:(Use, duplication,or disclosurebytheU.S. GovernmentissubjectrO\to restrictionsassetforthin subparagraph(c)(1)(ii)oftheRightsin TechnicalDataCOandComputerSoftwareclauseatDFARS 252.227-7013. O73O|Digital EquipmentB.V.1990,1994. OAllRights Reserved.)OZ Processedinthe Netherlands OMOThisdocumentwaspreparedusingVAX DOCUMENT,Version2.1.* "  a I7&DigitalInternalUseOnlyO0Preface %OLocationand installationEO4TheDOCTORutilitycanbefoundinandcopiedfrom0t &NSIC00::PSQ:[PUBLIC.SOURCES.DOCTOR]*.*T *OThisincludesthe .EXE0x executableimageandsomedocumen-NOtationforavarietyofoutputdevices, including bookreaderIO5format.+Thisdocumentisalsolocatedthere.+DOCTORre-OquiresV%lAX/VMSV5.4-2orhigher. t!OFrom V3.3-24 onwards, DOCTOR.EXEpwill work on all OVC}AX/VMSsystemswhetherornotDEC/CMSis installedOO5asaversion managementproduct.'Beforethisrelease,aspe-Ocialversion DOCTOR_NOCMS.EXE1pisrequiredforsitesthatdonot#OhaveDEC/CMS available.| +RKOTouseDOCTOR properly,itmustbeinvokedasaforeignIOcommand.,Thisisachievedbydefiningasymbol(prefer-PO5ablyinyourlogincommand proceduresoitisalwaysdefined+Owhenyoustartasession)ast $%DOCTOR%:==&$ disk:[dir] DOCTOR.EXEh > OThe disk:[dir];gpartmustbethelocationwhereyoucopiedWOtheprogramfileinto.'Ifmanypeopleusethisutility,itisad-PO5visabletocopytheprogramintothe directorypointedtobyOlogicalname- DOC$LOCAL_TOOLS ].rHHOIfthisisalldone,you'rereadytousetheDOCTOR.  ImportantNOwBecauseDOCTORisa collectionoftoolsunderone umbrella,NOitis importantthateach invocationstartswiththequali-IO(fierthat indicateswhichtoolyouwanttouse:)either( DOCTORFO /GLOSSARY, DOCTOR/PS, DOCTOR/SDML,DOCTOR/ONLINE,DOCTORO /MESSAGE z, DOCTOR/TAG_COUNT orw DOCTOR/XREF .NJOAquickoverviewonhowtouseDOCTORandwhatitcan)Odoforyou,isprovidedin/Chapter1,DOCTORataglance-O5Quick Overview.n$D@O@O LOFor problems,QAR's,and questions,pleasesendamailto&OTheodeKlerkviaeither NSIC00::KLERK orT TheodeKlerkO5 @UTOF5.After mid-December1993theE-mailaddresswillbeO NSIC00::KLERK:4.BecauseDOCTORisan unfunded, free-timeLOproduct,nosupportis guaranteedorimplied.*However,theMO>authorwilltrytokeepDOCTORuptodatewheneverpossi-OOble.(An additionalplatformfor discussionsonDOCTORisits%O conferencenotesfileon IJSAPL::DOCTOR ."O AvailabilityofDOCTORLO4Thisutilityisaproductof DS/CountryProgramOfficeinMOthe Netherlands.-Itis developedtobeusedwithinDigitalOO EquipmentCo.+AsofJanuary1st,1993itisallowedtousePO>thistooloncustomersites,providedthe following conditions;Oare explicitly communicatedtothe customer: #K`1.:DOCTORisDigital proprietary software.*ItmaynotbeK(further duplicated, distributedorsoldotherthanthroughDigital channels.G`2.:DOCTORisan unsupportedproduct.*Althoughbugre-FYports, enhancementrequestsare welcomed,no guaranteeMisgivenorimpliedthatany modificationwillbemadeto DOCTOR. OAcknowledgementsLO4DOCTORcameinto existence initiallyaftersome discussionsPOwithMarkDevriesonthetopicofblankpagesin PostScript. tPOTheunderlayfeaturestoinclude"draft" diagonallyacrossthePOpagewasinitallywrittenin1988asa PostScriptroutinebyJO5LanceMcNulty,andlater re-createdformoregeneraluseKObyChrisMackay,whoalsoprovidedthecurrent PostScriptOcodeforthe  /PS/CHANGE function. KOWill Kohlbrennerprovidedmuchofthe informationrequiredCOto interprettheXREFfilesforcross referencing.p OThe /ONLINE8codeinVAXSCANfinallyacceptednestedNOtagsaftervitalhelpfromBarryRogoffinshowinghowthe>O5TRIGGEREXPOSEandNOTANYhadtobe combined.KOMaryUttprovidedtestfilesand functionedastesterofCO/ONLINEwhileV2.0wasstillin engineeringphase. GOOtherswhowerevitalin providingmewithsomecru-LOcialanswersto questionsraisedduringthe developmentofHO5DOCTORareSheilaHuston,SheilaLawner,DavidandTomO Parmenter.1KOUnfortunately,severalofthesepeoplenolongerworkforNODigitaland continuedtheircareeroutsidethecompany-bySO5choiceordueto Digital'srestructuring.)Itwasa privilegetoOworkwiththem. O TechnicalChangesIO4Unfortunately,thereisa non-upwards compatibilityissuePOforusersofDOCTORV3.0orearlierandthoseusingV3.1orOhigher. @OYoumayneedtomodify command procedures using%ODOCTOR,iftheyusethe DOCTOR/SDML/MMSJutilitytopro-KO5duceanMMSfiletorebuildthe document.-All qualifiersPOrelatedtothe specificationofadoctypeor destinationnameMOneededtobe reworked,asDCLcouldnotalways distinguishKO>betweenthemasmorethanthefirstfour characterswereO identical.jq @'ORemovedarethe qualifiers." /LN03, /POSTSCRIPT,/LINE_PRINTER,O /MAIL, /BOOKREADER4.Thesame functionalityisnowmade>O5 availableinasingle qualifierwith keywords:\ /DESTINATION=(LN03=%,% POSTSCRIPT=%,& LINE_PRINTER=%,%MAIL=%,& BOOKREADER=&) FODefaultsettingswhennot mentionedremainedthesame=O(LN03,PS,LINE,MAILandBOOKrespectively).! z-OAlsoremovedarethe qualifiers /DOCTYPE and /ONLINE_DOCTYPE .JOTheyhavebeenreplacedwithasimilarsingle qualifier:6a /DOCTYPE=(PAPER=%,%ONLINE=&,%MANPAGE=K)"aKOFromV3.3-22onwards,thereisanincompatibilityfortheO /ONLINE/DUMMY_SYMBOL2W qualifier.,BeforeV3.3-22thisqual-KO5ifierwouldacceptafilespecification.-FromV3.3-22on-+Owards,ittakestwo keywords: OUTPUT=whichstilltakes&Otheoutputfilespecand TEXT="string"toallowtheuserMO>tospecifyatextstringasvalueforeach undefinedsym-Obol./Bydefault, /DUMMY_SYMBOLisequalto /DUMMY_SYMBOL=,O "(OUTPUT=infile.SDML_DUMMY_SYMBOLS)&D,whichisthesamebe-#OHhaviourof pre-V3.3-22.#XGOFromV3.3-24onwards, thereisnoneedforaspecialDOversionofDOCTORthatdoesnotdependonDEC/CMS.FO5BynotcallingtheCMSroutinesdirectlybutthroughO LIB$FIND_IMAGE_SYMBOL4_,DOCTORwilldiscoveritselfwhether4OornotDEC/CMSis availableforuse.x *&DigitalInternalUseOnly>O4Example3-1:7GlossaryentryforDOCTOR/GLOSSARYO (Call%frame)O (call%frame)O@ H Next% definition%is%taken%from&Digital%Press% publication  "Digital& Dictionary".O WO` (Standard%data% structure%built%on%the&stack&during%a& procedureWO or%function%call,%starting%from&the%location% addressed%by%the&frameSO pointer&(FP)% register,&to&lower& addresses.%Same%as%stack%frame.)HOY (This%comment&belongs%to%the&Call%Frame%entry)O (Channel)DO  (This%comment&belongs%to%the&Channel%entry)OR (I/Ochannel)O (channel)ZO (Logical%path& connecting%user%process&with%a%physical%device%unit3t* to%allow% communication%to%the%unit.)  m! p&DigitalInternalUseOnly"O\2.2DOCTOR's! componentsROTheutilityconsistsofseveralmoreorless independentparts,IO:eachworkingonsomesortoffileproducedbytheVAXHODOCUMENT typesetting software.'OnlythepartthatworksTOon PostScriptfilescanalsobeusedforother PostScriptfiles,?OCaslongastheyadheretotheAdobe specifiedC minimalconfor-O mantJ.file structure.'ThisisdefinedinAppendixCofthe" e RedO Book",the1 PostScriptLanguage ReferenceManualE, publishedJOMbyAddison&WesleyforAdobeInc.(DOCTORsupportsbothHOtheAdobe structuredcommentsversionsV2(usedbyVAX@ODOCUMENTV1.2BandV2.0-1)andV3(usedbyVAXOWDOCUMENTV2.1-1).xnNNOThetypesoffilesthatcanbehandledbytheDOCTORare::o!  `  PostScriptfiles `O :OXREFcross referencefilesofVAXDOCUMENT ` 0SDMLsourcefilesofVAXDOCUMENT `N JNMSGmessagefilesoftheVMSMessageutilitytoproduceSDMLfileshp>>OThesewillbe discussedinthenext chapters.nT$ *&DigitalInternalUseOnly6O4Example4-1:7SampleMessagesourcefileO .TITLE% doctor_msgO .IDENT%'V1.0')Ob .FACILITY%doctor,1/PREFIX=doc_ b1O .SEVERITY%SUCCESSO .BASE%1"O[ .SEVERITY% INFORMATIONAL [2O .BASE%1004O IDENT/FAO=2 3 2 !+ z ! z4^'z Explanation:% Indicates&the%current&version%of%the&utility%that%is%invoked._ !pThis&is& important%when&bugs%and&wishes%are% expressed&to&the% development  !pteam. R !  ! 5M' User&Action:%Specify%number%when% submitting&SPR's&or&QAR's.  !-DO* NOTIMPLK/FAO=1 r !+Z !% Explanation:&The% specified% functionality%is%not%yet& implemented,%evenC !pthough%the&command% interface&is&already%present. J !K !%User%Action:&Wait%till%the%next%release&or&inquire%at  !$ NSIC00KLERK. 6 " !-POj SENDQAR /FAO=1  !+] !% Explanation:&You%managed&to&give%a%set%of%input%data%that&caused%theXB !putility&program%to%go%to%"catch&all"% statements%that&should%never !pbe%reached. !Z !%User%Action:&Please%notify%the& developers%by%SPR&or&QAR,% describingUa !pthe%error%and& specifying%the&version%of%the&software&used,&theX !perror%messages% displayed%and&possibly&a%sample&of&the%input%filesZ !pthat&caused%the%error%to%occur,&together&with%the& specified%command9 !p statement. ! !-4 &DigitalInternalUseOnly7OExample4-2:7SampleDOCTOR/MESSAGEoutput.O (DOCTOR%Messages\MSG_DOCTOR) F1O #O (COLON\:\0\0\\\:) `7PO[ (IDENT\This&is&(string)%version&(string))  [3O (IDENT)O (Severity) 2O3 INFORMATIONAL!O{ (Explanation) {4PO Indicates%the&current%version%of%the%utility%that&is&invoked.\O  This&is& important%when&bugs%and&wishes%are% expressed&to&the% developmentOS team."O (User%Action) 5>O Specify&number%when& submitting%SPR's%or%QAR's.QOL (NOTIMPL\Functionality%(string)&not%yet% implemented)O (NOTIMPL)O (Severity)O$ INFORMATIONAL!Ol (Explanation)IO The% specified& functionality%is%not&yet% implemented,%even@O though%the&command% interface&is&already%present."OD (User%Action)9O Wait&till%the&next%release%or%inquire&at$O NSIC00KLERK. `6]O= (SENDQAR\Internal&error.%Please%send%QAR.&Error&ID:%(string))O (SENDQAR)O (Severity)O INFORMATIONAL!O] (Explanation)LO You%managed%to%give&a%set&of&input&data%that%caused%theUO utility&program%to%go%to%"catch&all"% statements%that&should%neverO4 be%reached."O| (User%Action)HO Please%notify&the% developers&by&SPR%or%QAR,& describingRO the%error%and& specifying%the&version%of%the&software&used,&theUOT error%messages% displayed%and&possibly&a%sample&of&the%input%filesWO that&caused%the%error%to%occur,&together&with%the& specified%commandO statement.OM (COLON) M 8O  qo&DigitalInternalUseOnly8O\3.5 DOCTORing#SDML#files:5Sorting"glossaryOentriesr O3.1BOverviewOUUsingtheU DOCTOR/GLOSSARY1U qualifierinvokestheglossaryitemPOsortutility.+Itwillaccepttheinputofanyproperlycoded"OSDMLsourcefilewith (entriesandsortstheseinLO^ ASCIIbeticalorderwithsomesmall correctionsonitscol-%Olating sequence.)Undera properlycoded#file,itis understoodOthatonlyasingle  s- blockexistsin Ohtheh .SDMLHhfile.)Multiple glossariesinsideasinglefilearenot O supportedbyDOCTOR.Js!  UOTheglossarydoesnotneedtobetheonlypartofthefile:*itLOmaybeembeddedinalargerSDMLfile.*OnlytheglossarySO5partissorted.'Text precedingor followingtheglossarysectionOremains untouched. _UNote _@An informationalheaderisproducedintheout-6putfile.*Thisheaderis recognizedby! *GL*markers.CHWhennewentriesareaddedtoa previouslysortedfile,j DOCTOR/GLOSSARY-willremovetheoriginalheaderGandreplaceitbyanewone.+ThiscanonlybedoneDRiftheheaderremains untouched.*(Itcanalwaysbe*manuallyremoved,ofcourse). stMIOKnown limitations-O4The following limitationsapply:u `1.:Onlyasingle 2dblockcanexistintheinputfile.C(Multiple glossariesinonefilearenot supported. `2. DOCTOR/GLOSSARY!ignoresany  or Ktagsinsidethe glossary.)Thismayleadtowrongresults?YifacommentblockincludesallorpartofaY  / *tag.-Itmaythenalsocause  and  > tobesortedto differentpartsofthefile.FcCommentblockswithintherangeofasingleglossaryDtermarenoproblem.,Commentblocks belongingtoa-glossarytermshouldfollowits5 [,notpreceedit.?lCommentblocksshouldalsonotspanorincludel tags.Av O3.2BSortingprocessOU DOCUMENT/GLOSSARY?Usortstheinputfilebylookingforthefirst!Olinethatcontainsa .Wtag.'Anything precedingthistag>Owillbecopiedverbatimintotheoutputfile.w! |(OAll text between the first ;tag and the tagO >owillbesorted accordingtothetextualargu-O5mentofthe 5 9I5tag.(Aglossarytermis consideredtobe=Oalltextfromthestartofthe correspondingh tagupto&Othepositionofthenext (orthefinal  ).PO>ThismeansthatitispossibletoinsertothercodesuchasO  ,   or  6withinthistextblock-eitherinside Othe and associated, )/tag argument,orasasep-=OHaratetag,notnestedwithinan argument,asHExample3-1Oshows.*w OxNyJ$O3.3BSortorder O(The( <8(tagscanbecodedinupperor lowercaseorMOmixed.*Theglossaryentriesareallsortedbytheirupper-JOcase equivalent.,However,theoutputretainstheoriginalO1representation.zHOThesorting mechanismhasbeen implemented similarlyto Othe /INDEX8keywordsof DOCUMENT.Ifyoudon'tspec-DOiifyanythingthere,youdon'tspecifyanythingwithi DOCTORO /GLOSSARYBtokeep consistentsortinginindexand glossary.JOThe followingoptionsare possible,whichareinvokedby'Or specifyingkeywordstother /SORTr qualifier: {  OO/SORT=K Description OOAWORD9KASortsatermletterbyletter(alsonon-7K alphabetical charactersinthemiddleof7Kwords)andtreatsspacesandhyphensas7K) significant.!Mutual exclusivewithLETTEROLETTER9KSortsatermletterbyletter(alsonon-7K alphabetical charactersinthemiddleofwords),ignoringspacesandhyphens.!Thisis6Kthedefault.!Mutual exclusivewithWORDFONONALPHA=AFTERaPlacetermsstartingwithnon-alphabetic?KS charactersattheendoftheglossary(follow-King"Z")GONONALPHA=BEFORE<Placetermsstartingwithnon-alphabetic>Kh charactersatthestartoftheglossary(pre-Kceding"A")CO/NONALPHA=IGNORE1Ignore nonalphabetic characters.)E.g.5K|"69WAYS"issortedas"WAYS".'ThisisKthedefault. O|{OThedefault) /INDEX=(LETTER,NONALPHA=IGNORE)is identicalto!OtheDOCUMENTdefault.}KOSomeattemptismadeto translate multinational charactersBObackinto"english characters"without punctuation:~POAny occurrenceinthefirststring(matchstring)isreplacedMObythe characterinthesecondstring (translationstring):)Oa '')O 'AAAAAAACEEEEIIIINOOOOOOOUUUUY' O3.4BOptionsKOUTherearefewoptions availableonthesorting mechanism.OThe qualifier3 /OUTPUT9Sallowstospecifyanotheroutputfile.'ByTOdefaultthenexthigherversionoftheinputfileiscreated.(ASO^warningthatapurgemaydeletetheoriginalfileisissuedinOthatcase. &DigitalInternalUseOnly'O4Example5-1:7OriginalfileO (unsymboled)&O (section% head1\s1_1) O 

\O Test&for%V1.2B%and%V2% differences:&it&should%not%add&symbols%for&V1.2B"O (A% subheader)5O| It%should%not&add%one%if%it%had&one>O (A% subheader&with%symbol\subheadsymbol)HO- Test&for%informal%figures&-%should&add% figurefile&onlyOu 

%O (ps\fig.ps\10)O JOn Test&for%symbol%adding,% reference%adding&and%file&adding#O 
(figure%caption),O "(ln03\ln03fig.six\10)OF 1O Test&for%same,%no% reference%addingO (f1_1)(O? 
(figure% caption\f1_1),O "(ln03\ln03fig.six\10)O DO8 Test&for%same,%no% reference%adding,%no%file&addingO (f1_2)(O 
(figure% caption\f1_2),O "(ln03\ln03fig.six\10),OX "(book\bookfig.fse\10)O 3O Test&for%same,% reference%adding&only(OQ 
(figure% caption\f1_3),O "(ln03\ln03fig.six\10),O "(book\bookfig.fse\10)O) :O Test&for%same,% reference%adding&only%again(O 
(figure% caption\f1_4)(O" (42\left&blank)Oj :O Test&for%same,% reference%adding&only%again(O 
(figure% caption\f1_5)Oc  somethingO O; 1O Add%symbol&and% reference%to%table.O (small&table)O4 (2\10)-O| (%1%\&the%only&row)O &O- (section% head1\s1_2)!O (section%head1)G -  - &DigitalInternalUseOnly'OExample5-2:7Modifiedfile*O (unsymboled\BK_ADDED_1)&O (section% head1\S1_1) O5 

\O| Test&for%V1.2B%and%V2% differences:&it&should%not%add&symbols%for&V1.2B-O (A%subheader\BK_ADDED_2)5O. It%should%not&add%one%if%it%had&one>Ov (A% subheader&with%symbol\SUBHEADSYMBOL)HO Test&for%informal%figures&-%should&add% figurefile&onlyO' 

%Oo (ps\fig.ps\10)(O (BOOK\FIG.fse\10)O JOh Test&for%symbol%adding,% reference%adding&and%file&adding.O 
(figure%caption\BK_ADDED_3),O "(ln03\ln03fig.six\10),O@ "(BOOK\LN03FIG.fse\10)O *O (BK_ADDED_3\FULL)1OZ Test&for%same,%no% reference%addingO (f1_1)(O 
(figure% caption\F1_1),O2 "(ln03\ln03fig.six\10),Oz "(BOOK\LN03FIG.fse\10)O DO+ Test&for%same,%no% reference%adding,%no%file&addingOs (f1_2)(O 
(figure% caption\F1_2),O "(ln03\ln03fig.six\10),OK "(book\bookfig.fse\10)O 3O Test&for%same,% reference%adding&only(OD 
(figure% caption\F1_3),O "(ln03\ln03fig.six\10),O "(book\bookfig.fse\10)O $O (F1_3\FULL):O Test&for%same,% reference%adding&only%again(O6 
(figure% caption\F1_4)(O~ (42\left&blank)O $O/ (F1_4\FULL):O Test&for%same,% reference%adding&only%again(O 
(figure% caption\F1_5)O( p somethingO O $Oi (F1_5\FULL)1O Add%symbol&and% reference%to%table.*O
(small&table\BK_ADDED_4)Ob (2\10)-O (%1%\&the%only&row)O *O[ (BK_ADDED_4\FULL)&O (section% head1\S1_2),O- (section%head1\BK_ADDED_5)w] 3&DigitalInternalUseOnly,O(Table6-1:7FONTkeywordvalues OD CJNotethatall PostScriptfont specificationhyphens@aarereplacedby underscoresfortheDCLkeywordO-{ Times_RomanOG-{ Times_BoldO-{Times_BoldItalicO:-{ Times_Italic#O-{NewCenturySchlbk_Roman"O.-{NewCenturySchlbk_Bold(O-{NewCenturySchlbk_BoldItalic$O!-{NewCenturySchlbk_ItalicO-{ HelveticaO-{Helvetica_Bold"O-{Helvetica_BoldObliqueO -{Helvetica_ObliqueO-{CourierO-{ Courier_Bold Ov -{Courier_BoldObliqueO -{Courier_ObliqueOi -{AvantGarde_BookO -{AvantGarde_Demi#O] -{AvantGarde_DemiOblique#O -{AvantGarde_BookObliqueOP -{LubalinGraph_BookO -{LubalinGraph_Demi%OD -{LubalinGraph_DemiOblique%O -{LubalinGraph_BookObliqueO7-{Souvenir_LightO-{ Souvenir_Demi O+-{Souvenir_DemiItalic!O-{Souvenir_LightItalic O z x&DigitalInternalUseOnly8O(Table6-2:7 Extractingorremovingfigures OD O QualifierResult O O/FIGURE.Default.!Leavesfigures untouchedOi/FIGURE=EXTRACTNiExtractfiguresintoseparatefilesbytheiroriginalnames.4FiguresalsoremainininputdocumentjO1/FIGURE=(EXTRACT,PAGE_NUMBER)Extractfiguresintoseparatefiles.&ThesefileshavetheQ~samenameastheinputfilespec,butappendedtoitisthe9pagenumberonwhichthefigure occurred.OE /NOFIGURE3ERemovesfiguresfromtheinputfile.O/NOFIGURE=EXTRACTKRemovesfiguresfromtheinputfile.$Extractfiguresinto6 separatefilesbytheiroriginalnames.lO/NOFIGURE=(EXTRACT,PAGE_NUMBER)eRemovesfiguresfromtheinputfile.$ExtractfiguresintoOseparatefiles.!ThesefileshavethesamenameastheinputN!filespec,butappendedtoitisthepagenumberonwhich othefigure occurred. O E+ "&DigitalInternalUseOnly1O4Figure6-1:7Saddlestichedprinting\ +--------+--------++--------+--------++--------+--------++--------+--------+  |   |:  || D  |  ||   |  ||  | J  | R | R |:R || DR |R || R | R || R | J R |  |  |: || D | ||  |  ||  | J  |  |  |: || D | ||  |  ||  | J  | ) | ) |:) || D) |) || ) | ) || ) | J ) | q |8 q |q 1||2 Dq |oq 7||6 q | q 3||4 q | $ q 5|\ +--------+--------++--------+--------++--------+--------++--------+--------+" front%sheet%1d" back%sheet%1" front%sheet%2d " back%sheet%2 (u&cDigitalInternalUseOnly M  1D(ThankstoKevin Mandersontopointthisouttome&DigitalInternalUseOnly9O4Example6-1:7 Conformant PostScriptskeletonO %!PS-Adobe O %%O@ %%CreationDate:Kdate O %% O %%' ...other%header& comments... O %%O` %%EndComments8` (or&a%line%not%starting%with%%%%or%%!) O %% O %%  ...prolog& commands... OY %%O %%EndProlog#O, %%Page:&folionrKordinal$ ...main&body%of%text...#O %%Page:&folionrKordinal$g ...etc%for&all%pages...&O %%BeginDocument:& (filespec)D ...encapsulated% PostScript%code&of&included& figure...O` %%EndDocumentO %%Trailer(J%k&DigitalInternalUseOnly5O\5.8 DOCTORing%SDML%files$for$ BookreaderOoutputO5.1BOverviewGOUVAXDOCUMENTcanbeusedtobuildbooksforprintingPOonpaper,butalsoforusingthemasonlinebooksusingthe>O DECwindows BookreaderoneitherVMSorULTRIX.T*DOUnfortunately,the BookreaderproductimposesamoreNOstrictuseofsomeofthetags, availablein DOCUMENT,duePO5toitsuniquefeaturesof"popup"elements(tables,figures,HO examples)thatappearwhenyouclickona"hotspot".8! KOBecauseanypartofthedocumentmustbe accessiblefromPOthetableof contents,asymbolmustbeattachedtothemsoTO5animplicit referenceismadefromthetableofcontentstotheOsectionpointedat.! WO DOCTOR/ONLINE>MwillgothroughyourSDMLfilesandaddsym-QObolswheretherearenone,andalsoadd referencestopopupRO5 elements,wherenoneiswritteninthetext.(IfyouspecifyaWOprofilefile,allelementswillalsobe searched,aswillanyfileO referencedina tag.) Specifying' /LOGwillshowyou&O>whichfilesare accessed.}S1OThe followingtagsaremodifiedby: DOCTOR/ONLINE :! j `   ,  ,9  ^,  ,  ,  ,  O,{ *-asymbolisaddedifnotqpresent `   i,  ,  ,  U,I  4I,`I  I,I  I, I "I-a#symbolisaddedunless /VERSION_1is specified. `! !formal!  C!,l! 
 |!,! 
%!-asymbolisaddedifynotpresent,ay ytothemiscreated ` # (book\..\..)-isaddedto supplementexisting,Qfiguresforother destinations.yO-OThe followingtagsareusedby DOCTOR/ONLINE :v L `   D,n  , ##-toreadthesefiles+(aswellduringthe processing `  8-tocreateasimilaronefortheBOOK destination. `  7totrackdownall referencestosymbols `  30whichdefines additionalsymbolsthat!Wmaybe referencedbyW  W. `  1whichdefinesasymbolforauser / specifiedbooktitle `   ,6  and tags.JDuringPass1,whenallsymbol informationis collected,F`DOCTORwillskipanyconditionalizedtextblockwhoseJ conditiondoesnotmatchthecurrent conditionalsetting.KItwillhowever,generatesymbolsforalltagsthatneed*ione, regardlessof condition. fJOTopreparefilesforusewithDOCUMENTV1.2ByoushouldOspecifyZ /VERSION_1;.)Noharmdoneifyouforgot:)justrepro-"O5cessthosefileswith+5 /VERSION_1%5andanysymboladdedonQOtagsthatshouldnothaveasymbolforV1.2BwillberemovedOagain.".O5.2BExampleofONLINE conversionKOUAnexampleoforiginalinputversus convertedoutputfileOcanbeseenin'eExample5-1,Originalfile 0andExample5-2,OModifiedfile.*epOnDrrOO+ (-O5.3B Including predefinedsymbolsQO(Inmanycases,abookalsousesasetof predefinedsymbols,/tagsareusedthatrefertoun-PO^defined sections.(Eitherbecausetherewasatypingerror,orPObecauseasectionwasremovedorbecausethesectionhasyetOtobewritten.WDOWhenDOCUMENT processesasourcefilethatcontainsGOmorethan30 undefined references(oranyotherwarn-PO5ing message),itwillabortafterthe30thmessage.)ToavoidDOthis,youcaninstruct DOCTOR/ONLINEtogenerateanNO additionalfilethatproducesvaluesforallthese undefined O>symbols:'specifythe/> /DUMMY_SYMBOL.> qualifier.rH+OItthenproducesafilewithH tagswhereGOthe value of each symbol is simply setto the valueO5 (reference)4X5tag./WhenthesourcedocumentisnowCO processedwith DOCUMENT,thefinaltextwillprint O"j (/ undefined_symbol  )+".+Ifthistextis unwanted,%O>youmaydefineyourown> undefined_symbol>textusingtheO /DUMMY_SYMBOL=(TEXT="_ string ? ")keyword.& QOThe processingoftheentiredocumentisnow possible,despiteIOthe undefinedsymbol referencesbythecommand sequence:-a #DOCTOR/ONLINE/DUMMY_SYMBOL=(OUTPUT=a dummy_symbol_fileTa ,%TEXT=" a string_ a ")%- inputfile.SDML DOCUMENT/SYMBOL= dummy_symbol_file. inputfile.SDML%doctype% destination$ N>OTogeneratesuchasymbolfile,the qualifier /DUMMY_SYMBOLS is&O required.'Whennokeywordd OUTPUT=*is specified,itdefaultsto,O5 "input_file_name.SDML_DUMMY_SYMBOLS D5.! rOODuringthe collectionofdefinedsymbols(inPass1),DOCTORTOobeysthesettingof conditionaltags.'IfaconditionalizedblockTO5oftextdoesnotmatchthecurrent condition,itisignoredandUOallsymbolsdefinedinthatblockarealsonotseen,i.e.'remainGO undefinedandhencewillbeoutputtothedummysym-QO>bolfile.+Youcansetaspecific conditionthrougheithertheO 3insidetheSDMLfileorthroughthe DOCTORO /ONLINE /CONDITION=# qualifier.OWhenthe /SYMBOL< qualifierisalso specified,thesymbolsde-KOfinedinthatsymbolfilearenotcopiedintothedummy6O5symbolfile.(Ifyouwanttoincludea%}5 (symbol_file_spec)OOintothe generateddummysymbolfiletobesureyouinclude#Oboth,thenthekeyword" /DUMMY=(INCLUDE_SYMBOLS)>is required.QO>Thisisusefulifyouwanttoprocessthefinaldocumentus-IOingboththe predefinedsymbolsandthe generateddummy)Oones.)Becauseonlyasingle9 /SYMBOLS=$ qualifierisallowedon OHtheH DOCUMENT;!Hcommandline,youcanspecifythe generatedJOdummysymbolfile,whichnow automatically referencesthe)O predefinedsymbolsthrougha tag.M##O5.5BThingstorememberV\O5.5.1BUsing/OUTPUTO4Usingthe4 /OUTPUT=74 qualifierallowsyoutoletDOCTORcre-OOatemodifiedoutputfileswitha differentnameor extensionQOthanthe orginals.*Thisallowsyoutokeeptheoriginalfiles@O= untouched.'Oneofthree approachesis suggested:]! 3`1.:Specify /OUTPUT= disk:[dir],only.)Thiswillmoveallmod-L(ifiedoutputfilesintoaseparate directory.*Youcanat-Mtempttobuildtheonlinebooksfromthere.'OncetheyareLcodedthewayyouwantit,youcandeletethe originals.'2Thisisthepreferedway.`2.:Specify /OUTPUT= .filetype2+only.'ThiswillcreatethemodifiedN filesinthesame directory,buttheyallhavea different cfile extension,e.g.ic .SDML_BOOK-c.OnceallfilesarecodedtoEyourliking,youcansimplyRENAMEthemintonormalKSDMLfiles.* Processingallfileswithmodifiedfiletypes(lmaycause problems,asthel  4landl ]ltagsEinsidethefilesstillrefertotheoriginalfiles.`D3.:SpecifyD /OUTPUT=[ ]7lD.)ThiswillcreatenewversionsoftheIfilesinyourcurrent directorywiththesamenameandRfile extensionasthe originals.'If originalsarealsoinyourFNdefault directorythen obviouslythenewcreatedones$ supersedethe originals. *WIfyouspecifyW /OUTPUT=.SDML+WtheoutputwillalwaysbeinMtheoriginal directoryofthesourcesandthenewversions*will supersedetheoldones. _UNote _Whenno; /OUTPUT[is specified, DOCTOR/ONLINEwillusekthefiletypek .SDML_ONLINE-Pk,toprevent unintentionalloss+ofthe originalsbyapurge. ! j"O5.5.2BUsing /VERSION_1JO4Thereisadistinct differencein processingbetweenVAX@ODOCUMENTV1.2BandV2.0orhigher..TheV2+al-"Olowsasymbolonthee  ,  t,  z=,=  1=,^=  =,=  z=,=  Oand 4 tags,whereasV1.2Bdoesnot.-IfyouOspecify[ /VERSION_1=,nosymbolsareadded.*Infact,ifanyis?OG encountered,itisremovedandplacedinsideaG oGtag.QO Therefore,ifbyaccidentyou processedfilesforV2(thede-QOfault)anysymbolsthatshouldnotbeaddedforV1.2Bcanbe:OQremovedby reprocessingthesamefilewithyQ /VERSION_1 Q.G! 2O5.6BAddingsymbols+OUEachsectiontagsuchasthemU (header)yUtag,withoutaNOsymbolwillbegivenone.+ThisisdonebyaddingauniqueOsymbol_ BK_ADDED_nnn9where 4 nnn)isa generatednumber.'Also=O^files processedbeforecanbe re-processedas^ DOCTOR/ONLINEVOfirstlooksforthepresenceofanyofthosetags,andwillgen-KOeratenewoneswhichstartfromthehighestfoundnumberOh nnn+1J4h.(Thesesymbolsare generatedforalltagsthatrequirePOone, regardlessofwhethertheyareembeddedina conditional6Otextblockwhose conditionisnotmet. !O5.7BAdding referencesPOUWhiletheDOCTORsearchesthroughthefiles,it registersallOOsymbolsfoundandtriestomatchthemwiththe occurenceofOatleastone 6tag.'IfthedocumentisnotreadyforIO^ Bookreader destination processing,DOCTORwillhavefoundSOsomesymbolsthathaveno references.'IfthisisthecasewithPOeitheraformaltable,exampleorfigure,theseelementscan-VOhnotbe"poppedup"byclickingonahotspot,astheseonlyexistOwhenas =iscoded.,W2OToresolvethis,DOCTORwilladda{ Htothese8Opopupelements immediately followingthex  ",O5  P5or5 .G5.+ItwillnotattempttoembedPOthis referenceina sentence:+youmaystillwanttodothisQOby yourself.*Thelistfilethatcanbe generatedcontainstheKO> instructionsofwheremanual interventionmaybe required. <$O5.8BAddingfigurefilesKOUBecausefiguresmayhavebeen specifiedforknownprinterOO destinations,butnotforonlinebooks,theDOCTORwillalsoOadda/ <withinafigureblockifnofigurefortheO^ BOOKF^ destinationisfound.( Obviously,DOCTORwillnotgen-UOeratesuchafigure.(YouwillneedtocreateityourselfortryROtoconverttheexistingfigureintotheFSEformatrequiredbyLOhthe Bookreader.'RAGSandUTOXaretwotoolsthatcanas-ROsistyouinthisprocess.(RAGScanmakefiguresforallvalidAO destinationtypesofVAX DOCUMENT,UTOXcancon-SOrvertseveralfigurefiletypesintoothers.)However,ifasixelVOof PostScriptfileisallyougotofafigure,youwillhaveto"O#re-drawit.'UseRAGS.P &#O5.9BWhatmustyoudo?OUIfyouspecifytheU /LISTU qualifierto?U DOCTOR/ONLINE$U,youwillgetUOalistfilethatcontainsalltheactionsyoustillmustperform7Oafterthe documentshavebeen converted.m C6O5.10CRemovingorrenewingaddedsymbolsPOU Occassionallyitwillhappenthatyouwanttoremoveallau-JO tomatically generatedsymbols.)ThismaybethecasewhenQOanexistingpieceoftextneedstobe incorporatedinanotherMO^ document.(Orwhenabookiscreatedof individualelementsKOwhichatsomepointintimewereall processed individu-MOally.)Inbothcaseschancesarethatthedocumentelements=Ohcontain identicalsymbolsthatwere generated.tJJODOCTORallowsyoutwooptionstocorrectthis situation: o `1. DOCTOR/ONLINE/REMOVE.removesallsymbols generatedby6(anyprevious processingofafilewith,( DOCTOR/ONLINE(.ItGremovesthesymbolsduringPass1 processingandthenstops. `Y2.!Y DOCTOR/ONLINE/SUPERSEDE-IYalsoremovesall generatedsym-LbolsduringPass1but continueswithPass2togenerateG newones,thatare consistent throughoutthe document.JcInthisprocessfileswithout generatedsymbolsarecre-IatedduringPass1inthe specifiedoutput directory( /OUTPUT=D)andthesearethenusedtoscanforaddingnewHlsymbolsduringPass2.* ThereforeyouwillendupwithJtwonewversionsoftheoriginalfiles:+thenewestwithGnewsymbols,theonebutnewestwithoutany generatedvsymbols. _UNote _GDuetothefactthatVAXSCANisunabletoretrieveNthespecificfileversionitcreatesitwasdecidednottoF1deletethis intermediatefilewithoutsymbolsautomat-CicallyasDOCTORcanneverbedeadsureitdeletesCtherightversionalways.,Andwe'dratherbesafe:thansorry. !z &DigitalInternalUseOnlyHO(Table7-1:7Tagsthatcauseotherfilestobeincluded OD  Otag description O O (filespec)  19AnSDMLfile specifiedinaprofilefileOn (filespec) R 1AnAnSDMLfile specifiedinsideanotherSDMLfile.1O '(logical-name\file-spec)  1<A referenceintheprofilethatoneofthe  5filescontainsa5 &F 5withalogicalnamethatAmustbe translatedintothe specifiedfilespec.!O (file-spec)  1/Withinatable,insertsatable.BOv 8(target-device\file-or-space\vertical-size) Z 3v Specifiedwithina7 v 
{ v environment,andJ specifiesabinary graphicalfiletobeincludedinthe document.'O (file-spec) o 2D SpecifiesthattheTag Translatorshouldinsertthe" specifiedfilewithT H E/j Xmacrosatthisspot.#Itisa& .TEX&file,notan & .SDML &file.(target-device\file-spec\vertical-size)  3/Asafigurefile,butwithinan   context.#O (file-spec) j 1CAllowsatextfiletobeinsertedaspartofang  Rg.$O (dvi-file-spec)  3Allowsanother .DVI_  dest)E filetobeincludedbytheG.Device Converteratthispositionintheoutputfile. Oy  O 1*m Tag Translatordoes inclusion O 2*m; Text Processordoes inclusion O{ 3,m Device Converterdoes inclusion O &f U&DigitalInternalUseOnlyCO4Example7-1:7 Hierarchylistproducedby DOCTOR/SDMLO *MF*GO *MF*Created%by%DOCTOR&V3.0%at% 20-JUL-1992% 13:51:10.98 1O; *MF*GO *MF*Command%issued:% DOCTOR/SDML%PASCAL_DECPRESS.SDML/CMSO *MF*QAR's&to:/ Theo%de%Klerk%@UTO,J NSIC00::KLERKO *MF*O[ *MF*04[ ***&Digital%Internal%Use&Only%***O *MF*5O *MF*CMS%library&=%PSQ:[EXAMPLE.CMSLIB]O3 *MF*MO{ *MF*The% following%files%are& referenced%by%this%SDML&file:O *MF*O  *MF* FRONT.SDMLOR *MF*VMS.SDMLO *MF*Z PROCESS.PSO *MF*Z PSPACE.PSO* *MF*0Z* PSPACE.SIX%---&file%not&found&--- *2Or *MF*Zr SCHEDULE.PSO *MF*2Z SCHEDULE.SIX%---%file%not%found%---#O *MF*IMAGEACTIVATOR.SDMLOJ *MF*ZJ SOURCEFILE.PS#O *MF*PASCAL_ENHANCE.SDMLO *MF*%Z VARYING.PASK(CMS&library) 3O" *MF*+Z" STRING_SCHEMA.PASK(CMS&library)Oj *MF*Zj CONFORMANT.PAS0O *MF*ENVIRONMENT.SDMLK(CMS&library)O *MF* STARLET.SDMLOB *MF*ZB DESCFIG1.EPSO *MF* STORAGE.SDMLO *MF*Z VAL_VAR_CAL.PSO *MF*Z NOPICTURE.TXTOb *MF*Zb FOREIGN.PS)O *MF* CASE.SDMLK(CMS%library)1O *MF*BIBLIOGRAPHY.SDMLJ(CMS%library)O9 *MF* GLOSSARY.SDMLO *MF*O > (FRONT.SDML) > 4 (VMS.SDML)( (IMAGEACTIVATOR.SDML)( (PASCAL_ENHANCE.SDML)%] (ENVIRONMENT.SDML)! (STARLET.SDML)! (STORAGE.SDML)5 (CASE.SDML)&} (BIBLIOGRAPHY.SDML)" (GLOSSARY.SDML)  OU 46X p&DigitalInternalUseOnlyO 4DOCQUALIFIERS=/CONTENTS/INDEX/BATCH=(NOTIFY,NOPRINT)"O" .DECW$BOOK~.DECW$BOOK%: "4]j IF%"$(MMS$CMS_LIBRARY)"%.NES.%""%THENJ DEFINE/USER%CMS$LIB%$(MMS$CMS_LIBRARY)m $(CMS)&FETCH&$(MMS$CMS_ELEMENT)%$/OUTPUT=$(MMS$TARGET_NAME).DECW$BOOK% $(CMSFLAGS)% $(CMSCOMMENT)O .PS~.PS&:]c IF%"$(MMS$CMS_LIBRARY)"%.NES.%""%THENJ DEFINE/USER%CMS$LIB%$(MMS$CMS_LIBRARY)f $(CMS)&FETCH&$(MMS$CMS_ELEMENT)%/OUTPUT=$(MMS$TARGET_NAME).PS% $(CMSFLAGS)% $(CMSCOMMENT) ...&etcetera&...O} .SIX~.SIX%:] IF%"$(MMS$CMS_LIBRARY)"%.NES.%""%THENJ DEFINE/USER%CMS$LIB%$(MMS$CMS_LIBRARY)g $(CMS)&FETCH&$(MMS$CMS_ELEMENT)%/OUTPUT=$(MMS$TARGET_NAME).SIX% $(CMSFLAGS)% $(CMSCOMMENT)v ...&etcetera&...O .SDML~.SDML%:]' IF%"$(MMS$CMS_LIBRARY)"%.NES.%""%THENJ DEFINE/USER%CMS$LIB%$(MMS$CMS_LIBRARY)ho $(CMS)&FETCH&$(MMS$CMS_ELEMENT)%/OUTPUT=$(MMS$TARGET_NAME).SDML& $(CMSFLAGS)& $(CMSCOMMENT)O .SDML.DECW$BOOK%:^ $(DOCUMENT)%$(MMS$TARGET_NAME)&$(ONLINE_DOCTYPE)&$(ONLINE_DEST)&$(DOCQUALIFIERS)O .SDML.PS%:[ $(DOCUMENT)%$(MMS$TARGET_NAME)& $(DOCTYPE)%$(POSTSCRIPT_DEST)&$(DOCQUALIFIERS)O; .SDML.LN03&:C $(DOCUMENT)%$(MMS$TARGET_NAME)& $(DOCTYPE)% $(LN03_DEST)  $(DOCQUALIFIERS)O .SDML.LINE&:C4 $(DOCUMENT)%$(MMS$TARGET_NAME)& $(DOCTYPE)% $(LINE_DEST) 4 $(DOCQUALIFIERS)O .SDML.TXT%:C $(DOCUMENT)%$(MMS$TARGET_NAME)& $(DOCTYPE)% $(MAIL_DEST)  $(DOCQUALIFIERS)ON .GRA.SDML%:@ $(DOCUMENT)/GRAPHICS=RENDER&$(MMS$TARGET_NAME).GRA%-S I/TYPE=(PS,BRF,MONOSIX)/OUTPUT=$(MMS$TARGET_NAME)/NOBACKGROUND/SDML=FIGUREOG .DEFAULT%: 0G5+ !%No%action%for& $(MMS$TARGET)9O PROFILE.DECW$BOOK% DEPENDS_ONK PROFILE.SDML,&-!z@ BOOKREADER_FIX.SDML,&-z FRONT.SDML,&-z PART10.SDML,%-z VMS.SDML,%-z` PROCESS.FSE,%-z PSPACE.FSE,&- ...& etcetera...4Oz PROFILE.LN03% DEPENDS_ONJ PROFILE.SDML,%- kz6!z BOOKREADER_FIX.SDML,&-z  FRONT.SDML,&-zR PART10.SDML,%-z VMS.SDML,%-z PROCESS.SIX,%-z* PSPACE.SIX,&- ...& etcetera...2O PROFILE.PS& DEPENDS_ONK PROFILE.SDML,%-!zD BOOKREADER_FIX.SDML,&-z FRONT.SDML,&-z PART10.SDML,%-z VMS.SDML,%-zd PROCESS.PS,&-z PSPACE.PS,%-2 ...etcetera%for%all&other& targets...WO~ !&If&the%next& dependency%is%used,%one&should%not%submit&the%finalVO !&DOCUMENT&jobs%in%batch%mode%as%they&are%not%allowed%to%run%inOO !& parallel.%The%MMS&macro& DOCQUALIFIERS%should&be&defined%as*OV !&DOCQUALIFIERS=/CONTENTS/INDEX:O ALL_DOCUMENTS& DEPENDS_ON%PROFILE.DECW$BOOK,&- 7' PROFILE.PS,% PROFILE.LN03,&-$. PROFILE.LINE,& PROFILE.TXT#/v !&All%are%up%to%date!T &DigitalInternalUseOnly6O4Example7-3:7OutputofDOCTOR/SDML/INDEX%O (DOCTORinstallation)&D (34% DOCTOR.SDML)#O (DOCTORinvocation)& (58% DOCTOR.SDML)O@ (CONFORM)*@ (16%DOCTOR_MSG.SDML)O (CREATED)* (25%DOCTOR_MSG.SDML)$O (IDENT%-%See%DOCTOR)* (34&DOCTOR_MSG.SDML)"vW(L&DigitalInternalUseOnly M  2(LINEforLSEDIT#X\&DigitalInternalUseOnly M 1+"GOTOBUFFERname"forLSEDIT}]zuP&DigitalInternalUseOnly*O\6.2 DOCTORing! PostScript!fileskO6.1BOverviewKOU PostScriptfilesareproducedbyawidevarietyofprod-BOucts,suchasVAX DOCUMENT, DECwrite,DECpaintorLOMS-Word.*Withthearrivaloflaserprinterslotsofdocu-MO^ mentationisproducedinthe PostScriptformatandprinted..OSeveralproblemscanthenoccur: U ` LAfileprintishalfwayreadywhenthesystemcrashesorM(thejobgetsabortedforalltherightandwrongreasons. ` HOnlyasectionofadocumentis interestingtoprint. `' A'Some products,likeVAX DOCUMENT,donotproduceHblankpageswhenasectionendsonanoddpage.+ThisMcausesdoublesidedprinterstoskipapageandprinttheI1 followingsectiononthewrongsideofthepage(recto5pagesonversopagesandviceversa). `  K Thesamefileisneeded,butonewouldlikea differentHastandardpagelayout(e.g.(withDRAFTwrittenovertheIpage)asdefinedintheprologofthe PostScriptfile. `9 L9The PostScriptfilecontainsfiguresthatwereinsertedas" encapsulated PostScript+AandyouwouldliketoremoveOthosefromthefileortocreatethemasseparatefilesto!Cre-usethosefigures. ` IA PostScriptdocumentshouldbe re-orderedinpageout-KputtoallowforsaddlestichingofdoublesidedprintedJssheets(4 pages/sheet,likeamagazinewithpagesfoldedinthemiddle). WPOTheDOCTORutilityallowstodoallthisinaneasymanner,MOprovidedthe PostScriptfilethatmustbe inspectedadheresIO5toAdobe'sminimal conformantcodingstyle,as described OinSection6.7.CeThisisassumedtobetrueifthefirstlineof)Othe PostScriptfilecontains  %!PS-Adobe&,possiblefollowedbyaO>versionnumber.*P}? MODOCTORalsoadherestothecodingstandarditself.)Itpre-QOfixesthefileoutputwiththe followingstandardbanner,thatO5followsthe5 %!PS-Adober5headerline:O %!PS-Adobe-2.0EO %%Creator:pVAX&DOCUMENT&V2.0%modified%by%DOCTOR&V3.0 OI %%3O %%CreationDate:% 20-JUL-1992% 13:21:58.92 O %%AO! %%%Command&issued:% DOCTOR/PS&DOCTOR.PS/OUT=[]/BLANKAOi %%%File&used:&PSQ:[PUBLIC.SOURCES.DOCTOR]DOCTOR.PS;4O %%%QAR's%to:/ Theo%de%Klerk%@UTO,J NSIC00::KLERK O %%4OA %%***&Digital%Internal%Use&Only%*** O %% gNOBecausethisheaderpreceedsanyheaderthatiscopiedfromOOtheoriginalinputfile,theaboveentriesoverrule identicalQO5headerentries.(Theoriginalheaderline indicatingitscreator4Ohasbeenkept,butappendedwiththe DOCTORversion.(ThisisYOtoallowothertoolstostillretrievefromthislinetheoriginof O>the PostScriptcode.  Important [/HItisadvisedalwaystousethe+H /OUTPUTMH qualifiertoGspecifytheoutputfilespecification.+Ifomitted,theADOCTORwillmakethenexthigherversionoftheHRinputfile.(Thisis potentially dangerousasonemightH accidentiallydeletethisoriginalfilethroughpurging. #O6.2BAddingblankpagesOUUsingtheU /BLANK8U qualifierwillallowyoutoinsertaddi-NOtionalpagesintothe PostScriptfiletobalancethenumberIOofodd/evenpages.-Thisis especially importantforVAXLO^DOCUMENTfilesthat,bydefault,donotincludeanyblank9Opagesifachapterendsonanoddpage. MOThiswillmakesurethattheoutput document,whenprintedTOonadoublesidedprintingdevicewillhaveallrectoandversoPO5pagesprintedinthecorrect orientation.)Thisisalsoimpor-OOtantonsinglesideprintingdevices,wherethefinaloutputOOwillbestackedintoadoublesidedprinting photocopierma-KO>chineforfurther duplication.,TheinsertedblankpageisNOindeedblank:)nopagenumbersoranythingisoutputtotheHOpage,asDOCTORdoesnotknowhowthepagelayoutisOH composed. ) Restrictionforupdatepages R DOCTOR/BLANKRinspectsthelR %%Page:RcommentsintheE PostScriptfileand determinesfromthelastnumericApartofthefolionumber(suchas"Glossary-10")F[whetherornotapageneedstobe inserted.+ItcanConlymakethisdecisionproperlyfornormallyfor-I mattedbooks.)Ifthebookisbuiltusingupdatepages,Aetheendresultmaybe incorrect,asDOCTORcan-Fnotmaketherightdecisiononpagejumpslike4-3,I4-3.1or4-3.1,4-4.*Thelastdigitsareallodd,as-Fosumingthatablankevenpageneedstobe inserted.F Dependingonyourown feelings,thismayormaynot bedesired. jfQOIfyouplantoprintthe PostScriptfileinareducedformatRO(withtwopagesononesideofasheetofpaper),youshouldO5alsousethe5 /LEADING_BLANK-55 qualifier.+ThisinsertsablankPOpagebeforethefirstpageofthedocumentoutput,toensureQOthatthe positioningofrectoandversopagesisnotchanged:QO>thefirstpageofadocumentisarighthandsidepage,but=Owouldoccupythelefthalfofthepagewhen /LEADING_BLANKOhadnotbeenused. rwOWhenthe /LOG@} qualifierisalsoenabled,theDOCTORwilltell:Oyouwhenapageis inserted.&Forexample:QOa $& DOCTOR/PS%9DOW.PS/BLANK/EXTRACT=(START=7-1,NUMBER=4)/OUT=TEMP.PS/LOG;O %DOCTOR-I-IDENT,&This%is%DOCTOR&version%V3.0LO %DOCTOR-I-CONFORM,%File%assumed&to&conform%to%%!PS-Adobe-3.02O9 %DOCTOR-I-INSERTED,&Page%7-2Kinserted2O %DOCTOR-I-INSERTED,&Page%8-2Kinserted2O %DOCTOR-I-INSERTED,&Page%A-2Kinserted2O %DOCTOR-I-INSERTED,&Page%B-2Kinsertedblankpageoutputas specifiedintheprevioussection.! SOTheuser specifiedfilemustcontainalltherelevant PostScriptTO instructionstocreatetheblankpagetobe inserted.'Thiscould+O5include instructionstotypset,o5 ThispagehasbeenleftblankO intentionally< or somethingsimilar.*The instructionsshouldOcontainthe showpage0EcommandtooutputthepageduringMO> printing.,Itshouldnotcontainapageheaderintheform Oof %%Page:Aastheinternalpagefolio numberingandordinal /LEADING_BLANK1c pagewillnotusetheuserspeci-VO fiedfileforblankpages,asthisleadingpageisnot consideredLO5 partofthe document,butrathera placeholderbeforetheO document.9)%O6.3B ReplacingtheprologPOUTheprologofeach PostScriptfileissupposedtofollowtheSOinitialheadersectionandeitherstartsatthefirstlinethat Odoesnotstartwith  %! {or  %%1Gorafterthefirstlinethatcon-O^tains^ %%EndComments:^.,It continuesuntilthereisanexplicitO %%EndPrologEline.(Thislinemustbepresent,evenifnoprologOis specified.! aPOTheprologcontains definitionsandageneralpagelayoutap-POplicabletoallpages.*Hence,youcanaddorreplacecertainOO5featurestogivetheprintedpagesa differentlook,withoutSO modifyinganyofthetextthatispartofthedocumentitself.POYoucancreateyourownprolog,eitherbasedontheoriginalQO>one,orentirely homewritten,toreplacetheprologthatcomesSOwiththeinputfile.'Thiswayyoucanproduceeffectsaswrit-ROing"DRAFT" diagonallyacrossallpages,orprintafaintlogo>OHoneachpageorborderthetextinaframe.kBOTheuser specifiedprologfilemustendwiththe %%EndPrologO statement.; N@OToallowsomesimple modification,the qualifier /CHANGE_PROLOGLOhasbeen implemented.)YoucanspecifythreeitemsoneachO5page:w ` KAboldprintedtextatthetopofeachpage(aheader) `O OOAboldprintedtextatthebottomofeachpage(afooter),@withorwithoutan additional (page)numberadded `' I'Afaintlygreyprintedtext diagonallyacrossthepage.3Thegreyscalecanbeset manually.! WROThesethreetextitemsdonot interferewiththeoriginaltextWOinthe PostScriptfile.'YoucouldimagineitasprintingthisfileRO5on pre-printedpaperthathadthosethreeitemsonitalready.QOThetextonthediagonallineis dynamicallyadjustedinsizeTOsothattheentiretextfitsonasinglelinerunningfromtheDO>bottomlefthandcornertothetop righthandcorner. r OThe /CHANGE_PROLOG8comeswithtwelve keywords,allofwhichCOare optional,butatleastonemustbe specified:Oa /CHANGE_PROLOG=(TOP=:a "text"a ,%- BOTTOM= "text" ,%COUNTER= integer ,%- DIAGONAL= "text" ,%-9 BORDER,%- FONT=_ font_type ,&SIZE= number ,% GRAYSCALE=T number4  ,%- OUTPUT= file_spec ,%- HSIZE= pointsize ,%VSIZE= pointsize t -Y PAGESIZE=Y papertype DY ) XQOThefirstfour argumentsspecifythetexttobeusedfortheUOheader,footerordiagonalline.)Ifaspaceoccursinthistext,OO5theentiretextmustbeenclosedwithin quotationmarks.'TheTO specifiedtextsareusedfortheprologintheoutput PostScriptOfile. W OThe COUNTER@argumentallowsyoutospecifyanintegervalueQOthatwillbeprintedonthebottomline, followingthespeci-O5fied5 BOTTOMA5text.)Thecounterwill incrementwitheachpage.MOItallowsyoutonumberpagesthatwould otherwisebeun-OOnumberedandyoucanspecifythestartingvalueofthepageO> numbering sequence.{! Q OThe GRAYSCALE=`allowstospecifyhowdarkthegreydiagonalTOtextmustbe.(Itdefaultsto95%,whichislightgrey.(AvaluePO5of00wouldmakeit ink-blackand99almost invisiblywhite.UOThediagonaltextwill auto-sizetofittheentirelengthoftheRO diagonal.'BydefaultthetextisprintedinHelvetica-Bold,andRO>thetopandbottomlinesaresizedto15points.(However,you6Omayspecifya differentfontusingthe FONT=keywordandtheO SIZE=J$keyword.'Althoughanysize(inpointunits)is accepted,OOHvaluesabove20pointsseem(nopun intended) pointless.(The:Ofontsthatcanbe specifiedarelistedinTable6-1.*ca?}SIOAbordermaybeprintedaroundthepage specifyingtheO BORDERCKkeyword.+Bydefault,nosuch rectangularborderisKO<drawn(Notethat PostScriptprinterscanproducethesame*Oifwithprintingthecommand! PRINT/PARA=(NUMBER=1) isO specified).b! 8 OThe OUTPUTDkeywordallowsthe specificationofafilespecifi-SOcation.)Inthatcase,inadditiontousingthoseheader,footerUO5anddiagonallinetextsintheoutput PostScriptfile,aseparateNOprologfileiscreated containingthosesame definitionsforROheader,footerand diagonal.(ThiscreatedprologfilecanlaterO>beusedwiththe> /PROLOG/> qualifiertoreplacethestandard2Oprologwiththisnewlycreatedone.H OThetwokeywords HSIZE and| VSIZE$SareonlyneedediftheTOprologmustbemadetofitaspecificpagesize.'BydefaultA4OO5sizeisused.+Anyother dimensioncanbe specifiedinpointOunits. {5OAlternatively,youcanusethekeyword PAGESIZE5thatwillCO recognizethe followingstandardpapersizes:.LETTER,>O5LEDGER,LEGAL, EXECUTIVE,7X9,35MM,A5,A4,LOA3,B5,B4,C6,C5,C4.'ThekeywordPAGESIZEismutuallyO exclusivetoboth HSIZE and& VSIZE .a! 7!O6.4B ExtractingrangesOUUsingtheU /EXTRACT60U qualifieryoucanspecifytocopyonlyOOarangeofpagesfromtheinputfileintotheoutputfile.ferentrange,thefirstmatchisused, resultingintheshortestSOrangebetweenthefirstandlastpageofthe extractedsection. W$OYoucanspecifyseveral /EXTRACT* qualifierstoallowforsev-KOeralrangestobeincludedinthesameoutputfile..TheSO5rangesshouldnotoverlap.'Initssearchtoendonerange,theOODOCTORwillreadpastthe beginningofthenextsectionandNOtherebywillnever encounterthestartingpageagainofthe$O>sectionthat overlapped. OThe /LOGC qualifierwillindicatewhenarangeisfoundand=Owhetherintheendsomerangeswereskipped. !"OThevalidentriesforA START= ;and END=&canbefoundbydoinga $%SEARCH filespec.PS %%Page: NOcommandatDCLlevel.)ThiswillrevealallthepageheaderJOlinesofthe availablepageswithinthe PostScriptdocu-HO5ment.(ForAdobeV3comment standards,thepagenumbersKOareenclosedwithin parentheses.+YoudonotspecifytheseO parenthesesinthe START= and END=Dkeywordsofthe /EXTRACTO> qualifier.  Important [BHMany documentsconsistoftextand graphics,madeDby differentproductsandsomehowcombinedintotheAfinal document.+AseachproductproducesitsownR %%Page:<Rentries,someentriesmayseemoutoforderAfromtheusual incremental numberingofthepageBsequencenumber (ordinal).+Whenthisisthecase,>[DOCTORignoresthosepagecommentsandassumesHitissomesortofincludedgraphicandnotreallyaE page.* Thereforeyoucannotselectoneofthosepage2enumberstoselectarange boundary.  4_U7Note 4_ATheAdobecommentstandardalsoallowsforpagestobemarkedas: %%Page:.text5bwhere` textdoesDmnotcontainanumericpart.+Inthiscase obviouslyBDOCTORisnotableto determinewhatpageranges& are availabletoextract. i  .O6.5BRemovingorre-usingfiguresMOUA PostScriptfilecontainstextandpossiblyfigures.,ThoseIOfiguresareveryoftenmade separately(usingadrawingSOpackage)andtheninsertedintothetextbodybythetextfor-2O^mattingtoolsuchasVAX DOCUMENT'sV^  A^tag6Oor DECwrite's"LINKTOPICTURE"option.:! MO OccassionallythereisaneedtoeitherremovethefiguresOOfromthe PostScriptfile(toallowthe remaindertobecon-UO5vertedbacktoplainASCIItextfile)ortore-usethosefiguresOinother documents.O %POThe extractingorremovaloffiguresisbasedontheassump-HOtionthattheinput PostScriptfilecontainsthelinesOa %%BeginDocument:a figure_filespecCt ...&code%of%the& encapsulated% PostScript&figure%...O %%EndDocument[JOtomarkthebeginandendofeachincluded encapsulatedOfigure.W OInTable6-272allpossible combinationsare summarized.*Fa?)a"O6.5.1BRemovingfiguresNOForsometimenowseveraltoolsare availabletoconvertaQO_ PostScriptfilebackintoitsplainASCIItextfile.+ThiscanPOcomehandyifthesourcestoproducethe PostScriptfilearePOlostorpartofthedocumentcouldbeusedinanotherfile.[<1JOWithinDigitalthereisaPS2TEXTutilitytoenableyouLOtodothisonseveral PostScriptfiles,amongstwhichVAX>Oi DOCUMENT.However,ifsuchadocumentcontainsHOfiguresmadebysomegraphicspackage,theseshouldbeNOremovedfromthe PostScriptfilebeforea conversionisat-GOrtempted.+AgainDOCTORcomestotherescuebyallowing Othe /NOFIGURES,m qualifierthatwillremoveall O#includedfigures.OWhenthe /LOG@ qualifieris specified,itoutputsthenamesofJOthefigurefilesthatareremovedfromtheoutputfile.T`*$O6.5.2B ExtractingfiguresMO4Whenyouwanttoextractfiguresfromadocumentintoin-removedfromtheinput document. &O6.6BSaddlestichprintingLOUWhenonewantstouseaprinterthatallowsforprintingROonbothsidesofasheetofpaper,itmaybe advantageoustoQOprintthepagesonhalfformat (allowingtwopagesonasin-SO^glesheetside)andthenfoldthepagesinthemiddletomakeKOa signature(likea magazine),readyforsaddle stiching.NNOWhenthebookisverythick,onemaydecidetodividetheLObookintoseveralofthese signaturesandthenstichthemO5 together.! WQOInbothcasesthisrequirestheoutputorderofthepagesinQOthe PostScriptfiletobe modified.)Ratherthantheusualse-TO5quentialorderofpage1,2,3etc,wenowneedthefirstandSOthelastpagetobeprintedaftereachother(andonthesameROsheetsideifprintingissetupfortwo pages/sheet).)AndthenSO>page2andthe one-but-lastpageonthebacksideofthesheet.NNOAsasmallexample:)suppose8pagesA4mustbeprintedinLOreducedformatandfoldedasabrochureofsizeA5.,This@O5resultsin2sheetsofpaperas illustratedinh5Figure6-1.*hO^\QOTo rearrangetheorderofthepagesina PostScriptfiletheOcommand DOCTOR/PS/SADDLE=mustbeused. e_UhNote e_AItis importanttonotethatthetwo qualifiers G /PSE /SADDLEE must8Ebe specifiedtogetherandinthatorder.! WThe{W /SADDLE3W qualifiercannotbeusedincombina-Ctionwithanyoftheother PostScript manipulation qualifiers(like /EXTRACT,/CHANGEqetc.).,WFinally,W /SADDLE2Wonlyworksforprinting4pagesonJasheet(twooneachside).)Thereisnosupportfor4Iormorepagesprintedonasinglesideofasheetofapaper. ! ~IOYoumustindicatehowmanypageswillcomposeasigna-TOture.' Obviouslythismustalwaysbeamultipleof4.'Itdoesn'tKO5matterifyour PostScriptdocumentpagenumberisnotanKOexactmultipleofthis signaturesize:*DOCTORwillappendPOthe necessaryfinalpagestocompletethefinal signature.)IfMO>thedocumentonlyhas7pages,DOCTORwillcreateablankGO8thpagetoteamupwithpage1onthesamesheet.QOThenumberofpagestogatherforeach signatureis specifiedOHwith H /GATHER=E5H.)Ifyoudonotspecifythis qualifier,theentireQObookis consideredtobecomeasingle signature.)ThiswillbeRO convenientfortypicalbooksoflessthan32pages(8sheets).TORIfthebookisthicker,youshouldspecifyagathervalueyour-UOselftoallowforsaddlestichingthe individual signatureslater.OAlternatively,if /GATHER7isnot specifiedforathickbook,theTO[entirebookwillbeasingle signaturethatcanbeusediftheTOpagesarecutinthemiddletoproducetwostacksofthehalf-TO sizedsheetsthatarethengluedtogetherinaperfectbind(or/Oeby thermoglueorspiral binding).j@@O Additional qualifiersthatcanbe specifiedare: ] `  /LOG:for additional informationduring processing `O O /OUTPUT=DOtospecifyanoutputfilespecification.(BydefaultPthenexthigherversionoftheinputfileiscreated(andaKwarningisissuedthatpurgingwilldeletethe original). ` @)2 )2 /2UPDi.ThiswillcauseDOCTORtoprocessthefilepro-ducedwith} /SADDLE-oncemoreandmodifysomepageK1output PostScriptcodetoallowyoutoprinttheresult-IingfileonA3sheetswithtwoA4pagesprintedonaHside(ratherthanreducingeachpagetofittwopagesK:onanA4sheet).)Becausethecodeinsertedisveryspe-Dcific PostScriptforVAXDOCUMENTV2.1output,thisL qualifierisignoredif specifiedforanyother PostScript9Ddocumentandawarningmessageisissued.x NQOAlthoughitis possible,itusuallyaddstothe confusionandOO frustrationtotryand reorganizea PostScriptfilethatwasNO5 reorganizedbefore.(Italsoshowscommonsensetofirstma-NOnipulatethe PostScriptfileinallotherways(likeaddingNOblankpages, modifyingprologetc)beforetryingtore-orderRO>thepages.'The re-orderingshouldbethelastthingyoudoonCOa PostScriptfilebeforesendingittoaprinter. _UNote _?Becauseseveralproductsthatproduce PostScript2coderedefinethe definitionofthe showpagecommand,DRwhichisusedbyDOCTORtoinsert additionalblankJpages,the resultingoutputfilemayprintasasetofDblankpages.) Currentlythe following PostScriptout-A[puthasshowntoprint correctly(orDOCTORhasKspecialfeaturesbuiltintoproducethedesiredresult):: VAXDOCUMENTV1.2orhigher,DECwriteV2.0>eandhigher, DECpresentV1.0,All MS-WindowsV3? PostScriptfilesproducedthroughthe MS-Windows "WindowsPSCRIPT"*b converter(e.g.+MS-Powerpoint,o MS-Word).  Va7O6.6.1BUsinganLPS40toprintthefileKO4TheLPS40isonlycapableofsinglesided printing..ThisNOmeansthatyouwillgettwopagesonasheetandablankPObackside.'ThosepagescanserveasmastercopybeforeusingAO=themincopyingmachinesforfurther duplication. !w$OThecommandtogiveisS PRINT/QUEUE=lps40_queue&file.PS%/PARAMETER=(DATA=POSTSCRIPT,% NUMBER=2)! SOBydefaultallpagesare bordered.'Ifyoudon'twantthis,you/Oneedtomakesurethatthefile LPS$NOBORDERNUP.LUPexistsinaEO5system directorythatispointedtobylogicalnameq5 LPS$LAYUP 5.OOInthis directorythe PrintserversoftwarewilllookforanyQOlayup informationtopositiontheoutputontheprintedpages.& $&OThecontentsofthefile' LPS$LAYUP:LPS$NOBORDERNUP.LUPshould)Ocontainthe followinglines: O !&LPS$NOBORDERNUP.LUPSO !& specifies%a& variation%for%n-up% printing.KA%larger&left%margin_O !&is& specified%to%allow%for%hole% punching.KThis%file%is%for%single&sidedHOZ !& printing.%It%does&not%draw&borders%around&the%pagesO no%borders'O  margins&=%19,&19,%60,%19l i@OItisthen activatedthroughtheprintcommand:-t PRINT/QUEUE=LPS40_queue%file.PS%-ITP /PARAMETER=(DATA=POSTSCRIPT,% NUMBER=2,%LAYUP=LPS$NOBORDERNUP)! 7O6.6.2BUsinganLPS20toprintthefileTO4Ifsinglesideprintingis required,thesame operationsareap-ROplicableasfortheLPS40printingasoutlinedinthepreviousOsection.b<8SOIfdoublesidedprintingisrequiredtoproduceareadytouseNObookletordoublesidedmasterforfurther reproduction,the+O5 followingcommandis required:-t PRINT/QUEUE=LPS20_queueKfile.PS%-?# /PARAMETER=(DATA=POSTSCRIPT,% NUMBER=2,% SIDE=TUMBLE)J    OThe TUMBLECkeywordensuresthatallpagesareprintedintheNOright orientationandnotupsidedown,whichisthedefaultQO5fordoublesidedprinting(toalloweasyflippingthrough,but!Othat'sunwantednow). HOWhennobordersarewantedaroundthepages,thesameO LAYUPF$keywordcanbe specifiedas describedfortheLPS40. )O6.7BMinimal conformantfilesFOUAdobeInc.+defineda "Document Structuring ConventionsPOSpecification"for PostScriptfilesthat utilitiessuchasVAXBODOCUMENTandDECwriteshouldadhereto.+OnlythenMO^other utilitiessuchasDOCTORcaninspectthosefilesandCO manipulatethem.-DOCTOR'soutputisalso conformantNOtothesestyles,soonecoulduseDOCTORonitsownfilesOh recursively. NOAcomplete descriptionofthe conformantrulescanbefoundOinthe6; PostScript ReferenceManual,2ndedition$writtenby>O5AdobeInc.'and publishedbyAddison&Wesley.  Electroniccopy D>An electroniccopyofthispartofthemanualcanGbeobtainedviathemailfileserverofAdobeSystemDInc.,Thisisathreestep approach,whereineachEHcaseasimpleMAILmessageissent(noheadersetcC-justaplainmessagethewayVAXmailworks)to( DECWRL::"adobe!ps-file-server""Nwithnosubjecttitle 1 #.* / Q I0.: InitiallyyoumaysendasimplemailwithonlytheEYword"help".'In response,themailserverwillsendDYTyou instructionsonwhatarevalidrequeststoit.J1.:Thefirstrequestconsistsofonlytheword"index".EY,Thisresultsinanindexof categoriesof documentsYthatare available.I2.:Thesecondrequestisaskingforthelistoffiles>Y\ availablewithinsucha category.*Forexample:AY"index Documents".+Thisproducesalistoffiles>Y  availablefromthecategory(folder) Documents.K3.:Thefinalrequest,basedonthepreviouslistofin-FY formation,isaskingforthefilestobesentover.GY> Sometimesasinglefileissolarge,thatmailgate-IYwayswillrefuseit.'Soyoucanaskitinparts,and@Ywillneedtoeditthemtogether afterwards(re-AYHmovingallheadingandtrailing informationaddedCYbythemail gateways).'Eachpartmustbeasepa-AYratemailrequest (otherwisethecombinedrequestDYQstillexceedsthemaximumbytesizeoftheallowedYmailsize).9YTherequestismadebysendingthewordsa sendY[ categoryfilename/[.(Forexample,forthe structur-Ying conventions:#8 send& Documents%DSC.ps.Ab:Yandsend additionalmessagesforthepartsd .B,.C,Y .D,.E Fand  .F4H(aswasthecasein September1992). '2OItisalsoknown informallyasthe. RedBookbecauseofitsMOcovercolour.,AppendixCofthatbook describesthestyle.?OITherearetwo importantaspectsto conformancy:*?`1.:Thecommentblockshavea particularformatN`O2.:Theprologcontainsall definitions,fontsetupsetc,soLthateachpage descriptiondependsonlyonitselfandthe' definitionsintheprolog.U! +MO Currentlytherearetwoversionsof structuredcommentsde-FOfinedbyAdobe,knownas PS-Adobe-V2and PS-Adobe-V3.KO5Althoughbothhavemuchincommon,therearecertainin-MOcompatibilities.'DOCTORattemptsto interpretboth correctly.i?QOIna conformantfile,the descriptionsofthe individualpagesJOareself-contained.+Theydonotdependonwhat'swrittenPO5onotherpages.)Forthisreason,any definitionof customizedIO PostScriptcommandsarenotembeddedinsidethedescrip-XOtionofasinglepage,buttheyareall collectedatthefrontofBO>the document,theprologpart.*HenceVAXDOCUMENTMO PostScriptfilesallowsprintingofsomepages,aslongasPOthe extractedfilecontainstheprolog,theselectedpagede-OOH scriptions,andthetrailer.)TheprologcanalsobeenhancedQO(addcertainfeatures applicabletoallpages),aslongasno4O definitionalreadypresentisremoved.8@OFor DOCTOR, theonly important aspectsare thatLOeach PostScriptfilecontainsatleastthepartsshowninO5Example6-1.Af5ItneedstobeabletofindtheendandstartOOoftheheader,prolog,mainbodyandtrailersectionoftheMO document.*Withinthemainbody,itmustfindallthepageIO>headersincaseanextractis required.,Each conformant&Ofileneedstostartwith %!PS-Adobe.onthefirstlineofthefile.RODOCTORwillcheckonthisandabortsifitdidnotfindthatVOHline.(Ifthelineisfound,itassumesthe remainderofthefile5Oalsoconformstothecoding standards.*OO!^!OYoucanalwaysdoaO $&SEARCH PostScript_file %%Page:! cJOtoseewhatpagefolionumbersare availablewithinthe7O PostScriptfileifyouwanttousethez /EXTRACT qualifieroption.KO5Whenthesepagenumbersare surroundedby parentheses(asLOdonewithAdobeV3comment standards),youdonotspecifyOthese parentheses.x! NKOItis importanttorealizethatmany PostScript documentsMOconsistof contributionsmadeby different packages:*atypeBO<settingsystemsuchasVAXDOCUMENTand graphicalHOpackagessuchasMacDraworRAGSorsinglepagedocu-IOmentsfromDECwriteor DECpresent.)EachofthesecreateKOEtheirown PostScriptfilesthataresomehowcombinedintoGOthefinalcompletedocumentfile.*Ascanforallthe %%Page:OOentrieswillthenquicklyreveal deviationsfromtheordinaryPOOpage numbering.'AnexamplelistofthisfromoneoftheVAXFODOCUMENT documentationfilesonusinggraphicsrevealsOthis:O %%Page:&(2-12)%33O %%Page:&(2-13)%34O %%Page:&(2-14)%35O] %%Page:&1%1 ] <--D] included%figureO %%Page:&(2-15)%36O %%Page:&"Only"%1  <--D included%figureO5 %%Page:&(2-16)%37O} %%Page:&(2-17)%38O %%Page:&(2-18)%39! KOTheDOCTOR recognizesthisasasudden disruptionoftheNO incrementalchangeoftheordinalpagenumberthat indicatesPO5thenumberofthepagesheetwithinthe document.'IfsuchaLO distruptionoccurs,DOCTORdoesnotconsiderthe disruptingO %%Page:H{entryarealpageandtreatsitasanordinaryline. %` "&DigitalInternalUseOnly?O4Example8-1:7SampleDOCTOR/TAG_COUNToutputfileHt Generated&by&DOCTOR/TAG_COUNT.KDigital&Internal&Use%Only\O Tags&(and%their% frequency)%found%in%SDML&document&rooted%in% DOCTOR.SDML:/ 2& / 4&   10& /[ 3& / 2&   10& 2 412&/z 7& / 1&   23&  R :  : 177&/* 6&/r 3&/ ��2& <TITLE_PAGE>/ ��4&<U>/J ��3& <VALID_BREAK>� ��369&<X>� ��104&<XS> " ��13&<Y>�n��������F������$��������������������������������z���&���DigitalInternalUseOnly;O�\��7.4 DOCTORing#SDML#files:4 hierarchy#of"filesO���within!a!book�������������������� ��2��������O����7.1BOverviewAO�U��AcomplexdocumentwrittenforVAXDOCUMENTpro-MO���cessingcanconsistofmany elements.+ThetextmayallbeRO���writteninasinglesourcefile,or distributedovermanyoth-O�^��ers,thatareall^ �� <INCLUDE>3^��dintothefinal printable document.RO���Besidestext,othertoolsand utilitiescanhaveprovidedaddi-LO���tional graphicalortabulardata.)OftenacomplexdocumentO�h��isbuiltusinga}h ��profilefile.h��wherethisprofile specifiesthePO���namesoftheotherSDMLfilesthatarepartofthecompleteO��� document.����������������������N���������CO����Whenseveralpeopleworkonsuchacompounddocu-VO����ment,itiseasytoloosetrackofthenumberoffilesthatareAO�5�� referencedfromthemain,theroot,sourcefile.�M���������������������������#��O����Here,the� �� DOCTOR/SDML+u���utility,alsoknownasMARFINEO����(MARkupFiles INcluded), canassistyouinthepro-MO�5��cess..GivenanytoplevelrootfilethatiscodedinVAX=O��� DOCUMENT,itwillproduceoneorseveralof:�U�������������������! ��������+�� `�� ��H����Anorganizationalhierachyofhowthedocumentiscom-I�(��posedof individualelements(thatinturnmayalsobe+���composedofsmaller elements). `�� ��I����ADEC/MMS descriptionfilethatlistsallthe dependen-L�Y��ciesbetweenthe individual componentsinordertorebuildL���thefinal printabledocumentinanyofthe supporteddes-G� �� tinations:(LN03, PostScript, Bookreader, Line_printeror�c��Mail. `� ��0���Alistofall occurrencesofthe  ��<X> ��and H ��<Y>��tagsthatareB�:��writteninthoseVAXDOCUMENTsourcefiles,anno-O���tatedwiththeexactlinenumberofthefileinwhichthey���werefound.�y�������������������� ���������O���OO����The followingsectionsshowyouhowtousethat information.�g�������������������! ��������=��,O����7.2BListingallincludedfilesMO�U��Whenadocumentis processedtothefinaloutput,theVAXEO���DOCUMENTcommandline indicatesthetoplevelsourceHO���SDMLfiletobe processed.'WhenoneofVAX DOCUMENT'sLO�^��three components(Tag Translator,Text ProcessorandDeviceMO��� Converter) encounteranyofthetags(ortheir equivalents)O���as specifiedinX��Table7-1,6��the specifiedfileswillbeopenedand8O�h��includedintothefinal printableoutput.�*�������������X����a��?���!������������� �������������� ������������HO����Thetags availableinVAXDOCUMENTtoincludematerial.O����intothedocumentarelistedin���Table7-1.�*����������� �������b��?���!������������"����������������h��������O����By specifyingthe� �� DOCTOR/SDML���forany� ��.SDMLN���file,theDOCTORLO����willopenthatfileandfolloweveryleadifoneoftheKO�<��abovetagsis encountered.+OnlywhenthosefilesareVAXBO���DOCUMENTsourcefiles themselves,theDOCTORopensNO���thosefilesand recursivelyinspectsthosetoo.-Itwillig-OO�E��noreanyoftheseincludedfiletagsiftheyarecodedin-O���sidea8 �� <LITERAL>��and/or �� <COMMENT>#H��block.,IfyoudowantJO���totakeintoaccounttheseblocks,youmustspecifythe%O�O ��/IGNORE=(COMMENTS,LITERALS)YO�� qualifier.������#����������������������f��QO����Thefinalresultisanewversionofthe specifiedfile,butJO����withacommentheaderthat illustratesthenestedcompo-RO�5��sitionofthepartsthedocumentisbuildof.(RatherthantheMO���nexthigherversion,youcanspecifytheoutputfileyour-O���selfthrough ��/OUTPUT;��,orifyoudon'twantanotherversionofO�>��thesourcefile,p> �� /OUTPUT=NL:/%>��producesnooutput.)Thisisuse-MO���fulonlywhensomeotheroutputis required,e.g.*theMMSO��� descriptionfile.������$�������������� ����������QO����Itisalso highlightedwhichfilesweresupposedtobethere,5O����butcouldnotbefound.'By specifying� ��DOCTOR/SDML/CMS���youin-IO�5��structtheDOCTORalsotoinspectanyDEC/CMS libraries5O���thatare currentlydefinedthroughthe ��CMSSETLIBRARY��com-MO���mand.)NormallyitwillsimplylookintheCMSlibraryandNO�>��inspectanyofthehighest generationsoftheCMS elements."O���However,by specifying ��/CMS=^ �� generation��onlyelementsareMO���lookedupthatareamemberofthat particular generation.�m������%�����������������������C���,O����Anexampleoutputisgivenin���Example7-1.�*�����������%����F�����O���&�������%�����'�������������� ��^��������PO����Thisexample illustratesthattheheaderthatisproducedal-O����waysstartswith� ��*MF*5U���.,Youshouldnotremovethis,ifyouO�<��wishtorun< �� DOCTOR/SDML0<��overthesamesourceagainlater.O���These9 ��*MF*F��are recognizedbytheutilityasbeinganolderhi-TO���erarchylistanditwouldreplaceitbyanupdatedone,ifthe9O�E��sameSDMLfileisscannedasecondtime.�`������(�����������������������6���6O����The annotationsintheexampleindicate�$�����)�������������� ��\�������� ����1Q����Theversionoftheutilitythatproducedthelisting.'ThisisI�(�� importantifbugfixesare communicatedtothedevelop-���ers. ����2(����Theutilitywasinvokedas� ��DOCTOR/SDML/CMS���toallowB�Y�� searchingthoughtheactiveDEC/CMS librariesthat���arelistedhere. �1��3M�1��Thisfileisnotfoundineitherthecurrent directoryor"���anyotherCMSlibrary � ��4E� ��ThisfilewasfoundonlyaselementintheDEC/CMS�a��library ���5G���The remainderofthefileis unmodifiedandanexactP�9��copyofthe specifiedinputfile.'Intheexample,weuseda� ��profile$��filethatincludesmany ��elementse��thatinturnref-0���erenceseveral graphicalfigures( ��.PS,.EPS,.SIX��)aswell.�C��asprogramexamplesinPascal(jC ��.PAS �C��).������*����������������N���������O����Usingthe� �� DOCTOR/SDML6���utilityprovidesyouwithaneasytoolMO����tomakesureallelementsthatareneededtorebuildyour/O�5��documentarepresent(ornot...).������+����������������������t��-O����7.3B ProducingMMSrebuildfilesKO�U��Becauseoncethe hierarchylistismade,theDOCTORalsoPO���knowswhichfilesdependonwhichotherones,itisaneasyOO���tasktoproducea descriptionfilethatcanbereadbyDECJO�^��/MMStorebuildthedocumentifoneoftheelementsisO��� modified.������,�������������� ��������y��IO����BecauseDEC/MMSdoesnotknowhowtobuildanLN03or5O���� PostScriptfilefromaSDMLfile,the� �� DOCTOR/SDMLB���alsoinsertsKO�5��alltherequiredMMSrulesandsuffixestoallowDEC/MMSQO���toretrievethesourcesfromaCMSlibraryandtorebuildit3O���usingaproperVAXDOCUMENTcommand.������-������������������������JO����Inordertoproducesucha descriptionfileforDEC/MMS!O����youmustspecifytheQ� ��/MMS3��� qualifier.)IfyouspecifyafilespecSO�5��toit,thatfilenamewillbeused.) Otherwisea descriptionfileNO���isproducedwiththesamefilenameastheinputSDMLfile,$O���butwithfile extention{ ��.MMS3��.Ifyoudon'twanttoreplacetheAO�>��headeroftheoriginalsourcefilealso,specify> �� /OUTPUT=NL: h>��toO���ensureonlyan} ��.MMS+,��fileis produced,andnonew, ��.SDML��file.�o�����.�������������� ��������E�� O����The�� �� DOCTOR/SDML:���willgenerateanMMS descriptionfilethatQO����hasbuild instructionsforthe following destinations.(Ifnoth-VO�5��ingis specified explicitlybytheuser,adefaultchoiceismadeBO���forthenameofthedoctypeandthe destination:������/������������������������ `�� ������ BOOKREADER (default:%j� ��SOFTWARE.ONLINE BOOKREADER )���) `�O ���O��LN03 (default:O ��REPORTLN03 O��) `� ����� POSTSCRIPT (default:/ ��REPORT POSTSCRIPT ��) `�N ��!�N�� LINE_PRINTER (default:N ��REPORTLINE >N��) `� �����MAIL (default: ��REPORTMAIL ��)�������0��������������! ��N���������VO����Itispossibletospecifya differentdoctypenameor destination,OO����ifyourlocalsitedoesnotusetheabove(defaultDOCUMENTO�5�� installation)names:������1��������������V ���������� `�� ������Usethe� ��/DOCTYPE4N���tospecifyanotherdoctypeforeither*�(��paperoronline destinations: ��/DOCTYPE=(PAPER= ��namey ��,%ONLINE= ��name _ ��) `�- ���-��Usethe- �� /DESTINATION1-��tospecifyanother destinationnameI���foroneorseveralofthepossibleoutput destinations:  ��/DESTINATION=(LN03=T  ��LN03_destination   ��,R �� POSTSCRIPT= 4R ��PostScript_destination iR ��, �� LINE_PRINTER=" ��LINE_PRINTER_destination  ��, ��MAIL=T ��MAIL_destination  ��,* �� BOOKREADER= 4* ��BOOKREADER_destination tr ��)������2��������������! ����������OO����ItispossibletoorderDOCTORtoonlyinspectelementgen-TO����erationsthatbelongtoaspecificCMSclass.'Inthatcase,theO�5 ��/CMS= 5 �� generation@5��mustbe specified.'Thisalsoresultsinanad-O���ditionalMMSmacro,m ��CMSFLAGS=/GEN=w �� generation��tobe specified*O���intheMMS descriptionfile.������3�������������� ��������r��OO����Finally,somesitesusespeciallogicalnames, additionalDECJO����/MMSrulesetc.-Toallowforthis,youcanspecifytheO�5 �� /INCLUDE=H5�� qualifier.(It specifiesafilethatcontainsvalidDECPO���/MMS instructions.'Itsresultontheproduced descriptionfileO���bytheE ��DOCTOR/SDML/MMS��isthatan ��.INCLUDEfilespec�� directiveUO�>��iswrittenintothe descriptionfile.'Thisincludedfilecancon-QO���tainyourownsetofsuffix definitions,actionrulesandMMSO���macrosymbols.������4�������������� ��������i��O����Normally� ��DOCTOR/SDML/MMS2���providesasetofsuffixesandac-NO����tionrulestoretrievefilesfromDEC/CMS libraries.*IfyouO�5��useanW5 ��.INCLUDE;5��file,youmaywanttodefineallyourownOO���suffixesandrulesandnotusethoseprovidedbyDOCTOR.In0O���thatcase,youshouldspecifythe �� /MMS/NORULES��.This qualifierQO�>��willstillproduceaminimumsetofrulesthatenableMMSto7O���rebuildthefinaltargetfilesfromthe ��.SDML^��sourcefiles.�������5�����������������������h���%O����Thevalid qualifiersfor� �� DOCTOR/SDMLK���arelistedin���Table7-2.�*�����������5����F���b��?���6������������7��������������! ��������f��IO����Becausethedoctypeand destinationaswellastheVAXBO����DOCUMENTcommmandaredefinedasMMSsymbols,youMO�<��canatanytimeoverrulethemby specifyingthesamesym-NO���bolsasDCLcommandsymbolsandinvokethe descriptionfileO���throughthecommand �� MMS/OVERRULE R��.������8�������������� ��������w��EO����Specific additionalDOCUMENT qualifiersmaybespeci-O����fiedusing� ��/DOCQUALIFIERS=*���wherethestringofDOCUMENT<O�5�� qualifiersare specifiedbetweenquotes,e.g.b5 ��/DOCQUALIFIERS=O� ��("/CONTENTS/INDEX")��.4By default, �� /CONTENTS!/INDEX!O� ��/BATCH=(NOPRINT,NOTIFY)��isused.�m������9�����������������������C���,O����Anexampleoutputisgivenin���Example7-2.�*�����������9����F�����O���:�������������;�����������������������]���KO����SomenotesbytheMMS descriptionfileasshowninthisO����example:������<��������������Y ���������� ����1M����Theversionnumberoftheutilityisonceagain mentioned. �O��2J�O��TheorderinwhichfiletypesdependononeanotherisK��� redefined.(ItincludesallthefiletypestheDOCTORen-M���� counteredwhilebuildingthe hierarchylist.)Thislistwill�Y��be suppressedifY ��/NORULESaY��is specified. ���3C���TheDOCUMENTcommandaswellasthedoctype,des-N�1��tinationand qualifiersarealldefinedassymbolstoallow0���overrulethroughDCLsymbolsora �� MMS/MACRO=z��command. � ��4N� ��Foreachofthefiletypesfound,rulesaremadetoallowF�a��MMStofetchthemfromaDEC/CMSlibrary.'Theseare(��� suppressedifthe qualifier ��/NORULES��is specified. �9��5J�9��Whennoupdatecanbemadeforacertainfileelement,?���bydefaultitnotifiestheuserand continues. ���6O���Thefirsttargettobuildistheentire document.' DependencyN�i��linesforall supportedoutputfiletypesarecreatedina���similarway. �A��7N�A��Ifyouwantall destinationstobe processedoneaftertheH���other,youmustinvokeMMSinthisexample,usingthe���command4w ��MMS/DESCRIPTION=PROFILE.MMS% ALL_DOCUMENTS�p�����=�������������� ��������F��I����Itwillthenexecutethis annotatedlinewhichinturnC����willinvokeeachoftheDOCUMENTcommandstopro-G�5��ducethe Bookreader, PostScript,LN03, Line_printerandI���Mailfiles respectively.)ThiscommandmaynotresultinK���abatchjob,however.'Thatwouldcauseparallel executionH�>��ofDOCUMENTonthesamesetoffiles,causingacon-)���flictontheaccesstotheL ��.XREF)"��cross referencefileofthe6���book:'itmustbeexecutedin sequence.�[������>�����������������������1���1O����7.4BUsingtheMMS descriptionfile�>�����?������������������������'O����7.4.1BWhatfiletobuild?LO�4��The generatedMMS descriptionfilecanbeusedinseveral(O���ways.)Asyoucanseefrom1��Example7-2,6��a dependencyruleEO���is generatedforeachofthe supported destinations.�*�����������?��1��O����O���:�������������@�������������� ������������SO����IfyourunMMSusingallits defaults,itwillalwaysgenerateGO����a dependencylineforthe Bookreader destinationonly.������A�������������� ��N���������!O����Ascanbeseenfrom;���Example7-2*/���thisisthefirst dependencySO����rule specifiedinthe generated descriptionfile,andbydefault:O�5��thisistheonlyaction performedbyMMS.�*�����������A��;��F�����O���:�������������B����������������z���������MO����Ifyouwantanyspecific destinationtobeused,youmustO����invokeMMSas%�a ��$%MMS/DESCRIPTION=file.MMSa �� targetfile�+�����C����������������N��������O����wherethe� �� targetfile6,���istheoutputfileyouwanttobuild.O����Fromthe���Example7-2!���thiscouldbeeither� �� PROFILE.PS ���orO�5 �� PROFILE.LN03#)5��oranyoftheothers.�*�����������C���������O���:������������D�������������� ����������2O����7.4.2BAnotherdoctypethan specifiedNO�4��OncetheMMS descriptionfileis generated,avalueisas-%O���signedtotheMMSmacro ��DOCTYPE :��and ��ONLINE_DOCTYPE��.Either#O���thesearethedefaultso ��REPORT k��and  ��SOFTWARE.ONLINEX��orthose6O�=��thatwere specifiedusingthe qualifier= ��/DOCTYPE=(PAPER=O� ��,ONLINE=)�������E�����������������������{���PO����Ifforsomereasonyoustillwantanotherdoctype,thereare+O����threewaysof obtainingthis:������F�������������� ����������G`����1.:EdittheMMS descriptionfileandchangetheval-�(��ues specifiedfor,( ��DOCTYPE M(��and( ��ONLINE_DOCTYPE(��macrosas3��� specifiedatthestartofthefile.%`����2.:InvokeMMSusingthe6� ��/MACRO0��� qualifier: ��MMS/MACRO=("DOCTYPE=y �� other_name ��","ONLINE_DOCTYPE= �� other_name   ��")I`���3.:DefineaDCLsymbolwiththesamenameastheMMS;�]��macrobeforeyouinvokeMMS(notusingthem] ��/MACRO��� qualifier):: ��$KDOCTYPE%=%": �� other_name : ��"! ��$KONLINE_DOCTYPE&=%" �� other_name  ��"�O�����G�������������� ��������%��6O����7.4.3BAnother destinationthan specifiedQO�4��Ifanother destinationnameisrequiredthanthat specifiedinMO���theMMS descriptionfile,youcanproceedthesamewayasO��� specifiedin��Section7.4.2,!�� replacingthemacros:�*�����������G��������?���D�������������H����������������;������g����� �� ONLINE_DEST� ��POSTSCRIPT_DEST�q �� LN03_DEST� �� LINE_DEST�" �� MAIL_DEST�T�����I�������������� ��������*��RO����Changeofthe destinationisnormallyonlyrequiredifthelo-HO����calDOCUMENTsystemhasbeensetuptoknow differentPO�5��namesthanthose specifiedbydefault.)Thisis especiallytheHO���casewithsitesthathaveDOCUMENT installedfromV1.0LO���onwardsorthathaveenabled automaticprintingafterpro-NO�>��cessing.)ThosestartedatV2.0normallydon'thave differentNO���namesandwillnothavetheneedtochangethe destinationO���names.������J�������������� ��&������m��1O����7.4.4BUsingDOCUMENT/GRAPHICS(Rags)@O�4��Aspecialmentionmustbemadefortheuseof4 ��DOCUMENTO� �� /GRAPHICSB��produced graphics.+Thisutility,thatis delivered@O���withVAXDOCUMENTV2.0onwards,isa DECwindowsRO�=��orientedgraphicseditor,thatwillproduceoneorseveraldif-KO���ferentoutput graphics:) PostScript,sixelorBRF-bookreader8O���files.+Inadditionitcanoutputanother ��.SDML��filethatonlyO�G��containsG �� <FIGURE_FILE>/G��tags./ThisenablestheauthortoHO��� completelydecoupletextandgraphics componentsoftheMO��� document.'Theonlythingwritteninthetextfilewillbe1�} ��<FIGURE>(figure%caption\figure_symbol)$� ��<INCLUDE>(figurefile.SDML)�  �� <ENDFIGURE>�^�����K�������������� ��������4��O����whereasthe � ��figurefile.SDML$k���willbecreatedbythe� ��DOCUMENTO�� �� /GRAPHICS.���editorandcontainstherequiredN� �� <FIGURE_FILE>8���tagsSO�5��withthecorrectsizeofthefigure,whichmaydifferforeachO��� destination.������L��������������! ��H������_��O����WhenE� ��DOCTOR/SDML/MMS3���isrequiredtoproduceanMMSfile,QO����itwillalsoaddtheactionruletoinvokethegraphicsedi- O�5��tor"�5 ��DOCUMENT/GRAPHICS=RENDER!k5��torecreateanysuchg5 ��.SDML<5��file8O���fromagraphics meta-filewithfiletype ��.GRA��.However,thisMO���willonlywork,iftheMMS descriptionfileisinvokedbyEO�>��MMSwhilerunningundera DECwindows environment,as O���the� ��DOCUMENT/GRAPHICS7p��utilitywillonlyworkwhenithastheJO��� DECwindows environmentavailable-evenifitwillnotdis-LO�H��playasinglewindow.*Forthisreason,theMMSfilemustKO���eitherbeinvokedfromaDECtermwindowonyourworksta-9O���tionor,if submittedtobatchmade,the �� LOGIN.COM:��fileneedstoLO�R��containaDCLcommandtocreateadisplayonsomeactiveO��� workstation:M�/ ��$%SET&DISPLAY/CREATE/NODE=nodename%/TRANSPORT=(LAT|LOCAL|DECNET)�K�����M�������������� ��������!��OO����wherethe specifiednodenameisa workstationinwhichtheMO����SessionManagerhasbeentold(viatheSecurityoption)toMO�5��acceptdisplaysfromthenodeonwhichthebatchqueueisMO���runningandfromtheusernameforwhichthebatchjobhasTO���been submitted.'Ifthesecuritysettingdoesnotallowthis,the(O�>��MMSjobwillabortbecauseP> ��DOCUMENT/GRAPHICS>��willreturna;O���fatalerrorfor"unabletocreate display".�_�����N��������������! ��������5��O����InsteadoftheY� �� LOGIN.COM1���file,youcanalsospecifyanother%O����MMSfiletocontainthe� ��SETDISPLAYx���command.)ThisMMS@O�5��fileisaddedtothe generatedonethroughthe5 ��DOCTOR/SDML/MMSO� ��/INCLUDE�� qualifier.������O������������������������,O����7.5BRetrieveallindexentriesHO�U��WhenadocumentiswrittenanditcontainsmanyindexNO���entries,yourchancesaregoodthatsomeindexentriesthatRO���weresupposedtobe identical,buton differentpages,areac-NO�^��tuallyprintedastwoentriesintheindex.*Usuallybecause+O���youmistypedanentryofthe u ��<X> ��or c ��<Y>��tag.�G�����P������������������������MO����Findingthosetypo'sistedious:-youneedtogetthebookSO����printed,thenlookintheindex,findtheerrors,lookatthatPO�5��page, determinewhichfileiscomesfromandfinallygointo-O���theeditorandfindtheentry.�w�����Q����������������������M��LO����TheDOCTORallowsallthistobedonemucheasier,with-PO����outtheoverheadof rebuildingtheentirebookeachtimeyouNO�5��thinkyoufoundalltheerrors.,(Usuallythefixingofin-PO���dexentriestakeseveralrepeatedloopsof correctingthetagO��� entries).������R����������������������z��O����By specifyingE� ��DOCTOR/SDML/INDEX$���theDOCTORproducestheJO���� hierarchylist,but,whilescanningthroughalltheSDMLQO�5��sourcefiles,italsocopieseachandevery occurrenceofthe O� ��<X> ���and z ��<Y>< ��tagsintoaseparatefile, specifiedbythe ��/INDEX=O��� qualifier.�������S�������������� ������������-O����Theresultlooks somethinglike���Example7-3.���Thismaylook*O����odd,butitisveryuseful.�*�����������S����F�����O���T������������U����������������2������g��7O����Thefactthatalllinesstartwithtag n� ��<X> ���or ]� ��<Y>���,allowsyouto O����usetheDCLcommand� ��SORT1a���tosortthefileinto alphabeticalSO�<��order.*(Itisproducedinorderofthefiles referencedbytheO���DOCTOR).*� ��$%SORTJ input_filep output_file������V�������������� ��a��������NO����Thiswillpositiontypo'sneareachotherandeasytospotWO����whenthesortedfileisprinted.)ItisalsoeasytoloadallthePO�5��requiredSDMLsourcefilesintoyoureditorbuffersonce,and.O���thenmovefrombuffertobuffer q��1*��tocorrecttheerrors.(SinceOO���youdonotaddanylines,butsimplyre-typeanentry,theQO�>��linenumbersthatpreceedthefile specificationthatisgivenO���inthe; �� <COMMENT>7��onthesameline,allowsyoutousea ��gotoO� ��line���command K��2?��toquicklymovetothe indicatedlinetofind%O�H��the incorrecttagentry.�*�����������V����D�����/���X�������*�����������V��K����"���/���W������������Y��������������! ����������QO�V���Oncealltheseentrieshavebeen correctedintheSDMLfiles,O����youcanrun&� ��DOCTOR/SDML/INDEX*���oncemoreonitandinspectOO���thenewoutputtospotanytypo'syouforgot.+IfthereareNO�`��none,youcanusetheproducedindexfiletomakeadummyUO���bookby processingtheindexfilebyitself.(OfcoursethefinalRO���outputwillcontain non-sensepagenumbers,butatleastitisRO�j�� processedandbuildin substantiallylesstimethanredoingtheLO���entire document.(Whenthe processedandprintedindexalsoOO���lookscorrect,thenyou reprocesstheentirebook.*Ifyou'reQO�s��stillnot satisfied,youshouldmake additionalchangestothe"O��� incorrecttagentries. �N_�UQ��Note N_����Youmayrunintoo ��%TEX-MEMEXCEEDED��errorswhenthereF�.��aremanyentriesintheproducedindexfile.(BecauseF���thereisnorealtext,theText ProcessorcanwriteJ���alltheindexentriesonasinglepage.)ItstoresthemD�8��inmemory,waitingforanewpagetostart(whichH���nevercomes).* Therefore,itisagoodideatouseanC���editorandinsertdummytextbetweenthelinesof$�B��indextags,aswellasB ��<PAGE>%B��tags.*Ifyousupplythe��� qualifier �� /RANDOM_TEXT��,then ��DOCTOR��willaddthistextH���foryou.* Obviously,youneedonlytoprintorinspect�K��the resultingK �� *_INDEX.*K��files. ���"��'�����������������������{���������������� ��������&���DigitalInternalUseOnly3O�4��Example9-1:7Sample .SDML_XREFoutput2O� ��(<CHECK_FOR_INCLUSION>(ENG_COOKBOOK_XREF)@O� �� <COMMENT>%+*******************************************#t�@ ��Created%by%DOCTOR%V3.03t� ��Creation%Date: 21-JUL-1992% 11:37:28.78t� ��Command%issued:p/XREF%[COOKBOOK]ENG_COOKBOOK%9/SORT/ALPHA/NUME/FULL/LIS/SYMB/PREF=HHG_/BOOKTITLE="Hitch%Hiker's%Guide%to%VAX%DOCUMO�[ ��ENT"Kt� ��XREF%file&used:p.PSQ:[PRIVATE.THEO.COOKBOOK]ENG_COOKBOOK.XREF;3t� ��QAR's%to:/ ��Theo&de&Klerk&@UTO,K NSIC00::KLERK0�T ��***&Digital%Internal%Use&Only%***?O� ��5*****************************************<ENDCOMMENT>LO�& ��<DEFINE_SYMBOL>(HHG_BOOK\Hitch%Hiker's%Guide%to%VAX% DOCUMENT)HO�n ��><DEFINE_SYMBOL>(HHG_ALIGNCHAR\<_italic>(<REFERENCE>(HHG_BOOK)),O� �� \Sectionname%4.8,%Aligned&text)DO� ��:<DEFINE_SYMBOL>(HHG_CHAP1\<_italic>(<REFERENCE>(HHG_BOOK));O�F �� \Chaptername%1,%Basic%commands%for& DOCUMENT)EO� ��;<DEFINE_SYMBOL>(HHG_CHAP10\<_italic>(<REFERENCE>(HHG_BOOK))JO� �� \ChapternameK10,%Using%the%Language% Sensitive&Editor%LSE)DO� ��:<DEFINE_SYMBOL>(HHG_CHAP3\<_italic>(<REFERENCE>(HHG_BOOK))0O�f �� \Chaptername%3,%Lists%in% Document)� ��...% etcetera...RO�8 ��H<DEFINE_SYMBOL>(HHG_THUNDERBIRDSSECTION\<_italic>(<REFERENCE>(HHG_BOOK))CO� �� \Sectionname%2.5.1,&The%origin%of%the& Thunderbirds)TO� ��J<DEFINE_SYMBOL>(HHG_XREFBOOKREADERSECTION\<_italic>(<REFERENCE>(HHG_BOOK))HO� �� \Sectionname%2.3,%Cross% references&and% Bookreader&files)JO�X ��@<DEFINE_SYMBOL>(HHG_XREFSECTION\<_italic>(<REFERENCE>(HHG_BOOK))%O� �� \Sectionname%9.5.3,&XREF)"O� ��<ENDCHECK_FOR_INCLUSION>�v��(������������������\������������������� ��y������2��&���DigitalInternalUseOnly4O�(��Table9-1:7 Alphabeticlistofsymbols O�D �O���Symbolname3��Type��NumberText O� �O��� HHG_ALIGNCHAR%3��Section4.8AlignedtextO�i�� HHG_CHAP143i��Chapter1BasiccommandsforDOCUMENTO��� HHG_CHAP10C3��Chapter10UsingtheLanguage SensitiveEditorLSEO�]�� HHG_CHAP3)3]��Chapter3ListsinDocument Q��...' etcetera...O�D��HHG_TB1SECTION,3D��Section 2.5.1.1.1 Thunderbird1O���HHG_O� ��THUNDERBIRDSSECTION<3��Section2.5.1rTheoriginofthe ThunderbirdsO���HHG_O���XREFBOOKREADERSECTIONA3��Section2.3Cross referencesand BookreaderfilesO�L��HHG_XREFSECTION3L��Section9.5.3rXREF O�s ��I��)������������������/�������������������f ��p��������&���DigitalInternalUseOnlyCO�(��Table9-2:7Chaptersymbols-in alphabeticalorder O�D �O���Symbolname3��NumberText O� �O��� HHG_CHAP1+3��1BasiccommandsforDOCUMENTO�i�� HHG_CHAP10:3i��10UsingtheLanguage SensitiveEditorLSEO��� HHG_CHAP3 3��3ListsinDocument4��...etcetera...HO���HHG_LAYOUTCHAPTER2Documentlayoutandcross references3O�D��HHG_TABLECHAPTER4TablesinDocument O�j ��J��*������������������0�������������������f ��C��������&���DigitalInternalUseOnly@O����Table9-3:7Chaptersymbols-in numericalorder O� �O�_��NumberSymbolname0_��Text O�z �O���1 HHG_CHAP1(0��BasiccommandsforDOCUMENTHO�<��2HHG_LAYOUTCHAPTERDocumentlayoutandcross referencesO���3 HHG_CHAP30��ListsinDocument4��...etcetera...O���9 HHG_CHAP9!0��Extralocal additionsO���10 HHG_CHAP1060��UsingtheLanguage SensitiveEditorLSE O�= ��4��$������������&����������Z����������������������i���&���DigitalInternalUseOnly5O�\��8.8 DOCTORing$SDML%files:9Counting%tagsO���used������[��������������! ��)��������O����8.1BOverviewSO�U��Thisisaverysimpleutilitythatcountsallthetagsencoun-TO���teredinanSDMLfile.&Atagisdefinedasany contiguoustextMO���string consistingof alphabetic,numericor underscorechar-OO�^��acters, surroundedbytheopeningandclosingangle brackets:O� �� <LIKE_THIS>I��.'Forthisreason,theutilityalsodetectsandcounts#O���alluserdefinedtags.�K�����\����������������������!��,O����Theutilityisinvokedthrough� ��DOCTOR/TAG_COUNT���,andtakesaLO����singleSDMLfileasinput parameter.*It automaticallyalsoPO�5��searchesthroughallfiles referencedbytheinputfilespec-UO���ified:+ifaprofileisgiven,allelementsofthebookarealso!O��� searched,asarethe1 �� <INCLUDE>��files. �h_�Uk��Note h_�H���Thisutilitycountsanytag-like construct,asitdoes@�H��not interpretorvalidatethem..Thisalsomeans'���itcountsalltagswithinD �� <COMMENT>��blocksand/or� �� <LITERAL>.>��blocks.(Whenwithintheseblocks �� <INCLUDE> �R��or9R �� <ELEMENT> R��or(R ��<INCLUDES_FILE>!\R��tagsare encountered,� �� DOCTOR/TAG;d��willattempttolookupthefiles referencedL���bythesetags.)Itwillgiveawarningifthosefilesdo2�[��notexist,but continues processing. ���Z�����]�������������� ��)������0��O����8.2BOptionsTO�U��Becauseofits simplicity,therearefewoptionswiththisutil-PO���ity.)Youcanspecifyyourownoutputfile specificationusing O���the� ��/OUTPUTF�� qualifier.*Ifomitted,itdefaultstotheinputfile/O�^��specification,butwithfiletype^ �� .TAG_COUNT^��.Only ^ ��/LOG^��canbeRO��� specifiedtokeeptrackofthenumberoffilessofar processedMO���incaseseveralnestedSDMLincludedfilesare encountered.�(�����^�������������������������O����8.3BOutputformatTO�U��TheoutputfileisasimpleASCIItextfile, formattedasindi-O���catedin��Example8-1,3��whichwasmadeagainstaversionof0O���thesourcefileofthis document.�*�����������^����p����O���`������������_�������������� ����������OO����Noticethatthenumberof occurrencesisgiveninthefirstKO����columns1-7,whereasthetagnamesaregivenfromcolumnPO�5��9onwards.)Theyaresortedin alphabeticalorder,butifyou5O���needthemin numericalorder,theDCL  ��SORT��commandcan&O���quicklydothisforyou:(�k ��SORT%/KEY=(POSITION=1,SIZE=7)k ��infile%outfile������a������������������������O����8.4BUsageLO�(��ThisutilitywascreatedtomakeaquickestimateontheIO���amountof conversioneffortrequiredifanSDMLencodedNO���fileneedstobe convertedintosomeothermarkup language,+O�1��suchasSGML,RunofforaT sB��E"1�� X-flavoursuchasLaT B��E 1��Xor O���ZzT ���E ���X.�3��&������&���$���+����t������b����������������u������J���&���DigitalInternalUseOnly$O�\��9.2 DOCTORing!XREF"files������c��������������! ��)��������O����9.1BOverviewFO�U��Whenalargedocumentisbuiltusing DOCUMENT,oftenPO��� referencesareusedtopointtootherpartsofthe document.SO���Afterawhile,and certainlyifseveralauthorsworkonadoc-LO�^��ument,youstartlosingtrackofwhatsymbolsaredefinedRO���forwhattables,sectionsandother referableitems.(Evenifa'O���naming conventionisused.������d��������������! ��<��������O����Forthisreason� �� DOCTOR/XREF/C���hasbeenbuilt.*Itwillworkon9O���anydocumentofwhichthecross reference ��.XREF[��fileex-TO�i��ists.'Thisisalwaystruefor documentsbuiltthroughaprofile.4O���Singlefile documentsdonothavean ��.XREFq��file-theTagNO��� TranslatorkeepsalldatagatheredinPass1inmemoryandVO�r��usesittoresolve referencesduringPass2:'noneedforafile.WO���Youmustbreakupthisfileintopartsandaddaprofilefileto!O�#��it,inordertouse# �� DOCTOR/XREF f#��.�������e��������������������������O����Using?� �� DOCTOR/XREF���ona� ��.XREF1~���filewillallowyoutodoseveralO����things:������f��������������! ��H�������� `�� ��B����BuildanSDMLfilewithallsymbolslistedina� ��<TABLE>I�(�� structure.*By processingthisSDMLfile(e.g.*usingtheJ���REPORTdoctype)yougetanicelyprintedlistingofallM���symbolsandtheirtextual contents.(Thoselistscanbeal-G�2��phabeticonsymbolnameorsorted numericallybytypeF���(e.g.'alltablesymbolssortedbytablenumber).'The ��/SORT ���or8 ��/LIST/ �� qualifiersarerequiredforthis. `�c ��3�c��BuildanSDMLsymbolfile containingSc ��<DEFINE_SYMBOL>2���tagsofallsymbolsdefinedinthe ��.XREFf��file.-Thisal-���lowsyouto �� <INCLUDE>2��thatfileintosomeotherbookandK�l��therebyenablesyoutocross referencebetweenbooks.'The� �� /SYMBOL_FILE-�� qualifierisrequiredforthis. �G_�UJ��Note G_�;���In some!cases you want to ensure all used�' �� <REFERENCE>0'��tagswillhaveproper definitions.A��� Sometimeshoweverthosesymbolsdonot(yet)ex-K���ist.'Ifyouneedafilewhereall undefinedsymbolscan,�1��be temporarilydefinedusinga31 ��<DEFINE_SYMBOL>s1��,then���usethe ��DOCTOR/ONLINE/DUMMY'�� qualifier,as describedin���Section5.4. �,��*�����������f�������|��?�����������A�����g�������������� ����������&O����9.2BBuildsymbollistingsO�U �� DOCTOR/XREF9U��allowsyoutoproducea formattedlistingIO���ofallsymbolsdefinedina document.0ThelistingsareO���madein ��<TABLE>4��formatandcanbe processedwithVAXGO�^��DOCUMENTusinganydoctype availablethatsupportsta-TO���bletags.'Thelistingscanbemadein alphabeticalorderortheNO���symbolnamesbutalsoin numericalorderofthesectionorO�h��objectnumbers.�������h����������������!���������EO����Toobtaintheselists,youneedtousethecommand� �� DOCTOR/XREFZ ��file ��.XREF%/LIST= ��filespec������i�������������� ����������TO����ifyouwantan alphabeticallistofallsymbols-amixtureofPO����tables, sections, examples, chapters, appendicesandothers.(If7O�5��youdon'tspecifythefilespecwiththe5 ��/LIST5�� qualifier,itde-4O���faultstothesamefilenameastheO ��.XREF %��file,butwithfileO���type� ��.SDML_SYMBOL_LIST y��.�5�����j�������������� �������� ��RO����Toproducealistofsymbolssortedbytypeofsymbol(table,IO����chapter,example,userdefinedandothers)the qualifier*� ��/SORTO�5��isneeded.� �� DOCTOR/XREFZ ��file ��.XREF%/SORT= ��filespec�A�����k�������������� ����������RO����Bydefaultallsymbolsarethensortedalphabeticallypertype.MO����However,inmanycasesitmaybemoreusefuliftheyareQO�5��sortedbytheirnumericvalue(if applicable)sothatyoucanSO���quicklylookupthesymbolforTable5-6.)Ifthisis required, O���the� ��/NUMERIC@ �� qualifierisalso required.)Tohavebothalpha-CO�>��beticand numericallysortedlistsofsymbols,use.> �� /ALPHABETICO� ��/NUMERIC z��.������l������������������������OO����Youcandecidewhetherthelistingsjustshowthebriefin-QO���� formationaboutthesymbolorthefulltext, similarlytotheO�5��workingofthe5 �� <REFERENCE> M5��tag,where arguments5 ��FULL,O� ��TEXT,VALUE9��areallowed.'Usethe appropriate qualifier ��/FULL,O� ��/TEXT,/VALUEC��forthis.�R�����m����������������D������(��4O����9.3BBuildcross referencesymbolfile"O�U��TobuildafilewithU ��<DEFINE_SYMBOL>!xU��tagsthatdefinetheOO���symbolsplustheir reference translation,youneedtospecify O���the� ��.XREF"��filetoscanandthey �� /SYMBOL_FILE=^ ��filespec��forthe"O�^�� resultingoutputfile.� �� DOCTOR/XREFZ ��file ��.XREF% /SYMBOL_FILE= ��filespec  ��-Z+ �� /BOOKTITLE="+ ��title&text+ ��"&/PREFIX=+ ��prefix������n�������������� ��W��������LO����Ifyouomitthefilespecification,thefilenameofthe� ��.XREF9O����fileistaken,andfiletypedefaultsto� �� .SDML_XREF���toavoidPO�5��ittooverruletheprofilefileofthebook,which otherwiseRO���wouldhavethesamefilespecicification,butatotallydiffer-RO���entcontentsthatyouwouldnotwanttolosebyan accidentalO�>��purge.������o����������������i��������QO����Ifthesymbolsdefinedaregoingtobeusedinanotherbook,NO����a potential collisionmayoccuriftheotherbookusestheLO�5��some identicalnamesforsymbols.*Topreventthis,apre-PO���fixcan(andshould)beattachedtoallsymbolsderivedfrom O���the� ��.XREFA��filetoensuretheir uniqueness.)Within CorporateEO�>�� Publishing,thebookcodecouldbeusedforthis.)IfU> ��/PREFIX v>��isOO���not specified,awarningisissued,but processing continues. �_�U��Note _�C���Makesurethatsymbolname+prefixneverexceeds>���theVAXDOCUMENTlimitof31 charactersmaxi-�R��mumlength.R �� DOCTOR/XREF,R��willwarnyouifthisisthe=���caseandtruncatethesymbolnametomaximum��� allowablelength �M�������p��������������! ����������SO����Inadditionto specifyingaprefix,youshouldalsospecifythe+O����titleofthebook,usingthe� �� /BOOKTITLE=%��� qualifier.'Thiswillre-2O�5��sultinthe definitionofasymbol5 ��prefix!5��BOOKwhich translates;O���intothe specifiedtitleofthebook.'(The ��prefix��partis specifiedO���through ��/PREFIX@��oromittedifthisisnot specified).(ThiswayNO�>��youcanperformacross referencetothebookfromanotherO���bookbywriting:>t�= ��For&more% information%see&<reference>(prefixBOOK)5t� ��in%its&"<reference>(prefixOVERVIEWCHAPTER)�W������q�����������������������-���-O����Whichcouldthen translateinto�������r��������������� ������������*O����...(Formore informationsee[� ��TheArtofZen���initsChapter1,"O����HowItAllBegan...������s������������������������OO����Youcandecidewhetherthelistingsjustshowthebriefin-QO���� formationaboutthesymbolorthefulltext, similarlytotheO�5��workingofthe5 �� <REFERENCE> M5��tag,where arguments5 ��FULL,O� ��TEXT,VALUE9��areallowed.'Usethe appropriate qualifier ��/FULL,O� ��/TEXT,/VALUEC��forthis.�������t�������������� ���������e���UO����Inordertousethefilewithallthesymbolsdefined,youmustO����either�v�����u����������������r������L�� `�� ������Specify!� ��/SYMBOLS=file.SDML_XREFb���ontheDOCUMENTG�(��commandlineforthebookthat referencesthedefined���symbols `�� ������Specifya#2� ��<INCLUDE>(file.SDML_XREF)#���intheprofileofthe7�Y��bookthat referencesthedefinedsymbols������v����������������w������n��O����9.4BExampleoutputMO�U��Thissectiongivesthreeexamplesonthefinaloutputpro-O���ducedby �� DOCTOR/XREF_��whenthe ��.XREF!��fileisscannedthat+O���isproducedin processingthe(} ��HitchHiker'sGuidetoVAXO�^ ��DOCUMENT3$^��,another publicationoftheauthor.�������w�������������� �����������"O����ThecommandgivenwasEt� �� DOCTOR/XREF%ENG_COOKBOOK.XREF%/LIST/SORT/ALPHA/NUMERIC&-U�P ��$/SYMBOL/PREFIX=HHG_/BOOKTITLE="Hitch%Hiker's%Guide%to%VAX% DOCUMENT"&-� ��/FULL������x�������������� ��N���������PO����Theresultsare presentedbelowinthenext subsections.'OnlyRO����smallpartsofthecompletetableareprinted-enoughtogetO�5��afeelingofwhat5 �� DOCTOR/XREFv5�� produces.������y�������������� ��V������}��%O����9.4.1BSymbolfileoutput$O�4��Theoutputasshownin4��Example9-14��hasbeen4 �� <INCLUDE> ]4��dOO���intothis document.' Therefore,wecannowcross referenceto O���the2� ��HitchHiker'sGuidetoVAXDOCUMENT��bookbyusing O�=��the�= �� <REFERENCE>$=��toany particularpart.�*�����������y���������O���{������������z�������������� ��N���������O����Forexample,using!� ��<REFERENCE>(hhg_chap10)@���wouldresultin: O����"2j�� ��HitchHiker'sGuidetoVAXDOCUMENTB���Chapter10,Using1O�5��theLanguage SensitiveEditorLSE".������|��������������! ��������t��#O����9.4.2BListfileoutputEO���RatherthanshowingtheVAXDOCUMENT constructspro-O�_��ducedinthe*_ ��.SDML_SYMBOL_LIST)_��file,wewillshowasmall4O���sampleofthefinaloutput,whenthe ��<TABLE>��hasbeenCO��� processedbyVAX DOCUMENT.ThistableisshowninO�i��Table9-1.�*�����������|��O���,��a��?����������������}�������������������������8O����Symbolsin!PSQ:[COOKBOOK]ENG_COOKBOOK.XREF;1O�4��Booktitle:4 �� <HHG_BOOK>+4��=HitchHiker'sGuidetoVAXO���DOCUMENT�k������~�����������������������A���AO����Alldata specifiedintableisusedforoutput.�����������������������x���������+O����9.4.3BSortedlistfileoutputOO���Whentheoutputissortedbyitssymboltype,the followingGO�_��tablesoccur.&Onlyasmallsampleis reproducedhere:��������������������! ����������� `�� ������Table9-2BJ���showsthelistofchaptersymbolsin alphabetical�(��order `� �����Table9-3?N��showsthelistofchaptersymbolsin numerical����order�*�������������������`��?����������*����������������k��b��?�����������������������������������������NO����Similarlistsarealsoproducedfor sections,figures,exam-PO���ples,tables,userdefinedsymbols,andothertagsthatallowO�i��symbolic references.��������������������������������8O����Symbolsin!PSQ:[COOKBOOK]ENG_COOKBOOK.XREF;1O�4��Booktitle:4 �� <HHG_BOOK>+4��=HitchHiker'sGuidetoVAXO���DOCUMENT�k�����������������������������A���AO����Alldata specifiedintableisusedforoutput.����+���������&���,����j����������������������8������@���&���DigitalInternalUseOnlyO���CommandSection���,���������+���-��������������������������/������n���&���DigitalInternalUseOnlyO���DOCTOR/GLOSSARY/O���SortglossaryitemsinSDMLfile�*�������������������������������������e�������������������! ��������;�� O����The�� ��DOCTOR/GLOSSARY"C���utilitywillsortall� ��<GTERM>!���tagsandO�(�� associated( ��<GDEF>;(��tagswithinanSDMLsourcefile.&Theglos-UO���sarysectionmaybepartofalargerfile.&TheremayonlybeaO���single glossary.�#������������������� �����������O����Format2O�s��DOCTOR/GLOSSARYNfilespec [/qualifiers]O���Command Qualifiers��DefaultsO�:���/OUTPUT :���/OUTPUT=input_filespecO�|���/LOG|���/NOLOGO����/SORT*���/SORT=(LETTER,NONALPHA=IGNORE)���������������������! ��=���������O���� ParametersO�s��filespecSO���AvalidVMSfile specificationofanSDMLfilethatcontainsaO�$ �� <GLOSSARY>0$��section.'No wildcardsareallowed.��������������������! ��'��������O���� Restrictions `�s ��!�s��Inputfilemusthaves �� <GLOSSARY> {s��ands �� <ENDGLOSSARY>G���if non-glossarytextpreceedsandfollowstheglossary�$��section. `� �����Ifno �� <ENDGLOSSARY>1��tagis available,the remainderof5���theinputfile,startingatthefirst ��<GTERM>�� occurrence,is.�T�� consideredpartofthe glossary. `� �� ���NoY �� <INCLUDE>;��tagsare evaluatedwithintheglossarysec-K�,��tion:,allglossaryitemstosortmustbepresentinthe���sourceinputfile. `� ��L���Tagsforcommentblocksand/orliteralblocksareignored.G�\��Thismayleadto unexpectedresultsifcommentblocks*���includeorspanoneormore ��<GTERM> ��tags.(Commentson0���aglossarytermshouldfollowthe ��<GTERM>��,notpreceedit.�T����������������������������*���O����PromptsO�s��File:filespec��������������������! ��������c��O���� DescriptionO�s ��DOCTOR/GLOSSARY@s��scansthroughtheinputfileandwillsortthe4O���filepartthatstartswiththefirst ��<GTERM>.��tag occurrence,andO�$��endswiththeP$ �� <ENDGLOSSARY>0p$��tag.)Alltextbeforethissection1O�|��or followingit,remains untouched.��������������������! ��3������~��LO����TheglossarytermsaresortedinASCII collating sequence,IO���whereonlythe characterranges"A"-"Z"and"0"-"9"areNO�i�� evaluated.(Other charactersareignoredforthesortingpro-QO���cess.' Internallyallglossarytermsare convertedto uppercase.JO���Outputremainsthesameas specifiedintheinputfile.�����������������������=���������O���� QualifiersO�s��/LOGQO���This qualifierresultin additionalmessagesonthefilebeingEO�$�� processed.'Bydefaultnosuchmessagesareissued($ ��/NOLOG k$��).�������������������� ��������q��O����/OUTPUT=filespecPO�(��This qualifier specifiestheoutputfiletogeneratefromtheTO���inputfile.'Whenomitted,theoutputfiletakewillbethenextQO���higherversionoftheinputfile.(AwarningmessagewillthenSO�2��be generatedthattheoriginalfilemaybelostifapurgeisO���done.�q������������������� ��K������G��O����/SORT=keywordsOO�(��This qualifier determinesthewaythesortis performed.'OneDO���caneitherspecifyLETTERorWORD.WithLETTERallOO���termsaresortedwithspacesandhyphensasnot significant.MO�2��Thisisthedefault.'WORDdoestreatthoseas significant.�����������������������)������q���GO����InadditiononecanspecifythekeywordNONALPHAwith*O���oneofthe followingvalues:������������������������������ `�� ��<����NONALPHA=AFTER-alltermsstartingwithnonH�(�� alphabetic charactersare positionedattheendofthe��� glossary. `�� ��=����NONALPHA=BEFORE-alltermsstartingwithnonJ�Y�� alphabetic charactersare positionedatthestartofthe���glossary `�1 ��@�1��NONALPHA=IGNORE-alltermsaresortedontheir@���first alphabetic character.&Thisisthedefault.���-������ ���,���.�����������������������������������&���DigitalInternalUseOnlyO���DOCTOR/MESSAGE9O���CreateSDMLfilefromVMSMessagedefini-O���tions�*������������������������������������� ������������������� ����������� O����The�� ��DOCTOR/MESSAGE0���utilitycancreateaVAXDOCUMENTMO�(��SDMLfilewith explanationoferror messages,fromaprop-O���erlycodedV(���AX/VMSMessagesourcefile.�������������������������������O����Format1O�s��DOCTOR/MESSAGENfilespec [/qualifiers]O���Command Qualifiers��DefaultsO�:���/FAO:���/NOFAOO�|���/HELP|���/NOHELPO����/LOG���/NOLOGO����/OUTPUT��� /OUTPUT=.SDML�����������������������=���������O���� ParametersO�s��filespecMO���AvalidVMSfile specificationofaVMSMessage definition(O�$��file.'Defaultfiletypeis$ ��.MSG)($��.No wildcardsareallowed.�H�����������������������������O���� Restrictions `�s ��;�s��ItisassumedtheinputfilehasproperVs��AX/VMSB���MessageUtilitysyntaxandwill correctlycompile. `�K ��A�K��Comments describingthemessageshouldfollowthe$���message definitionline.�T����������������������������*���O����PromptsO�s��File:filespec�?������������������� ����������O���� DescriptionO�s ��DOCTOR/MESSAGE8ws��readsthroughthemessage definitionfileFO���andproducesaSDMLfilefromthecommentsthatde-MO�$��scribethe messages.)TheSDMLfilecanbeincludedinanyKO�|��SDMLsourcefilethatis processedfortheSOFTWAREfam-4O���ily doctypes.+ItwillthenproduceaQ ��<HEAD1>|��sectioninthatPO�-�� document, preferablyaspartofan appendix.(Forfulldetails O���see���Chapter4.�*����������������I��k��O������������������������������ ����������O���� QualifiersO�s��/FAORO���Whenthis qualifieris specified,themessagestringiswrittenO�$��intotheoutput|$ ��.SDML4R$��filewithall specifiedFAO argumentsIO�|�� unchanged.)BydefaultallFAO argumentsarereplacedby%O���genericstrings,suchas ��string��fora Y ��!AS��FAO argument.�S������������������� ��������)��O����/HELP,O�(��This qualifierwillproducean( ��.SDML(\(��filethatcanbe processedO���fortheX �� HELP.MESSAGE82��doctypethatis currentlybeing developed7O���byCUIPtoproduceinputfilesforthe �� HELP/MESSAGE��utilityfor@O�2��OpenVMSandAlphaVMSsystems.(Thedefaultis2 ��/NOHELP 2��,"O��� resultinginanormalk ��.SDML0A��messagefilefor insertionintoa7O���paperoronline Bookreaderuser'sguide.�������������������� �����������O����/LOGSO�(��This qualifierresultin additionalmessagesonfilesbeingpro-LO���cessedandoutputfilesbeingcreated.,Bydefaultnosuch*O���messagesareissued (/NOLOG).�������������������� ����������O����/OUTPUT=filespecPO�(��This qualifier specifiestheoutputfiletogeneratefromtheRO���inputfile.'Whenomitted,theoutputfiletakethesamevaluesNO���astheinputfile,exceptforthefiletype,whichbecomes! ��.SDML ��.XO�2��Itisallowedtospecifyonlyapartofa filespec.'MissingfieldsGO���defaultfromtheinputfields(exceptthetypepart).�2!��.���������-���/��������������������������/������k���&���DigitalInternalUseOnlyO��� DOCTOR/ONLINE.O���ModifySDMLfilesfor Bookreader�*��������������������������������������������������������! ��K������^�� O����The�� �� DOCTOR/ONLINE6���scansthroughthe specifiedSDMLsourceTO�(��fileandthefilesit references,forcorrectsyntaxtobepro-IO���cessedforthe BOOKREADER destination.(ThisimpliesthatPO���symbolsareaddedtoall unsymboled sections,tables,examplesO�2��andfigures.����������������������f��������O����Format0O�s�� DOCTOR/ONLINENfilespec [/qualifiers]O���Command Qualifiers��DefaultsO�:��� /CONDITION:��� /NOCONDITIONO�|���/DUMMY_SYMBOLS|���/NODUMMY_SYMBOLSO����/LIST���/NOLISTO����/LOG���/NOLOGO�D���/OUTPUTD���/OUTPUT=.SDML_ONLINEO����/REMOVE��� /NOREMOVEO���� /SUPERSEDE��� /NOSUPERSEDEO� ��� /SYMBOL_FILE ���/NOSYMBOL_FILEO�M��� /VERSION_1M��� /NOVERSION_1�������������������� �����������O���� ParametersO�s��filespecJO���AvalidVMSfile specificationofaVAXDOCUMENTsourceYO�$��file.)Thiscanbeasinglefileortheprofilefileofabook.)NoO�|��wildcardallowed.�����������������������=���������O���� Restrictions `�s ��?�s��It is assumed the input!files have proper VAX>���DOCUMENTsyntaxandwill correctlyprocessfor.�$��Mail,LN03or PostScriptoutput.�T����������������������������*���O����PromptsO�s��File:filespec�m������������������� ��������C��O���� DescriptionO�s �� DOCTOR/ONLINE@Os��scansthroughthe specifiedsourcefileanditsNO��� referencedfilestoensurethatsymbolsareattachedtoallQO�$�� sectioningtagsaswellasthe Bookreader"popup"items:(ta-/O�|��ble,exampleandfigure.*Usethe| �� /VERSION_1|�� qualifieriftheGO���documentis processedwithVAXDOCUMENTV1.2B.AtextMO�-��file explainingwhatactionsmustbetakenafter processing+O���canbeobtainedby specifyingp ��/LIST +��.�x�������������������! ��������N��O���� QualifiersO�s��/CONDITION=nameJO���This qualifier instructsDOCTORtoignoreany conditionalOO�$��textblockwhose conditiondoesnotmatchtheone specified.SO�|��Thiswillresultinignoringanysymboldefinedinthoseblocks5O���(andwhichhencewillshowupinthe ��/LIST ��or �� /DUMMY_SYMBOLUO�-�� specifiedfiles.(Itdoesnotaffect generationofsymbolstotagsSO���thatrequireone.*Allofthosewillgetone, regardlessofany&O��� conditionsetorremoved.�������������������� ����������%O����/DUMMY_SYMBOLS[=(keywords)]=O�(��This qualifier generatesafilethatcontainsl( ��<DEFINE_SYMBOL>O���tagsforeach< �� <REFERENCE>0��tagthatisusedinthedocumentMO���thathasno definition.)Thiswaythedocumentcanbepro-%O�2��cessed successfullyusing%2 ��DOCUMENT/SYMBOL=symbol_file2��untilQO���the referencesarewrittenupbytheauthorsorthe referenceO���itselfremoved.�������������������� ����������NO����Ifasymbolfileforthedocumentalreadyexists,thentheNO���dummysymbolfile generatedcanincludea referencetothis O�i��fileby insertinga$i ��<INCLUDE>(symbol_filespec)i��taginthegener->O���ateddummysymbolfile.,Thiswayyoucanuse% ��DOCUMENTO� ��/SYMBOL=dummyfile7��toprocessthe document,usingboththe<O�r�� predefinedsymbolsandthe generatedsymbols.�j�����������������������������@���@O����Therearethreekeywordsthatcanbe specified:�������������������� ����������O����OUTPUT=� ��filespec03���Allowstospecifytheoutputfile*3;��specwiththesymboldefini--3��tions.)Whenomitted,theoutput,3��filenameis identicaltothe,3E��inputfilenameandfiletype3 ��.SDML_DUMMY_SYMBOLS ��.O���TEXT=" ��textstring ��"/3��Allowstospecifythe replacement03p��textforall undefined references.*3��Whenomitted,itdefaultsto03! ��&<TAG>(reference\undefined_symbol_name) !��.9O���INCLUDE_SYMBOLSWhen specified,theresult-#3��ing dummysymbols file,3L��willalsocontainalinewith$3 ��<INCLUDE>(symbol_filespec)S��..This)3��isusefulwhenthedocument3V��is processedwithV ��DOCUMENT 3 ��/SYMBOL=dummy_filespec��because13��thiswillreadboththe predefined/3_��symbolsaswellasthe generated3��ones.��������������������! ��������z��O����/LIST [=filespec]WO�(��Whenthis qualifieris specified,alistfileis produced,contain-LO���ing instructionsofwhatactionstheauthormust undertakeGO���tomakethedocumenttruelyreadyfor Bookreaderpro-NO�2��cessing.*Actionsare instructionstocreate additionalfigure8O���files,oradding sentencesaroundcreated �� <REFERENCE>��tags.PO���Bydefaultnolistiscreated.,Whennofile specificationisWO�<��given,itdefaultstotheinputfilespec,butwiththefiletypeO� ��.ONLINE_ERRORS Z��.�������������������� �����������O����/LOGSO�(��This qualifierresultin additionalmessagesonfilesbeingpro-LO���cessedandoutputfilesbeingcreated.,Bydefaultnosuch"O���messagesareissued(M ��/NOLOG -��).��������������������! ����������O����/OUTPUT=filespecPO�(��This qualifier specifiestheoutputfilestogeneratefortheOO���modifiedinput.'Whenomitted,theoutputfilestakethesameRO���valuesastheinputfile,exceptforthefiletype,whichbe-O�2��comesE2 �� .SDML_ONLINE?2��.ItisallowedtospecifyonlyapartofaPO��� filespec.*Missingfieldsdefaultfromtheinputfields(exceptWO���thetypepart).&ItisadvisedeithertospecifyonlythediskandTO�<�� directoryorthefiletype.+Itis discouragedtospecifyafileUO���name,asalloutputwillthenresultinmultipleversionsoftheO���samefilename.����������������������������}��O����/REMOVEKO�(��This qualifierallowsyoutoremoveany generatedsymbolsO���addedby �� DOCTOR/ONLINE0��duringprevious processing.+Itex-#O���ecutesonlyPass1ofV �� DOCTOR/ONLINE"W��anddoesnotgenerateLO�2��anynewsymbols.)This qualifierismutually exclusivewithO� �� /SUPERSEDE ��.�b���������������������U������8��O���� /SUPERSEDE7O�(��This qualifierallowsyoutoremoveany( �� DOCTOR/ONLINE(��gen-IO���eratedsymbolsfromthedocumentandre-issuenewones.IO���ThisenablesyoutocombinedocumentelementsthatwereJO�2�� previously processed individuallyand thereforemighthaveIO��� identicalsymbolsdefinedinthesourceswhichmayleadDO���tomultiplesymbol definitionerrorsduringDOCUMENTCO�<�� processing.'This qualifierismutually exclusivetoK< ��/REMOVE Q<��.�(������������������������������O����/SYMBOL_FILE=filespecNO�(�� SpecifiesthatDOCTORshouldalsoreadafilethatcontainsGO���symbol definitionsthatwouldbeusedontheDOCUMENT%O���commandlinethroughthe, ��/SYMBOLK�� qualifier.�������������������� �����������O���� /VERSION_1QO�(��Specifythis qualifieronlyforsourcesthatmustbe processed3O���withVAXDOCUMENTV1.2B.ItinhibitsQ ��<SUBHEAD  ��*  ��>��tagstoO���begivenasymbol.�|A��/������!���.���0��������������������������/������\���&���DigitalInternalUseOnlyO��� DOCTOR/PS#O���Modify PostScriptfiles�*�������������������������������������������������������� ��K������X��SO����Thisutilityallowstoaddblankpagesto PostScriptfileswhenNO�(��requiredtohaveabalancedsetofodd/evenpages.+ItalsoWO���allowstoreplacetheprologpartofa PostScriptfileortopro-PO���ducean alternativeoutputfilethatconsistsofasubsetofO�2��pages.�x���������������������������N��O����Format3O�s�� DOCTOR/PSNPostScript_file [/qualifiers]O���Command Qualifiers��DefaultsO�:���/BLANK[=filespec]:���/NOBLANKO�|���/CHANGE_PROLOG|���/NOCHANGE_PROLOGO����/EXTRACT=range���None.O����/[NO]FIGURES=keyword���/FIGURESO�D���/LEADING_BLANKD���NOLEADING_BLANKO����/LOG���/NOLOGO����/OUTPUT=filespec0���nexthigherversionofinputfileO� ���/PROLOG=filespec ���None.O�M��� /NOPROLOGM���None.O����/SADDLE��� /NOSADDLEO����/2UP���/NO2UP��������������������! ����������O���� ParametersO�s��PostScript_fileSO���Inputfiletobescannedthroughandtoproduceanoutputfile8O�$��from.'ThefilemustadheretotheAdobe$ ��minimal conformant9O�|�� conditionsV2orV3,as describedinthe| �� PostScript ReferenceO� ��Manual4o��, publishedbyAddison&Wesley.&See��Section6.7.�*�����������������|��?��� ����������������������������d���������O���� Restrictions `�s ��H�s��Inputfilemustbeminimal conformant PostScriptcoded. `� ��H���Inputfilemaynotbean encapsulated PostScriptfile:3�K��musthaveproperprologandtrailer.�+������������������� ����������O���� QualifiersO�s��/BLANK[=filespec]PO���This qualifiermakessuretheoutputfileconsistsofabal-QO�$��ancedsetofoddandevenpagesto facilitateproperprintingSO�|��onadoublesidedprintingdevice.(ItwillalsoappendablankVO���pageifthefinalpageisodd.)ItwillalsoprefixablankpageRO�-��ifanextractrangestartsonanevenpageorappendablank6O���pageifarangeendsonanoddpage.�������������������� ��3��������PO����Youcanspecifyafile specificationthatcontainsacompleteQO��� descriptionofablankpage.*ThisfileshouldnotincludetheO�i ��%%Page:E}i��comment,butshould otherwisebecompleteinitself.UO���Ifnofileis specified,asimpleblankpageisproducedthrough O���the� ��showpage�� PostScriptcommand.�������������������� ����������O����/CHANGE_PROLOGPO�(��This qualifierallowstoreplacethestandardprologwithoneRO���thatdefinesan additionallineatthetop(header)andbottomWO���(footer)ofeachpage,aswellasafaintgreydiagonaltextlineQO�2��acrossthepage.)InadditionthesechangescanbesavedinaRO���newprologfiletobecreated,thatcanbeusedin subsequentO���casesthroughX ��/PROLOGw�� qualifier.��������������������������������� O����The�� ��/CHANGE_PROLOG3��� qualifiertakestwelve arguments,allHO���� optional,butatleastoneofthemmustbe specified:�g �������������������! ��������= �� `�� ��Q����TOP=text- specifiesthetextlinetobeprintedasaheaderN�(��oneachpage.)Ifthetextcontainsblanks,theentiretext7���stringshouldbewithin quotationmarks. `�� ��L���� BOTTOM=text- specifiesthetextlinetobeprintedasaP�Y��footeroneachpage.'Ifthetextcontainsblanks,theentire=���textstringshouldbewithin quotationmarks. `�1 ��B�1��COUNTER=integer- specifiesthestartingnumbertoK���beprintedonthebottomline, followingthetextspeci-B���fiedwithBOTTOM.Thenumber incrementswitheachF�:��pageandcanbeusedfor numberingpagesthatwould$��� otherwisebe unnumbered. `� ��K��� DIAGONAL=text- specifiesthetextlinetobeprintedinK�k��afaintgreyfont diagonallyacrosseachpageandunder-M���layingthetextonthepage.*Ifthetextcontainsblanks,J���theentiretextstringshouldbewithin quotationmarks. `� ��B���OUTPUT=filespec-If specified,thenewprologisI���alsooutputasaseparatefile./ThisfilecanbeusedE�L��in subsequent occassionsby inputtingitthroughthe� ��/PROLOG=��filespec qualifier. `�$ ��I�$��HSIZE=pointsize-If specified, determinesthe horizontalN�}��pagewidthusedto accomodatethetopline.&Ifomitted,A4$���sizedpaperisassumed. `�U ��E�U ��VSIZE=pointsize-If specified, determinestheverti-H� ��calpagewidthusedto accomodatethebottomline.+If2� ��omitted,A4sizedpaperisassumed. `� ��C� ��PAGESIZE=papertype-Thisallows specificationofaD� �� particularstandardsized papersheet..ItismutuallyH�6 �� exclusivetobothHSIZEandVSIZE.The papersizesrec-<� ��ognizedareLETTER,LEDGER,LEGAL, EXECUTIVE,A� ��7X9,35MM,A5,A4,A3,B5,B4,C6,C5andC4. `�g ��G�g ��BORDER-if specifiedtheunderlaypageis surroundedI� ��withathin rectangle:.thetextisprintedwithinthis1� �� rectangle.&Thedefaultis NOBORDER. `� ��?� ��GRAYSCALE=number-Ifused,youmustspecifyaL� ��numberbetween00and99.'Thisis translatedintoaper-I�H��centage(00-99%) indicatingthegreyscaleusedfortheO���diagonaltext.)Avalueof00isblack,99isalmostwhite.Q���Ifomitted,itdefaultsto95%:(alightgreytext.(NotethatJ�R��youmustenteraleadingzerofor percentages01-09,asO���asimple"0."isprefixedtothenumber,makinga"1"into���"0.1"-i.e.'10%. `� ��G��� FONT=fontname-Ifused,avalid PostScriptfontmustR���be specifiedtobeusedforthetop,bottomordiagonalline./�3��Forafulllistofkeywordssee3��Table6-1.3��Whenomitted,#���Helvetica-Boldisused. `�  ��H� �� SIZE=number-allows specificationofthetopandbot-O�d��tomlinefontsize.(Whenomitted,itdefaultsto15points.C���Valuesabove20pointsare pointless,butallowed.�*�����������������b��?����������������������������������������z��� O����The�� ��/PROLOG ���and� ��/CHANGE_PROLOG#��� qualifiersaremutuallyO���� exclusive.�������������������� ����������O����/EXTRACT=rangeSO�(��This qualifierallowstocopyasubsetofpagesfromtheorig-RO���inalfileintotheoutputfile.+Therangecanbe specifiedbyLO���givingthestartoftherange (compulsory)andeithertheJO�2��numberofpagestocopyfromthereonwardsorthepageRO���numberofthefinalpage.'Forthispurposethe qualifiertakesO���three arguments:�N�������������������! ��w������$�� `�� ��G���� START=folio- specifiesthestartingpagenumber.*E.g.E�(��IIIor4-6orINDEX-6.+ThevalidnumbersarethoseQ���thatare availableintheinput PostScriptfile.'If uncertain,���doa-^ ��$&SEARCH%postscript_fileK%%Page:�D������������������� ����������D����commandtoseewhichpagefolionumbersareavail-J����able.)Donotspecifytheopeningandclosing parenthesisJ�5��ifthefolionumbersare surroundedbythese.)(AdobeV3$���comment standardsonly). `�  ��O� �� END=folio- specifiesthelastpageofarangeofpagestoM�e��beprinted.'Avalidfolionumbermustbe specified,other-G���wisetheDOCTORwillincludeall remainingpagesupto"���theendofthefile. `� ��B���NUMBER=integer- specifiesthenumberofpagestoL���extractfromthe specifiedstartingfolioonwards.*IfthisF�G��numberislargerthanthe remainingnumberofpages,/���therestofthefileiscopied.�N������������������� ��������$��DO����EitherENDorNUMBERmustbepresent.-IfbothareLO����present,theshortestrangespanfromSTARTtoeitherENDLO�5��orNUMBERistaken.'Ifneitherarepresent,the remainderHO���ofthefile,fromtheSTARTfolioonwards,iscopied.���������������������! ������������IO����TheEXTRACT qualifiercanbe specifiedseveraltimestoUO����allowforseveralrangestobeincludedinthesameoutputfile.��������������������! ����������O���� /[NO]FIGURESOO�(��This qualifierallows manipulationofproperlyinsertedencap-,O���sulated PostScriptfigures.)The �� /NOFIGURESI�� qualifierremoves4O���thefiguresfromtheinputfile.(The\ ��/FIGURES�� (default)leavesAO�2��them untouched.-ByaddingthekeywordEXTRACTtoO���either: ��/FIGURE Z��or �� /NOFIGURE0*��thefiguresarewrittenintosep-LO���aratefigurefilesas encapsulated PostScript.*Theyreceive2O�<��theiroriginalnames (displayedwhen< ��/LOGW<��is specified).+IfGO���alsothekeyword PAGE_NUMBERis specified,thefiguresQO���getthesamefilenameastheinputfile,butwiththepagePO�E��numberappendedtoit.(Thisallowsforeasy referenceofthe3O���figuretotheprinteddocumentpage.�������������������� ����������O����/[NO]LEADING_BLANKMO�(��This qualifierwillproduceablankpagebeforetheactualNO���documentstarts.'Thisisrequiredwhenthe PostScriptoutputRO���fileistobeusedforreducedsizeprinting(with2documentTO�2��pagesonasinglesideofasheetofpaper).*This qualifierisTO���onlyrequiredwhentheoutputfileistoincludethefirstpage/O���ofthedocumentalso.(Defaultis ��/NOLEADING_BLANK1��.TheblankNO�<��pageproduceddoesnotuseauser-specifiedblankpagefile(O���thatcanbe specifiedwith ��/BLANK ��.�����������������������������l���O����/[NO]LOGGO�(��Outputs informationalmessagesonblankpagesthatareO��� inserted.�a���������������������K������7��O����/OUTPUT=filespecSO�(�� Specifiestheoutputfilethatwillbecreated.*Ifomitted,thePO���nexthigherversionoftheinputfileiscreatedandames-PO���sageisissuedtowarntheusernottopurge(whichdeletes*O�2��the original,completefile).�������������������� ��U������n��O����/PROLOG=filespecRO�(�� Specifiesthetextoftheprologpartoftheoutput PostScriptPO���file.(When specified,theoriginalprologpartisremovedandRO���thecontentsofthe specifiedfileis included.+ThisfilemustKO�2��becompleteandadheretothe PostScript conformantstyleO���(see���Section6.7.&��Thefinallineshouldbe �� %%EndProlog��.(Asim-VO���pleprologfile,usingaheader,footeranddiagonalline,canbeO�<��createdthroughthe2< ��/CHANGE_PROLOGV<�� qualifier.�*����������������N��|��?��� ������������������������������������ O����If�� �� /NOPROLOG@���is specified,theentireprologisomittedfromMO����theoutputfile.-Thiswayonecanincludetheoutputfile>O�5��intoanother PostScriptfile, e.g.0throughthe5 ��<FIGURE_!O� ��FILE>(ps\filespec\size)<��tag.-Inthiscase,theoutputfiletypeis0O��� defaultedto.EPSinsteadof.PS.������������������������������z��� O����The�� ��/PROLOG ���and� ��/CHANGE_PROLOG#��� qualifiersaremutuallyO���� exclusive.�������������������� ����������O����/SADDLESO�(��Theuseofthis qualifierismutually exclusivewithallothers'O���thatareallowedwiththe  ��/PS.�� qualifier.)Itallowstore-orderOO���pagesinsidethe PostScriptfilefor differentlyorderedout-PO�2��put.(Thisoutputcanbeusedtoproduce brochuresbyfoldingPO���pagesinthemiddle(tobecomea signature)andsaddlestichPO���themorbydrivingastaplethroughthespine.(ThisrequiresQO�<��thatprintingisdonewithtwopagesonasinglesheetside.%O���Formore informationsee��Section6.6.��Defaultis  �� /NOSADDLE p��.�*���������������W��|��?�����������l�����������������������������B���#O����Allowed qualifierswith� ��/SADDLE���are:�E������������������� ��[��������O����/LOG3K���Produce additionaloutputduringpro-K;��cessing.&Defaultis; ��/NOLOG ;��.JO���/OUTPUT=filespecQSpecifyoutputfilespecification.'Default8K��isthenexthigherversionoftheinputKf��fileCO���/GATHER=numberGNumbermustbeamultipleof4.,It5K8�� indicatestherangeofpagesthatare7K��printedasasingle signature.(Whennot6K�� specifieditdefaultstothenumberof+KB��pagesinthe PostScriptfile.�������������������� ����������O����/2UPKO�(��For PostScriptfilesproducedbyVAXDOCUMENTV2.1itisSO���possibletoinsert additionalcodethatallowsyoutoprinttheSO���fileondoublesizedpaper(e.g.)A3)withtwopagesonasideGO�2��(eg.(twoA4pages).)ThisonlyworksforVAXDOCUMENTJO���V2.1produced PostScriptfilesandthe qualifiermustbe#O��� specified followingthew �� /PS/SADDLE ��.�������������������� �� ��������O����ExamplesF�s��ThenextexampleshowshowblankpagesareaddedtoL���anexisting PostScriptfileandtheresultiscopiedinto�$�� BALANCED.PS. O���1. � ��$9��� DOCTOR/PSK myfile.PS%/BLANK/OUTPUT=balanced.PSL���The followingexampleshowsthe productionofafilethatJ�%��containsonlythetableof contents,5pagesofChapterN�}��2andtheIndex(whichisthefinalpartofthebook)ofJ���anexisting PostScriptfile.*Blankfilesareaddedwhere�.��needed. O���2. � ��$=��� DOCTOR/PS&book.ps%/EXTRACT=(START=III,END=XIV)%-, ��/EXTRACT=(START=2-1,% NUMBER=5)&-% ]��/EXTRACT=(START=INDEX-1)&-$ ��/OUTPUT=SUMMARY.PS&/BLANKL���The followingexampleshowsthe productionofafilethatH���hasabottomlineadded "InternalUseOnly-Rev.+B"K�`��anddiagonaltext"ReviewOnly",whichisprintedwithaL���90%greyscale(lightgrey.(00wouldbeblack,99almost� �� invisiblywhite). O� ��3. � ��$� �� DOCTOR/PS&book.ps%-3  ��/CHANGE=(BOTTOM="Internal%Use%Only",&-%Y? ��DIAGONAL="Review%Only",%-Y �� GRAYSCALE=90)%-$  ��/OUTPUT=SUMMARY.PS&/BLANKJ� ��Thenextexampleshowshowa29pagebookis convertedN�2 ��intoa32pagebookletathalfsizebyprintingitonanF� ��LPS20withtwopagesoneachsideanddoublesided: O� ��4. �) ��$A�) ��DOCTOR/PS/SADDLE%book.ps&/GATHER=32/OUTPUT=booklet.PS �q ��$F�q ��<PRINT/QUEUE=LPS20/PARAMETER=(DATA=POST,NUMBER=2,SIDE=TUMBLE)�,��0���������/���1��������������������������/������\���&���DigitalInternalUseOnlyO��� DOCTOR/SDML!O���MarkupFilesIncluded�*�������������������������������������������������������� ��������y�� O����The�� �� DOCTOR/SDML/���,scansthroughtheVAXDOCUMENTQO�(��sourcefilesforothersourcesincludedbythem,uptoanest-SO���inglevelof20.'TheseincludedfilescanbeVMSfilesorCMSOO��� elements,ifDEC/CMSis installedonthesystem.(ThesefilesLO�2��canbeanyoftheonesnormallyacceptedthroughstandardO���tags.OO�&��Itreportsthedocument structureasacommentblockinthePO�~��sourcefileandcanproduceanMMSbuildfileaswellasa;O���listofallthe occurrencesofindextags.��������������������}����������O����Format.O�s�� DOCTOR/SDMLMfilespec [/qualifiers]O���Command Qualifiers��DefaultsO�:���/CMS[=generation]:���/NOCMSO�|���/DOCTYPE=doctypeH|���/DOCTYPE=(PAPER=REPORT,ONLINE=SOFT.ONLINE,MANPAGE=MANPAGE)"O����/DESTINATION=destination@��� defaults:!LN03,PS, BOOKREADER,ROFF,MAIL,LINEO����/IGNORE=(options)��� /NOIGNOREO�D���/INCLUDE=filespecD��� /NOINCLUDEO����/INDEX=filespec���/NOINDEXO����/LOG���/NOLOGO� ���/MMS[=filespec] ���/NOMMSO�M���/OUTPUT=filespec M���/OUTPUT=input_filespecO���� /RANDOM_TEXT���/NORANDOM_TEXTO����/RULES���/RULES��������������������������������O���� ParametersO�s��filespecKO���AvalidVMSfilespecification., Wildcardsareallowed.,InNO�$��thatcaseallfilesmatchingthe specificationare processedO�|�� individually.�@�������������������������������O���� Restrictions�{�������������������! ��m������Q�� `�� ��K����The specifiedfile specificationonthecommandlinemustM�(��beanormalVMS filespec.(IfitresidesinCMS,youneedL���tofetchitfromtherefirst.+Anyfile referencedbythe0��� specifiedfilewillbefetchedby �� DOCTOR/SDML��itself. `�Y ��;�Y��IfDEC/CMSisnot installedonyoursystemY �� DOCTOR/SDMLI���canonlyinspectVMSfiles,notCMS elements.*Seealso� ��Preface. `� ��� �� DOCTOR/SDML7��cannotinspectany.STT (precompiledtagK��� definition)fileduetothe compressedtag definitionsin�:��those `� ��(��� Filespecsmustbe explicit. �� DOCTOR/SDMLG��willnot recognizeL��� filespecsthataredefinedwithinasymbolandreferedto �k��by>k ��<REFERENCE>(symbol)k��tags. `� ��� �� DOCTOR/SDML��willnotice  ��<INCLUDE_TEX_FILE>��tagsbutwillnot-�C��processanyofthe specifiedT T��E C��Xfiles.�*��������������������?��� ��������T����������������������������*���O����PromptsO�s��File:filespec��������������������! ����������O���� DescriptionO�s �� DOCTOR/SDML<s��readsthe specifiedVAXDOCUMENTsourcefileQO���andscansforthosetagsthatincludeotherfiles.*Thesetags O�$��are�$ �� <ELEMENT> P$��,|$ �� <INCLUDE> $��,$ �� <FIGURE_FILE> $��,$ ��<INCLUDE_TEX_FILE> n$��,O�| �� <ICON_FILE> |��,| ��<EXAMPLE_FILE> |��,4| �� <TABLE_FILE> |��and| ��<INCLUDES_FILE> |��.CO���Thetags introducedinVAXDOCUMENTV1.1arealsoO�-�� supported:- �� <FILE_SPEC> }-��and- �� <MEMO_FILE>!-��.)Whenthe qualifierO� ��/INDEX.I��is specified,italsolooksfor  ��<X> ��and H ��<Y> ��.�������������������� ����������RO����Itwillthenopenthosefilesandrepeattheprocess,upto20NO���levelsdeep.*When finished,itwillwriteaspecialcommentTO�i��headeratthestartofthesourcefile, indicatingthe structureCO���ofthedocumentandthefilesitrefersto.)When" �� DOCTOR/SDMLSO���isrunseveraltimesoverthesamefile,thiscommentblockisOO�r�� refreshed,ifleft unmodifiedbytheuser(it recognizesthe����������������������������|��2O����IfDEC/CMSisusedonyoursystem,� �� DOCTOR/SDMLT���canalsoMO����attempttolookuptheincludedfilesinyourcurrentCMS*O�5�� librariesifyouspecifythe5 ��/CMS'5�� qualifier.,Ifa generationPO���orCMSclassis specified,onlyelementsthatbelongtothat&O��� generationarelookedup.���������������������! ��N���������SO����Apartfrom informationinsidethesourcefile,itcanalsogen-PO����eratea descriptionfileforMMStoprocessthefilescanned+O�5��throughoranyofitsparts.��������������������! ����������O���� QualifiersO�s��/[NO]CMS[=generation],O���Usingthis qualifierwillurge| �� DOCTOR/SDML3��alsotolookintoTO�$��your currentlysetCMSlibraryifanyofthefiles specifiedinQO�|��theSDMLsourcefilescannotbefoundinthe specifieddirec-SO���tories.(After inspections,thesefetchedfilesaredeletedagain.LO�-��TheonesfoundinCMSaremarkedwith"(CMS Library)"inO���thecommentheader.�D�����������������������������PO����ItonlylooksintoCMSforincludedfiles:*the"main"sourceQO���fileyou specifiedonthecommandlinemustexistasfileinKO�i��your directoryandwillnotbefetchedfromCMS.DefaultO���valueisx ��/NOCMS X��.����������������������N���������:O����Iftheerrormessage%MARFIN-F-NOCMSSUPoc-O����curswhen� ��/CMS;���is specified,itmeansthatDEC/CMSisnotCO�5�� installedor availableforuseonthesystem.&See5��Preface.�*��������������������?��� ��������_���������������������������5��O����Ifwith_� ��/CMS8���youalsospecifyaCMSclassname,then� ��DOCTORO�� ��/SDMLH%���willonlylookintotheCMSlibraryforelementsthatSO�5��belongtothisclass.,Inallothercases,therequiredfileis#O���reportedasnotfound.��������������������� �����������O���� /DESTINATIONOO�(��This qualifieracceptsfour keywords,eachallowingtomodifyEO���thedefault destinationusedforDOCUMENT processing:����������������������o������m�� `�� ��&���� BOOKREADER=.-Defaultsto4� �� BOOKREADER���foronline�(�� destinations `� ��&��� POSTSCRIPT=.+Defaultsto �� POSTSCRIPT��for PostScript���� destinations `� �� ���LN03=.'Defaultsto ��LN03!m��forLN03 destinations `� �� ���MAIL=.'Defaultsto ��MAIL!}��forMAIL destinations `�~ ��(�~�� LINE_PRINTER=.,Defaultstou~ �� LINE_PRINTERR~��forline���printer destinations `�V �� �V��ROFF=.'DefaultstoV ��ROFF!}V��forRoff destinations������������������������������y���JO����Ifmorethanone destinationis modified,the individual/O����keywordsare separatedbycommas.��������������������������������O����/DOCTYPEOO�(��Youcanspecifythetypeofdocumenttobuildforpaperor<O���online destinations.'Ittakesthree keywords:�s������������������� ��������I�� `�� ��?����PAPER=./Acceptsanyvalidpaperdoctypename.�(��DefaultstoREPORT. `� ��A���ONLINE=.-Acceptsanyvalidonlinedoctypename.'����DefaultstoSOFTWARE.ONLINE `� ��C���MANPAGE=.&Acceptsanyvalidmanpagedoctypename.���DefaultstoMANPAGE�������������������� ��U�������� O����/IGNORE=(keyword-list)IO�(��When specified,DOCTORwillalsoscancertainblocksof?O���textthatarenormallyignored.*Bydefaultany� �� <COMMENT> O���or� �� <LITERAL>>%��blockisnotscannedforfile inclusiontags.O�2�� Specifying2 ��/IGNORE72��willallowyoutoforceDOCTORtoscanQO���oneorbothoftheseblocktypes.'Theallowedoptionkeywords O���are� ��LITERAL ��and ��COMMENT4��.Whenbothare specified,theymust&O�<��be separatedbyacomma:#< ��/IGNORE=(COMMENT,LITERAL) <��.�"�������������������! �����������O����/INCLUDE=filespecQO�(�� SpecifiesanMMSincludefilethatallowstheusertospecifyBO��� additionalrules,macrosorsymbols.'Resultsina+ ��.INCLUDEo��line*O���intheMMS descriptionfile.�������������������������������O����/INDEX=filespecO�(�� Instructs( �� DOCTOR/SDML:_(��alsotoproduceafile containingalltheQO���indextags,togetherwiththeir occurrence(filespecandlineO���withinfile).�������������������������������O����/[NO]LOGKO�(��Thisoutputs additional informationalmessagesoneachin-3O���cludedfileduringthe processingofT �� DOCTOR/SDML��.DefaultisO� ��/NOLOG /��.�������������������� ����������O����/[NO]MMS[=filespec]MO�(��This generatesanMMS descriptionfiletorebuildthedoc-MO���ument.+ThisfilehasthesamefilenameasthesourcefileTO��� processed,butwithfiletype.MMS.Afilespec specifiedtothisNO�2�� qualifierwilltake precedence.*Youshouldnotspecifyfile-MO���namesand/ortypesiftheinputfile specificationcontainsO��� wildcards.�������������������� ����������O����/OUTPUT=filespecNO�(��When specifieditwillproducethenewversionoftheSDML)O���file(thatwillcontainthe �� DOCTOR/SDML"��header)asthespeci-PO���fied filespec.*Whenomitted,anewversionoftheinputfileNO�2�� parameterismade.'Notethatwhenwildcardinputfilespec-MO��� ificationsareusedoneshouldnotspecify filenamesand/orO���types.�}���������������������K������S��O���� /RANDOM_TEXT7O�(��Addssome additionalrandomtexttothe( ��/INDEX(��producedIO���outputtoallow processingofthefilebyVAXDOCUMENT#O���withoutrunningintoT ��E,��Xmemoryexceedederrors.+Only&O�2��validin combinationwith2 ��/INDEX 2��.�(������������������� �����������O����/RULESO�(�� Specifying( ��/NORULES4(�� suppressesthe generationofMMSsuf-OO���fixesanddefaultactionrulestoretrieveelementsfromCMS"O��� libraries.'Bydefault,? ��/RULES9��isused.�= ��1������ ���0���2��������������������������/������j���&���DigitalInternalUseOnlyO���DOCTOR/TAG_COUNT*O���CountalltagsinSDMLfile�*�������������������������������������@������������������� ���������� O����The�� ��DOCTOR/TAG_COUNT7e���utilitycountsalltag constructsinsideIO�(��anSDML document.&ThisdocumentmaybeacompletebookNO���(profileplus elements).,Itreportsthecountedtagsinthe!O���producedoutputfile.��������������������������������O����Format3O�s��DOCTOR/TAG_COUNTNfilespec [/qualifiers]O���Command Qualifiers��DefaultsO�:���/OUTPUT:���/OUTPUT=.TAG_COUNTO�|���/LOG|���/NOLOG�������������������� �����������O���� ParametersO�s��filespecPO���AvalidVMSfile specificationofanSDMLfile.(No wildcardsMO�$��areallowed.,Filemaybetheprofileofthebookandmay(O�|��refertootherSDMLfiles.��������������������������������O���� Restrictions `�s ��F�s��Anytag-like constructisseenandcounted, including���thoseinside �� <COMMENT> '��or �� <LITERAL>��blocks.�T����������������������������*���O����PromptsO�s��File:filespec�������������������� ����������O���� DescriptionO�s ��DOCTOR/TAG_COUNT;s��scansthroughthe specifiedinputSDMLfileRO���andallits referencedSDMLfilestocountalltags.(TagsareKO�$��any consecutivenumberof alphabeticornumeric charactersNO�|��or underscores, surroundedbyangle brackets.*Itreportsits=O���findingsintheoutputfile.'Fordetailssee%��Chapter8.�*�������������%����l��O���Z�����������������������������=���������O���� QualifiersO�s��/LOGMO���This qualifierresultin additionalmessagesonfilesbeingEO�$�� processed.'Bydefaultnosuchmessagesareissued($ ��/NOLOG k$��).������������������������������O����/OUTPUT=filespecPO�(��This qualifier specifiestheoutputfiletogeneratefromthePO���inputfile.)Whenomitted,theoutputfiletakethesameval-SO���uesastheinputfile,exceptforthefiletype,whichbecomesO�2 �� .TAG_COUNTJ2��.Itisallowedtospecifyonlyapartofa filespec.PO���Missingfieldsdefaultfromtheinputfields(exceptthetypeO���part).�>��2���������1���3��������������������������/������d���&���DigitalInternalUseOnlyO��� DOCTOR/XREF)O���Listcross referencesymbols�*������������������������������������������������������������������ O����The�� �� DOCTOR/XREF;���utilityenablesyoutoproduceafilewithO�( ��<DEFINE_SYMBOL>;(��tagsofallsymbolsdefinedwithinabook,O���derivedfromits ��.XREFv��file.TO���Italsoenablesyoutoproducealistingofallsymbols,sortedPO�u��alphabeticallyorbysymboltype (chapter,table,exampleetc)�I���������������������-��������O����Format3O�s�� DOCTOR/XREFM xref_filespec [/qualifiers]O���Command Qualifiers��DefaultsO�:��� /ALPHABETIC:��� /ALPHABETICO�|��� /BOOKTITLE|���noneO����/FULL���/NOFULLO����/LIST���/NOLISTO�D���/LOGD���/NOLOGO����/NUMERIC���/NUMERICO���� /SYMBOL_FILE���/NOSYMBOL_FILEO� ���/PREFIX ���noneO�M���/SORTM���/NOSORTO����/SYSTEM_SYMBOLS���/SYSTEM_SYMBOLSO����/TEXT���/NOTEXTO����/VALUE���/VALUE�O������������������� ��������%��O���� ParametersO�s�� xref_filespec3O���AvalidVMSfile specificationofa& ��.XREF!��cross referencefile,GO�$��producedbyVAXDOCUMENTduringabookbuilt.'DefaultO�|��filetypeis| ��.XREF)|��.No wildcardsareallowed.�@�������������������������������O���� Restrictions��������������������� ��r������x�� `�� ��:����ItisassumedtheinputfileisaproperD� ��.XREF���fileproduced�(��byVAXDOCUMENT `� ��-���Atleastoneofthe qualifiers �� /SYMBOL_FILE ��, ��/LIST ��or ��/SORT2����mustbe specifiedinordertohave� �� DOCTOR/XREFe���perform�Y��anyaction.�T����������������������������*���O����PromptsO�s��File:filespec�M�������������������! ��������#��O���� DescriptionO�s �� DOCTOR/XREF&s��inspectsavalidDOCUMENTPs ��.XREF%s��fileproducedOO���duringa bookbuild operationofamultiplefile document.)ItPO�$��allowsthe productionofeitherafilewhereallsymbolsareQO�|��definedoncemore explicitlytoallowyouto incorporatethoseNO���symbolsintoanothersetof documentsandenablecrossref-3O�-��erencingbetweenbooks.*The qualifier- �� /SYMBOL_FILE-��isthenO��� required.��������������������! ��3��������OO����InadditionitallowsyoutoproducetabularlistingofallQO���symbolsdefinedina document,for referencebytheauthoror5O�i��writers.'Thesetablesare generatedasi ��.SDMLi��fileswithi ��<TABLE>NO��� constructsthatcan subsequentlybe processed individuallyby7O���DOCUMENTusingtheREPORTdoctypestyle.����������������������F��������O���� QualifiersO�s�� /ALPHABETIC!O���OnlyvalidwhenalsoZ ��/SORT00��is specified.(It indicateswhetherMO�$��thesortedlistingshouldbeorderedbysymbolnameorbyGO�|��theobjectorsectionnumber.)Whennoneis specified,| ��/SORTO� �� /ALPHABETICE��isassumed.)Togetbothfeaturesinonefile,bothO�-��also�- ��/SORT-��mustbe specified.�M������������������� ��������#��O����/BOOKTITLE="string"NO�(��Aquotedstring specifyingthenameofthebookfromwhichPO���thecross referencefile originates.*Thistextisusedduring@O��� referencingofthesymbols,tooutpute.g.,"See ��TheLifeofO�2 ��BrianL42��Chapter4, Mothers..."Thetext specifiedisdefinedasaO���symbol_ ��prefix_d ��BOOK>��toallow referencestoit.(Theprefixisset O���by� ��/PREFIX,��.Defaultisanemptystring.�/������������������� ����������O����/FULLPO�(��Definesthesymbolvaluetoconsistofname,numberandfullO���text(e.g.. ��Chapter4,Whereitallhappens��).'Defaultis ��/NOFULL ��.O���Seealso} ��/VALUE ]��.�f�������������������! ��U������<��O����/LIST[=filespec]FO�(�� SpecifiesthefilespecofanormalVAXDOCUMENTfile3O���inwhichallsymbolsdefinedinthe^ ��.XREF7��inputfileareLO���listedin alphabeticalorder.,Thisoutputcanbe processedFO�2��throughVAXDOCUMENTandusedbyauthorsandwritersNO���fortheirown reference.+Whennofilespecisgiven,itde-QO���faultstothesamenameastheinputfile,butwithfiletypeO�< ��.SDML_SYMBOL_LIST<��.Defaultisb< ��/NOLIST g<��.��������������������� ��A������m���O����/LOGDO�(��Outputs additional informational messages.'Defaultis( ��/NOLOG (��.������ �������������� ����������O����/NUMERIC!O�(��OnlyvalidwhenalsoZ( ��/SORT00(��is specified.(It indicateswhetherRO���thesortedlistingshouldbeorderedbysymbolnameorbythe6O���objectorsectionnumber.(Whenomitted, ��/SORT/ALPHABETIC ��isSO�2��assumed.'Togetbothfeaturesinonefile,both qualifiersmustO���be specified.������ �������������� ��K������V��O����/PREFIX=filespecWO�(��AshortstringtoprefixtoallsymbolsdefinedintheinputfilePO���tomakethemunique.(Ifomittednoprefixisused,butsym-LO���bolsfromseveralbooksmayhavebeendefined identically,IO�2��causing referencing conflicts.'Awarningisthenissued.������ ��������������! ��K������_��O����/SORT[=filespec]O�(��Similarto( ��/LISTA(��.Allsymbolsareagainlisted,butnowgroupedTO���bytheirclass(figure,table,chapteretc).(WhennofilespecisTO���given,itdefaultstothesamenameastheinputfilebutwithO�2��filetypei2 ��.SDML_SYMBOL_TYPE 2��.������ ��������������! ��K������k��!O����/SYMBOL_FILE[=filespec]XO�(�� SpecifiestheoutputfilespecofthefilethatwillcontainalltheO� ��<DEFINE_SYMBOL>@�� definitions.)Ifthefilespecisomitted,itde-SO���faultstoyourcurrent directory,withfilename identicaltothe'O�2��inputfile,butfiletypev2 �� .SDML_XREF 2��.������ �������������� ����������O����/SYSTEM_SYMBOLSGO�(��Foritsownuse,DOCUMENTalso generatesanumberofMO���symbols(likehighestsectionnumberin document,pagepre-MO���fix,onlinechunk).+Thesearenormallynotofinterestfor5O�2��theuserand thereforeomittedinthe2 �� DOCTOR/XREFb2��output.O��� Specifying ��/SYSTEM_SYMBOLS-"��alsoincludesthose.+DefaultisO� ��/NOSYSTEM_SYMBOLS ��.�������������������� �����������O����/TEXTPO�(��DefinesthesymbolvaluetoconsistofthetextpartoftheHO���symbolonly.'(e.g.'"Whereitall happens").'Defaultis ��/NOTEXT ��. O���See� ��/VALUE ��.�������������������������������O����/VALUEMO�(��DefinesthesymbolvaluetoconsistofthenameandvalueKO���numberonly(e.g.(Chapter4).(Thisisthedefaultifno ��/TEXT O���or� ��/FULL��is specified.����3���������2���4����m����������������������u������C���&���DigitalInternalUseOnlyO�\��A.!Error!messages�I��������������������������������O����A.1CDOCMSGMessages���4���������3���5����P���������������������k������&��&���DigitalInternalUseOnlyO�(��CREATED,,Created (��'(��string (��'��� Severity:P�� INFORMATIONAL�^�� Explanation:7^�� Indicatesthe successfulcreationofthe"���outputfile specified.�R��UserAction:R��None.�Q������������������� ��k������'��GO����PASS1,,StartPass1:'Readallmessagesandsortthem�(��alphabetically��� Severity:P�� INFORMATIONAL�^�� Explanation:6^��Scansthroughthesource.MSGfileand,��� registersallmessagesdefined.�R��UserAction:R��None.����������������������������w��:O����PASS2,,StartPass2:'Generatemessagefile�k�� Severity:Pk�� INFORMATIONAL��� Explanation:5��Usingthe informationgatheredinPassK�^��1,theoutputSDMLfilewithmessagesis constructedforG���eachfacilityandeachmessagesoutputin alphabetical���order.���UserAction:��None.�I��������������������������������O����A.2CDOCTORMessages�������������������� ����������O����IDENT,,Thisis ���'���string ���')���version c���'���string x���'�k�� Severity:Pk�� INFORMATIONAL��� Explanation:<�� IndicatesthecurrentversionoftheutilityJ�^��thatisinvoked.(Thisis importantwhenbugsandwishes5���are expressedtothe developmentteam.�R��UserAction:6R��Specifynumberwhen submittingSPR'sor���QAR's.��������������������! ����������!O����NOTIMPL,, Functionality Y���'���string n���'���notyetimple-�(��mented��� Severity:P�� INFORMATIONAL�^�� Explanation::^��The specified functionalityisnotyetim-H��� plemented,eventhoughthecommand interfaceisalready���present.���UserAction:)��Waittillthenextrelease.� ������������������� ��&��������?O����SENDQAR,,Internalerror.+PleasesendQAR.Error �(��ID: h(��'(��string ~(��'��� Severity:P�� INFORMATIONAL�^�� Explanation:9^��YoumanagedtogiveasetofinputdataO���thatcausedtheutilityprogramtogoto"catchall"state-2���mentsthatshouldneverbereached.���UserAction:6��Pleasenotifythe developersbySPRorI���QAR, describingtheerrorand specifyingtheversionofJ�\��thesoftwareused,theerrormessages displayedandpos-O���siblyasampleoftheinputfilesthatcausedtheerrortoE� ��occur,togetherwiththe specifiedcommand statement.�L�����������������������������"���"O����A.3C DTAGCOUNTMessages�*������������������������������O����CREATED,,Created ���'���string ���'�k�� Severity:Pk�� INFORMATIONAL��� Explanation:7�� Indicatesthe successfulcreationofthe"�^��outputfile specified.���UserAction:��None.�������������������� ��u��������O����FNF,,File ���'#���string ���'+U���is referencedindocumentbut+�(��doesnotexist-willignore��� Severity:P��WARNING�^�� Explanation:5^�� Indicatesthatthedocumentcontainsa� �� <INCLUDE> D��or ��<INCLUDES_FILE> ��orC �� <ELEMENT>��tagreferingtoI���afilethat currentlydoesnotexistatthat location.���UserAction:7��Makefile availableorcorrecttheSDMLF���filebyremovingthe referencetoit.)The DOCTOR/TAGJ�\��utilitywillignorethisfileinitscounting procedure.�A�����������������������������O����SCAN,,Scanning ���';���string ���'�k�� Severity:Pk�� INFORMATIONAL��� Explanation:4�� IndicatesthecurrentSDMLfilebeing>�^�� processedinthesearchfortagsusedinit.���UserAction:��None.�K�����������������������������!���!O����A.4CGLOSSARYMessages�L���������������������������"��O����CREATED,,Created ���'���string ���'�k�� Severity:Pk��SUCCESS��� Explanation:9�� Indicatesthe successful completionoftheH�^��utilityandthecreationofthe specifiedoutputfile.���UserAction:��None.�������������������� ��u������V��7O���� DUPLICATE,, Duplicateentryfor<GTERM>' f���'���string {���' ���'�(��infile��� Severity:P��FATAL�^�� Explanation:8^��TheSDMLfilethatcontainstheglossary=���containsmultiple identicalentriesdefinedby2 ��<GTERM> W��.+���Thismakessorting impossible.���UserAction:6��Remove duplicatesorcombinethemtoa���single ��<GTERM>��entrywitha ��<LIST>(numbered)��toindicatethe-�\�� differentmeaningsoftheword.�6����� ����������������u������ ��6O����GTERMOUTBOUND,,Found<GTERM>tagoutside-�(�� <GLOSSARY>- <ENDGLOSSARY>range��� Severity:P��FATAL�^�� Explanation:^��DOCTORfoundZ^ ��<GTERM>^��tagsouside���thevalidrangeofm �� <GLOSSARY> ��and �� <ENDGLOSSARY>��.*ThisB���isinvalidforDOCUMENTandalso unacceptablefor�h��DOCTOR.���UserAction:��Movethe\ ��<GTERM>#��tagsinsidetheproper�\��glossaryblock.���5������ ���4���6����\�����!����������������������2��&���DigitalInternalUseOnly8O�J�� NEXTGLOSSARY,,Multiple <GLOSSARY>tagsen-1��� countered.'Canonlysortoneblock�=�� Severity:P=��FATAL��� Explanation:��Several �� <GLOSSARY>��tagsareencoun-G�1��teredinthe specifiedinputfile.*BecauseDOCTORcan;���onlysortasingleblockbetweenthefirst �� <GLOSSARY> 0��and� �� <ENDGLOSSARY>8��tag,thecurrentfileisnot acceptable.�}��UserAction::}��CombinebothglossaryblocksintoasingleL���oneorsplitthemintotwoormorefiles,whicharein-�.��cludedby@. �� <INCLUDE>-.��intothefinal document.*DOCTORG���cansorteachoneoftheglossaryfiles individually.������"��������������N ��&��������"O����NOALPHA,-Foundterm" K���'{���string `���' ���"without alphabetic:�(�� characters.'Donotuse/SORT=NONALPHA=IGNORE��� Severity:P��FATAL�^�� Explanation:6^��Thesortingprocessis conductedeitherI��� explicitlyorbydefaulttoignore nonalphabeticcharac-H���ters.+Thecurrenttermconsistssolelyof nonalphabeticG�h�� charactersandcan thereforenotbesortedasanull���string.�\��UserAction:,\��Specify/SORT=NONALPHA=BEFOREorM���AFTERtoallowthetermtooccuratthestartorendof<� ��the glossary.'Alternatively,removetheterm.�5�����#���������������������� ��9O����NOENDGLOSSARY,,Noclosing <ENDGLOSSARY>tag�(��found��� Severity:P��WARNING�^�� Explanation::^��Duringthescanningoftheinputfile,no� �� <ENDGLOSSARY>��tagwasfound.�R��UserAction: R��AddR �� <NOGLOSSARY>(pR��.)Orignore,iftheglos--���saryitemsareincludedviaanC �� <INCLUDE>��tagthatis"��� positionedbetweenthe  �� <GLOSSARY> ��andJ �� <ENDGLOSSARY> P��.�T�����$��������������! ��u������*��;O���� NOGLOSSARY,,Openingtag <GLOSSARY>notfound%�(��beforefirst<GTERM>tag��� Severity:P��WARNING�^�� Explanation:^��DOCTOR discovereda?^ ��<GTERM>^��withouta��� precedingH �� <GLOSSARY> ��.�R��UserAction:4R��None.*Usermaywishtocheckwhether0��� elsewhereinthedocumentthetag �� <GLOSSARY>n��isspeci-P���fied.'Theremustbeoneifthisdocumentistobe processed'�\�� correctlybyVAX DOCUMENT.�v�����%�������������� ��������L��=O���� NOGTERMS,-Inputfiledoesnotcontain<GTERM>�(��tags��� Severity:P��FATAL�^�� Explanation:9^��TheSDMLinputfiledoesnotcontainany� ��<GTERM>��tagtosorton.�R��UserAction:=R��Checkonuseofproperfileoraddglossary���terms������&�������������� ��&��������DO���� SAMEFILESPEC,-Outputfileisnexthigherversionof�(��inputfile..���Purgingwillloseoriginalfile.��� Severity:P��WARNING��� Explanation:=��Youdidnotspecifyanexplicitoutputfile,M���hencetheutilitydefaultstotheinputfilespecification.O�h��However,thismaycausethelostoftheoriginalinputfile9���isan accidentalpurgecommandisissued.�\��UserAction:;\��RenamethelatestversionintoanotherfileM���nameorcopythefiletoanotherlocationtoavoidlosing� ��theoriginalcopy.�I������'��������������������������O����A.5CMARFINMessages�[�����(����������������k������1��O����ATLAST,,Created E���'u���string [���'�k�� Severity:Pk�� INFORMATIONAL��� Explanation:7�� IndicatesthecreationofanewversionC�^��ofthemainVAXDocumentfileMarfinhasfinished���reading.�R��UserAction:R��None�R�����)����������������������(��O����CREATED,,Created ���'���string ���'�k�� Severity:Pk�� INFORMATIONAL��� Explanation:9�� Indicatesthe successful completionoftheH�^��utilityandthecreationofthe specifiedoutputfile.���UserAction:��None.�l�����*�������������� ��u������B��O����FNF,,File ���' ���string ���'&O��� referenced,butnotfound�k�� Severity:Pk��WARNING��� Explanation:>��Intryingtolocateallfilesthatwereref-I�^��erencedbythe document,the indicatednumbercouldnotJ���befound.(InthecommentheaderoftheSDMLfilespec-J���ifiedonthecommandline,youcanseewhichonesthey�h��are.���UserAction:8��Eitherremovethe indicated referencesor0�\��retrieve/createthefiles required.������+�������������� ��������l��>O����HUMANS,,Humans-alwaysgivingthewrongcom-�(��mands.-���Marfindothis,Marfindothat��� Severity:P��FATAL��� Explanation:3��InvalidDCL parametersor combination&���of qualifiersweregiven.���UserAction:8��Specifyacorrectcommandline.(Readthe���manual!�/�����,��������������! ��u��������O����IGNORED, +���'[���string A���'�k�� Severity:Pk��WARNING��� Explanation:2��Atthecommandlinetwo definitionsJ�^��forthesameentityaremade(e.g.* destination specifiedD���with /DESTINATIONaswellasforthedocumenttypeF��� /POSTSCRIPT).Inthiscasethemessage indicateswhat�h��isignored.���UserAction:<��Removeoneofthe conflicting definitionsor$�\��acceptthesetdefault.������-��������������) ��k��������/O����MMSTOO,,MadeMMS descriptionfile x���'���string ���'�k�� Severity:Pk�� INFORMATIONAL��� Explanation:.�� IndicatesMarfin alsocreatedanF�^��MMS descriptionfiletoautomatethebuildingofthe%���VAXDocumentsourcefile�R��UserAction:@R��None.&UsethisfilewithMMS/DESCRIPTION=file.MMS���6������ ���5���7����_�����.�������������� ��������5��&���DigitalInternalUseOnlyO�J��MUMBLE, J��'6J��string J��'��� Severity:P�� INFORMATIONAL��� Explanation:2��Marfinishavingoneofhismoods.���UserAction:=��Bearwithdignityafteralltheworkhedid�s��foryou������/�������������� ��&������q��<O���� NOCMSSUP,,DEC/CMSnot available.*Reissuecom-�(��mandwithout/CMS��� Severity:P��FATAL�^�� Explanation:1^�� DOCTOR/SDMLcouldnotfindtheDECH���/CMSproductlibraryand thereforeassumesthisproduct/���isnot installedonyoursystem.���UserAction:3��Reissuethecommandwithout/CMS.InH��� addition,youmaywanttoinstall(after purchase)DECD�\��/CMSasversion managementsystemforyourdocumentB���files.*Afterthat,DOCTOR/SDML/CMSwilloperateon � ��these librariestoo.������0�������������� ��������~�� O���� NOTFOUND,-Therewere s���'!���unsigneddecimalnum- �(��ber _(��'8(��files referencedthatcouldnotbefound��� Severity:P��WARNING�^�� Explanation:>^��Intryingtolocateallfilesthatwereref-I���erencedbythe document,the indicatednumbercouldnotJ���befound.(InthecommentheaderoftheSDMLfilespec-J�h��ifiedonthecommandline,youcanseewhichonesthey���are.�\��UserAction:8\��Eitherremovethe indicated referencesor0���retrieve/createthefiles required.�R�����1����������������������(��O���� OHMYDIODES, ���'���string ���'�k�� Severity:Pk��FATAL��� Explanation:(��Internal programmingerrors.���UserAction:)��Pleasesubmitbugreportto �� IJSAPL::KLERK ���or8 ��TheodeKlerk@UTO ��.�5�����2���������������������� ��,O����OHNO,-Iwon'tenjoy processing x���'���string ���'�k�� Severity:Pk�� INFORMATIONAL��� Explanation:3�� IndicatesthemainVAXDocumentfile!�^��Marfintriestoread���UserAction:��None�I������3��������������������������O����A.6CONLINEMessages�2�����4�������������� ����������+O����CREATED,,Createdmodifiedfile ���'���string ���'�k�� Severity:Pk�� INFORMATIONAL��� Explanation:=��Themodifiedinputfile(s)iswrittenoutas�^��newfile.���UserAction:��None.�n�����5����������������k������D��'O����CRELIST,,Createdlistfile ���'���string ���'�k�� Severity:Pk�� INFORMATIONAL��� Explanation:<��Thelistinputfilewithactionstoperform�^��iswritten.���UserAction::��Readthefileandcomplywiththeactions�R�� suggested.�@�����6������������������������!O����FNF,,Filetoinclude ���'���string ���'!���notfound-willbe�(��ignored.��� Severity:P��WARNING�^�� Explanation: ^��AK^ �� <ELEMENT> ^��or<^ �� <INCLUDE>^�� specifiesafileE���thatmustbeincludedinthe document,andassuchB���wouldalsobe inspectedbyDOCTOR/ONLINE.However,K�h��thegivenfilespecdoesnotrefertoanexistingfile.C��� DOCTOR/ONLINEwillnotattempttofindandinspect���the specifiedfile.���UserAction:9��the specifiedfilespecmaybe incompleteG� ��(e.g.(onlynameandtype mentioned)andyoumaycur-F�e��rentlyexecuteDOCTORfromanother directory.(InthatI���case,youmaywanttochangeyourdefault directorytoJ���thecorrectoneforDOCTORtofindthefiles specified.L�o�� Otherwiseeitherlocatethe specifiedfileandstartagain���orignoreit.�v�����7�������������� ��������L�� O���� INPUTFNF,-Inputfile ���'���string ���'N���notfound�k�� Severity:Pk��FATAL��� Explanation:9��The specifiedinputfilecannotbefound.���UserAction:<��Specifyexistinginputfile.(Correctspelling.���ordevice/directoryspecification.�������8����������������������n���O����INSPECT,, Inspecting ���'����string ���'�k�� Severity:Pk�� INFORMATIONAL������9�������������� ��k������h��O����MODIFY,- Modifying ���'���string ���' ���tobe compliantfor"�(�� BOOKREADER destinations��� Severity:P�� INFORMATIONAL�^�� Explanation::^��Theoriginalinputfile(s)aremodifiedtoD���beproperly formattedforDOCUMENTonline processing�R��UserAction:R��None.������:����������������k������i��@O����PASS1,, Collectinglabeland reference information�k�� Severity:Pk�� INFORMATIONAL��� Explanation:;��Theinputfileandthefilesit referencesI�^��are inspectedforanylabelsdefinedand referenced,to?���buildadata structuretobeusedinPass2.�R��UserAction:R��None.���7������ ���6���8���������;����������������=��������&���DigitalInternalUseOnlyCO�J��PASS2,, Generatinglabels, referencesand figure_file���tags�=�� Severity:P=�� INFORMATIONAL��� Explanation:7��Theinputfileandthefilesitrefer-E�1��encesare inspectedandmissinglabelsare inserted.0��� Unreferencedlabelsare referenced.�$��UserAction:$��None.�|�����<��������������! ��������R��'O����REMOVE,-Removedlabelfrom Y���'���string n���' ���tag�k�� Severity:Pk��WARNING��� Explanation::��Somesectiontagshavenolabel associated,�^��withtheminVAXDOCUMENTV1. j��*\^��.+Theyareal-J���lowedinV2,butthe /VERSION_1 qualifierthatwasused&���causedittoberemoved.���UserAction:8��None,ordonotspecify /VERSION_1qual-L���ifier.+Inthiscase,theoutputcanonlybe processedby�\��VAXDOCUMENTV2. "g��*�I������=��������������������������O����A.7CPSSCANMessages�3�����>��������������! ��9������ ��8O����ABSENTPAGESCHEME,-Pagenumber indicatedas �(��'(��string (��';���Blankpage insertion mechanismmaynotwork���properlyhere�u�� Severity:Pu��WARNING��� Explanation:9��Itisallowedby PostScriptcommentstan-F�h��dardstodefineapagecommentas'%%Page:+?,n'orN���'%%Page:'""n'iforanyothertextstringwithoutanex-I���plictpagenumber specifiedandprintedonthephysicalK�r��page.*The'?'*or""isreplacedby DOCTOR/PStobe"?-O���0"toallowproper processingofthepageasifitwereaD�#��knownpagenumbersystem.+However,sinceitisun-H�{��knownwhether"?"pagesareoddoreven,thereisnoF���waytoknowwhether additionalblankpagesshouldbe�-�� inserted.���UserAction:;��None.'Theuseof/BLANKontheinputfile7� ��isprobablynotusefulinthiscontext.�f�����?����������������������<��2O����CONFORM,,Fileassumedtoconformto ���'���string ���'�k�� Severity:Pk�� INFORMATIONAL��� Explanation:9��Input PostScriptfileseemstoconformtoE�^��theAdobeInc.' (minimal) conformantcoding standards.���UserAction:��None.�L�����@����������������������"��O����CREATED,,Created ���'���string ���'�k�� Severity:Pk��SUCCESS��� Explanation:9�� Indicatesthe successful completionoftheH�^��utilityandthecreationofthe specifiedoutputfile.���UserAction:��None.� �����A������������������������1O����CREATOR,,Inputfilewascreatedby G���'w���string ]���'�k�� Severity:Pk�� INFORMATIONAL��� Explanation:3��Thismessage indicatestheoriginofG�^��the PostScriptfilethatis currentlybeing processed.E��� Dependingonthisorigin,somefeaturesof DOCTOR/PSB���maynotbeused.)AllVAXDOCUMENTproducedfiles&�h��willbehandled properly.���Useraction:��None�x�����B����������������k������N��O���� INSERTED,-Page +���'[���string @���'���inserted�k�� Severity:Pk�� INFORMATIONAL��� Explanation:8�� IndicatesthatablankpagewasinsertedH�^��intotheoutputdocumenttobalancethenumberofodd���/evenpages.�R��UserAction:R��None.������C�������������� ����������-O���� INVALCOUNT,,Invalidpagecounter :���'j���signeddecimal�(��number (��'(c(��.'Mustbepositiveinteger��� Severity:P��FATAL�^�� Explanation:<^��ThepagecountertobeaddedtothefooterK���mustbeapositiveinteger.)Negativevaluesandzeroare���notallowed.���UserAction:7��Specifypositiveintegerfrom1upwards.� �����D��������������! ����������>O���� INVORDINAL,,InputfileviolatesAdobe standard:�(��ordinalstartsat w(��'!(��signeddecimalnumber j(��'��� Severity:P��WARNING�^�� Explanation::^��ThecommentsofthefirstpageinsidetheN��� PostScriptfileshouldindicatethefolionumberaswellasN���thesequencenumberofthepagewithinthefile.'ThefirstF�h��pageisassumedtohavesequencenumber1.)ForsomeN���reason,theprogramthatoutputthe PostScriptfiledidnotG���startcountingfrom1upwards,butfromthe indicated�r��number.� ��UserAction:3 ��None-TheDOCTORwillrectifythisK�e��intheoutputfileit produces.-YoumaywishtofileaG���ProblemReporttothe producersofthesoftwarepack-O���agethatmadeyour PostScriptfile,statingtheyviolatethe(�o��Adobe programming standards.������E��������������! ��O��������&O���� INVPAGCOM,,Pagecomment" 7���'g���string M���'}���"atline ���' ���un-!�(��signeddecimalnumber (��'<���not conformingtoAdobe PostScript standards.$���Ignoredaspagemarker.�u�� Severity:Pu��WARNING��� Explanation:9��Theinputfilecontainsinvalid conformantE�h��coding comments,wherebytheutilitycannot interpretH���thepagedata correctly.&AlthoughDOCTORwill continue,M���itignoresthislineaspageandassumesthereisnonew�r��pagethatstarts.� ��UserAction:= ��Inspectthefinaloutput.'Itmaynotbeex-J�e��actlywhatyouwanted,butitmay.)Thiscanbechecked���throughthe&�C ��$&SEARCH%filespec%%%Page:J���DCLcommandandseeifallpagesare correctlyodd/even�6�� positioned.�q�����F��������������! ��u������G��8O���� NEGPAGNO,,Invalidpagenumbertoconvert: ���'���signed�(��decimalnumber x(��'��� Severity:P��FATAL�^�� Explanation::^��ApagenumberwaspassedtoaroutinetoI���be convertedtoanASCIIRomanofArabicnumeral.'ThisI���erroroccurswhenanegativenumberispassedfromthe=�h�� PostScriptfileorthroughaninternalerror.���UserAction:0��SeeDOCTORSENDQARmessageiftheH�\�� PostScriptfiledoesnotcontainnegativepagenumbers.������G�������������� ��������b��?O���� NOCHANGE,,Inputfileneededno modification.)No�(��newfile generated��� Severity:P�� INFORMATIONAL�^�� Explanation::^��The operationoftheutilityontheinputO���fileresultedinan identicalcopyfortheoutput.' ThereforeJ���nooutputis generated.(ThemessageisalsoissuedwhenI�h��oneormorepagerangesshouldbe extractedbutnota,���singlerangecouldbelocated.�\��UserAction:9\��Behappywiththecurrent PostScriptfile-���orspecifycorrectpageranges.� ��8������ ���7���9���������H��������������! ��������t��&���DigitalInternalUseOnly>O�J��NOPAGE,,Filecontainsnovalid%%Page:,markers;���andisnotAdobeCodingStandard conformant�=�� Severity:P=��WARNING��� Explanation:;��Despitethefactthatthefilestartswith �1��a1 �� %!PS-Adobe81��headertosuggestitconformstoAdobe's4��� StructuredCoding PostScript standards,>�$��itdoesnot,because individualpagesarenot�}��markedbya} ��%%Page }��:#1}��commentline.1 ThereforeE���DOCTORisnotableto distinguishbetweenpagesfor&�.�� extractionor re-ordering.���UserAction:=��Trytocreatethe PostScriptfileagainfromL�!��thetext processortool, enforcingAdobe standards.'IfMS-G�z��Windows applicationsareused,thePrintSetup...*menuQ���willallowyou(aftervariouslayersof Options...'orSetup...C�+��submenus)tochecktheboxfor"Adobe StructuredF���Coding Standards".(Oncechecked,outputthe PostScript���fileagain.�f�����I��������������! ��������<��AO���� NOPROLOG,,Filedoesnotcontainvalid %%EndProlog*�(��comment.'NotAdobe conformant��� Severity:P��WARNING�^�� Explanation: ^��the^ �� %%EndProlog';^��commentlinefailsintheO��� PostScriptfile.)Assuch,itisnot conformingtotheAdobe(��� StructuredCoding standards.���UserAction:=��Trytocreatethe PostScriptfileagainfromL���thetext processortool, enforcingAdobe standards.'IfMS-G�\��Windows applicationsareused,thePrintSetup...*menuQ���willallowyou(aftervariouslayersof Options...'orSetup...C� ��submenus)tochecktheboxfor"Adobe StructuredF�e��Coding Standards".(Oncechecked,outputthe PostScript���fileagain.�m�����J�������������� ��&������C��AO���� NOTCONFORM,,Fileisnot (minimally) conformingto�(��Adobe PostScript*��� standards.'Nooutputcreated.��� Severity:P��FATAL��� Explanation:7��The specifiedinput PostScriptfiledoesG���notseemtoadheretotheAdobeInc.+minimalconfor-I�h��mantcoding standard.'Hencetheutilitycannot correctlyM��� interprettheinputfile(evenifitiscorrect PostScript���code).���UserAction:7��Whateveryouwantedtodomustbedone� �� manually.�i�����K��������������! ��������?��@O���� NOTVAXDOC,,/CHANGEusedonPSfilenotproduced%�(��byDOCUMENTor DECwrite.&���Successisnot guaranteed��� Severity:P��SUCCESS��� Explanation:0��The/CHANGEisonly guaranteedto;���workforVAXDOCUMENTandDECwriteproducedJ�h�� PostScriptfiles.' Dependingonthe adherenceto standardsD���byother PostScript creators,/CHANGEmayalsowork@��� successfullyhere,butnosuccessis guaranteed.���UserAction:*��None.'Useatyourownrisk.�+�����L��������������! ��u��������2O����PASS,,StartinginputfilescanPass ���'!���unsigneddecimal�(��number (��'��� Severity:P�� INFORMATIONAL�^�� Explanation:4^��Becausesomany PostScriptfileshaveJ���figuresandplotfilesincludedthatallhavetheirownF��� %%Trailer commment,itis necessarytofindtheveryO�h��last %%Trailerpositioninthefilebeforestartingthereal��� processing.�\��UserAction:\��None.�5�����M�������������� �������� ��/O���� RANGESKIP,-Pagerangestartingat 1���'a���string F���' ���not�(��found��� Severity:P��WARNING�^�� Explanation::^��Issuedattheendofthe processingofaN��� PostScriptfilefromwhicharangeofpageshadtobeex-L���tracted.'ThestartingpagenumbercouldnotbelocatedinJ�h��theinputfile,hencetheentirerangeisnot included.���UserAction:+��Specifycorrectstartingpage.������N�������������� ��&��������DO���� SAMEFILESPEC,-Outputfileisnexthigherversionof�(��inputfile..���Purgingwillloseoriginalfile.��� Severity:P��WARNING��� Explanation:=��Youdidnotspecifyanexplicitoutputfile,M���hencetheutilitydefaultstotheinputfilespecification.O�h��However,thismaycausethelostoftheoriginalinputfile9���isan accidentalpurgecommandisissued.�\��UserAction:;\��RenamethelatestversionintoanotherfileM���nameorcopythefiletoanotherlocationtoavoidlosing� ��theoriginalcopy.������O�������������� ��&��������:O���� SHORTRANGE,-Twoendrangevalues specified.�(��Usingshortestof (��'#(��unsigneddecimalnumber (��' A(��and ���'��string ��'��� Severity:P�� INFORMATIONAL��� Explanation:2��You specifiedthe/EXTRACT qualifier?���withbothanENDandNUMBERkeyword.) WhicheverI�h��ofthetwo indicatesthesmallestnumberofpagesfrom7���the specifiedSTARTpage,willbeused.�\��UserAction:6\��Acceptor respecifythe/EXTRACTrange,C���usingonlyoneofthetwoendingkeywordsENDor� ��NUMBER.������P������������������������<O���� SKIPFIGURE,-Removingfigurefromoutputdocu-�(��ment: (��'(��string (��'��� Severity:P�� INFORMATIONAL�^�� Explanation:9^��The specifiedfigurefileisremovedfromJ���the PostScriptoutputtobecreated.)Thisallowsconver-O���siontoolsto reconstructtheoriginaltextfilewithoutthe>�h��graphics informationinsertedfromothertools.���UserAction:��None������Q�������������� ����������;O���� STARTRANGE,, Includingpagerangestartingat �(��'(��string (��'��� Severity:P�� INFORMATIONAL�^�� Explanation:6^��Informsyouthatthe specified/EXTRACTK���rangewasfoundandis activated.(The specifiedrangeof9���pageswillbecopiedtotheoutputfile.���UserAction:��None.������R����������������&��������?O���� TRUNCATED,- Resultingfigurefilenametoolong.�(�� Truncatedto (��'2(��string (��'��� Severity:P��WARNING�^�� Explanation:7^��Byaddingthepagenumbertotheorig-H���inalinputfilenametocomposethefigureEPSoutputA���filename,thenameexceededthemaximumallowedC�h��RMSfilenamelength.(DOCTOR therefore truncatedtheH���namebyremovingthelastfew charactersoftheinput(���filenametomakeitfit.���UserAction:6��None.*Youmaywishtorenamethefile8� ��namemanuallyafterDOCTORhas completed.�g�����S��������������! ��u������=��)O���� UNKWNPAG,,Unknownpagetype: ���'���string ���'�k�� Severity:Pk��FATAL��� Explanation::��Theutilitycanonlyhandlearabicorro-L�^��mannumberedpagessuchas1,2,3or1-1or Glossary-6L���orPART1-IXorIII.TheinputfileseemstocontainpageE��� numberingschemesotherthanthesetwo.*Therebythis>�h��utilitycannot interpretthosepages correctly.���UserAction:7��Whateveryouwantedtodomustbedone�\�� manually.�I������T��������������������������O����A.8CSADDLEMessages�|,���)��������������INDEXINDEX��!�����i���� � i���AA��C�����S�����9����ABSENTPAGESCHEMEABSENTPAGESCHEME�>���/�����S�����8����ATLASTATLAST�(���!�����i���� � i���BB��X�����S���#�#�8����%%BeginDocument:!comment%%BeginDocument: comment�������8�����S��� ��8����blankpageblank page�����@�����S����N9����user specifieduser specified�����3�����S��� ���8���� BookreaderBookreader��F�����S����N8����Adding referencesAdding references�����@�����S����N9����AddingsymbolsAdding symbols�����R�����S���#�#N8���� correctingfilesfor-correcting files for -�����H�����S����N8����figurefilefor-figure file for -�����K�����S����N9����withDOCUMENTV1.2Bwith DOCUMENT V1.2B�����]�����S���)�)N8����withDOCUMENTV2andhigherwith DOCUMENT V2 and higher�����/�����S�����8����BorderBorder�����h�����S���".�.�9���� Brochure, producingreducedsizedBrochure, producing reduced sized�����:�����S��� ��8����BugReportsBug Reports�����!�����i���� � i���CC��5�����S�����8����CONFORMCONFORM�?��W���M�����S�����9����CREATEDCREATED�������)��4��@��X��h���5�����S�����9����CREATORCREATOR�A��Y���1�����S�����8����CRELISTCRELIST�5���B�����S�����8����cross referencecross reference�p���!�����i���� � i���DD��Z�����M����)�)�3����DOCUMENT/GRAPHICS-SeeRAGSDOCUMENT/GRAPHICS - See RAGS��1�����S�����8����DEC/CMSDEC/CMS�$���X�����S���&�&N9����classandDEC/MMSrebuildclass and DEC/MMS rebuild�2���1�����S�����8����DEC/MMSDEC/MMS����U�����S���%�%N8����UseofMMSandDOCUMENTUse of MMS and DOCUMENT�>���C�����S�����8����DECwindows/MotifDECwindows/Motif�M���5�����S��� ��9���� DEFGATHERDEFGATHER�Z���R�����S���&��8���<DEFINE_SYMBOL> 8����tag<DEFINE_SYMBOL> tag�m���+�����S������8����DOCTORDOCTOR��7�����S��� �N9���� componentscomponents�m����;�����S��� �N8���� installationinstallation� ����7�����S��� �N8���� invocationinvocation�����>�����S����N9����usingDEC/CMSusing DEC/CMS�����=�����S�����8���� DOCTOR/ONLINEDOCTOR/ONLINE�����H�����S�����8����document structuredocument structure����Z�����S���'�'N9����buildMMS descriptionfilebuild MMS description file�+���5�����S��� ��8���� DUPLICATEDUPLICATE����!�����i���� � i���EE��N�����S��� � �8���� %%EndCommentscomment%%EndComments comment����P�����S���!�!�9����%%EndDocument:!comment%%EndDocument: comment�����N�����S��� � �8���� %%EndDocumentcomment%%EndDocument comment����J�����S�����8���� %%Endprologcomment%%Endprolog comment����!�����i���� � i���FF��5�����S��� ��8���� .FACILITY.FACILITY�����+�����S������9����figurefigure��m�����S���"/�/N8���� extracting-from PostScriptfileextracting - from PostScript file��������F�����S���-�-N9����removing-from PostScriptfile�����1�����S��� � �8����FNFFNF���*��6���8�����S��� ��8����FSEformatFSE format�����!�����i���� � i���GG��/�����S��� ���9����GlossaryGlossary��f�����S���!-�-N8���� International charactersetsortInternational character set sort�~����1�����S����N8����sortingsorting�r����8�����S��� �N8����sortordersort order�z����=�����S�����9���� GTERMOUTBOUNDGTERMOUTBOUND� ���B�����S��� ��8���<GTERM> 8����tag<GTERM> tag�v����!�����i���� � i���HH��P�����S�����8���� HELP/MESSAGEutilityHELP/MESSAGE utility�������/�����S�����9����HUMANSHUMANS�+���!�����i���� � j���II��-�����S�����8����IDENTIDENT����1�����S�����8����IGNOREDIGNORED�,���>�����S�����9����IncludefilesInclude files����>�����S�����8����IndexentriesIndex entries�O���>�����S����N8���� correctionofcorrection of�Y���3�����S��� ��9����INPUTFNFINPUTFNF�7���3�����S��� ��8����INSERTEDINSERTED�B���1�����S�����8����INSPECTINSPECT�8���7�����S��� ��8���� INVALCOUNTINVALCOUNT�C���;�����S��� ��9���� INVORDINALINVORDINAL�D��[���5�����S��� ��8���� INVPAGCOMINVPAGCOM�E���!�����i���� � i���LL��-�����S�����8����LaTeXLaTeX�a���:�����S������9����LPS20printerLPS20 printer��a�����S���+�+N8����UsefordoublesidedprintingUse for double sided printing����:�����S������8����LPS40printerLPS40 printer��E�����S����N9����UseforprintingUse for printing����!�����i���� � j���MM��/�����S�����8����MARFINMARFIN�%���G�����S�����8����Messagefile,VMSMessage file, VMS�����D�����S����N9����elementsofa-elements of a -�����D�����S����N8����sortingmessagessorting messages�����V�����S���(��8���<MESSAGE_SECTION> J8����tag<MESSAGE_SECTION> tag�����/�����S�����8����MMSTOOMMSTOO�-���/�����S�����9����MODIFYMODIFY�9���>�����S��� ��8���<MSG> 8����tag<MSG> tag�����H�����S���!��8��� <MSG_TEXT> @8����tag<MSG_TEXT> tag�����/�����S�����9����MUMBLEMUMBLE�.���!�����i���� � i���NN��3�����S��� ��8����NEGPAGNONEGPAGNO�F���;�����S��� ��8���� NEXTGLOSSARYNEXTGLOSSARY�!���1�����S�����9����NOALPHANOALPHA�"���9�����S��� ��8���� NOBOOKTITLENOBOOKTITLE�i���3�����S��� ��8����NOCHANGENOCHANGE�G���3�����S��� ��9����NOCMSSUPNOCMSSUP�/���=�����S�����8���� NOENDGLOSSARYNOENDGLOSSARY�#���/�����S�����8����NOFOURNOFOUR�\���-�����S�����8���� NOGLOSSARY�$���3�����S��� ��9����NOGTERMSNOGTERMS�%���3�����S�����8����NOPAGENOPAGE�H��]���3�����S��� ��8����NOPREFIXNOPREFIX�j���3�����S��� ��9����NOPROLOGNOPROLOG�I���7�����S��� ��8���� NOSORTSPECNOSORTSPEC�k���;�����S��� ��8���� NOTCONFORMNOTCONFORM�J��^���3�����S��� ��9����NOTFOUNDNOTFOUND�0���1�����S�����8����NOTIMPLNOTIMPL����5�����S��� ��8���� NOTVAXDOCNOTVAXDOC�K���!�����i���� � i���OO��7�����S��� ��9���� OHMYDIODESOHMYDIODES�1���+�����S�����8����OHNOOHNO�2���1�����S�����8����ORDEREDORDERED�_���!�����i���� � i���PP��F�����S�����8����%%Page:!comment%%Page: comment�������-�����S�����9����PAGESPAGES�`���/�����S�����8����PASSPASS�L��a���1�����S�����8����PASS1PASS1���:���1�����S�����9����PASS2PASS2���;���<�����S��� ��8����PerfectbindPerfect bind�����3�����S��� ���8���� PostScriptPostScript��A�����S����N9����AddblankpageAdd blank page�����T�����S���#�#N8����%%BeginDocument:!comment%%BeginDocument: comment�����a�����S���*�*N8���� conformant PostScriptskeletonconformant PostScript skeleton����K�����S����N9����drawingpageborderdrawing page border�����L�����S����N8���� encapsulatedfiguresencapsulated figures�����P�����S���!�!N8����%%EndDocument:!comment%%EndDocument: comment�����L�����S����N9����minimal conformantminimal conformant�m��� ���F�����S����N8����%%Page:"comment%%Page: comment��������Q�����S���"�"N8����pagerange descriptionpage range description�����H�����S����N9����prolog replacementprolog replacement�����J�����S����N8���� structuredcommentsstructured comments�����U�����S���"�"N8���� structuredcommentsV2structured comments V2�������U�����S���"�"N9���� structuredcommentsV3structured comments V3�������X�����S���&�&N8����user specifiedblankpageuser specified blank page�����>�����S������8���� PostScriptfilePostScript file��H�����S����N9����prolog replacementprolog replacement�����D�����S�����8���� PostScriptfilesPostScript files�����B�����S�����8����PS2TEXTutilityPS2TEXT utility�����H�����S�����9���� %!PS-Adobecomment%!PS-Adobe comment����!�����i���� � i���QQ��:�����S��� ��9����QARreportsQAR reports�����!�����i���� � i���RR��/�����S�����8����RAGSRAGS�������=�����S��� �N8����usewithMMSuse with MMS�J���5�����S��� ��9���� RANGESKIPRANGESKIP�M���5�����S��� ��8���� referencereference�c���>�����S�����8���� referencetagreference tag�����J�����S���"��9��� <REFERENCE> u9����tag<REFERENCE> tag�����)�����S�����8����REMOVE�<���[�����S���(�(�9����RulesforMMSandDOCUMENTRules for MMS and DOCUMENT�<���/�����S�����8����RunoffRunoff�a���!�����i���� � i���SS��D�����S��� ��8����SaddlestichSaddle stich����������C�����S��� ��8���� SAMEFILESPECSAMEFILESPEC�&��N��b���+�����S�����9����SCANSCAN����2�����S��� ���8����SDMLfileSDML file��`�����S���*�*N8����addingsymbolsfor Bookreaderadding symbols for Bookreader�����1�����S�����9����SENDQARSENDQAR����K�����S�����8����SETDISPLAYcommandSET DISPLAY command�N���5�����S��� ��8���� .SEVERITY.SEVERITY�����+�����S�����9����SGMLSGML�a���7�����S��� ��8���� SHORTRANGESHORTRANGE�O���7�����S��� ��8���� SKIPFIGURESKIPFIGURE�P���7�����S��� ��9���� STARTRANGESTARTRANGE�Q���c�����S���,�,�8���� .SUFFIXESforMMSandDOCUMENT.SUFFIXES for MMS and DOCUMENT�<���7�����S�����8����symbolsymbol�������c���X�����S���&�&N9���� definitionofallsymbolsdefinition of all symbols�m���L�����S��� � N8����listofallsymbolslist of all symbols�g���3�����S��� ��8����SYMTRUNCSYMTRUNC�l���!�����i���� � i���TT��'�����S������9����TagsTags��3�����S��� �N8����countingcounting�[���5�����S��� ��8���� TRUNCATEDTRUNCATED�R���!�����i���� � i���UU��3�����S��� ��8����UNKWNPAGUNKWNPAG�S���3�����S��� ��9����UNSUPVERUNSUPVER�c���)�����S��� � �8����2UP2UP�U���5�����S��� ��8���� 2UPNOTSUP2UPNOTSUP�V���+�����S�����9����UTOXUTOX�����!�����i���� � j���VV��%�����S���� � �8����VMSVMS��1�����S����N8����AlphaAlpha�������/�����S����N9����OpenOpen�������!�����i���� � j���WW��3�����S��� ��8����WHATTODOWHATTODO�m���!�����i���� � i���XX��6�����S��� ��8����XREFfileXREF file�c���>�����S���� �8���<X> E8����tag<X> tag���O���!�����i���� � i���YY��>�����S���� �9���<Y> E9����tag<Y> tag���O���!�����i���� � j���ZZ��-�����S�����8����ZzTeXZzTeX�a�����9������ ���8���:���������U�������������� ��u��������&���DigitalInternalUseOnlyHO�(��2UP,- Preparingfilefor2UPprintinginthenextfile��� version...��� Severity:P�� INFORMATIONAL��� Explanation:4��Thefilethatwassortedforsaddle-H��� stitchingisoncemoremodifiedtoadd PostScriptcodeO�h��toallowittobeprintedas2-upwithoutany reductionof���thepagesize.�\��UserAction:\��None������V������������������������BO���� 2UPNOTSUP,,The/2UPfeatureisonly supportedfor�(��VAXDOCUMENTV2.1��� Severity:P��FATAL�^�� Explanation:/^��The PostScriptcodeadded toal-C���low2-upprintingisspecificforthecodegener-8���ated byVAX DOCUMENT V2.1.2Until a moreE�h��genericcodeis developed, noother PostScriptfilesF���canbe processedwith/2UP.ThefilecreatedcanbeC���usedforreducedsaddlestitch printing, usingthe4�r��!/PARAMETER=(SIDE=TUMBLE,NUMBER=2)feature ���ofthe printservers.�e��UserAction:-e��Use the /SADDLE byitselfwith+���!/PARAMETER=(SIDE=TUMBLE,NUMBER=2)�f�����W����������������������<��2O����CONFORM,,Fileassumedtoconformto ���'���string ���'�k�� Severity:Pk�� INFORMATIONAL��� Explanation:9��Input PostScriptfileseemstoconformtoE�^��theAdobeInc.' (minimal) conformantcoding standards.���UserAction:��None.�L�����X����������������������"��O����CREATED,,Created ���'���string ���'�k�� Severity:Pk��SUCCESS��� Explanation:9�� Indicatesthe successful completionoftheH�^��utilityandthecreationofthe specifiedoutputfile.���UserAction:��None.� �����Y������������������������1O����CREATOR,,Inputfilewascreatedby G���'w���string ]���'�k�� Severity:Pk�� INFORMATIONAL��� Explanation:3��Thismessage indicatestheoriginofG�^��the PostScriptfilethatis currentlybeing processed.E��� Dependingonthisorigin,somefeaturesof DOCTOR/PSB���maynotbeused.)AllVAXDOCUMENTproducedfiles&�h��willbehandled properly.���Useraction:��None������Z��������������! ��������a��8O���� DEFGATHER,,No/GATHER qualifier specified.�(��Using/GATHER= (��'#(��unsigneddecimalnumber (��' -(��as���default��� Severity:P�� INFORMATIONAL��� Explanation:8��Whenno/GATHERis specified,theentireI���bookis re-orderedintoasingle gathering.*ThisallowsR�h��youtoeitherfoldthepaperstackintoabrochureortocutI���thepaperstackinthemiddlefora paperbackglueing.�\��UserAction:8\��Noneorspecify/GATHERwitha different���value� �����[��������������! ����������>O���� INVORDINAL,,InputfileviolatesAdobe standard:�(��ordinalstartsat w(��'!(��signeddecimalnumber j(��'��� Severity:P��FATAL�^�� Explanation::^��ThecommentsofthefirstpageinsidetheN��� PostScriptfileshouldindicatethefolionumberaswellasN���thesequencenumberofthepagewithinthefile.'ThefirstF�h��pageisassumedtohavesequencenumber1.)ForsomeN���reason,theprogramthatoutputthe PostScriptfiledidnotG���startcountingfrom1upwards,butfromthe indicated�r��number.� ��UserAction:3 ��None-TheDOCTORwillrectifythisK�e��intheoutputfileit produces.-YoumaywishtofileaG���ProblemReporttothe producersofthesoftwarepack-O���agethatmadeyour PostScriptfile,statingtheyviolatethe(�o��Adobe programming standards.�C�����\��������������! ��u�������� O����NOFOUR,,The/GATHER= r���'!���unsigneddecimalnum- �(��ber _(��'#(��isnot divisibleby4��� Severity:P��FATAL�^�� Explanation:8^��Saddlestaplingcanonlyoccurwhenmul-N���tiplesof4pagesare specified(thatcanbeprintedonaL���singlesheet-frontandbackside).'The specifiednumber$�h��isnot divisibleby4.���UserAction:4��Specifyacorrectnumberthatcanbe�\��dividedby4.������]�������������� ��������U��@O����NOPAGE,,Novalid%%Page:*commentlines.+Fileis4�(��notAdobe StructuredCoding conformant��� Severity:P��FATAL�^�� Explanation:<^��The specifiedinput PostScriptfiledoesnot���seemtoadhere;�R��totheAdobeInc.,minimal conformantcoding/���standardasitlacksthe%%Page:2��page separationF���commentlines.+Hencetheutilitycannot correctlyin-K�\��terprettheinputfile(evenifitiscorrect PostScript���code).�O��UserAction:7O��Attemptto re-createthe PostScriptfileH��� enforcingthetext processortooutput conformantAdobeC���� StructuredCodingStandardcode.(For MS-Windowsap-H�Y�� plications,thismayimplytoenterthePRINTSETUP...L���menuandfind(undervariouslayersof additionalSetup...G� ��or Options...*andAdvanced Options...)menus)thecheckF�b��boxforAdobe StructuredCoding Standards.*Checkthis4���andexportthe PostScriptfileagain.�m�����^�������������� ��&������C��AO���� NOTCONFORM,,Fileisnot (minimally) conformingto�(��Adobe PostScript*��� standards.'Nooutputcreated.��� Severity:P��FATAL��� Explanation:7��The specifiedinput PostScriptfiledoesG���notseemtoadheretotheAdobeInc.+minimalconfor-I�h��mantcoding standard.'Hencetheutilitycannot correctlyM��� interprettheinputfile(evenifitiscorrect PostScript���code).���UserAction:7��Whateveryouwantedtodomustbedone� �� manually.������_�������������� ��&��������FO����ORDERED,, PostScriptfilealreadyisinspecialorder."�(��Outputmaybeuseless��� Severity:P��WARNING�^�� Explanation:3^��DOCTOR discoveredthe PostScriptcom-���ment �� %%PageOrder:'Special.��insidethe PostScriptfile.'ThisI��� indicatesthatthepagesinthefilehavealreadybeenB�h��orderedinsomespecialway.,AlthoughDOCTORwillC���proceed,thefinaloutputmayhave re-arrangedtheE���pagesinsuchawaythattheorderisnotuseful.���UserAction:>��None.'EitherdonottrytosaddlestitchtheT� ��fileorlookattheprinteroutputiftheresultis acceptable.������`�������������� ����������$O����PAGES,,Documentcontains ���'! ���unsigneddecimalnum- �(��ber _(��'(��pages��� Severity:P�� INFORMATIONAL�^�� Explanation:3^��DOCTORfoundthe indicatednumberof� ��%%Page:4���entriesthatwerevalidpageentries.�R��UserAction::R��None.(Itmayhelpin determiningthesize5���ofthe gatheringyouwanttospecify.���:���������9��������-�����a��������������! ����������&���DigitalInternalUseOnly2O�J��PASS,,StartinginputfilescanPass J��'!J��unsigneddecimal���number ��'�=�� Severity:P=�� INFORMATIONAL��� Explanation:;��Startsreadingtheinput PostScriptfileinL�1��Pass1tocollectallpagerelateddatabeforethepagesI���arerandomlyaccessedinPass2toallow extractionor4��� re-orderingtheminthefinaloutput.�}��UserAction:}��None.������b�������������� ��&��������DO���� SAMEFILESPEC,-Outputfileisnexthigherversionof�(��inputfile..���Purgingwillloseoriginalfile.��� Severity:P��WARNING��� Explanation:=��Youdidnotspecifyanexplicitoutputfile,M���hencetheutilitydefaultstotheinputfilespecification.O�h��However,thismaycausethelostoftheoriginalinputfile9���isan accidentalpurgecommandisissued.�\��UserAction:;\��RenamethelatestversionintoanotherfileM���nameorcopythefiletoanotherlocationtoavoidlosing� ��theoriginalcopy.������c��������������! ����������'O���� UNSUPVER,,Fileproducedby ;���'k���string Q���'���isnotsup-�(��ported.9���SeeMessageAppendixinDOCTORmanualfor���manual correction�u�� Severity:Pu��FATAL��� Explanation:;��The PostScriptfileisproducedbyaprod-M�h��uctthatoutputs PostScriptcodethatcannotbehandledby���DOCTOR/PS/SADDLE.�\��UserAction:;\��Forsomeproductsthisisbecausethereis&���abugintheirPScode.H�O��The followingproductsallowmanual correctionandthenM���youcanresubmitthe correctedfileforcorrect processing:�������d����������������g���������Y���DECwriteV1.1GY(��EditthePSfileandatthefinal occurrenceoftheY �� %%Trailer8��line interchangethe followingtwolines:Y ��$D&restoreYN �� %%Trailer�`������e����������������������6���Y���intoY< �� %%TrailerY ��$D&restore������f�������������� �����������GY���Nowtherestore operationremainswiththetraileratGY���theendofthesaddlestitchedfileratherthanmov-DY5��ingwiththeoriginallastpage,causing "offending"Y��commandisa"errors.�G������g��������������������������O����A.9CXREFMessages�#�����h�������������������������O����CREATED,,Created ���'���string ���'�k�� Severity:Pk�� INFORMATIONAL��� Explanation:5��XREFhas succesfullycreatedtheindi-�^��catedoutputfile.���UserAction:��None�g�����i��������������! ��������=��7O���� NOBOOKTITLE,,No /BOOKTITLE specifiedwith�(�� /SYMBOL_FILE��� Severity:P��WARNING�^�� Explanation:*^��Whenafileiscreatedwith^ ��<DEFINE_� ��SYMBOL>C ��tags,toallowcross referencingbetweenbooks,itO���isalmost imperativethatyoualsospecifythetitleoftheP�h��book,sothatthecross referencecancontainbothtitleand+���sectionofthebook involved.�\��UserAction:7\��Add /BOOKTITLEwithpropertitleofthe���book������j�������������� ����������@O���� NOPREFIX,,Noprefix specified.,Thismayleadto!�(�� conflicting references��� Severity:P��WARNING�^�� Explanation:4^��Theuserdidnotspecifythe/PREFIXM��� qualifier.'HenceallsymbolsfromtheXREFfiletobeex-M���tractedassymbol definitionsmayturnouttobe identical*�h��tosymbolsdefined elsewhere.���UserAction:<��ItisgoodpractisetomakeallsymbolsofJ�\��a particularbookuniqueby prefixingthemwithashortI���identification.*Thiscanbeanacronymofthebook,anI� ��authornumber,etc.*KeepinmindthatthetotallengthF�e��ofprefix+symbolnamemustnotexceedthemaximumI���lengthallowedtosymbols,being31 characters(A-Z,0-I���9and underscore).*Theprefixshouldnotstartwithan/�o�� underscorebutmayendwithone.������k�������������� ���������� O���� NOSORTSPEC,, Qualifier a���'���string w���'���isinvalidwithout#�(��/SORT.Willbeignored��� Severity:P��WARNING�^�� Explanation:=^��Itisonlypossibletoproducesortedalpha-1���beticor numericallyorderedlists.�R��UserAction:9R��Eitheradd/SORTtothecommandline(toJ���activatethe currently specified qualifier,orremovethe��� specified qualifier.�|�����l��������������! ��������R��O���� SYMTRUNC,-Symbol ���'���string ���'+���exceedsmaximum-�(��allowedsymbollength.' Truncated��� Severity:P��WARNING�^�� Explanation:=^��Duetothe prefixingofthe specifiedstringG���with/PREFIXthelengthoftheentiresymbolexceededC���themaximumlengthallowedbyVAX DOCUMENT.ItisF�h�� truncatedtomaximum allowablelengthbyremovingthe���final character(s).�\��UserAction:8\��None.)Alternatively,ashorterprefixcanH���bechoosenorintheoriginaldocumentfromwhichtheF� ��XREFfile originates,oneshouldshortenthesymbolicI�e��namestoavoidtheproblem.)Thisrequires processingof?���thatfilebyVAXDOCUMENTagainafterediting.������m�������������� ��u��������;O���� WHATTODO,,Youmustspecifyatleastoneof)�(�� /SYMBOL_FILE,/LISTor/SORT��� Severity:P��FATAL�^�� Explanation:2^�� DOCTOR/XREFcanonlyperformoneorP���severalofitsthreepossible operationsifoneofthethreeK��� qualifiers indicatedis specified.*Withouteitherofthem,�h��nothingisdone.���UserAction:7��Specifyone,twoorallthree specified�\�� qualifiers.�*������n������������������������������� ������������������������������������ ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ��� ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������ ������������������������������������������������������������������������������!���������"���#������$���$���$���$���$���$���%���$���&���&���&���&���&���&���&���&���&���&���&���&���&���&���&���&���&���&���&���&���&���&���&���&���&���'���&���&���&���(���&���&���&���&���&���)���*���+���,���,���,���,���,���,���,���,���,���,���,���,���,���,���-���-���-���-���-���-���-���-���-���-���-���-���.���.���.���.���.���.���.���.���.���.���.���.���.���.���.���.���.���.���.���.���/���/���/���/���/���/���/���/���/���/���/���/���/���/���/���/���/���/���/���/���/���/���/���/���/���/���/���/���/���0���0���0���0���0���0���0���0���0���0���0���0���0���0���0���0���0���0���0���0���0���0���0���0���0���0���0���0���0���1���1���1���1���1���1���1���1���1���1���2���2���2���2���2���2���2���2���2���2���2���2���2���2���2���2���2���2���2���2���2���2���3���3���4���4���4���4���4���4���4���4���4���4���4���4���4���4���4���5���5���5���5���5���5���5���5���5���5���5���5���5���6���6���6���6���6���6���6���6���6���6���6���6���6���7���7���7���7���7���7���7���7���7���7���7���7���7���8���8���8���8���8���8���8���8���8���8���8���8���8���9���9���9���9���9���9���9���9���9���9���9���9���:���:���:���:���:���:���:���:���:���:���:���:���:���:����W��������������������������������������������������������Preface�����Preface�����Preface�����Preface�����Preface�����Preface�����Preface�����Preface�����Preface�����Preface�����Preface�����Preface�����Preface�����Preface�����Preface�����Preface�����Preface�����Preface�����Preface�����Preface�����Preface�����Preface�����Preface�����Preface�����Preface��-���1. DOCTOR at a glance - Quick Overview�����1.1 Questions�����1.1 Questions�����1.1 Questions�����1.1 Questions�����1.1 Questions�����1.1 Questions�����1.2 Answers��1���1.2.1 Add blank pages to a PostScript file��1���1.2.1 Add blank pages to a PostScript file��1���1.2.1 Add blank pages to a PostScript file��1���1.2.1 Add blank pages to a PostScript file��4���1.2.2 Extract page range from PostScript file��4���1.2.2 Extract page range from PostScript file��4���1.2.2 Extract page range from PostScript file��4���1.2.2 Extract page range from PostScript file��4���1.2.2 Extract page range from PostScript file��4���1.2.2 Extract page range from PostScript file��8���1.2.3 Adding diagonal wording to PostScript pages��8���1.2.3 Adding diagonal wording to PostScript pages��/���1.2.4 Adding footers to PostScript pages��/���1.2.4 Adding footers to PostScript pages��/���1.2.4 Adding footers to PostScript pages��/���1.2.4 Adding footers to PostScript pages��/���1.2.4 Adding footers to PostScript pages��=���1.2.5 Adding headers to pages of a PostScript document��=���1.2.5 Adding headers to pages of a PostScript document��7���1.2.6 Extract figures from a PostScript document��7���1.2.6 Extract figures from a PostScript document��7���1.2.6 Extract figures from a PostScript document��7���1.2.6 Extract figures from a PostScript document��8���1.2.7 Re-arrange pages for saddle-stitch printing��8���1.2.7 Re-arrange pages for saddle-stitch printing��8���1.2.7 Re-arrange pages for saddle-stitch printing��1���1.2.8 List of an SDML document composition��1���1.2.8 List of an SDML document composition��1���1.2.8 List of an SDML document composition��3���1.2.9 Automate document generation using MMS��3���1.2.9 Automate document generation using MMS��3���1.2.9 Automate document generation using MMS��3���1.2.9 Automate document generation using MMS��.���1.2.10 Prepare SDML file for Bookreader��.���1.2.10 Prepare SDML file for Bookreader��.���1.2.10 Prepare SDML file for Bookreader��.���1.2.10 Prepare SDML file for Bookreader��5���1.2.11 Produce a list of all <X> index entries��5���1.2.11 Produce a list of all <X> index entries��5���1.2.11 Produce a list of all <X> index entries��5���1.2.11 Produce a list of all <X> index entries��3���1.2.12 Produce a list of all symbols defined��3���1.2.12 Produce a list of all symbols defined��3���1.2.12 Produce a list of all symbols defined��3���1.2.12 Produce a list of all symbols defined��3���1.2.12 Produce a list of all symbols defined��3���1.2.12 Produce a list of all symbols defined��1���1.2.13 Cross referencing between documents��1���1.2.13 Cross referencing between documents��1���1.2.13 Cross referencing between documents��1���1.2.13 Cross referencing between documents��%���1.2.14 Sort a Glossary section��%���1.2.14 Sort a Glossary section��%���1.2.14 Sort a Glossary section��!���1.2.15 Count all tags used��!���1.2.15 Count all tags used��!���1.2.15 Count all tags used��C���1.2.16 Create SDML <MESSAGE_SECTION> from VMS Message source��C���1.2.16 Create SDML <MESSAGE_SECTION> from VMS Message source��C���1.2.16 Create SDML <MESSAGE_SECTION> from VMS Message source��C���1.2.16 Create SDML <MESSAGE_SECTION> from VMS Message source��"���1.2.17 Define dummy symbols��"���1.2.17 Define dummy symbols��"���1.2.17 Define dummy symbols��"���1.2.17 Define dummy symbols�����2. DOCTOR's components�����2. DOCTOR's components�����2. DOCTOR's components�����2. DOCTOR's components��8���3. DOCTORing SDML files: Sorting glossary entries�����3.1 Overview�����3.1 Overview�����3.1 Overview�����3.1 Overview�����3.2 Sorting process�����3.2 Sorting process��7���Example 3- 1: Glossary entry for DOCTOR/GLOSSARY�����3.3 Sort order�����3.3 Sort order�����3.3 Sort order�����3.3 Sort order�����3.3 Sort order�����3.3 Sort order�����3.4 Options��,���4. DOCTORing VMS Message source files�����4.1 Overview�����4.1 Overview�����4.1 Overview�����4.1 Overview�����4.1 Overview��5���4.2 Commenting requirements for a message file��5���4.2 Commenting requirements for a message file��5���4.2 Commenting requirements for a message file��5���4.2 Commenting requirements for a message file��5���4.2 Commenting requirements for a message file��5���4.2 Commenting requirements for a message file��/���Example 4- 1: Sample Message source file��1���Example 4- 2: Sample DOCTOR/MESSAGE output��5���4.2 Commenting requirements for a message file��5���4.2 Commenting requirements for a message file��5���4.2 Commenting requirements for a message file��5���4.2 Commenting requirements for a message file��*���4.3 Include result in documentation��*���4.3 Include result in documentation��3���4.4 DOCTOR/MESSAGE Features on Message Files��3���4.4 DOCTOR/MESSAGE Features on Message Files��3���4.4 DOCTOR/MESSAGE Features on Message Files��3���4.4 DOCTOR/MESSAGE Features on Message Files��3���4.4 DOCTOR/MESSAGE Features on Message Files��4���5. DOCTORing SDML files for Bookreader output�����5.1 Overview�����5.1 Overview�����5.1 Overview�����5.1 Overview�����5.1 Overview�����5.1 Overview�����5.1 Overview�����5.1 Overview�����5.1 Overview��'���5.2 Example of ONLINE conversion��"���Example 5- 1: Original file��"���Example 5- 2: Modified file��'���5.3 Including predefined symbols��'���5.3 Including predefined symbols��'���5.3 Including predefined symbols��(���5.4 Generating additional symbols��(���5.4 Generating additional symbols��(���5.4 Generating additional symbols��(���5.4 Generating additional symbols��(���5.4 Generating additional symbols��(���5.4 Generating additional symbols��(���5.4 Generating additional symbols�����5.5 Things to remember�����5.5.1 Using /OUTPUT�����5.5.1 Using /OUTPUT�����5.5.1 Using /OUTPUT�����5.5.2 Using /VERSION_1�����5.6 Adding symbols�����5.7 Adding references�����5.7 Adding references�����5.8 Adding figure files�����5.9 What must you do?��.���5.10 Removing or renewing added symbols��.���5.10 Removing or renewing added symbols��.���5.10 Removing or renewing added symbols��$���6. DOCTORing PostScript files�����6.1 Overview�����6.1 Overview�����6.1 Overview�����6.1 Overview�����6.1 Overview�����6.2 Adding blank pages�����6.2 Adding blank pages�����6.2 Adding blank pages�����6.2 Adding blank pages�����6.2 Adding blank pages�����6.2 Adding blank pages�����6.2 Adding blank pages�����6.2 Adding blank pages�����6.2 Adding blank pages�����6.2 Adding blank pages�����6.2 Adding blank pages�����6.2 Adding blank pages�����6.2 Adding blank pages�����6.3 Replacing the prolog�����6.3 Replacing the prolog�����6.3 Replacing the prolog�����6.3 Replacing the prolog�����6.3 Replacing the prolog�����6.3 Replacing the prolog�����6.3 Replacing the prolog�����6.3 Replacing the prolog�����6.3 Replacing the prolog�����6.3 Replacing the prolog��&���Table 6- 1: FONT keyword values�����6.3 Replacing the prolog�����6.3 Replacing the prolog�����6.3 Replacing the prolog�����6.3 Replacing the prolog�����6.4 Extracting ranges�����6.4 Extracting ranges�����6.4 Extracting ranges�����6.4 Extracting ranges�����6.4 Extracting ranges�����6.4 Extracting ranges��'���6.5 Removing or re-using figures��'���6.5 Removing or re-using figures��'���6.5 Removing or re-using figures��'���6.5 Removing or re-using figures��'���6.5 Removing or re-using figures��1���Table 6- 2: Extracting or removing figures�����6.5.1 Removing figures�����6.5.1 Removing figures�����6.5.1 Removing figures�����6.5.2 Extracting figures�����6.5.2 Extracting figures�����6.5.2 Extracting figures�����6.5.2 Extracting figures�����6.5.2 Extracting figures�����6.5.2 Extracting figures�����6.5.2 Extracting figures�����6.5.2 Extracting figures�� ���6.6 Saddle stich printing�� ���6.6 Saddle stich printing�� ���6.6 Saddle stich printing�� ���6.6 Saddle stich printing��+���Figure 6- 1: Saddle stiched printing�� ���6.6 Saddle stich printing�� ���6.6 Saddle stich printing�� ���6.6 Saddle stich printing�� ���6.6 Saddle stich printing�� ���6.6 Saddle stich printing�� ���6.6 Saddle stich printing�� ���6.6 Saddle stich printing��-���6.6.1 Using an LPS40 to print the file��-���6.6.1 Using an LPS40 to print the file��-���6.6.1 Using an LPS40 to print the file��-���6.6.1 Using an LPS40 to print the file��-���6.6.1 Using an LPS40 to print the file��-���6.6.2 Using an LPS20 to print the file��-���6.6.2 Using an LPS20 to print the file��-���6.6.2 Using an LPS20 to print the file��-���6.6.2 Using an LPS20 to print the file��#���6.7 Minimal conformant files��#���6.7 Minimal conformant files�� ���Note 1��#���6.7 Minimal conformant files��#���6.7 Minimal conformant files��#���6.7 Minimal conformant files��#���6.7 Minimal conformant files��#���6.7 Minimal conformant files��#���6.7 Minimal conformant files��#���6.7 Minimal conformant files��#���6.7 Minimal conformant files��3���Example 6- 1: Conformant PostScript skeleton��#���6.7 Minimal conformant files��#���6.7 Minimal conformant files��@���7. DOCTORing SDML files: hierarchy of files within a book�����7.1 Overview�����7.1 Overview�����7.1 Overview�����7.1 Overview�����7.1 Overview��%���7.2 Listing all included files��%���7.2 Listing all included files��=���Table 7- 1: Tags that cause other files to be included��%���7.2 Listing all included files��%���7.2 Listing all included files��%���7.2 Listing all included files��%���7.2 Listing all included files��;���Example 7- 1: Hierarchy list produced by DOCTOR/SDML��%���7.2 Listing all included files��%���7.2 Listing all included files��%���7.2 Listing all included files��%���7.2 Listing all included files��&���7.3 Producing MMS rebuild files��&���7.3 Producing MMS rebuild files��&���7.3 Producing MMS rebuild files��&���7.3 Producing MMS rebuild files��&���7.3 Producing MMS rebuild files��&���7.3 Producing MMS rebuild files��&���7.3 Producing MMS rebuild files��&���7.3 Producing MMS rebuild files��&���7.3 Producing MMS rebuild files��&���7.3 Producing MMS rebuild files��&���7.3 Producing MMS rebuild files��5���Table 7- 2: DOCTOR/SDML qualifiers for DEC/MMS��&���7.3 Producing MMS rebuild files��&���7.3 Producing MMS rebuild files��&���7.3 Producing MMS rebuild files��5���Example 7- 2: Example DEC/MMS description file��&���7.3 Producing MMS rebuild files��&���7.3 Producing MMS rebuild files��&���7.3 Producing MMS rebuild files��)���7.4 Using the MMS description file�� ���7.4.1 What file to build?�� ���7.4.1 What file to build?�� ���7.4.1 What file to build?�� ���7.4.1 What file to build?�� ���7.4.1 What file to build?��+���7.4.2 Another doctype than specified��+���7.4.2 Another doctype than specified��+���7.4.2 Another doctype than specified��/���7.4.3 Another destination than specified��/���7.4.3 Another destination than specified��/���7.4.3 Another destination than specified��+���7.4.4 Using DOCUMENT/GRAPHICS (Rags)��+���7.4.4 Using DOCUMENT/GRAPHICS (Rags)��+���7.4.4 Using DOCUMENT/GRAPHICS (Rags)��+���7.4.4 Using DOCUMENT/GRAPHICS (Rags)��+���7.4.4 Using DOCUMENT/GRAPHICS (Rags)��%���7.5 Retrieve all index entries��%���7.5 Retrieve all index entries��%���7.5 Retrieve all index entries��%���7.5 Retrieve all index entries��%���7.5 Retrieve all index entries��0���Example 7- 3: Output of DOCTOR/SDML/INDEX��%���7.5 Retrieve all index entries��%���7.5 Retrieve all index entries�� ���Note 2�� ���Note 1��%���7.5 Retrieve all index entries��2���8. DOCTORing SDML files: Counting tags used�����8.1 Overview�����8.1 Overview�����8.2 Options�����8.3 Output format�����8.3 Output format��8���Example 8- 1: Sample DOCTOR/TAG_COUNT output file�����8.4 Usage�����9. DOCTORing XREF files�����9.1 Overview�����9.1 Overview�����9.1 Overview�����9.1 Overview�� ���9.2 Build symbol listings�� ���9.2 Build symbol listings�� ���9.2 Build symbol listings�� ���9.2 Build symbol listings�� ���9.2 Build symbol listings�� ���9.2 Build symbol listings��,���9.3 Build cross reference symbol file��,���9.3 Build cross reference symbol file��,���9.3 Build cross reference symbol file��,���9.3 Build cross reference symbol file��,���9.3 Build cross reference symbol file��,���9.3 Build cross reference symbol file��,���9.3 Build cross reference symbol file��,���9.3 Build cross reference symbol file��,���9.3 Build cross reference symbol file�����9.4 Example output�����9.4 Example output�����9.4 Example output�����9.4.1 Symbol file output�����9.4.1 Symbol file output��-���Example 9- 1: Sample .SDML_XREF output�����9.4.2 List file output�����9.4.2 List file output�����9.4.2 List file output��-���Table 9- 1: Alphabetic list of symbols��$���9.4.3 Sorted list file output��$���9.4.3 Sorted list file output��$���9.4.3 Sorted list file output��$���9.4.3 Sorted list file output��$���9.4.3 Sorted list file output��:���Table 9- 2: Chapter symbols - in alphabetical order��7���Table 9- 3: Chapter symbols - in numerical order�����Command Section�����DOCTOR/GLOSSARY�����DOCTOR/GLOSSARY�����DOCTOR/GLOSSARY�����DOCTOR/GLOSSARY�����DOCTOR/GLOSSARY�����DOCTOR/GLOSSARY�����DOCTOR/GLOSSARY�����DOCTOR/GLOSSARY�����DOCTOR/GLOSSARY�����DOCTOR/GLOSSARY�����DOCTOR/GLOSSARY�����DOCTOR/GLOSSARY�����DOCTOR/GLOSSARY�����DOCTOR/GLOSSARY�����DOCTOR/MESSAGE�����DOCTOR/MESSAGE�����DOCTOR/MESSAGE�����DOCTOR/MESSAGE�����DOCTOR/MESSAGE�����DOCTOR/MESSAGE�����DOCTOR/MESSAGE�����DOCTOR/MESSAGE�����DOCTOR/MESSAGE�����DOCTOR/MESSAGE�����DOCTOR/MESSAGE�����DOCTOR/MESSAGE�����DOCTOR/ONLINE�����DOCTOR/ONLINE�����DOCTOR/ONLINE�����DOCTOR/ONLINE�����DOCTOR/ONLINE�����DOCTOR/ONLINE�����DOCTOR/ONLINE�����DOCTOR/ONLINE�����DOCTOR/ONLINE�����DOCTOR/ONLINE�����DOCTOR/ONLINE�����DOCTOR/ONLINE�����DOCTOR/ONLINE�����DOCTOR/ONLINE�����DOCTOR/ONLINE�����DOCTOR/ONLINE�����DOCTOR/ONLINE�����DOCTOR/ONLINE�����DOCTOR/ONLINE�����DOCTOR/ONLINE�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/PS�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/SDML�����DOCTOR/TAG_COUNT�����DOCTOR/TAG_COUNT�����DOCTOR/TAG_COUNT�����DOCTOR/TAG_COUNT�����DOCTOR/TAG_COUNT�����DOCTOR/TAG_COUNT�����DOCTOR/TAG_COUNT�����DOCTOR/TAG_COUNT�����DOCTOR/TAG_COUNT�����DOCTOR/TAG_COUNT�����DOCTOR/XREF�����DOCTOR/XREF�����DOCTOR/XREF�����DOCTOR/XREF�����DOCTOR/XREF�����DOCTOR/XREF�����DOCTOR/XREF�����DOCTOR/XREF�����DOCTOR/XREF�����DOCTOR/XREF�����DOCTOR/XREF�����DOCTOR/XREF�����DOCTOR/XREF�����DOCTOR/XREF�����DOCTOR/XREF�����DOCTOR/XREF�����DOCTOR/XREF�����DOCTOR/XREF�����DOCTOR/XREF�����DOCTOR/XREF�����DOCTOR/XREF�����DOCTOR/XREF�����A. Error messages�����A.1 DOCMSG Messages��"���CREATED, Created ' string '��J���PASS1, Start Pass 1: Read all messages and sort them alphabetically��1���PASS2, Start Pass 2: Generate message file�����A.2 DOCTOR Messages��3���IDENT, This is ' string ' version ' string '��>���NOTIMPL, Functionality ' string ' not yet imple- mented��E���SENDQAR, Internal error. Please send QAR. Error ID: ' string '�����A.3 DTAGCOUNT Messages��"���CREATED, Created ' string '��V���FNF, File ' string ' is referenced in document but does not exist - will ignore�� ���SCAN, Scanning ' string '�����A.4 GLOSSARY Messages��"���CREATED, Created ' string '��D���DUPLICATE, Duplicate entry for <GTERM> ' ' string ' ' in file��P���GTERMOUTBOUND, Found <GTERM> tag outside <GLOSSARY> - <ENDGLOSSARY> range��T���NEXTGLOSSARY, Multiple <GLOSSARY> tags en- countered. Can only sort one block��i���NOALPHA, Found term " ' string ' " without alphabetic characters. Do not use /SORT=NONALPHA=IGNORE��8���NOENDGLOSSARY, No closing <ENDGLOSSARY> tag found��L���NOGLOSSARY, Opening tag <GLOSSARY> not found before first <GTERM> tag��9���NOGTERMS, Input file does not contain <GTERM> tags��g���SAMEFILESPEC, Output file is next higher version of input file. Purging will lose original file.�����A.5 MARFIN Messages��!���ATLAST, Created ' string '��"���CREATED, Created ' string '��5���FNF, File ' string ' referenced, but not found��Z���HUMANS, Humans - always giving the wrong com- mands. Marfin do this, Marfin do that�����IGNORED, ' string '��3���MMSTOO, Made MMS description file ' string '�����MUMBLE, ' string '��F���NOCMSSUP, DEC/CMS not available. Reissue com- mand without /CMS��b���NOTFOUND, There were ' unsigned decimal num- ber ' files referenced that could not be found�����OHMYDIODES, ' string '��0���OHNO, I won't enjoy processing ' string '�����A.6 ONLINE Messages��0���CREATED, Created modified file ' string '��,���CRELIST, Created list file ' string '��C���FNF, File to include ' string ' not found - will be ignored.��0���INPUTFNF, Input file ' string ' not found��%���INSPECT, Inspecting ' string '��O���MODIFY, Modifying ' string ' to be compliant for BOOKREADER destinations��8���PASS1, Collecting label and reference information��@���PASS2, Generating labels, references and figure_file tags��0���REMOVE, Removed label from ' string ' tag�����A.7 PSSCAN Messages��v���ABSENTPAGESCHEME, Page number indicated as ' string ' Blank page insertion mechanism may not work properly here��5���CONFORM, File assumed to conform to ' string '��"���CREATED, Created ' string '��4���CREATOR, Input file was created by ' string '��)���INSERTED, Page ' string ' inserted��\���INVALCOUNT, Invalid page counter ' signed decimal number ' . Must be positive integer��b���INVORDINAL, Input file violates Adobe standard: ordinal starts at ' signed decimal number '�����INVPAGCOM, Page comment " ' string ' " at line ' un- signed decimal number ' not conforming to Adobe PostScript standards. Ignored as page marker.��J���NEGPAGNO, Invalid page number to convert: ' signed decimal number '��I���NOCHANGE, Input file needed no modification. No new file generated��a���NOPAGE, File contains no valid %%Page: markers and is not Adobe Coding Standard conformant��V���NOPROLOG, File does not contain valid %%EndProlog comment. Not Adobe conformant��g���NOTCONFORM, File is not (minimally) conforming to Adobe PostScript standards. No output created.��i���NOTVAXDOC, /CHANGE used on PS file not produced by DOCUMENT or DECwrite. Success is not guaranteed��F���PASS, Starting input file scan Pass ' unsigned decimal number '��=���RANGESKIP, Page range starting at ' string ' not found��g���SAMEFILESPEC, Output file is next higher version of input file. Purging will lose original file.��o���SHORTRANGE, Two end range values specified. Using shortest of ' unsigned decimal number ' and ' string '��E���SKIPFIGURE, Removing figure from output docu- ment: ' string '��>���STARTRANGE, Including page range starting at ' string '��N���TRUNCATED, Resulting figure file name too long. Truncated to ' string '��.���UNKWNPAG, Unknown page type: ' string '�����A.8 SADDLE Messages��G���2UP, Preparing file for 2UP printing in the next file version...��J���2UPNOTSUP, The /2UP feature is only supported for VAX DOCUMENT V2.1��5���CONFORM, File assumed to conform to ' string '��"���CREATED, Created ' string '��4���CREATOR, Input file was created by ' string '��g���DEFGATHER, No /GATHER qualifier specified. Using /GATHER= ' unsigned decimal number ' as default��b���INVORDINAL, Input file violates Adobe standard: ordinal starts at ' signed decimal number '��O���NOFOUR, The /GATHER= ' unsigned decimal num- ber ' is not divisible by 4��]���NOPAGE, No valid %%Page: comment lines. File is not Adobe Structured Coding conformant��g���NOTCONFORM, File is not (minimally) conforming to Adobe PostScript standards. No output created.��R���ORDERED, PostScript file already is in special order. Output may be useless��C���PAGES, Document contains ' unsigned decimal num- ber ' pages��F���PASS, Starting input file scan Pass ' unsigned decimal number '��g���SAMEFILESPEC, Output file is next higher version of input file. Purging will lose original file.��|���UNSUPVER, File produced by ' string ' is not sup- ported. See Message Appendix in DOCTOR manual for manual correction��|���UNSUPVER, File produced by ' string ' is not sup- ported. See Message Appendix in DOCTOR manual for manual correction��|���UNSUPVER, File produced by ' string ' is not sup- ported. See Message Appendix in DOCTOR manual for manual correction��|���UNSUPVER, File produced by ' string ' is not sup- ported. See Message Appendix in DOCTOR manual for manual correction�����A.9 XREF Messages��"���CREATED, Created ' string '��=���NOBOOKTITLE, No /BOOKTITLE specified with /SYMBOL_FILE��M���NOPREFIX, No prefix specified. This may lead to conflicting references��Q���NOSORTSPEC, Qualifier ' string ' is invalid without /SORT. Will be ignored��S���SYMTRUNC, Symbol ' string ' exceeds maximum allowed symbol length. Truncated��N���WHATTODO, You must specify at least one of /SYMBOL_FILE, /LIST or /SORT��N���WHATTODO, You must specify at least one of /SYMBOL_FILE, /LIST or /SORT� �M��1�������������������������������2�������������������������������3�������������������������������4�������������������������������5�������������������������������6�������������������������������7�������������������������������8�������������������������������9�������������������������������10������������������������������PREFACE_SECTION�����������������BK_ADDED_1����������������������13������������������������������14������������������������������15������������������������������16������������������������������17������������������������������18������������������������������19������������������������������20������������������������������DOCTORAVAILABLE�����������������22������������������������������ACKNOWSECTION�������������������24������������������������������25������������������������������26������������������������������27������������������������������28������������������������������TECHCHANSECTION�����������������30������������������������������31������������������������������32������������������������������33������������������������������34������������������������������35������������������������������QUICKOVERVIEWCHAPTER������������QUESTIONSECTION�����������������FILETYPEQUESTION����������������ACTIONQUESTION������������������POSTSCRIPTQUESTION��������������SDMLQUESTION��������������������XREFQUESTIONS�������������������ANSWERSECTION�������������������BLANKPAGEANSWER�����������������45������������������������������46������������������������������47������������������������������EXTRACTANSWER�������������������49������������������������������50������������������������������51������������������������������52������������������������������53������������������������������CHANGEANSWER��������������������55������������������������������FOOTERANSWER��������������������57������������������������������58������������������������������59������������������������������60������������������������������TOPANSWER�����������������������62������������������������������FIGUREANSWER��������������������64������������������������������65������������������������������66������������������������������SADDLEANSWER��������������������68������������������������������69������������������������������LISTANSWER����������������������71������������������������������72������������������������������MMSANSWER�����������������������74������������������������������75������������������������������76������������������������������BOOKREADERANSWER����������������78������������������������������79������������������������������80������������������������������INDEXANSWER���������������������82������������������������������83������������������������������84������������������������������XREFANSWER����������������������86������������������������������87������������������������������88������������������������������89������������������������������90������������������������������XREFSYMBOLANSWER����������������92������������������������������93������������������������������94������������������������������GLOSSARYANSWER������������������96������������������������������97������������������������������TAGCOUNTANSWER������������������99������������������������������100�����������������������������MESSAGEANSWER�������������������102�����������������������������103�����������������������������104�����������������������������DUMMYANSWER���������������������106�����������������������������107�����������������������������108�����������������������������CHAP1���������������������������110�����������������������������111�����������������������������112�����������������������������CHAP5B��������������������������SORTGLOSOVERVIEWSECTION���������115�����������������������������GLOSLIMITSECTION����������������117�����������������������������GLOSSORTSECTION�����������������119�����������������������������GLOSSARYSORTEXAMPLE�������������SORTORDERSECTION����������������122�����������������������������123�����������������������������124�����������������������������125�����������������������������126�����������������������������GLOSSORTOPTIONSECTION�����������CHAP6���������������������������MESSOVERVIEWSECTION�������������130�����������������������������131�����������������������������132�����������������������������133�����������������������������MESFILEPARTSECTION��������������135�����������������������������136�����������������������������137�����������������������������138�����������������������������139�����������������������������DOCTORMSG1EXAMPLE���������������DOCTORMSG2EXAMPLE���������������142�����������������������������143�����������������������������144�����������������������������145�����������������������������INCLMESOUTFILESECTION�����������147�����������������������������DOCMESFORMATSECTION�������������149�����������������������������150�����������������������������151�����������������������������152�����������������������������CHAP5���������������������������INTRO5��������������������������155�����������������������������156�����������������������������157�����������������������������158�����������������������������159�����������������������������160�����������������������������161�����������������������������162�����������������������������ONLINEEXAMPLESECTION������������INPUTFILEEXAMPLE����������������OUTPUTFILEEXAMPLE���������������PREDEFSYMBOLSECTION�������������167�����������������������������168�����������������������������DUMMYSYMBOLSECTION��������������170�����������������������������171�����������������������������172�����������������������������173�����������������������������174�����������������������������175�����������������������������REMEMBERSECTION�����������������OUTPUTSECTION�������������������178�����������������������������179�����������������������������VERSION_1SECTION����������������ADDSYMBOLSECTION����������������ADDREFERENCESECTION�������������183�����������������������������ADDFIGURESECTION����������������DOITSECTION���������������������REMOVESYMBOLSECTION�������������187�����������������������������188�����������������������������CHAP2���������������������������OVERVIEWSECTION�����������������191�����������������������������192�����������������������������193�����������������������������194�����������������������������BLANKSECTION��������������������196�����������������������������197�����������������������������198�����������������������������199�����������������������������200�����������������������������201�����������������������������202�����������������������������BK_ADDED_2����������������������204�����������������������������205�����������������������������206�����������������������������207�����������������������������PROLOGSECTION�������������������209�����������������������������210�����������������������������211�����������������������������212�����������������������������213�����������������������������214�����������������������������215�����������������������������216�����������������������������217�����������������������������FONTTABLE�����������������������219�����������������������������220�����������������������������221�����������������������������222�����������������������������RANGESECTION��������������������224�����������������������������225�����������������������������226�����������������������������227�����������������������������228�����������������������������REMOVEFIGSECTION����������������230�����������������������������231�����������������������������232�����������������������������233�����������������������������EXTRACTFIGURETABLE��������������REMOVEFIGURESUBSECTION����������236�����������������������������237�����������������������������EXTRACTFIGURESECTION������������239�����������������������������240�����������������������������241�����������������������������242�����������������������������243�����������������������������244�����������������������������245�����������������������������SADDLESECTION�������������������247�����������������������������248�����������������������������249�����������������������������SADDLEFIGURE��������������������251�����������������������������252�����������������������������253�����������������������������254�����������������������������255�����������������������������256�����������������������������257�����������������������������BK_ADDED_3����������������������259�����������������������������260�����������������������������261�����������������������������262�����������������������������BK_ADDED_4����������������������264�����������������������������265�����������������������������266�����������������������������CONFORMANTSECTION���������������268�����������������������������_DECW_FN_1_1��������������������270�����������������������������271�����������������������������272�����������������������������273�����������������������������274�����������������������������275�����������������������������276�����������������������������277�����������������������������PSEXAMPLE�����������������������279�����������������������������280�����������������������������CHAP4���������������������������SDMLOVERVIEWSECTION�������������283�����������������������������284�����������������������������285�����������������������������286�����������������������������LISTINGSECTION������������������288�����������������������������TAGTABLE������������������������290�����������������������������291�����������������������������292�����������������������������293�����������������������������MARFINSDMLEXAMPLE���������������295�����������������������������296�����������������������������297�����������������������������298�����������������������������MMSSECTION����������������������300�����������������������������301�����������������������������302�����������������������������303�����������������������������304�����������������������������305�����������������������������306�����������������������������307�����������������������������308�����������������������������309�����������������������������MMSTABLE������������������������311�����������������������������312�����������������������������313�����������������������������MMSEXAMPLE����������������������315�����������������������������316�����������������������������317�����������������������������MMSDESCRIPUSESECTION������������WHATFILESECTION�����������������320�����������������������������321�����������������������������322�����������������������������323�����������������������������DOCTYPESPECIFIEDSECTION���������325�����������������������������326�����������������������������DOCDESTSPECIFIEDSECTION���������328�����������������������������329�����������������������������RAGSSECTION���������������������331�����������������������������332�����������������������������333�����������������������������334�����������������������������INDEXSECTION��������������������336�����������������������������337�����������������������������338�����������������������������339�����������������������������INDEXEXAMPLE��������������������341�����������������������������342�����������������������������_DECW_FN_2_3��������������������_DECW_FN_1_2��������������������345�����������������������������CHAP5A��������������������������TAGCNTOVERVIEWSECTION�����������348�����������������������������TAGCNTOPTIONSECTION�������������TAGCNTOUTPUTSECTION�������������351�����������������������������TAGCOUNTEXAMPLE�����������������TAGCNTUSESECTION����������������CHAP3���������������������������OVERVIEWXREFSECTION�������������356�����������������������������357�����������������������������358�����������������������������SYMBOLLISTSECTION���������������360�����������������������������361�����������������������������362�����������������������������363�����������������������������364�����������������������������XREFSYMBOLFILESECTION�����������366�����������������������������367�����������������������������368�����������������������������369�����������������������������370�����������������������������371�����������������������������372�����������������������������373�����������������������������EXAMPLEXREFSECTION��������������375�����������������������������376�����������������������������SYMFILEXREFSECTION��������������378�����������������������������SDMLXREFEXAMPLE�����������������LISTFILEXREFSECTION�������������SYMDEFXREFSUBHEAD���������������382�����������������������������SDMLSYMBOLLISTTABLE�������������SORTFILEXREFSECTION�������������385�����������������������������386�����������������������������SYMDEFSUBHEAD�������������������388�����������������������������XREFCHAPTERATABLE���������������XREFCHAPTERNTABLE���������������COMMANDPART���������������������GLOSSARYCOMMAND�����������������393�����������������������������394�����������������������������395�����������������������������396�����������������������������397�����������������������������398�����������������������������399�����������������������������400�����������������������������401�����������������������������402�����������������������������403�����������������������������404�����������������������������405�����������������������������BK_ADDED_5����������������������407�����������������������������408�����������������������������409�����������������������������410�����������������������������411�����������������������������412�����������������������������413�����������������������������414�����������������������������415�����������������������������416�����������������������������417�����������������������������BK_ADDED_6����������������������419�����������������������������420�����������������������������421�����������������������������422�����������������������������423�����������������������������424�����������������������������425�����������������������������426�����������������������������427�����������������������������428�����������������������������429�����������������������������430�����������������������������431�����������������������������432�����������������������������433�����������������������������434�����������������������������435�����������������������������436�����������������������������437�����������������������������BK_ADDED_7����������������������439�����������������������������440�����������������������������441�����������������������������442�����������������������������443�����������������������������444�����������������������������445�����������������������������446�����������������������������447�����������������������������448�����������������������������449�����������������������������450�����������������������������451�����������������������������452�����������������������������453�����������������������������454�����������������������������455�����������������������������456�����������������������������457�����������������������������458�����������������������������459�����������������������������460�����������������������������461�����������������������������462�����������������������������463�����������������������������464�����������������������������465�����������������������������466�����������������������������BK_ADDED_8����������������������468�����������������������������469�����������������������������470�����������������������������471�����������������������������472�����������������������������473�����������������������������474�����������������������������475�����������������������������476�����������������������������477�����������������������������478�����������������������������479�����������������������������480�����������������������������481�����������������������������482�����������������������������483�����������������������������484�����������������������������485�����������������������������486�����������������������������487�����������������������������488�����������������������������489�����������������������������490�����������������������������491�����������������������������492�����������������������������493�����������������������������494�����������������������������495�����������������������������TAGCOUNTCOMMAND�����������������497�����������������������������498�����������������������������499�����������������������������500�����������������������������501�����������������������������502�����������������������������503�����������������������������504�����������������������������505�����������������������������XREFCOMMANDSECTION��������������507�����������������������������508�����������������������������509�����������������������������510�����������������������������511�����������������������������512�����������������������������513�����������������������������514�����������������������������515�����������������������������516�����������������������������517�����������������������������518�����������������������������519�����������������������������520�����������������������������521�����������������������������522�����������������������������523�����������������������������524�����������������������������525�����������������������������526�����������������������������527�����������������������������APPERROR������������������������MSG_DOCMSG����������������������MSG_DOCMSG����������������������MSG_DOCMSG����������������������MSG_DOCMSG����������������������MSG_DOCTOR����������������������MSG_DOCTOR����������������������MSG_DOCTOR����������������������MSG_DOCTOR����������������������MSG_DTAGCOUNT�������������������MSG_DTAGCOUNT�������������������MSG_DTAGCOUNT�������������������MSG_DTAGCOUNT�������������������MSG_GLOSSARY��������������������MSG_GLOSSARY��������������������MSG_GLOSSARY��������������������MSG_GLOSSARY��������������������MSG_GLOSSARY��������������������MSG_GLOSSARY��������������������MSG_GLOSSARY��������������������MSG_GLOSSARY��������������������MSG_GLOSSARY��������������������MSG_GLOSSARY��������������������MSG_MARFIN����������������������MSG_MARFIN����������������������MSG_MARFIN����������������������MSG_MARFIN����������������������MSG_MARFIN����������������������MSG_MARFIN����������������������MSG_MARFIN����������������������MSG_MARFIN����������������������MSG_MARFIN����������������������MSG_MARFIN����������������������MSG_MARFIN����������������������MSG_MARFIN����������������������MSG_ONLINE����������������������MSG_ONLINE����������������������MSG_ONLINE����������������������MSG_ONLINE����������������������MSG_ONLINE����������������������MSG_ONLINE����������������������MSG_ONLINE����������������������MSG_ONLINE����������������������MSG_ONLINE����������������������MSG_ONLINE����������������������MSG_PSSCAN����������������������MSG_PSSCAN����������������������MSG_PSSCAN����������������������MSG_PSSCAN����������������������MSG_PSSCAN����������������������MSG_PSSCAN����������������������MSG_PSSCAN����������������������MSG_PSSCAN����������������������MSG_PSSCAN����������������������582�����������������������������583�����������������������������584�����������������������������585�����������������������������586�����������������������������587�����������������������������588�����������������������������589�����������������������������590�����������������������������591�����������������������������592�����������������������������593�����������������������������594�����������������������������595�����������������������������MSG_SADDLE����������������������MSG_SADDLE����������������������MSG_SADDLE����������������������MSG_SADDLE����������������������MSG_SADDLE����������������������MSG_SADDLE����������������������MSG_SADDLE����������������������MSG_SADDLE����������������������MSG_SADDLE����������������������MSG_SADDLE����������������������MSG_SADDLE����������������������MSG_SADDLE����������������������MSG_SADDLE����������������������MSG_SADDLE����������������������MSG_SADDLE����������������������MSG_SADDLE����������������������612�����������������������������613�����������������������������614�����������������������������MSG_XREF������������������������MSG_XREF������������������������MSG_XREF������������������������MSG_XREF������������������������MSG_XREF������������������������MSG_XREF������������������������MSG_XREF������������������������622����������������������������� ����B�����-ADOBE-Helvetica-Medium-R-Normal--*-120-*-*-P-*-ISO8859-1��M����-ADOBE-New Century Schoolbook-Bold-R-Normal--*-140-*-*-P-*-ISO8859-1��@����-ADOBE-Helvetica-Bold-R-Normal--*-180-*-*-P-*-ISO8859-1��@����-ADOBE-Helvetica-Bold-R-Normal--*-120-*-*-P-*-ISO8859-1��B����-ADOBE-Helvetica-Medium-O-Normal--*-120-*-*-P-*-ISO8859-1��@����-ADOBE-Helvetica-Bold-R-Normal--*-100-*-*-P-*-ISO8859-1��B����-ADOBE-Helvetica-Medium-R-Normal--*-100-*-*-P-*-ISO8859-1��@����-ADOBE-Helvetica-Bold-R-Normal--*-140-*-*-P-*-ISO8859-1��O����-ADOBE-New Century Schoolbook-Medium-R-Normal--*-140-*-*-P-*-ISO8859-1��@��� �-ADOBE-Courier-Medium-R-Normal--*-120-*-*-M-*-ISO8859-1��@��� �-ADOBE-Courier-Medium-O-Normal--*-120-*-*-M-*-ISO8859-1��O��� �-ADOBE-New Century Schoolbook-Medium-I-Normal--*-140-*-*-P-*-ISO8859-1��/��� �-ADOBE-Symbol-*-R-*--*-140-*-*-P-*-*-*��O��� �-ADOBE-New Century Schoolbook-Medium-R-Normal--*-100-*-*-P-*-ISO8859-1��O����-ADOBE-New Century Schoolbook-Medium-R-Normal--*-120-*-*-P-*-ISO8859-1��>����-ADOBE-Courier-Bold-R-Normal--*-120-*-*-M-*-ISO8859-1��M����-ADOBE-New Century Schoolbook-Bold-R-Normal--*-120-*-*-P-*-ISO8859-1��O����-ADOBE-New Century Schoolbook-Medium-I-Normal--*-120-*-*-P-*-ISO8859-1��M����-ADOBE-New Century Schoolbook-Bold-R-Normal--*-100-*-*-P-*-ISO8859-1��B����-ADOBE-Helvetica-Medium-R-Normal--*-140-*-*-P-*-ISO8859-1��@����-ADOBE-Courier-Medium-R-Normal--*-140-*-*-M-*-ISO8859-1��Ko�� ��������� ��� ���������$��������������� ����������&���DigitalInternalUseOnly7O�\��1.2DOCTOR!at!a!glance!-"Quick!OverviewOO���ThischapterwillgiveashortoverviewtotheDOCTORutil-NO�:��ityandallowsyoutofindthe informationrequiredquicklyOO���throughasetof questionstobe answered.)ThischaptermayPO���betheonlyoneyouneedtoreadasanewuserofDOCTOR.�B������%���������������������������O����1.1B Questions�X�����&���������������! ��,������.��:O����1.!WhatfileneedstobeusedbyDOCTOR? `�[ �� �[��A $[ ��.PS![�� PostScriptfile.(Goto*[��3.)What modificationmustbe*���madetothe PostScriptfile? `�3 �� �3��A%3 ��.SDML,3��VAXDOCUMENTsourcefile.+GotoC3��4.,What0���mustbedonewiththeSDMLfile? `�  �� � ��A!  ��.XREFE ��cross referencefileproducedbya bookbuildrunof�c��VAX DOCUMENT.Goto+c��5.(Whatdoyouwanttoknow!���fromtheXREFfile?. `�; �� �;��A#; ��.MSG*;��VAXMessagesourcefile.'See;��Section1.2.16. `� ��A���Don'tknowbutIknowwhatIwanttodo.(Goto��2.(What$���isityouwanttodo? ��.�n�����������&�������������������(���D��������[���� ���� ����[����[��������������[���n�����������&�������������������)���D������C��3��C����t����t��3����3��������������3���n�����������&�������������������*���D��������s����(����(����s����s��������������s���*�����������&���������?���e��������n�����������&�������������������'���D����������������������������#�����#��������n �����'���������������A ��T������D ��.O����2.!Whatisityouwanttodo? `�[ ��>�[��Convert a VAX Message source file into a VAXB���DOCUMENTsourcefile describingthemessagesina�  ��<MESSAGE_SECTION> Y ��. `� ��K���Getanoverviewofallsymbolsusedinadocumentwrit-'���tenforVAX DOCUMENT.SeeZ��Section1.2.12. `�c ��O�c��Getanoverviewofallsourcefiles,figurefilesandotherE���filesusedand referencedbyaVAXDOCUMENTwritten��� document.'See��Section1.2.8. `� ��B���MMSmustautomatethebuildingofaVAXDOCUMENT!���written document.'See��Section1.2.9. `�k ��I�k��BeabletorefertosectionsinonebookfromanotherC���book,whenbothbooksarewritteninVAXDOCUMENT���sourcecode.'See4��Section1.2.13. `� ��?���SortaVAXDOCUMENTglossaryalphabeticallyal-<���thoughtheitemsare currently unsorted.'See2��Section1.2.14 `�t ��E�t��ListalltagsusedinaVAXDOCUMENTwrittendocu-.���mentandtheirusagecount.'See|��Section1.2.15. `�K ��B�K��AddsymbolstoallVAXDOCUMENTtagsinadocu-J���menttoallowthedocumenttoprocess correctlyforthe'��� BOOKREADER destination.'Seei��Section1.2.10. `�| ��A�| ��ProduceaVAXDOCUMENTsourcefilethatcontains� ��<DEFINE_SYMBOL>8/ ��tagsforallsymbolsthatare referencedL�- ��butnotactuallyassignedtoaspecificsection,tableor� ��figure.'Seeo ��Section1.2.17. `� ��G� ��Addblankpagestoan unbalanced PostScriptfile.,See�] ��Section1.2.1. `� ��>� ��Extractasectionfroma PostScriptfile.'See ��Section1.2.2. `�\ ��P�\ ��Addadiagonalfaintgreytextonallpagesofa PostScript� �� document.'See ��Section1.2.3. `�4 ��.�4 ��Addafootertoallpages.&See4 ��Section1.2.4. `� ��.� ��Addaheadertoallpages.'See  ��Section1.2.5. `�2 ��?�2��Extractfigures from a PostScript document.2See���Section1.2.6. `�  ��M� �� Re-arrangepagesina PostScriptfilesoIcanprintthem>�c��asa signaturebooklet(saddle stitching).'Seec��Section1.2.7. `� ��B���Numberpagesofan unnumbered PostScript document. �;��Seec;��Section1.2.4.�*�����������'���Z������?���U��������*�����������'���������?���F��������*�����������'���������?���I��������*�����������'���4������?���[��������*�����������'���2������?���_��������*�����������'���|������?���b��������*�����������'���i������?���M��������*�����������'���o��H ����?���i��������*�����������'������ ����?���,��������*�����������'����� ����?���0��������*�����������'�����w ����?���6��������*�����������'����� ����?���8��������*�����������'��� ��v ����?���=��������*�����������'������N����?���?��������*�����������'�����&����?���C��������*�����������'���c������?���8�������������(��������������� ����������LO����3.!What modificationmustbemadetothe PostScriptfile? `�[ ��G�[��Addblankpagestoan unbalanced PostScriptfile.,See���Section1.2.1. `�3 ��>�3��Extractasectionfroma PostScriptfile.'See3��Section1.2.2. `� ��P���Addadiagonalfaintgreytextonallpagesofa PostScript� �� document.'See ��Section1.2.3. `� ��.���Addafootertoallpages.&See��Section1.2.4. `�  ��.� ��Addaheadertoallpages.'See  ��Section1.2.5. `� ��?���Extractfigures from a PostScript document.2See���Section1.2.6. `�` ��M�`�� Re-arrangepagesina PostScriptfilesoIcanprintthem>���asa signaturebooklet(saddle stitching).'See��Section1.2.7. `�8 ��B�8��Numberpagesofan unnumbered PostScript document. ���Seec��Section1.2.4.�*�����������(������v����?���,��������*�����������(���������?���0��������*�����������(���������?���6��������*�����������(�����M����?���8��������*�����������(��� ������?���=��������*�����������(����������?���?��������*�����������(�����|����?���C��������*�����������(���c��T����?���8��������H�����)���������������! ����������:O����4.!WhatmustbedonewiththeSDMLfile? `�[ ��O�[��Alistmustbeproducedofallfilesthatmakeupadocu-���ment.&SeeU��Section1.2.8. `�3 ��G�3��AnMMS descriptionfilemustbemadetoautomatethe*���rebuildofthe document.&See��Section1.2.9. `�  ��K� ��Thedocumentmusthavesymbolsaddedtoenableittobe2�c�� processedtoa Bookreaderfile.'Seec��Section1.2.10. `� ��O���Alistmustbeproducedofallsymbolsusedina document. �;��Seec;��Section1.2.12. `� ��*���Alistofallindexentries X ��<X> ��and  ��<Y>��mustbe produced. ���Seec��Section1.2.11. `� ��H���Theglossaryentriesmustbesortedalphabetically.+See���Section1.2.14 `�j ��Q�j��Alistofalltagsusedinthedocumentmustbegiven,with#���theirusagecount.'See��Section1.2.15.�*�����������)���U��v����?���F��������*�����������)�����N����?���I��������*�����������)�����&����?���M��������*�����������)���c������?���U��������*�����������)���c������?���Q��������*�����������)����������?���_��������*�����������)���������?���b�������������*��������������� ��������r��CO����5.!WhatdoyouwanttoknowfromtheXREFfile? `�[ ��A�[��Alistofallsymbolsdefinedinthebook.'See[��Section1.2.12 `� ��M���AfiledefiningallsymbolsofonebookassymbolstobeK�3��usedinanotherbookforcross referencingbetweenbooks. ���Seec��Section1.2.13.�*�����������*���������?���U��������*�����������*���c��N����?���[��������@������+���������������������������O����1.2BAnswers�g�����,�����������������������=��;O����1.2.1BAddblankpagestoa PostScriptfileMO�4��Tobeusedonlyon documentsthatforsomereasonomittedMO���toincludeblankeven (lefthandside)pageswhenachapter"O���endsonanoddpage.Ft�i �� DOCTOR/PS&/BLANK% inputfile.PS%[%/OUTPUT=outputfile.PS%]�"�����-�����������������N���������OO����Ifyouhaveadefaultblankpagedefinedas PostScriptfileNO����(e.g.,withtextslike"LeftBlank")youcanspecifysucha&O�5��blankpagefilewiththe!5 ��/BLANK=blankpagefile.PS*5�� qualifier.�y������.�����������������!������O���O����Example:=� �� DOCTOR/PS%file.PS&/OUTPUT=twosidedfile.ps&/BLANK�]������/������������������������3���O����Fordetails,seew���Section6.2.�*�����������/���w��F���|��?����������������0��������������� ����������=O����1.2.2BExtractpagerangefrom PostScriptfileOO�4��Anypagerangeorrangescanbe extractedfroma PostScriptPO���file,providedyouspecifythecorrectpagevalues.)TheseareOO��� mentionedinsidethe PostScriptfileonthelinesthatstartO�=��with = ��%%Page:"=��.'WithaDCLcommand*t� ��$%SEARCHK inputfile.PSJ%%Page:�������1������������������������m���MO����youwillseeallvalidpagevalues specified followingtheO�� ��%%Page:{���word.�������2�����������������i���������.O����Toextractarangethenspecify;� �� DOCTOR/PS% inputfile.PS%/OUTPUT=outputfile.PS&-2zP ��/EXTRACT=(START=startpage,& END=endpage)������3��������������������������LO����Or,whenanumberofpagesmustbeprinted followingtheO����startingpage:;�a �� DOCTOR/PS% inputfile.PS%/OUTPUT=outputfile.PS&-:z ��/EXTRACT=(START=startpage,&NUMBER=integervalue)�������4��������������������������O����Example:?� �� DOCTOR/PS%completefile.PS%/OUTPUT=partialfile.PS%-+/P ��/EXTRACT=(START=4-6,%END=5-2)%-*/ ��/EXTRACT=(START=8-1,NUMBER=6)%-0/ ��/EXTRACT=(START=INDEX-1,% END=INDEX-9)�]������5������������������������3���O����Fordetails,seew���Section6.4.�*�����������5���w��F���|��?�����������,�����6��������������� ��*��������AO����1.2.3BAddingdiagonalwordingto PostScriptpagesUO�4��Toaddafaintdiagonaltexttoallpagesofa PostScriptfile,O���specify[t� �� DOCTOR/PS& inputfile.PS%/CHANGE=(DIAGONAL="text%string")%/OUTPUT=outputfile.PS�]������7������������������������3���O����Fordetails,seew���Section6.3.�*�����������7���w��F���|��?����������������8��������������� ��*���������7O����1.2.4BAddingfootersto PostScriptpagesTO�4��Toaddafooteronallpagesofa PostScript document,usetheO���commandYt� �� DOCTOR/PS& inputfile.PS%/CHANGE=(BOTTOM="text%string")%/OUTPUT=outputfile.PS�.�����9��������������� ����������SO����Toaddacountervalueoneachpagefooterstartingonacer-MO����tainpositiveintegervaluethat incrementswitheachpage,O�5��specifySt� �� DOCTOR/PS& inputfile.PS%/CHANGE=(COUNTER=integer)&/OUTPUT=outputfile.PS�������:��������������� ������������ O����The�� ��BOTTOM= ���and� ��COUNTER=-��� argumentscanbe combined.'ThenFO����thenumberisappendedtothe specifiedfootertext.�������;��������������� ��i���������O����Example:R� �� DOCTOR/PS% inputfile.PS%/CHANGE=(BOTTOM="text&string",& COUNTER=50)&- zP ��/OUTPUT=outfilefile.PS�]������<������������������������3���O����Fordetails,seew���Section6.3.�*�����������<���w��F���|��?����������������=���������������q �����������HO����1.2.5BAddingheaderstopagesofa PostScriptdocumentTO�4��Toaddatextstringatthetopofeachpage,usethecommandW� �� DOCTOR/PS% inputfile.PS%/CHANGE=(TOP="text&string")&/OUTPUT=outfilefile.PS�]������>������������������������3���O����Fordetails,seew���Section6.3.�*�����������>���w��F���|��?����������������?�������������������������@O����1.2.6BExtractfiguresfroma PostScriptdocumentEO�4��Whenfiguresinadocumentaremadeas encapsulatedHO��� PostScriptfilesandincludedinthecomplete document,KO���youcanextractthosefiguresinto individual encapsulated<O�=�� PostScriptfilesagainbyusingthecommand:3� �� DOCTOR/PS% inputfile.PS%/FIGURES=EXTRACT�z�����@���������������! ��+������P��QO����Eachfigurewillgetthenameithad originallywhenincludedHO����intothe document.,Ifyouwanttheir filenameschangedNO�5��toreflectthepagenumberonwhichtheyarefoundinthe&O���complete document,specifyC� �� DOCTOR/PS% inputfile.PS%/FIGURES=(EXTRACT,& PAGE_NUMBER)�������A�����������������N���������GO����Whetheradocumenthasincluded encapsulated PostScriptFO����figurescanbe determinedby searchingforthelinesO�5 ��%%BeginDocument/5��insidetheinput PostScriptfile.�]������B������������������������3���O����Fordetails,seew���Section6.5.�*�����������B���w��F���|��?����������������C���������������! ����������@O����1.2.7B Re-arrangepagesfor saddle-stitchprintingMO�4��Tore-orderthepageorderinsidea PostScriptdocumenttoTO���allowforprintingfourpagesathalfsizeonthetwosidesofUO���asinglesheetofpapersothatthebookletcanbefoldedasaMO�=�� magazine,youmustfirstensurewhetherthedocumenthasaOO���balancedsetofpages (containingblankpageswhereneeded- O���see���Section1.2.1>��todothis).(Then,youcanreorderthepagesO�G��bythecommand:?� ��DOCTOR/PS/SADDLE% inputfile.PS&/OUTPUT=outputfile.PS�*�����������C����������?���,��������������D���������������q ��z���������FO����ThenthebookletisprintedonanLPS20doubleside,O���� PostScriptlaserprinterusing:U�a ��1PRINT/QUEUE=lps20_PSqueue/PARAMETER=(SIDE=TUMBLE,% NUMBER=2)& outputfile.PS�]������E������������������������3���O����Fordetails,seew���Section6.6.�*�����������E���w��F���|��?�����������2�����F�����������������*��������:O����1.2.8BListofanSDMLdocument compositionTO�4��Alistofallfiles (figures,tables,elementsetc)usedinone;O���documentcanbeproducedusingthecommand:?� �� DOCTOR/SDML& mainfile.SDMLK[/OUTPUT=outputfile.SDML]������G�����������������������~��MO����Thisresultsinanewversionofthemainfilewherethe:O���� structureofthedocumentiswrittenina*� �� <COMMENT>���headerYO�5��atthestartofthatfile.(ThemainfilemustbethefilethatisFO��� specifiedontheDOCUMENTcommandlinefor processing5O���(i.e.'theprofilefilein bookbuilds).�]������H������������������������3���O����Fordetails,seew���Section7.2.�*�����������H���w��F���|��?����������M�����I��������������� ��������#��;O����1.2.9BAutomatedocument generationusingMMSPO�4��TogenerateanMMS descriptionfilethatcanbeusedtoau-GO���tomatethe processingofaVAXDOCUMENT document,useO���thecommand;�i ��DOCTOR%/SDML% mainfile.SDML&/MMSK [/OUTPUT=NL:]�`�����J���������������! ��������6��O����Thisresultsina� �� mainfile.MMS*��� description.)YoumustspecifyO�� �� /OUTPUT=NL:4���ifyoudon'twanttogenerateanew � �� mainfile.SDMLRO�5��thatcontainsalistingofthedocument structure(as described O���in���Section1.2.8).�*�����������J������P����?���F�������������K��������������� ����������PO����Youcanalsospecifyaspecificdoctypeand/or destinationifEO����youdon'tlikethedefaults(REPORT,SOFTWARE.ONLINE,8O�5��MANPAGEandLN03, LINE_PRINTER,PS,MAIL,,O��� BOOKREADER,ROFF).Forexample:-� �� DOCTOR/SDML& mainfile.SDML%/MMS%->/Z ��/DOCTYPE=(PAPER=MANUAL,JONLINE=MANUAL.ONLINE,&)%-G/ ��/DESTINATION=(POSTSCRIPT=POST,%LN03=MY_OWN_LN03,% MAIL=TEXT)�]������L������������������������3���O����Fordetails,seew���Section7.3.�*�����������L���w��F���|��?���+������������M��������������� ����������6O����1.2.10CPrepareSDMLfilefor BookreaderIO�4��Adocumentmusthavesymbolsattachedtoall sectioningRO���tags,tables,examplesandfiguresandthesemustalsoberef-O���erencedusingthe �� <REFERENCE>(��.+DOCTORcanaddallthisMO�=��whereitisnotprovidedbytheauthorusingthecommand:C� �� DOCTOR/ONLINE% mainfile.SDML% [/SUPERSEDE]% /OUTPUT=.SDML������N���������������! ��W��������VO����Thiswillresultinnewversionsofallfilesofwhichthedocu-O����mentconsistswith�� �� \BK_ADDED_nn(���symbolsaddedwhereneeded.GO�5��Whenadocumentismodifiedorhasbeen processedby%O��� DOCTOR/ONLINEbefore,the �� /SUPERSEDEG�� qualifierwillre-OO���movealloldsymbolsthatwereaddedbeforeaddingnewonesO�>��whereneeded.�������O��������������� ��z���������MO����Whenmanysymbolsare predefinedinaspecialsymbolfile,=O����thesecanbemadeknowntoDOCTORtoousingL�a �� DOCTOR/ONLINE% mainfile.SDML%/SYMBOL_FILE=filespec% /OUTPUT=.SDML�[������P������������������������1���O����Fordetails,seew���Chapter5.�*�����������P���w��F���l��O����������������Q��������������� ��������|��+O����1.2.11CProducealistofall X���<X>���indexentries4O�4��Toproduceatextfileinwhichall %4 ��<X> 4��and O4 ��<Y>4��tagsarelisted,OO���togetherwiththeirorigin(sourcefileandlinenumber)can)O���beproducedbythecommand:=�i �� DOCTOR/SDML&main_file.SDML&/INDEX=outputfile_spec� �����R��������������� �����������RO����ThisoutputfilecanbeusedtocheckfortypingerrorswhereQO����indexentriesshouldbe identicalandarenot.)BysortingtheO�5��outputfile:&� ��SORT% index_fileJ index_file�������S���������������! ��N��������� O����all �� ��<X>BM���entriesaresortedalphabeticallyandmistypeden-TO����triesareeasily discoveredandcanbe correctedintheoriginalO�5��sourcefiles.�]������T������������������������3���O����Fordetails,seew���Section7.5.�*�����������T���w��F���|��?���O������� �����U�������������������������=O����1.2.12CProducealistofallsymbolsdefinedGO�4��Whena bookbuildis performedonaprofilefile, VAXCO���DOCUMENTalsoproducesacross referencefilewith<O���thenameoftheprofilefileandfiletype  ��.XREF��.ThiscrossMO�=�� referencefilecanbe inspectedbyDOCTORanditcangen-RO���erateseveraltabularliststhatdescribeallsymbolsandtheir*O��� translationwhenusedwitha �� <REFERENCE>W��tag.*TheselistsDO�G��areproducedinVAXDOCUMENTsourceformat,sotheFO��� resultingfilesfromDOCTORmustbe processedbyVAX3O���DOCUMENT(e.g.'usingREPORT doctype).�������V�����������������!���������OO����Toproducealistofallsymbolsin alphabeticalorder,use7t� �� DOCTOR/XREF%profilefile.XREF%/LISTJ[/FULL]�������W�����������������N���������O����Whenthe� ��/FULL=���isomitted,thetablesonlycontainthetext&O����thatwouldbeshownwhen7� ��<REFERENCE>(value)���wouldhaveO�5��beenused.������X��������������������������RO����Toproducealistofallsymbolssortedin alphabeticalorder,SO����butdividedbytheirtype (chapter,section,figure,tableetc), O�5��use7� �� DOCTOR/XREF&profilefile.XREF%/SORTK[/FULL]�������Y���������������! ��z���������UO����Toproducealistofallsymbolssortedin numericalorder(1.1,7O����1.2,1.2.1etc)andbytheirtype,useA�a �� DOCTOR/XREF&profilefile.XREF%/SORT%/NUMERICK[/FULL]�]������Z������������������������3���O����Fordetails,seew���Section9.2.�*�����������Z���w��F���|��?���g������������[���������������! ��j������d��8O����1.2.13CCross referencingbetween documentsBO�4��WhenDOCUMENTperformsa bookbuild,itproducesaTO���cross referencefilewiththesamenameastheprofilefileandO���withfiletype@ ��.XREF<��.ThisfilecontainsallsymbolsdefinedinNO�=��thedocumentandtheirvalue.)ItispossibleforDOCTORtoLO���inspectthiscross referencefileandproduceanotherSDMLO���filewith ��<DEFINE_SYMBOL>1��tagsforeachsymbolinthefile.NO�G��Thisway,the resultingSDMLfilecanbeincludedintoan-"O���otherbook(usingthe] �� <INCLUDE> ��or1 ��/SYMBOL=u�� qualifier)andtheTO���symbolsofthefirstbookbeusedinthesecondtoallowcross&O�Q�� referencingbetweenbooks.�y�����\�����������������������O��BO����To generate a symbol!file from a book!after VAX0O����DOCUMENThasproducedtherequired7� ��.XREF���file,useO�5��thecommand3� �� DOCTOR/XREF&profilefile.XREF%/SYMBOL%-z ��/PREFIX=string&-.zI ��/BOOKTITLE="title&of&the%book"%-(z ��[/FULL%|&/VALUE%|&/TEXT&]������]��������������� ����������QO����Aprefixcanbeaddedtoallsymbolstoavoid collisionwithLO����symbolsdefinedinthesecondbook.,A booktitleshouldbeUO�5�� specifiedtoallowittobenamedinthesecondbook(e.g.("SeeHO��� 'EuropeanTales',Chapter5")., DependingontheuseofO� ��/FULL,/VALUE G��or ��/TEXT2��thesymbolswillcontainonlythose1O�>��partsthatwouldbeseenwhentheJ> �� <REFERENCE>>��wasused%O���witheithertheargument ��FULL,VALUE ��or ��TEXT��.Whenomitted,O� ��/VALUEI��isassumed.�]������^������������������������3���O����Fordetails,seew���Section9.3.�*�����������^���w��F���|��?���m������������_���������������! ����������,O����1.2.14CSortaGlossarysection;O�4��WhenaVAXDOCUMENTsourcefilecontainsaj4 �� <GLOSSARY>NO���section,thedefinedtermscanbewritteninanyorderand=O���DOCTORcansortthemalphabeticallyusingtheD ��<GTERM>QO�=��tagsforsorting.(Therestofthe document,outsidetheglos-HO���sary,remains untouched..Tosortthe glossary,usetheO���command)t�s ��DOCTOR/GLOSSARYKinputfile.SDML������`���������������! ��+��������JO����Whenaspecificorderingiswanted,youcan additionallyO����specifythe� ��/SORT<��� qualifierwhichhasthesameoptionsastheO�5 ��/INDEXAH5�� qualifieroftheDOCUMENTcommandtoensurethatHO���bothglossaryandindexaresortedinsimilarfashion:F� ��/SORT=(% [LETTER|WORD]%![,NONALPHA={AFTER|BEFORE|IGNORE}]%)�[������a������������������������1���O����Fordetails,seew���Chapter3.�*�����������a���w��F���l��O���q�������������b�����������������*���������(O����1.2.15CCountalltagsusedRO�4��Toobtainalistofalltagsusedandtheirusagecount,youO���specifythecommandAt� ��DOCTOR/TAG_COUNT% mainfile.SDML&/OUTPUT=outputfile.TXT�=�����c��������������� ����������RO����Thisproducesaplaintextfilewherealltagsarelistedal-OO���� phabeticallywiththenumberoftimesthetagwasused.'TheWO�5��mainfile specifiedissearchedaswellasanyotherfilethatisO���includedbyit.�[������d������������������������1���O����Fordetails,seew���Chapter8.�*�����������d���w��F���l��O���Z�������k�����e�����������������������A��O����1.2.16CCreateSDMLp���<MESSAGE_SECTION>���fromVMSMessageg(��sourceO���ToconvertaV=^��AX/VMSmessageutilitysourcefile(filetypeO� ��.MSG>���into documentationforVAXDOCUMENT processing,SO�=��themessagesourcefileneedstobewritteninaspecificfor-IO���mat,whereeachmessageisfollowedbyacommentblockO��� structuredas:,t� ��FNF&<File&!AS%not% found>/FAO=1 t� ��!+t�$ ��!% Explanation:Ktext t�l ��!%User&Action:Ktext t� ��!-������f��������������� ��������W��0O����Thecommentblockmuststartwith v� ��!+���andendwith � ��!-���.'AnyKO����commentoutsidetheblockisignored.)The explanationandMO�5��useractiontextcanspanmultiplelines.,Whenacolonis%O���neededinthetext,the ��<COLON>��mustbeused.������g��������������������������JO����Messagesourcefiles formattedas describedabovecanbe+O���� convertedintoaVAXDOCUMENT� ��.SDMLl���fileusingtheO�5��commandE� ��DOCTOR/MESSAGE&vmsmessage.MSG&[/OUTPUT=outputfile.SDML%]�[������h������������������������1���O����Fordetails,seew���Chapter4.�*�����������h���w��F���l��O�����������p�����i��������������� ��`������F��(O����1.2.17CDefinedummysymbolsCO�4��WhenaVAXDOCUMENTsource referencessymbolsthatMO���donot (yet/anymore)exist,butthedocumentshouldprocessLO���properlywithoutabortingonwarningsof undefinedsymbols,NO�=��anSDMLfilecanbeproducedthatdefinesallmissingsym-O���bolswithvalue"% ��<REFERENCE>(missing_symbol)#'��".'Thisfilecanthen$O���beeitherincludedwith �� <INCLUDE>��orbytheDOCUMENTO�G��command qualifier G ��/SYMBOL G��.�������j�����������������z���������*O����ToproducesuchafilewithH� ��<DEFINE_SYMBOL>���tags,usetheO����command:A�a �� DOCTOR/ONLINE% mainfile.SDML%/OUTPUT=NL:/DUMMY_SYMBOLS�������k��������������� ��z���������KO����or,whenmanysymbolsare predefinedinaspecialsymbolO����file:W�a �� DOCTOR/ONLINE% mainfile.SDML%//SYMBOL=symbolfilespec/OUTPUT=NL:/DUMMY_SYMBOLS������l��������������� ��������f��SO����Thiswillkeeptrackof conditionssetandskipblocksthatdo?O����notmatchthe currentlyactive condition.(Using"� �� /CONDITION=PO�5��allowsyoutospecifysucha conditiontoDOCTOR,similartoKO���thewayyouwouldspecifythisto DOCUMENT.Fordetails, O���see���Section5.4.�*�����������l��������{��?����������� 1�����������������������������������������u������Z���&���DigitalInternalUseOnly4O�\��4.2 DOCTORing!VMS!Message!source!files��������������������� ��2��������O����4.1BOverviewDO�U��Whenasoftwareproductiscodedandone usesthe O���VC}���AX/VMSerrormessageutilitytoproduceerrormes-GO���sageson SYS$ERRORwhenthesoftwaredetectsanerrorO�^��(likethe^ ��%DOCTOR7^��messagesyougetfromDOCTOR),thebestOO���placetodescribethereasonoftheerrormessage occurring,QO���andwhattheusercouldpossiblydotopreventitnexttime,OO�h��istowritethis information immediatelywhenthemessageisMO���defined.'That'swhenyouknowbestwhichmessageisadded,DO���whyitwasaddedandwhatyoucoulddoaboutit.�H�������������������� ��$�������� O����The�� ��DOCTOR/MESSAGE3���utilitywillformataproperlycodedO����sourcefilewithV3���AX/VMSmessage definitionsandembed-MO�5��dedcommentsinsuchawaythatthecommentsofthefile#O���are reformattedintoa ��<MESSAGE_SECTION>-��section,readyforOO��� inclusionintotheUser'sGuidemessageappendixofthedoc-MO�>�� umentationthat describesthesoftwaretowhichtheseerrorO���messagesbelong. �_�U��Note _����IfyouuseY ��DOCTOR/MESSAGE/HELP;��thentheproduced� ��.SDML:��fileis compatiblefor processingwiththe�R �� HELP.MESSAGER��doctypeandtheR ��MDFIR�� destination,thatB���is currentlyunder developmentbyCUIP.Thiswill���resultinad ��.MDFI/;��helpfilefortheAlphaVMSand�[��OpenVMSutilitye[ �� HELP/MESSAGE"@[��thatgivesonlineac-I���cesstothemessage explanationofanybaseorlayered>� ��productrunningonthat platform.,Seenote6. O��*  ��in �e��the_e ��SQM::BLADE_INFO3e��notesfileformoredetailsonthis���utility. ��������������������������N���������,O����TheproducedSDMLfilecanbe� �� <INCLUDE>H���dintoaVAXCO����DOCUMENTsourcethatis processedfortheSOFTWAREO�5��familydoctype.��������������������� ��b������w��)O����Theerrormessagesfoundinr���AppendixA&���aremadeby� ��DOCTORO�� ��/MESSAGE:���fromthemessagefilethatbelongstothep� ��DOCTORMO�5��utilitysources,andisincludedintothisUser'sGuideby.O� ��<APPENDIX>(Error&messages\apperror)$O� ��<include>(DOCTOR_MSG.SDML)O�I �� <ENDAPPENDIX>�*��������������r��F�����O����������{������������������������������Q���QO����Youcanlooktheretogetan impressiononthefinaloutput.�������������������������������>O����4.2B Commenting requirementsforamessagefileGO�U��TheVAXMessagefilemustconformtotheVAXMessageJO���Utility standard.*Thismeansthateachmessage definitionPO���isonelineandupto255 charactersinlength.)Anythingfol-KO�^��lowingan exclamationmark("!")onalineis consideredMO���commentor(ifpartofthemessagetext)aFAO directive.�������������������������������O�� ��DOCTOR/MESSAGE9w���willusecommentlinestoallowthepro-OO����grammertodescribethereasonsfortheerrormessagetobeQO�5�� signalledtotheuserandpossibleuseractionstoavoidthisIO��� situationfrom happeningagain.)ThesecommentlinesmustMO���adheretoacertain structurethatwillbe explainednext.�J����������������������N������ ��O�� ��DOCTOR/MESSAGEBu���willstartbyreadingallthefacility definitionO����lines(%� �� .FACILITY=u���)andsortthemalphabetically.)EachfacilityO�5��willproducea!b5 ��<HEAD1>(facilityname))&5��sectionintheoutputfile.�������������������������������s���NO����Next,itwillreadallthesymbolicmessagenamesandalso%O����sortthemalphabetically.� ����������������������W��������NO����Finally,itwillscanthroughthecommentlines followingaEO����messagelineandreformatitintoVAX DOCUMENT.TheMO�5��comments followingamessagelineare consideredtobede-CO���scribingthatmessage.+Theyareonly recognizedby ��DOCTORO� ��/MESSAGE?��whentheyarewritteninacommentblockthatO�>��startswith" > ��!+M>��"andendswith" > ��!- >��".�$�������������������� ��N���������JO����Asmallexampleofthemessagefilesourcecodetothe� ��DOCTORSO����utilityandthe resultingmessagecodeforthisUser'sGuideisO�5��shownin5��Example4-1 5��and@5��Example4-2.�*���������������������O�����������*��������������@�������O�����������������������������������������|���LO����SomecommentstotheoriginalmessagesourcefileandtheO����produced� ��.SDML���file:�7�������������������� �� ������ �� ����1 ����Thex� �� .FACILITY"���isusedtocomposea&� ��<HEAD1>(facility title\MSG_�( �� facility);(��sectiontag.'Theyaresortedalphabetically. ���2F���Theseveritylevelwillbeprintedwitheachmessage���� descriptionasa� ��<MSG_TEXT>(Severity:)���entry. ���3F���Themessageidentandstringisusedtocomposethe$���messageentryusingtheV ��<MSG>:��tag. �W��4F�W��Thecommentblock followingthemessage definitionisK���splitincommententries.)Eachentrystartswithashort� ��header.  ��DOCTOR/MESSAGE.( �� interpretseachcommentline.)IfO�a��acolonis encountered,thefirstpartofthelineismade���intoa �� <MSG_TEXT>6a��entry,the remainderoftheline(plusI���possible subsequentlines)formthebodyofthemessage�k��entry description. ���5D���Sameaspreviousentry.. FollowingtheDigitalstan-I�C��dardformessage descriptions,twoentriesaremadeper���message:&an�� Explanation ��andM��UserActionA��section. ���6S���Ifyouwanttousethecolon(:)&aspartofthetextwithout�s ��DOCTOR/MESSAGE:s�� interpretingthisasanentryheading,use���thetag ��<COLON> ��whichisdefinedby ��DOCTOR/MESSAGE ��attheK�$��startofthemessagesectionoutputand undefinedatthe"�}��endofit(soitis $} ��not'}��astandardDOCUMENTtag!). ���7��� Definitionof ��<COLON> �{ ��8�{ ��Undefineof{ ��<COLON>���������������������! ��W��������8O����The followinglinesarerequiredbyboth� ��DOCTOR/MESSAGE #���andJO����theVAXMessageutilitytowork properly.,NotethatyouO�5��shouldnotrunv5 ��DOCTOR/MESSAGE.5��onasourcefilewithouthavingJO���beenabletoproperlycompilethesourcebytheMESSAGEO���command. ��DOCTOR/MESSAGE-��doesnotdothesame intensiveJO�>��checkingasMESSAGEandpartlyreliesoncorrectsyntax.�~��������������������! �� ������T��O���� .FACILITY<K���Onceforeachsetoffacility messages.%The3K0��facilitynameisusedtocreatethe0 ��<HEAD1><K~��headingforthatmessagesection." Abbreviated8K��formsoftheword .FACILITYareallowed.O�E�� .SEVERITYAKE��Requiredtospecifythetypeofseverityofthe/K��message described.'Itisusedbyi ��DOCTORK ��/MESSAGE/��towritethis informationintheK-�� Severity:,-��partoftheoutput.&Eachmes->K{��sagecanalsohaveitsownseverity indicated6K��usingthe /WARNING,/SUCCESSetc.#qual-?K��ifiersattachedtothemessage definitionline.6Kc�� Abbreviatedformsoftheword .SEVERITYK��areallowedO�+��messagelineK+�� Formattedas, �� messagenameK<&text% >/qualifiers, �� messagenameK"&text% "/qualifiersK|��wherethe|��text% |��messageis surroundedby8K��either quotationmarksorangle brackets.6K��Thislineisoutput literallyintothe ��DOCTORKe ��/MESSAGE3e��outputfile,sortedalphabeticallyon<K��messagename.!Bydefault,theFAO directives3K���arereplacedbygenericstringslike���string w���orKM��number4@M��, dependingontheFAO directiveen-9K�� countered.%AlsoUIC,time,dateandother?K�� directivesareproperly substituted.$IfthisisK6 ��notwanted,specify6 ��DOCTOR/MESSAGE/FAO m6 ��onK ��thecommandline.�L��������������������! ��������"��1O����4.3BIncluderesultin documentationOO�U��The resultingmessagedocumentfilecanbeincludedintoap-RO���pendicesoftheuser publicationsormadepartoftheDetailedPO���DesignSpecification.&Bothwillthenhavean identicalformat.��������������������� �����������RO����Assuch,the followinguseofthemessageoutputis suggested:%�* ��<APPENDIX>(Error& messages)%�q ��<INCLUDE>(messagefile.SDML) T ��:$  �� additional%message%files TI ��:� �� <ENDAPPENDIX>��������������������� ��|������c��;O����4.4BDOCTOR/MESSAGEFeaturesonMessageFilesEO�U��Thecommentsrelatedtoamessageare recognizedbyU ��DOCTORO� ��/MESSAGEC��onlyiftheyarewrittenwithinaspecialcommentO���block, formattedas � ��!+ � ��!  ��header%text: �� additional&text � ��! �c ��!-�������������������������������v���&O����Thiscommentblockshould?� ��follow$%���theVMSmessagedefini-O����tion immediately.�����������������������W�������� O����The�� ��headertext=���isoutputasaboldlywrittensetofwords,QO����followedbyoneormorelinesof additionaltext.(Thesepara-O�5��tionbetween*5 ��headertext15��andthe remainingtextismadebyUO���thecolon(":").(Assuchthe additionaltextshouldnotusethisRO��� character.(Ifthecolonisrequiredaspartofthe explanatoryO�>��text,thenusethe> ��<COLON>>��tag.���������������������! ��������p��NO����ToconformtotheDigitalstandardwayof documentingerror8O���� messages,the followinguseis suggested:;� �� message_nameJ<error&message%text>% /qualifiers  ��!+  ��!% Explanation:ptext Z ��!  ��!%User%Action:ptext  ��!-B 2 ��!K additional%comments%not&meant&for%DOCTOR/MESSAGE z ��!�Q��������������������L ��,������'��LO����Notethatanycommentwrittenoutsideacommentblockde-BO����limitedbythe"+"and"-"willnotbeseenby� ��DOCTOR/MESSAGE.JO�5��In addition,theentiremessagecanbeomittedfromtheLO���SDMLoutputifthemessagelineitselfcontainsacomment)O���trailerthatcontainseither  ��!* ��or ��!*Skip*��astext:D� �� message_nameJ<error&message%text>% /qualifiersK!*SKIP*  ��!+  ��!% Explanation:ptext d ��!  ��!%User%Action:ptext  ��!-U ; ��!KDespite%the&!+&and%!-%marked%comment%block,%the&entire%message[  ��!Kis&not%copied%into%the%SDML%output%file%due%to%the&!*SKIP*%comment$  ��!Kon&the%message&line.  ��!����������5��� ��:���W��f��~�M����F������^��� ����������-�������������������bl��#����"����Ko��6�����A������4���:����D 1��9���n��=���v�4��`����(J��O���n���S���@�G �����@���W���w��Z������\����E��^��� ���^��������zn������������������4��������������� ���������1��4�����l� ��8��3��*��^�"��-��v��/���I��0��FJ��R��T���R����\��`���c��r2!��t���|A����$�,���� = ����`>����������r��������������,����� ����x���(�������|,������������