@MAIN HEAD = VP Roundup @CREDITS = Copyright <189> 1991 @CREDITS = by Peter Donnelly @CREDITS = 1301 Ryan Street @CREDITS = Victoria BC Canada V8T 4Y8 @SECTION HEAD = Introduction VPROUNDUP is an affordable, easy-to-use program that helps you manage Ventura Publisher chapters and style sheets. The program's main features: @BULLET = Automatically catalogs chapters and stylesheets in selected directories or on the entire hard disk. @BULLET = Copies a chapter to another directory or an archive disk and updates the chapter pointers. Can copy the stylesheet without bringing along the width table, and can override incorrect pointers. @BULLET = Lists all component files of a chapter, and shows the contents of text files. @BULLET = Deletes a chapter and all associated files. @BULLET = Cross-references chapters and stylesheets so you can easily identify chapters that use a certain stylesheet. @BULLET = Finds and deletes unused stylesheets. @BULLET = Lists paragraph tags within a stylesheet, with font and alignment information. @BULLET = Finds and deletes unused tags in a stylesheet. All chapters that use the stylesheet are checked. @BULLET = Copies a tag from one stylesheet to another. @BULLET = Changes typefaces and point sizes globally within a stylesheet. @BULLET = Makes global changes to paragraph typography, e.g. to enable automatic pair kerning in every tag. VPROUNDUP works equally well with the GEM and Windows editions of Ventura Publisher, and has been tested with versions 2.0 through 4.0. At present it does not support version 4's use of object linking and embedding, and should not be used for management of chapters that employ OLE. @SECTION HEAD = The interface The program uses a Turbo Vision interface that is very similar to GEM and Microsoft Windows. It can be used with or without a mouse. Some of the menu choices have shortcut function keys, which are shown on the menus. Menu choices and buttons can be activated by pressing Alt plus the highlighted letter. Striking Enter always activates the highlighted button. In dialog boxes, move from field to field with Tab and Shift-Tab, or by clicking on the field or label with the mouse. If you're not using a mouse, you can move the highlight from checkbox to checkbox with the arrow keys, and toggle checkboxes with the space bar. In input boxes, a block-shaped cursor indicates overtype mode and an underline indicates insert mode. You can switch modes with the Ins key. Highlight text by clicking on the field's label, by double-clicking on the text in the box, or by dragging across selected text with the mouse. The Del key deletes highlighted text; as well, any highlighted text is deleted when you start typing in insert mode. In lists, you can move the highlight with the scroll bar or the arrow keys, or by clicking or dragging with the mouse. Home moves the highlight to the top of the box and End to the bottom; PgUp and PgDn move a new part of the list into the box; Ctrl-PgUp and Ctrl-PgDn go to the top and bottom of the list. In most lists you can select an item by double-clicking on it. You can move a dialog box by dragging on the top border. To close a dialog box, click on OK or Cancel or the little box in the upper left corner, or strike the Esc key. Where there is a choice of OK or Cancel, selecting OK retains any changes made within the dialog box; otherwise they are discarded. Quit the program by striking Alt-X or through the Program menu. @SECTION HEAD = Installation and setup Install VPROUNDUP by copying ROUNDUP.EXE to any directory on your hard drive. If you are using a version of DOS earlier than 3.0, you must change to the VPROUNDUP home directory before calling the program; otherwise you can call it from anywhere, as long as you provide DOS with the path in the usual way. @SUBHEAD = Set preferences You may want to change the default colors under Program: Preferences<193> The gray-scale option provides a somewhat more legible screen on the full-page monitors often used with Ventura. In the same dialog box, click on Auto catalog if you want the file catalog to be recompiled automatically each time you run the program. @SUBHEAD = Set paths and make catalog Before using the program you need to create a catalog of Ventura chapters and stylesheets. Refer to the following section for details. @SECTION HEAD = Catalog menu @SUBHEAD = Paths<193> This menu choice allows you to specify the directories that will be searched when VPROUNDUP compiles its catalog of chapters and stylesheets. In the first two fields you can enter any number of directories and subdirectories, separated by a semicolon, for a total of up to 255 characters. If the length of the path exceeds the width of the input box, an arrow will appear and you can scroll the text by clicking on this arrow, or with the usual cursor-movement keys. To cause the program to search all subdirectories of a directory (to any level), put a backslash and an asterisk after the directory name. For example: @COURIER = C:\*;D:\* causes all of drives C and D to be searched; and @COURIER = C:\TYPESET;C:\VENTURA\*; causes the TYPESET directory, the VENTURA directory, and all subdirectories within the VENTURA directory to be searched. Note that the final semicolon is optional. If you wish to set identical paths for stylesheets and chapters, click on Same after filling in the first field. Click on Reset to restore the paths to what they were when the program was loaded. This feature is handy for those occasions when you have changed the paths in order to work with chapters on a floppy disk or in a seldom-used directory, but do not want the new paths to be saved as the default. If you plan to use VPROUNDUP to find and delete unused style sheets or tags, it's obviously wise to make certain that the chapter catalog is comprehensive. The certainty that no stray chapters have been overlooked may be worth the extra time spent in searching the entire disk rather than just selected directories. Before closing the dialog box, make sure the correct drive letter for your VENTURA directory is entered in the last field. This is the drive where the program will look for OUTPUT.WID or ENVIRON.WID in the event that it cannot find the width table referenced by a stylesheet. (If it is unable to find a width table at all, you will not be able to see the typeface names for the paragraph tags.) It is also the drive where it will look for a stylesheet referenced by a chapter when the reference does not contain a drive letter. Click on OK to save the paths without further action. Choose Make catalog to save the paths and immediately build the catalog. The path settings are saved to disk when you quit the program and automatically reloaded in your next session. @SUBHEAD = Make When you choose Catalog: Make from the main menu or click on Make catalog in the paths dialog, the program compiles a list of files with the extensions <169>.STY<170> and <169>.CHP<170> in the search path. Style sheets are checked for the Ventura version number, so that STY files from other programs such as Microsoft Word are excluded. The catalog files, VPSTYLES.CAT and VPCHAPS.CAT, are in ASCII format and can be printed through DOS or another program. @SECTION HEAD = Chapters menu Select All<193> to see a list of all chapters in the catalog, or From stylesheet<193> to get a list of the chapters that use the selected stylesheet, if one has been selected. Highlight a chapter and make one of the following choices by clicking on the appropriate button. (Double-clicking on a chapter name activates the Info button for that chapter. The other buttons are available only on the complete chapter list.) @SUBHEAD = Info Clicking this button brings up certain information about the chapter, starting with the date and time when the chapter was last saved. If there is a CIF file, dates and times are given for the creation of the chapter and for the last time the chapter was archived with Ventura's Copy All or with VPROUNDUP. (If the <169>Archived<170> timestamp is the same as <169>Created<170>, the chapter has not been archived.) Also shown is a list of the files that make up the chapter, including the stylesheet and any CAP, VGR, CIF, and external text or graphics files. The size in bytes and the date and time are given for each file. You can examine the contents of any text file (including the CAP file) by highlighting the name and clicking on Read, or by double-clicking on the file name. The first 100 or so lines of the file are displayed, and the name of the file and its word-processing format are given at the top of the frame. Scroll through the text with the usual cursor keys or the scroll bar. When done, close the frame with Esc or by clicking on the little square. Some effort is made to convert the various file formats to a plain ASCII display, with tabs shown as right-pointing arrows. However, you may see bad line breaks or odd characters in the text. The Read function is provided as a handy way of checking on the subject matter of files, not as a full-scale text viewer. DCA format is not supported at all. Another button on the chapter information screen lets you Erase the highlighted file. The file is deleted from disk but the CHP file is not updated. When you next load the chapter into Ventura you will be warned that the file is missing, and at the next save it will be removed from the chapter's file list. The Erase option should be exercised with caution; it is mostly useful for getting rid of files that you know are not actually used in the chapter, such as the empty files that are sometimes created when you accidentally click on the underlying page in text mode. @SUBHEAD = Style This button brings up the name of the stylesheet used by the chapter. If the stylesheet is in the catalog, you are given the option of selecting it for examination and processing. Selecting the stylesheet also closes the chapter list and returns you to the main menu. @SUBHEAD = Delete You are prompted to confirm that you want to delete the chapter and all its component files. If you select Ask, you are given the choice of retaining the stylesheet and any external text or graphics files used by the chapter. Be careful: no warning is given if a stylesheet or other file is used by another chapter in the catalog. When the program deletes an imported graphics file, it also deletes any IMG or GEM file that Ventura created when converting the image. If chapters and stylesheets have been deleted, the disk catalogs are updated when you exit VPROUNDUP, unless you have Auto catalog selected, in which case they are rebuilt the next time you run the program. @SUBHEAD = Copy In the Destination directory box, enter a complete directory path but no chapter name, e.g. <169>C:\VENTURA\REPORTS<170>. To copy to the root directory, enter the drive as <169>A:\<170>; if you omit the backslash, the chapter will be copied to the current directory. Clear the checkbox if you do not want to copy the stylesheet; the chapter will continue to point to the stylesheet in its original location. You can copy any chapter, not just one in the catalog. To copy an uncatalogued chapter, first select any file from the list, then change the name of the Chapter to copy in the dialog box. This procedure can be handy for transferring chapters from floppy disk. New copies of chapters and stylesheets will not appear in VPROUNDUP's lists until you have rebuilt the catalog. The chapter copy feature works like Ventura's Copy All, but with the following differences: 1.<+>All files that form part of the chapter are copied to the same directory, except for the stylesheet, which optionally can be left where it is, and the width table, which is never copied. 2.<+>The destination directory must already exist. 3.<+>Any existing files with the same names in the destination directory are overwritten without warning. 4.<+>You cannot copy to the directory that already holds the CHP file. (If you want to get around this, in order to consolidate all the chapter's files in a single directory, you can copy to another directory and then back again.) 5.<+>If the program cannot find a stylesheet or a text or graphics file in the directory pointed to by the chapter, it will look for it on the same path as the CHP file. Thus you can use VPROUNDUP to copy a chapter even when the pointers are incorrect. You are warned whenever the program cannot find a file in the expected place and substitutes one from the CHP path. If any files cannot be found at all, you are warned that the chapter may be incomplete. An example of point 5 may be helpful. Suppose you have archived FOO.CHP onto a diskette in drive B, using either Ventura's Copy All or VPROUNDUP. The chapter now expects to find all its external files on drive B. You then wish to copy the chapter onto the hard disk of a computer that will accept the diskette only in drive A. You enter <169>A:\FOO.CHP<170> in the Chapter to copy field. VPROUNDUP looks for the stylesheet and text and graphics files first on drive B; failing to find them, it gets them from drive A and warns you that a change has been made. Once all files have been copied to the hard drive, of course, the pointers are updated and the chapter will load properly. This feature even lets you copy and fix up chapters that have been copied with DOS, as long as all components are in a single directory. But it's dangerous to do this, as the old pointers may point to unwanted versions of files, or cause confusion in other ways. It remains bad practice to copy chapters with the DOS copy command. @SECTION HEAD = Stylesheets menu @SUBHEAD = Select<193> This choice brings up a list of all stylesheets in the catalog. To select one for viewing and processing, highlight it and click on Select, or double-click on the name. When a stylesheet has been selected, the name of the stylesheet appears at the top of the frame, followed by <169>(R-O)<170> if it is a read-only file. A list of paragraph tags and other information appears on the screen and remains there until another stylesheet is chosen or the current one is deleted from the disk. The main menu remains active after you have selected a stylesheet, and dialog boxes can be opened over the tag list. You can move any dialog box out of the way in order to refer to the tag list (by dragging the top border with the mouse), but you cannot scroll the list or highlight a different tag as long as a dialog box is open. The typeface names in the tag list are taken from the width table referenced by the stylesheet, or from the default OUTPUT.WID or ENVIRON.WID if the referenced width table could not be found. (The name of the width table from which the typeface names are taken is given above the tag list, followed by a question mark if the referenced width table was not found.) If no width table could be found, or if a typeface used in a tag is not found in the width table, the name of the typeface appears as a series of question marks. To the left of each typeface name is the number used by Ventura to identify the face. At the right, the size of the font is given in points. The last item on the line describes the paragraph alignment. If you switch between scalable and bitmapped fonts, you may occasionally see a non-existent half-point size listed for a bitmapped font, e.g. 10.5 instead of 10. This is because the stylesheet <169>remembers<170> half-points even when a font is changed to a face that exists only in whole-number sizes. Ventura ignores the fraction when using a non-scalable font, and you can do the same. @SUBHEAD = Find unused<193> This menu choice cross-references all chapters and all stylesheets in the catalog and then displays a list of unused stylesheets. Highlight the name of any stylesheet you wish to delete and click on the Delete button. If you first want to check the date or examine the list of tags, make the stylesheet active by clicking on Select or by double-clicking on the name. To delete an unused stylesheet after selecting it, choose Chapters: From stylesheet<193> or Tags: Find unused tags<193>, either of which will bring up the appropriate prompt. @SECTION HEAD = Tags menu @SUBHEAD = Copy one<193> To copy a tag from the currently selected stylesheet to another one in the catalog, highlight the tag and choose Tags: Copy one<193> Now select another stylesheet from the list that appears. If the tag name already exists in the destination stylesheet, you are prompted either to replace the existing tag (by clicking Yes) or to create a new tag with a different name (by clicking Rename). If you select Cancel, the tag will not be copied. If you get a <169>Stylesheet version mismatch<170> error, it means you are attempting to copy tags between stylesheets that were saved with different versions of Ventura Publisher. You can convert the older stylesheet by loading it into your current version of Ventura and then saving it. @SUBHEAD = Faces<193> The Faces dialog lets you change one typeface to another throughout the selected stylesheet. You see two lists of typeface names, with their identity numbers. On the left are all the faces used in the stylesheet; on the right are all faces available in the width table, in the same order as in Ventura's font list. Select a face from each list by clicking on it. (If you're not using a mouse, you can move the highlight from one list to the other with the Tab key.) When you close the dialog and confirm that you want to update the stylesheet, the typeface selected from the left-hand list will be changed to the one selected from the right-hand list, in every tag where it occurs. Font attributes<|><197><|>italics etc.<|><197><|>and sizes are not affected, unless they do not exist for the new typeface, in which case Ventura will change them the next time it loads the stylesheet. If the Tags: Faces<193> pick is not available even though a stylesheet has been selected, it means that no width table was found for the stylesheet. @SUBHEAD = Sizes<193> This menu item brings up a list of all point sizes that occur in the stylesheet. Move the highlight to a size that you want to change in every tag where it occurs. Then click on the input box (or strike Tab) and enter the desired size. You can enter any point size in half-point increments up to 254; but note that if your width table or printer does not support the size you enter, the results in Ventura will be unpredictable. @SUBHEAD = Typography<193> Through this menu choice you can alter certain typographical features of every tag. The default settings in the dialog box are taken from the Body Text tag in the selected stylesheet. If you click on OK without changing any of the settings, all tags will be made to conform to the Body Text settings. For each typographical feature you have the option of leaving the setting Asis, meaning that the setting will not be changed in any tag. Thus you can standardize hyphenation, for example, without disturbing individual settings for tracking or other features. To turn hyphenation on, select Method#1 or Method#2. These methods refer to the two selections offered under Ventura's Paragraph: Alignment: Hyphenation menu, e.g. USDICT and USENGLSH. Normally you will want to choose Method#1. If you turn on letter spacing, enter a value in the input box below the buttons. This value is ignored if you have selected Asis or Off. To change tracking in every paragraph, select Tighter or Looser and enter a value in the input box below the buttons. This value is ignored if you have selected Asis. If you want to make a global change to any of the space widths, you must enter the desired value in the input box at the right and ensure that there is an X in the check box. An unchecked box is equivalent to a choice of Asis for that space width. @SUBHEAD = Find unused tags<193> This option compiles a list of unused tags by searching all text and caption files belonging to all catalogued chapters that use the selected stylesheet. You are then offered the choice of removing unused tags from the stylesheet. VPROUNDUP will recognize paragraph tags in text saved in most word processor formats supported by Ventura Publisher. DCA and MultiMate are exceptions; files in these formats will not be searched for tags, and you will see the warning <169>Unsupported formats encountered.<170> Non-keyboard characters (e.g. accented vowels) within tags may also cause problems. If you see the warning <169>Text file(s) for [chapter name] missing,<170> one or more files do not exist where the chapter expects to find them. You can proceed with deleting unused tags, but it may be unwise to do so without first loading the chapter into Ventura to see what has gone missing. Note that Ventura's generated tags (e.g. Z_HEADER and Z_EQUATION) never appear in the list, even though they may be unused. To remove a tag, highlight it and click on Delete. To delete all tags in the list, click on All in the prompt box that appears. @SECTION HEAD = Technical support The author is pleased to respond to any questions, bug reports, or requests for new features when these come from registered owners of the program. If you have not already registered, please enclose a check or money order for $25 with your letter. Peter Donnelly can also be reached on CompuServe (76217,2177). @SECTION HEAD = Acknowledgments Ventura Publisher is a trademark of Ventura Software Inc., whose assistance is gratefully acknowledged. VPROUNDUP was developed with Turbo Pascal and Turbo Vision, products of Borland International.