=================================================================
README.SHL                                                 1/1/97
=================================================================

This README file explains how to install and customize Corel
Shell. It also outlines common Corel Shell 4.0 problems and
answers and gives information about temporary files and startup
options, differences between versions 3.1 and 4.0, and
enhancements introduced with Corel Shell 4.0.


SETTING THE CONFIG.SYS FILE
===========================
The CONFIG.SYS file contains commands that help set up your
computer. This file must found in your computer's root directory.

You can use Corel WordPerfect or a DOS text editor to create or
edit the CONFIG.SYS file.

Before you run Corel Shell, you need to set the FILES= and
BUFFERS= commands in the CONFIG.SYS file to at least FILES=50 and
BUFFERS=20.

Because Corel Shell lets you keep multiple programs in memory,
each program can keep multiple files open. Consequently, if you
plan on running several programs at once, you may need to set
the FILES= command higher than 50.


CREATING AND EDITING THE AUTOEXEC.BAT FILE
==========================================
You can set up an AUTOEXEC.BAT file in the root directory of
your hard drive.

Use Corel WordPerfect or a DOS text editor to create or edit the
AUTOEXEC.BAT file.

You can include the DOS PATH command in your AUTOEXEC.BAT file to
have DOS search in certain directories for program files. In the
DOS path command, include all the directories for the program
files you run from the Shell.

A sample AUTOEXEC.BAT file can contain the following commands:

path C:\;C:\COREL\WP62;C:\COREL\SH40
cd \COREL\SH40
shell

The "CD \COREL\SH40" command moves you to the directory where
Corel Shell is found and makes that your default directory.

Because the SHELL command starts the Corel Shell program, make
it the last command in your AUTOEXEC.BAT file.

When you start a program from Corel Shell, it searches for the
program file first in the default directory, then in the
directory listed at the upper left corner of your desktop
(C:\COREL\SH40), then in each directory in the DOS path. For
programs found elsewhere, you must include the path and filename
with the program.


RUNNING COREL SHELL
===================
To run Corel Shell from the DOS prompt,

1. Change to the directory where the Corel Shell files are
   found (C:\COREL\SH40).

2. Type SHELL, then press Enter.

On a stand-alone computer, if the Corel Shell directory is
included in the list of directories found in the path in your
AUTOEXEC.BAT file, you can start Corel Shell from any directory.

On a network, if the directory is listed in the path of
each user's AUTOEXEC.BAT file or the directory has been mapped,
you can start Corel Shell from any directory. However, you may
still be prompted for your user ID.

If you want to use the advanced macros included with Corel Shell,
type "MC SHELL" when you start Shell to also start the macro
engine.


GETTING ON-LINE HELP
====================
To display information about Corel Shell features,

1. Press F3 on any screen or dialog box.

Starting Corel Shell for the first time displays a Getting
Started dialog box. Press F3 in the dialog box to display a
screen where you can select topics to learn about creating
menus, using programs, and retrieving and converting old Shell
menu files.

Often Help screens list other Help topics you can jump to. The
names for these other Help topics are bolded.

Use the arrow keys to move up and down from topic to topic,
Press Tab (forward) or Shift-Tab to move forward and backward
from topic to topic.

Once a topic is highlighted, press Enter to display information
about that topic.

You can use the Help index to learn about the following
convenient features:

File Manager
Use File Manager to find, organize, copy, and manage files
without having to return to DOS.

Message Board
Instead of writing notes on paper, use the personal message
board to make quick notes or reminders. On a network, the
shared message board works like a public bulletin board.

Clipboard
Clipboards store information for transfer to other programs. The
Corel Shell 4.0 Clipboard is file-based. It copies information
to a temporary file. You can create as many as 80 clipboards.

Corel Shell Macros
Use macros to record keystrokes or commands. You can automate
virtually any task performed in Corel Shell or in programs
running under it. You can use advanced macro commands and
variables to create complex macros.


CUSTOMIZING COREL SHELL 4.0 ON A NETWORK
========================================
Several additional steps are necessary to customize Corel Shell
on a network.

Creating the SH{SH}.ENV File
----------------------------
In order for Corel Shell to function correctly on a network, you
must create an environment file in DOS text file format and place
it in the same directory as SHELL.EXE.

The environment file is called SH{SH}.ENV. It alerts Corel Shell
that it is running on a network.

