From 54b41ab95053434aaf3a2782d5465e7dd4b88be6 Mon Sep 17 00:00:00 2001 From: Mark Linimon Date: Wed, 1 Dec 2010 09:05:46 +0000 Subject: [PATCH] Add new section, "notes on the codebase". More to come. --- .../articles/portbuild/article.sgml | 44 +++++++++++++++++++ 1 file changed, 44 insertions(+) diff --git a/en_US.ISO8859-1/articles/portbuild/article.sgml b/en_US.ISO8859-1/articles/portbuild/article.sgml index 06f3837205..a9195f7817 100644 --- a/en_US.ISO8859-1/articles/portbuild/article.sgml +++ b/en_US.ISO8859-1/articles/portbuild/article.sgml @@ -77,6 +77,50 @@ for experimental builds + + + Notes on the codebase + + Until mid-2010, the scripts were completely specific to + pointyhat as the head (dispatch) node. During + the summer of 2010, a significant rewrite was done in order to allow + for other hosts to be head nodes. Among the changes were: + + + removal of the hard-coding of the string + pointyhat + + factoring out all configuration constants (which + were previously scattered throughout the code) into configuration + files + + + appending the hostname to the directories + specified by buildid (this will allow + directories to be unambigious when copied between machines.) + + + making the scripts more robust in terms of setting + up directories and symlinks + + where necessary, changing certain script invocations + to make all the above easier + + + + This document was originally written before these changes + were made. Where things such as script invocations have changed, + they are denoted as new codebase: as opposed + to old codebase:. + + + As of December 2010, pointyhat is still + running on the old codebase, until the new codebase is considered + rock-solid. + + + +