Share Gallery 1/share_gal_1.zip/share_gal_1/LA/LA030.ZIP/PIE.DOC

Text File | 1991-03-01 | 15KB | 425 lines

Programmer's Integrated Environment Version 2.0
Copyright (C) 1991, twentysomething Software


LICENSE

    Programmer's Integrated Environment (PIE) is Copyright (C)
    1991 by twentysomething Software. This software must be
    treated like a book, in that the registered copy of this
    software may not be used in more than one computer at the
    same time (Just like you can't read the same book in two
    different places at the same time). You are granted
    authorization to make archival copies of this software for
    the sole purpose of backing up this software to protect your
    investment.

    Unregistered copies of this program may be freely distributed,
    no fee may be charged except for the cost of duplication of the
    complete unregistered version.


DISCLAIMER

    twentysomething Software makes no warranty of any kind,
    either express or implied, including but not limited to
    implied warranties of merchantability and fitness for a
    particular purpose, with respect to this software and
    included documentation. In no event shall twentysomething
    Software be liable for any loss of profit or any other
    commercial damage, including but not limited to special,
    incidental, consequential or other damages, arising out of
    the use, or inability to use this program, even if
    twentysomething Software has been advised of the possibility
    of such damage.


TRADEMARKS

    IBM PC, IBM PC-XT, IBM PC-AT, IBM PS/2 are trademarks of
    International Business Machines Corporation. QuickBASIC and
    MS-DOS are trademarks of Microsoft Corporation. Turbo Pascal,
    Turbo C, Turbo Assembler, and Turbo Debugger are trademarks
    of Borland International.  All other product names are
    trademarks of their manufacturers.






















