The 'PCBits' folder
-------------------

This is where any !PC support code should live.  Its purpose is to allow for
simple installation and / or disabling of such support code by the user.

You should distribute any support code in folders with a unique name (check
first with us in case of any doubt).  Inside each folder, you can create two
obey files, 'Startup' and 'Shutdown' which are run just before and after !PC
is.

If your support code needs to be loaded before or after any other code that
you're aware of, you should include a small text file named 'Order' in the
folder.  This can contain any number of lines which specify that extension's
place in the loading order; for instance,

load_before_me: Core
load_before_me: NetLinks
load_after_me: ARMEdit
dont_load: ARMASPI
load_in_preference: Sound

will ensure that the 'Core' and 'NetLinks' extensions will be loaded before
this one, the 'ARMEdit' extension after it, 'ARMASPI' will not be loaded at
all while this extension is present, and if 'Sound' is present, this
extension will not be loaded.

If you list any extensions in the 'Order' file which the loader can't find,
it'll ignore them quietly.  If two extensions specify they need to be
loaded before each other, !PC will not load.  If two extensions
disable each other, no error will occur.  Everything in the Order file is
case-insensitive.

Please note that including none of these files is obligatory, though if you
load RISC OS modules in Startup, killing them off in a Shutdown script is
expected.

You should set Diva$Error to an error message if you wish to report a fatal
error that will stop !PC from starting normally, otherwise make your own
arrangements to pop up a non-fatal error box (N.B. Using *Error in an obey
script will be non-fatal).

