
                             4DOS v7.63

                       README.TXT -- May 2008


Greetings, and thanks for trying 4DOS!

This file contains a variety of information you should read before using
4DOS, including:

      Installation Notes
      Files Included with this Version
      Technical Support and Downloads
      Legal Notices
      Build History


INSTALLATION NOTES
------------------

   There are just two steps you need to take to install a downloaded
   copy of 4DOS:

      >> Extract all the files to a new directory (do not use a directory
         you're using for other products, or for a previous version of
         4DOS).

      >> Start 4DOS.  It will "install itself".

   Additional details on these steps are below.  For manual installation
   instructions see the sections with those headings below.

   When installing 4DOS under Windows 95/98 we recommend that you do NOT
   use a "long" directory name.  If you do, you will have to know and use
   the equivalent short name to load 4DOS in CONFIG.SYS; it's easier to
   simply use a short name from the beginning.  (This is not a 4DOS
   limitation.  It's because DOS, which starts before Windows 95/98 and
   loads the primary command processor, cannot handle long file names.
   While 4DOS fully supports long file names, to make DOS work well it
   is best to install 4DOS in a directory with a short name.)

   You can view any of the documentation files on-line, or copy them to
   your printer.  The Introduction and Installation Guide in 4DOS.TXT
   has page breaks, headers and footers; all other documentation files
   are unpaginated ASCII text.


"Self-Installation"

   To begin the installation process, simply run the program file,
   4DOS.COM, from a prompt.  This will automatically start the
   self-installation file _4INST.BTM, which will finish installing
   4DOS on your system.

   _4INST will prompt you for permission before each installation step,
   and no system files will be modified without asking you first.

   When the installation is finished, _4INST renames itself to _4INST.BTX,
   so that it will not be run again.  (If installation terminates
   abnormally, _4INST may not be renamed, and will then run again the
   next time you start the program.)


