Amaryllis Software BASIC Line Numbers Version 1.0 For IBM Personal Computers and compatibles with 64K and DOS 2.0 or later. Deletes line numbers from or adds line numbers to BASIC programs saved in ASCII format. BASIC Line Numbers User's Guide Version 1.0 Amaryllis Software Program and documentation written by Carol Poster. This software and manual are copyright Amaryllis Software. Portions are copy- right Microsoft Corp. Copying of both is restricted as described later in this manual. This program was developed using Micro- soft's QuickBASIC. This manual was com- posed and printed on a Star Micronics SR-10 printer using the Hammerlabs' Lettrix Banker, Prestige, and OCR-A fonts. Portions c Microsoft Corp. c Amaryllis Software 1987 CONTENTS Introduction .................................. 1 Backing Up Your Disk .......................... 2 Creating Shareware Disks ...................... 3 Getting Started ............................... 4 BASIC Line Numbers Initial Menu ............... 5 Disk Drive Selection .......................... 5 Select Filename ............................... 7 Line Numbering Menu ........................... 8 Source Code ................................... 11 Technical Support ............................. 12 Other Amaryllis Software Products ............. 13 FIGURES Figure 1: Title Display ....................... 4 Figure 2: BASIC Line Numbers Initial Menu ..... 6 Figure 3: Disk Drive Selection ................ 6 Figure 4: Line Numbering Menu ................. 9 INTRODUCTION Amaryllis Software's BASIC Line Numbers pro- vides the following capabilities:  Delete Line Numbers: Removes unrefer- enced line numbers from BASIC programs.  Add Line Numbers: Numbers lines in a BASIC file, by leaving any existing line numbers unchanged, and adding new numbers to unnumbered lines in a manner compatible with existing line numbers. You can use BASIC Line Numbers for many devel- opment tasks, including:  Enter code with your favourite ASCII text editor, then add line numbers before running the program with a BASIC interpreter.  Switch easily between interpreters which re- quire line numbers and compilers which do not require line numbers.  Add line numbers to a file written in com- piler BASIC for debugging purposes.  Delete line numbers, use a text editor to move sections of code (something very dif- ficult within most BASIC editors), then add line numbers to produce usable interpreted BASIC code. The ability to produce unnumbered lines so that you can edit BASIC code with an ASCII text editor is extremely useful for converting a "quick and dirty" program into a production program by re- structuring and/or reorganizing the code into modules. - 1 - BACKING UP YOUR DISK Before you try to use this software you should make two copies of your original disk. You should use one of the copies as a working disk; reserve the other copy for archival purposes. You will only need to use the original if both copies fail during a backup. Floppy Disk Based Systems Put your DOS disk in drive a: and turn on your computer. If you have a single floppy drive sys- tem, type: DISKCOPY A: A: [ENTER] and follow the displayed instructions. For a dual floppy system, type: DISKCOPY A: B: [ENTER] and then follow the displayed instructions. Hard Disk Based Systems Turn on your computer system. If you want this program in your root directory, place your orig- inal disk in floppy drive a: and type: COPY A:*.* C: [ENTER] To place BASIC Line Numbers in a subdirect- ory, create the subdirectory with the MKDIR com- mand if it does not already exist, then copy the original disk to the desired subdirectory. For ex- ample, if you want to place BASIC Line Numbers in a subdirectory called "BASIC", you should type: MKDIR \BASIC [ENTER] COPY A:*.* C:\BASIC [ENTER] - 2 - CREATING SHAREWARE DISKS Amaryllis Software's BASIC Line Numbers is a type of program known as "shareware". We believe that it is difficult or impossible to tell if a program really will be useful for your purposes unless you can try it for a few weeks. Therefore we allow you to make copies of our software for your friends and co-workers. We do not authorize you to sell our programs -- only to share them. The batch file, "SHARE.BAT", on your disks, cre- ates a "shareable" BASIC Line Numbers disk. The only differences between the shareable version and the registered one are that we give registered users a complete printed manual, GWBASIC source code, and technical support. We hope that this will give owners of the shareware version of our software an incentive to register, and also reward those users who have paid for their software. To create a shareable BASIC Line Numbers disk, first make sure that a complete copy of your soft- ware (either version) is located on the current directory of your default disk drive. Type: SHARE [ENTER] and follow displayed directions. The new disk should contain the following files: FILES.TXT MANUAL.TXT PRINTMAN.BAT SHARE.BAT BASLIN.EXE - 3 - GETTING STARTED Once you have backed up your disk (see page 2), starting BASIC Line Numbers is very easy. If your copy of BASIC Line Numbers is in the cur- rent directory of the default drive just type: BASLIN [ENTER] If BASIC Line Numbers is located elsewhere, invoke it using the complete filename, including drive and pathname, as described in your DOS manual. After you invoke BASIC Line Numbers, you will see the title display (Figure 1) on the screen. ********************************* * OMITTED FROM SHAREWARE MANUAL * ********************************* FIGURE 1: Title Display - 4 - BASIC LINE NUMBERS INITIAL MENU Press [enter] as prompted by the title display. BASIC Line Numbers will display its initial menu (Figure 2). From this menu, you can either exit to DOS or start the file selection process. DISK DRIVE SELECTION The disk drive selection menu (Figure 3) allows you to select drives a:, b:, c:, or d: or display a directory of your default or selected drive. If you don't remember which disk or drive contains your file, look at a directory before making a selection. If you have configured part of your memory as a RAM disk, copy your BASIC file to your RAM disk before running BASIC Line Numbers. Since this is a disk-intensive program, placing your BASIC file on a RAM disk will increase performance dramatically. - 5 - ********************************* * OMITTED FROM SHAREWARE MANUAL * ********************************* FIGURE 2: BASIC Line Numbers Initial Menu ********************************* * OMITTED FROM SHAREWARE MANUAL * ********************************* FIGURE 3: Disk Drive Selection - 6 - SELECT FILE NAME The file name selection menu enables you to either select a filename or look at the directory of the selected drive. If you choose the filename sel- ection option, you will be prompted for the file- name. Enter the complete filename including ex- tension. BASIC Line Numbers will verify that the file is present on the selected drive. If the file is not found, you will be prompted to enter a new filename or select a different drive. If you cannot find your BASIC file on the selected drive, you can press [CTRL]-[BREAK] to exit the program. Remember that BASIC Line Numbers works ONLY on ASCII files; it will not work on tokenized files produced by the regular SAVE function of the BASIC interpreter. To save a file from the interpreter in ASCII format, you should type: SAVE "file.bas",A [ENTER] Special Filename BASIC Line Numbers uses a file named $TEMP for a temporary workspace. If you have a file named $TEMP in the same directory as your BASIC file, it will be destroyed. If BASIC Line Numbers terminates abnormally, (you press [CTRL]-[BREAK] or reboot your system) $TEMP may not be deleted. If you find $TEMP on your disk, delete it. - 7 - LINE NUMBERING MENU The Line Numbering Menu (Figure 4) enables you to add or delete line numbers or return to the ini- tial menu. Add Line Numbers Option 1, "Add line numbers to program.", adds line numbers to all unnumbered lines in the speci- fied file. If some line numbers are already pre- sent in the file, it leaves them unchanged, and preserves their sequence. For example, if a seg- ment of code read: 100 PRINT "A=";A A=A+1 200 PRINT "A=";A GOTO 300 BASIC Line Numbers would number it as follows: 100 PRINT "A=";A 101 A=A+1 200 PRINT "A=";A 201 GOTO 300 BASIC Line Numbers uses the file $TEMP for temporary workspace while adding line numbers to your file. - 8 - ********************************* * OMITTED FROM SHAREWARE MANUAL * ********************************* FIGURE 4: Line Numbering Menu - 9 - Remove Line Numbers Option 2, "Remove line numbers from program.", re- moves all unreferenced line numbers from the file. Referenced line numbers are not changed. For ex- ample, if a section of code read: 100 ' START LOOP 110 A=A+1 120 IF A<100 THEN GOTO 110 130 PRINT "A=";A BASIC Line Numbers would number it as follows: ' START LOOP 110 A=A+1 IF A<100 THEN GOTO 110 PRINT "A=";A BASIC Line Numbers uses the file $TEMP for temporary workspace while removing line numbers from your file. Garbage In Garbage Out If the specified file is not a valid BASIC file, you may get errors. The most common errors are:  Tokenized File: You saved your file from a BASIC interpreter in a tokenized form. Go back to the interpreter and save the file in an ASCII format.  Non-ASCII File: You edited your file with a non-ASCII word processor. Try ex- porting your file to ASCII.  Not BASIC: BASIC Line Numbers is designed to work with BASIC files. Although it may be modified to work with other files, results may be unpredictable. - 10 - SOURCE CODE Commented GWBASIC source code, saved in ASCII for- mat is provided to REGISTERED USERS ONLY. ********************************* * OMITTED FROM SHAREWARE MANUAL * ********************************* - 11 - TECHNICAL SUPPORT Technical support is available to REGISTERED USERS ONLY. If you have any question or problems, please write us at: ********************************* * OMITTED FROM SHAREWARE MANUAL * ********************************* - 12 - OTHER AMARYLLIS SOFTWARE PRODUCTS Other products offered by Amaryllis Software are  Aerobic Points: Have you ever wondered how much exercise you need? Do you want to track how much exercise you are getting? This program will keep track of all your aerobic activities for you, and let you ev- aluate whether you are meeting your exer- cise requirements.  Computer Media Database: Information about several hundred computer and tech- nology related periodicals in PC-File and mail-merge formats.  PC-F Pack: Improves the performance of applications using Buttonware's PC-File III or PC-File/R databases.  Star Printer Setup: This menu-driven program allows you to access many of the capabilities of your Star Micronics printer without the need to use complex escape code sequences.  WizBreaker: Enables players of Sir- Tech's Wizardry to modify or restore characters. All Amaryllis Software products run on MS DOS com- puters with 64K RAM and one disk drive, DOS ver- sions 2.0 and later. We market all our products as shareware. - 13 - ------------------------------------------------------------------------------- REGISTRATION FORM ------------------------------------------------------------------------------- PRODUCT QTY PRICE EACH PRICE EXTENDED BASIC Line Numbers (1 copy) 1 $9.99 $_____________ BASIC Line Numbers (2-4 copies) ___ $9.00 $_____________ BASIC Line Numbers (5-10 copies) ___ $8.00 $_____________ BASIC Line Numbers (over 10 copies) ___ $7.00 $_____________ PC-F Pack ___ $9.99 $_____________ Star Printer Setup ___ $9.99 $_____________ WizBreaker ___ $9.99 $_____________ Aerobic Points ___ $25.00 $_____________ Computer Media Database ___ $25.00 $_____________ ------------------------------------------------------------------------------- SUBTOTAL $_____________ Utah residents add 6.25% sales tax TAX $_____________ SHIPPING AND HANDLING $ 3.00 TOTAL $_____________ _______________________________________________________________________________ Please make checks payable to Amaryllis Software or provide appropriate credit card number. COD orders are not accepted. NOTE: allow 2-3 weeks for personal checks to clear. We cannot fill your order until your check has cleared. MasterCard _____ or Visa _____ Expiration Date __________ Card Number ___________________________________________________________________ Signature _____________________________________________________________________ Name __________________________________________________________________________ Address _______________________________________________________________________ _______________________________________________________________________ City _________________________________ State ________ Zip ___________________ _______________________________________________________________________________ Please send registration form to: Amaryllis Software 525 Parkview Drive Park City UT 84060 _______________________________________________________________________________ - 14 -