                SuperDIR 97 Version 6.19 Release README File
               Copyright (c) 1989-99, Omnivision Technologies
                      http://www.bigfoot.com/~superdir
                        email: superdir@bigfoot.com

===========================================================================
                             TABLE OF CONTENTS

1. What is SuperDIR 97?                8. Registering SuperDIR 97
2. Why use SuperDIR 97?                I. Shareware Licence Grant
3. SuperDIR 97 features               II. Registered License Grant
4. Installation                      III. Copyright
5. De-installation                    IV. Disclaimer
6. Using SuperDIR 97                   V. Trademarks
7. Contact Information

===========================================================================


1. What is SuperDIR 97?

SuperDIR 97 is a complete replacement for the MS-DOS "DIR" command with long
filename support under Windows 97. It has all the features of DOS's "DIR"
command plus a huge array of other useful features. Moreover, it still remains
extremely easy to use.

SuperDIR is released for distribution as Shareware. You can evaluate SuperDIR
for 30 days. If you wish to continue using SuperDIR beyond this evaluation
period you must register. The cost of registering is a mere AUS$19.97 (approx.
US$15.00) for a single licence.

---------------------------------------------------------------------------

2. Why use SuperDIR 97?

There are many of us who still prefer to use the command line to accomplish many
day-to-day file management tasks. The file management facilities in operating
systems such as Microsoft Windows 97 are often too slow and cumbersome. The most
common command issued at the command line is the familiar DIR command.

There have been many DIR replacements in the past which display files in
different colours according to their file extensions. However, with the
inclusion of long filenames in Microsoft Windows 97, our favourite DIR
replacement utilities are no longer functional. Super DIR 97 was the first DIR
replacement utility to implement the new long filename system and still remains
the only DIR replacement utility to correctly implement all features of this new
file system (known as VFAT).

---------------------------------------------------------------------------

3. SuperDIR 97 Features

   * Complete Windows 97 and MS-DOS 7.0/7.1 compatibility, including
     - Long filename (VFAT) support
     - Extended wildcard specifications
     - Full network support, including UNC specifications
       (eg. \\COMPUTER_NAME\SHARED_DEVICE)
     - Ability to display last access time, creation time or last write
       time for files
   * Display filenames in different colours based on their file extensions
     (user customisable)
   * Fully user customisable display formats
   * Support for 4DOS/NDOS filename descriptions (automatic detection)
   * Automatically maximizes the number of columns displayed based on the
     current display format and the length of the filenames being displayed
   * Ability to display only those files that have a specified attribute
   * Directory tree feature
   * Sort files based on various criteria in either a horizontal or
     vertical direction
   * Proprietary "TurboScroll" algorithm for incredibly fast scrolling
   * Ability to handle thousands of files in a single directory

... plus much, much, much more. Use the /? command line switch to see a
full list of SuperDIR 97 features. Use the /SET command line switch to
alter the default settings (interactive mode).

---------------------------------------------------------------------------

4. Installation

Copy SDIR.EXE to your DOS directory (usually C:\WINDOWS\COMMAND or C:\DOS)
or another suitable directory and then simply type "SDIR" instead of "DIR".
You may also like to rename SDIR.EXE to D.EXE and then type "D" instead of
"DIR". Make sure that this directory is contained in your path.

---------------------------------------------------------------------------

5. De-installation

Simply erase SDIR.EXE and SUPDIR.CFG from the directory you installed it
to. SuperDIR 97 does not modify your AUTOEXEC.BAT, CONFIG.SYS, WIN.INI,
SYSTEM.INI, system registry or any other files. It is entirely self
contained.

---------------------------------------------------------------------------

6. Using SuperDIR 97

