Timex FDD3000 to +3 converter (John Elliott, 7 December 2008)
=============================================================

  If you are compiling this software, you need to have LibDsk 
<http://www.seasip.demon.co.uk/Unix/LibDsk/> installed. 

  This program converts disc images in Timex FDD3000 160k format to +3DOS or
PCDOS format.

  This is a command-line utility. Syntax is:

timex2p3 { options } infile.dsk outfile.dsk

  where infile.dsk is the Timex disc image to convert, and outfile.dsk is the
+3DOS or PCDOS file to create.

  Any of the following options can be supplied. The first four are LibDsk 
options controlling the disc image file formats:

-itype <type>    Set the type of the input disc image (default is to 
                 autodetect). The list of types is below.
-otype <type>    Set the type of the output disc image (default is to DSK).
-icomp <type>    Set the compression system used for the input disc image
                 (default is to autodetect). The DOS build only supports one
		 compression method: 'sq' (Huffman compressed).
-ocomp <type>	 Set the compression system for the output disc image (the 
		 default is uncompressed).

  The remaining options handle details of the conversion process:

-cpm		 The input file is in CP/M format, with the directory on 
		 track 2 and a skew of 5. 

-xlt		 Attempt to convert file headers from Timex to +3DOS format.

-180		 Output in the standard +3DOS 173k format. By default, a 169k
		 format with a larger directory is used.

-720		 Output in +3DOS 706k format.

-dos		 Output in PCDOS 713k format.

Examples
~~~~~~~~

timex2p3 timex.dsk plus3.dsk

		Convert a .DSK in Timex format to a .DSK in +3DOS 169k format.
		Files that have headers will keep their Timex headers.

timex2p3 -xlt timex.dsk plus3.dsk

		Convert a .DSK in Timex format to a .DSK in +3DOS 169k format.
		File headers will be converted to +3DOS headers.

timex2p3 -dos -otype raw timex.dsk pcdos.ufi

		Convert a .DSK in Timex format to a raw filesystem image in 
		PCDOS 713k format. This should then be usable under Virtual
		PC, or loopback-mountable under Linux.

timex2p3 -dos -otype floppy timex.dsk a:

		Run under DOS, this ought to convert timex.dsk to a 720k 
		floppy in drive A:.

timex2p3 -cpm -180 -otype edsk timex.dsk plus3.dsk

		Convert the supplied file to 173k +3DOS format, assuming the
		input to be a CP/M disc. Write the output in extended CPCEMU
		format.
  

LibDsk drivers
~~~~~~~~~~~~~~
  The following LibDsk drivers are supported in the DOS build. Only the first
four are likely to prove useful:

floppy:		The system floppy drive
raw:		Flat file containing only sector data
dsk:		CPCEMU .DSK
edsk:		CPCEMU extended .DSK

apridisk:	Apricot disc image archiver
ydsk:		YAZE emulator disc image
cfi:		Compressed floppy image, used by FDCOPY.COM

In addition, input files in TeleDisk and CopyQM formats _may_ be autodetected;
I don't guarantee this will work on any given file.

