Xdirlist version 01.00.00 by B.F. Schreurs, email address: stack@xs4all.nl

This program is freeware. You shouldn't have to pay for it.
The Turbo Assembler source is also available.
Set your browser to: www.xs4all.nl/~stack
and download the source code or other nice utilities for your Atari XL/XE.

Very short description follows...
This program is parameter driven (i.e. no fancy screens or graphic stuff).
The syntax is as follows:

XDIRLIST [drive1:][path1]

or to give an example:

XDIRLIST
or
XDIRLIST C:\*.*
or
XDIRLIST G:\*.XFD
or
XDIRLIST I:\XLDISKS\*.ATR

Use this exact syntax, remember it's only a hack <grin>.

Let me explain.
At drive1 and/or directory path1, you specify where the Atari XL/XE
disk images are located. If you specify a drive (and path), please
do not forget to include the filemask.
You cannot specify a directory only!
You can however run the program without specifying anything.
It will then start at the current drive\directory.

If you place this utility in C:\UTIL or another directory and you
specified in your AUTOEXEC.BAT file the following:
PATH C:\UTIL
then you can run this program anywhere you are in a directory.

If you specify the following: XDIRLIST C:\XL\*.*
the program will search through directory C:\XL en all underlying
subdirectories for XFD and ATR Atari disk images.
The images do not need the .ATR or .XFD extension to be recognized.
It will basically inspect any file to see if it is a disk image.
If it is, it will determine if it is a disk containing an Atari 8 bit
volume table of contents (VTOC), if it has, it will retrieve all the
files from the VTOC and write it out to a file located at C:\LOCATOR.TXT
Some usergroups abuse the VTOC of an Atari disk, and place text files
in it or just place program code in it. This program tries to list only
real VTOC files. Sometimes it fails, sorry for that.

It will specify the Atari 8 bit filename, its size in 128 byte sectors,
if it is locked, if it is located above sector 720 (extended) and if it
is deleted or not, and the PC location of the disk image.
See the example below:

Atari File   Size Lck Ext Del Pc Path
------------ ---- --- --- --- ------------------------------------------------
DOS.SYS        37 No  No  No  C:\XL\DOS25.ATR
DUP.SYS        42 No  No  No  C:\XL\DOS25.ATR

The LOCATOR.TXT is 256 bytes per entry, this is because a path can be quite
long, and this way you can easily import it into Microsoft Excel or Access.

This is basically it. If you still got questions,
you probably didn't understand a word I've written.
You'd better re-read this document again then.

If you still got questions left, you can email them to me.
With some luck, I'm able to answer them <grin>.
Suggestions, ideas or improvements are welcome too.
That does not mean that I will follow them up though.
I needed this program, and it works, I hope it works for you too.
If you don't like it, you can download the code and change it! <big grin>.

Enjoy!
