Symbian3/PDK/Source/GUID-ED20B02A-C146-5E28-A102-D3AE11D9015F.dita
changeset 5 f345bda72bc4
parent 3 46218c8b8afa
child 14 578be2adaf3e
--- a/Symbian3/PDK/Source/GUID-ED20B02A-C146-5E28-A102-D3AE11D9015F.dita	Tue Mar 30 11:42:04 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-ED20B02A-C146-5E28-A102-D3AE11D9015F.dita	Tue Mar 30 11:56:28 2010 +0100
@@ -1,57 +1,57 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
-<!-- This component and the accompanying materials are made available under the terms of the License 
-"Eclipse Public License v1.0" which accompanies this distribution, 
-and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
-<!-- Initial Contributors:
-    Nokia Corporation - initial contribution.
-Contributors: 
--->
-<!DOCTYPE concept
-  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
-<concept id="GUID-ED20B02A-C146-5E28-A102-D3AE11D9015F" xml:lang="en"><title>Building
-and Running the MiniGUI Tutorial</title><shortdesc>This topic describes how to build a MiniGUI ROM image and how to
-run the MiniGUI in the emulator. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
-<p> <b>Variant</b>: ScreenPlay. <b>Target audience</b>: Device creators. </p>
-<p>This topic builds on the introduction in the <xref href="GUID-E09F74E2-B5A2-51F8-BD9E-882BE2661D5C.dita">MiniGUI
-Environment Overview</xref> and the ROM Tools Guide. </p>
-<section><title>Building a MiniGUI ROM image</title> <ol id="GUID-AAD227D8-8D67-5951-B359-715D4A0AD33B">
-<li id="GUID-9921FB78-9201-5337-95D4-CB62BEFA4C32"><p>Use a text editor to
-edit the Window Server configuration file, <filepath>\epoc32\data\z\wsini_minigui.ini</filepath>. </p> <p>Note:
-This file must be created or saved in Unicode instead of ASCII. </p> </li>
-<li id="GUID-43452758-28A2-5095-88FB-07C2964F49CB"><p>Add the following lines
-to the <filepath>wsini_minigui.ini</filepath> file to start ESHELL as the
-system shell in the specified screen mode. </p> <codeblock id="GUID-21B815C5-1BE1-5905-87C6-BA14DA659C8B" xml:space="preserve">STARTUP ESHELL
-SCREENMODE COLOR16MAP</codeblock> <p>Refer to <xref href="GUID-1D529BDC-6665-58E2-AB3F-7023D8A84F69.dita">The
-wsini.ini File Reference</xref> for more information about the parameters. </p> </li>
-<li id="GUID-CC5687DF-9863-51C6-B348-D10C10868DAD"><p>Make sure that the ROM
-image description file, <filepath>minigui.oby</filepath>, exists under <filepath>\epoc32\rom\include\</filepath>.
-This OBY file is the input file to the <filepath>BUILDROM</filepath> tool. </p> <p>This
-file contains a statement that refers to the <filepath>wsini_minigui.ini</filepath> file. </p> <codeblock id="GUID-82D32D6F-A2A2-56A0-8AF9-6C021CC3E321" xml:space="preserve">data=DATAZ_\wsini_minigui.ini    system\data\wsini.ini</codeblock> </li>
-<li id="GUID-C3015F0E-CDE7-5940-9088-9DBE34468277"><p>Build a MiniGUI ROM
-image from a command prompt. </p> <p>The following commands build a ROM image
-for H4: </p> <p>&gt; cd d:\Symbian\epoc32\rom </p> <p>&gt; buildrom -nosymbols h4hrp
-minigui </p> <p>The following commands build a ROM image for H6: </p> <p>&gt;
-cd d:\Symbian\epoc32\rom </p> <p>&gt; buildrom -nosymbols 34xx_sdp minigui </p> <p>Where <filepath>minigui</filepath> stands
-for the <filepath>minigui.oby</filepath> file. The <codeph>-nosymbols</codeph> directive
-means do not generate the symbol file which contains the ROM building information
-for debugging purpose. </p> </li>
-</ol> <p> <b>Result</b>: The MiniGUI ROM image is generated in the current
-directory: <filepath>d:\Symbian\epoc32\rom</filepath>. </p> </section>
-<section><title>Running the MiniGUI in the emulator</title> <ol id="GUID-DC6EB5D4-FDE5-5464-B2CE-0D272F4AAD61">
-<li id="GUID-B6913759-85BE-5480-B3A2-F0D52D7E40B7"><p>Make sure that ScreenPlay
-is enabled and add the following line to the <filepath>\epoc32\data\epoc.ini</filepath> file: </p> <codeblock id="GUID-EE4BD889-EB25-5259-9183-7F96BF419794" xml:space="preserve">minigui</codeblock> <p>For
-more information about enabling ScreenPlay, refer to <xref href="GUID-6D8A1FC7-095B-587E-8274-23C132978C53.dita">Enabling
-the Graphics Architecture Variants</xref>. </p> </li>
-<li id="GUID-B866EB6F-7817-55F1-9631-ED0B7122B048"><p>Add the following lines
-to the <filepath>\epoc32\release\winscw\udeb\z\system\data\wsini.ini</filepath> to
-start ESHELL as the system shell in the specified screen mode: </p> <codeblock id="GUID-7ECA751A-5C25-5774-ACBD-DA5D861C125D" xml:space="preserve">startup eshell
-screenmode color16map</codeblock> </li>
-</ol> <p>Launch the emulator to verify that MiniGUI configuration works. It
-boots into the black and white ESHELL. </p> </section>
-</conbody><related-links>
-<link href="GUID-6D8A1FC7-095B-587E-8274-23C132978C53.dita"><linktext>Enabling
-the Graphics Architecture  Variants</linktext></link>
-<link href="GUID-85E1E45B-DD05-5B7D-84E7-9911E0A3E3CC.dita"><linktext>The wsini.ini
-File</linktext></link>
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
+<!-- This component and the accompanying materials are made available under the terms of the License 
+"Eclipse Public License v1.0" which accompanies this distribution, 
+and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
+<!-- Initial Contributors:
+    Nokia Corporation - initial contribution.
+Contributors: 
+-->
+<!DOCTYPE concept
+  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
+<concept id="GUID-ED20B02A-C146-5E28-A102-D3AE11D9015F" xml:lang="en"><title>Building
+and Running the MiniGUI Tutorial</title><shortdesc>This topic describes how to build a MiniGUI ROM image and how to
+run the MiniGUI in the emulator. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p> <b>Variant</b>: ScreenPlay. <b>Target audience</b>: Device creators. </p>
+<p>This topic builds on the introduction in the <xref href="GUID-E09F74E2-B5A2-51F8-BD9E-882BE2661D5C.dita">MiniGUI
+Environment Overview</xref> and the ROM Tools Guide. </p>
+<section><title>Building a MiniGUI ROM image</title> <ol id="GUID-AAD227D8-8D67-5951-B359-715D4A0AD33B">
+<li id="GUID-9921FB78-9201-5337-95D4-CB62BEFA4C32"><p>Use a text editor to
+edit the Window Server configuration file, <filepath>\epoc32\data\z\wsini_minigui.ini</filepath>. </p> <p>Note:
+This file must be created or saved in Unicode instead of ASCII. </p> </li>
+<li id="GUID-43452758-28A2-5095-88FB-07C2964F49CB"><p>Add the following lines
+to the <filepath>wsini_minigui.ini</filepath> file to start ESHELL as the
+system shell in the specified screen mode. </p> <codeblock id="GUID-21B815C5-1BE1-5905-87C6-BA14DA659C8B" xml:space="preserve">STARTUP ESHELL
+SCREENMODE COLOR16MAP</codeblock> <p>Refer to <xref href="GUID-1D529BDC-6665-58E2-AB3F-7023D8A84F69.dita">The
+wsini.ini File Reference</xref> for more information about the parameters. </p> </li>
+<li id="GUID-CC5687DF-9863-51C6-B348-D10C10868DAD"><p>Make sure that the ROM
+image description file, <filepath>minigui.oby</filepath>, exists under <filepath>\epoc32\rom\include\</filepath>.
+This OBY file is the input file to the <filepath>BUILDROM</filepath> tool. </p> <p>This
+file contains a statement that refers to the <filepath>wsini_minigui.ini</filepath> file. </p> <codeblock id="GUID-82D32D6F-A2A2-56A0-8AF9-6C021CC3E321" xml:space="preserve">data=DATAZ_\wsini_minigui.ini    system\data\wsini.ini</codeblock> </li>
+<li id="GUID-C3015F0E-CDE7-5940-9088-9DBE34468277"><p>Build a MiniGUI ROM
+image from a command prompt. </p> <p>The following commands build a ROM image
+for H4: </p> <p>&gt; cd d:\Symbian\epoc32\rom </p> <p>&gt; buildrom -nosymbols h4hrp
+minigui </p> <p>The following commands build a ROM image for H6: </p> <p>&gt;
+cd d:\Symbian\epoc32\rom </p> <p>&gt; buildrom -nosymbols 34xx_sdp minigui </p> <p>Where <filepath>minigui</filepath> stands
+for the <filepath>minigui.oby</filepath> file. The <codeph>-nosymbols</codeph> directive
+means do not generate the symbol file which contains the ROM building information
+for debugging purpose. </p> </li>
+</ol> <p> <b>Result</b>: The MiniGUI ROM image is generated in the current
+directory: <filepath>d:\Symbian\epoc32\rom</filepath>. </p> </section>
+<section><title>Running the MiniGUI in the emulator</title> <ol id="GUID-DC6EB5D4-FDE5-5464-B2CE-0D272F4AAD61">
+<li id="GUID-B6913759-85BE-5480-B3A2-F0D52D7E40B7"><p>Make sure that ScreenPlay
+is enabled and add the following line to the <filepath>\epoc32\data\epoc.ini</filepath> file: </p> <codeblock id="GUID-EE4BD889-EB25-5259-9183-7F96BF419794" xml:space="preserve">minigui</codeblock> <p>For
+more information about enabling ScreenPlay, refer to <xref href="GUID-6D8A1FC7-095B-587E-8274-23C132978C53.dita">Enabling
+the Graphics Architecture Variants</xref>. </p> </li>
+<li id="GUID-B866EB6F-7817-55F1-9631-ED0B7122B048"><p>Add the following lines
+to the <filepath>\epoc32\release\winscw\udeb\z\system\data\wsini.ini</filepath> to
+start ESHELL as the system shell in the specified screen mode: </p> <codeblock id="GUID-7ECA751A-5C25-5774-ACBD-DA5D861C125D" xml:space="preserve">startup eshell
+screenmode color16map</codeblock> </li>
+</ol> <p>Launch the emulator to verify that MiniGUI configuration works. It
+boots into the black and white ESHELL. </p> </section>
+</conbody><related-links>
+<link href="GUID-6D8A1FC7-095B-587E-8274-23C132978C53.dita"><linktext>Enabling
+the Graphics Architecture  Variants</linktext></link>
+<link href="GUID-85E1E45B-DD05-5B7D-84E7-9911E0A3E3CC.dita"><linktext>The wsini.ini
+File</linktext></link>
 </related-links></concept>
\ No newline at end of file