home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
C!T ROM 2
/
ctrom_ii_b.zip
/
ctrom_ii_b
/
PROGRAM
/
UTILS
/
SHELL-92
/
SHELL92.DOC
next >
Wrap
Text File
|
1992-07-07
|
17KB
|
443 lines
Shell-92 Copyright 1992 by James P. Habel Jr.
PURPOSE OF PROGRAM
------------------
Shell-92 is intended to be an aid to programmers who are now
compiling their programs from the command line. This program will
eliminate the need for repetitive typing of filenames and switches
each time you compile your programs. It also allows you to use your
favorite editor to edit your source files. You can instantly switch
between your editor, compiler, debugger and linker with the press
of a couple keys, effectively eliminating the need for the command
line at all. Shell-92 can also be used as a replacement for some
IDEs when you begin seeing that dreaded message, < OUT OF MEMORY >.
FEATURES
--------
- Easy to configure ( NO special text files to create, the program
does it all for you )
- Accepts up to 6 filenames that you would normally have to type
at the command line each time you go to compile. Once the pro-
gram is configured this process now takes 2 key presses.
- Accepts up to 15 switch directives that you toggle on an off
with a press of the space bar.
- Easily configured to use your favorite editor, debugger and
linker.
- Includes a 15 line batch file editor to create those small batch
files that you always seem to need when writing programs.
- Delete files, print files, change directories and run ANY program
on your HD from easy to use menus.
- Easily configure any five seperate programs to run from a menu
with the press of a single key.
- MANY more features !
FILES INCLUDED
--------------
shell92.doc - The file you are now reading.
shell92.exe - The file name you type at the command line to
run the program.
GENERAL INSTRUCTIONS
--------------------
Install-92 can be run from any directory on your hard disk.
Changing back and forth between directories is easily accomplished
via a menu. Therefore only one copy of Install-92 is needed to run
many different configurations. Whenever you save a configuration
the information will be stored in the current directory. Also when-
ever you change to a different directory the new configuration for
the new directory will be read into the program. If no configuration
file is found in the directory you change to then the program de-
faults will be used.
KEY USAGE
---------
Menus -
Up Arrow - Move cursor bar up.
Down Arrow - Move cusor bar down.
Enter - Select highlighted entry.
Right Arrow - Next menu to right.
Left Arrow - Next menu to left.
ESC - Abort menu and return to top bar menu.
( You may also select an option from a menu by pressing the highlighted
letter for the option you wish to use. )
Data -
Up Arrow - Go up one field.
Down Arrow - Go down one field.
CTRL- Left - Move cursor one character to left.
CTRL- Right - Move cursor one character to right.
Home - Go to first field.
End - Go to last field.
ESC - Abort data entry OR show options menu.
F3 - Save data to disk.
INSTRUCTIONS FOR ALL MENU ITEMS
-------------------------------
<< FILES >>
-----------------
File Names - This is the place where you configure the program to
---------- meet your programming needs. Two different types of
file names need to be entered here, file names that will make your
programming quicker and paths that the program needs to find certain
files.
Main file name - This file will usually be the name of the source
file that you will be editing most often.
Execute file name- This file will usually be the name of the file
that will be created as a result of compiling
your source files.
Include files (1-5) - You may enter the names of 5 different file
names here if your compiler expects include
files to be typed at the command line.
( Assemblers usually need include files for example while pascal
compilers don't. If your compiler doesn't use include files
then be sure to leave all 5 of these lines BLANK ! )
Command.com Path - This is the complete path to your systems
command.com file. On a lot of systems this will
be C:\DOS\COMMAND.COM
Text editor Path - Enter the complete path of the text editor that
you plan to use to edit your source files. If
you plan to use EDLIN then this will usually be
C:\DOS\EDLIN.COM
Linker Path - Enter the path to your linker if you plan to
use one. The default path is C:\DOS\LINK.EXE
Compiler Path - Enter the complete path to your compiler here.
For example, C:\QP\QPL.EXE if you plan to use
the QuickPascal compiler. Remember if your
compiler also runs from it's own IDE you need
the name of the command line compiler NOT the
name of the IDE !
Default Extension- Examples :
Compiler Enter
-------- -----
Basic .bas
Pascal .pas
C .c
Assembly .asm
Debugger - Enter the complete path to the debugger that
you plan to use here. The default for this line
will be : C:\DOS\DEBUG.COM
Program Names - Use this option to enter up to 5 different programs
------------- that you would like to run from a menu with the press
of a single key. They can be any programs that are located anywhere
on your hard disk. For each program you need to enter at least 2
items, the title of the program that you would like to appear on the
menu and the complete path to the program on your hard disk. The 3rd
entry for the command line is optional and would contain any items
that you would normally type after the file name when running a
program from the command line.
Switch Settings - This is where you toggle any switches that you may
--------------- have configured previously off and on. Simply move
the cursor to the switch you want to change with the arrow keys then
use the space bar to toggle the switch off and on. If a check mark
shows in the box then that switch is on, otherwise it will be off.
For more information about configuring switches see the information
about the MISC menu.
Set Directory - Use this option to change to any directory you wish.
------------- First delete the current directory name with the
delete key then type in the name of the directory that you wish to
change to. Press ENTER to change to the new directory. If the new
directory does not exist, the name of the current directory will be
re-displayed. Remember that you can store different configurations
in different directories. The first thing the program will do when
you change directories is read the new configuration into the pro-
gram. If no configuration files are found then the program will use
the program defaults.
Delete Files - This option allows you to delete files easily from
------------ a menu. After selecting the file to delete press Y
to delete the file or N to leave the file intact.
Print Files - Use this option to print any file to your printer.
----------- This option does not use any special printing meth-
ods so it is best used to print text files.
[ A note about PICK, CHOOSE and LIST ]
These 3 options appear on most menus and are explained below.
CHOOSE - Choose allows you to enter any file name that you wish
by simply typing the FULL path to the file on the line
provided.
LIST - List allows you to select a file name from the current
directory. Only the files with the extension shown on
the menu will be listed.
PICK - Pick will allow you to select ANY file name from ANY
directory from an easy to use menu. To change direct-
ories simply move the cursor to highlight the desired
directory and press enter.
<< EXEC >>
----------------
Main File - This option will execute the file name that you
--------- specified when you configured the program. If
you did not specify an execute file name then this option
will do nothing.
Choose - This option will execute any program that you type
------ on the line provided. You must supply the FULL path
to the file or you will get a error message.
Pick - Use this option to execute ANY file from ANY directory
---- by simply selecting the file name from the menu.
1 List COM - Presents a menu of all COM files that can be
------------ executed in the current directory.
2 List EXE - Presents a menu of all EXE files that can be
------------ executed in the current directory.
3 List BAT - Presents a menu of all BAT files that can be
------------ executed in the current directory.
If you configured up to 5 different programs to run from this
menu with a single key stroke they will appear where the solid
lines appear in the menu.
No matter which of the above methods you use to execute a
program remember that the program MUST end with one of the
following extentions : COM, EXE or BAT
<< /Edit >>
----------------
Main File - This option will allow you to edit the file name
--------- that you specified when you configured the program.
If you did not specify a main file name then this option will
do nothing.
Choose - This option will aloow you to edit any file that you type
------ on the line provided. You must supply the FULL path
to the file or you will get a error message.
List - This option will display all the files in the
---- current directory ending with the extension that you
specified when configuring the program. Simply select the
file that you wish to edit.
Pick - Use this option to edit ANY file from ANY directory
---- by simply selecting the file name from the menu.
If you configured the names of any include files they will
appear at the end of this menu instead of the solid lines.
<< Comp >>
----------------
Main File - This option will allow you to compile the file name
--------- that you specified when you configured the program.
If you did not specify a main file name then this option will
do nothing.
Choose - This option will allow you to compile any file that you type
------ on the line provided. You must supply the FULL path
to the file or you will get a error message.
List - This option will display all the files in the
---- current directory ending with the extension that you
specified when configuring the program. Simply select the
file that you wish to compile.
Pick - Use this option to compile ANY file from ANY directory
---- by simply selecting the file name from the menu.
Any include files that you configured will appear on the menu
instead of the solid lines. Only the include file that you
select will be compiled.
If you configured the names of any include files they will
be included in the compilation just as if you had typed them
on the command line, except as per the above paragragh.
<< Link >>
----------------
Execute Linker - This option will run the linker program that
-------------- you specified when you configured Shell-92.
If you didn't specify one the program will default to:
C:\DOS\LINK.EXE
Cancel - This will return you to the main menu bar.
------
<< Debug >>
----------------
( All options on this menu will run the debugger that you
specified on the Set File Names screen. The following
options will select the name of the file that you wish
to debug. )
Main File - If you specified an execute file name when you
--------- configured Shell-92 then that file name will
appear here, if not then this option will run your debugger
without specifing a file name.
Choose - With this option you can type in the FULL path of
------ the file you want to debug.
1 COM files - This will list all the COM files in the
------------ current directory. Simply select the COM
file that you want to debug.
2 EXE files - This will list all the EXE files in the
------------ current directory. Simply select the EXE
file that you want to debug.
Pick - Here you can select ANY file from ANY directory
---- to debug.
<< Misc >>
---------------
System Info - This option will display various information
----------- such as the time of day, free disk space etc.
Change Colors - Use this option to change all the program
------------- colors to your liking.
Batch File Editor - This option will invoke the mini batch
----------------- file editor descibed below.
Batch File Editor
-----------------
This utility is great for writing small batch files of up to
15 lines in length. To create a new batch file select the CREATE
BATCH FILE option from the presented menu. To edit an existing
batch file select EDIT BATCH FILE and all the batch files that
are located in the current directory will be displayed. Select
the file that you wish to edit and press ENTER. The editor will
then appear. Once you are in the editor the ESC or F3 keys will
bring up the options menu which is :
SAVE FILE - This will save the file that you are current-
ly working on and then exit to the main bar menu.
ABORT CHANGES - This will NOT save any changes you made
since loading the current file, and then exit to the main
bar menu.
INSERT LINE - This will insert a blank line at the current
cursor location and move all lines below it down one line.
DELETE LINE - This will delete the line that the cursor is
located on and move all lines below it up one line.
The following keys are functional while editing a file :
Insert, delete, all arrow keys, ctrl-right, ctrl-left,
home, end, and F7.
The F7 function key will allow you to use all 256 IBM char-
acters in your batch files. Simply press F7 and type the
numerical code for the character you want to display and
press ENTER.
Configure Switches - This option will allow you to configure
------------------ up to 15 different switches for your
compiler. These switches can then be toggled on and off by
using the Set Switches option from the Files menu. This will
help save time as each switch would normally have to typed at
the command line each time you went to compile your program.
You can give each switch any title you want but the switch
itself should be entered exactly as you would type it on the
command line. When you are done entering your switches press
F3 to save them to disk, then when you run the program the
next time the switches will load automaticly.
<< \Dos >>
---------------
Shell to DOS - This option will shell you out to the DOS
------------ command line where you can use any DOS
commands that you would normally use. Type EXIT when you
want to return to Shell-92.
<< Quit >>
---------------
Quit Program - Use this option when you are done with
------------ Shell-92 and wish to return to DOS.
REGISTRATION
------------
If after trying Shell-92 for awhile and you find it useful
enough to keep using you must register it with me. To register
please send one dollar ($1.00) along with your name and address
to :
James P. Habel Jr.
645 West Vine Street
Lancaster, PA 17603
You will not recieve another disk if you register the program
as you already have in your possession the complete program.
If can can't find a dollar to send, don't worry, you can still
register by sending your name and address. Any questions, comments
or suggestions about the program just drop me a line at :
Home - 717-291-4637
Delphi - JHABEL
Prodigy - HGVR05A
Thanks and hope to be hearing from you !
( PS - If anybody wants the PASCAL source code ( lots of home
grown routines ) let me know and I'll gladly send it to you.
About 3 bucks would be appreciated to cover disk and mailing
costs. )