From: Todd Lyons Date: Sat, 26 Oct 2013 01:14:47 +0000 (-0700) Subject: Updated Home (markdown) X-Git-Url: https://git.exim.org/buildfarm-client-wiki.git/commitdiff_plain/cb2dc4f72fb6bc3839fd658cb307fca0edad680d?hp=375f03850eb803ef5dc8adae9765fc183577464c Updated Home (markdown) --- diff --git a/Home.md b/Home.md index 6b6a6e6..22568e2 100644 --- a/Home.md +++ b/Home.md @@ -4,4 +4,13 @@ The Exim Build Farm Client software is run on machines to build and test the [Ex View the [Installation](https://github.com/mrballcb/exim-build-farm-client/wiki/Installation) page for info on how to install the Build Farm Client. +## Overview + +In the default configuration, a full rebuild of Exim will occur when a new commit to the monitored branches occurs or every 7 days, and it will also build and run the test suite. You can choose to have it also build the docs, but there are several extra package requirements for it to build the documentation. + +Review your enabled features in the Makefile and make adjustments to your *build-farm.conf* to enable those features, using either the makefile_set, makefile_add, or makefile_regex. You may also receive requests from the developers to enable specific features on your build. Documentation for enabling these in [build-config.conf](https://github.com/mrballcb/exim-build-farm-client/wiki/BuildConfigConf) is elsewhere. + +The default build configuration will build all branches specified in a text file on the server. Most of the time this will only be HEAD, but occasionally the developers may have an interest in building some experimental code on a different branch. The above configuration will do all of it automatically for you. The *run_cron.sh* will also check the master repo at github and update itself (the Exim Build Farm Client software). + +## Credits This code is derived from the excellent [PostgreSQL Build Farm](http://www.pgbuildfarm.org/) client and server code. Many thanks to them for a fantastic collection which serves such a useful function. \ No newline at end of file