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


UnixFiler is a simple program for accessing Unix disk images to examine and
extract files. It will run on BBC, Master, RISC OS and Windows.

On running, you get a 0> prompt. You specify the drive to access by entering
the drive number, or specify a disk image to access with 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
===============

*command
--------
This passes the command to the OS.

d
-
Entering a single digit 0, 1, 2 or 3 will select the specified drive to
access. The current directory is set to '/' on the disk.

FILE <file>
-----------
Selects the specified file as a disk image file. All disk access is then
sent to this file instead of a physical disk drive. The current directory is
set to '/' on the disk image.

CAT
---
This displays a catalogue (listing) of the current Unix directory.

LS or EX
--------
This displays an extended catalogue (listing) of the current Unix directory.

INFO <file>
-----------
This displays the file information on the specified file as well as the
file's allocation vector.

CD <dir> or DIR <dir>
---------------------
This selects a new current directory. Only directories in the current
directory can be selected, or '..' to go to the parent, or '/' to return to
the root.

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.

EXPORT <unix source> <host dest>
--------------------------------
This allows you to copy one or more files from the UNIX disk image to the
host filing system. If <unix source> is a file, that one file is copied to
the file <host dest>. If <unix source> is a directory, the whole directory
is recursively copied into the host directory <host dest>. The file and
directory creation and modification dates are set where possible. Executable
Unix files are settyped to &FE6 (UnixEx), otherwise files are settyped to
&FFF (Text).

IMPORT <source> <dest>
----------------------
This allows you to copy a single file into the UNIX disk image, overwriting
an existing file.

For example,

  IMPORT develop/pdp11/bbcbasic bbcbasic

would overwrite the Unix file 'bbcbasic' with the file 'develop/pdp11/bbcbasic'
from the currently selected filing system.

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

QUIT
----
This will terminate the program

FREE
----
Displays the disk space free and used, and the total disk size.

BLOCK <blocknum>
----------------
Dumps the contents of the logical disk block.


Version History
===============
05-Oct-2007 v0.10 Initial version, based on SJFiler.
22-Aug-2008 v0.12 Export works, accesses 24-bit (Unix v7) disk images.