Welcome to Source Printer. Copyright 1994 David J. Mikelson This is version 2.0 (circa November 1995). See the file WHATSNEW.TXT for changes since version 1.0. Extensive online help is available via the Windows help file SRCP20.HLP. Context sensitive help while running Source Printer is available by pressing F1 at any time. Note that you can browse the SRCP20.HLP file without installing or running Source Printer by double clicking on it from File Manager. CONTENTS -------- What It Does Supported Programming Languages Disclaimer - Agreement About the Unregistered Version Installing Source Printer Quick Start How To Register Ordering By Check Ordering Through Compuserve Order Form Ordering Through PsL (credit cards) Upgrading Contacting the Author Distributing Source Printer Uninstalling Source Printer WHAT IT DOES ------------ Source Printer prints your source code so that it is easier to read and follow. It does this by: Allowing you to specify different fonts for normal and commented code Expanding tabs properly Intelligently indenting and word wrapping each line when required Intelligently aligning columns and blocks of code Printing headers and/or footers if requested Source Printer can interpret comments for a number of programming languages. In addition, you can specify a user defined comment format to handle almost any programming language not supported. The programming languages supported by Source Printer include: .ASM Assembler source code .BAS Basic source code .C C source code .CBL Cobol source code .CPP C++ source code .FOR Fortran source code .H C,C++ include files .INC Pascal include files .LSP Lisp source code .PAS Pascal source code .POV Persistence of Vision Scene Files .PRG Clipper source code .??? User Defined Source Printer allows you to specify margins, tabstops, character spacing, and line spacing. It can print text from Window's Clipboard, and supports 'Drag and Drop' onto either its icon or main window. DISCLAIMER ---------- Prices below will be valid until at least 31 December 1996. Users of Source Printer must accept this disclaimer of warranty: Source Printer is supplied as is. The author disclaims all warranties, expressed or implied, including, without limitation, the warranties of merchantability and of fitness for any purpose. The author assumes no liability for damages, direct or consequential, which may result from the use of Source Printer. Source Printer is a 'shareware program' and is provided at no charge to the user for evaluation. Feel free to share the unregistered version with your friends, but please do not give it away altered or as part of another system. The essence of 'user-supported' software is to provide personal computer users with quality software without high prices, and yet to provide incentive for programmers to continue to develop new products. If you wish to register Source Printer, make a registration payment of US$ 10.00 (or US$ 15.00 if ordering through PsL) to David J. Mikelson (see How To Register). The registration fee will license one copy for use on any one computer at any one time. You must treat this software just like a book. An example is that this software may be used by any number of people and may be freely moved from one computer location to another, so long as there is no possibility of it being used at one location while it's being used at another. Just as a book cannot be read by two different persons at the same time. Site-License arrangements may be made by contacting David J. Mikelson (see Contacting the Author). Anyone distributing Source Printer for any kind of renumeration must first contact David J. Mikelson at the address given on the Order Form for authorization. You are encouraged to pass unregistered trial copies of Source Printer along to your friends for evaluation. Please encourage them to register their copy if they find that they can use it. ABOUT THE UNREGISTERED VERSION ------------------------------ Prices below will be valid until at least 31 December 1996. I thought long and hard about whether or not to distribute unregistered trial copies of Source Printer in a fully functional form. In the end, for purely selfish reasons, I decided not to. Your interest in Source Printer probably means you are a programmer, and so perhaps you can relate to the many person-hours involved in writing something like Source Printer. Instead, I have tried to make the basic registration fee very reasonable, and I hope you agree that US$ 10.00 is reasonable. In its unregistered form, the only limitation is that you cannot print more than five pages from each source code file. You can of course break your big files up into many five page files, and print them that way, but I'm sort of hoping you'll get tired of that. On the other hand, if you only dabble with programming and your source files are generally less than five pages, then the unregistered version will serve you well, and you are welcome to continue using it for as long as you like (though you'll have to put up with the beg notices). Upon registration, you will be sent a personal registration number that will unlock the five page limitation. The same registration number will work with all future versions. See How To Register later. INSTALLING SOURCE PRINTER ------------------------- Make a subdirectory with a name of your choosing. The following assumes you have chosen a subdirectory called SRCPRN. Copy the following files to the SRCPRN subdirectory. Do not copy the supplied version of BWCC.DLL yet (if you are extracting Source Printer from an archive, do not extract BWCC.DLL yet). SRCP20.EXE SRCP20.HLP README.TXT ORDERFRM.TXT WHATSNEW.TXT To run SourcePrinter, the file BWCC.DLL needs to be in your SRCPRN subdirectory, or in your Windows subdirectory, or in your Windows/System subdirectory, or somewhere on your path. Chances are that you already have a copy of BWCC.DLL because many different programs use and install BWCC.DLL. The copy you already have may be newer or older than the one that comes with SourcePrinter. (BWCC.DLL is part of Borland Windows Custom Controls - (C) Copyright 1991-1993 by Borland International.) The version of BWCC.DLL shipped with this copy of SourcePrinter is BWCC.DLL v 2.04. The file date is 28 February 1995 and the file size is 164,928 bytes. You can determine the version number of any copy of BWCC.DLL on your hard disk by highlighting the file in File Manager, selecting File - Properties from the File Manager's main menu, and reading the Version number. Ideally you should have only one copy of the latest version of BWCC.DLL on your system, and it is usually placed in the Windows\System subdirectory. Using the above information, you should now cause the preceding sentence to be true. Copy the file BWCC.DLL from the Source Printer disk or archive only if the version supplied with Source Printer is newer than the copy currently on your machine. When Source Printer is run for the first time, it will create a file called SRCP20.INI in Source Printer's subdirectory. This file is used on subsequent startups to set various parameters to whatever they were when you last exited Source Printer (like fonts, margins, preferences, etc.). The initial SRCP20.INI file that is created when Source Printer is first run contains reasonable defaults. The installation of Source Printer is now complete. If desired, you can create a new group or add Source Printer to an existing group by using the normal File Manager's drag and drop facilities or Program Manager's File - New - Group/Item commands. QUICK START ----------- To print something with Source Printer right now: If you have not already done so, install Source Printer. When you run Source Printer for the very first time, the various settings suggested below will have already been selected by default. Any of the settings below can be changed later. Any changes will be automatically saved for your next Source Printer session. For the Quick-Start, just use the ones suggested. See 'What It Does' for a list of the programming languages that Source Printer supports. Double click on SRCP20.EXE from File Manager, use File - Run from Program Manager, or, if you have installed a Source Printer icon in Program Manager, double click on that. Click on the Select Files button on Source Printer's main window. This brings up a file selection dialog box from which you select one or more source code files to place in the file list on Source Printer's main window for printing. Hold the Ctrl key down while clicking on the file names to select more than one file. Select Format - Fonts from the main menu. Place a check-mark in the 'Allow Fixed pitch only' box. Set the Line Spacing to 1.0. Set the Char Spacing to 1.0. Click on the Change normal code font button and select Courier New, 10 pt, Regular. Click on the Change commented code font button and select Courier New, 10 pt, Bold. Select Format - Header/Footer from the main menu. Place check-marks in Number Pages, Bottom, Right. Place check-marks in Print Filename, Top, Left. Place check-marks in Print Date, Top, Right. Select Use Today's Date. Place check-marks in Header separator and Footer separator. Select Format - Margins/Tabs from the main menu. Set all margins to 1.0 inch, but make sure these are larger than the minimum margins that will be shown for your printer. Set the tab stops to 3. The current page orientation (Portrait or Landscape) is shown in Source Printer's main window. To change this, select File - Print Setup from the main menu. When Source Printer first starts up, it configures itself to use the default printer you have specified through Windows' Control Panel. Click the Print button. Note that the un-registered version of Source Printer will only print the first 5 pages of each source file. See below for instructions on registering. HOW TO REGISTER --------------- Prices below will be valid until at least 31 December 1996. You can register in three ways: 1) By ordering through Compuserve's Shareware Registration service Log onto Compuserve and GO SWREG. Follow the prompts. Source Printer's Compuserve registration ID is 3555. When you register this way, you leave your Compuserve ID with SWREG. Your registration is charged to your Compuserve account. SWREG then notifies me via e-mail that you have registered. I then e-mail you your registration number. 2) By sending me a check directly Print the file ORDERFRM.TXT 3) By credit card through PsL (Public (software) Library). Note that you cannot upgrade through PsL. See Ordering through PsL. Ordering through Compuserve's SWREG service is the preferred method. It is simpler for me and quicker for you. But there is absolutely nothing wrong with the other two methods. The basic registration fee for Source Printer is US$ 10.00 per copy. However, there is an exception: If you must order via credit card, then you must order through PsL (Public (software) Library). In this case, I must ask a registration fee of US$ 15.00 to cover additional costs to me. Upgrades are not available through PsL. For the basic registration fee, you will be sent a registration number to unlock the copy you currently have. Your registration number will unlock all future versions. In order to keep the cost down, I am not sending disks automatically. Please strive to get the latest version from Compuserve (GO PCFF to help find it), or try the Internet at ftp.winsite.com (see Upgrading). SOURCE PRINTER ORDER FORM ------------------------- If ordering by check only, print the order form by printing the file ORDERFRM.TXT from DOS. Or, if viewing the Windows SRCP20.HLP file, select the topic 'Order Form' and select 'File - Print Topic' from the menu bar. Do not use this form to order through Compuserve or PsL. The order form is duplicated below. ------------------------------------------------------------------- Prices below will be valid until at least 31 December 1996. Send this form with a check payable to Dave Mikelson to: Dave Mikelson 370 Vester Sted Solvang, CA 93463 U.S.A. Payments must be made in US dollars drawn on a US bank, or you can send international postal money orders in US dollars. Name: ______________________________________________________________ Company: ___________________________________________________________ Address: ___________________________________________________________ City: ______________________________________________________________ Country: _________________________Post Code: _______________________ Day Phone: ______________________ Eve.Phone ________________________ Electronic Mail Address: ___________________________________________ Where did you hear about or download Source Printer from:___________ Version of Source Printer You Have: ________________________________ Source Printer Registration Number (if upgrading and requesting disk) (Name above must be exact registered name) _________________________ Costs: Basic Registration (receive reg number only - no disk**): US$ 10.00 Receive Upgrade disk**** (See Upgrading) US$ 2.00 California residents must add 8.25% sales tax. Disk Size: Hi Den 3-1/2 (1.4 Mb)____ Hi Den 5-1/2 (1.2 Mb) ____ ** If you are registering for the first time, and if I have completed a later version than the one you have, I will send you a disk with the later version on it for no extra charge. **** For registered users only who cannot download from Compuserve or other BBS. Note: For some reason, some users send me checks for $12.00. This is never necessary. Either send $10.00 if you are registering for the first time, or $2.00 if you are a registered user, know a new version exists, and do not have access to Compuserve or Internet ftp. ------------------------------------------------------------------- ORDERING THROUGH PSL -------------------- Use PsL only if you must order by credit card. Upgrades are not available through PsL (see Upgrading). PsL takes orders only. Any questions about the status of the order, refunds, registration options, product details, technical support, volume discounts, dealer pricing, site licenses, etc. must be directed: By post, to: Dave Mikelson 370 Vester Sted Solvang, CA 93463 U.S.A. or From Compuserve to: TO: DAVE MIKELSON, 100141,1006 or From Internet: To: 100141.1006@compuserve.com If you order through PsL, the basic registration fee is US$ 15.00. This is because there are additional costs to me. Note that you can register for only $US 10.00 if you use Compuserve's shareware registration service (GO SWREG) (see How To Register) or if you send a check directly to me (see Order Form). Source Printer's PsL Product ID is 11599. PsL is short for 'Public (software) Library'. CREDIT CARD ORDERS ONLY You can order with MC, Visa, Amex, or Discovery from Public (software) Library by calling 800-2424-PsL or 713-524-6394 or by FAX to 713-524-6398 or by CIS Email to 71355,470. You can also mail credit card orders to PsL at P.O. Box 35705, Houston, Texas, 77235-5705. THE ABOVE NUMBERS ARE FOR ORDERS ONLY Any questions about the status of the shipment of the order, refunds, registration options, product details, technical support, volume discounts, dealer pricing, site licenses, etc. must be directed to the author's (Dave Mikelson) contacts above. PsL will notify me the day of your order, and I will dispatch your Source Printer registration number directly to you. Once again, if you have a Compuserve account already, use GO SWREG instead of PsL and save yourself US$ 5.00. UPGRADING --------- Prices below will be valid until at least 31 December 1996. If you are a registered user and have access to Compuserve, upgrades are free. The latest version of Source Printer should always be available on Compuserve. The easiest way to find it is to GO PCFF. This is the PC File Finder. From its menu, choose 1) to Access the File Finder. Choose 7) to define the File Submitter (me). Type in my Compuserve ID as 100141,1006. Then choose 8) to Display Selected Titles. Except for version 1.0 (which was named SRCPRN.???), all subsequent Source Printer versions will be named as SRCPXX.??? where XX will indicate the version number (20 means 2.0) and ??? will generally be the file extension associated with popular file compression programs. Download the file with the largest 'XX'. The latest version should also be available via Internet at The WinSite Windows Archive (ftp.winsite.com), probably in the /pub/pc/win3/programr subdirectory. Note that this is the new name for what used to be known as CICA (ftp.cica.indiana.edu). As of 13 October 95, CICA moved and is no more. Note that you cannot upgrade through Compuserve's Shareware Registration Service (SWREG). SWREG is for initial registration only. The latest version as of 5 November 1995 is version 2.0, and is distributed as SRCP20.??? (where ??? will generally be the file extension associated with popular file compression programs.) Registered users will be able to use their registration number to unlock all future versions. You cannot upgrade through the Compuserve Shareware Registration Service (SWREG) or by credit card. If you are a registered user, and only if you know that a later version than the one you have exists, but you do not have access to Compuserve, then: Registered users can receive an upgrade disk for US$ 2.00. You must send a check to me directly. Include your registration name and number on all correspondence. (see Order Form). CONTACTING THE AUTHOR --------------------- The easiest way to reach me is to leave me mail on Compuserve. From Compuserve: TO: DAVE MIKELSON, 100141,1006 From Internet: To: 100141.1006@compuserve.com (please pay the postage yourself) Alternatively, write to: Dave Mikelson 370 Vester Sted Solvang, CA 93463 U.S.A. DISTRIBUTING SOURCE PRINTER --------------------------- You are encouraged to pass unregistered trial copies of Source Printer along to your friends for evaluation. If you do so, you must provide them with the entire set of Source Printer files: SRCP20.EXE SRCP20.HLP README.TXT ORDERFRM.TXT BWCC.DLL FILE_ID.DIZ WHATSNEW.TXT If your are compressing the files, please name the archive SRCPXX.??? where XX is 20 for version 2.0, and .??? is representative of the compression program used. UNINSTALLING SOURCE PRINTER --------------------------- Erase the following files from whatever subdirectory you installed Source Printer into. SRCP20.EXE SRCP20.HLP SRCP20.INI README.TXT ORDERFRM.TXT WHATSNEW.TXT If you created a Source Printer icon in Program Manager, delete that icon. Source Printer came with a copy of BWCC.DLL, which should be in your main Windows system subdirectory (like C:\WINDOWS\SYSTEM). However, there are many other programs that require BWCC.DLL to run, so, unless you are sure that no other programs you have require BWCC.DLL, do not delete this file. Source Printer itself makes no changes to any of the Window's .INI files. However, if you used File Manager to associate any file extensions with Source Printer, there may be references to Source Printer in some of your Windows .INI files. End of Source Printer README.TXT