Difference between revisions of "Development snapshots"

From ScarletDME
Jump to navigation Jump to search
Line 37: Line 37:
 
==How to build a new copy of OpenQM GPL from a snapshot==
 
==How to build a new copy of OpenQM GPL from a snapshot==
  
<to be done>
+
Firstly, stop any instances of OpenQM using "qm -stop".
 +
 
 +
After extracing the snapshot, simply build the distribution like you would the stable release.
 +
 
 +
You will need a C compiler and the 'make' system in order to build.
 +
 
 +
Run 'make' from the snapshot root to build the binaries. They will be located under ./bin/ after linking.
 +
 
 +
Once the binaries are built, copy ./bin/qm to either /usr/bin/ or another user binary directory listed in your environment path.
 +
 
 +
Copy everything except the ./gplsrc/ directory to /usr/qmsys/.
 +
 
 +
Run 'qm -start' to start OpenQM.
 +
 
 +
Change to the /usr/qmsys/ directory and run 'qm -internal'. You will need to rebuild the GPL.BP sources, including the QMBASIC compiler. The steps in this process should be strictly followed to avoid the possibility of breaking your QMBASIC compiler and install. This is normally required only when SYSCOM.H is changed, but it is a good general habit to gain if you plan on building snapshots often.
 +
 
 +
After logging in using 'qm -internal', under /usr/qmsys/, rebuild the files in the following manner:
 +
 
 +
1) BASIC GPL.BP CPROC LOGIN BASIC BCOMP PTERM CATALOG
 +
 
 +
2) Exit out of QM
 +
 
 +
3) Log back into OpenQM again using "qm -internal"
 +
 
 +
4) BASIC GPL.BP *
 +
 
 +
5) Recompile any applications that need new features or changes provided by the new snapshot. It is best to recompile ALL of your application code if possible.
 +
 
 +
6) * * * Much Rejoicing * * *
  
 
==How to upgrade an existing OpenQM GPL install from a snapshot==
 
==How to upgrade an existing OpenQM GPL install from a snapshot==
  
 
<to be done>
 
<to be done>

Revision as of 04:04, 12 April 2009

How to obtain a snapshot of a recent development revision

Snapshots are available at http://gpl.openqm.com/downloads/snapshots/.

For the latest snapshot go to http://gpl.openqm.com/downloads/snapshots/current-dev-snapshot.tar.gz

Snapshot filename convention is: openqm-gpl-dev-<stable version number>-r<SVN revision>.tar.gz

How to unpack a snapshot

The snapshot is a gzipped tar file. The simplest way to extract the files is to use the following command:

tar -zxf current-dev-snapshot.tar.gz


You can also decompress the file first and then extract the files:

gunzip current-dev-snapshot.tar.gz

tar -xf current-dev-snapshot.tar.gz


The tar will extract the entire OpenQM bundle and gplsrc root into the current working directory.

Example process:

cd /tmp/

mkdir /tmp/openqm-snapshot/

cd /tmp/openqm-snapshot/

wget http://gpl.openqm.com/downloads/snapshots/current-dev-snapshot.tar.gz

tar -zxf current-dev-snapshot.tar.gz

How to build a new copy of OpenQM GPL from a snapshot

Firstly, stop any instances of OpenQM using "qm -stop".

After extracing the snapshot, simply build the distribution like you would the stable release.

You will need a C compiler and the 'make' system in order to build.

Run 'make' from the snapshot root to build the binaries. They will be located under ./bin/ after linking.

Once the binaries are built, copy ./bin/qm to either /usr/bin/ or another user binary directory listed in your environment path.

Copy everything except the ./gplsrc/ directory to /usr/qmsys/.

Run 'qm -start' to start OpenQM.

Change to the /usr/qmsys/ directory and run 'qm -internal'. You will need to rebuild the GPL.BP sources, including the QMBASIC compiler. The steps in this process should be strictly followed to avoid the possibility of breaking your QMBASIC compiler and install. This is normally required only when SYSCOM.H is changed, but it is a good general habit to gain if you plan on building snapshots often.

After logging in using 'qm -internal', under /usr/qmsys/, rebuild the files in the following manner:

1) BASIC GPL.BP CPROC LOGIN BASIC BCOMP PTERM CATALOG

2) Exit out of QM

3) Log back into OpenQM again using "qm -internal"

4) BASIC GPL.BP *

5) Recompile any applications that need new features or changes provided by the new snapshot. It is best to recompile ALL of your application code if possible.

6) * * * Much Rejoicing * * *

How to upgrade an existing OpenQM GPL install from a snapshot

<to be done>