Build System Documentation

Over time this document will describe the UHC build structure.

1 Overview

2 EHC variant building

3 make defines

These defines are all passed to make (or a submake via $(MAKE)) by <name>=<value>.

• INCLUDE_DERIVED_MK, values: yes|..., use: internal
  Compute the dependencies between chunked source code using shuffle, and include these. This is necessary for building any ehc variant and other make targets using the content of these chunked files, for example for text targets including source code. If such a flag were not used, make would complain about the absence of derived makefiles, build them (using shuffle, which has to be build then as well), etc. This is confusing for make targets which do not require this.

4 Release checklist

• ensure the version nr in VERSION (EHCHOME/VERSION) is right.
• run make release-prepare, to build expected regression test output.
• svn commit this plus other changes.
• check whether make uhc; make install; make test works on as many platforms as possible.
• repeat this until it works...
• ensure all is committed.
• svn co a fresh copy, do a configure in there, and proceed from this dir.
• make release
• svn commit the release from the top of the svn repository working copy.
• make release/version available as tarball download on the svn.cs.uu.nl.
• update the download page.
• update the news page.

Yes, I know, this way it is crap and way too much work...