[Esbox-commits] r410 - in trunk/org.indt.esbox.help/html: gettingstarted tasks
raul at garage.maemo.org
raul at garage.maemo.org
Fri Feb 15 13:54:00 EET 2008
Author: raul
Date: 2008-02-15 13:53:51 +0200 (Fri, 15 Feb 2008)
New Revision: 410
Modified:
trunk/org.indt.esbox.help/html/gettingstarted/CompilingCMaemoProject.html
trunk/org.indt.esbox.help/html/gettingstarted/ProfilingMaemoApplications.html
trunk/org.indt.esbox.help/html/gettingstarted/RunningPythonProject.html
trunk/org.indt.esbox.help/html/tasks/CreateMakeTarget.html
trunk/org.indt.esbox.help/html/tasks/CreateNewTarget.html
trunk/org.indt.esbox.help/html/tasks/DebianPackage.html
trunk/org.indt.esbox.help/html/tasks/RunningDebugging.html
trunk/org.indt.esbox.help/html/tasks/SettingPreferences.html
trunk/org.indt.esbox.help/html/tasks/SettingsSbrshConfiguration.html
Log:
final fixies.
Modified: trunk/org.indt.esbox.help/html/gettingstarted/CompilingCMaemoProject.html
===================================================================
--- trunk/org.indt.esbox.help/html/gettingstarted/CompilingCMaemoProject.html 2008-02-15 01:22:41 UTC (rev 409)
+++ trunk/org.indt.esbox.help/html/gettingstarted/CompilingCMaemoProject.html 2008-02-15 11:53:51 UTC (rev 410)
@@ -1,41 +1,83 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-
<html>
<head>
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
- <title>Compiling a C/C++ Maemo Project</title>
- <style type="text/css">
+
+
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+
+
+ <title>Compiling a C/C++ Maemo Project</title>
+ <style type="text/css">
<!--
.style1 {font-family: Arial, Helvetica, sans-serif}
-->
</style>
</head>
+
+
<body>
+
<h2 class="style1">Compiling a C/C++ Maemo Project</h2>
+
<p>When is created a Automake C/C++ Maemo Project, it is automatically compiled.</p>
+
<p>If you have created a Makefile C/C++ Maemo Project, you need to provide a makefile.</p>
+
<p>When you build a project, output from make is displayed in the Console view.
Makefile actions are displayed in the Make Targets view.</p>
-To know more about setting create make target <a href="../tasks/CreateMakeTarget.html">click here</a>.</STRONG></p>
+To know more about setting create make target <a href="../tasks/CreateMakeTarget.html">click here</a>.
+<p></p>
+
+
<p>To build your C/C++ Maemo Project, do:</p>
+
<ul>
- <p><li><div align="justify">In the C/C++ Maemo Projects view, select a project.</div></li></p>
- <p><li><div align="justify">Right click on a project and you can see Build Application.</div></li></p>
- <p><li><div align="justify">Can generate a configure, run your configure (./configure) or build your project.</div></li></p>
- <p></p><img src="../images/build.jpg" alt="build"></li>
- <p><li><div align="justify">The picture below shows when Build all is clicked. The Console view displays the output of the make utility.</div></li></p>
- <p></p><img src="../images/build1.jpg" alt="build1"></li>
+
+
+ <p></p>
+ <li>
+ <div align="justify">In the C/C++ Maemo Projects view, select a project.</div>
+ </li>
+
+
+ <p></p>
+ <li>
+ <div align="justify">Right click on a project and you can see Build Application.</div>
+ </li>
+
+
+ <p></p>
+ <li>
+ <div align="justify">Can generate a configure, run your configure (./configure) or build your project.</div>
+ </li>
+
+
+ <p></p>
+ <img src="../images/build.jpg" alt="build">
+
+ <p></p>
+ <li>
+ <div align="justify">The picture below shows when Build all is clicked. The Console view displays the output of the make utility.</div>
+ </li>
+
+
+ <p></p>
+ <img src="../images/build1.jpg" alt="build1">
</ul>
-<p>Go to <a href="../tasks/RunningDebugging.html"><STRONG>Running and Debugging</STRONG></a></p>
+
+<p></p>
+<p>Go to <a href="../tasks/RunningDebugging.html"><strong>Running and Debugging</strong></a></p>
+
</body>
-</html>
\ No newline at end of file
+</html>
Modified: trunk/org.indt.esbox.help/html/gettingstarted/ProfilingMaemoApplications.html
===================================================================
--- trunk/org.indt.esbox.help/html/gettingstarted/ProfilingMaemoApplications.html 2008-02-15 01:22:41 UTC (rev 409)
+++ trunk/org.indt.esbox.help/html/gettingstarted/ProfilingMaemoApplications.html 2008-02-15 11:53:51 UTC (rev 410)
@@ -2,11 +2,21 @@
<html>
<head>
+
+
+
+
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+
+
+
+
+
<title>Easing the extraction of strings</title>
<style type="text/css">
<!--
@@ -16,39 +26,152 @@
</head>
-
<body>
+
+
<h2 class="style1">Profiling Maemo Applications</h2>
+
+
<p><span style="font-weight: bold;"></span>Profiling is one of the most
important techniques available for programmers to understand which are
-the problems of its applications. By simply profiling an application, it becomes
-immediately apparent where the overwhelming memory and CPU burdens are, and allows you to quickly squash them. ESbox provides support for <a href="http://www.valgrind.org/">Valgrind</a> memory profiler and <a href="http://oprofile.sourceforge.net/news/">OProfile</a> system-wide profiler for both C/C++ and Python Projects.
+the problems of its applications. By simply profiling an application,
+it becomes immediately apparent where the overwhelming memory and CPU
+burdens are, and allows you to quickly squash them. ESbox provides
+support for <a href="http://www.valgrind.org/">Valgrind</a> memory profiler and <a href="http://oprofile.sourceforge.net/news/">OProfile</a> system-wide profiler for both C/C++ and Python Projects.
</p>
+
+
<span style="font-weight: bold;">Using Valgrind<br>
+
+
<br>
+
+
</span>Valgrind is a framework to build dynamic analyses tools. You can
use Valgrind to profile your applications: it detects memory management
(memory leak, use of uninitialised memory, etc.) and thread bugs.
However, Valgrind is only supported on X86/Linux, AMD64/Linux,
PPC32/Linux and PPC64/Linux. In order to run Valgrind, you have to
select an X86 Scratchbox target wich the tool properly installed.<br>
+
+
<br>
+
+To run Valgrind, rigth-click on the application (binary for C/C++
+projects or the Python script for Python projects) and select Run As
+-> Valgrind Memory Profiler.<br>
+
<br>
+
+<br>
+
+<br>
+
+<img style="height: 724px; width: 1280px;" alt="" src="../images/profiling0.jpg"><br>
+
+
+<br>
+
+<br>
+
+<br>
+
+<br>
+
+The Valgrind tool runs your application on X86 target and the result is
+shown on Valgrind view. All problems found by Valgrind are shown as a
+tree: problem as parent nodes and details of the problems as children
+nodes.<br>
+
+<br>
+
+<br>
+
+<br>
+
+<img style="width: 1025px; height: 353px;" alt="" src="../images/profiling1.jpg"><br>
+
+
<span style="font-weight: bold;"><br>
+
+<br>
+
+<br>
+
Using OProfile<br>
+
+
<br>
+
+
</span>OProfile is a system-wide profiler for Linux systems and
can profile all running code.
It consists of a kernel driver and a daemon for collecting sample data,
and several
-post-profiling tools for turning data into information. Valgrind is
+post-profiling tools for turning data into information. OProfile is
supported for ARM/Linux. It's executed on Internet Tablet in order to
-obtain hight quality of profiling information.
+obtain hight quality of profiling information. ESbox uses sbrsh to
+remotely execute OProfile and colect profiling information. So, it's
+necessary to properly install the application (for more information
+read <a href="../tasks/SettingsSbrshConfiguration.html">this tutorial</a>).<br>
+
+<br>
+
+To run OProfile, rigth-click on the application (binary for C/C++
+projects or the Python script for Python projects) and select Run As
+-> Valgrind Memory Profiler.<br>
+
+<br>
+
+<br>
+
+<br>
+
+<img style="width: 1043px; height: 789px;" alt="" src="../images/profiling6.jpg"><br>
+
+<br>
+
+<br>
+
+<br>
+
+Then, a password prompt appears asking for your desktop superuser
+password. Such password is necessary because some commands executed by
+OProfile requires superuser privileges. But don't worry: such password
+is not saved and is "forgotten" as soon as possible.<br>
+
+<br>
+
+<br>
+
+<br>
+
+<img style="width: 535px; height: 232px;" alt="" src="../images/profiling3.jpg"><br>
+
+<br>
+
+<br>
+
+<br>
+
+Finally, OProfiles starts. ESbox also runs your application on device
+in order to collect profiling informations. Then OProfile stops and the
+result of profiling is shown on OProfile View. <br>
+
+<br>
+
+<br>
+
+<br>
+
+<img style="width: 1280px; height: 978px;" alt="" src="../images/profiling4.jpg"><br>
+
+
</body>
</html>
Modified: trunk/org.indt.esbox.help/html/gettingstarted/RunningPythonProject.html
===================================================================
--- trunk/org.indt.esbox.help/html/gettingstarted/RunningPythonProject.html 2008-02-15 01:22:41 UTC (rev 409)
+++ trunk/org.indt.esbox.help/html/gettingstarted/RunningPythonProject.html 2008-02-15 11:53:51 UTC (rev 410)
@@ -1,30 +1,63 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-
<html>
<head>
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
- <title>Running Python Maemo Project</title>
- <style type="text/css">
+
+
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+
+
+ <title>Running Python Maemo Project</title>
+ <style type="text/css">
<!--
.style1 {font-family: Arial, Helvetica, sans-serif}
-->
</style>
</head>
+
+
<body>
+
<h2 class="style1">Running Python Maemo Project</h2>
+
<p>Then, to run the file you can:</p>
+
<ol>
- <p><li>Click on X button to start the X server and viewer.</p></li>
- <p><li>Click on Maemo button.</p></li>
- <p><li><div align="justify">In the Pydev Projects view, select a project.</div></li></p>
- <p><li><div align="justify">Click Run As -> Python Maemo Local Application.</div></li></p>
- <p></p><img src="../images/python3.jpg" alt="python3"></li>
+
+
+ <p></p>
+ <li>Click on X button to start the X server and viewer.</li>
+
+
+ <p></p>
+ <li>Click on Maemo button.</li>
+
+
+ <p></p>
+ <li>
+ <div align="justify">In the Pydev Projects view, select a project.</div>
+ </li>
+
+
+ <p></p>
+ <li>
+ <div align="justify">Click Run As -> Python Maemo Local Application.</div>
+ </li>
+ <p></p>
+
+
+ <p></p>
+ <img src="../images/python3.jpg" alt="python3">
</ol>
-<p>NOTE: You can only run files that are in your project.</p>
-<p>After the first run, if you type Ctrl+F11, the last file ran is re-run.</p>
+<p><span style="font-weight: bold;"></span></p>
+<p><span style="font-weight: bold;">NOTE</span>: You can only run files that are in your project.</p>
+
+<p>After the first run, if you type Ctrl+F11, the last file ran is re-run.</p>
+
+
</body>
-</html>
\ No newline at end of file
+</html>
Modified: trunk/org.indt.esbox.help/html/tasks/CreateMakeTarget.html
===================================================================
--- trunk/org.indt.esbox.help/html/tasks/CreateMakeTarget.html 2008-02-15 01:22:41 UTC (rev 409)
+++ trunk/org.indt.esbox.help/html/tasks/CreateMakeTarget.html 2008-02-15 11:53:51 UTC (rev 410)
@@ -1,29 +1,50 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-
<html>
<head>
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
- <title>Create Make Target</title>
- <style type="text/css">
+
+
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+
+
+ <title>Create Make Target</title>
+ <style type="text/css">
<!--
.style1 {font-family: Arial, Helvetica, sans-serif}
-->
</style>
</head>
+
+
<body>
+
<h2 class="style1">Create Make Target</h2>
+
<p>To create a make target:</p>
-<ol>
- <p><li>Go to Make Targets view.</li></p>
- <p><li>Right click on a project and select <b>Add Make Target</b>.</li></p>
- <p><img src="../images/maketarget.jpg" alt="maketarget"></li></p>
- <p><li>Enter the Target name and build options and click Create.</li></p>
- <p><img src="../images/maketarget1.jpg" alt="maketarget1"></li></p>
+
+<ol>
+ <li>Go to Make Targets view.</li>
+ <p></p>
+ <li>Right click on a project and select <b>Add Make Target</b>.</li>
+ <p></p>
+
+
+ <p><img src="../images/maketarget.jpg" alt="maketarget"></p>
+
+ <p></p>
+ <li>Enter the Target name and build options and click Create.</li>
+ <p></p>
+
+
+ <p><img src="../images/maketarget1.jpg" alt="maketarget1"></p>
+
+
</ol>
+
</body>
-</html>
\ No newline at end of file
+</html>
Modified: trunk/org.indt.esbox.help/html/tasks/CreateNewTarget.html
===================================================================
--- trunk/org.indt.esbox.help/html/tasks/CreateNewTarget.html 2008-02-15 01:22:41 UTC (rev 409)
+++ trunk/org.indt.esbox.help/html/tasks/CreateNewTarget.html 2008-02-15 11:53:51 UTC (rev 410)
@@ -1,18 +1,26 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-
<html>
<head>
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
- <title>Create New Target</title>
- <style type="text/css">
+
+
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+
+
+ <title>Create New Target</title>
+ <style type="text/css">
<!--
.style1 {font-family: Arial, Helvetica, sans-serif}
-->
</style>
</head>
+
+
<body>
-<h2 align="left" class="style1">Create new Target</h2>
+
+<h2 class="style1" align="left">Create new Target</h2>
+
<p>Scratchbox defines different environments by creating and using TARGETS.
The user defines which compiler, devkits, etc. will be part of the environment.
The process of creating a new target is performed at Scratchbox with the aid of
@@ -22,42 +30,127 @@
Each target is a separate environment that has a selected toolchain, target
CPU and an own file system and can use only one in each maemo project.</p>
+
<p align="left">You can create a new Target following these steps:</p>
- <ol>
- <p><li><div align="justify">First click on Properties.</div></li></p>
- <p></p><img src="../images/target.jpg" alt="target"></li>
+
+
+<ol>
+
- <p><li><div align="justify">Then, click on New to show a wizard to help
- the programmer to create new target.</div></li></p>
- <p></p><img src="../images/target0.1.jpg" alt="target0.1"></li>
+ <p></p>
+ <li>
+ <div align="justify">First click on Properties.</div>
+ </li>
+
+
+ <p></p>
+ <img src="../images/target.jpg" alt="target">
- <p><li><div align="justify">First, you need to specify a name of new target.</div></li></p>
- <p></p><img src="../images/target0.jpg" alt="target0"></li>
+
+ <p></p>
+ <li>
+ <div align="justify">Then, click on New to show a wizard to help
+ the programmer to create new target.</div>
+ </li>
+
+
+ <p></p>
+ <img src="../images/target0.1.jpg" alt="target0.1">
+
- <p><li><div align="justify">Next wizard will ask which toolchain should be used to compile programs.</div></li></p>
- <p></p><img src="../images/target1.jpg" alt="target1"></li>
+ <p></p>
+ <li>
+ <div align="justify">First, you need to specify a name of new target.</div>
+ </li>
+
+
+ <p></p>
+ <img src="../images/target0.jpg" alt="target0">
- <p><li><div align="justify">We can select optional development tools.</div></li></p>
- <p></p><img src="../images/target2.jpg" alt="target2"></li>
- <p><li><div align="justify">After development kit selection the CPU-transparency method is chosen.</div></li></p>
- <p></p><img src="../images/target3.jpg" alt="target3"></li>
+ <p></p>
+ <li>
+ <div align="justify">Next wizard will ask which toolchain should be used to compile programs.</div>
+ </li>
+
- <p><li><div align="justify">If you choose SBRSH as CPU-transparency will become available a wizard to configure it.</div></li></p>
- <p></p><img src="../images/target4.jpg" alt="target4"></li>
+ <p></p>
+ <img src="../images/target1.jpg" alt="target1">
+
+
+ <p></p>
+ <li>
+ <div align="justify">We can select optional development tools.</div>
+ </li>
+
+
+ <p></p>
+ <img src="../images/target2.jpg" alt="target2">
+
+
+ <p></p>
+ <li>
+ <div align="justify">After development kit selection the CPU-transparency method is chosen.</div>
+ </li>
+
+
+ <p></p>
+ <img src="../images/target3.jpg" alt="target3">
+
+
+ <p></p>
+ <li>
+ <div align="justify">If you choose SBRSH as CPU-transparency will become available a wizard to configure it.</div>
+ </li>
+
+
+ <p></p>
+ <img src="../images/target4.jpg" alt="target4">
- <p><li><div align="justify">First you need to specify the hostname or IP-address of the target device.</div></li></p>
- <p></p><img src="../images/target5.jpg" alt="target5"></li>
- <p><li><div align="justify">The next dialog shows the default hostname of your host. It is used to mount the NFS filesystems on the target device, so you may need to change it to an address that is known to the device.</div></li></p>
- <p></p><img src="../images/target6.jpg" alt="target6"></li>
+ <p></p>
+ <li>
+ <div align="justify">First you need to specify the hostname or IP-address of the target device.</div>
+ </li>
+
+
+ <p></p>
+ <img src="../images/target5.jpg" alt="target5">
- <p><li><div align="justify">Now you have the possibility to add yourself to sbrshd's access list if you have root access.</div></li></p>
- <p></p><img src="../images/target7.jpg" alt="target7"></li>
+
+ <p></p>
+ <li>
+ <div align="justify">The next dialog shows the default hostname of
+your host. It is used to mount the NFS filesystems on the target
+device, so you may need to change it to an address that is known to the
+device.</div>
+ </li>
+
- <p><li><div align="justify">Everything is now ready and you can activate the target.</div></li></p>
- </ol>
+ <p></p>
+ <img src="../images/target6.jpg" alt="target6">
+
+
+ <p></p>
+ <li>
+ <div align="justify">Now you have the possibility to add yourself to sbrshd's access list if you have root access.</div>
+ </li>
+
+ <p></p>
+ <img src="../images/target7.jpg" alt="target7">
+
+
+ <p></p>
+ <li>
+ <div align="justify">Everything is now ready and you can activate the target.</div>
+ </li>
+ <p></p>
+
+
+</ol>
+
+
</body>
-</html>
\ No newline at end of file
+</html>
Modified: trunk/org.indt.esbox.help/html/tasks/DebianPackage.html
===================================================================
--- trunk/org.indt.esbox.help/html/tasks/DebianPackage.html 2008-02-15 01:22:41 UTC (rev 409)
+++ trunk/org.indt.esbox.help/html/tasks/DebianPackage.html 2008-02-15 11:53:51 UTC (rev 410)
@@ -1,67 +1,106 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-
<html>
<head>
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
- <title>Debian Package</title>
- <style type="text/css">
+
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+ <title>Debian Package</title>
+
+
+ <style type="text/css">
<!--
.style1 {font-family: Arial, Helvetica, sans-serif}
-->
- </style>
+ </style>
</head>
+
<body>
+
<h2 class="style1">Debian Package</h2>
+<br>
+Debian package is one of the most elegant, easy and common method used
+to deploy software (specially Debian distribution). ESbox provides
+features to easly generate, deploy and install .deb package from you
+application (C/C++ or Python) on Internet Tablet. ESbox uses sbrsh to
+deploy and install you .deb package on Internet Tablet. So, it's
+necessary to properly configure sbrsh (for more information read <a href="SettingsSbrshConfiguration.html">this tutorial</a>).<br>
+
<h4 class="style1">Create Debian Package</h4>
+
<p>
-User can create Debian packages for Internet Tablet Application Manager. This function provides an
+User can create Debian packages for Internet Tablet Application
+Manager. This function provides an
easy way to import user made applications to Internet Tablet.
-
To execute Create Debian Package:
+</p>
<ol>
- <li><p>Go to Debian Package on popup menu.</p></li>
-
- <li><p>
- Click in Create Debian Package.
- <p></p><img src="../images/debian.jpg" alt="debian1"></li>
- </li></p>
+
+ <li>
+ <p>Go to Debian Package on popup menu.</p>
+
+ </li>
+
+ <li>
+ <p> Click on Create Debian Package.</p>
+
+ </li>
+
</ol>
+<br>
+<span style="font-weight: bold;">NOTE</span>: you have to create a debian path on your project and also all necessary files to create the package.<br>
+<p></p>
+
+<img src="../images/debian.jpg" alt="debian1">
+<h4 class="style1"><br>
+</h4>
+<h4 class="style1">Deploy and Install Debian Package</h4>
+
+<p>ESbox allows to deploy and install the .deb package generated. In order to install your application on Internet Tablet:
</p>
-<h4 class="style1">Deploy Debian Package</h4>
-<p>
-Runs deploy deb command and tries to create an installable Debian
-package according to the rules on /debian folder.
+<ol>
-To execute Deploy Debian Package:
+ <li>
+ <p>Go to Debian Package on popup menu.</p>
-<ol>
- <li><p>Go to Debian Package on popup menu.</p></li>
-
- <li><p>
- Click in Deploy Debian Package.
- <p></p><img src="../images/debian.jpg" alt="debian2"></li>
- </li></p>
-
- <li><p>
- This item opens dialog with name of the project and remote location. You can choose
- Create debian Package or Install package on device.
- <p></p><img src="../images/debian1.jpg" alt="debian3"></li>
- </li></p>
-
- <li><p>
- Click on <b>Browser</b> and select package of your choice.
- </li></p>
-
- <li><p>
- Click <b>Ok</b>.
- </li></p>
+ </li>
+
+ <li>
+
+ <p> Click on Install Debian Package on Device.</p>
+ </li>
+
+
+ <li>
+ <p> This item opens dialog with name of the project and
+remote location (local and remote mount points already defined on sbrsh settings). </p>
+
+ <p></p>
+
+ <img src="../images/debian1.jpg" alt="debian3"></li>
+
+ <p></p>
+
+ <li>
+ <p> Click on <b>Browser</b> and select package
+of your choice. </p>
+
+ </li>
+
+ <li>
+ <p> Click <b>Ok</b>.</p>
+ </li>
+ <li>
+Then, a password prompt appears asking for your desktop superuser
+password. Such password is necessary to install .deb package on your Internet Tablet. But don't worry: such password
+is not saved and is "forgotten" as soon as possible.</li>
+
</ol>
-</p>
+<p><img style="width: 535px; height: 232px;" alt="" src="../images/profiling3.jpg"></p>
+
</body>
-</html>
\ No newline at end of file
+</html>
Modified: trunk/org.indt.esbox.help/html/tasks/RunningDebugging.html
===================================================================
--- trunk/org.indt.esbox.help/html/tasks/RunningDebugging.html 2008-02-15 01:22:41 UTC (rev 409)
+++ trunk/org.indt.esbox.help/html/tasks/RunningDebugging.html 2008-02-15 11:53:51 UTC (rev 410)
@@ -1,81 +1,198 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-
<html>
<head>
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
- <title>Running And Debugging</title>
- <style type="text/css">
+
+
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+
+
+ <title>Running And Debugging</title>
+ <style type="text/css">
<!--
.style1 {font-family: Arial, Helvetica, sans-serif}
-->
</style>
</head>
+
+
<body>
+
<h2 class="style1">Running And Debugging</h2>
+
<p>You may launch your programs from the workbench. The programs may be launched in either run or debug mode.
- <ul>
+ </p>
+<ul>
+
<li>In run mode, the program executes, but the execution may not be suspended or examined.</li>
- <li>In debug mode, execution may be suspended and resumed, variables may be inspected, and expressions may be evaluated.</li>
- </p></ul>
+
+ <li>In debug mode, execution may be suspended and resumed, variables may be inspected, and expressions may be evaluated.</li>
+
+
+ <p></p>
+</ul>
+
<p>To create a run or debug configuration:</p>
- <ol>
+
+
+<ol>
+
<li>
- <div align="justify">In the C/C++ Maemo Projects view, select a project.</div></li>
- <p><li><div align="justify">Click Run As -> Open Run Dialog or Debug As -> Open Debug Dialog.</div></li></p>
- <p><li><div align="justify">In the Configurations box, expand Maemo Application.</div></li></p>
- <p><li><div align="justify">Click New. The name of the new project is displayed in the Configurations box. The default name is the name of the project.</div></li></p>
- <p><li><div align="justify">Click the Main tab.</div></li></p>
- <p><li><div align="justify">Do the following:
+
+ <div align="justify">In the C/C++ Maemo Projects view, select a project.</div>
+ </li>
+
+
+ <p></p>
+ <li>
+ <div align="justify">Click Run As -> Open Run Dialog or Debug As -> Open Debug Dialog.</div>
+ </li>
-<ul>
- <li>In the Name box, type a descriptive name for this new a descriptive name for this launch configuration.</li>
- <li>In the Project box, type the name of the project containing the application that you want to run.</li>
- <li>In the C/C++ Application box, type the name of the executable that you want to run.</li>
- </div></li></p>
-</ul></p></ol>
+
+ <p></p>
+ <li>
+ <div align="justify">In the Configurations box, expand Maemo Application.</div>
+ </li>
- <p></p>
+
+ <p></p>
+ <li>
+ <div align="justify">Click New. The name of the new project is displayed in the Configurations box. The default name is the name of the project.</div>
+ </li>
+
+
+ <p></p>
+ <li>
+ <div align="justify">Click the Main tab.</div>
+ </li>
+
+
+ <p></p>
+ <li>
+ <div align="justify">Do the following:
+
+ <ul>
+
+ <li>In the Name box, type a descriptive name for this new a descriptive name for this launch configuration.</li>
+
+ <li>In the Project box, type the name of the project containing the application that you want to run.</li>
+
+ <li>In the C/C++ Application box, type the name of the executable that you want to run.</li>
+
+
+ </ul>
+ </div>
+ </li>
+ <p></p>
+
+</ol>
+
+
- <p>In the scratchbox environment the DISPLAY variable has to be set so
+
+
+<p>In the scratchbox environment the DISPLAY variable has to be set so
that it matches to the display setting given above for the Xephyr
server (parameter :2 in the above example).
- <ol start="7">
+ </p>
+<ol start="7">
+
- <p><li>Select: Window -> Preferences... </p></li>
- <p><li>Expand Scratchbox.</p></li>
- <p><li>Click on Environment.</p></li>
- <p><li>Click on <strong>new</strong> to create a variable.</p></li>
- <p><li>Will appear a wizard, type <strong>DISPLAY</strong> on name field and on value field type <strong>:2</strong>.</p></li>
- <p><li>Click ok. </p></li>
- <p></p><img src="../images/run.jpg" alt="run1"></li>
- <p><STRONG>To know more about setting preferences <a href="SettingPreferences.html">click here</a>.</STRONG></p>
- </ol></p>
+
+ <p></p>
+ <li>Select: Window -> Preferences...</li>
+
+
+ <p></p>
+ <li>Expand Scratchbox.</li>
+
+
+ <p></p>
+ <li>Click on Environment.</li>
+
+
+ <p></p>
+ <li>Click on <strong>new</strong> to create a variable.</li>
+
+
+ <p></p>
+ <li>Will appear a wizard, type <strong>DISPLAY</strong> on name field and on value field type <strong>:2</strong>.</li>
+
+
+ <p></p>
+ <li>Click ok.</li>
+
+
+ <p></p>
+ <img src="../images/run.jpg" alt="run1">
+
+ <p><strong>To know more about setting preferences <a href="SettingPreferences.html">click here</a>.</strong></p>
+
- <p>Make sure that the right target has being choosen.
- <ol start="13">
- <p><li> Select: Properties -> ESbox -> Target. </p></li>
- <p></p><img src="../images/target0.1.jpg" alt="target"></li>
- <p><STRONG>To know more about targets <a href="CreateNewTarget.html">click here</a>.</STRONG></p>
- </ol>
+</ol>
+<p></p>
+
+
+
+<p>Make sure that the right target has being choosen.
+ </p>
+<ol start="13">
+
+
+ <p></p>
+ <li> Select: Properties -> ESbox -> Target.</li>
+
+
+ <p></p>
+ <img src="../images/target0.1.jpg" alt="target">
- <ol start="14">
- <p><li>
- Click on X button to start the X server and viewer.
- </p></li>
- <p><li>
+ <p><strong>To know more about targets <a href="CreateNewTarget.html">click here</a>.</strong></p>
+
+
+</ol>
+
+
+
+<ol start="14">
+
+
+ <p></p>
+ <li>
+ Click on X button to start the X server and viewer.</li>
+
+
+ <p></p>
+ <li>
Click on Maemo button.
- </p></li>
- </ol>
- <p>Now with all set up, click on Run as -> Maemo Local Application. </p>
- <p></p><img src="../images/run1.jpg" alt="run2"></li>
- <p>
- Or, for debug, click on Debug as -> Maemo Local Application.</p>
- <p></p><img src="../images/run2.jpg" alt="run3"></li>
- </p>
- </p>
+
+ <p></p>
+ </li>
+
+
+</ol>
+
+
+<p>Now with all set up, click on Run as -> Maemo Local Application. </p>
+
+
+<p></p>
+<img src="../images/run1.jpg" alt="run2">
+
+<p>
+ Or, for debug, click on Debug as -> Maemo Local Application.</p>
+
+
+<p></p>
+<img src="../images/run2.jpg" alt="run3">
+
+<p></p>
+
+
+<p></p>
+
</body>
-</html>
\ No newline at end of file
+</html>
Modified: trunk/org.indt.esbox.help/html/tasks/SettingPreferences.html
===================================================================
--- trunk/org.indt.esbox.help/html/tasks/SettingPreferences.html 2008-02-15 01:22:41 UTC (rev 409)
+++ trunk/org.indt.esbox.help/html/tasks/SettingPreferences.html 2008-02-15 11:53:51 UTC (rev 410)
@@ -1,49 +1,72 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-
<html>
<head>
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
- <title>Setting preferences</title>
- <style type="text/css">
+
+
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+
+
+ <title>Setting preferences</title>
+ <style type="text/css">
<!--
.style1 {font-family: Arial, Helvetica, sans-serif}
-->
</style>
</head>
+
+
<body>
+
<h2 class="style1">Setting preferences</h2>
+
<p>
The first thing a user should do is to 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 via the Window -> Preferences menu,
+running with the plug-ins, the preferences may be set via the Window -> Preferences menu,
under which there is a list with the option Scratchbox.
</p>
+
<p>
The Scratchbox page offers the user a way to define the syntax used to invoke
commands inside Scratchbox (this varies between Scratchbox versions) and the root directory of
the user's sandbox environment.</p>
-<p></p><img src="../images/preferences.jpg" alt="preferences1"></li>
+<p></p>
+<img src="../images/preferences.jpg" alt="preferences1"><br>
+<br>
+
+
<p>
The Gazpacho sub page gets its name from common user interface editor Gazpacho. Gazpacho
is advanced editor, and for what is important it allows own implementation to code without
using Gazpacho. Use x-host command starting Gazpacho in Maemo runs the command in
the Xhost input box.</p>
-<p></p><img src="../images/preferences1.jpg" alt="preferences2"></li>
+<p></p>
+<img src="../images/preferences1.jpg" alt="preferences2">
+
+<p></p>
+<p></p>
<p>
In Environment sub page offers the user a way to adjust a set of environment variables.
The user can create a new variable clicking on <b>New</b> or modified existing ones, clicking
on <b>Select</b>. </p>
-<p></p><img src="../images/run.jpg" alt="run"></li>
+<p></p>
+<img src="../images/run.jpg" alt="run"><br>
+<br>
+
+
<p>
The X Server sub page contains commands for starting the X-Server.
-<p></p><img src="../images/preferences2.jpg" alt="preferences3"></li>
+</p>
+<p></p>
+<img src="../images/preferences2.jpg" alt="preferences3">
</body>
-</html>
\ No newline at end of file
+</html>
Modified: trunk/org.indt.esbox.help/html/tasks/SettingsSbrshConfiguration.html
===================================================================
--- trunk/org.indt.esbox.help/html/tasks/SettingsSbrshConfiguration.html 2008-02-15 01:22:41 UTC (rev 409)
+++ trunk/org.indt.esbox.help/html/tasks/SettingsSbrshConfiguration.html 2008-02-15 11:53:51 UTC (rev 410)
@@ -2,39 +2,56 @@
<html>
<head>
+
+
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
- <title>Setting preferences</title>
+
+
+
+ <title>Setting preferences</title>
<style type="text/css">
<!--
.style1 {font-family: Arial, Helvetica, sans-serif}
-->
</style>
</head>
+
+
<body>
+
<h2 class="style1">Setting Sbrsh preferences</h2>
+
<p>In order to use the features releated to remote launch and debug, it
is necessary to configure properly Sbrsh (Scratchbox Remote Shell).
ESbox has a preference page that helps to setting sbrsh configuration.
Go to Window -> Prefences -> ESbox -> Sbrsh.</p>
+
<img style="width: 835px; height: 685px;" alt="" src="../images/sbrsh0.jpg"><br>
+<br>
+<br>
-<p>You have to edit location of both sbrsh configuration (default is /home/USER/.sbrsh) and exec files (default is /home/USER/sbrsh).
+
+<p>You have to edit location of both sbrsh configuration (default is
+/home/USER/.sbrsh) and exec files (default is /home/USER/sbrsh).
The page loads the file and shows all elements of it (user name, device
and host IPs, etc.). You can edit, create or remove mount points of
Sbrsh configuration file.</p>
<p><img style="width: 835px; height: 685px;" alt="" src="../images/sbrsh1.jpg"></p>
-You have to select a mount point as path to copy the binaries that will
+<br>
+<p>You have to select a mount point as path to copy the binaries that will
be executed. Sbrsh mounts such mount point (and all the others to). To
select a mount point as bin path, click-rigth on the mount point you
-want to select.
+want to select.</p>
<p><img style="width: 840px; height: 690px;" alt="" src="../images/sbrsh3.jpg"></p>
+
<br>
+
</body>
</html>
More information about the Esbox-commits
mailing list