sbsv2/raptor/notes/variant_cfg.txt
author jascui
Tue, 16 Nov 2010 15:56:27 +0800
changeset 683 8e0eb519ef53
parent 641 8dd670a9f34f
permissions -rw-r--r--
Solve incorrect handling of ExportName=SymbolName@Ordinal syntax
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
641
8dd670a9f34f sbs version 2.15.2
Jon Chatten
parents:
diff changeset
     1
The pre-included header file used in builds (.hrh) is normally defined
8dd670a9f34f sbs version 2.15.2
Jon Chatten
parents:
diff changeset
     2
inside a text file located at $(EPOCROOT)/epoc32/tools/variant/variant.cfg
8dd670a9f34f sbs version 2.15.2
Jon Chatten
parents:
diff changeset
     3
in each kit.
8dd670a9f34f sbs version 2.15.2
Jon Chatten
parents:
diff changeset
     4
8dd670a9f34f sbs version 2.15.2
Jon Chatten
parents:
diff changeset
     5
This is an unnecessary extra file to maintain if you already define all the
8dd670a9f34f sbs version 2.15.2
Jon Chatten
parents:
diff changeset
     6
other kit properties in an XML file in the $(EPOCROOT)/epoc32/sbs_config
8dd670a9f34f sbs version 2.15.2
Jon Chatten
parents:
diff changeset
     7
folder.
8dd670a9f34f sbs version 2.15.2
Jon Chatten
parents:
diff changeset
     8
8dd670a9f34f sbs version 2.15.2
Jon Chatten
parents:
diff changeset
     9
This change allows kit owners to define the .hrh file name in the XML instead
8dd670a9f34f sbs version 2.15.2
Jon Chatten
parents:
diff changeset
    10
of using an additional variant.cfg file.
8dd670a9f34f sbs version 2.15.2
Jon Chatten
parents:
diff changeset
    11
8dd670a9f34f sbs version 2.15.2
Jon Chatten
parents:
diff changeset
    12
An example of this is shown in $(SBS_HOME)/examples/os_properties.xml
8dd670a9f34f sbs version 2.15.2
Jon Chatten
parents:
diff changeset
    13
where the VARIANT_HRH parameter is set as follows,
8dd670a9f34f sbs version 2.15.2
Jon Chatten
parents:
diff changeset
    14
8dd670a9f34f sbs version 2.15.2
Jon Chatten
parents:
diff changeset
    15
<set name='VARIANT_HRH' value='$(EPOCINCLUDE)/feature_settings.hrh'/>
8dd670a9f34f sbs version 2.15.2
Jon Chatten
parents:
diff changeset
    16
8dd670a9f34f sbs version 2.15.2
Jon Chatten
parents:
diff changeset
    17
8dd670a9f34f sbs version 2.15.2
Jon Chatten
parents:
diff changeset
    18
In the unusual case where you want to build without a .hrh file at all (maybe
8dd670a9f34f sbs version 2.15.2
Jon Chatten
parents:
diff changeset
    19
to create an epoc32 tree from scratch) there is a variant "nohrh" which
8dd670a9f34f sbs version 2.15.2
Jon Chatten
parents:
diff changeset
    20
simply sets VARIANT_HRH as above to an empty file. Example usage would be,
8dd670a9f34f sbs version 2.15.2
Jon Chatten
parents:
diff changeset
    21
8dd670a9f34f sbs version 2.15.2
Jon Chatten
parents:
diff changeset
    22
sbs -b bootstrap/bld.inf -c tools2.nohrh
8dd670a9f34f sbs version 2.15.2
Jon Chatten
parents:
diff changeset
    23
8dd670a9f34f sbs version 2.15.2
Jon Chatten
parents:
diff changeset
    24
Note that, in general, actual code will not build properly without a .hrh
8dd670a9f34f sbs version 2.15.2
Jon Chatten
parents:
diff changeset
    25
file to configure it.