docwash.fm5FASLFm55 ˱$X  Aa*d -@y` @  P=MY !A@eHH $ @d f$YK_H6̀̀̀ff@  d Footnote TableFootnote**.\t.\t/ - :;,.!?3 _9 bTOCHeading1   EquationVariablesjv'ְֱִֵַָּֽ֤֥֨֩֫֬(EFKLSR S h i       Tabpq~)*CD[\  !!""##0$1$%%&&''6(7(~))**++,,--M.N.^/_/l0m0~11223344556677485899::;;;      !"#$%&'()*+,-./0123456789:; (<$paratext[ReportTitle]> <$paratext[Heading1]> <$curpagenum><$lastpagenum><$monthname> <$daynum>, <$year> (Continued)+ (Sheet <$tblsheetnum> of <$tblsheetcount>)Pagepage<$pagenum>Heading & Page <$paratext> on page<$pagenum>See Heading & Page%See <$paratext> on page<$pagenum>.Figure Number & Page(Figure<$paranumonly> on page<$pagenum> Table All7Table<$paranumonly>, <$paratext>, on page<$pagenum>Table Number & Page'Table<$paranumonly> on page<$pagenum> Figure All8Figure<$paranumonly>, <$paratext>, on page<$pagenum> y docalyzedocalyze u doccountdoccount w docwashdocwash A AATOCLOFLOTIX A*,>+,,=,====== ==2,,3,1.62.:7.==<3.=4.>5.?6.====J,,P,[,,i,1.2.3.) 4.*,&(,./015.23456TL',!==,'==-==@==F==L,=W,x,,,1.2.3.4.5.6.7.8., =,== ====#==1=P,,0,h,=,1.2. 3.H,Note: S,,^,,_,,j,,4.,,,, ,,,(,,A=,W>=_==>=,>,%,,/,D,,s=,r==~,=,,,u ,=Note: ,Tip: , ,,,,,,,/,Tip: Q,Tip: ,,,M,,,,Tip: ,, =,!==0,=,,5=,a====>=>=>=;,,R,Tip: [,,e,v,,,,,== ==N,,,==%,=>=,===,,>,,l,,,,==,,Tip: jd dd f$_Acf$_AAw9` Pagination  GIf the foreign files have frozen pagination, unfreeze it. If they have 0Mdisconnected body pages, either delete them or connect them. Disconnected or @0frozen pages will likely cause strange results. u NWhen the foreign files have been cleaned down to a set of tag-names for which P@Pyour house template has reasonable replacements, save the foreign files as MIF. d f$_eif$_ee `7The output MIF file is a complete document comprising:  KThe Color, Condition, Font, Paragraph and Table catalogs, and the Variable 0aand Cross-reference definitions, from the =docwash9 template file. The foreign @;versions of these seven catalogs are discarded completely.  (gThe Reference pages of the 9=docwash9 template file. The foreign reference pages K@are discarded.  Z KThe Master pages and Body pages of the foreign file. Thus the page layouts 0fFare unchanged; and any unanchored (fixed) frames on body pages are at @their original locations.  JThe text, tables, and anchored frames of the foreign file; however, every 0LColor, Condition, Variable, Xref, Font, Paragraph and Table Format tag-name Fis converted according to the Replacement tags you specified in the H+=docwash9 template file. hQ=docwash9 can issue error messages on the standard error file: ˪ \Warning: no replacement for <dtagtype9 dtagnames9> means that the program 0תLfound a tag of the indicated kind and there was no replacement given in the @template tables.  ]Warning: tag <dtagtype9 dtagnames9s> unchanged, / not supported means that 0Pthe replacement string was the single letter /, meaning delete the tag, but @'this feature has not been implemented. l(X=docwash9 does not check for misspellings. If the replacement tag you 0*Rspecify is not spelled exactly as it appears in the template catalog, Frame notes Ran error when you open the washed file. At least in the case of Table formats, if @8you misspell a replacement table tag, Frame will crash. V(aTo ensure correct spelling, copy the tagname from a 9=docalyze9 report and Pb@paste it into the table. 6f$X}C6f$X}h( ~Hf$X}DHf$X} j( ~d  f$_X} f$_X}  Ponly the page formats from your house template file. At this point, headers and @footers should look correct.  NNow edit the converted document to take care of remaining issues and deferred P@!issues, such as ambiguous fonts. 6f$X}E 6f$X} ( ~6f$X}F$6f$X}## l6+61&G$&6+61&%% l6KH&6K'' lHf$X}I)Hf$X}(( lH+61&J)+H+61&** lHKK+HK,, lHuL-Hu..  lHjVM-0HjV//  lH)*~EN-02H)*~E11" lHKO-3HK44# lHQ&EPKMHQ&ELL$ lHV&EQKMOHV&ENN% lH&1RKOQH&1PP& llrWuSRTlrWuSS' lHuTUHuVV( ~HjVUUHjVWW( ~6f$X}VX6f$X}Y!( ~Hf$X}WZHf$X}[\( ~6f$X}Xd6f$X}e`( ~Hf$X}YoHf$X}pb( ~ 6 ~32ZXY!6 ~3232Wh(How to Run Idocalyze?  _5[X  _513 hFThe steps for using 9=docalyze9 are as follows:  LCreate, or select, a Frame document whose contents you want to record. This 0Bis typically either a house template for which you need reference @Jdocumentation, or a foreign document whose structure you want to analyze. F`IOpen the document under Frame and use File>Save As... to save it as MIF. (dExecute 9=docalyze9, piping the document MIF as standard input and saving the a@9standard output stream as another MIF file. For example, UTl`,docalyze template.analysis  z GUnder Frame, use File>New to open a new document based on the template @file =MIFFEDTP.fm49. )haUse File>Import>File and specify the output of 9=docalyze9 to be imported.  LThe result, after a few seconds, is that a set of tables appears in the new 0Pdocument. The tables are in the order that catalogs appear within the input MIF @)document. The usual order is as follows: `Table 1: Color definitions `#Table 2: Condition Tag definitions `$Table 3: Paragraph Basic Attributes `+Table 4: Paragraph Default Font Attributes `)Table 5: Paragraph Pagination Attributes  `(Table 6: Paragraph Numbering Properties A`'Table 7: Paragraph Advanced Properties HQ~32\Z[\HQ~3232WIh(How to Run Idoccount? f$hX}f$hX} W" d 6RK 6R6RR 6+61&6+61&  W lzUsing Ldocwash{ 6̬qO 6̬q6̬q̬q 6K6KW l9|8}U~LThe DocWasher SuiteU f$hX}f$hX}W d HRUHRHR.R H+61&H+61& W lUsing Ldocwash H̬qYH̬qH̬q.̬q HKHKW)l:VThe DocWasher SuiteUV7 d uh-uhW +d jhV-jhVHR~b-HR~HRR H)*~E-H)*~E W! lJune 7, 1995 H[Rf-3H[RH[R.[RH̬qh-2H̬qH̬q.̬q HK-HK W# l 1 d6J H@R`@57H@R`@H-H-:FootnoteH 56988Footnoteo7 H57A:; Heading1 Ruled_r9;d_ddմ9:<= Heading2 Rulef'du;=f'df'ddHշ;<>? Heading2 Ruled_x=?d_ddչ=>@@ Heading2 Ruled_{?d_dd HFSZ`@ 59BHFSZ`@H$H$: Heading1 RuleHr 5ADCC TableFootnoteD~BD~DD J cdMR`@ 5BEJ cdMR`@J cmJ cm: TableFootnoteH 5DGFF Figure Rule_փE_ HbB `@ 5EHHbB `@HH: Figure RuleGC233ջ 5GJII Heading2 Rule~և H~~ H2F:SZ`@ս 5HH2F:SZ`@H;H;: Heading2 RuledQ HQ&EKHQ&E։W$/d<$paratext><$pagenum> Hu]`@KHu]`@HG5HG5:Table of Contents Specification HV&EKHV&E։W%/d"<$paranum><$paratext><$pagenum> HCu,`@KHCu,`@HL5HL5:List of Figures Specification H&1KH&1W&/d"<$paranum><$paratext><$pagenum> Hu`5`@KHu`5`@H5H5:List of Tables SpecificationdT lrWuRlrWuH'0d Level2IX *d Level1IX +d1, 23 ,%d$<$symbols><$numerics><$alphabetics> -3:dLSymbols[\ ];Numerics[0];A;B;C;D;E;F;G;H;I;J;K;L;M;N;O;P;Q;R;S;T;U;V;W;X;Y;Z S.0Ed <$pagenum> lbum^-`@Rlbum^-`@lk5lk5:Index Specificationd u_Uu_(+`The DocWasher Suite /4UTUT` Dave Cortesi 05q +A set of programs for analyzing FrameMaker p1template files, and for conversion of a document @from one template to another. j_VUj_V&3 `0The DocWasher suite consists of three programs: (\=docalyze9 produces an exhaustive report showing all paragraph, font, and @)other catalogued features of a document. (_You use 9=docalyze9 to document a template for reference, and to help in @?planning the conversion of a foreign file to a house template. N(c=doccount9 produces a census of the use of all paragraph, font, etc. tagnames in Z@6a document, and whether they are used in hidden text. i(dYou use 9=doccount9 to analyze the actual usage of tags within a document, in u@,order to find out what has to be converted. (]=docwash9 reads a template document and then converts an input document to @@use that template, following instructions in the template file. (^You use 9=docwash9 to perform a brainwashing operation, automatically @;converting almost all usages from one template to another. `7All these programs read and write files in MIF format. Q`DThroughout this report, Frame can mean either Frame 3 or Frame 4. R` S` T` AU` d< f$_ =X f$_ 16UTUTh(Using bcdocalyzeb K (Y=docalyze9y reads the MIF version of a Frame document and notes all the @(definitions within it of the following:  `EColor definitions (Frame 4 supports the definition of custom colors)  N`Conditional tags  `Table formats `Cross-reference formats `Variable definitions `#Pages: reference, master, and body  ` Paragraphs (eThe output of =docalyze9 is a MIF file that contains the definition of a number of 0Ttables. The rows and columns of these tables reflect the details of the definitions Oabove. For example, table 1 lists the name of each Color tag, and for each tag @Bgives the percent composition of Cyan, Magenta, Yellow and Black. 媪(_Because some of the =docalyze9 tables are quite wide, they are formatted for pNdisplay in a particular template which is defined with wide pages and compact Wtable cells. This template, named =MIFFEDTP.fm49, is required; it is a Frame 4 @ document. d f$_Z"f$_ `)Table 8: Paragraph Table Cell Properties 2`$Table 9: Character Style Properties 4`!Table 10: Table Basic Properties 5`Table 11: Variable definitions 6`&Table 12: Cross-Reference definitions 7`Table 13: Pages in document 8e`2You now save the report document and/or print it. 96UTUMh(Using bcdoccountb : (a=doccount9 reads the MIF version of one or more Frame documents and counts the @7usage in them of all tag-names of the following kinds: ;ª` Color tags <Ѫ`Variable names =`Cross-reference format names >`Table format names ?`Condition names @`Character tag names A`Paragraph tag names B`Reference frame names C?(eFor each of these classes of names, =doccount9 produces a table containing one row K@Ofor every tag name that appears in the document. The columns in the table are: D]`+Tag name, showing the spelling of the name El GCatalog, containing Y or N depending on whether or not this tag is x@#defined in its respective catalog. F`LHidden, containing Y only if this tag is used in hidden conditional text. G`DCount, showing the count of times the tag is used in text anywhere. HhaReplacement, a blank column whose use is described with 9=docwash9, later. L JUsing these tables you can tell exactly which tags are really in use in a pŪMdocument (or in a set of documents) and which are not. This helps you plan a @Bconversion, or judge the effect of a change in a template design. Q_m]Z"Q_mT3,J hJIn order to use 9=doccount9 you proceed as follows: M IUsing Frame, save the document or documents for which you want to take a @census in MIF form. N(cExecute 9=doccount9, specifying the MIF files as command line arguments. The FHhoutput of 9=doccount9 is a stream of MIF which you direct to a file. For example, WOUTQ`4doccount first.mif second.mifthird.mif >census.mif 6t"~32^de^6t"~3232 W[`Concepts and Terms t"_3$_d]_t"_3$3$ \ (fYou use 9=docwash9 in order to convert a document from one template to another. @!This can happen in two contexts. ] EA style change is being made in your house template, and you want to @Cbatch-convert existing documents to use the new or renamed styles. ^F MIn this case, only a relatively small number of tag-names changes; there are R@Hrelatively few differences between an old document and a converted one. _a >You have been given a set of documents prepared by some other m@Corganization and you need to convert them to your house templates. `| JIn this case, there are very few correspondences between the old template 0Fand the new one. Almost everything in the document changes except the @ actual text. a bIn this discussion, the dforeign files9 are the documents to be converted. The dhouse 8Rtemplate9 is your template the defines the house style. (In fact you may have b Lmultiple house templates, for example one for chapters, one for appendixes, @etc.) 6Z9F~32`d^`6Z9F~3232 Wd`Planning the Conversion Z9F_d{[ad_Z9F_d{[Y3- e OThe first step is to plan the conversion. Specifically you have to analyze the @?foreign files with respect to your house template, and decide: g`5Which tags have approximate one-for-one replacements  JWhich tags are used ambiguously, so that they might need replacement with F@%one or another of several house tags QfU`5Which tags cannot be supported by the house template H!~32bopbH!~3232Wb`Cleaning the Foreign Files !_ coa!_ 3))c UThe next step is to clean out of the foreign files all tags that you do not support, @-and all hidden text. Consider the following: i9`Conditional Text j :Under Frame, set every document to show all conditional 0ntext. Save as MIF and run 9=doccount9 on the set of all files. Check to see if any tags @/are used in hidden text. Repeat until none is. n9a`Cross-Reference Formats  a0Under Frame, delete the definition of any cross-0mJreference format you dont want to support. Frame gives you the option of @&converting all uses to text; take it. m EIf you plan to do hand clean-up of these cross-references afterward, 0Nproceed in two steps. First change the unwanted definitions so they contain a Rrecognizable string, for instance so that they display enclosed in double parens. OThen delete them, converting them to text. You can later search on the text to @(find the uses of the former references. 9` Variables o @Under Frame, delete the definitions of any variables you do not 0Mwant to support. Frame offers you the option of converting used variables to Ttext; take it. As with cross-reference formats, you can first change the definition @5to include a search-target string for later cleanup. p9`Character Styles q =Unfortunately, if you delete a character style from the font 0Pcatalog, Frame does not remove that style from any text that uses it. Text that Ouses the style retains its appearance, now using an uncataloged style recorded @right with the text. rI MIf you want to completely eliminate all uses of a character style, your only 0UKchoice is to search for it with the Find dialog. When you find it, you can Smanually change it to default format. (Alternatively, you can select default text; Guse Edit>Copy Special>Character Format to put the default style on the @Bclipboard; then change all uses of the target font by pasting.) s(^When =doccount9 reports a use of a style and the Find dialog say it doesnt 0Pexist, the reason is probably that the style is used on a Master or a Reference @8page. Find only searches the page type that is visible. t DSuppose the foreign file uses a named font in an ambiguous way, for pݿPexample using italic promiscuously for emphasis, variables, etc. As a result, Ryou want to visit every use of this font and manually change it to one of several [possible fonts from the house template. This cant be done by =docwash9. OHowever, you can select the least-used, or most-visible, special font from the `house template (for example, 14-pt Zapf Dingbats), and have =docwash9 convert Othe foreign tag to this font. Then during the manual cleanup stages it will be @(easy to find these points and fix them. 6~31df6~3131v Specifying the Conversion P@ Template d f$_d]f$_ P EUsing Frame, open a New document. You can make an ordinary, portrait-0Gmode, blank document; or you can use some other template. However, the Vnew document dmust9 define the table format Format A. If this format is not Gdefined, Frame will crash in the next step (a bug has been reported to @comments@frame.com). VEh`Using File>Import>File, specify the output of 9=doccount9 to be imported. WY LAfter a few seconds, a number of tables appear in the new document. You can e@#save the document and/or print it. X6UTULh'Using bcdocwashb Y (_=docwash9 brainwashes a Frame document, replacing all of its catalogs with 0Ocatalogs from a template, and changing all the tag-names it uses to conform to Kthe tags defined in the new catalogs. As a result a great deal of document Lreformatting is accomplished automatically. Manual intervention is required ^both before and after using =docwash9, but quite a bit of mouse-drudgery is @ eliminated. QZhJThe use of 9=docwash9 requires several major steps. _3ecg_33x (jApply 9=doccount9 to the final, cleaned, foreign MIF files. Load its output into an @$empty copy of your house template. y JIf your house template does not support Format A tables, first load the 0a=doccount9 output into a default blank paper document. Then copy and paste the @+tables into a copy of your house template. zY(dThe =doccount9 tables in the template list the tags used in the foreign files. Go 0eMdown each of these tables and, in the column headed Replacement, enter the @Bname of the replacement tag from the house template. For example, { aThe foreign files define a color dPuce9 and you decide to change it to dYellow9. @XUnder Replacement in the color table, write dYellow9 opposite dPuce9. | WThe foreign files use the tag dBody9 for ordinary text paragraphs, and you use 8YText9. In the table of paragraph tags, you write dText9 under Replacement,  @opposite dBody9. } LYou must write a replacement name for every tag that is both catalogued and 0Ractually used in the foreign files. You do not need to supply a replacement for a Jcharacter or paragraph tag that is not catalogued; and you do not need to @3supply a replacement for a tag that is never used.  PIn some cases, the foreign tag and the house tag will be the same. For example, 0Oevery Frame document defines eight basic color tags from Black to White. Also, Nif you are only converting from an old version of the house template to a new Rversion, almost all the tags are the same. To save you time in this case, you can Ksimply write the one character = in the replacement column. This tells H4=docwash9 to leave the tag alone. R QYou can write = in just one cell; then copy the cell; then paste the cell into ^@=all or part of a table column with a single paste operation. r MWhen you have prepared a copy of the house template containing a full set of p~d=doccount9 tables with replacement tags in every row, save the template as an MIF HBfile. This is the 9=docwash9 template file. 6b96~32ffh6b96~3232Wh,How to Run ?Idocwash? b96_\{kggb96_\{kE3- (kNow you can apply 9=docwash9 to each of the foreign MIF files in turn. For each file 0you execute 9=docwash9 specifying the 9=docwash9 template file as the command line Margument. You direct one of the foreign MIF files as standard input; and you @9save the standard output as a new MIF file. For example: WkUTB`2docwash update.tpl.mif washed1.mif H ~32hjH ~3232W`Editing the Washed File  _ܮii _ܮ3$ (aAfter applying =docwash9, you use Frame to open (not import) the washed output 0Pfile. In some cases, Frame may open its console window and report errors in the Rinput file, typically because it cannot find some tag. It also may say it cannot [find Table ID dn9. This indicates that something from a foreign reference page is Mreferenced from something in a foreign master page, or from a paragraph with @an uncatalogued format. ~] OIn most cases, MIF error messages are harmless since Frame uses default values 0iRfor missing data. It is possible for bad MIF to crash Frame, however, so save all @*files before opening the washed document.  NThe washed document has the approximate pagination of the original, but since 0Qit now uses your house paragraphs styles, text may flow differently than before. @DThis may be particularly evident in textrects within illustrations.  MSave the opened document and examine it. It should display the formatting of pPthe house-template definition of paragraphs, fonts, and tables, but the foreign Lpage layout. To complete the conversion, use File>Import>Formats and import d f$_oaf$_h (fIn order to make these decisions, use =docalyze9 to get reports on the structure of pgthe house template and the foreign files. Use =doccount9 to get counts of the actual @$usage of tags in the foreign files. dLeftdRightd-Firstd5 ReferencedKTOCdRIXdUFirstd Xd Zd dd od d d f@  zzFooterFirst. f@ NoteBoldNote: . f@  3B fV  L _ s33 fv    3# ff  ̽  33B FfV Y CodeInd. f@SQ   List1st StepNumber S:.\tList. f@S   List StepNumber S:.\t. f@ TipBoldTip: . @@ Body. f@P &Heading3Text. f@  3B fV  L _ s33 fv    3# ff  ̽  33B FfV Y Code. f@  Extract. @@@ TableText TableText. f@  zzHeaderFirst. f@B! % Bullet BulletSymbolB:\t. H@@ ReportTitle ReportAuthor. f@P 'Heading2 Heading2 RuleText. $f@P,Heading1 Heading1 RuleText. f@B  Bullet BulletSymbolB:\t. f@ TextInd. f@  3B fV  L _ s33 fv    3# ff  ̽  33B FfV Y Code. f@ Extract. f@P Heading3Text. f@ TabularListText. f@ Footnote. f@P Heading2 Heading2 RuleText. f@S  List StepNumber S:.\t. f@  zzHeaderRight. f@ TipBoldTip: . f@  . zzFooterRight. f@  zzHeaderLeft. f@  . zzFooterLeft. f@ TableFootnote. f@ Text. H@@ ReportTitle ReportAuthor. cf@ _. Heading1TOC. cf@ ? _. FigureLOF. cf@ ? _. TableTitleLOT.  f@ Level2IX. $f@ Level1IX. f@  SeparatorsIX. f@  SortOrderIX. f@ $ GroupTitlesIX. f@ IndexIX. $f@PHeading1 Heading1 RuleText. f@  3B fV  L _ s33 fv    3# ff  ̽  33B FfV Y CodeInd. @@@ TableText TableText. f@B % Bullet BulletSymbolB:\t. f@ TextInd. f@ TabularListText. f@ NoteBoldNote: . f@E EquationEquationNumber E:(EQ ). f@ Text. f@FA FigTitle Figure RuleF:Figure Text. f@ PageBreak. f@SQ  List1st StepNumber S:.\tList. Hf@@  ReportPurpose Figure Rule Figure RuleText. f@XQ  ExampleTitleX:Example Code. Hf@@ ReportAuthor ReportPurpose. Hf@@ - ReportPurpose Figure Rule Figure RuleText. f@1 TableHead. f@2 TableHead. Hf@@. ReportAuthor ReportPurpose. @@Na   TableTitleFigureN:TableText. @@Na  TableTitleFigureN:TableText.   zV   Bold   BulletSymbol    StepNumber{>  zV Bold  Command  Variable 3Callout  Emphasis3EquationNumber EquationVariables$  FirstLetter  Small Cap StepNumber  Symbols     Command    Function   Command  ;co  BulletSymbol " {>    {>   "    Command  Emphasis  @Z@Z@@Z@ThinMediumDoubleThick@ Very Thin YF33QQF33QQF33QQF33QQF33QQ Table6colYWQQWQQWQQWQQ Table4colX3,!!!H!!! TabularList YSSSS Table2colComment;PSV Y \ _be T j  ! #"%$)GM&U('c*),+.-r0/2143+65E87]:9<;>=@? BA!DC"FE#HG$2JI%LK&NM'PO(8RQ)TS*VU+XW,ZY-\[.O^]/``_0nba1dc2fe3hg4ji5lk6nm7po86rq9ts:vu;d BlackT!WhiteddARedddGreendd BluedCyandMagentad YellowHeader/Footer $1Header/Footer $1Header/Footer $2Header/Footer $2IndexIndexCommentCommentSubjectSubjectAuthorAuthorGlossaryGlossaryEquationEquation Hypertext Hypertext  Cross-Ref Cross-Ref Conditional TextConditional TextPositionFMPrivatePositionFMPrivateRangeEndFMPrivateRangeEndFMPrivate HTML Macro HTML Macro M.Avant Garde.PAvantGarde-Book FrameRoman M.Palatino.PPalatino-Roman FrameRoman M.Courier.PCourier FrameRoman M.Times.P Times-Roman FrameRomanM.B Avant Garde Demi.PAvantGarde-Demi FrameRoman M.Helvetica.BHelvetica-Bold FrameRoman M.Courier.B Courier-Bold FrameRoman M.Palatino.B Palatino-Bold FrameRoman M.Palatino.IPalatino-Italic FrameRoman M.Times.I Times-Italic FrameRoman FrameRomanM.I Avant Garde BookOblique.PAvantGarde-BookOblique FrameRoman' Avant Garde Courier HelveticaPalatinoSymbolTimes%Regular%BookRoman Regular MediumDemiDemiboldBoldRegular ObliqueItalicXhނӝAa&Lᒝno<IDSA;Q}Bmloܝx}{"q%,i>51ȞA1ªX0 . <. ( >0 2$ :, 2$ . <.  Zd