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

                         List2000 Version 1.05

                               -FREEWare-

             Copyright (c) 1998-2001, Massimiliano Giarratana

                http://members.tripod.com/~mgiar/index.html

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

                             TABLE OF CONTENTS

1.   What is List2000?
2.   List2000 features
3.   Installation
4.   De-installation
5.   Using List2000
6.   How to modify colours
7.   Registration
8.   Disclaimer Warranty
9.   Contact information
10.  Revision history

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

1. What is List2000?

List2000 is a replacement for the MS-DOS "DIR" command. It has most of the
features of DOS's "DIR" and display files in different colours according
to their file extensions. It is extremely easy to use. List2000 will operate
under Microsoft Windows 9x,NT. There have been many DIR replacements, however,
with the inclusion of long filenames in Microsoft Windows 95, our favourite
DIR replacement utilities are no longer functional. List2000 is a free DIR
replacement utility which implements the new long filename system,which is
known as VFAT. List2000 1.05 doesn't implement the older FAT system.

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

2. List 2000 Features

   * Long filename (VFAT) support
   * Display filenames in different colours (user customisable)
   * Automatically calculates the column format on the basis of the length
     of the filenames being displayed
   * Sort files based on various criteria
   * Ability to handle thousands of files in a single directory.

Use the /? command line switch to see a full list of List2000 features.
Modify list.cfg file to alter the default colours settings.

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

3. Installation

Copy LIST.EXE and LIST.CFG to your DOS directory (usually C:\WINDOWS\COMMAND
or C:\DOS) or another suitable directory and then simply type "LIST" instead
of "DIR". You may also like to rename LIST.EXE to L.EXE and then type "L"
instead of "DIR". Make sure that this directory is contained in your PATH
variable: for instance if you installed List2000 under "C:\INSTALL_DIR"
add following line to your AUTOEXEC.BAT file "PATH C:\INSTALL_DIR".

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

4. De-installation

Simply erase LIST.EXE and LIST.CFG from the directory you installed it to.
List2000 does not modify your AUTOEXEC.BAT, CONFIG.SYS, WIN.INI, SYSTEM.INI,
the Registry or any other files.

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

5. Using List2000

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

    LIST [drive:][path][filename][/][-][DNSVX?]

    /D     Disable colour
    /N     Disable sort order by name
    /S     Enable sort order by size
    /V     Enable verbose display format
    /X     Modify sort order by extension by name

Here are examples of List uses:

LIST             Display files in the column format by name
LIST /D          Display files in the column format by name disabling colours
LIST /S          Display files in the column format by size
LIST /X          Display files in the column format by name by extension by name
LIST /V          Display files in the verbose format by name
LIST /VS         Display files in the verbose format by size
LIST /VSX        Display files in the verbose format by size by extension by name
LIST /?          Display help

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

6. How to modify colours

Available colors are:

    BLACK
    BLUE
    GREEN
    CYAN
    RED
    MAGENTA
    BROWN
    LIGHTGRAY
    DARKGRAY
    LIGHTBLUE
    LIGHTGREEN
    LIGHTCYAN
    LIGHTRED
    LIGHTMAGENTA
    YELLOW
    WHITE

* Filename extensions:

In order to define different colours for new filenames extensions
you have to edit the configuration file LIST.CFG and modify/add entries
under FILE_COLOUR section;

example:

[FILE_COLOUR]
doc            WHITE

 |               |
 |               |___ edit second field in order to define an available colour
 |
 |
 |____ edit first field in order to specify that every file which take such
       extension will be displayed in accord with colour specified by second
       field

* Screen details:

It is also possible to specify colour of 'details' being displayed by List2000,
this should be useful in case you set-up your MS-DOS Console Window with unusual
background colours or just for fun ! :-) You have to edit the configuration file
LIST.CFG and modify entries under DETAILS_COLOUR section; (under "colours"
directory of the installed application there are some examples)

[DETAILS_COLOUR]
consCbckgr    BLACK
consCforgr    GREEN
dtCdir        MAGENTA
dtCsizdat     CYAN
dtChidden     BLUE
dtCtitle      LIGHTCYAN
dtCpath       YELLOW
dtCfntfnd     LIGHTRED

  Means of each details colour entry:

consCbckgr    background of your MS-DOS Console Window
consCforgr    foreground of your MS-DOS Console Window
dtCdir        DIR field
dtCsizdat     both size and date-time fields
dtChidden     background for hidden files
dtCtitle      application title
dtCpath       path of: file text
dtCfntfnd     file not found message

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

7. Registration

Registering List2000 will add you to my list. The only thing you will get from
me is an occasional e-mail with the latest version of List2000 attached, as soon
as it is finished. To register, send me a brief e-mail with your e-mail address,
your current version of List2000 and any comments that you have about List2000.
My Email Address is: mgiar@hotmail.com

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

8. Disclaimer Warranty

List2000 Freeware is copyright (C) 1998-2001, by Massimiliano Giarratana.

The software, List2000, is provided "as is". In no event shall I, the
author, be liable for any consequential, special, incidental or indirect
damages of any kind arising out of the delivery, performance or use of this
software. This software has been written with care but I do not warrant
that the software is error free. You may not attempt to reverse compile,
modify, translate or disassemble the software in whole or in part.

You may freely give copies of List2000 to others, as long as the software is
unmodified. You may not change a single bit, you may not exclude any files or
add any to the package and you may not make List2000 part of another package.
You may not charge any money for the copying and/or distribution of List2000,
also not for List2000 itself.

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

9. Contact Information

You can contact the author by sending email to mgiar@hotmail.com

Please report any bugs or comments to mgiar@hotmail.com

The official List2000 home page is located at:
    http://members.tripod.com/~mgiar/index.html

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

10. Revision History

1.00  1 January  1998 : Initial version.
1.01 10 February 1999 : Optimized memory management in algorithm used to
                      : fetch directory info's, number of files which can
                      : be listed is now unlimited.
1.02 30 Julay    2000 : Improved routine which display files in column format,
                      : yk2 compatibility, fixed some minor bugs.
1.03  8 October  2000 : Entries for colours details in list.cfg,
                      : support for multiple arguments at command line,
                      : usage of MS-win32 Console function routines.
1.04  3 January  2001 : Added new option '/X': modify file sort by extension
                      : by name.
1.05  4 March    2001 : Extension of files longer than 32 characters is now
                        displayed.
---------------------------------------------------------------------------
