README file for vfman for Epson D88 file images.

The vfman suite are a set of tools to create read from and write to the d88 floppy images used with the QX-10 and TF-20 emulators from the Toshiya TAKEDA site (http://homepage3.nifty.com/takeda-toshiya/).

The current code is a rewrite with better structure than the previous versions. Basic functionality is present, but there is still much room for improvement. Like:
- The directory listing is very primitive, just a used extend listing,
- Several structs are used, but the organisation of data is poor,
- Only files from the local directory can be used, as the Path is not stripped before writing to the image,
- Files can only be read with the same nas used in the image, and only to the local directory,
- No checking is done on the image other than its presence. Write to another file type, and you probably mutilate it,
- No support for system, read only or archive flags,
- There is documentation on the CP/M disk structure, but it always describes 2.2 and 3.0. So I'm not sure the tools have the right 2.2 behaviour for the Epson computers. It must be close, tough,
- Handling filename sizes larger than 8.3 is primitive,
- There is no documentation other than this file,
- Etc, etc, ...

The files:
d88header.bin - The header of the image. Used by fvormat.
Makefile    - makefile used for both linux and Windows/Msys
vf.c        - functions used by vformat.c, vfread.c and vfwrite.c
vf.h        - header file for vformat.c, vfread.c and vfwrite.c
vformat     - Linux vformat executable
vformat.c   - Vformat source
vformat.exe - Windows vformat executable
vfread      - Linux vfread executable
vfread.c    - Vfread source
vfread.exe  - Windows vfread executable
vfwrite     - Linux vfwrite executable
vfwrite.c   - Vfwrite source
vfwrite.exe - Windows vfwrite executable

The code is developed and somewhat tested on a Kubuntu 9.10 machine. The Windows compilation is done with an CygWin/MinGW/Msys environment. Identical source is used for both platforms.

Fred Jan Kraan,
2010-03-21