2.4.1.1 Unix using RPM packages

Getting RPMs packages

Building your own RPMs is probably the best option. This way you won't have to find distribution specific package, and you'll be able to set building options. For this purpose, `CS/scripts/rpm/cs.spec' file is provided with Crystal Space.

Configure your system to build RPMs packages

Building RPMs packages involves a few settings, which are covered in the following page: http://qa.mandrakesoft.com/twiki/bin/view/Main/RpmHowTo#Preliminary_tasks

Building your own RPMs packages from Crystal Space source archive

Once you've set your system to build RPM packages as a regular user:

1. Get Crystal Space sources archive (see section 1.6 Where to Get Crystal Space) and put it in your `rpm/SOURCES/' directory.

2. Go into your `rpm/SPECS' directory.

3. Extract the `CS/scripts/rpm/cs.spec' file, and put it in your `rpm/SPECS/' directory.

   cd /home/user/rpm/SPECS tar xvjf /home/user/rpm/SOURCES/cs98_003.tar.bz2 \ CS/scripts/rpm/cs.spec mv CS/scripts/rpm/cs.spec /home/user/rpm/SPECS rm -rf CS/

4. Verify the source archive filename you downloaded is set in accordance with the filename part of the URL in `Source:' line of `cs.spec', otherwise rpm won't be able to do his job.

• To build binary RPMs only, use rpm -bb cs.spec
• To build source RPMs as well, use rpm -ba cs.spec

Build options are specified by using --with switch. The following values are supported:

• --with newrenderer to build with New Renderer support.
• --with perl to build with Perl support.
• --with debug. This option may be useless since rpm strips files before packaging.

So, to build all packages, with New Renderer and Perl support, use:

rpm -ba cs.spec --with newrenderer --with perl

The binary RPMs should be under `rpm/RPMS/', and the source RPM in `rpm/SRPMS/'.

The process builds three Crystal Space binary RPMs packages :

1. `crystalspace' base package. It provides executables, plugins, data and configuration files.
2. `crystalspace-devel' development package. It provides headers and static libraries needed for development.
3. `crystalspace-doc' documentation package. It provides api and user manual documentation in HTML format.