TO REGISTER Programmer's Integrated Environment

    This software product and manual are being distributed under
    the USER SUPPORTED SOFTWARE concept (SHAREWARE).  The
    software and manual are not in the public domain.  Shareware
    means you are permitted to try the program for a limited
    period of time (usually 30 days), after that period of time
    you are required to register the software.

    To register this software, print the file REGISTER.PIE and
    fill it out, then send it to:

        twentysomething Software
        16744 James St.
        Holland  MI  49424

    To print REGISTER.PIE, type "COPY REGISTER.PIE PRN" and press
    enter (don't type "") at the DOS prompt.

    Registration of PIE will provide you with:

        - Registered version of PIE V2
        - A free editor (Dan's Editor)
        - Low-cost upgrades to future versions
        - Shipping and handling

Files Included:

    README       - Program Information
    INSTALL.EXE  - PIE Installation program
    REGISTER.PIE - Registration Form to be printed
    PIE.DOC      - This file
    PIE2(U).EXE  - Program file, U = Unregistered Version
    PIE_???.CFG  - Configuration files, examples included
    E.EXE        - Dan's Editor, registered version only!
    EDITOR.HLP   - Help file for Dan's Editor
    E.CFG        - Editor configuration file


Program Description

    The purpose of Programmer's Integrated Environment (PIE) is
    to provide an interface for most compiled programming
    languages.  It allows a programmer to edit, compile, link,
    test, and debug a program using a simple menu.  PIE is an
    interface between the editor, command line compiler, linker,
    and debugger, if all of these are available (an editor is
    supplied with the registered version of PIE).  It has been
    used successfully with Turbo Pascal 6.0, Turbo C 2.0, Turbo
    Assembler 2.0, and QuickBASIC 4.5.
















Documentation Notes

    First a word about this documentation.  PIE is intended for
    use by programmer's who are experienced with the basics of
    DOS.

        C:\TP\PAS\MYFIRST.PAS

        PATH=C:\DOS;C:\UTIL

    For instance, if you know that the first line means that the
    file MYFIRST.PAS is on the C drive (C:), in the subdirectory
    \TP\PAS, and in fact \PAS is a subdirectory of \TP.  Also, if
    you know that PAS is the file extension part of the file
    MYFIRST.PAS.  And, if you know that the second line will set
    the PATH environment variable to allow programs in the \DOS
    or \UTIL of the C drive to be run from almost any drive or
    directory.  If you knew all of that, then you are ready for
    this program and the documentation.


    This does not mean that PIE is difficult to work with, in
    fact it provides a simple, straight forward interface to
    handle typically larger programming projects.  PIE was
    created because the author was tired of running into "Out of
    Memory" type compiler errors within the integrated
    environments supplied with most popular languages, and then
    having to return to the command line compiler, then testing,
    then debugging, then re-editing.  Too much time was wasted
    typing in command line options, switching between
    directories, etc.


Program Requirements

    PIE requires a minimum of 512K of RAM on an MS-DOS compatible
    computer, a hard disk, and of course, a programming language.
    Also, PIE will use EMS memory for swapping, if EMS is not
    available, swapping will be done to disk.


Program Installation

    To install PIE, run the program INSTALL.EXE.


Running PIE

    To run PIE, go to the drive and directory where PIE is
    installed, end enter PIE2(U) at the command line.















Entering a Source File

    PIE is able to act as an interface for more than one
    programming language.  To do this it creates a configuration
    file for each language based on the file extension of the
    source file (.BAS for BASIC, .PAS for Pascal, .C for C,
    etc.).  If there is a sample configuration file for the
    entered source file, it will be used, this will most likely
    need to be changed.  To change this configuration file, enter
    a source file with a wildcard character (?,*) in it, when the
    list of files is displayed, select any file as a source file,
    at the main menu, select Setup.  Then edit the configuration
    file for your system, press Ctrl and enter, and respond with
    a Y to save the configuration.

    The first screen encountered when PIE is run will ask for a
    source file name including an extension.  First, a couple of
    rules, the source file name must not be an empty field, it
    may include wildcard characters (*,?), but not in the file
    extension part of the file name.  If you do include a
    wildcard character, a list of files will be displayed, and
    the source file may be selected from this list.  A note about
    the files displayed in this list, ALL files and directories
    in the source file directory will be displayed, this allows
    access to files other than those with a file extension as
    entered. For example, if you want to edit a Pascal include
    file (INC extension).  Also, selecting a directory will move
    you to that directory, this allows you to edit files anywhere
    on the specified drive.  Now, if this is the first time you
    have entered a file with this extension, you will need to
    setup a configuration file before going to the main menu.


Setting Configuration Files

    If no configuration file is found for the entered file
    extension, or Setup is selected from the Main Menu, the
    configuration screen will be presented.

    The first field will ask for the drive and directory where
    source files will be found and stored.  Example: Source files
    for Turbo Pascal are stored in the C: drive, \TP\PAS
    directory, the entry for this would be "C:\TP\PAS" (do not
    include the "").

    The next field ask for a path.  This will add what is entered
    to the DOS environment PATH specification.  This is useful if
    any of the programs PIE runs, in turn runs another program.
    An example of this is Turbo C command line compiler, which
    runs the Turbo C linker.  An entry in this field should
    conform to the rules for specifying a PATH in DOS.  If more
    than one directory is entered, seperate them with a semicolon
    (;). Example: The directories C:\TC, and C:\TD need to be
    added to the PATH specification.  The entry for this would be
    "C:\TC;C:\TD", alternatively, if the current drive is the C:
    drive the entry could be "\TC;\TD" (again, do not include
    "").










    The EDITOR: field accepts the drive and directory and
    filename of the desired editor.  If for instance, the editor
    supplied with PIE is desired, this entry may look like
    "C:\PIE\E.EXE", where C: is the drive, and \PIE\ is the
    directory where the editor E.EXE is found.  It is not
    necessary to use the editor supplied with PIE (Dan's Editor),
    any editor may be used, even the editor supplied with the
    appropriate programming language may be used.  In fact often
    times the editor supplied with a programming language offers
    many help features not available with any other editor. Next
    is the PARAMS: field for the Editor, when PIE runs the
    editor, it assembles the command line equivalent of
    EditorEntry+SourceFile+EditorParams. For example, if
    MYFIRST.BAS is the source file, C:\PIE\E.EXE is the editor
    entry, and /B /C is the entry for editor params, PIE runs;

    C:\PIE\E.EXE MYFIRST.BAS /B /C

    If your editor requires any parameters before the SourceFile,
    enter those in the EDITOR: field.

    COMPILER: field is the same as the EDITOR: field except, of
    course the drive, directory, and complete file name for the
    compiler are entered here.  If any parameters need to be
    entered before the source file name, they should be entered
    in this field. The PARAMS: field for the compiler is the same
    as the params field for the editor, any parameters that would
    be entered after the source file name from the command line,
    are entered here.

    The LINKER: field will contain the drive, directory, and file
    name of the linker.  Not all programming languages have a
    linker, so this field may be left blank.  The entry for the
    PARAMS: field for the linker uses the same logic as the
    editor and compiler entries.  One difference with the linker,
    only the source name (no file extension) is used when this is
    run. Most linkers default to an .OBJ extension.  The command
    line entry would look like this if using the above example;

    C:\QB\LINK.EXE MYFIRST /B /C

    DEBUGGER: and the PARAMS: entry use the same logic as the
    entries for the linker.

    The RUN DIR: field accepts the drive and directory where the
    executable file will be after it is compiled/linked, this
    allows the program to be run (tested), the RUN EXT: field
    requires the extension of the executable file, usually this
    is EXE, but may be COM.

    If everything is complete, press ^Enter (^Enter means to
    press and hold the Ctrl key and then press Enter).  You will
    be asked if you want to save the configuration to disk,
    respond by pressing the Y key.












Main Menu

    Here is the easy part, the screen contains a menu in the
    middle of the screen.  The top center border of the menu will
    contain the name of the source file.  From this menu, may be
    selected any options with a corresponding entry in the
    configuration file. For instance, if no linker was entered at
    the setup screen, the Link option cannot be selected.  To
    edit the source file, press the E key, or use the up and down
    arrow keys to highlight Edit, and press enter.  When you are
    done editing the file and you want to compile the program,
    press C for Compile.  Once the program is compiled you may
    have to link it, press L.  To test the program press R for
    Run, if there are any errors you may wish to debug the
    program, press D for Debug.  If you found an error, return
    from the debugger and press E again to Edit the source file.

    If the editor, compiler, linker, or debugger fail to run
    properly, press S to change the configuration for the current
    language extension.  Most problems can be solved by verifying
    the correct drive, directory, and complete filename are
    entered. Other problems may require lengthy parameters to
    specify where necessary units, or libraries can be found.  To
    cut down on the size of the PARAM: entries, most compilers,
    linkers, or debuggers use a configuration file for the
    setting of default parameters.  Check your documentation for
    information on this topic.

    If you want to work on a different program, press N for New
    Source. This will bring up the same request for a source file
    as appears at the beginning of the program.

    Press O for a temporary exit to the operating system, when
    finished type EXIT at the prompt and press enter.

    When you are done working with PIE, press Q for Quit, and PIE
    will terminate.


Other Topics

    The best way to use PIE, is to use it for all of your
    programming needs.  Most integrated environments provided
    with programming languages provide the capabilities to edit,
    compile, and debug smaller programs.  For the EDITOR: field,
    specify the appropriate program, then use all of its
    capabilities along with PIE.  For example, if you are
    programming in QuickBASIC, go ahead and start PIE and enter a
    source file with a BAS extension.  Be sure that the
    QuickBASIC integrated environment is specified as the
    EDITOR:. Now press E for Edit, this brings you to the
    integrated environment where you may edit the file, get help,
    check syntax, and if the program is not too large, run the
    program.  If the program is too large, exit from the












    integrated environment and back to PIE, where the compiler,
    linker, and other options may be used.  This provides the
    best of both worlds, the advantages of an integrated
    environment, and the ability to easily work with large
    programs.


To Get Help

    Help is available in several different forms, first is the
    mailing address:

        twentysomething Software
        16744 James St.
        Holland  MI  49424

    Also, members of CompuServe may leave mail for
    72421,1072.  GEnie members may leave mail for DJN.

    Phone support is available by calling [phone], but
    hours are limited to late morning to early afternoon on
    weekdays, and weekends.