[Esbox-commits] r1050 - branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted
jeffc at garage.maemo.org
jeffc at garage.maemo.org
Fri Dec 5 23:33:07 EET 2008
Author: jeffc
Date: 2008-12-05 23:33:07 +0200 (Fri, 05 Dec 2008)
New Revision: 1050
Modified:
branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/SettingPreferences.html
branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/virtualmachine.html
Log:
updated screenshots and added ESbox pref panels info
Modified: branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/SettingPreferences.html
===================================================================
--- branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/SettingPreferences.html 2008-12-05 21:31:03 UTC (rev 1049)
+++ branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/SettingPreferences.html 2008-12-05 21:33:07 UTC (rev 1050)
@@ -20,25 +20,36 @@
The first thing a user should do is set the preferences for using Scratchbox, since the rest
of the functionality of the plug-ins depends on these settings. Once the Eclipse IDE is
running with the plug-ins, the preferences may be set by selecting <strong>Window > Preferences...</strong> and expanding the ESbox and Maemo groups.</p>
-
-
-<p>
-The Maemo page allows you to define the command pattern for the launch shell and whether or not to log commands.</p>
-
+<p>The ESbox group contains preferences to select the build machine for ESbox, define options for Scratchbox1 and Scratchbox 2, and define settings for X Server.</p>
+<h2><a name="bldmachine"></a>Build Machines</h2>
+<p>The Build Machines page allows you to select a build machine for ESbox. If you select VMware Linux Build Machine or QEMU Linux Build Machine then additional tabs will appear for further setup. Additional information about build machines is provided in the topic <a href="virtualmachine.html">Running ESbox on other operating systems</a>.</p>
+<p> </p>
+<p><img src="../images/buildmachines.png" width="908" height="392"></p>
+<h2><a name="sbox1"></a>Scratchbox 1</h2>
+<p>Define your sandbox root directory and command template for Scratchbox 1. </p>
+<p><img src="../images/pref_images/sbox1.png" alt="sbox1" width="1342" height="392"></p>
+<p> </p>
+<h2><a name="sbox2"></a>Scratchbox 2</h2>
+<p>Define your mapping mode, level of messages that you want logged, and command template for Scratchbox 2.</p>
+<p><img src="../images/pref_images/sbox2.png" alt="sbox2" width="994" height="496"></p>
+<p> </p>
+<h2><a name="xsr"></a>X Server</h2>
+<p>The X Server page contains commands for starting the X Server.</p>
+<p><img src="../images/pref_images/xserver.png" alt="xserver" width="1031" height="367"></p>
+<p> </p>
+<p> </p>
+<p>The Maemo page allows you to define the command pattern for the launch shell and whether or not to log commands.</p>
<p></p>
-<img src="../images/pref_images/maemo_pref.png" alt="preferences1" width="896" height="402"><br>
+<img src="../images/pref_images/maemo_pref.png" alt="preferences1" width="903" height="351"><br>
<br>
-
-
-<p> </p>
<h2><a name="env"></a>Environment</h2>
<p>The <strong>Environment</strong> page allows you to define Scratchbox environment variables. Click the New button to specify the variable Name and Value. This dialog also specifies environment variable *changes* for any program invoked by ESbox. Variables may be replaced/added or undefined.</p>
-<p><img src="../images/pref_images/pref_maemo_env.png" alt="environment" width="802" height="404"></p>
+<p><img src="../images/pref_images/pref_maemo_env.png" alt="environment" width="903" height="371"></p>
<p> </p>
<h2><a name="int"></a>Installed Targets</h2>
<p>The Installed Targets page allows you to add or remove scratchbox targets. Click New to launch a wizard that guides you through the steps to add a target.</p>
<p><strong>CAUTION:</strong> If you select an existing target and click <strong>Remove</strong>, the complete installation of the SDK will be removed from your filesystem!</p>
-<p><img src="../images/pref_images/targets.png" alt="installed targets" width="811" height="416"></p>
+<p><img src="../images/pref_images/targets.png" alt="installed targets" width="765" height="377"></p>
<p> </p>
<blockquote>
<h3><a name="newtarget"></a>Creating a New Target</h3>
@@ -87,25 +98,10 @@
<p>Enter the hostname or ip address and click Finish.</p>
<p> </p>
</blockquote>
-<h2><a name="sbox1"></a>Scratchbox 1</h2>
-<p>Define your sandbox root directory and command template for Scratchbox 1. </p>
-<p><img src="../images/pref_images/sbox1.png" alt="sbox1" width="1014" height="402"></p>
-<p> </p>
-<h2><a name="sbox2"></a>Scratchbox 2</h2>
-<p>Define your mapping mode, level of messages that you want logged, and command template for Scratchbox 2.</p>
-<p><img src="../images/pref_images/sbox2.png" alt="sbox2" width="990" height="499"></p>
-<p> </p>
<h2><a name="ssh"></a>SSH</h2>
<p>Use the SSH page to configure secure shell settings for communicating with a device.</p>
-<p><img src="../images/pref_images/ssh.png" alt="ssh" width="868" height="414"></p>
+<p><img src="../images/pref_images/ssh.png" alt="ssh" width="908" height="392"></p>
<p> </p>
-<p>The ESbox group contains preferences to select the build machine for ESbox and define settings for X Server.</p>
-<h2><a name="bldmachine"></a>Build Machines</h2>
-<p>The Build Machines page allows you to select a build machine for ESbox. If you select VMware Linux Build Machine or QEMU Linux Build Machine then additional tabs will appear for further setup. Additional information about build machines is provided in the topic <a href="virtualmachine.html">Running ESbox on other operating systems</a>.</p>
<p> </p>
-<p><img src="../images/buildmachines.png" width="843" height="385"></p>
-<h2><a name="xsr"></a>X Server</h2>
-<p>The X Server page contains commands for starting the X Server.</p>
-<p><img src="../images/pref_images/xserver.png" alt="xserver" width="1037" height="389"></p>
</body>
</html>
Modified: branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/virtualmachine.html
===================================================================
--- branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/virtualmachine.html 2008-12-05 21:31:03 UTC (rev 1049)
+++ branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/virtualmachine.html 2008-12-05 21:33:07 UTC (rev 1050)
@@ -15,7 +15,7 @@
<P>The maemo SDK, scratchbox, and rootstraps only work on Linux/x86. If you want to use ESbox in Windows, or Linux/x86-64, then you can do this by hooking up ESbox with an appropriately configured virtual machine.</P>
<P>ESbox exposes the concept of "Build Machines". For Linux/x86 hosts, the host serves as a build machine. For other hosts, only a virtual machine can be a build machine. You can select the build machine for ESbox by selecting <strong>Window > Preferences > ESbox > Build Machines</strong>.</P>
<P> </P>
-<P><img src="../images/buildmachines.png" width="843" height="385"></P>
+<P><img src="../images/buildmachines.png" width="908" height="392"></P>
<P>ESbox will use an SSH connection with the virtual machine to perform builds, launch/debug applications, and configure sb1/sb2 rootstraps.</P>
<P>Projects in Eclipse must be visible to both the host and the virtual machine (VM). This requires some folders to be shared between them.</P>
<h3>Virtual machine configuration </h3>
@@ -35,7 +35,7 @@
<UL>
<LI>An X server is needed to launch the Maemo emulator. The default settings assume you've installed Cygwin/X, with Cygwin at c:\cygwin. Edit <strong>Window > Preferences > ESbox > X Server</strong> preferences to configure.</LI>
</UL>
-<p><img src="../images/xserver.png" width="1099" height="448"></p>
+<p><img src="../images/xserver.png" width="1031" height="367"></p>
<h3>ESbox (virtual) machine configuration </h3>
<UL>
<LI>Configuration is under ESbox > Build Machines. If you navigate here before configuring anything, or try to create a project and launch first, you need to select either VMware or QEMU as a virtual machine and adjust the configuration accordingly.</LI>
@@ -44,13 +44,13 @@
<UL>
<LI>Use the "Apply and Validate" button to run through a series of tests to validate that the machine is configured properly.</LI>
</UL>
-<p><img src="../images/buildmachine_qemu.png" width="1425" height="538"></p>
+<p><img src="../images/buildmachine_qemu.png" width="1324" height="485"></p>
<p> </p>
<h3>ESbox Machine Access </h3>
<P>The Machine Access tab allows you to configure the networking and authentication with the VM.</P>
-<p><img src="../images/buildmachine_qemu_machine.png" width="962" height="538"></p>
+<p><img src="../images/buildmachine_qemu_machine.png" width="824" height="491"></p>
<P> </P>
<P><strong>User</strong> is the account which acts as the agent for all operations with the VM. This must have passwordless "sudo" access. </P>
<P><strong>Password</strong> is the account for the user account. <STRONG>NOTE</STRONG>: the password is saved in preferences but in an encrypted form, but, due to current design quirks, this password can still show up in <EM>plaintext</EM> in SSH filesystem URIs. </P>
@@ -63,7 +63,7 @@
<P>Additionally, the project must be visible to scratchbox. Sbox 1 has some restrictions here, but sbox 2 is looser. A convenient solution is to make the shared folder visible twice, once in a normal location under the user's home folder, and again in the parallel location visible to sbox 1. (The user's home should be shared identically amongst any sbox 1 target to maximize the benefit, else you need to share yet again for every rootstrap.) </P>
<P>Thus, the Shared Folders portion of the VM configuration page will let ESbox know how to map paths. Each mapping is considered in order, so list sbox 1 mappings at the end. </P>
<P>ESbox has some support for automatically mounting shares into the VM, since this is a commonly needed task when the VM is started and stopped. Note, however, ESbox will not configure shares for you or validate whether your settings make any sense -- the provided share must be manually configured.</P>
-<p><img src="../images/buildmachine_qemu_shfold.png" width="871" height="538"></p>
+<p><img src="../images/buildmachine_qemu_shfold.png" width="824" height="491"></p>
<P> </P>
<P><strong>Host</strong> tells the place where a share will be seen on the Eclipse host. </P>
<P><strong>Target</strong> tells the place where a share will be seen on the VM. </P>
More information about the Esbox-commits
mailing list