                        BBC DISK MANAGER INSTRUCTIONS
                        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

1.0 - INTRODUCTION
~~~~~~~~~~~~~~~~~~

DiskMgr is a utility program for transfering files to and from, and for the
management of, BBC Micro disk image files on the PC.  It is distributed
only with the registered version of PCBBC as supplied by Stuart McConnachie
and is only for use by officially registered users of the PCBBC packgage.
It is subject to the same disclaimer, and terms and conditions as set out
in the README.TXT file.
_____________________________________________________________________________


2.0 - USING DISKMGR
~~~~~~~~~~~~~~~~~~~

You should find DiskMgr should be simple and easy to use.  To start DiskMgr
type DISKMGR [ENTER] at the MS-DOS command prompt.
_____________________________________________________________________________


3.0 - SELECTING A DISK IMAGE FILE
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The initial screen prompts you to enter the name of the disk image file you
want to work with:

BBC DISK MANAGER 1.04 (C) Stuart McConnachie 1998


This program is only for use by registered users of the PCBBC package.

Enter a disk image filename or press ESCAPE to exit
Image file: DISKIMG\

If the image file is in the DISKIMG directory then just type the name of
the file, e.g. DISK1.IMG and press [ENTER].  If the image file is located
eleswhere, delete DISKIMG\ and type in the full drive and path name to the
image file you wish to work with e.g. C:\BBCDISKS\DISK1.IMG [ENTER].

Before allowing you to edit the disk image file, DiskMgr checks the DFS
catalogue structure of the disk.  If DiskMgr does not recognise the disk
image as a standard format Acorn DFS disk (40 or 80 track) it will not allow
you to open the disk image.  Sorry, but at present DiskMgr only allows for
this type of disk.  I may enhance DiskMgr to read ADFS or Watford 62 file
format DFS disks in the future.  As a registered user of PCBBC you are
entitled to a free upgrade to the latest version of DiskMgr.

If the file you select has the "r" (read only) attribute set, then DiskMgr
prompts you and asks if you want to make the disk read/write.  If you answer
N to this question you will not be able to make any changes to the disk,
only copy files off the disk to DOS.  Answer with Y if you want to be able
to change the disk image.
_____________________________________________________________________________


4.0 MAIN MENU OPTIONS
~~~~~~~~~~~~~~~~~~~~~

The next screen presents you with the options available:

MAIN MENU OPTIONS


BBC DFS disk image, 80 tracks: DISKIMG\GAMES.IMG

Select an option or ESCAPE to exit:
  1 - Catalogue BBC disk
  2 - Copy PC file(s) -> BBC disk
  3 - Copy BBC file -> PC disk
  4 - Change BBC filename & attributes
  5 - Delete BBC file
  6 - Compact BBC disk
  7 - Uncompact BBC disk

4.1 - Catalogue BBC Disk
------------------------
Press 1 to view a catalogue of the disk, including the files load, exec,
length and start sector information.

4.2 - Copy PC File -> BBC Disk
------------------------------
Press 2 to copy a file from your PC hard drive onto the BBC disk image.
NB: If you are copying files which have been saved by another BBC emulator
they may have an associated .INF file which gives the BBC name, load and
execution addresses.  If a .INF file exists then DISKMGR will use it,
otherwise you will have to type in a name for the file to be saved under on
the BBC disk.  In this case the load and exec addresses will be set to 000BAD
and you may need to use option 4 later to set them correctly.
First enter the name of the PC file you wish to copy, note that you can
specify wildcards here so ELITE\*.* will convert all of the files in the
ELITE directory.  You will then be prompted "Convert file <FILENAME> [Y/N]:"
for each PC file, in turn.  Answer Y or N, and you may also need to enter a
BBC file name, which must specify a single letter directory name, a full stop
and then upto 7 characters for the actual name: #.#######.  Press [ENTER].

If there is sufficient free space, the file will be added to the disk.
Otherwise you will get an error - either "Disk full" or "Compation required".
Disk full means that there is not enough space on the disk to hold the file,
you must delete some files to make some space.  Remember that the maximum
capcatity for an 80 track disk is a little under 200 Kb.  Compaction required
means that there is enough space, but not all in one contiguous lump.
Compact the disk with option 6 on the menu and try again.

NB: You can not select this option if the disk is read only.

4.3 - Copy BBC File -> PC Disk
------------------------------
Press 3 to extract a file from the disk image and save it as a single file
on your PCs hard drive.  First move the blue highlight, using the cursor
keys, until it is over the file you wish to extract.  Then press [ENTER].
Now enter the name of the file you want to save as on the PC hard drive and
press [ENTER].  To exit press [ESCAPE] until you return to the main menu.

4.4 - Change BBC Filename & Attributes
--------------------------------------
Press 4 to set or change the locked, load address and exec address for a BBC
file.  First move the blue highlight, using the cursor keys, until it is over
the file you want to change and press [ENTER].  You can then change the name
of the file, or just press [ENTER] to continue.  Next press [Y] to lock the
file (make it read only) or N for read/write.  Next enter the load and then
the execution address of the file.  If you wish to leave an option unchanged
then just press [ENTER] to continue.  When you are all done chenging file
attributes press [ESCAPE] to return to the main menu.
NB: You can not select this option if the disk is read only.

4.5 - Delete BBC File
---------------------
Press 5 to delete a BBC file from the disk.  Select the file with the cursor
keys and press [ENTER].  Then confirm that you want to delete the file.  Once
you delete a file there is no way to undelete it, so take care!
NB: You can not select this option if the disk is read only.

4.6 - Compact BBC Disk
----------------------
Press 6 to compact the BBC disk.  Compacting a BBC disk is sort of the same
as MS-DOS Defrag - it move all of the files to the start of the disk and all
of the free space to the end.  This allows you to fit a bigger file on the
disk, since all DFS files must be in one chunk (not fragmented).  Compacting
a BBC disk also has the dual action of making the image file as small as
possible, by trucating it after the last file on the disk.  If your 80T disk
image only contains one 4K file, then the resulting disk image after a
compact will only be 4.5K (4K for the file plus 1/2K for the catalogue) and
not 200K as would be the case for a full 80 track disk image.  If you later
add extra files to the BBC disk, PCBBC will automatically extend the file
without you having to reformat the disk, but note that this type of disk will
not usually *VERIFY as this involves *reading* the *entire* disk, even those
sectors past the last sector on the disk which nolonger exist.
NB: You can not select this option if the disk is read only.

4.7 - Uncompact BBC Disk
------------------------
Press 7 to uncompact the BBC disk.  Esentially uncompacting a disk is the
reverse action of the trucation process described above, so really it should
be called untrucate or soemthing!  It just increases the size of your image
file to 100K for a 40 tack disk and 200 for an 80 track one.  You should now
be able to *VERIFY the disk.  Uncompacting is useful for some emulators that
require a correctly sized disk image (i.e. not PCBBC!).
NB: You can not select this option if the disk is read only.
_____________________________________________________________________________


5.0 - EXITING
~~~~~~~~~~~~~

Press [ESCAPE] at the main menu to return to the disk image selection screen.
Either select another disk image to work with, or press [ESCAPE] again to
return to the DOS prompt.  When you exit DiskMgr restores the read only
attribute for you, if it was set when you opened the disk image.
_____________________________________________________________________________


6.0 - COMMENTS AND SUGGESTIONS
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

I welcome comments, suggestions and bug reports on all my software.  Find my
contact details in the PCBBC README.TXT file.
_____________________________________________________________________________

