MkImage - Make disk image
			=========================

Creates DFS disk images from set of files. BBC BASIC (BBC/RISC OS/Windows)

Syntax: MkImage outfile inpath -cycles num -debug -fs type -i@file -o opt
-q -r -s size -t title -u -vn -x file -quit command

MkImage can be called as a *command or CHAINed and takes various options,
as follows:

outfile		disk image file to create, will be filetyped to &B22 on BBC
		or RISC OS.

inpath		source pathname to read file from.

-cycles num	Set disk cycle number.

-debug		Turn on debugging.

-fs type	Specify disk image type. Currently, only '-fs DFS' is
		supported.

-i@file		Read a list of filenames to include from the specified text
		file.

-o opt		Set the disk boot option.

-q		Quiet - suppress all display output.

-r		Recurse into subdirectories.

-s size		Specify maximum disk size in K, for example '-s 200K'
		specfies a maximum 200K disk image, as with a single-sided
		80-track DFS disk. If no size is specified, the final disk
		image's size will be the total size of the included files.
		The DFS filesystem stores disk sizes and sector numbers in
		10 bits, so the largest possible disk image is 256K.

-t title	Specify the disk title.

-u		Update disk image. The disk image will only be written to
		if the datestamp on the source directory is later than the
		datestamp on an existing disk image, or if no disk image
		exists.

-vn		Verbosity option. The only verbosity option supported is
		'-v1' which displays all program output on a single line.

-x file		Exclude the specified filename.

-quit command	Call the specified command on exit. If command starts with
		a '*', then it is called as a *command, otherwise it is
		CHAINed. OSBYTE 1 is set to any error number. This will be
		0 for no error. -quit must be the final option on the line.

Example command
---------------
*MkImage Utility1/s $.Disk.JGH.Utilities1 -o 3 -t Utilities1 -u -v1 -quit *Dir $.Image.JGH

Filename translation
--------------------
When copying files to a DFS image, files are put in the DFS '$' directory,
unless the second character is a '/'. Then, the first character is used as
the DFS directory. For instance, "HDInit" becomes the DFS filename
"$.HDInit", "T/HDInit" becomes the DFS filename "T.HDInit".

Copying from subdirectories is not yet supported.