The SH{SH}.ENV file must contain the following startup option:

  /NT-x, where x is the network type.

It can also contain any of the following options:

  /PS-path, where path is the pathname of the drive and directory
  where you want to send user's .SET and .VEW files.
  /D-path, where path is the pathname of the drive and directory
  where you want to send user's temporary files. Temporary files
  are deleted when users exit Corel Shell.
  /V-path, where path is the pathname of the file where the disk
  swap file directory is sent. The disk swap file is a temporary
  file created when users switch from one program to another.

  All users must have all rights to these directories except for
  access control and supervisory rights (on a Novell network).

  If you do not want to include these options in the SH{SH}.ENV
  file, you can add them to the Novell Login Script (on Novell
  networks), to a batch file, or to a DOS Environment variable.

To use the COPY CON command to create a SH{SH}.ENV file,

1. Change to the directory where the Corel Shell files are found
   (C:\COREL\SH40).

2. Type COPY CON SH{SH}.ENV at the DOS prompt, then press Enter.

3. Type /NT-x, where x is the network type, then press Enter.

4. Enter any other options you want to include in the SH{SH}.ENV
   file.

5. When you have finished entering options, press the F6 function
   key, then press Enter.


SELECT PROGRAMS
===============
Use Select Programs when you want to choose the programs you want
on your Corel Shell menu and then have it created for you.

1. Choose Select Programs (1) from the Getting Started dialog
   box.

   The List Programs dialog box is displayed.

2. Select Program Type (1) to display the possible program types.

   You can select from the following program types:

   COMMON PROGRAMS
   Program files you may have that are widely used throughout the
   computer industry and that have a .EXE or .COM extension.

   ALL PROGRAMS
   Any files with a .EXE or .COM extension.

   MACROS
   Any files with a .SHM or .KBM extension. These files contain
   Corel Shell and keyboard macros.

   BATCH FILES
   Any files with a .BAT extension.

   COREL PRODUCTS
   The program files for any product provided by Corel.

3. Select a program type, then press Enter.

   You can have the search include only the C: drive, the files
   and directories in your DOS path, or another directory of your
   choice.

4. Select Search Directories (2), select an option to indicate
   the scope of your search, then press Enter.

5. Press Search (F2) to begin the search.

   While the search is in progress, the Program Search dialog box
   displays the names of the directories and files being
   searched.

   Once the search is completed, the List Programs dialog box
   appears. It lists the programs that you want added to the
   Corel Shell menu.

6. Highlight a program you want to include on the menu,
   then select Mark for Add (1) or type an asterisk (*) to mark
   that program with an asterisk.

   The descriptions displayed for the executable (*.EXE) files
   are not always complete. Consequently, when you select a
   program, the complete pathname of the program file is listed
   at the bottom of the dialog box. This information may help you
   decide if this is a program you want to add to the menu.

7. Repeat step 6 for each program you want to add to your menu.

8. Move to Add to Menu, then press Enter.

   The Menu Description dialog box is then displayed.

9. Type the title of your menu in the Enter Description box, then
   move to OK and press Enter.

   or

   Move to OK, then press Enter to leave the new menu untitled.

The menu is created and displayed.


FIND SHELL 3.X MENU
===================
Use Find Shell 3.x Menu to find the Shell menu you used with
WordPerfect Office 3.0, 3.01, or 3.1 and convert it to
Corel Shell 4.0 format.

1. Select Find Shell 3.x Menu (2) from the Getting Started dialog
   box.

   On a network, if a version of WordPerfect Office is on your
   system, you are asked for your user initials.

2. Enter your 3-letter user identification.

   or

   Continue to step 3.

   The program then searches for the 3.x menu file.

   If a Shell 3.x menu file is found, it is converted and
   displayed. You can then use it as it is or edit it.

   If no Shell 3.x menu file is found in the current DOS path,
   the following error message is displayed:  "Shell 3.x menu
   file not found."

3. Move to OK, then press Enter to return to the Getting Started
   dialog box.

You can then use the Retrieve Menu File option to retrieve a menu
file.


RETRIEVE MENU FILE
==================
The Retrieve Menu File option lets you input the drive letter and
directory path for the menu file you want to retrieve. You can
use this option to retrieve either a 3.x or a 4.0 menu file.

