bbctapedisc 1.01:
----------------
  This program can be used to read files from Acorn BBC computer tapes
(using line-in on  the sound card or using a  pcm encoded audio sample
(22-44kHz, mono, unsigned 8 bit)), and create ssd disk images or files
on your PC.


Use:
----
	bbctapedisc -w myprograms.wav
will scan the audio file  'myprograms.wav' and shows all tape files it
contains.

	bbctapedisc -i -s -a image.ssd
will read from the soundcard's line-in and decode files to disk.

  Type 'bbctapedisc' for more information.

  Note further  that when reading from the  soundcard, processing will
only stop when you stop the program (CTRL-C).


Notes:
------
  When extracting blocks, the program will compare any existing blocks
with the  same name;  if they  are equal to  the block  extracted from
audio, this  block is skipped, if  different, the new  file is renamed
sequentially by appending a number,  e.g.  ELITE_00 (block 0 of ELITE)
becomes ELITE_0_00 (block 0 of ELITE_0), if this file also exists, the
new file  is renamed to ELITE_1_00,  etc. This means  it's possible to
have multiple files of the same name extracted from tape into a single
directory. It  also enables manual checking  of files in  case a block
should slip through twice with a correct CRC but different data (it is
extremely  unlikely  that  the CRC  should  be  ok  when the  data  is
corrupted  on tape  (or  even decoded  in  a way  giving an  incorrect
result), but it is possible).


Authors:
--------
W.H.Scholten, R.Schmidt, O.Stauning, Jon Welch and others

Send comments, questions, bug-reports for this version to Jon Welch
<jon.welch@ntlworld.com>.


History
-------
1.01 March 2005 by Jon Welch
     - Renamed the program 'bbctapedisc'
     
1.00 January 2005 by Jon Welch
     - Merged several program to make the new version
     - Used sound card routines from make_tape_blocks
     - Used disc image routines from bbcim
     
0.95 (? may 2001)
     - Added preliminary tape image support (create from tape, write to tape).
     - Started converting more code to C (C++ sucks, use e.g. Ada or Eiffel)
     - use my_write/my_read/my_fwrite to handle short transfers (EINTR)
     transparently.

0.94 (28 april 2001, not released)
     - Incorporated audio file writing (using code from Ole Stauning's tape
       utility). Tested by connecting the BBC's cassette port to the PC's
       line-out and by writing to file, then extracting with option -e, etc.

0.93 (24 april 2001, not released)
     - Optimizations in file reading code for sound cards

0.92 (20 april 2001)
     This version is released by W.H.Scholten (only to R.S. :).
     - Almost all the output code replaced
     - Main loop replaced
     - Split the code in various files
     - Added header CRC checking
     - Added reading from sound card for OSS (unix)
     - Saving of files is done in archive format or tape blocks.
     - Added switch to write bad blocks too (-f), at the moment only the
       ones that are loaded fully but fail the data CRC check.

     bbctape.cc & _decode.c contain a lot of the 0.91 code by R.S. the other
     files are new by WHS.

     I (WHS) have used this version to read in about 5 hours of tapes with
     lots of BBC files and file fragments (more than 3000 tape blocks).

0.91 (21.02.96)
        Modified the __CATALOG__ output to enclose file names in quotes.
        Cleaned up the code (removed inactive code, added some comments.)
        Made a more interesting README.

0.9 (20.02.96)
        First beta release.
