Date: Mon, 25 Nov 2002 19:58:05 +0000 From: "Richard Dawe" Sender: rich AT phekda DOT freeserve DOT co DOT uk To: djgpp-workers AT delorie DOT com X-Mailer: Emacs 21.3.50 (via feedmail 8.3.emacs20_6 I) and Blat ver 1.8.6 Subject: [PATCH] Updates for readme.1st Message-Id: Reply-To: djgpp-workers AT delorie DOT com Hello. Following up from the review of readme.1st, here is a patch that: * describes basically what a long file name is (CBFalconer); * updates the description of RHIDE (CBFalconer); * adds compatibility information for various 2.x versions and symlinks and also about Windows 2000 & XP compatibility (Andrew Cottrell). Charles didn't think that the symlink information was necessary, but I think we should tell users about it in advance. Forewarned is forearmed, I think the saying goes. OK to commit? Bye, Rich =] Index: readme.1st =================================================================== RCS file: /cvs/djgpp/djgpp/readme.1st,v retrieving revision 1.18 diff -p -u -3 -r1.18 readme.1st --- readme.1st 18 Oct 2002 12:12:49 -0000 1.18 +++ readme.1st 25 Nov 2002 19:49:56 -0000 @@ -119,6 +119,12 @@ possible if you are using a newer Window Installation ------------ +A 'long file name' or 'long directory name' has path components that +are longer than 8 characters in the portion before the extension +and longer than 3 characters in the extension. A long file name may +also have multiple extensions and contain some characters that are +illegal in short file names (e.g.: spaces). + 1. Create a directory for DJGPP, say C:\DJGPP. (WARNING: do NOT install DJGPP in a directory C:\DEV, D:\DEV, etc., or in any of their subdirectories: it will not work! See the FAQ for more details.) Do @@ -314,16 +320,13 @@ other free editors can serve as an IDE. editors (including Emacs) cannot do is to run a debugger in a full-screen session. -A DJGPP-specific IDE called RHIDE has recently been released and is -now available to all DJGPP users. It features a Turbo C-style +An IDE called RHIDE supports DJGPP. It features a Turbo C-style interface, auto-indentation, color syntax highlighting, automatic invocation of the DJGPP compiler, automatic Makefile generation, and easy access to the DJGPP online documentation. RHIDE also incorporates integrated and/or standalone debugging using the same -functionality as the GNU Debugger (gdb). Since RHIDE is brand new, -there are still revisions and bugfixes being made; visit -http://www.tu-chemnitz.de/~sho/rho/rhide.html for the latest -information and updates. +functionality as the GNU Debugger (gdb). Visit http://www.rhide.com/ +for the latest information and updates. @@ -490,15 +493,30 @@ command line type "info info". To find -Compatibility with V2.00 ------------------------- +Compatibility with V2.x +----------------------- If you are upgrading from version 2.00 of DJGPP, you should completely reinstall all the packages you need to use. Because of the different methods used by versions 2.01 and later to handle long command lines -(and long filenames under Win95), mixing V2.00 programs with those +(and long file names under Win95), mixing V2.00 programs with those from later versions can cause very subtle and difficult to debug problems. See the FAQ section 16.6 for more information. + +DJGPP uses files of a special format, to support symbolic links +between files. Version 2.04 introduced a new format for symlinks, +to improve symlink support. Versions 2.00 through 2.03 do not +understand the new format symlinks and cannot resolve them. +Version 2.04 understands the old and new symlink formats. +Subtle and difficult to debug problems may be experienced, if programs +built with version 2.04 are mixed with programs built +with an earlier version. + +If you are upgrading from version 2.00 through 2.02 of DJGPP +on Windows 2000 or XP, you should reinstall all the DJGPP packages. +The DJGPP packages were rebuilt with a later version of DJGPP, +to support Windows 2000 and XP. Programs built with version 2.02 +are likely to fail on Windows 2000 and XP.