The following is a brief summary of the SuperDIR usage and command line
options (taken from built in help):

    SDIR [drive:][path][filename] [ /A[[:][-]RHSDA] /B /BYTE /C /CLR
    /D[:]DA /E /F /FREE /H /I /J /L /M[:]NSDAF /O[:][-]NDESU /ORIG /P /Q /S
    /SET /T[:]ACW /TREE /TURBO /U /V /W /X /Y /7BIT /! /[1234] /? ]

    /A     Attribute specification      /B     Bare display format
    /BYTE  File sizes in BYTEs          /CLR   CLeaR screen before display
    /D     Disable colour               /E     uppEr case filenames
    /F     Full path name               /FREE  display FREE space
    /H     Hide dots                    /I     display drive Information
    /J     Justify names (8.3 only)     /L     use Lower case
    /M     Modify display format        /O     sort Order
    /ORIG  restore ORIGinal settings    /P     Pause between screens
    /Q     Quiet mode (disable output)  /S     recurse Subdirectories
    /SET   change default SETtings      /T     select date/Time to display
    /TREE  display directory TREE       /TURBO enable TURBO scroll
    /U     display only sUmmary info    /V     Verbose display format
    /W     Wide display format          /X     show 8.3 (vfat) filenames
    /Y     Vertical sorting direction   /Z     display file descriptions
    /7BIT  use 7 BIT ascii              /!     allow redirection (DOS writes)
    /[1234] limit min number of columns /?     this help information
    /INFO  licencing/registration INFO  /R     enter Registration details
    /Y     Vertical sorting direction   /Z     display file descriptions
    /7BIT  use 7 BIT ascii              /!     allow redirection (DOS writes)
    /[1234] limit min number of columns /?     this help information

A more detailed description of each option follows:

/A     Attribute specification
         R Read only
         H Hidden
         S System
         A Archive
         D Directory
       Limits the files displayed based on the attributes of the files.
       One or more attributes can be specified.
/B     Use bare mode (no header or summary information is displayed)
/BYTE  Display file sizes in bytes rather than KB, MB, etc.
/CLR   Clear screen before displaying anything
/D     Disable colour
         A Disable all colour
         F Disable file colour
/E     Use upper case characters for filename display
/F     Display full path names for each filename
/FREE  Display free space on drive at end of display (enabled by default)
/H     Hide dots (. and ..) from display
/J     Justify filenames (available for 8.3 filenames only)
/L     Use lower case characters for filename display
/M     Custom display format
         N Filename
         S File size
         T File date/time
         A File Attributes
         F FAT alias
         D File description
         (N and D are mutually exclusive)
       The order of the output is the same as the order of the parameters
       you specify. One or more parameters can be specified.
/O     Set sort order
         N Sort by name
         D Sort by date
         E Sort by extension
         S Sort by size
         U Unsorted
         G Group directories first
       Multiple sorting criteria is not available.
/ORIG  Restore original settings
/P     Pause between screens (enabled by default)
/Q     Quiet mode, i.e. don't display any output
/S     Recurse subdirectories. All directories below the current directory
       will be displayed.
/SET   Change default settings. This activates an interactive mode where
       various settings can be changed.
/T     Specify date/time display
         A Last access time
         C Creation time
         W Last write time (default)
       When a files date/time is displayed, this option selects which
       date/time to display. Under exclusive DOS mode, this option is not
       applicable.
/TURBO Enable turbo scroll which results in much faster scrolling (enabled
       by default)
/U     Display only summary information
/V     Verbose file display, i.e. display long filename, fat filename,
       date, time, size, and attributes
/W     Wide display format, i.e. display filenames only
/X     Display 8.3 FAT aliases (only applicable under Windows 97)
/Y     Vertical sorting direction as opposed to horizontal sorting
       direction. The files displayed on each screen are sorted in
       columns rather than rows.
/Z     Display file descriptions if they exist (enabled by default)
/7BIT  Use 7BIT ASCII (useful for outputting to a printer)
/!     Allow SuperDIR output to be redirected, i.e. use DOS screen writes
/[1234]Limit the minimum number of columns displayed. The output can contain
       more than the number of columns you specify, but it can never contain
       less.
/?     Displays this help information
NB: You can override preset switches by prefixing any switch with a - (hyphen)


Here are some examples of SuperDIR uses:

SDIR /A:H-S      Display all files which have the hidden attribute set and
                 also do not have the system attribute set
SDIR /Msna       Display the size, long filename and attribute properties
                 of all the files (in that order)
SDIR /O-S-G      Display all files sorted by decreasing size with directories
                 not grouped first (i.e. directories are sorted with the
                 files)