However, do not use this option to retrieve the SH{SH__}.MNU
master menu file because this will create a duplicate menu.

1. Select Retrieve Menu File (3) from the Getting Started dialog
   box.

   The Add Menu File dialog box appears, asking you for the name
   of the menu file you want to retrieve.

2. In the Filename box, type the path and filename of the 3.x or
   4.0 menu file you want to retrieve.

   You can use the File List (F5) or QuickList (F6) features to
   find a menu filename and insert it in the Filename box.

3. Move to OK, then press Enter to retrieve the file.

The file is converted and displayed. You can then use it as it
is or edit it.


CREATE MENU MANUALLY
====================
Use Create Menu Manually to create a blank Shell menu with no
programs added to it. You can then use Shell menu setup options
to add the menu items you want.

1. Select Create Menu Manually (4) from the Getting Started
   dialog box.

   The Menu Description dialog box is displayed.

2. Type a new title for your menu in the Enter Description box,
   move to OK, then press Enter.

   or

   Move to OK, then press Enter to leave the new menu untitled.

   The new menu is created and displayed.

   You can now add program items to your new Shell menu.

3. Press Insert.

   or

   Select Add Item from the Menu menu.

   The Add Items dialog box is displayed.

   You can use Program to add program and macro items to your
   menu, Menu to create a submenu, and Text to add titles that
   are for display only.

4. Select Program (1) to begin adding a new program to your menu.

   The Define Program dialog box is displayed.

5. Use the Define Program options to input the necessary informa-
   tion about the program you want to add (as explained below).

6. Move to OK, then press Enter or Exit (F7) to return to the
   menu and add the new program item to it.

The Define Program dialog box contains the following items:

DESCRIPTION
This box contains the text that identifies this program
on the Corel Shell menu.

Select Description (1), type the text, then press Enter.

If you want the title to include a mnemonic letter that you
can press to start the program, place a tilde (~) before the
character you want to use as the mnemonic.

FILENAME
This box should contain the pathname of the file that program
is using. Executable files are used to run programs. They
have one of the following extensions:  .EXE, .COM, .BAT,
.SHM, or .KBM. You do not need to include the extension
with the filename. However, if you do, the extension must
match the program type (see Type below) or the following error
message is displayed when you try to save the program
definition:  "The filename for this program is not a
standard DOS executable filename (.COM or .EXE)."

Select Filename (2), then type in the pathname of the file, or
use Directory Tree (F8) or File List (F5) to insert it.

DEFAULT DIRECTORY
This box should contain the pathname of the default directory
for the files you use when you run the Shell. Normally, you
can leave this box blank. However, if you are having problems
loading the Shell program, type the pathname of the directory
where the executable file for the program you are adding is
found (the same directory also used in the Filename box,
above).

MACROS DIRECTORY
This box should contain the name of the directory where you
want to place the macros created for this program item.
You can create and use several convenient macros. See Macros
in the Corel Shell on-line Help Index.

TYPE
This box lets you indicate the type of program file you are
using:  Normal for *.EXE or *.COM files, DOS/Batch for *.BAT
files, or Macro for *.SHM or *.KBM files.

HOTKEY
This optional box lets you select the hotkey you want to use
for this program. You can then press Control-Alt-hotkey (the
default keystroke) from any program to move to this program,
where hotkey is any letter from a-z or any number from 0-9.

If you include a mnemonic letter in the Description, that
letter is also inserted as the hotkey letter. If the hotkey
has already been assigned, changing the mnemonic does not
change it.

To change the hotkey letter, select HotKey (5), then type the
key you want to use.

ADVANCED OPTIONS
The advanced options let you insert command line options and
preloaded commands for the program. They also let you
disable the hotkey letter and start the program as resident on
the Corel Shell menu. To learn how to use these options, see
Advanced Options in the online Help index.

CHECKING FOR THE NETWORK ENVIRONMENT FILE
After you have a menu file, the main system menu is displayed.

