@MAIN HEAD = VP ROUNDUP @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 Xerox Ventura Publisher version 2 or 3 chapters and style sheets. The program's main features: @BULLET = Automatically catalogs chapters and style sheets in selected directories or on the entire hard disk. @BULLET = Cross-references chapters and style sheets so you can easily identify a chapter's style sheet, or what chapters use a certain style sheet. @BULLET = Finds and deletes unused style sheets. @BULLET = Lists style tags within a style sheet, with font and alignment information. @BULLET = Copies a tag from one style sheet to another. @BULLET = Changes one typeface to another in every tag in a style sheet. @BULLET = Makes global changes to paragraph typography, e.g. to enable automatic pair kerning in every tag. @BULLET = Copies a chapter to another directory or an archive disk and updates the chapter pointers; can copy the style sheet without bringing along the width table. @BULLET = Deletes a chapter and all associated files. References to Ventura Publisher in this manual are to the GEM edition. Names of dialog boxes etc. may differ in the Windows version. VPROUNDUP should work equally well with either edition of Ventura. @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. Most 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. In dialog boxes, clicking on Cancel or the little box in the upper left corner, or striking the Esc key, discards any changes made. Striking Enter activates the highlighted button. 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. 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 button to button or 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. 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 style sheets. 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 style sheets. 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 plan to use VPROUNDUP to find and delete unused style sheets, it's obviously wise to make certain that the chapter catalog is comprehensive. The certainty that no stray chapters have been overlooked is well 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 is entered in the last field. This is the drive where the program will look for \VENTURA\OUTPUT.WID in the event that it cannot find the width table referenced by a style sheet. (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 style sheet referenced by a chapter when the reference does not contain a drive letter. 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, 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, STYLES.CAT and CHAPTERS.CAT, are in ASCII format and can be printed through DOS or another program. @SECTION HEAD = Chapters menu @SUBHEAD = Find style sheet<193> This menu pick brings up a list of all the chapters in the catalog. To find out what style sheet a chapter uses, highlight the name and click on OK. If the filename that appears is in the style catalog, you are offered the option of selecting the style sheet for examination or processing. @SUBHEAD = Delete<193> To delete a chapter and all related files, highlight the name in the catalog list and click on OK. You are now given the choice of cancelling the deletion or going ahead with or without prompting. If you select Ask, you are given the choice of not deleting the style sheet and any external text or graphics files used by the chapter, but the CHP, CAP, CIF, and VGR files will be deleted without prompting. Be careful, as no checking is done to see if a style sheet or other file is used by another chapter in the catalog. When deleted, a chapter is removed from the list for this session (as is its style sheet if you have chosen to delete it), but the catalog is not updated. If you do not have Auto catalog selected, you will be prompted to update the catalog when you quit the program. @SUBHEAD = Copy<193> To copy a catalogued chapter and all related files, highlight the name and click on OK. 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 style sheet; in this case, the chapter will continue to point to the style sheet 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. 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 style sheet, which optionally can be left where it is. 2.<+>The destination directory must already exist. 3.<+>Any existing files with the same names in the destination directory are overwritten without warning. 4.<+>The width table is never copied. 5.<+>You cannot copy to the directory that already holds the CHP file. (If you really want to get around this, in order to consolidate all the chapter's files in a single directory, you can always copy to another directory and then back again.) If the program cannot find a text or graphics file referenced by the chapter, it will warn you that the chapter may be incomplete. However, it will not detect missing CAP or VGR files. @SECTION HEAD = Styles menu @SUBHEAD = Select style sheet<193> This choice brings up a list of all style sheets in the catalog. To select one for processing, highlight it and click on Select, or double-click on the name. The name of the selected style sheet appears on the bottom line of the screen throughout the session. @SUBHEAD = Where used<193> Choose this to see a list of all chapters in the catalog that point to the selected style sheet. If there are no matches, you are offered the choice of deleting the style sheet. If you delete it, it is removed from the list for this session but remains in the disk catalog until the next update. If you do not have automatic cataloguing turned on, you will be prompted to update the catalog when you quit the program. @SUBHEAD = Find unused<193> This menu choice cross-references all chapters and all style sheets in the catalog and then displays a list of unused style sheets. Highlight the name of any style sheet you wish to delete and click on the Delete button. If you wish to examine the list of tags in the style sheet first, make it the active style sheet by clicking on Select or by double-clicking on the name, then choose Tags: View & Copy<193>. Then, if you still wish to delete the file, you can choose Styles: Where used<193> to bring up the appropriate prompt. @SECTION HEAD = Tags menu @SUBHEAD = View & Copy<193> This displays a list of all paragraph tag names in the selected style sheet, together with some additional information about the tags and about the style sheet itself. The typeface names are taken from the width table referenced by the style sheet, or from the default OUTPUT.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 at the bottom of the dialog box.) 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 tag font is given in points. The last item on the line describes the paragraph alignment. To copy a tag from the currently selected style sheet to another one in the catalog, highlight the tag and click on Copy. Now select another style sheet from the list that appears. If the tag name already exists in the destination style sheet, 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. @NOTE = Note on face ID and sizes. Those who use Ventura with more than one printer may want to read this note; others can safely skip it. @NOTE = 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 style sheet <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. @NOTE = It is useful to know the typeface ID so that you have some idea of what to expect when transferring a chapter between printers. The typeface ID is the constant in a style sheet, whereas the typeface name and even the actual face may change depending on the width table and the printer used. For example, face No. 2 is Univers on a LaserJetIII, Helvetica on a PostScript printer, and Swiss on a printer using Bitstream fonts. @NOTE = By the same token, faces that might be expected to be equivalent may not have the same ID. For instance, the Ventura driver supplied by Pacific Data Products with its Complete Font Library Cartridge does not assign the normal Palatino ID to the Palacio face, with the result that a paragraph that prints out in Palacio on the LaserJet will not be in Palatino on a PostScript printer. (The technically minded can fix this by altering the face ID in the VFM and CNF files.) @SUBHEAD = Faces<193> The Faces dialog lets you change one typeface to another throughout the selected style sheet. You see two lists of typeface names, with their identity numbers. On the left are all the faces used in the style sheet; on the right are all faces available in the width table, in the same order as in the Ventura font dialog. 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 style sheet, 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, boldface etc.<|><197><|>are not affected. The point size remains the same for each tag, unless of course that size does not exist for the new typeface, in which case Ventura will change it the next time the style sheet is used. If the Tags: Faces<193> pick is not available even though a style sheet has been selected, it means that no width table was found for the style sheet. @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 style sheet. 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 VP-GEM's Paragraph: Alignment: Hyphenation menu, e.g. USDICT and USENGLSH. Normally you will want to choose Method#1. (Users of the Windows edition should leave hyphenation Asis.) 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 the value for 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. @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.