home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Share Gallery 1
/
share_gal_1.zip
/
share_gal_1
/
LA
/
LA030.ZIP
/
PIE.DOC
< prev
next >
Wrap
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 (616) 399-6855, but
hours are limited to late morning to early afternoon on
weekdays, and weekends.