Shareware Overload/ShartewareOverload.cdr/progm/baslin.zip/MANUAL.TXT

Text File | 1987-11-04 | 16KB | 833 lines

       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 -