Dec 052017
 
Programmer's Environment (DOS shell).
File PSHELL.ZIP from The Programmer’s Corner in
Category Miscellaneous Language Source Code
Programmer’s Environment (DOS shell).
File Name File Size Zip Size Zip Type
PSHELL.COM 47713 23230 deflated
READ.ME 9612 3108 deflated
SETUP.TXT 451 208 deflated

Download File PSHELL.ZIP Here

Contents of the READ.ME file









P - SHELL
---------


a programming environment












This program was developed by Steven Kitching.
It is POSTWARE: if you like it, send us a postcard addressed to us
at
67 Gilmour Street
Ottawa , Ontario K2P 0N1
Canada
(613) 230-5591 (voice only, please)

Of course, we're glad to hear comments, suggestions about
enhancements, and even about complaints, incompatibilities and bugs.
And if you like the program please give it to your friends, place it
on bulletin boards and otherwise spread it around.

And I make the usual disclaimer: this software is
distributed "as is" and is warranted for no purpose. Any risk
associated with its use including, but not limited to, loss of data
is borne by the user.






1) P-Shell contents

- PSHELL.COM {Executable file}
- SETUP.TXT {Configuration file for PSHELL.COM}
- READ.ME {Documentation}


2) Hardware requirements

- PC compatible
- CGA card (Colour or B & W monitor)


3) Purpose

- Perform DOS commands with minimal keystrokes
- Full screen directory searches with relevent files seperated from others
- User defined hot keys for repetive DOS commands
- Ablility to enter a DOS shell while PSHELL is in the background

4) Setup

- Between the dotted lines below is a sample of the configuration file
SETUP.TXT
- This file must exist in the same directory PSHELL is invoked from
- By editing this file(without altering the columns or adding or
deleting or rearranging lines) the user can configure PSHELL to
his type of monitor,editor, and programming language

-----------------------------------------------------------------
1-> |0x07 |
2-> |0x70 |
3-> |0x0A |
4-> |*.c |
5-> |*.h |
6-> |*.doc |
7-> |F2 {not assigned} 0 |
8-> |F3 Compile cc 2 -l/t |
9-> |F4 Trace ctr/m/g 2 |
10-> |F5 Link linker 2 |
11-> |F6 Execute 2 |
12-> |F7 Link w/window linker 2 window |
13-> |F8 GT PowerCom \com\gt\gt 3 |
14-> |F9 Dearchive pkxarc 2 \com\files\temp1 |
15-> |F10 Edit edit 1 |
-----------------------------------------------------------------

LINE FIELD COMMENT
---- ----- -------
1 Colour 0 Normal text colour. The default colours are set
for a B&W monitor. Change the last two digits
(i.e. 07) if you have a colour monitor. The
first of the two digits is the background and the
second is the foreground colour.
0 - Black 8 - Gray
1 - Blue 9 - L. blue
2 - Green A - L. green
3 - Cyan B - L. cyan
4 - Red C - L. red
5 - Magenta D - L. magenta
6 - Brown E - Yellow
7 - White F - Bright White
(e.g. 0xE4 would have a yellow background
and a red foreground as the normal text).

2 Colour 1 Hilighted text colour. See above for changes.
3 Colour 2 Reverse Video colour. See above for changes.
4 Mask 0 Default Mask. The first column of file titles
in the directory will have this mask. (i.e
only files that have a .C extention will be
shown). If you program in Pascal you can change
it to .PAS, BASIC to .BAS etc..
5 Mask 1 Alternate Mask 1. The default mask can be changed
on the fly to one of the alternate masks.
6 Mask 2 Alternate Mask 2.
7 F2 Function Key 2. The function keys work in
conjunction with the file under the cursor.
COLUMN PURPOSE
------ -------
1 Function Key name
2 Function Key title(to appear on screen)
3 DOS Command Prefix
4 Code where
0 = Ignore file and enter DOS shell
1 = Use filename and extention of file
2 = Use filename and not the extention
3 = Do not use filename in DOS command
5 DOS Command Suffix
(e.g to define F6 to type the desired file and
pipe the output to the MORE DOS command.
1 F6
2 Type -> More {or whatever}
3 TYPE
4 1 {as you want fname.ext}
5 | MORE
this would yield the DOS command
>TYPE filename.ext | MORE
and then return to PSHELL
8-15 F3-F10 Function Keys 3 to 10. Same as above.


5) Invoking PSHELL

- Type PSHELL (without parameters) in the same directory as SETUP.TXT'
exists.
- Five window will appear on the screen.
Clockwise from top left they are:
1 Directory of current path with default mask.
2 Directory of current path.
3 Directory of current path (.COM .EXE and .BAT files only).
4 List of hotkeys(Function keys) and other key bindings.
5 Comment window (with path name and size of current file in bytes).
- The following keys work in PSHELL
moves to window on the left.
moves to window on the right.
moves to previous file.
moves to next file.
moves to the first file on the screen.
moves to the last file on the screen.
moves to the previous set of files.
moves to the next set of files.
<^PgUp> moves to the first set of files.
if the cursor is on a directory then that directory becomes
the current directory
if the cursor is on an execuatable file (.COM .EXE .BAT) the
file is executed in a DOS Shell and after completion control
is returned to PSHELL
if the cursor is on a non-executable file then a primitive
editor is invoked so the files contents can be displayed.
B the current file is backed up (i.e. it is copied to a file
with the same name but with the extention .bak)
C the user is prompted for a path and that path becomes the
current directory
E the current file is erased (after confirmation)
H help
M a list of alternate masks is displayed
S the screen is refreshed (use this after a DOS command is
done that changes the directory or the files in the current
directory)
T examine the screen contents since the last DOS call
0 switch to mask 0
1 switch to mask 1
2 switch to mask 2
exit PSHELL to DOS


6) Final notes

- This is version 1 of PSHELL, version 2 will contain:
- A setup program to prompt for colours,key bindings etc.
- More user defineable keys
- Enable use of the SET command to locate SETUP.TXT
- TSR feature
- Printing
- More DOS commands (MD,RD,etc.)
- Tagging files for multiple deletions,compilations,or linking
- Faster execution with assembler code
- Smaller memory block

- I designed this because I was in need of a fast programming environment.
The MIX C environment is very slow but the only one that has an
inexpensive source debugger which is mandatory for serious C programming.
The only worthwhile Public Domain editor I found was QEDIT version 1.36
but it lacked a directory command. PSHELL is a good interface between
MIX C and QEDIT. However, it should be a good link between any editor
and programming language.



 December 5, 2017  Add comments

Leave a Reply