You now need to verify that your system is reading the Corel
Shell environment file (SH{SH}.ENV).

 1. Press Shift-F1 to display the Setup dialog box.

 2. Select Environment (3) to display the Environment dialog box.

 3. Make certain that the Environment dialog box includes the
    Network Administration (n) option (highlighted above).

 4. If the Network Administration option appears, the system is
    reading the environment file. Move to OK, then press Enter
    to return to the main menu.

    or

    If no Network Administration option appears, you need to make
    certain that the environment file is in the same directory as
    SHELL.EXE and is named SH{SH}.ENV (see Creating the SH{SH}.ENV
    File earlier in this section). Continue following the above
    steps until you can verify that the Network Administration
    option exists. Once it does, move to OK, then press Enter
    twice to return to the main menu.

    A Corel Shell menu is displayed.

 5. If you want to use the displayed menu as the master menu,
    press Shift-F10 to display the Menu Files dialog box. Make
    certain that this dialog box lists the path and filename of
    your master menu file, then move to OK and press Enter to
    return to the menu. You can then press F10 to save the view,
    and advance to the User Access section below.

    or

    If the menu is blank, as shown above, continue following the
    steps in order to retrieve a menu.

 6. Make certain that you are the network administrator and have
    started using the program by entering shell/u-{sh at the DOS
    prompt.

 7. Press Shift-F10 to display the Menu Files dialog box.

 8. Select Remove (2) to remove any menu files from the list.
    Note that this does not delete the menu files; it simply
    removes them from the list to avoid confusion.

 9. Choose Add (1), then type the path and filename of the menu
    file you want to use as the master menu. Be sure to include
    the .MNU extension.

    The standard network master menu file is called SH{SH__}.MNU.
    It is found in the same directory as the SHELL.EXE file.

    You can press File List (F5) and QuickList (F6) and use these
    features to insert a filename.

    Once you are sure you've typed the filename correctly, press
    Enter.

10. Make certain the Menu Files dialog box lists the full pathname
    of the menu file you want to use.

11. Note the description given for the menu file. You will use
    this description to identify it.

12. Move to OK, then press Enter or Exit (F7).

    You are returned to the main menu. However, it is still
    blank. You now need to select the master menu.

13. Press Ctrl-O to display the Go To Menu dialog box.

    The master menu is listed by the description you noted in
    step 11 above.

14. If necessary, highlight the menu you want to as the main
    master menu.

15. Choose Select Menu (1) to select it.

    The main master menu is now displayed.

16. Use the mouse to position and size the menu as you want it by
    clicking the left mouse button on the side of the menu and
    dragging it to be the size you want.

    or

    Use Tab to move to the menu you want to size, then press
    Ctrl-F3 to display the keyboard options.

    Use the keyboard options to reposition and size the items you
    want.

17. When you've finished arranging the menu, press F10 to save the
    view and create the master view file.

All view files have .VEW extensions. The master view file is
called SH{SH__}.VEW. The view files are found in the directory
you indicate using the /PS option in your environment file.
See Creating the SH{SH}.ENV File earlier in this section.

You are returned to the main master menu.

If the menu you want is still not displaying as the main master
menu in Corel Shell 4.0, repeat steps 6-15 above to select the
master menu.


USER ACCESS
===========
If you want to let all system users create and change their own
menus, you can skip this section.

To keep users from creating and changing personal menus so
that they will have access only to the master menu,

1. If necessary, enter SHELL/U-{SH at the DOS prompt to start
   Corel Shell as the network administrator.

2. Press Shift-F1, then select Environment (3).

3. Type n to select Network Administration and display the
   Network Administrator Options dialog box.

4. Select Restrict User Access (2) to insert an X in the Restrict
   User Access check box.

5. Move to OK, then press Enter to leave the Network Administra-
   tor Options dialog box and return to the main master menu.


LOCATION OF FILES
=================
As network administrator, you may also want to make sure that the
Location of Files options indicate the correct directories.

1. If necessary, enter SHELL/U-{SH at the DOS prompt to start
   Corel Shell as the network administrator.

2. Press Shift-F1, then select Location of Files (4) to display
   the Location of Files dialog box.

3. Make certain that the various Location of Files options
   contain the pathnames of the directories you want to use
   (explained below).

   You can move to an option, press Directory Tree (F8) or
   QuickList (F6), then use these features to select a directory
   name.

4. Once each box lists the directories you want to use, move to
   OK, then press Enter to save your selections.

The Location of Files dialog box contains the following options:

SYSTEM MACRO FILES
The System Macro Files option (1) should contain the full
pathname for the directory where the system macro files are
stored. No system macros are shipped with Corel Shell. However,
any macros you create in the future will be placed in the
directory listed here. Also, you need to move any previously
created macro files into this directory. It is a good idea to
store your shared macro files in a shared directory, which
users have all access rights to, except for access control and
supervisory rights.

To learn more about Corel Shell macros, see Macro in the online
Help index.

LOCAL MACRO FILES
System users can use the Local Macro Files option (2) to
indicate the name of a directory they use for storing their
personal macro files. As the network administrator, you can
leave this entry blank.

MENUS
Selecting the Menus option (3) displays two possible options:

  PERSONAL DIRECTORY
  This box lets system users indicate the name of the directory
  they want to use for their personal menu files. As the
  network administrator, you can leave this entry blank for the
  users to complete.

  SHARED DIRECTORY
  This box lists the full pathname for the directory that
  contains the master system menu files. By default, menu
  files are placed in the same directory as SHELL.EXE. If you
  change the location, you then need to place any menu files
  you have created in that directory.

MESSAGES
Selecting the Messages option (4) displays two possible options:

  PERSONAL DIRECTORY
  This box lets system users indicate the name of the directory
  they want to use for storing their personal messages for the
  Message Board. As the network administrator, you can leave
  this entry blank for the users to complete.

  SHARED DIRECTORY
  This box should contain the full pathname of a drive and
  shared directory, which users have all access rights to,
  except for access control and supervisory rights (on Novell
  networks).


SETTING UP COREL SHELL 4.0 AS A USER
====================================
Once you've finished customizing the system options, you
are ready to start the Corel Shell as a user.

The following instructions guide you through personalizing a
Corel Shell.

1. Log into the network as a user, then enter SHELL at the DOS
   prompt.

   or

   Enter SHELL/U-xxxxx where xxxxx represents your user initials.
   The /u option is explained under Startup Options, below.

2. If you marked the Restrict User Access option on the Location
   of Files dialog box with an X when you defined the Corel Shell,
   an exact duplicate of the master menu is displayed. As a user,
   you can only change the Setup (Shift-F1) options.

   or

   If you didn't mark the Restrict User Access option with an X
   as the network administrator, the Getting Started dialog box
   is displayed.

This is the same dialog box that you used to create the master
menu for your system. You can now use its options to create a
personal Shell menu, as explained under Selecting the
Network Master Menu earlier in this guide.


COREL SHELL ERROR MESSAGES
==========================
The following error messages are not self-explanatory.

Cannot create more than 16 levels
---------------------------------
You can only have 16 levels of submenus.

Cannot delete a menu that contains active programs.
---------------------------------------------------
You attempted to delete a menu containing a currently resident
program. Exit the program, then change the program entry.

Cannot install the . . .
------------------------
You tried to add a program that can't run under Corel Shell.

Cannot modify or delete an active program.
------------------------------------------
You tried to modify a program that you have open. Exit the
program then change the menu entry.

Cannot remove a file that contains active programs.
---------------------------------------------------
You can't remove a menu file from the Menu Files list if it
contains any files for programs that you have open. Exit those
programs.

Can't transfer control.
-----------------------
There isn't enough disk space, expanded memory, or extended
memory to hotkey from the current program. Free up some space.

Directory listing exceeds the buffer limit.
-------------------------------------------
The DOS path expands to a size greater than allowed in list
programs.

Entry is required.
------------------
You must enter a filename pattern when adding a QuickList entry.

Insufficient cache memory.
--------------------------
Use the /w startup option to increase work space or install more
expanded or extended memory.

Insufficient rights to create a message.
----------------------------------------
You can't create a message when the message board directories are
read-only.

No search directories selected.
-------------------------------
You tried to perform a search after selecting "Other" and adding
no directories.

Pasting will create more than 16 levels.
----------------------------------------
You can't paste in the selected location because the result would
create more than 16 levels of submenus.

Program not found.
------------------
The program name is not in the path. You must add the full path
to the filename line or the default directory line in the Default
Program dialog box.

Resulting command line options are too long.
--------------------------------------------
Either the command line options are too long or you marked the
compatibility box in Advanced Options under Program Definition.

Shell requires at least one menu.
---------------------------------
You tried to delete all menu files from the Menu Files list. You
must have at least one.

Too directories listed.
-----------------------
The length of the total directories exceeds buffer size.

Unable to create batch file needed to run program.
--------------------------------------------------
There isn't enough memory in Shell of the directory for temporary
files to create the batch file for the specified program.

Unable to open file.
--------------------
Corel Shell can't find the menu file. Add the menu file to the
Menu Files list.


MEMORY USAGE
============
Corel Shell lets you keep several programs resident in memory
while you switch from program to program. When you start a
program, the information needed to start the program resides in
conventional memory. When you leave one program resident to
switch to another program, the first program is swapped to
memory.

Corel Shell uses any available expanded memory, extended memory,
hard disk space, and RAM drive space to swap programs. Shell
swaps programs first to expanded memory, the extended memory,
then to RAM drive space. It also supports the
Lotus/Intel/Microsoft (LIM) Expanded Memory Specification.

You can use the /v option to specify the drives (2 max) you
want to use for memory swapping. If you don't want to
use expanded or extended memory, use the /ne or /nx startup
option. To limit the amount of expanded or extended memory
available for swapping, use the /el and /xl startup options.
See Corel Shell 4.0's Launcher Startup Options below.

When there isn't enough memory to swap a program, the following
message is displayed:  ERROR: Insufficient memory. You then
need to exit a resident program before starting a new one.


COREL SHELL 4.0 STARTUP OPTIONS

USING STARTUP OPTIONS
=====================
Type each option exactly as given, include slashes, commas,
semi-colons, or brackets. Separate arguments by commas. Enclose
extra information in brackets. You can use several options
together, in any order, and place an optional space between
options.

You can include startup options when you start Corel Shell from
DOS, for example: shell/d-c:\temp. You can use the DOS SET
environment to assign startup options, for example set
sh=d-c\temp. If you include the command in your AUTOEXEC.BAT
file, you can add startup options to that command.

/32             Lets you use Lotus Intel Memory Specifications
                (LIM 3.2). May be necessary for compatibility
                with older memory drivers.
/?              Displays the available startup options without
                starting Corel Shell.
/cp=<number>    Tells the Corel Shell program to use the code
                page indicated by number. Code Pages are
                character sets you can select for specific
                languages and language groups. See your DOS
                manual.
/d=d:\path      Redirects Corel Shell's temporary files to the
                directory indicated by path. You can only use one
                path. For example, use /d=d:\path.
/da             Forces Corel Shell to not take advantage of the
                task-swapping ability of DOS 5.0 higher that
                conflicts with Corel Shell's own task-switching
                ability.
                May solve problems with swapping programs.
/el-<limit>     Expanded memory manager swapping limit in
                kilobytes.
/h              Displays startup options without starting Corel
                Shell.
/l=<language>   Starts Corel Shell in a given language, where
                language is a two-character .TRS file language
                ID.
/m=<macroname>  Runs the macro as you start Corel Shell. If the
                macro is not found in the current directory, be
                sure to include the complete path with the macro
                name.
/mono           Lets you emulate a monochrome monitor.
/mnu=<menuname> Lets you specify which menu (in a network
                setting) should be used as a template. Lets users
                bypass the Getting Started dialog box that
                initially displays when you start Corel Shell.
/mt=<number>    Tells Corel Shell to override the current monitor
                type, where <number> is the number for the
                monitor type.
/n              Starts Corel Shell without starting resident
                programs. Any program marked to be loaded will
                not be left resident.
/ne             Starts Corel Shell without expanded memory.
/nf             Starts Corel Shell with a non-flash display.
/nk             Eliminates advanced keyboard bios calls in the
                keyboard that you are using which may conflict
                with bios calls and cause problems.
/nt=<n>         Indicates the network you are using, where n is
                the network ID number, such as 1 for Novell
                Netware.
/nx             Starts Corel Shell without extended memory.
/pe<progs>      Specifies the number of programs to let resident,
                where <progs> is the number of programs.
/ps=d:\path     Indicates the directory for the Shell .SET and
                .VEW files.
/r              Puts SHELL.OVL in extended or expanded memory.
/re             Puts SHELL.OVL in expanded memory.
/rx             Puts SHELL.OVL in extended memory.
/sa             Starts Shell as a stand-alone program (disables
                the network).
/sb-<mins>      Default screen blank-out time in minutes.
/ss=rows,cols   Sets the screen size the same as for the Corel
                WordPerfect /ss option.
/tsr            Loads the macro engine (MC.EXE) as a Terminate
                and Stay Resident (TSR) program. The /TSR option
                is valid only for the macro engine (MC.EXE).
                Enter mc/tsr at a DOS prompt. To load the macro
                engine into upper memory, use a utility in
                addition to this startup option (for example,
                enter LOADHIGH C:\COREL\SH40\MC.EXE
                /TSR).
/u=xxxxx        Starts Corel Shell for a user, where xxxxx is a
                user's initials. Although Shell 3.1 used only
                three letters, Corel Shell 4.0 can use up to
                five. If no previous user initials exist, Corel
                Shell 4.0 creates default five-letter user
                initials for each user, based on network names.
                To learn a user's default network user initials,
                log in as that user, press Alt-h to display the
                Help menu, then type "s" for information. The
                default user initials are listed as the user's
                Network ID. You can use the /u startup option
                with the DOS SET Environment variable or the WPC
                environment string to change the default initials
                for the users on your system.
/w=kk,kk,kk     Sets the workspace size in kilobytes, where
                kk,kk,kk represents CONV,EMS,XMS.
/ws             Displays available workspace.
/x              Disables default setup file changes.
/xl-<limit>     Extended memory swapping limit, in kilobytes.

COREL SHELL 4.0'S LAUNCHER STARTUP OPTIONS
/el=<number>    Sets the EMM swapping limit, where number is a
                number in kilobytes.
/xl=<number>    Sets the XMS swapping limit, where number is a
                number in kilobytes. This option is only
                available in Corel Shell 4.0b and later.
/ll             Loads the program launcher into conventional
                memory.
/nv             Eliminates disk (virtual) swapping so that you
                cannot swap to disk.
/pe=<number>    Limits the number of programs you can leave
                resident at any one time, where number is a
                number from 7 to 40.
/sb=<number>    Sets screen blanking time, where number is a
                number in minutes. You must insert the /SB option
                on the Command Line Option for Corel WordPerfect
                6.x for the Corel Shell screen saver to work.
/v-path         Specifies which disks you want used (2 max) when
                Corel Shell swaps memory. Also specifies a limit
                for each disk. Use path1[lim1];path2[lim2].
                Available in Corel Shell 4.0 and later releases.


DIFFERENCES BETWEEN SHELL 3.1 AND COREL SHELL 4.0
=================================================
MEMORY REQUIREMENTS
Shell 3.1 requires 53K of memory (unless you swap out the Shell).
This memory is used to enable macros and task switching.

Corel Shell 4.0 automatically loads high and uses expanded,
extended, and virtual disk memory. Therefore, as you switch
between applications, all conventional memory is available for
your applications.

MEMORY MANAGEMENT
Shell 3.1 supports swapping of resident programs to expanded
memory and to disk. It does not support extended memory.

Corel Shell 4.0 supports expanded and extended memory. It also
uses virtual memory from available disk space.

SUBMENUS
In Shell 3.1, you display only one menu at a time. Each submenu
was maintained in a different file.

With Corel Shell 4.0, you can open and display several menus
at a time. You can also size, tile, and cascade menu windows.
All the submenus of a menu are stored in one menu file. You can
display the organization of a menu file and its submenus by using
Go To Menu (Ctrl-O).

MNEMONICS
In Shell 3.1, each item in a menu or submenu had to have a unique
mnemonic.

In Corel Shell 4.0, you can have several items with the same
mnemonic. When a conflict exists, you are asked to clarify your
selection. In addition, Corel Shell 4.0 checks through all open
windows to determine if the item you selected is already
displayed.

HOTKEYS
In Corel Shell 4.0, hotkeys function separately from mnemonics.
When duplicate program and submenu items have the same hotkey
character, you are asked to clarify your selection. Possible
hotkey characters are 0-9 and a-z. Corel Shell 4.0 checks for
hotkeys through all menu entries (including closed menus).

STANDARD HOTKEYS
In addition to the hotkeys used to move between menu items, an
additional set of standard hotkeys is provided to access Corel
Shell 4.0 functionality. For instance, if you need to display a
file list when using TAPCIS under Corel Shell 4.0, you can simply
press Alt-Ctrl-F5. You can use Alt-Ctrl-F2 to display a complete
list of available hotkeys.

NETWORK MENU
In Corel Shell 4.0, a network administrator can define which
network menus can be used but not modified by all network users.
When an administrator changes any item on a network menu, that
change is automatically provided to each network user without
disrupting the user's personal menus or forcing all users to use
the same personal menus.

MACROS
The Corel Shell 4.0 macro language is essentially equivalent to
that provided with Shell 3.1.

In addition, Corel Shell 4.0 includes record and playback
keystroke macros and programmable macros accessed by loading a
Macro module, which is installed as a TSR and can be loaded into
high memory.

To learn about macros, see Macros in the online Help index.

HARDWARE REQUIREMENTS
Shell 3.1 runs on any PC/XT compatible machine.

Shell 4.0 requires a 286 computer or better. For best
performance, 2M RAM or more is highly recommended.


MEMORY DUMP POTENTIAL WITH OS/2
===============================
When you run Corel Shell on OS/2, and you use the Ctrl+Alt+F10
keystroke to run macros, be sure not to inadvertantly press the
F10 function key twice. On some systems, doing this can start a
memory dump.

On OS/2 systems, you can copy the current contents of your memory
to disk to send it to IBM technical support by holding down
Ctrl+Alt, then pressing the Numlock key twice. When the memory
dump starts, any programs you have open on the Shell are
terminated and you will lose any unsaved changes. The contents of
any data on the floppy in your A: drive is also lost because the
A: drive floppy is immediately reformatted to a proprietary
format.

Consequently, be aware that on OS/2 systems holding down Ctrl+Alt
and then pressing the F10 function key or the Numlock key twice
can start a memory dump.


COREL SHELL 4.0 ENHANCEMENTS
============================
DEFINE PROGRAM
In the Define Program dialog box, pressing PgDn or PgUp now takes
you to the next or previous program in the current menu window so
you can quickly edit program information for different programs.

DEFAULT PATHNAMES
In many of the text boxes where you are asked for a pathname, you
can now enter a valid drive letter and have it expand to list the
default directory for that drive.

For example, if you enter x: in the Define Program dialog box,
the x: expands to list the default directory for that drive.

MULTIPLE MENU FILES
Since you can open multiple menu files at any given time in Corel
Shell 4.0, groups of users can even share certain menu files for
specific functions. For instance, users in a law firm who need
to access a specific set of time and billing programs can all
point to a common menu file with these program items. These users
can be accessing the network menu file and their own personal
menu files at the same time.

IBM LAN SERVER
If you are running Corel Shell on an IBM LAN Server, call IBM at
(800) 237-5511 to obtain a new REDIR (redirector). Be prepared to
give the operator your customer number, software package, and
operating system, then ask for APAR #IC05512 to transfer to a
technician that can give you the redirector.

MENU WINDOWS
You can now have a maximum of 12 menu windows open on the desktop
at one time and use Ctrl-Up Arrow and Ctrl-Down Arrow to
maximize, minimize, and restore menu windows.

MOUSE
If MOUSE.COM is not your mouse driver, you may have to reselect
your mouse each time you hotkey to another program.

ADD PROGRAM
In the Preloaded Commands group box in the Options dialog box
under Advanced Options for program information, typing text that
wraps to the next line inserts a soft return. When you start the
program, the soft return is treated as a space.

QEMM MEMORY MANAGER
If you are using QEMM as a memory manager, do not use the
QEMM Stealth feature with Corel Shell 4.0 as it may behave
erratically.

COREL SHELL UNDER OS/2
If you are running Corel Shell 4.0 under OS/2 2.x, you may want
to customize some settings.

When you create the icon for Corel Shell 4.0, enter SHELL.COM in
the Path and Filename text box for that icon.

In the Optional Parameters text box, enter /LL as well as any
other startup options you want to use. Click the Session tab,
select DOS full screen, then turn on DOS_UMB.

MACRO INFORMATION
The SHELLMAC.TXT file contains macro information that has been
changed or updated since Shell 3.1.

DISPLAY
A new color scheme, Tara (16 Grey), has been added to Corel
Shell 4.0. This color scheme shows mnemonics with greater
contrast on monochrome VGA displays.

LIST PROGRAMS
Editing the description for a program in the List Programs dialog
box now marks that program for addition to the menu.

ADVANCED MACROS
The {Active Programs} macro command has been renamed to {Resident
Progs}.

MESSAGE BOARD
Pressing Save (F10) from the Message Board dialog box saves the
highlighted message. Pressing F4 saves the attachment of the
highlighted message.
