Important information for users upgrading from versions before 2.10
===================================================================

Yes, I'm sorry, the source file format changed again, but it really was a bit of a mess beforehand, wasn't it?  Most syntax is still the same, but some of it might be a bit different, and backwards compatibility is unfortunately somewhat lacking compared to the changes made in version 2.00.

The new format is much more flexible and orthagonal, and a good read of the manual, as ever, is advised for your own benefit, but the important changes are summarised here:

Configuration options have COMPLETELY changed.  Practically nothing of the old (rubbish) implementation survives.  If you made any use of them beyond a few lines at the very beginning of the file, then the consequences will probably be unexpected.  In particular, options no longer affect the line before them (an especially bizarre misfeature caused by an ill-thought out implementation detail), and are now local to the level in which they appear (signified by the number of hashes), affecting only items in the exceptions and not the rest of a + mode list (therefore behaving rather like exceptions themselves).

AutoRecurse now works properly in all circumstances, and partial paths are now the norm (not the exotic exception).  A new option, SpriteRecurse, can be used to get everything from inside files, as AutoRecurse gets everything from inside directories.

The double dot ("..") syntax, hitherto restricted to the data file and a very obscure and pointless part of the source file, is now universal.  Nested lists are no longer necessary to handle multiple sprites.

Finally, wildcards have been added.  They're very useful.  Use them.

The reason the "Writing source files" section of the manual was so crap previously was that I didn't really know what I was talking about either.  Well, now I do.  It's been completely rewritten.  You'll enjoy it.  (Possibly.)

Things of note for users upgrading from versions before 2.03
============================================================

When first running this version, the data file will be rebuilt, due to an incompatibility between this and previous versions.

I don't usually like changing defaults, but this time I felt I had to: please note that as of this version, PinBackdrop is turned OFF by default.  You may have to change your source file accordingly.

The new addition to the archive, MBBBoot, is to be placed in PreDesk as a helper for running MBBack on bootup, to solve problems with Configure taking precedence.  Please make absolutely sure that any workarounds you may have put in place to fix this bug are removed.  Full details in the manual.

If MBBBoot is resident in PreDesk, the program requires WaitUntil from Soft Rock Software: http://www.softrock.co.uk/ (EDIT FOR VERSION 2.11: NOT ANY MORE IT DOESN'T)

Important information for users upgrading from versions before 2.00
===================================================================

In version 2.00, the formats of both the source and data files changed quite drastically and before running MBBack you should make quite certain that everything works.

Due to changes to the header format, MBBack should more or less accidentally detect that the data file is out of date and rebuild it when you next run the program.  Before doing this, however, please review the contents of your source file, taking into account the following:

Full stops after the filenames of lists of multiple sprites are no longer necessary.  At present they are silently ignored.

Multiple sprites and directory scans CANNOT be combined any longer.  (I don't imagine anybody ever used it anyway.)

A directory scan will now scan inside subdirectories as well as in the filename you give.  If you do not want this to happen, you will need to create a nested list and use #AutoRecurseOff - see the manual for details.

Setting characters are now case-sensitive again.  Capital letters will now have quite different effects to lower case, so watch out.

By default, setting extensions will now preserve transparency instead of drawing on a white background.  If this is not what you want, insert '#WhiteBack' into the beginning of the file.

Old source files should be otherwise compatible, but please take the time to read the manual to find out how to take full advantage of the new features - some of them, especially nested lists and partial paths, will save you a lot of time and effort.