Windows Shareware GOLD

home *** CD-ROM | disk | FTP | other *** search

/ Windows Shareware GOLD / NuclearComputingVol3No1.cdr / utils / f1165 / winprint.doc < prev next >

Wrap

Text File | 1990-08-27 | 66.8 KB | 1,893 lines

NOTE: Print this documentation with WinPrint using the following settings: Set all margins to 0.00 Choose a font and point size such that WinPrint indicates at least 78 characters per line and at least 58 lines per page. If you are using a dot matrix printer, select a font internal to your printer. For example, the internal fonts for the IBM Proprinter driver are Courier 10cpi, Courier 12cpi, and Courier 17cpi. Select Courier 10cpi to print this documentation. Make sure all headers and footer options are de-selected. (tm) W i n P r i n t Version 1.0 March 20, 1990 A Microsoft (R) Windows (tm) Based Text File Printing and Formatting Application Copyright (c) 1990, Charles E. Kindel, Jr. Kindlco Software Systems All rights reserved. WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. (tm) WinPrint "A unique solution for the control of printing ASCII files using the power of the Microsoft Windows printer interface." Written by Charles E. Kindel, Jr. Kindlco Software Systems 3000 118th Ave. SE, Suite A-203 Bellevue, Washington 98005 Electronic mail: CompuServe 71551,1455 Program and Documentation Copyright (c) 1990, Charles E. Kindel, Jr. and Kindlco Software Systems. All rights reserved. Portions Copyright 1987, 1988 Microsoft Corporation PC-DOS and PC are trademarks of IBM Corporation. MS-DOS, Windows, OS/2, and Presentation Manager are trademarks of Microsoft Corporation. Command Post is a trademark of Wilson WindowWare. Any other products mentioned are trademarks of their respective developer. ACKNOWLEDGEMENTS Special thanks to Mike Brehm for his inspiration, input, and testing. WinPrint could not have been developed without the help of Charles Petzold's book "Programming Windows"; thank you Charles. Kudos to Joel Diamond, Howard Sobel, and the rest of the WUGNET editors and contributors for their beta testing efforts and support. WinPrint is written in Microsoft C 5.1 for Microsoft Windows/286 and Windows/386 2.x and Windows 3.0. Version 1.0 of WinPrint is being distributed as a part of the WUGNET (National Windows Users Group Network) Disk Library. WUGNET is an independent resource for MS Windows and OS/2 Presentation Manager users and developers. All WUGNET Disk contributions are required to adhere to high quality and professional standards for performance, documentation, and reliability. Page i WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. DISCLAIMER The accuracy of the information contained herein and the fitness of the WinPrint program for any purpose may change without notice, and should not be construed as a commitment of any kind. No guarantee is made, expressed or implied pertaining to the use, misuse, or problems caused by this program. Page ii WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. TABLE OF CONTENTS ACKNOWLEDGEMENTS . . . . . . . . . . . . . . . . . . . . . . i DISCLAIMER . . . . . . . . . . . . . . . . . . . . . . . . ii 1 REGISTRATION INFORMATION . . . . . . . . . . . . . . . . . 1 1.1 Licensing Policies . . . . . . . . . . . . . . . . . 1 1.2 Registration Instructions . . . . . . . . . . . . . 2 2 INTRODUCTION AND GETTING STARTED . . . . . . . . . . . . . 3 2.1 Installation . . . . . . . . . . . . . . . . . . . . 7 2.2 Starting WinPrint . . . . . . . . . . . . . . . . . 7 2.3 The Help System . . . . . . . . . . . . . . . . . . 7 2.4 General Usage . . . . . . . . . . . . . . . . . . . 8 3 THE MAIN WINDOW . . . . . . . . . . . . . . . . . . . . . 9 3.1 Selecting Files to Print . . . . . . . . . . . . . . 9 3.1.1 THE "Select file spec" EDIT BOX . . . . . . . . 9 3.1.2 THE "Select" BUTTON . . . . . . . . . . . . . . 9 3.1.3 THE "List" BUTTON . . . . . . . . . . . . . . . 9 3.1.4 THE "Remove" BUTTON . . . . . . . . . . . . . 10 3.2 Printing Selected Files . . . . . . . . . . . . . 10 3.2.1 THE "Minimize While Printing" CHECK BOX . . . 10 3.2.2 THE "Close When Done" CHECK BOX . . . . . . . 10 3.2.3 THE "Draft Mode" CHECK BOX . . . . . . . . . 10 3.3 The Info Box . . . . . . . . . . . . . . . . . . . 10 3.4 Current Configuration Indication . . . . . . . . . 11 4 THE WinPrint MENU BAR . . . . . . . . . . . . . . . . . 12 4.1 THE "File" MENU . . . . . . . . . . . . . . . . . 12 4.1.1 About WinPrint... . . . . . . . . . . . . . . 12 4.1.2 Exit . . . . . . . . . . . . . . . . . . . . 12 4.1.3 Open Setup... . . . . . . . . . . . . . . . . 12 4.1.4 Save Setup... . . . . . . . . . . . . . . . . 13 4.1.5 Change Printer... . . . . . . . . . . . . . . 13 4.2 THE "Option" MENU . . . . . . . . . . . . . . . . 14 4.2.1 Text... . . . . . . . . . . . . . . . . . . . 14 4.2.1.1 Margins . . . . . . . . . . . . . . . . . 14 4.2.1.2 Expanding Tabs . . . . . . . . . . . . . . 14 4.2.1.3 Fonts and Text Styles . . . . . . . . . . 15 4.2.1.4 Multiple columns . . . . . . . . . . . . . 15 4.2.2 Headers/Footers... . . . . . . . . . . . . . 16 4.2.2.1 What Makes up a Header or Footer . . . . . 16 4.2.2.3 Fonts and Text Styles . . . . . . . . . . 16 4.2.3 F1=Help! . . . . . . . . . . . . . . . . . . 17 5 CONTROLLING WinPrint FROM THE COMMAND LINE . . . . . . . 18 5.1 Introduction . . . . . . . . . . . . . . . . . . . 18 Page iii WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. 5.2 Command Line Syntax . . . . . . . . . . . . . . . 18 5.3 Program control options . . . . . . . . . . . . . 19 5.3.1 Begin printing as soon as WinPrint opens. . . 19 5.3.2 Use a previously saved configuration. . . . . 19 5.3.3 Close when finished printing . . . . . . . . 19 5.3.4 Minimize while printing . . . . . . . . . . . 20 5.3.5 Select Printer . . . . . . . . . . . . . . . 20 5.3.6 Draft mode . . . . . . . . . . . . . . . . . 20 5.3.7 Unit of measurement used when specifying margins 20 5.3.8 Top Margin . . . . . . . . . . . . . . . . . 20 5.3.9 Left Margin . . . . . . . . . . . . . . . . . 20 5.3.10 Bottom Margin . . . . . . . . . . . . . . . . 20 5.3.11 Right Margin . . . . . . . . . . . . . . . . 20 5.3.12 Text Fontname . . . . . . . . . . . . . . . . 21 5.3.13 Text font Pointsize . . . . . . . . . . . . . 21 5.3.14 Text Style . . . . . . . . . . . . . . . . . 21 5.3.15 Header/footer Fontname . . . . . . . . . . . 21 5.3.16 Header/footer font Pointsize . . . . . . . . 21 5.3.17 Header/footer Style . . . . . . . . . . . . . 22 5.3.18 Header options . . . . . . . . . . . . . . . 22 5.3.19 Footer options . . . . . . . . . . . . . . . 22 5.3.20 Header/footers use Margin settings . . . . . 22 5.4 Examples . . . . . . . . . . . . . . . . . . . . . 22 TECHNICAL SUPPORT . . . . . . . . . . . . . . . . . . . . . 24 INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 Page iv WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. 1 REGISTRATION INFORMATION 1.1 Licensing Policies WinPrint is a commercial copyrighted program protected by both U.S. and international copyright law. You are authorized to use and evaluate it for a limited time without charge. WinPrint is distributed as shareware. This allows you to determine whether the application satisfies your needs before you have to pay for it. WinPrint may be freely copied and distributed for evaluation as long as the following four rules are followed: 1) The program and this documentation are not modified in any way, shape, or form. 2) A copy of this documentation and the files: README.DOC, WINPRINT.DOC, ORDER.FRM, and TEST.FILE are provided with each copy of the program (WINPRINT.EXE). 3) No charge, other than a media and handling charge (not to exceed $5.00), is made. 4) A user may use the program for 21 days before paying the registration fee. If the program is used after the 21 day evaluation period, an obligation to register and pay the registration fee is incurred. The registration fee for WinPrint is $20 (US Dollars). Payment of this fee entitles you to: 1) A registration number that will disable the shareware advertisements contained within the program. 2) Free upgrade to the next major version, and reduced rates on future upgrades. 3) Technical support via electronic mail. You may also purchase WinPrint on a disk with a printed manual directly from Kindlco Software Systems. See section 1.2, Registration Instructions, for more information. Site licenses are available. Contact Kindlco Software Systems for more information. Page 1 WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. 1.2 Registration Instructions At the present time registering (purchasing a license) for WinPrint may be done by mail only. If you wish to become a registered user of WinPrint enclose the following items in an envelope and mail to the address below: 1) A check for $20.00 (US Dollars) made out to Charles E. Kindel, Jr. 2) The version number of the copy of WinPrint you currently have. You can find the version number in the About... item on the WinPrint File menu. 3) Name and address. Please include both a first and last name. (A registration form is provided as the last page of this documentation. It is recommended that you use this form when registering.) Send to: Charles E. Kindel, Jr. Kindlco Software Systems 3000 118th Ave. SE, Suite A-203 Bellevue, WA 98005 For your $20.00 you will receive: 1) A special registration number that will disable the shareware advertisements contained within WinPrint. 2) Instructions on how to enter your registration number into WinPrint. 3) The latest information on Kindlco products and services. If you send $25.00 you will receive all of the above plus: 4) A disk containing the latest version of WinPrint. (Please specify 5.25" or 3.5" disk size). 5) A printed copy of the documentation. Page 2 WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. 2 INTRODUCTION AND GETTING STARTED WinPrint has been designed as a valuable tool for printing text files while using Microsoft Windows. As it is distributed, Windows provides basically one way of sending plain text files to the printer: use the Print... command in the File menu of the MS- DOS Executive. WinPrint provides a powerful alternative that will leave you wondering how you ever got along without it. For example, suppose you have five text files you have created with the Notepad editor that you would like to print. Using the MS-DOS File.Print... command you could select each file and print them. They would come out of your printer exactly as typed, but what about margins and headers and footers (with page numbers)? It just doesn't work. Well, with WinPrint, it does! Everybody who uses Windows will appreciate the features of WinPrint. If you program you can use it to obtain better source code listings. Electronic mail users will find WinPrint invaluable when printing messages they have received. WinPrint provides the following major features: Spooling WinPrint uses the Windows Spooler to effectively manage its output. You can print the largest of your files and still get other work done on your computer. Also, if you normally print to a disk file you know the Windows Spooler overwrites the print file with each new print job; WinPrint allows you to select multiple files to be printed as one job. Headers and Footers Headers and footers can be printed on each page. They can contain the name of the file, the time and date the file was last revised, the current time and date, and page numbers. Margin Control Top, left, bottom, and right margins can be set using either inches or the metric system. Page 3 WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. Font Control WinPrint allows the user to select fonts, point sizes, and print attributes such as bold, italic, and underline. Headers/Footers and the text being printed can use different fonts and attributes. Tab and Form Feed Support Many files that you might want to print on your PC contain Tab and Form Feed characters. WinPrint can be set to convert tab characters to any number of spaces, or to ignore them. WinPrint also "understands" form feeds and takes appropriate action. Multiple Saved Configurations WinPrint can save it's configuration for each type of file you print. For example you might have one configuration named "SourceCode" that would print your files with a one inch left margin for hole punches, a small font allowing 132 characters per line, and the file date in the header. At the same time you could also have a configuration named "Documentation". This configuration would be used to print shareware documentation with no margins or headers and footers. Command Line Invocation While WinPrint has a carefully crafted user interface that takes full advantage of Windows, all options can be set from the command line. This enables you to run WinPrint transparently from a program manager such as Wilson WindowWare's Command Post. On-Line Help WinPrint is equipped with on-line documentation. Complete documentation of all features is available at any time. In addition, Kindlco Software Systems is currently working on many enhancements to WinPrint. Several of the enhancements that will appear in the later versions of WinPrint are: Multiple Column Printing Save paper by printing your documents in landscape mode with two (or more) pages side by side on one sheet of paper (duplex printing). Page 4 WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. Select Font Size by Specifying Lines Per Page and Characters Per Line Currently font sizes are selected by choosing a point size for the font you want. A feature that will allow you to select the number of lines per page and the number of characters per line and WinPrint will select the appropriate point size automatically under development. DDE Support Extensive DDE (Dynamic Data Exchange) support is in the works. This will allow WinPrint to "talk" with many existing applications such as Microsoft Excel, Microsoft Word, Dynacomm, APE, and many more! Filters The ability to filter specific words and/or characters from the file being printed will be added. Multiple Files Per Page If you are printing many small files (i.e. less than a page long) WinPrint will be able to print more than one file on a page, allowing you to save paper. Custom Headers and Footers In a manner similar to Windows Write, headers and footers will be able to contain user specified strings and formatting options. Indexed Help System While the current help system is very good, Kindlco will be enhancing it by providing an interactive index. This will allow you to get help easily on a specific key word. Windows 3.0 Compatibility While WinPrint 1.0 currently works under Windows 3.0 in both real and protected modes, it has not been thoroughly tested in that environment. When Microsoft officially announces Windows 3.0, and makes developers tools available to Kindlco Software Systems, WinPrint will be completely compatible. WinPrint is a commercial software application that is distributed as shareware. This means that if you've downloaded it from a Page 5 WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. bulletin board, on-line service, or obtained it from a friend, you can try it out before you have to pay for it. Like all shareware, if you do decide to keep WinPrint, you must pay a registration fee. Only registered users will be entitled to free upgrades and technical support. Register TODAY! See part 1 of this document for registration instructions. Page 6 WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. 2.1 Installation To install WinPrint simply copy the executable file (WINPRINT.EXE) to a directory that is located on your environment path. The directory that Windows was installed in is usually a good place (C:\WIN or C:\WIN386). 2.2 Starting WinPrint The easiest way to start WinPrint is by double-clicking on the WINPRINT.EXE filename in the MS-DOS executive. It can also be started any other way you normally start Windows applications. Once WinPrint begins executing several things happen. First WinPrint checks to see if you are a registered user or not. If you are not, two windows will appear; one after the other. The first window gives you information regarding WinPrint such as the version number and registration instructions. Click on the "Ok" button to continue. The second window has two edit fields and two buttons. If you have obtained a registration number from Kindlco Software Systems for WinPrint you may enter it according to the instructions on the invoice. If you have not paid your registration fee and have not received your registration number click on the button labeled "Ignore" (But don't ignore the fact that you are using WinPrint without registering!). After WinPrint checks the registration information, it checks to see if you have used WinPrint before. If you have, the configuration WinSpit used that last time it was run is loaded. Otherwise WinPrint sets all options to their "Factory Defaults". (See sections 4.1.3 and 4.1.4 for details.) WinPrint can also be started with command line options. See section 5 for more information. 2.3 The Help System The help system, like the rest of WinPrint, has been designed to be easy to use yet powerful. To activate the help system press the F1 key or click on the F1=Help! menu item. Then, to get help on any of the menu items provided by WinPrint, simply select that menu item in the "WinPrint Help" window. When the help window appears, it contains help on the WinPrint main window. To obtain general information about WinPrint select the WinPrint Info menu item. Page 7 WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. To get help on command line options, choose the Cmd Line menu item. To return to the main window help select "F1=Help!" again. Section 4.2.3 contains more information on the help system. 2.4 General Usage WinPrint may be operated in either an interactive or "command line" mode. The interactive mode is used when WinPrint is opened as a window. Files and options are selected using push buttons, list boxes, and other Windows gadgets. The instructions for using the main WinPrint window are given in section 3. The command line mode comes into play when the user specifies files and options on the command line, either through the MS- DOS Executive Run... command or via a Windows application manager such as Command Post. WinPrint's command line syntax is detailed in section 5. Page 8 WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. 3 THE MAIN WINDOW When WinPrint opens you are presented with a window that contains several items that allow you to control WinPrint. The main window is split into three boxes. The box on the left is used to select and de-select the files that are to be printed by WinPrint. The box on the right allows you to see what files are selected for printing, start printing, and allows you to change options. Near the bottom of the main window is a box that WinPrint uses to display useful information about the current settings. 3.1 Selecting Files to Print WinPrint has been designed to allow you to print several files at once. Files may be selected for printing in one of several ways. The main window controls used in selecting files are explained below. 3.1.1 THE "Select file spec" EDIT BOX This edit box contains the file specification that is to be either selected for printing or listed. The file specification in this box affects the operation of both the "Select" and "List" buttons. If the "Select file spec" edit box contains a file specification with DOS wildcards in it then the "List" button will be enabled. 3.1.2 THE "Select" BUTTON Clicking on this button will cause the file specification contained in the "Select file spec" edit box to be selected for printing. If the file specification contains wildcards all files in the specified directory matching the wildcard will be selected for printing. If the file specification is simply a filename, then just that file will be selected for printing. If the "Select file spec" edit box is empty this button will be disabled. 3.1.3 THE "List" BUTTON This button will use the file specification in the "Select file spec" edit box to change to contents of the current file list box (on the left). The "List" button only has an affect when the file specification has a wildcard in it or indicates a change in the current directory or drive. Page 9 WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. 3.1.4 THE "Remove" BUTTON If any files have been selected and appear in the selected files list box you may use this button to un-select them. This button will be disabled if there are no selected files. 3.2 Printing Selected Files After one or more files have been selected (i.e. they appear in the list box to the right) clicking on the "Print Selected Files" button will initiate the printing. The files will be printed in the order they appear in the selected files list box. There are several options for controlling how WinPrint will behave during and after the print process. These options are described below. 3.2.1 THE "Minimize While Printing" CHECK BOX If this check box is checked WinPrint will minimize (iconize) itself as soon as the "Print Selected Files" button is pushed. This allows you to automatically get WinPrint out of your way while it is printing. 3.2.2 THE "Close When Done" CHECK BOX This check box controls whether or not WinPrint will close itself (quit) after it has finished printing the selected files. If this box is checked when the "Print Selected Files" button is pushed, WinPrint will automatically close when it has finished printing the selected files. 3.2.3 THE "Draft Mode" CHECK BOX If this check box is checked, WinPrint will attempt to print your files using the fastest method the currently selected printer allows. This option is only useful if you are printing to a dot matrix printer. 3.3 The Info Box Along the bottom portion of WinPrint's main window you will notice a box containing information concerning the currently selected fonts. This box gives you an indication of how many characters will fit on a page using the currently selected fonts and the currently selected printer. Page 10 WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. 3.4 Current Configuration Indication The title bar is used to display the name of the current configuration. The configuration name is displayed in the form "WinPrint - [config name]". If any changes are made to the currently loaded configuration, and not saved, the "-" will change to a "*". Page 11 WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. 4 THE WinPrint MENU BAR 4.1 THE "File" MENU 4.1.1 About WinPrint... This menu item is used to get information about WinPrint. You can find the address of KindlCo Software Systems, the version number of this copy of WinPrint, and your registration information here. 4.1.2 Exit If you choose this menu item the WinPrint window will close. If you have changed any settings and have not explicitly saved them, WinPrint will ask you if you want to save your settings before it quits. 4.1.3 Open Setup... If you choose this menu item you will be presented with a dialog box containing a list of currently saved configurations plus a selection for resetting all options to their "Factory Defaults". Select the configuration you wish to load and click on the "Open" button to open that configuration. The "Cancel" button allows you to exit the Open Configuration dialog box without opening a saved configuration. When you open a configuration the name of the currently selected configuration is saved in the WIN.INI file. Next time you start WinPrint, the most recently used configuration will be loaded. Page 12 WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. 4.1.4 Save Setup... If you choose this menu item you will be presented with a dialog box containing a list of currently saved configurations. You may either select the name of a previously saved configuration or enter a new name in the edit box labeled "Save configuration name". Select the name of configuration you wish to save and click on the "Save" button to save the current configuration. The "Cancel" button allows you to exit the Save Configuration dialog box without saving your configuration. When you save a configuration the name of that configuration is saved in your WIN.INI file. Next time you start WinPrint the most recently used configuration will be loaded. 4.1.5 Change Printer... This menu item allows you to change the printer that WinPrint will print to. When you choose this menu item, WinPrint will present you with a list of currently available printers. Choose the printer you want to use and click on the "Ok" button. At this point you will have the opportunity of setting printer specific options such as landscape printing. If you do not want to change you current printer, simply click on the "Cancel" button. Note that, although the current printer is saved as part of WinPrint's configuration, the default printer for Windows is not changed by this option. Page 13 WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. 4.2 THE "Option" MENU 4.2.1 Text... This menu item invokes a dialog box that allows you to specify exactly how you want your printouts to appear. 4.2.1.1 Margins WinPrint measures it's page margins from the edge of the printed page inward. WinPrint allows you to set top, left, bottom, and right margins. All margins are set to 0.00 inches by default. The margin settings may be specified in either inches or centimeters by using on the radio buttons labeled "Units". The default setting is in inches. Often the area of a physical page is larger than the printed page. For example an Apple LaserWriter IINTX usually prints on paper that measures 8.5x11 inches. If WinPrint's margin settings are all set to 0.00" you would find that your printouts actually had margins of about 0.25". It is a good idea to test how your printer handles its printed page by printing the file TEST.FIL that is provided with WinPrint using 0.00" margins. 4.2.1.2 Expanding Tabs WinPrint can be set to either expand any tab characters it finds in the input file to spaces or send the tab characters to the printer driver. You may choose the number of spaces used for tab expansion. Different printer drivers handle tab characters in different ways. The file TEST.FIL included with WinPrint has several lines with imbedded tabs. To see how your printer handles tabs, print this file with tab expansion both on and off. Page 14 WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. 4.2.1.3 Fonts and Text Styles Near the bottom of the Text Option dialog box is a group of check boxes and a button that allow you to change the font, font point size, and style (bold, italic, and underline) of the printed text. If you click on the button labeled "Fonts..." you will be presented with a dialog box in which you may choose from any of the fonts and font point sizes available on the current printer. If the font you select can be continuously scaled (i.e. made any size) you may enter a specific point size in the edit box provided. Some printers are capable of printing both their internal fonts and fonts specific to Windows. If your printer is relatively slow, such as a dot-matrix printer, it is recommended that you use fonts that are internal to the printer. Otherwise, Windows has to draw each page as a graphic image which can slow the printing process considerably. 4.2.1.4 Multiple columns Version 1 of WinPrint does not support printing with multiple columns. The next version will. Register today to receive free upgrades! Page 15 WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. 4.2.2 Headers/Footers... WinPrint allows you to customize your printouts with an assortment of Header and Footer options. This menu item brings up a dialog box that allows you to specify those options. 4.2.2.1 What Makes up a Header or Footer Headers and footers can be composed of the name of the file being printed, the date and time that file was last revised or the current date and time, and the current page number. The format of headers and footers is as follows: - Aligned to the left is the pathname and filename of the file. - Centered is either the date and time the file was last revised or the current date and time. - Aligned to the right is the page number. 4.2.2.2 Changing Headers/Footers To set or change the header/footer options use the check boxes labeled "headers" and "footers". If the "Date" check box is not checked, the "date revised/printed" radio buttons will be disabled. When the "Date" check box is checked you can use the "date revised/printed" radio buttons to choose whether you want the header/footer to contain the date the file was last revised or the current date. If you check the "Use margins settings..." check box headers and footers will be printed within the left and right margins you have set. If this check box is not checked, headers and footers will be printed within the left and right margins of the physical page as defined by your printer. This check box is checked by default. 4.2.2.3 Fonts and Text Styles Near the bottom of the Header/Footer dialog box is a group of check boxes and a button that allow you to change the font, font point size, and style (bold, italic, and underline) of your headers and footers. Page 16 WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. If you click on the button labeled "Fonts..." you will be presented with a dialog box in which you may choose from any of the fonts and font point sizes available on the current printer. If the font you select can be continuously scaled (i.e. made any size) you may enter a specific point size in the edit box provided. Some printers are capable of printing both their internal fonts and fonts specific to Windows. If your printer is relatively slow such as a dot-matrix printer, it is recommended that you use fonts that are internal to the printer. Otherwise, Windows has to draw each page as a graphic image which can slow the print process down considerably. If no font has been explicitly set by the user, WinPrint will attempt to use a Courier font. 4.2.3 F1=Help! By either pressing the F1 key or clicking on the F1=Help! menu item you will invoke WinPrint's on-line documentation system. A window will appear with a menu bar with the same items as the WinPrint main window. In addition there is a "Cmd Line" menu item. To get help on any WinPrint feature simply select the menu item corresponding to that feature. For help on the command line options supported by WinPrint select the "Cmd Line" menu item. General help on WinPrint and help on the main window is initially displayed when the help window opens. If you wish to return to the general help information after seeking another help topic, simply click on the "F1=Help!" menu item again. The WinPrint Help Window can be left open while you continue to work with WinPrint. To close the help window select "Close" from the help window's system menu. Page 17 WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. 5 CONTROLLING WinPrint FROM THE COMMAND LINE 5.1 Introduction One of WinPrint's most useful features is its ability to be completely controlled from the command line. Typically, Windows applications are started by double-clicking on the file name in the MS-DOS Executive window. But many program managers have been developed that allow you to select programs with icons or menus. Wilson WindowWare's Command Post is a good example of such a product. WinPrint's command line options allow you to easily integrate WinPrint into one of these program managers. 5.2 Command Line Syntax The following syntax and rules are used by WinPrint when invoked from the command line. All options must be prefixed with a slash ("/"). Anything on the command line that is not prefixed with a slash will be interpreted as a filespec. Filespecs are any valid DOS file specifications, including the wild card characters "?" and "*". Angle Brackets ("<" and ">") delimit required arguments. For example the Text font point size option, /TP:<n>, requires an integer value following the colon (":"): /TP:10 This would tell WinPrint to use a 10pt font size. Note the angle brackets are not included on the command line. Square Brackets ("[" and "]") are used to delimit optional arguments. An ellipsis ("...") indicates that the previous argument may be repeated. For example the standard usage for WinPrint is [/opt1 [/opt2]...] [filespec1 [filespec2]...] Thus zero or more options may be specified, followed by zero or more filespecs. Page 18 WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. Curly Braces ("{" and "}") delimit an argument that is required but may have two or more possible values. Each possible value is listed within the curly braces. One, and only one, of the values may be used for each option. For example the /C{+,-} option may take either of the following forms, but not both: WinPrint /C+ WinPrint /C- Note that the curly braces are not included on the command line. The following is the general syntax for starting WinPrint from the command line: WinPrint [/opt1 [/opt2]...] [filespec1 [filespec2]...] 5.3 Program control options 5.3.1 Begin printing as soon as WinPrint opens. /GO If this options is specified on the command line, WinPrint will begin sending the selected files to the printer immediately. This is very useful when starting WinPrint via a program manager such as Command Post. 5.3.2 Use a previously saved configuration. /S:<configuration name> Where <configuration name> is the name of a configuration saved with the File.Save Setup... menu item. All command line options, except /GO, that precede the /S: option will be ignored. Options specified after the /S: option will override the appropriate setting within the configuration specified. If the configuration name contains spaces it must be enclosed in quotes. 5.3.3 Close when finished printing /C{+,-} This option duplicates the checkbox in the WinPrint main window labeled Close when done. Plus (+) means checked/on, minus (-) means unchecked/off. Page 19 WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. 5.3.4 Minimize while printing /M{+,-} This option duplicates the checkbox in the WinPrint main window labeled Minimize while printing. Plus (+) means checked/on, minus (-) means unchecked/off. 5.3.5 Select Printer /P:<printer name> Where <printer name> is the name of a printer that has been installed using the Windows Control Panel program. 5.3.6 Draft mode /D{+,-} This option duplicates the checkbox in the WinPrint main window labeled Draft Mode. Plus (+) means checked/on, minus (-) means unchecked/off. 5.3.7 Unit of measurement used when specifying margins /U:{IN,CM} For each of the margin switches given below, n is a real number specifying units of measurement in either inches or centimeters as determined by the /U:{IN,CM} option. The /U: option must precede any of the margin options on the command line. If it does not, the default unit setting will be used. 5.3.8 Top Margin /MT:<n> 5.3.9 Left Margin /ML:<n> 5.3.10 Bottom Margin /MB:<n> 5.3.11 Right Margin /MR:<n> Page 20 WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. 5.3.12 Text Fontname /TF:<fontname> <fontname> specifies the name of the font that the text being printed will appear in. If the currently selected printer does not support the specified font name, you may get unpredictable results. If a font name contains spaces it must be enclosed in quotes. 5.3.13 Text font Pointsize /TP:<n> <n> specifies the line height point size for the currently selected text font. If the current printer does not support the specified point size, WinPrint will select the closest available size. 5.3.14 Text Style /TS:{[I][U][B],N} This option allows you to select text attributes for the text being printed. You may specify any combination of [I]talic, [U]nderline, and [B]old. If you specify [N]ormal the text will be printed with normal attributes. 5.3.15 Header/footer Fontname /HF:<fontname> <fontname> specifies the name of the font for the headers and footers (if activated). If the currently selected printer does not support the specified font name, you may get unpredictable results. 5.3.16 Header/footer font Pointsize /HP:<n> <n> specifies the line height point size for the currently selected header/footer font. If the current printer does not support the specified point size, WinPrint will select the closest available size. Page 21 WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. 5.3.17 Header/footer Style /HS:{[I][U][B],N} This option allows you to select text attributes for headers and footers. You may specify any combination of [I]talic, [U]nderline, and [B]old. If you specify [N]ormal the headers/footers will be printed with normal attributes. 5.3.18 Header options /H:{[F][N][{P,R}],-} Using this option you can control what you want to appear in your headers. You may specify any combination of [F]ilename, page [N]umber, and date [P]rinted/date [R]evised. If you specify "-" headers will be turned off. 5.3.19 Footer options /F:{[F][N][{P,R}],-} Using this option you can control what you want to appear in your footers. You may specify any combination of [F]ilename, page [N]umber, and date [P]rinted/date [R]evised. If you specify "-" footers will be turned off. 5.3.20 Header/footers use Margin settings /HM{+,-} WinPrint can print headers and footers in one of two ways: within the left and right margin settings or flush with the edge of the page. If you specify /HM+, headers and footers will be printed within the current left and right margin settings. If you specify /HM-, headers and footers will be printed without left and right margins. 5.4 Examples WINPRINT /S:"Source Code" /GO WS_*.C Assuming that you have saved a configuration named "Source Code" this would start WinPrint with all of the settings of that configuration. The /GO option would cause WinPrint to immediately start printing the files in the current directory that match "WS_*.C". Page 22 WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. WINPRINT /S:Documents /GO /M+ /C+ winprint.doc This would print the file WinPrint.DOC, using the configuration settings saved under the name "Documents". WinPrint would be minimized, would start printing immediately, and would close after it printed the file. WINPRINT /M+ /C- /U:cm /ML:1.5 /tf:Courier /tp:8 *.c This would start WinPrint with the Minimize option enabled, the Close option disabled, the Left Margin set at 1.5 centimeters, the text would be printed using the Courier font at an 8pt line height. All files in the current directory ending with the ".C" extension would be printed. WINPRINT /m+ /HS:BI /H:FNP /F:R /D+ *.c *.h makefile In this example WinPrint would print all files in the current directory with either ".C" or ".H" extensions and the file named "MAKEFILE". Each page would be printed with a header (in Bold and Italic) consisting of the Filename, page Number, and date Printed. Each page would also contain a header (also in Bold and Italic) consisting of the date Revised. Page 23 WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. TECHNICAL SUPPORT Technical support for WinPrint is provided to registered users only. If you are a registered user, you can contact Kindlco Consulting for support on CompuServe in the WINAPA forum. Send Easyplex mail to 71551,1455. The standard support for WinPrint is via electronic mail, as it allows correspondence at convenient times regardless of time zones and schedules. In addition it provides a record of all communications which may be of use. Telephone support is also provided, but is discouraged at this time. It should be used only by users who do not have a modem or an account on CompuServe. Page 24 WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. INDEX /C{+,-} . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 /D{+,-} . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 /F:{[F][N][{P,R}],-} . . . . . . . . . . . . . . . . . . . . 22 /GO . . . . . . . . . . . . . . . . . . . . . . . . . 19, 22, 23 /H:{[F][N][{P,R}],-} . . . . . . . . . . . . . . . . . . . . 22 /HF:<fontname> . . . . . . . . . . . . . . . . . . . . . . . 21 /HM{+,-} . . . . . . . . . . . . . . . . . . . . . . . . . . 22 /HP:<n> . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 /HS:{[I][U][B],N} . . . . . . . . . . . . . . . . . . . . . . 22 /M{+,-} . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 /MB:<n> . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 /ML:<n> . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 /MR:<n> . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 /MT:<n> . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 /P:<printer name> . . . . . . . . . . . . . . . . . . . . . . 20 /S:<configuration name> . . . . . . . . . . . . . . . . . . . 19 /TP:<n> . . . . . . . . . . . . . . . . . . . . . . . . . 18, 21 /TS:{[I][U][B],N} . . . . . . . . . . . . . . . . . . . . . . 21 /U:{IN,CM} . . . . . . . . . . . . . . . . . . . . . . . . . 20 Cancel . . . . . . . . . . . . . . . . . . . . . . . . . 12, 13 Change Printer . . . . . . . . . . . . . . . . . . . . . . . 13 Close When Done . . . . . . . . . . . . . . . . . . . . . 10, 19 Command Line . . . . . . . . . . . . . . . . . . 4, 7, 8, 17-20 Command line invocation . . . . . . . . . . . . . . . . . . . . 4 Command Post . . . . . . . . . . . . . . . . . . i, 4, 8, 18, 19 CompuServe . . . . . . . . . . . . . . . . . . . . . . . . i, 24 Configuration . . . . . . . . . . . . . . 4, 7, 11-13, 19, 22, 23 Current Configuration . . . . . . . . . . . . . . . . . . 11, 13 Date revised/printed . . . . . . . . . . . . . . . . . . . . 16 DDE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 DOS . . . . . . . . . . . . . . . . . . . . . . . . i, 3, 7-9, 18 Dot-matrix . . . . . . . . . . . . . . . . . . . . . . . 15, 17 Draft Mode . . . . . . . . . . . . . . . . . . . . . . . 10, 20 Electronic mail . . . . . . . . . . . . . . . . . . . i, 1, 3, 24 Examples . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Exit . . . . . . . . . . . . . . . . . . . . . . . . . . 12, 13 F1=Help! . . . . . . . . . . . . . . . . . . . . . . . 7, 8, 17 Factory defaults . . . . . . . . . . . . . . . . . . . . . 7, 12 File . . . . . . . . . . . . . 2-5, 7, 9, 12-14, 16, 18, 19, 23 Filespec . . . . . . . . . . . . . . . . . . . . . . . . . . 18 Font . . . . . . . . . . . . . . . . . . 1, 4, 5, 15-18, 21, 23 Footers . . . . . . . . . . . . . . . . . . . . . 3-5, 16, 21, 22 Form feed . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Free upgrade . . . . . . . . . . . . . . . . . . . . . . . . . 1 General syntax . . . . . . . . . . . . . . . . . . . . . . . 19 Getting started . . . . . . . . . . . . . . . . . . . . . . . . 3 Headers . . . . . . . . . . . . . . . . . . . 1, 3-5, 16, 21, 22 Headers/Footers . . . . . . . . . . . . . . . . . . . . 4, 16, 22 Page 25 WinPrint, Copyright (c) 1990, Charles E. Kindel, Jr. Help . . . . . . . . . . . . . . . . . . . . . i, 4, 5, 7, 8, 17 Inches . . . . . . . . . . . . . . . . . . . . . . . . 3, 14, 20 Info box . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Installation . . . . . . . . . . . . . . . . . . . . . . . . . 7 Internal fonts . . . . . . . . . . . . . . . . . . . . 1, 15, 17 Landscape . . . . . . . . . . . . . . . . . . . . . . . . . 4, 13 LaserWriter . . . . . . . . . . . . . . . . . . . . . . . . . 14 Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 List . . . . . . . . . . . . . . . . . . . . . . . 8-10, 12, 13 Main window . . . . . . . . . . . . . . . . . . 7-10, 17, 19, 20 Margin control . . . . . . . . . . . . . . . . . . . . . . . . 3 Margins . . . . . . . . . . . . . . . . . 1, 3, 4, 14, 16, 20, 22 Metric system . . . . . . . . . . . . . . . . . . . . . . . . . 3 Minimize While Printing . . . . . . . . . . . . . . . . . 10, 20 MS-DOS Executive . . . . . . . . . . . . . . . . . . 3, 7, 8, 18 Multiple column printing . . . . . . . . . . . . . . . . . . . 4 Multiple files . . . . . . . . . . . . . . . . . . . . . . 3, 5 Notepad . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 On-line help . . . . . . . . . . . . . . . . . . . . . . . . . 4 Open Setup... . . . . . . . . . . . . . . . . . . . . . . . . 12 Option . . . . . . . . . . . . . . . . . . . . 10, 13-15, 18-23 Optional arguments . . . . . . . . . . . . . . . . . . . . . 18 Printed manual . . . . . . . . . . . . . . . . . . . . . . . . 1 Printing selected files . . . . . . . . . . . . . . . . . . . 10 Registration . . . . . . . . . . . . . . . . 1, 2, 6, 7, 12, 26 Registration fee . . . . . . . . . . . . . . . . . . 1, 6, 7, 26 Remove . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Required arguments . . . . . . . . . . . . . . . . . . . . . 18 Save . . . . . . . . . . . . . . . . . . . . . 4, 5, 12, 13, 19 Save Setup... . . . . . . . . . . . . . . . . . . . . . . 13, 19 Select file spec . . . . . . . . . . . . . . . . . . . . . . . 9 Selecting files . . . . . . . . . . . . . . . . . . . . . . . . 9 Shareware . . . . . . . . . . . . . . . . . . . . . . . 1, 2, 4-6 Spooler . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4, 14 Tab expansion . . . . . . . . . . . . . . . . . . . . . . . . 14 Technical support . . . . . . . . . . . . . . . . . . . 1, 6, 24 TEST.FIL . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Text style . . . . . . . . . . . . . . . . . . . . . . . . . 21 Text... . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Units . . . . . . . . . . . . . . . . . . . . . . . . . . 14, 20 Use margin settings . . . . . . . . . . . . . . . . . . . . . 22 Wildcard . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 WIN.INI . . . . . . . . . . . . . . . . . . . . . . . . . 12, 13 WINAPA . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 Windows 3.0 . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Page 26 INVOICE/REGISTRATION FORM Remit to: Charles E. Kindel, Jr. Kindlco Software Systems 3000 118th Ave. SE, Suite A-203 Bellevue, WA 98005 From: FIRST NAME: ______________________________________ LAST NAME: ______________________________________ ADDRESS: ______________________________________ ______________________________________ ______________________________________ Quantity Unit Price Total ________ WinPrint Single User Registration Fee $20.00 _______ ________ WinPrint Disk and Printed Documentation $5.00 _______ Total: _______ Please specify disk size: ___ 5.25" or ___ 3.5" Note that WinPrint Version 1.0 has been delivered and accepted by the customer. Upon receipt of this paid invoice, a registration number will be sent.