diff -r ac0bbc1e5d79 -r 8dd670a9f34f sbsv2/raptor/notes/variant_cfg.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/sbsv2/raptor/notes/variant_cfg.txt Mon Sep 13 14:04:04 2010 +0100 @@ -0,0 +1,25 @@ +The pre-included header file used in builds (.hrh) is normally defined +inside a text file located at $(EPOCROOT)/epoc32/tools/variant/variant.cfg +in each kit. + +This is an unnecessary extra file to maintain if you already define all the +other kit properties in an XML file in the $(EPOCROOT)/epoc32/sbs_config +folder. + +This change allows kit owners to define the .hrh file name in the XML instead +of using an additional variant.cfg file. + +An example of this is shown in $(SBS_HOME)/examples/os_properties.xml +where the VARIANT_HRH parameter is set as follows, + + + + +In the unusual case where you want to build without a .hrh file at all (maybe +to create an epoc32 tree from scratch) there is a variant "nohrh" which +simply sets VARIANT_HRH as above to an empty file. Example usage would be, + +sbs -b bootstrap/bld.inf -c tools2.nohrh + +Note that, in general, actual code will not build properly without a .hrh +file to configure it.