Manual Installation

   For complete manual installation instructions, see the Introduction
   and Installation Guide in the file INTRO.TXT.  The detailed
   instructions for 4DOS are in Chapter 5.

   If you choose to perform a manual installation you should rename the
   automated installation file, _4INST.BTM (we recommend renaming it to
   _4INST.BTX, which is what the file itself does when it's finished).
   If you don't, it will start automatically the first time you run
   4DOS.


FILES INCLUDED
--------------

   The following files are included with 4DOS 7.63:

         4DOS.COM          4DOS program file
         4HELP.EXE         4DOS help program
         4DOS.HLP          4DOS online help text
         _4INST.BTM        Self-installation batch file
         4DOS.ICO          Icon file for 4DOS under Windows
         BATCOMP.EXE       Batch file compression utility
         EXAMPLES.BTM      Sample batch file demonstrating the use of
                              variable functions and internal variables
         HELPCFG.EXE       Color configuration program for the help
                              system
         INTRO.TXT         ASCII copy of the 4DOS Introduction and
                              Installation Guide
         INSTHELP.EXE      Installation helper used when installing 4DOS
                              under DOS and Windows 95/98
         JP4DOS.INF        Setup file to install 4DOS registry extensions
                              under Windows 95/98
         JPOS2INS.CMD      Installation helper used when installing 4DOS
                              under OS/2
         JP4DOSSC.INF      Setup file to install JP Software program
                              group and shortcuts under Windows 95/98
         KSTACK.COM        Memory-resident program used by the
                              KEYSTACK command
         LICENSE.TXT       License agreement
         OPTION.EXE        Program used by the OPTION command
         README.TXT        This file


TECHNICAL SUPPORT AND DOWNLOADS
-------------------------------

   This version of 4DOS is free and unsupported.  (Existing 4DOS customers
   are still eligible for support by JP Software)

   To download JP Software files, including trial versions of the Windows
   products (4NT and Take Command), visit:

      >> JP Software web site at http://jpsoft.com
      >> JP Software FTP site at  ftp://jpsoft.com


LEGAL STUFF
-----------

Copyright  1988-2004  Rex Conn & JP Software Inc.  All Rights Reserved.
Published by JP Software Inc., P.O. Box 328, Chestertown, MD 21620, USA
phone 410-810-8818, fax 410-810-0026.

4DOS is a registered trademark of JP Software Inc.  JP Software,
jpsoft.com, and all JP Software designs and logos are also trademarks
of JP Software Inc.  Other product and company names are trademarks of
their respective owners.


BUILD HISTORY SINCE VERSION 7.50 BUILD 132 IN REVERSE ORDER
-----------------------------------------------------------

The new builds are developed independently of JP Software by Luchezar
Georgiev in Bulgaria. JP Software is not responsible for any bugs that
these builds may introduce. The user must assume all risks of using them.

Build 163 (Version 7.63) - 3 May 2008:
        If EditMode is not Init*, cursor shape is now reset on hitting Enter
        "Warm" REBOOT in DOS now also pulses RESET pin on ATs (still "warm")
        If InstallPath is not set, OPTION can now invoke 4HELP
        (NOTE: OPTION can't be built yet, so that's only in source)

Build 162 (Version 7.62) - 23 April 2008:
        The prompt after a CLS now goes to the first, not the second line
        As in COMMAND.COM, /K now suppresses the signon messages like /C
        (NOTE: As IO.SYS 7.x appends "/D /K AUTOEXEC" or "/K NETSTART" to
        the SHELL= line, add a colon after the "K" to "mute" the signon.)

Build 161 (Version 7.61) - 28 January 2008:
        Correctly show the minor version number of OS/2 Warp 4.x
        Correctly show X-DOS version and avoid NLS separator corruption in it
        Recognise Wendin-DOS (but unfortunately 4DOS crashes in it)

Build 160 (Version 7.60) - 28 December 2007:
        Auto-completion and SELECT now support filenames containing backquotes
        HEAD/TAIL /V option header now always starts on new line if /C used
        Return value of @FILEWRITE now equals the number of bytes written

Build 159 (Version 7.59) - 27 October 2007:
        Wildcard matches include all LFNs containing bracket characters ([])
        Added @MD5 function for files using the RSA algorithm from RFC 1321
        Updated help file for the above change

Build 158 (Version 7.58) - 15 September 2007:
        Direct screen output now works in monochrome video modes too
        Amended sign-on message with information about 4DOS patches
        Re-enabled the MOVE /W(ipe) option

Build 157 (Version 7.57) - 27 July 2007:
        Auto-completion of file names with many dots works in DOSLFN as in W9x
        Creation / access times can now be TOUCHed in DOSLFN, not only in W9x
        SELECT /X now works in DOSLFN too, not only in W9x
        Fixed possible pointer underflow if @WORD and @FIELD count backwards
        @WORD and @FIELD no longer return whole string if it has leading space
        Added @FIELDS function
        Updated help file for the above change

Build 156 (Version 7.56) - 25 June 2007:
        Show zero creation or access times in DOSLFN the same way as in W9x
        Added _DATETIME and _MONTHF variables
        Added @AGEDATE and @MONTHF functions
        Updated help file for the above changes

Build 155 (Version 7.55) - 14 May 2007:
        Show correct CD/DVD-ROM disk space in raw DOS; fixes DIR in PC DOS 7.1
        Avoid false detection of MS-DOS 7 (MSDOS7 variable) in case of FreeDOS
        DIR /2 /X in Windows now looks like in DOS and doesn't reach column 80
        VER /R now displays also build date

Build 154 (Version 7.54) - 20 April 2007:
        Added message.* to global header dependency
        Added high-level @EMS function code (was missing in original sources)
        Added _ALT,_CAPSLOCK,_CTRL,_LSHIFT,_NUMLOCK,_RSHIFT,_SCROLLLOCK,_SHIFT
        Updated help file for the above change

Build 153 (Version 7.53) - 15 February 2007:
        Recognise LZ-DOS, RXDOS, DOS-ROM and S/DOS
        The "Marked" message of SELECT no longer shifts even on largest files
        8.3 file size over 1 GB no longer misaligns DIR, TREE or SELECT output
        Updated help for the above (maximal non-wrap description size now 39)

Build 152 (Version 7.52) - 4 February 2007:

        Correctly process the "invalid disk change" code during critical error
        Irrelevant error codes in critical error converted to "general failure"
        Added a /L(ine offset) option to LIST
        Updated help file for the above change

Build 151 (Version 7.51) - 31 January 2007:
        For Novell DOS and DR-DOS 7.x-8.0, show the right DOS version
        For hard errors, show operation and drive; accept only allowed actions
        DOS error messages amended and edited to clarify and remove duplicates
        Updated help file for the above change

Build 150 - 25 January 2007:
        Fixed the "Lock violation on COPY from remote drive without SHARE" bug
        Worked around a bug (in MSVCRT?!) leaving high byte of _doserrno != 0
        VER_MINOR = VER_BUILD - 100 from now on (version 7.51 = build 151)

Build 149 - 18 January 2007:
        Fixed the "DIR [PATH] finds no files in DOS LFN volumes" bug
        An * instead of *.* default wildcard is now used for DOS LFN volumes
        FFIND /U (summary only) option can now be evaluated by @EXECSTR
        FFIND and LIST search can now be interrupted with Ctrl-C

4HELP Changes on 15 January 2007
        4HELP now supports mouse wheel (As for 4DOS, a driver that supports
        wheel is needed, e.g. Cute Mouse 2.x; the W9x driver does NOT support
        wheel for the DOS mouse API.)

Build 148 - 10 January 2007:
        LIST, SELECT and command history window now support mouse wheel
        (NOTE: A driver that supports wheel is needed, e.g. Cute Mouse 2.x+)
        The right mouse button now exits LIST and SELECT

Build 147 - 8 January 2007:
        Fixed command line buffer overflow when repeatedly pressing F12
        Added hexadecimal output option to @EVAL
        Updated help file for the above change

Build 146 - 7 January 2007:
        Fixed command line buffer overflow and path search name underflow bug
        Added new @CWD and @CWDS functions
        Updated help file for the above change

Build 145 - 6 January 2007:
        @READY now equals the inverted "no disk in drive" bit for CD-ROMs
        Added new EJECTMEDIA and CLOSETRAY commands
        Updated help file for the above change

Build 144 - 30 December 2006:
        Added a /V(erbose) option to TYPE to show a header for each file
        Added a /P(ower off) option to REBOOT to shut the system down
        REBOOT now flushes SMARTDRV cache before reboot or power off
        Updated help file for the above changes

Build 143 - 29 December 2006:
        /P page prompts are now overwritten like DR-/PTS-DOS COMMAND.COM
        Restored DOS version 2.x compatibility of 4DOS.COM, lost in v6
        4DOS.COM now aborts on attempt to run it in DOS version 1.x

Build 142 - 26 December 2006:
        Restored 8086/8088 (PC/XT, Pravetz-16, etc.) compatibility, lost in v6
        Added compatibility information about CADStar PCB in the help file
        Added @SERIAL function; help file updated for it too

Build 141 - 24 December 2006:
        Added GB units to file size ranges, @DISK* and @FILESIZE functions
        DIR /4 now shows size of files over 1 GB with precision of 0.1 GB
        Added information about the above features in the help file

Build 140 - 22 December 2006:
        For Pentium 4 and up, _CPU now returns 786
        Removed the @READY warning from 4DOS.HLP and added 786 info to it
        Added build.h dependency for expand, removed shareware dependencies

Build 139 - 21 December 2006:
        Recognise Datalight ROM-DOS
        Can now load in upper memory in PTS-DOS
        @READY now works properly in PTS-DOS

Build 138 - 19 December 2006:
        @READY now works more reliably with CD-ROM drives
        Removed unused modules "batcomp" and "parspath" from 4DOS.LNK
        INTVER = VER_BUILD again, now OPTION.EXE patched on each build

Build 137 - 17 December 2006:
        Re-enabled _4INST.BTM (self-installer) support
        Added the installer files from version 6.02 (1999) to the archive
        4DOS.HLP replaced by extended and updated version by Charles Dye

Build 136 - 15 December 2006:
        Process the DR-DOS F5/F8 startup keystrokes too
        Fixed the "%* affected by the SHIFT command" bug
        Removed the unused (non-4DOS and shareware) error messages

Build 135 - 13 December 2006:
        No longer mistake DR-DOS 7.0x for Novell DOS
        Recognise PC DOS, FreeDOS, PTS-DOS and DR-DOS 7.03
        Fixed the "DIR /F and DIR /B /S disable colourisation" bug

Build 134 - 9 December 2006:
        Batch debugger now refuses to load batch files over the 64 KB size limit
        Fixed the "total @FILESIZE roll-over at 4 GB" bug
        Fixed the "DESCRIBE loses third-party info" bug

Build 133 - 7 December 2006:
        Properly show FAT32 drive space in MS/PC/LZ/EDR/PTS/ROM/FreeDOS
        Properly show free XMS memory in the MEMORY command if > 64 MB
        Re-enabled the /Y single-stepping option that was disabled in 2003
        Fixed the "SET /M not upper-casing master environment variables" bug
        Fixed the "RD not removing hidden and system sub-directories" bug
        Fixed the C4018 "signed/unsigned mismatch" C compiler warnings
        Reverted INTVER from 131 to 130 to make OPTION compatible
