CPMFiler 1.27
			      =============
		   J.G.Harston - jgh@arcade.demon.co.uk
		70 Camm Street, Walkley, Sheffield, S6 3TR


CPMFiler is a simple program for accessing Acorn CPM, Torch CPN and
Amstrad disks to examine and extract files.

On running, you get a drive prompt A> or B>, as if running the Console
Command Processor.  You can change drives with A: and B: just the same. 
You can also access disk images using the FILE command, which changes the
prompt to display the image file name.

At the prompt you can enter commands to examine the disk, examine files on
the disk, and transfer files from the disk.  To get a list of commands,
enter ? or HELP.


Command Summary
===============

d:
--
Select drive.

FILE <file>
-----------
Selects the specified file as a disk image file.  All CPM disk access is
then sent to this file instead of a physical disk drive.

DIR, CAT  
--------
These two commands display a catalogue of all the files on the disk.  DIR
gives a CPM-style display, and CAT gives a BBC-style display.

STAT <file>, INFO <file>
------------------------
These display information on either all the files or one specific file. 
STAT displays the information CPM-style, as follows:

    D:FILENAME.EXT U LENGTH EX RSA <- - - - Allocation - - - ->

Each line lists the drive, the filename and extension, the user number,
the file length (including any final-sector byte count), the extent, the
file attributes ReadOnly, System and Archive, and the allocation sector
numbers.

INFO displays the information BBC-style.

TYPE <file> [CTRLS], DUMP <file> [7BIT]
---------------------------------------
TYPE displays a file, and DUMP gives a hexadecimal file dump.  If the
[CTRLS] option is given to TYPE, then all control characters are passed
unfiltered, otherwise only LF and CR are displayed.  If the [7BIT] option
is given to DUMP, then the characters in the dump are displayed in 7-bit
format, with bit 7 ignored.

DISS <file>
-----------
This disassembled the specified file into Z80 mnenomics.  The DisAssem
Osword call must be available for this command, as provided in the
DisAssem and Z80 BASIC ROM images.

COPY <source> <dest>
--------------------
This allows you to copy single files from or to CPM disks.  The source and
destination filing systems are specified by prefixing the filenames with
CPM:, CPN: or BBC:.  So, doing the following:

  COPY CPM:README.DOC BBC::2.$.README

copies the file README.DOC from the CPM drive to the file :2.$.README on
the BBC filing system.  Multiple file can be copied with wildcards, eg:

  COPY CPM:*.* BBC:OUTPUT

will copy all files from the CPM disk to the BBC directory OUTPUT.

FREE, MAP
---------
These two commands display the free space and map on the CPM disk.

BLOCK <sector>
--------------
This dumps out the specified CPM-referenced block.  Each block is &800
bytes, and on Acorn CPM disks, block &00 is at the start of track 3.  The
block parameter is in hexadecimal, as with the allocation numbers displayed
by STAT.

HELP
----
This will list all the commands you can use.

QUIT
----
This will terminate the program


Notes
=====
At the moment, COPY will only copy from disks.  The output display from
INFO, FREE and MAP are not fully implemented.

SECT can recognised small negative numbers as the sector parameter, and
will dump the system tracks at FF, FE, FD and FC.


Version History
===============
28-Apr-2007 v1.27 Physical disks accessible on RISC OS, works on Windows.
11-Feb-2001 v1.25 Commands in lower case recognised.  Long files
		(extent>0) dealt with correctly.
05-Dec-1999 v1.24 AmsDOS disks recognised. Partial support for Einstein
		disk images.
28-Nov-1999 v1.23 Access to CPN disks fully implemented, USER command.
27-Nov-1999 v1.22 Will access image files, side 2 access corrected.
15-Dec-1998 v1.21 Displays file attributes.
27-Nov-1998 v1.20 FDC routines call DFS to reset the FDC.
17-Jul-1998 v1.12 COPY fully working, with BBC: and CPM: specifiers.
		Program now called CPMFiler.
18-Feb-1998 v1.10 All routines implemented.
06-Jun-1994 v1.00 Initial version of CPMReader, only DIR, DUMP and TYPE
		implemented.