[Meta]
ShortName: the name that would have been used in rpm, for instance "dialog", "genst", "gaim", "emacs" etc
Version: the version of the software (ie 0.9, 1.1-alpha etc)
DisplayName: The display name of software in english, so "K Desktop Environment", or "GNOME" or "Codeweavers Crossover"
DisplayName[de]: german localisation etc
RootName: The root name of the package in the form @host.domain/path/packagename/version
InstallerFile: the name of the installer file to create (ie genst-1.0.package)

Summary: A short description in english of what the software does
Summary[fr]: french localisation etc
Packager: My Name <my@address>
Maintainer: if this is missed out, assumed to be the same as Packager
Bugs: another email address, where to report bugs too. Perhaps in future an integrated bug reporting tool? As above
Environment: console|X|KDE|GNOME|Enlightenment - used to determine install paths amongst other things

[Description]
Put a longer description of the package here in english

[Description:de]
Localised versions

[BuildPrepare]
Script that prepares the software for packaging - usually consists of the build sequence, or
simply "prepareBuild" which will do it for you

[BuildUnprepare]
Reset the build back to its original state (ie clean it, reset the prefix etc)

[Extractions]
What files to extract from the prepared build root. Consists of calls to the extract method:

extract "./bin" "$build_root" "bin/genst"
extract "./share" "$build_root" "share/genst/*"
extract "./doc" "$source_dir" "AUTHORS COPYING ChangeLog NEWS README"

The first parameter is the relative directory from which to copy (the reasons for the split are somewhat obscure)
The second parameter is where to copy from. $build_root is where the software was "make installed" to. $source_dir is the source directory.
The final parameter is the list of files to copy, or a globbing pattern.

[Script-Prep]
The preparation script. Usually consists of calls firstly to "require" for
dependancy checking, then any user interactions that may be needed/wanted.

[Script-Install]
The installation script. This is the install process itself. This will be
called if the preparation script has successfully finished.

[Script-Uninstall]
reverseLog
