Added instructions for how to build rpm files.

Author: robert_dodier

README.rpms

@@ -1,8 +1,63 @@
-These RPMs were created on a RedHat Enterprise Linux 3-compatible
-system.
+Installing rpms
+===============
 
-Both the maxima and maxima-exec-cmucl packages are required. It is
-possible to simultaneously install maxima-exec packages for other
-lisps, but I am only providing cmucl at this time.
+There are three Maxima binary rpms:
+maxima, maxima-exec-cmucl, and maxima-xmaxima.
 
-The maxima-xmaxima package is optional. It provides a maxima GUI.
+The maxima and maxima-exec-cmucl rpms must be installed together.
+
+maxima-exec rpms for other Lisp versions can also be installed,
+although you'll probably have to build them yourself.
+
+The maxima-xmaxima rpm is optional. Xmaxima is a Maxima GUI.
+
+
+Building rpms
+=============
+
+You can build rpm files from an unpacked tarball or cvs sandbox.
+
+(0) Go to the Maxima directory.
+
+    $ cd sandbox/maxima  # or whatever is your top-level maxima directory
+
+(1) Set the version number.
+    
+    Open ./configure.in and change the AM_INIT_AUTOMAKE line.
+    (This is the only way I know to change the version number.)
+
+    Optionally -- open ./maxima.spec.in and increment the `Release' number.
+    (This number is appended to the version number.)
+
+(2) Select Lisp version.
+
+    Open ./maxima.spec.in.
+
+    Change all `%define enable_<whatever>' to `0'
+    except for the selected Lisp; make that `1'.
+
+    Change all `%define <whatever>_flags' to `--disable-<whatever>'
+    except for the selected Lisp; make that `--enable-<whatever>'.
+
+(3) Generate the rpm spec file.
+
+    $ make maxima.spec
+
+(4) Generate a source tarball.
+
+    $ make dist-gzip
+
+    May need to invoke superuser privileges here (if /usr/src/local not writeable).
+
+    $ mv maxima-<release number>.tar.gz /usr/src/local/SOURCES
+
+(5) Build rpms.
+
+    The maxima.spec file builds three binary rpms:
+    maxima, maxima-xmaxima, and maxima-exec-<whatever>.
+
+    May need to invoke superuser privileges here (if /usr/src/local not writeable).
+
+    $ rpmbuild -ba ./maxima.spec  # build source rpm and three binary rpms
+
+    $ rpmbuild -bb ./maxima.spec  # build three binary rpms