NEWSHELL
Format: NEWSHELL [<window specification>] [FROM <filename>]
Template: WINDOW,F ROM
Purpose: To open a new interactive Shell window.
Path: Internal
Specifications:
NEWSHELL invokes a new, interactive Shell. The new window becomes the
currently-selected window and process. The new window has the same current
directory, prompt string, path, and stack size as the one from which it was
invoked. However, each Shell window is independent, allowing separate input,
output, and program execution.
The window can be sized, dragged, zoomed, and depth-adjusted just like most
other Amiga windows.
To create a custom window, you can include the WINDOW argument. You may
specify the initial dimensions, location, and title of the window with this
<window specification> syntax:
CON:x/y/width/height/title/options
Where:
x
Is the number of pixels from the left edge of the screen to the left border
of the Shell window.
y
Is the number of pixels from the top of the screen to the top of the Shell
window.
width
Is the width of the Shell window, in pixels.
height
Is the height of the Shell window, in pixels.
title
Is the text that appears in the Shell window title bar.
The permissible options are:
AUTO
The window automatically appears when the program needs input or produces
output. With the Shell window, it will open for input immediately. The
window can only be closed with the ENDSHELL command. Selecting the Shell's
close gadget will close the window, but it will re-open immediately since it
is expecting input.
CLOSE
The window has all the standard gadgets, including a close gadget.
BACKDROP
The window appears on the backdrop, behind all the Workbench windows. The
only gadget in the window border is the zoom gadget. This Shell window
cannot be brought to the front of the screen; you have to resize the
Workbench windows to see it.
NOBORDER
The window opens without any left or bottom window border. Only the zoom,
depth, and sizing gadgets are available.
NODRAG
The window cannot be dragged. It has a zoom, depth and sizing gadget, but no
close gadget.
NOSIZE
The window only has a depth gadget.
SCREEN
The window will open on a public screen. The screen must already exist. You
must specify the name of the screen after the SCREEN keyword.
SIMPLE
If you enlarge the window, the text will expand to fill the newly available
space, allowing you to see text that had been scrolled out of the window.
SMART
If you enlarge the window, the text does not expand to fill the newly
available space.
WAIT
The window can only be closed by selecting the close gadget. (An example of
this is the Execute Command Workbench Output Window.) NEWSHELL uses the
default startup file S:Shell-startup, unless a FROM filename is specifed.
S:Shell-startup is a standard AmigaDOS script file. You might have several
different Shell-startup files, each having different command aliases, for
example. You can call such customized Shell environments with FROM.
The NEWCLI command has the same effect as NEWSHELL; it invokes a new Shell
process.
Example 1:
1> NEWSHELL
A new Shell window will open.
Example 2:
1> NEWSHELL CON:0/0/640/200/My5hell/CLOSE
A window starting in the upper left corner of the screen and measuring 640
pixels wide and 200 pixels high will open. The window will be titled MyShell,
and it will have a close gadget. If you add the command to your User-startup
file, a Shell window will open automatically when your Amiga is booted.
Example 3:
1> NEWSHELL FROM S:Programming.startup
Opens a new Shell, but instead of executing the Shell-startup file, the
Programming.startup file is executed. You could have aliases and prompt
commands in the Programming.startup file that you only use when you are
programming.
Converted from AmigaGuide to HTML by Jaruzel