DOSLnk
------

Short English abstract - Note: I'm no native speaker so please excuse some poor phrases.



What?
-----

DOSLnk is an add-on for TVFSCC and should not be used standalone. It will be executed when needed from TVFSCC.



How?
----

DOSLnk mangles files and directories with long filenames recursively into non-conflicting 8+3 format. This is usefull if you try to work with DOS or WinOS applications and long filenames (HPFS).
Invalid characters will be replaced ("(space)", "+", "[", "]", ";", "=", ",", "~", """, "/", "\", ":", "*", "?", "|", "<", ">", "-", "&") and in case of conflicts short names will be named with "~" and an ascending number.

The given directory will always handled completely including subdirectories etc. No support for single files yet.



Known Bugs?
-----------

-Speed: Not very fast because of doing every link action on every file and not just on only one directory.

-You should avoid to link to root directory. In this case unlinking is quirky.

-Short filenames appear with there original longname (.LONGNAME) if watched via WPS. Directories not because SysPutEA can't handle directories.

-Please DON'T pack DOSLnk.exe with 'lxlite' from Andrew Zabolotny. It will not run any more because of the used compiler.



What else?
----------

DOSLnk is based on SFN from Samuel Audet. After my own code was nearly ready (some directory related stuff missed), Samuel released his very well working code so I decided to make SFN the base code for DOSLnk.

Changes made:

-TVFSCC related changes
-Parameter parsing
-Error handling
-Some things optimized
-Expand invalid filenames
-.LONGNAME support for files

Special thanks to Samuel Audet (guardia@cam.org) who made his code available for further use:
--------------------------------------------------
I make NO warranty for this code, and everyone is free to do whatever they
want with it... gimme the credits though :)
--------------------------------------------------

The limitations from SFN actually are the same for DOSLnk:
--------------------------------------------------
- The directories are read only (0 bytes free), although the files are not.
- Renaming is futile.
- There seems to be a problem with % signs in filenames, can't figure out
  why... must be a hidden bug (err feature) in REXX.
--------------------------------------------------



Who?
----

DOSLnk is a quick hack but was tested carefully under Warp 4 (german version) with FP1.

If you detect problems or errors or if you have suggestions, please let me know.

Kai Evers
email:	ke@LB.maus.de
www:	http://www1.stuttgart.netsurf.de/~kevers/

DOSLnk is freeware.

Disclaimer:
Use at your own risk. The author shall in no event be liable for the accuracy of the retrieved data and the program code or for any damage that the software might cause directly or indirectly. 
