[Esbox-commits] r986 - branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted
jeffc at garage.maemo.org
jeffc at garage.maemo.org
Sat Nov 22 02:03:59 EET 2008
Author: jeffc
Date: 2008-11-22 02:03:59 +0200 (Sat, 22 Nov 2008)
New Revision: 986
Modified:
branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/BasicTutorial.html
branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/CompilingCMaemoProject.html
branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/ConfigurationTutorial.html
branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/CreatingAMaemoProject.html
branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/CreatingProjectTemplates.html
branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/CreatingPythonProject.html
branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/DebuggingCMaemoApplications.html
branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/DebuggingPythonMaemoApplications.html
branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/ExternalizeString.html
branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/Introduction.html
branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/ProfilingMaemoApplications.html
branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/RunningCProject.html
branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/RunningPythonProject.html
branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/SettingPreferences.html
branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/SettingsSbrshConfiguration.html
Log:
updated info and screenshots
Modified: branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/BasicTutorial.html
===================================================================
--- branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/BasicTutorial.html 2008-11-22 00:02:42 UTC (rev 985)
+++ branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/BasicTutorial.html 2008-11-22 00:03:59 UTC (rev 986)
@@ -10,7 +10,7 @@
<body>
<h2 class="style1">Basic Tutorial</h2>
-<p>Shows step by step how to create a ESbox project.</p>
+<p>Creating a Maemo project</p>
<ul>
<li><strong><a href="CreatingAMaemoProject.html">
@@ -25,13 +25,13 @@
Creating a Python Project
</a></strong></li></ul>
-<p>Now with ESbox project created, Let's compile.</p><ul>
+<p>Compiling Maemo project</p><ul>
<li><strong><a href="CompilingCMaemoProject.html">
Compiling a C/C++ Maemo Project
</a></strong></li></ul>
-<p>Finally, running projects.</p><ul>
+<p>Running projects</p><ul>
<li><a href="RunningCProject.html"><STRONG>
Running C/C++ Maemo Project
@@ -40,7 +40,7 @@
Running Python Maemo Project
</a></strong></li></ul>
-<p>Debugging projects.</p><ul>
+<p>Debugging projects</p><ul>
<li><a href="DebuggingCMaemoApplications.html"><STRONG>
Debugging C/C++ Maemo Project
</STRONG></a></li>
@@ -48,14 +48,14 @@
Debugging Python Maemo Project
</a></strong></li></ul>
-<p>Analysis of Performance.</p><ul>
+<p>Analyzing Performance</p><ul>
<li><strong><a href="ProfilingMaemoApplications.html">
Profiling C/C++ application
</a></strong></li></ul>
-<p>Helping extraction of strings.</p><ul>
+<p>Extracting strings</p><ul>
<li><strong><a href="ExternalizeString.html">
-Externalize string on C/C++ application.
-</a></strong></li></ul>
+Externalize string on C/C++ application</a></strong></li>
+</ul>
</body>
</html>
Modified: branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/CompilingCMaemoProject.html
===================================================================
--- branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/CompilingCMaemoProject.html 2008-11-22 00:02:42 UTC (rev 985)
+++ branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/CompilingCMaemoProject.html 2008-11-22 00:03:59 UTC (rev 986)
@@ -11,29 +11,26 @@
<h2 class="style1">Compiling a C/C++ Maemo Project</h2>
-<p>When an Automake C/C++ Maemo Project is created, it is automatically compiled.</p>
-<p>If you created a Makefile C/C++ Maemo Project, you need to provide a makefile.</p>
-
+<p>When an Automake C/C++ Maemo Project is created, it is automatically compiled. If you create 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>
For more information about creating a make target <a href="../tasks/CreateMakeTarget.html">click here</a>.
-<p></p>
<p>To build your C/C++ Maemo Project:</p>
<ul>
<li> In the Project Explorer or C/C++ view, select a project.</li>
<li> Right click on a project and select Build Application (context menu varies depending upon which view is active)</li>
- <li> Options include generating a configure script, run your configure script (same as ./configure) or build your project.</li>
+ <li> Options include generating a configure script (Generate Configure), run your configure script (Configure) (same as ./configure) or build your project (Build All).</li>
<p></p>
- <img src="../images/build.jpg" alt="build" width="549" height="670">
+ <img src="../images/buildapp.png" alt="build" width="452" height="524">
<p></p>
<li> The screenshot below shows the effect of clicking Build All. The Console view displays the output of the make utility.</li>
<p></p>
- <img src="../images/build1.jpg" alt="build1" width="1036" height="768">
+ <img src="../images/consoleoutput.png" alt="build1" width="693" height="210">
</ul>
<p> </p>
Modified: branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/ConfigurationTutorial.html
===================================================================
--- branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/ConfigurationTutorial.html 2008-11-22 00:02:42 UTC (rev 985)
+++ branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/ConfigurationTutorial.html 2008-11-22 00:03:59 UTC (rev 986)
@@ -11,9 +11,7 @@
<body>
-<h3>Project Configuration Tutorial</h3>
-
-<p></p>
+<h2>Project Configuration</h2>
<ul>
<li><strong><a href="SettingPreferences.html">
Setting Preferences
Modified: branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/CreatingAMaemoProject.html
===================================================================
--- branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/CreatingAMaemoProject.html 2008-11-22 00:02:42 UTC (rev 985)
+++ branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/CreatingAMaemoProject.html 2008-11-22 00:03:59 UTC (rev 986)
@@ -14,7 +14,7 @@
</head>
<body>
-<h2 class="style1">Creating a new C/C++ Maemo project</h2>
+<h2 class="style1">Creating a C/C++ Maemo project</h2>
<p>The following steps describe how to create a project that contains your source code and related files.
A project has an associated builder that can incrementally compile source
@@ -25,23 +25,21 @@
<p>To create a new C/C++ Maemo project:</p>
<ol>
- <li>Select <strong>File > New > C/C++ Maemo Project</strong> from the main menu bar to open the New Project wizard.</li>
- <p>Depending on which view is currently active, you may have to select <strong>Project...</strong> then expand the <strong>C</strong> folder and select <strong><em>M</em> C/C++ Maemo Project</strong>.</p>
- <p><img src="../images/esbox0.jpg" alt="esbox0" width="600" height="368"></p>
+ <li>Select <strong>File > New > C/C++ Maemo Project</strong> from the main menu bar to open the New Project wizard.
+ <p><img src="../images/newmaemoproject.png" alt="esbox0" width="632" height="179"></p>
+ </li>
<li>In the Template Project Type window, select a project template and click Next. You can choose an empty project in the Simple group. Select a template to display related information in the bottom information box. Check the "Filter templates based on enabled SDKs" box to only display templates based on installed and enabled SDKs. </li>
- <p><img src="../images/esbox1.jpg" alt="esbox1" width="525" height="850"></p>
+ <p><img src="../images/projecttemplate.png" alt="esbox1" width="525" height="726"></p>
<li>In the Project Configuration Dialog, type your project name in the Project name field. You can use the default workspace location to store the new project or uncheck the "Use default location" option to browse to a different folder. Select a build target for the project. To show all installed build targets unrelated to the selected template, uncheck the "Filter build targets based on selected template" option. </li>
- <p><img src="../images/esbox2.jpg" alt="esbox2" width="525" height="556"></p>
+ <p><img src="../images/projconfig.png" alt="esbox2" width="493" height="518"></p>
<li>Click <STRONG>Next</STRONG> to display the Basic Settings dialog.</li>
- <p><img src="../images/esbox3.jpg" alt="esbox3" width="525" height="483"></p>
- <li>Click <STRONG>Finish</STRONG> to create project. If the C/C++ perspective is not currently set as the default, you are prompted to associate the project with the C/C++ perspective. Click Yes.</li>
+ <p><img src="../images/basicsettings.png" alt="esbox3" width="484" height="343"></p>
+ <li>Click <STRONG>Finish</STRONG> to create project. If the C/C++ perspective is not currently set as the default, you are prompted to associate the project with the C/C++ perspective. Click Yes.</li><br \>
- <p><img src="../images/esbox4.jpg" alt="create project" width="524" height="482"></p>
+ <li>The Console output will display information related to the project creation and suggest ways to fix any errors.</li>
- <li>The Console output will display information related to the project creation and suggest ways to fix any errors.</li>
-
- <p><img src="../images/esbox5.jpg" alt="console" width="772" height="251"></p>
+ <p><img src="../images/console.png" alt="console" width="693" height="210"></p>
</ol>
</body>
Modified: branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/CreatingProjectTemplates.html
===================================================================
--- branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/CreatingProjectTemplates.html 2008-11-22 00:02:42 UTC (rev 985)
+++ branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/CreatingProjectTemplates.html 2008-11-22 00:03:59 UTC (rev 986)
@@ -14,7 +14,7 @@
</head>
<body>
-<h2 class="style1">Creating a Hello World Application</h2>
+<h2 class="style1">Creating HelloWorld Project from Template</h2>
<p>In this tutorial, you will use the CDT to create a simple 'Hello World' application.
This tutorial describes the process of creating a new C/C++ Maemo project where the
@@ -23,18 +23,18 @@
<p>To create a hello world project:</p>
<ol>
<li>Select <strong>File > New > Project...</strong> from the main menu bar to open the New Project wizard.</li>
- <p><img src="../images/newproject.png" alt="new project" width="667" height="330"></p>
+ <p><img src="../images/newproj.png" alt="new project" width="634" height="175"></p>
<li>In the New Project dialog, select the folder with the name C, click C/C++ Maemo Project and click Next to start the new C/C++ maemo project wizard.</li>
- <p><img src="../images/newproject1.png" alt="new"></p>
+ <p><img src="../images/newproj_selectwiz.png" alt="new" width="525" height="500"></p>
<li>Select the Hello World project and click Next. Additional information for each project template is displayed in the information box. </li>
- <p><img src="../images/newproject2.png" alt="new" width="559" height="718"></p>
+ <p><img src="../images/newproj_template.png" alt="new" width="525" height="726"></p>
<li>In the Project name field, enter a name for the project and select an installed build target.</li>
- <p><img src="../images/newproject3.png" alt="target"></p>
+ <p><img src="../images/newproj_config.png" alt="target" width="503" height="505"></p>
<li>Next, you can specify the basic properties for the new project,
such as your name and version.</li>
- <p><img src="../images/newproject4.png" alt="new" width="559" height="447"></p>
+ <p><img src="../images/newproj_basic.png" alt="new" width="503" height="505"></p>
<li>Click <STRONG>Finish</STRONG>. If the C/C++ perspective is not currently set as the default, you are prompted to display the C/C++ perspective. Click Yes.</li>
</ol>
Modified: branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/CreatingPythonProject.html
===================================================================
--- branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/CreatingPythonProject.html 2008-11-22 00:02:42 UTC (rev 985)
+++ branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/CreatingPythonProject.html 2008-11-22 00:03:59 UTC (rev 986)
@@ -21,17 +21,16 @@
<li>Select <strong>File > New > Project...</strong> from the main menu bar to open the New Project wizard.</li>
<li>In the New Project, select the folder with the name Pydev, click Python Maemo Project and click Next to start the project wizard.</li>
<p><img src="../images/newpythonproject.png" alt="python" width="525" height="500"></p>
- <li>On this page, type your project name in the Project name field.</li>
- <li> Choose a python template in Project types.</li>
- <li>Choose a platform target and SDK.</li>
- <p><img src="../images/newpythonproject1.png" alt="python1" width="621" height="532"></p>
- <p> </p>
- <li> Click <STRONG>Next</STRONG> to set basic settings.</li>
- <p> </p>
- <p><img src="../images/newpythonproject2.png" alt="basic" width="621" height="532"></p>
+ <li>On this page, select a project template.</li>
+ <p><img src="../images/newpythonproject1.png" alt="python1" width="525" height="500"></p>
+ <li>Click <STRONG>Next</STRONG> to define project name and build target.</li>
+ <p><img src="../images/newproj_pythonconfig.png" alt="configurations" width="525" height="500"></p>
+ <li>Click <STRONG>Next</STRONG> to set basic settings.
+ <p><img src="../images/newproj_pythonbasic.png" alt="basic" width="525" height="379"></p>
+ </li>
<li> Click <STRONG>Finish</STRONG>.</li>
<li> You are prompted to associate this project with the Pydev perspective. Click Yes, if desired.</li>
- <p><img src="../images/python9.jpg" alt="python9"></p>
+ <p><img src="../images/newproj_pydevperspec.png" alt="python9" width="544" height="192"></p>
</ol>
</body>
Modified: branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/DebuggingCMaemoApplications.html
===================================================================
--- branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/DebuggingCMaemoApplications.html 2008-11-22 00:02:42 UTC (rev 985)
+++ branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/DebuggingCMaemoApplications.html 2008-11-22 00:03:59 UTC (rev 986)
@@ -16,54 +16,55 @@
<h2 class="style1">Debugging a C/C++ Maemo Application</h2>
-In oder to debug a C/C++ application, it is necessary that you compile the application using GCC debugger flags (e.g,
--g). If you want to use remote debugging, it is necessary to configure Sbrsh (see <a href="SettingsSbrshConfiguration.html">Setting Sbrsh Configuration</a>) You can also set
-breakpoints in the code. Just right-click on the left-side editor
+To debug a C/C++ application, it is necessary that you compile the application using GCC debugger flags (e.g,
+-g). If you want to use remote debugging, it is necessary to configure Sbrsh (see <a href="SettingsSbrshConfiguration.html">Setting Sbrsh Configuration</a>). You can also set
+breakpoints in the code. Right-click on the left-side editor
margin and add a breakpoint.
-<p><img src="../images/debug9.jpg" width="824" height="526"></p>
+<p><img src="../images/breakpoint.png" width="595" height="531"></p>
<p></p>
-<p>ESbox has 3 different types of debuggers:</p>
+<p>Maemo provides five different types of debuggers:</p>
<ul>
- <li>ESbox GDB Debugger</li>
- <li>ESbox
+ <li>gdb/mi</li>
+ <li>gdb Debugger</li>
+ <li>gdbserver Debugger</li>
+ <li>Maemo
gdbserver Debugger on Device</li>
- <li>ESbox gdbserver Local Debugger</li>
+ <li>Maemo gdbserver Local Debugger</li>
</ul>
+<p>Select <strong>Run > Run Configurations...</strong> or <strong>Run > Debug Configurations...</strong> and select the Debugger tab for a local or remote run or debug configuration you have created.</p>
+<p><img src="../images/debuggertab.png" alt="Debug tab" width="630" height="373"></p>
<p> </p>
-<p>Select <strong>Run > Open Run Dialog...</strong> or <strong>Run > Open Debug Dialog...</strong> and select the Debugger tab for a local or remote run or debug configuration you have created.</p>
-<p><img src="../images/pref_images/debugtab_maintab.png" alt="Debug tab" width="642" height="452"></p>
-<p> </p>
<p>The debugger types are selected from a dropdown list in the Debugger tab of the Run or Debug dialog.</p>
-<p> </p>
-<p><img src="../images/pref_images/debugtab_debuggerlist.png" alt="debuggers" width="651" height="415"></p>
-<p> </p>
-<p> ESbox
- GDB Debugger is designed to be used in Scratchbox targets that use
- compilers for X86 architecture.</p>
-<p>ESbox gdbserver Debugger
+<p><img src="../images/debuggers.png" alt="debuggers" width="518" height="109"></p>
+<p> GDB Debugger is designed to be used in Scratchbox targets that use
+ compilers for the X86 architecture.</p>
+<p>Maemo gdbserver Debugger
on Device is used to debug applications that are running on the Internet
Tablet.</p>
-<p>ESbox gdbserver Local Debugger is designed to be used in Scratchbox targets that use
+<p>Maemo gdbserver Local Debugger is designed to be used in Scratchbox targets that use
compilers for the ARM architecture.</p>
<p>To debug your C/C++ Maemo Project:</p>
<ul><li>In the C/C++ Projects view, select a project.</li>
<li>Right click on the application and select <strong>Debug As > Maemo Local Application</strong>.</li>
<p></p>
- <p><img src="../images/debug10.jpg" width="743" height="721"><br>
+ <p><img src="../images/debuglocalapp.png" width="678" height="606"><br>
</p>
<p></p>
+ <li>If Maemo is not running, you will be prompted to launch it. Click Yes to launch Maemo.</li>
+ <li>If a breakpoint is set in your source code, you will also be prompted to open the Debug Perspective.</li>
<li>The Debug perspective is opened and various information about your application is shown: memory map, registers,
variables, etc. The programmer can also follow the control flow of the
application.</li>
<p></p>
- <p><img src="../images/debug5.jpg" width="1036" height="768"></p>
-
+ <p><img src="../images/debugperspec.png" width="968" height="673"></p>
</ul>
<p> </p>
<h3>Related Topic</h3>
-<p><a href="../concepts/RemoteDebugging.html">Remote Debugging</a> </p>
+<ul>
+ <li><a href="../concepts/RemoteDebugging.html">Remote Debugging</a></li>
+</ul>
</body>
</html>
Modified: branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/DebuggingPythonMaemoApplications.html
===================================================================
--- branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/DebuggingPythonMaemoApplications.html 2008-11-22 00:02:42 UTC (rev 985)
+++ branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/DebuggingPythonMaemoApplications.html 2008-11-22 00:03:59 UTC (rev 986)
@@ -36,25 +36,27 @@
<br>
-<img src="../images/debug7.jpg" width="1024" height="560"></p>
+<img src="../images/setbreakpoint.png" width="578" height="672"></p>
<p></p>
<p>To debug:</p>
-<ul>
- <p></p>
+<ul><li> In the Pydev Package Explorer view, select a project.</li>
+ <li> Right click on the python script and select <strong>Debug As > Python Maemo Local Application.</strong></li>
- <li> In the Pydev Package Explorer view, select a project.</li>
- <li> Right click on the python script and select <strong>Debug As > Python Maemo Local Application </strong>or select <strong>Python Maemo Remote Application</strong>; as appropriate.</li>
-
- <p><img src="../images/debug8.jpg" width="799" height="709"></p>
+ <p><img src="../images/debugpythonlocal.png" width="716" height="442"></p>
<p> </p>
- <li> The Debug perspective is opened and various information about your application is shown: variables, breakpoints, etc. The programmer can also follow the control flow of the application.</li>
- <p><img src="../images/debug6.jpg"></p>
+ <li>If Maemo is not running, you will be prompted to launch it. Click Yes to launch Maemo.</li>
+ <li>If a breakpoint is set in your source code, you will also be prompted to open the Debug Perspective.</li>
+ <li>The Debug perspective is opened and various information about your application is shown: variables, breakpoints, etc. The programmer can also follow the control flow of the application. Click Resume button (or F8) to continue with application execution.</li>
+ <p><img src="../images/debug_python.png" width="968" height="673"></p>
+ <li>If you receive errors and Debug perspective is not opened, make sure that the Python interpreter is defined in the preferences setting. Select <strong>Window > Preferences > Pydev > Interpreter - Python</strong> to define the location of the Python Interpreters.</li>
+ <p align="left"><img src="../images/pref_pythonint.png" alt="python interpreter" width="693" height="726"></p>
</ul>
- <h3>Related Topics</h3>
- <p><a href="SettingsSbrshConfiguration.html">Setting Sbrsh Preferences</a></p>
- <p><a href="SettingPreferences.html">Setting Preferences</a> </p>
- <p> </p>
+<h3>Related Topics</h3>
+ <ul>
+ <li><a href="SettingsSbrshConfiguration.html">Setting Sbrsh Preferences</a></li>
+ <li><a href="SettingPreferences.html">Setting Preferences</a></li>
+</ul>
</body>
</html>
Modified: branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/ExternalizeString.html
===================================================================
--- branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/ExternalizeString.html 2008-11-22 00:02:42 UTC (rev 985)
+++ branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/ExternalizeString.html 2008-11-22 00:03:59 UTC (rev 986)
@@ -18,26 +18,25 @@
<p>The Externalize Strings wizard allows you to refactor a compilation unit
-such that strings used in the compilation unit can be translated to different languages.
-</p>
+such that strings used in the compilation unit can be translated to different languages.</p>
<p>To externalize strings:</p>
<ol>
- <li>Select a project and right-click to display the popup menu and select <strong>Source > Externalize String</strong>.</li>
- <p><img src="../images/externalize01.jpg" alt="Externalize String"></p>
- <li>Select the file that should be externalized.</li>
- <p><img src="../images/externalize02.jpg" alt="File that should be externalized"></p>
- <li>A Wizard will appear showing strings that will be externalized. You can define the name of the output file, msgstr, and msgid.</li>
- <p><img src="../images/externalize03.jpg" alt="Externalize Wizard"></p>
+ <li>Select a project in Project Explorer and right-click to display the popup menu and select <strong>Source > Externalize Strings</strong>.</li>
+ <p><img src="../images/extractstrings.png" alt="Externalize String" width="430" height="459"></p>
+ <li>Select the file(s) that should be externalized to enable the Externalize button, then click Externalize.</li>
+ <p><img src="../images/extractstrings1.png" alt="File that should be externalized" width="400" height="500"></p>
+ <li>A Wizard will appear showing strings that will be externalized. You can define the name of the output file, msgstr, and msgid. Click on a message string or message id to make a change.</li>
+ <p><img src="../images/extractstrings2.png" alt="Externalize Wizard" width="719" height="726"></p>
<li>Click Finish.</li>
</ol>
-<p>A couple of files will be generated (<strong>POTFILE.in</strong> and <strong>outputName.po</strong>) which will be placed in the <strong>YourProject/po/</strong> directory.</p>
+<p>A couple of files will be generated (<strong>POTFILE.in</strong> and <strong>outputName.po</strong>) which will be placed in the <strong><em>ProjectName</em>/po/</strong> directory.</p>
<ul>
<li>POTFILES.in contains the list of source code files that will be localized.</li>
- <li> outputName.po includes translated text.</li>
+ <li> <em>outputName</em>.po includes translated text.</li>
</ul>
-<p>The Console view may output some warnings which usually are not serious, but should be checked.</p>
+<p>The Console view will output warnings and errors.</p>
<p><b>For example:</b></p>
<p>In your source code, you probably have many strings, which eventually are shown in the user interface. For example:</p>
Modified: branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/Introduction.html
===================================================================
--- branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/Introduction.html 2008-11-22 00:02:42 UTC (rev 985)
+++ branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/Introduction.html 2008-11-22 00:03:59 UTC (rev 986)
@@ -26,7 +26,7 @@
<h4 align="left" class="style1">Target</h4>
<ul>
<p>
- The active toolchain and configuration currently used. A target uses a selected toolchain and contains a filesystem to use, and a related configuration. You can have multiple targets, even if they all use the same toolchains. This makes it easy to try something different, or start a parallel target to test things from scratch. Examples of targets are CHINOOK_ARMEL and CHINOOK_X86.</p>
+ The active toolchain and configuration currently used. A target uses a selected toolchain and contains a filesystem to use, and a related configuration. You can have multiple targets, even if they all use the same toolchains. This makes it easy to try something different, or start a parallel target to test things from scratch. Examples of targets are DIABLO_ARMEL and DIABLO_X86.</p>
</ul>
<h4 align="left" class="style1">Platform</h4>
@@ -41,7 +41,6 @@
</ul>
<h4 align="left" class="style1">SDK</h4>
-<ul>
<p>
SDK is typically a set of development tools that allows a software engineer
to create applications for a specific software framework or something similar.
@@ -53,18 +52,13 @@
<ul>
<li>Latest stable: maemo 4.0.1 Chinook</li>
</ul>
-</p>
<p>
OS2007 for N800 developers
<ul>
<li>Latest stable: maemo 3.x Bora</li>
</ul>
-</p>
-<p>Nokia 770 developers
-<ul>
+<p>Nokia 770 developers<ul>
<li>Latest: maemo 2.2 Gregale</li>
</ul>
-</p>
-
</body>
</html>
\ No newline at end of file
Modified: branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/ProfilingMaemoApplications.html
===================================================================
--- branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/ProfilingMaemoApplications.html 2008-11-22 00:02:42 UTC (rev 985)
+++ branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/ProfilingMaemoApplications.html 2008-11-22 00:03:59 UTC (rev 986)
@@ -31,20 +31,18 @@
select an X86 Scratchbox target with the tool properly installed.</p>
<p>To run Valgrind, right-click on the application (binary for C/C++
-projects or the Python script for Python projects) and select <strong>Run As > Valgrind Memory Profiler</strong>.</p>
+projects or the Python script for Python projects) and select <strong>Run As > Local Valgrind Memory Profiler</strong>.<br>
<br>
-<br>
-<img src="../images/profiling0.jpg" width="789" height="743"><br>
+<img src="../images/valgrind.png" width="509" height="428"><br>
</h2>
-<p> </p>
+</p>
<p>The Valgrind tool runs your application on the X86 target and the result is
shown in the Valgrind view. All problems found by Valgrind are shown as a
tree: problem as parent nodes and details of the problems as children
nodes.</p>
+<p><img src="../images/profiling1.jpg"><br>
+</p>
<p> </p>
-<img src="../images/profiling1.jpg"><br>
-
-<p> </p>
<h3>Using OProfile</h3>
<p>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,
@@ -62,10 +60,6 @@
configuration for Oprofile yourself, please see
<a href="../tasks/CreateOprofileconfig.html">Creating a OProfile Run Launch Configuration</a>.</p>
-<br>
-<img src="../images/profiling6.jpg" width="764" height="633">
-<br>
-<p> </p>
<p>After OProfile starts, ESbox launches your application on the device.
Then a dialog will pop up letting you decide when to stop profiling data collecting.
After you click OK on the dialog, OProfile data collecting will
Modified: branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/RunningCProject.html
===================================================================
--- branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/RunningCProject.html 2008-11-22 00:02:42 UTC (rev 985)
+++ branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/RunningCProject.html 2008-11-22 00:03:59 UTC (rev 986)
@@ -26,12 +26,12 @@
<ol>
- <li> In the C/C++ Maemo Projects view, select a project.</li>
- <li> Click <strong>Run As > Open Run Dialog</strong>.</li>
- <li> In the Configurations box, select Maemo Local Application or Maemo Remote Application.</li>
+ <li> In the C/C++ perspective, select a project.</li>
+ <li> Click <strong>Run As > Run Configurations...</strong></li>
+ <li> Select Maemo Local Application or Maemo Remote Application.</li>
<li> <img src="../images/pref_images/new.png" alt="new" width="18" height="18">Click the New button. The name of the new project is displayed in the Configurations box located on the leftside of window. The default name is the name of the project.</li>
<li> Click the Main tab.</li>
- <p><img src="../images/run_main.png" alt="Main" width="855" height="640"></p>
+ <p><img src="../images/run_main.png" alt="Main" width="844" height="559"></p>
<li>Do the following:
<ul>
<li>In the Name box, type a descriptive name for this launch configuration.</li>
@@ -41,9 +41,9 @@
</li>
<p>Make sure that the right target has been chosen.</p>
- <li>Select the project in Project Explorer, right-click and select <strong>Properties. </strong>Then select <strong>ESbox Build Target</strong>.</li>
+ <li>Select the project in Project Explorer, right-click and select <strong>Properties. </strong>Then select <strong>Maemo Build ConfigurationsTarget</strong>.</li>
<li>Select the correct build target for this project, which is used to cross-compile and run your application.</li>
- <p><img src="../images/pref_images/installed_targets.png" alt="targets" width="772" height="558"></p>
+ <p><img src="../images/maemobuildconfigs.png" alt="targets" width="822" height="574"></p>
<p>For more information about targets <a href="../tasks/CreateNewTarget.html">click here</a>.</p>
@@ -51,12 +51,12 @@
<li>Click on Maemo (M) button.</li>
</ol>
-<p>Now with everything set up, select <strong>Run as > Maemo Local Application</strong> or <strong>Maemo Remote Application</strong>; as appropriate.</p>
+<p>Now with everything set up, select the project, right-click and select <strong>Run as > Maemo Local Application</strong>.</p>
-<p><img src="../images/run1.jpg" alt="run2" width="782" height="701"></p>
-<p> </p>
<h3>Related Topics</h3>
-<p><a href="SettingsSbrshConfiguration.html">Setting Sbrsh Preferences</a></p>
-<p><a href="DebuggingCMaemoApplications.html">Debugging a C/C++ Maemo Project</a></p>
+<ul>
+ <li><a href="SettingsSbrshConfiguration.html">Setting Sbrsh Preferences</a></li>
+ <li><a href="DebuggingCMaemoApplications.html">Debugging a C/C++ Maemo Project</a></li>
+</ul>
</body>
</html>
Modified: branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/RunningPythonProject.html
===================================================================
--- branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/RunningPythonProject.html 2008-11-22 00:02:42 UTC (rev 985)
+++ branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/RunningPythonProject.html 2008-11-22 00:03:59 UTC (rev 986)
@@ -36,18 +36,18 @@
<li>Click on Maemo (M) button.</li>
- <li>In the Pydev Projects view, select a project.</li>
- <li>Select <strong>Run As > Python Maemo Local Application</strong> or <strong>Run As > Python Maemo Remote Application</strong>; as desired.</li>
- <p><img src="../images/python3.jpg" alt="python3" width="798" height="687"></p>
+ <li>In the Pydev Projects view, select a project script file.</li>
+ <li>Right-click and select <strong>Run As > Python Maemo Local Application</strong> or <strong>Run As > Python Maemo Remote Application</strong>; as appropriate.</li>
+ <p><img src="../images/runpython.png" alt="python3" width="760" height="672"></p>
</ol>
+<p> </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 select Ctrl+F11, the last file ran is re-run.</p>
-<p> </p>
<h3>Related Topics</h3>
-<p><a href="SettingsSbrshConfiguration.html">Setting Sbrsh Preferences</a></p>
-<p><a href="SettingPreferences.html">Setting Preferences</a> </p>
-<p> </p>
+<ul>
+ <li><a href="SettingsSbrshConfiguration.html">Setting Sbrsh Preferences</a></li>
+ <li><a href="SettingPreferences.html">Setting Preferences</a></li>
+</ul>
</body>
</html>
Modified: branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/SettingPreferences.html
===================================================================
--- branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/SettingPreferences.html 2008-11-22 00:02:42 UTC (rev 985)
+++ branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/SettingPreferences.html 2008-11-22 00:03:59 UTC (rev 986)
@@ -15,69 +15,56 @@
<body>
-<h1 class="style1">Setting Preferences</h1>
+<h1>Setting Preferences</h1>
<p>
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 group.</p>
+running with the plug-ins, the preferences may be set by selecting <strong>Window > Preferences...</strong> and expanding the Maemo group.</p>
<p>
-The ESbox page allows you to define the syntax used to invoke commands inside Scratchbox (this varies between Scratchbox versions) and the root directory of
+The Maemo page allows you 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" width="900" height="558"><br>
+<img src="../images/pref_images/maemo_pref.png" alt="preferences1" width="892" height="477"><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. Inside that dialog you can click Variables to select from a list of build variables. </p>
+<p>The <strong>Environment</strong> page allows you to define Scratchbox environment variables. Click the New button to specify the variable Name and Value.</p>
+<p><img src="../images/pref_images/pref_maemo_env.png" alt="environment" width="804" height="495"></p>
<p> </p>
-<p><img src="../images/pref_images/env.png" alt="environment" width="736" height="558"></p>
-<p><img src="../images/variables.png" alt="variables" width="392" height="601"></p>
-<p> </p>
-<p> </p>
-<h2><a name="gaz"></a>Gazpacho</h2>
-<p>The <strong>Gazpacho</strong> page gets its name from the common graphical user interface editor Gazpacho. Gazpacho
- is an advanced gui editor. You can specify to "Use xhost command to start Gazpacho in Maemo" and enter a command for starting Xhost.</p>
-<p></p>
-<p><img src="../images/pref_images/gazpacho.png" alt="Gazpacho" width="737" height="559"><br>
- <br>
-</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><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="692" height="492"></p>
<p> </p>
-<p><img src="../images/pref_images/targets.png" alt="installed targets" width="690" height="558"></p>
-<p> </p>
<blockquote>
<h3><a name="newtarget"></a>Creating a New Target</h3>
- <p>Click the <strong>New</strong> button to launch a wizard for creating a new target. If both scratchbox1 and scratchbox2 are installed, then a dialog will appear requesting you to choose which version of scratchbox to use for the new target. </p>
- <p><img src="../images/pref_images/new_target.png" alt="define target" width="542" height="185"></p>
- <h4> </h4>
+ <p>Click the <strong>New</strong> button to launch a wizard for creating a new target. If both scratchbox1 and scratchbox2 are installed, then a dialog will appear requesting you to choose which version of scratchbox to use for the new target.</p>
<h4>Scratchbox 1 Wizard</h4>
<p>If you choose scratchbox 1, the following wizard dialogs will appear.</p>
<p>Enter a name for the new target and select Next. </p>
- <p><img src="../images/pref_images/new_target_sb1_1.png" alt="target name" width="480" height="421"></p>
+ <p><img src="../images/pref_images/new_target_sb1_1.png" alt="target name" width="512" height="448"></p>
<p> </p>
<p>Select a compiler for the new target and select Next. </p>
- <p><img src="../images/pref_images/new_target_sb1_2.png" alt="compiler" width="480" height="421"></p>
+ <p><img src="../images/pref_images/new_target_sb1_2.png" alt="compiler" width="512" height="448"></p>
<p> </p>
<p>Select a devkit and click Next. </p>
- <p><img src="../images/pref_images/new_target_sb1_3.png" alt="Devkit" width="480" height="421"></p>
+ <p><img src="../images/pref_images/new_target_sb1_3.png" alt="Devkit" width="512" height="448"></p>
<p> </p>
<p>Select a CPU-transparency method and click Next.</p>
- <p>The recommended setting for the CPU transparency method is "qemu-arm-0.8.2-sb2". The sbrsh method should be manually configured to take advantage of sshfs.More information is located at: http://maemo-sdk.garage.maemo.org/sbrsh-sshfs.html.</p>
- <p><img src="../images/pref_images/new_target_sb1_4.png" alt="cpu" width="480" height="421"></p>
+ <p>The recommended setting for the CPU transparency method is "qemu-arm-0.8.2-sb2". The sbrsh method should be manually configured to take advantage of sshfs. More information is located at: http://maemo-sdk.garage.maemo.org/sbrsh-sshfs.html.</p>
+ <p><img src="../images/pref_images/new_target_sb1_4.png" alt="cpu" width="512" height="448"></p>
<p> </p>
<p>If <strong>sbrsh</strong> is selected in the CPU-transparency method dialog, additional dialogs are provided to enter the target and host addresses.</p>
<p>Enter the Target Device Address. </p>
- <p><img src="../images/pref_images/new_target_sb1_5.png" alt="target address" width="529" height="421"></p>
+ <p><img src="../images/pref_images/new_target_sb1_5.png" alt="target address" width="512" height="448"></p>
<p> </p>
<p>Enter the hostname or ip address and click Finish. </p>
- <p><img src="../images/pref_images/new_target_sb1_6.png" alt="hostname" width="529" height="421"></p>
+ <p><img src="../images/pref_images/new_target_sb1_6.png" alt="hostname" width="512" height="448"></p>
<p> </p>
<h4>Scratchbox 2 Wizard </h4>
<p>If you choose scratchbox 2 for a new target, the following wizard dialogs will appear.</p>
@@ -96,29 +83,25 @@
<p> </p>
<p>Select a CPU-transparency method and click Next. </p>
<p><img src="../images/pref_images/new_target_sb2_4.png" alt="sb4" width="550" height="433"></p>
- <p> </p>
<p>If <strong>sbrsh</strong> is selected in the CPU-transparency method dialog, additional dialogs are provided to enter the target and host addresses.</p>
<p>Enter the Target Device Address.</p>
- <p><img src="../images/pref_images/new_target_sb1_5.png" alt="target address" width="529" height="421"></p>
+ <p>Enter the hostname or ip address and click Finish.</p>
<p> </p>
- <p>Enter the hostname or ip address and click Finish. </p>
- <p><img src="../images/pref_images/new_target_sb1_6.png" alt="hostname" width="529" height="421"></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="832" height="472"></p>
+<p><img src="../images/pref_images/sbox1.png" alt="sbox1" width="1012" height="475"></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="832" height="472"></p>
+<p><img src="../images/pref_images/sbox2.png" alt="sbox2" width="912" height="563"></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="864" height="473"></p>
+<p><img src="../images/pref_images/ssh.png" alt="ssh" width="922" height="575"></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="996" height="473"></p>
+<p><img src="../images/pref_images/xserver.png" alt="xserver" width="930" height="472"></p>
</body>
</html>
Modified: branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/SettingsSbrshConfiguration.html
===================================================================
--- branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/SettingsSbrshConfiguration.html 2008-11-22 00:02:42 UTC (rev 985)
+++ branches/work_Jeff/org.maemo.esbox.help/html/gettingstarted/SettingsSbrshConfiguration.html 2008-11-22 00:03:59 UTC (rev 986)
@@ -16,14 +16,13 @@
<body>
-<h2 class="style1">Setting Sbrsh preferences</h2>
+<h2 class="style1">Setting Sbrsh Preferences</h2>
<p>To use Sbrsh (Scratchbox Remote Shell) to run or debug a C/C++ or Python Maemo application remotely on a device, sbrsh settings can be configured in a new Run or Debug remote launch configuration.
-Select a project in the Project Explorer and select <strong>Run > Open Run Dialog... </strong>or<strong> Run > Open Debug Dialog... </strong> to display the Run or Debug configuration page. Create a new or select an existing Maemo Remote Application then select the Download tab. Select Mount via SBRSH in the Download Method dropdown list.</p>
-<p> </p>
-<h3>SBRSH Client Configuration Method: Automatic (screenshot from Python related project) </h3>
-<p><img src="../images/pref_images/sbrsh_download.png" alt="sbrsh download" width="871" height="616"><br>
+Select a project in the Project Explorer and select <strong>Run > Run Configurations... </strong>or<strong> Run > Debug Configurations... </strong> to display the Run or Debug configuration page. Create a new or select an existing Maemo Remote Application then select the Download tab. Select Mount via SBRSH in the Download Method dropdown list.</p>
+<h3>SBRSH Client Configuration Method: Automatic</h3>
+<p><img src="../images/pref_images/sbrsh_download.png" alt="sbrsh download" width="969" height="482"><br>
<br>
</p>
<table width="770" border="1" cellspacing="3" cellpadding="3">
@@ -39,11 +38,11 @@
<td>SBRSH configuration file and mount points are automatically created. The configuration file is created under the current project folder for each launch configuration associated with the project. The mount point is the path where the binaries will be copied and executed. Sbrsh mounts the mount point. The mount point (target binary path) will be determined by checking which SBRSH mount for the current SBRSH target has the host folder that contains the debugged program. The debugger will invoke the sbrsh command to launch the application or gdbserver on the device.</td>
</tr>
<tr>
- <td>Host PC Name or IP:</td>
+ <td>Host address:</td>
<td>Enter name or IP address of the host PC connecting the host and the device (where the physical connection may be USB, Bluetooth or IR). Default IP address is 192.168.2.14. Note that a name entered should be resolvable in the /etc/hosts file on the device.</td>
</tr>
<tr>
- <td>Target Device Name or IP:</td>
+ <td>Target address:</td>
<td>Enter name or IP address of target device. Default value is 192.168.2.15. Note that a name entered should be resolvable in the /etc/hosts file on the host.</td>
</tr>
<tr>
@@ -51,11 +50,11 @@
<td>This button allows you to view the content of the auto-generated SBRSH configuration file when a valid host name/IP and target name/IP are entered. The default location of the sbrsh configuration file is in /home/<em>USER</em>/.sbrsh) and the sbrsh executable file is assumed to be in /usr/bin/sbrsh or /home/USER/sbrsh.</td>
</tr>
</table>
-<p><img src="../images/pref_images/sbrsh_viewer.png" alt="viewer" width="537" height="550"></p>
+<p><img src="../images/pref_images/sbrsh_viewer.png" alt="viewer" width="539" height="532"></p>
<p> </p>
<p> </p>
<h3>SBRSH Client Configuration Method: Custom (screenshot from C/C++ related project) </h3>
-<p><img src="../images/pref_images/sbrsh_download_custom.png" alt="sbrsh custom" width="680" height="472"></p>
+<p><img src="../images/pref_images/sbrsh_download_custom.png" alt="sbrsh custom" width="646" height="317"></p>
<p> </p>
<table width="770" border="1" cellspacing="3" cellpadding="3">
<caption>
@@ -87,6 +86,6 @@
</tr>
</table>
<p> </p>
-<p><img src="../images/pref_images/sbrsh_edit.png" alt="edit dialog" width="732" height="772"></p>
+<p><img src="../images/pref_images/sbrsh_edit.png" alt="edit dialog" width="738" height="754"></p>
</body>
</html>
More information about the Esbox-commits
mailing list