ResGen
======

ResGen is a tool for creating resource file data in a form suitable for
use by ResourceFS from a set of input files and corresponding resource
file names.

The format of the ResGen command is:

  ResGen [options] <area> <output> [<file> <ResourceFS name> | -via <viafile>]

Where:

  [options] select -26bit to mark the AOF function as APCS-R
                   -32bit to mark the AOF function as APCS 3/32 (default)
                   -wa    to not warn about zero length files

  <area> is the name of an AOF AREA in which the resource file data is
  to be placed. A function of this name is exported as an external symbol which
  can be used in C or assembler code to get the address of the resource data.

  <output> is the name of the object output file to be produced.

Followed by repeats of:

  <file> is the name of a file to be included in the resource file
  data.

  <ResourceFS name> is the name within the ResourceFS which is used by the
  application to refer to a file within the resource file data.

or a <viafile> containing a list of <file> <ResourceFS name> pairs, one
per line. This may be used for convenience or to circumvent the 256
character command line length limit.

A typical use might be

  ResGen -32bit resarea o.resobj en-gb.translation Resources.MyModule.Messages

then in the C program

  extern int resarea(void);
  :
  _swix(ResourceFS_RegisterFiles, _IN(0), resarea());

and finally link them together

  link -rmf -o MyModule o.program o.resobj C:o.stubs


Prior to ResGen 1.00
====================

This is the version supplied with Application Note 280 in support of
the User Interface Toolbox.


Changes in version 1.01
=======================

The -wa switch supresses warnings about adding zero length files to ResourceFS.


Changes in version 1.02 to 1.07
===============================

The addition of -26bit and -32bit options to select APCS variant. The default
is 32bit.
