Chapter 3. Creating and using the package file

Once the package XML has been written, stub configuration files have been
created and source files have been gathered, it is time to combine all of the
files into a ReST package. Part of the ReST suite is the ReST Packager
utility. This utility combines all of the necessary files into one package
for easy distribution. Below is an example of how the ReST Packager
is used.

In the above example, the user has run the ReST Packager, which is
included in the ReST suite to create a package named example.rsp. The
-X argument tells the ReST Packager to use
examplepackage.xml as the package XML file for this package.
The -f argument tells the packager the name of the file
to create. The remaining arguments tell the Packager which files to include.
Every file that is declared in the package.xml must be included in the Packager
arguments. The resulting file can be distributed by whatever means desired
and used with the ReST Installer.

Once the package file is created, it simply needs to be installed from the
ReST Installer. To install the package, run the ReST Installer with the name of
the package as an argument. The package can be local or placed on a web server,
although larger packages will run more quickly if they are local. Here is an
example of our package being used by the ReST Installer.