SDIR /Md /TC     Display the long filename and creation date/time properties
                 of all the files
SDIR /X          Display the long filename, size and 8.3 FAT filename of all
                 the files (i.e. standard format plus 8.3 VFAT filenames)
SDIR /Z          Display the size, 8.3 FAT filename and description of all the
                 files. The long filename of a file will be displayed instead
                 of the description if no desctiption exists (default)
SDIR /-W         Display all files in the standard format if /W is a preset
                 switch
SDIR /! > F.TXT  Re-direct output to F.TXT

---------------------------------------------------------------------------

7. Contact Information

Please mail of correspondance to sdir@ozemail.com.au

The SuperDIR 97 home page is located at:
    http://www.ozemail.com.au/~sdir

The latest version of SuperDIR 97 can always be obtained from this home page.

---------------------------------------------------------------------------

8. Registering SuperDIR 97

Registration costs AUS$19.97 (approx. US$15) and is for lifetime. Site licence
discounts are also available. When you register SuperDIR you will receive a
REGISTRATION KEY that will instantly register your copy of SuperDIR (use SDIR
/R to register SuperDIR).

You can pay for your SuperDIR registration using your credit card (VISA,
Mastercard, Bankcard), cheque, or international money order.

The easiest way to register SuperDIR is to use the online registration form
which can be accessed from the SuperDIR 97 home page
(http://www.ozemail.com.au/~sdir). Online registration is only available if you
are paying with your credit card. Your registration key will be usually emailed
to you within 48 hours of registration.

There are other ways to register too. You can fill out the registration form
accessible using the /INFO option (i.e. SDIR /INFO) or by directly editing the
ORDER.TXT file. You must then mail it to the given address. Alternatively, you
can email it directly to sdir@ozemail.com.au

By registering SuperDIR you will obtain the following benefits:
* a registration key that will work on all future versions of SuperDIR
* notification of future updates
* you will not be breaking the law
* you will have a clear conscience
* you will be supporting Shareware
* you will ensure continued development of this product

===========================================================================

I. Shareware Licence Grant

Please feel free to (a) upload SuperDIR to any Internet site or bulletin
board, (b) demonstrate the software and its capabilities or (c) give copies
to potential users, so that others may have the opportunity to obtain a
copy for use in accordance with the following license terms.

SuperDIR is released for distribution as Shareware. You have 30 days to
sample the full capability of SuperDIR - the Shareware version includes all
the features of the registered version. After this period, if you find that
SuperDIR is a valuable utility, then you must register your copy. Use the
/INFO switch followed by the "R" key to register.

The cost of registering is a mere AUS$19.97 for home, business, institution
or government users (quantity discounts available). Registered users will
receive a registration key which will register their copy of SuperDIR
(which will remove the nag screens) and receive notification of future
updates.

You may distribute this evaluation copy to others so that they may try it
out as well, as long as you distribute it with all related files. You must
not, however, sell or accept any money except a distribution fee charged by
shareware distribution companies. In addition, you must not tamper with any
of the files that come with SuperDIR. Doing so is illegal. Please note that
you risk prosecution if you do not register SuperDIR after 30 days of use.
Registration simply pays for continued development of this product. This
will make SuperDIR an even better product in the future.

---------------------------------------------------------------------------

II. Registered License Grant

You are authorised to make archival copies of this software for the sole
purpose of backing up your investment from loss. Under no circumstances may
you copy this software for the purposes of distribution to others. Unless
additional copies were registered, this software can only be used on one
computer at any one time, otherwise, it may be used on as many machines as
registered. In addition, you must not tamper with any of the files that
come with SuperDIR. Doing so is illegal.

---------------------------------------------------------------------------

III. Copyright

This manual and the software program it describes are copyright. It is
illegal to modify the software in any way, or disassemble it.

---------------------------------------------------------------------------

IV. Disclaimer

Although every effort has been made to ensure SuperDIR runs correctly,
Omnivision Technologies accept no liability or responsibility, for
consequences arising from the use of this product. If you do not agree with
the above conditions you should stop using SuperDIR and delete all copies of
the software.

---------------------------------------------------------------------------

V. Trademarks

All names are trademarks of their respective owners.


[2 May 1999]

