
                                  FlatOut BFS archiver

  This program deletes from, updates, lists and extracts FlatOut BFS archives.



  1. Usage

  The parameter syntax is the following:

  FLATBFS D <archive> [<source-dir>]
  FLATBFS U <archive> [<source-dir>]
  FLATBFS L <archive>
  FLATBFS X <archive> [<destination-dir>] [-|/<options>]

  Commands:
  - D: Delete files from an archive. All  files,  that  exist  in  the  source
       directory, are deleted from the  archive.  All  other  files  are  kept
       unchanged.
  - U: Update files in an  archive.  All  files,  that  exist  in  the  source
       directory, are injected into the archive, with their compression method
       set to "no compression". All other files are kept unchanged.
  - L: List the contents of an archive.
  - X: Extract the contents of an archive.

  <archive>:
  This is the full name of archive to be processed. When changing the contents
of archives, the original archive is not touched; all changes are saved into a
new archive called "<archive>_new" instead.

  <source-dir>:
  This is the path from which files should be deleted from or updated  in  the
archive.

  <destination-dir>:
  This is the path to which files should be extracted from the archive.

  <options>:
  - A: When extracting files, disables adding  some  attributes  as  secondary
       extension. Note that if you want to repack files then you will have  to
       keep this information, otherwise the game may not be able to  load  the
       files.



  2. Important notes

  - The A (Add) command is missing. You cannot add new  files  into  archives,
    only delete or update those that already exist in the archive. You  cannot
    even change the number of files in the archive; deletion  only  fills  the
    corresponding entry in the archive directory with zeros.  The  reason  for
    this is that the exact meaning of the "hash table" is currently unknown.

  - This program is unable to uncompress compressed files in the archives. Use
    the "bfsunpack" software to completely uncompress archives.



  3. Error messages

  - Invalid command
    The command is unknown.

  - Long filenames are not available
    You should run the program in an  environment  capable  of  handling  long
    filenames.



  4. Copyright and legal issues

  The source of this program is public domain and provided here "as  is"  -  I
don't feel like commenting it but if you have problems then feel free  to  ask
me. If you derive your own program from the source or put a part of the source
into your own program, please, give me a credit and send a copy to me.



  5. The author

  If you're interested in some similarly useful utilities you can  contact  me
at sta@c64.org or visit my homepage at http://sta.c64.org.

  Joe Forster/STA
  28th December, 2004
