67 ROM (/epoc32/rom/phone, /epoc32/rom/include)</codeblock> <p><b>value</b> </p><p>Value |
67 ROM (/epoc32/rom/phone, /epoc32/rom/include)</codeblock> <p><b>value</b> </p><p>Value |
68 can be a variant name, a file name or a directory name. for example, myphone |
68 can be a variant name, a file name or a directory name. for example, myphone |
69 or /epoc32/tools/variant/name.var. </p><ul> |
69 or /epoc32/tools/variant/name.var. </p><ul> |
70 <li><p>Use '/' as the path separator between files and directories.</p></li> |
70 <li><p>Use '/' as the path separator between files and directories.</p></li> |
71 <li><p>Begin all paths with '/' implying that they are relative to EPOCROOT.</p></li> |
71 <li><p>Begin all paths with '/' implying that they are relative to EPOCROOT.</p></li> |
72 </ul> <p><b>Example</b> </p> <p>An example of a variant: </p> <codeblock id="GUID-50190D57-7C49-5697-A858-7626D59B1967-GENID-1-11-1-1-7-1-11-1-2-2-20" xml:space="preserve">VARIANT name |
72 </ul> <p><b>Example</b> </p> <p>An example of a variant: </p> <codeblock id="GUID-50190D57-7C49-5697-A858-7626D59B1967-GENID-1-13-1-1-7-1-11-1-2-2-20" xml:space="preserve">VARIANT name |
73 VIRTUAL |
73 VIRTUAL |
74 EXTENDS parent |
74 EXTENDS parent |
75 VARIANT_HRH /epoc32/include/variant/something.hrh |
75 VARIANT_HRH /epoc32/include/variant/something.hrh |
76 BUILD_INCLUDE set directoryA |
76 BUILD_INCLUDE set directoryA |
77 BUILD_INCLUDE append directoryB |
77 BUILD_INCLUDE append directoryB |
79 ROM_INCLUDE set directoryD |
79 ROM_INCLUDE set directoryD |
80 ROM_INCLUDE append directoryE |
80 ROM_INCLUDE append directoryE |
81 ROM_INCLUDE prepend directoryF |
81 ROM_INCLUDE prepend directoryF |
82 |
82 |
83 </codeblock> <p><b>Notes</b> </p> <ul> |
83 </codeblock> <p><b>Notes</b> </p> <ul> |
84 <li id="GUID-84B8E804-46B8-5422-9CFE-048C9EF0179B-GENID-1-11-1-1-7-1-11-1-2-2-22-1"><p>All <filepath>.var</filepath> files |
84 <li id="GUID-84B8E804-46B8-5422-9CFE-048C9EF0179B-GENID-1-13-1-1-7-1-11-1-2-2-22-1"><p>All <filepath>.var</filepath> files |
85 must exist in <filepath>/epoc32/tools</filepath> <filepath>/</filepath> <varname>variant</varname>. </p> </li> |
85 must exist in <filepath>/epoc32/tools</filepath> <filepath>/</filepath> <varname>variant</varname>. </p> </li> |
86 <li id="GUID-CDB78FAD-58A6-5464-ACC6-EFBCEDFD5092-GENID-1-11-1-1-7-1-11-1-2-2-22-2"><p>A default variant configuration |
86 <li id="GUID-CDB78FAD-58A6-5464-ACC6-EFBCEDFD5092-GENID-1-13-1-1-7-1-11-1-2-2-22-2"><p>A default variant configuration |
87 file (<filepath>default.var</filepath>) must exist in <filepath>/epoc32/tools/variant/</filepath>. </p> </li> |
87 file (<filepath>default.var</filepath>) must exist in <filepath>/epoc32/tools/variant/</filepath>. </p> </li> |
88 <li id="GUID-7216C624-7E28-52A5-BAA7-BB897286AE51-GENID-1-11-1-1-7-1-11-1-2-2-22-3"><p>The name of the variant |
88 <li id="GUID-7216C624-7E28-52A5-BAA7-BB897286AE51-GENID-1-13-1-1-7-1-11-1-2-2-22-3"><p>The name of the variant |
89 configuration file (.var) must be same as the variant name. For example, if |
89 configuration file (.var) must be same as the variant name. For example, if |
90 the variant name is <b>myvar</b>, then the variant configuration file must |
90 the variant name is <b>myvar</b>, then the variant configuration file must |
91 be named as <filepath>myvar.var</filepath>. </p> </li> |
91 be named as <filepath>myvar.var</filepath>. </p> </li> |
92 <li id="GUID-CADF1047-C92E-5A8C-81FB-64CAA19380B8-GENID-1-11-1-1-7-1-11-1-2-2-22-4"><p>Each variant must have |
92 <li id="GUID-CADF1047-C92E-5A8C-81FB-64CAA19380B8-GENID-1-13-1-1-7-1-11-1-2-2-22-4"><p>Each variant must have |
93 a default <filepath><variant_name>.hrh</filepath> file at <filepath>/epoc32/include/variant/</filepath>. |
93 a default <filepath><variant_name>.hrh</filepath> file at <filepath>/epoc32/include/variant/</filepath>. |
94 If you want to use any other <filepath>.hrh</filepath> file under EPOCROOT, |
94 If you want to use any other <filepath>.hrh</filepath> file under EPOCROOT, |
95 use the <codeph>VARIANT_HRH</codeph> keyword to specify its name along with |
95 use the <codeph>VARIANT_HRH</codeph> keyword to specify its name along with |
96 the relative path. </p> </li> |
96 the relative path. </p> </li> |
97 <li id="GUID-FEEDF642-117E-5E4F-8CD4-B6305B977204-GENID-1-11-1-1-7-1-11-1-2-2-22-5"><p>A default variant cannot |
97 <li id="GUID-FEEDF642-117E-5E4F-8CD4-B6305B977204-GENID-1-13-1-1-7-1-11-1-2-2-22-5"><p>A default variant cannot |
98 be <codeph>VIRTUAL</codeph>. </p> </li> |
98 be <codeph>VIRTUAL</codeph>. </p> </li> |
99 </ul> </section> |
99 </ul> </section> |
100 <section><title>Example</title> <p>An example of a variant: </p> <codeblock id="GUID-50190D57-7C49-5697-A858-7626D59B1967-GENID-1-11-1-1-7-1-11-1-2-3-3" xml:space="preserve">VARIANT name |
100 <section><title>Example</title> <p>An example of a variant: </p> <codeblock id="GUID-50190D57-7C49-5697-A858-7626D59B1967-GENID-1-13-1-1-7-1-11-1-2-3-3" xml:space="preserve">VARIANT name |
101 VIRTUAL |
101 VIRTUAL |
102 EXTENDS parent |
102 EXTENDS parent |
103 VARIANT_HRH /epoc32/include/variant/something.hrh |
103 VARIANT_HRH /epoc32/include/variant/something.hrh |
104 BUILD_INCLUDE set directoryA |
104 BUILD_INCLUDE set directoryA |
105 BUILD_INCLUDE append directoryB |
105 BUILD_INCLUDE append directoryB |
108 ROM_INCLUDE append directoryE |
108 ROM_INCLUDE append directoryE |
109 ROM_INCLUDE prepend directoryF |
109 ROM_INCLUDE prepend directoryF |
110 |
110 |
111 </codeblock> </section> |
111 </codeblock> </section> |
112 <section><title>Notes</title> <ul> |
112 <section><title>Notes</title> <ul> |
113 <li id="GUID-84B8E804-46B8-5422-9CFE-048C9EF0179B-GENID-1-11-1-1-7-1-11-1-2-4-2-1"><p>All <filepath>.var</filepath> files |
113 <li id="GUID-84B8E804-46B8-5422-9CFE-048C9EF0179B-GENID-1-13-1-1-7-1-11-1-2-4-2-1"><p>All <filepath>.var</filepath> files |
114 must exist in <filepath>/epoc32/tools</filepath> <filepath>/</filepath> <varname>variant</varname>. </p> </li> |
114 must exist in <filepath>/epoc32/tools</filepath> <filepath>/</filepath> <varname>variant</varname>. </p> </li> |
115 <li id="GUID-CDB78FAD-58A6-5464-ACC6-EFBCEDFD5092-GENID-1-11-1-1-7-1-11-1-2-4-2-2"><p>A default variant configuration |
115 <li id="GUID-CDB78FAD-58A6-5464-ACC6-EFBCEDFD5092-GENID-1-13-1-1-7-1-11-1-2-4-2-2"><p>A default variant configuration |
116 file (<filepath>default.var</filepath>) must exist in <filepath>/epoc32/tools/variant/</filepath>. </p> </li> |
116 file (<filepath>default.var</filepath>) must exist in <filepath>/epoc32/tools/variant/</filepath>. </p> </li> |
117 <li id="GUID-7216C624-7E28-52A5-BAA7-BB897286AE51-GENID-1-11-1-1-7-1-11-1-2-4-2-3"><p>The name of the variant |
117 <li id="GUID-7216C624-7E28-52A5-BAA7-BB897286AE51-GENID-1-13-1-1-7-1-11-1-2-4-2-3"><p>The name of the variant |
118 configuration file (.var) must be same as the variant name. For example, if |
118 configuration file (.var) must be same as the variant name. For example, if |
119 the variant name is <b>myvar</b>, then the variant configuration file must |
119 the variant name is <b>myvar</b>, then the variant configuration file must |
120 be named as <filepath>myvar.var</filepath>. </p> </li> |
120 be named as <filepath>myvar.var</filepath>. </p> </li> |
121 <li id="GUID-CADF1047-C92E-5A8C-81FB-64CAA19380B8-GENID-1-11-1-1-7-1-11-1-2-4-2-4"><p>Each variant must have |
121 <li id="GUID-CADF1047-C92E-5A8C-81FB-64CAA19380B8-GENID-1-13-1-1-7-1-11-1-2-4-2-4"><p>Each variant must have |
122 a default <filepath><variant_name>.hrh</filepath> file at <filepath>/epoc32/include/variant/</filepath>. |
122 a default <filepath><variant_name>.hrh</filepath> file at <filepath>/epoc32/include/variant/</filepath>. |
123 If you want to use any other <filepath>.hrh</filepath> file under EPOCROOT, |
123 If you want to use any other <filepath>.hrh</filepath> file under EPOCROOT, |
124 use the <codeph>VARIANT_HRH</codeph> keyword to specify its name along with |
124 use the <codeph>VARIANT_HRH</codeph> keyword to specify its name along with |
125 the relative path. </p> </li> |
125 the relative path. </p> </li> |
126 <li id="GUID-FEEDF642-117E-5E4F-8CD4-B6305B977204-GENID-1-11-1-1-7-1-11-1-2-4-2-5"><p>A default variant cannot |
126 <li id="GUID-FEEDF642-117E-5E4F-8CD4-B6305B977204-GENID-1-13-1-1-7-1-11-1-2-4-2-5"><p>A default variant cannot |
127 be <codeph>VIRTUAL</codeph>. </p> </li> |
127 be <codeph>VIRTUAL</codeph>. </p> </li> |
128 </ul></section> |
128 </ul></section> |
129 </conbody><related-links> |
129 </conbody><related-links> |
130 <link href="GUID-917413FC-0AC0-5768-B5AD-36BD2EDCB1FF.dita"><linktext>How to build |
130 <link href="GUID-917413FC-0AC0-5768-B5AD-36BD2EDCB1FF.dita"><linktext>How to build |
131 feature based variants</linktext></link> |
131 feature based variants</linktext></link> |