[Esbox-commits] r1190 - in branches/work_Ed/org.maemo.esbox.help: . html html/concepts html/context_help html/images html/reference html/tasks
eswartz at garage.maemo.org
eswartz at garage.maemo.org
Tue Feb 3 23:29:58 EET 2009
Author: eswartz
Date: 2009-02-03 23:29:58 +0200 (Tue, 03 Feb 2009)
New Revision: 1190
Added:
branches/work_Ed/org.maemo.esbox.help/html/images/ImportPackageConfig.png
branches/work_Ed/org.maemo.esbox.help/html/images/ImportPackageConfig2.png
branches/work_Ed/org.maemo.esbox.help/html/images/ImportPackageConfig3.png
branches/work_Ed/org.maemo.esbox.help/html/images/ImportPackageConvert.png
branches/work_Ed/org.maemo.esbox.help/html/images/ImportPackageFetch0.png
branches/work_Ed/org.maemo.esbox.help/html/images/ImportPackageFetch1.png
branches/work_Ed/org.maemo.esbox.help/html/images/ImportPackageProject.png
branches/work_Ed/org.maemo.esbox.help/html/images/ImportPackageSelect.png
branches/work_Ed/org.maemo.esbox.help/html/images/ImportPackageWizard.png
branches/work_Ed/org.maemo.esbox.help/html/tasks/ImportDebianPackage.html
Modified:
branches/work_Ed/org.maemo.esbox.help/html/concepts/DebianPackage.html
branches/work_Ed/org.maemo.esbox.help/html/context_help/esbox_dialogs_help.xml
branches/work_Ed/org.maemo.esbox.help/html/reference/FAQ.html
branches/work_Ed/org.maemo.esbox.help/html/tasks/validatepackages.html
branches/work_Ed/org.maemo.esbox.help/html/toc.html
branches/work_Ed/org.maemo.esbox.help/toctasks.xml
Log:
Update FAQ, update docs for validating installed packages, and add docs for Import Projects from Debian Repository feature
Modified: branches/work_Ed/org.maemo.esbox.help/html/concepts/DebianPackage.html
===================================================================
--- branches/work_Ed/org.maemo.esbox.help/html/concepts/DebianPackage.html 2009-02-02 19:07:17 UTC (rev 1189)
+++ branches/work_Ed/org.maemo.esbox.help/html/concepts/DebianPackage.html 2009-02-03 21:29:58 UTC (rev 1190)
@@ -35,6 +35,7 @@
<h3>Related Topic</h3>
<ul>
<li><a href="../tasks/DebianPackage.html">Creating Debian Package</a></li>
+ <li><a href="../tasks/validatepackages.html">Validating and Installing Packages</a></li>
</ul>
</body>
</html>
\ No newline at end of file
Modified: branches/work_Ed/org.maemo.esbox.help/html/context_help/esbox_dialogs_help.xml
===================================================================
--- branches/work_Ed/org.maemo.esbox.help/html/context_help/esbox_dialogs_help.xml 2009-02-02 19:07:17 UTC (rev 1189)
+++ branches/work_Ed/org.maemo.esbox.help/html/context_help/esbox_dialogs_help.xml 2009-02-03 21:29:58 UTC (rev 1190)
@@ -94,9 +94,13 @@
<!-- PLUGIN: org.maemo.mica.linux.packages.ui -->
<!-- Project > Validate Installed Packages => wizard -->
<context id="wizard_validate_packages" >
- <description>Select projects to validate installed packages</description>
+ <description>Validate installed packages for projects</description>
<topic label="Validate Installed Packages" href="html/tasks/validatepackages.html" />
</context>
+ <context id="wizard_import_project_packages" title="About Importing Packages">
+ <description>Import projects from "apt" packages from a Debian repository</description>
+ <topic label="Import Projects from Debian Repository" href="html/tasks/ImportDebianPackage.html" />
+ </context>
<!-- PLUGIN: org.maemo.mica.common.ui -->
<!-- Global preference => Maemo -->
@@ -132,4 +136,4 @@
<!-- <context id="download_method_selection_dialog" > -->
-</contexts>
\ No newline at end of file
+</contexts>
Added: branches/work_Ed/org.maemo.esbox.help/html/images/ImportPackageConfig.png
===================================================================
(Binary files differ)
Property changes on: branches/work_Ed/org.maemo.esbox.help/html/images/ImportPackageConfig.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: branches/work_Ed/org.maemo.esbox.help/html/images/ImportPackageConfig2.png
===================================================================
(Binary files differ)
Property changes on: branches/work_Ed/org.maemo.esbox.help/html/images/ImportPackageConfig2.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: branches/work_Ed/org.maemo.esbox.help/html/images/ImportPackageConfig3.png
===================================================================
(Binary files differ)
Property changes on: branches/work_Ed/org.maemo.esbox.help/html/images/ImportPackageConfig3.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: branches/work_Ed/org.maemo.esbox.help/html/images/ImportPackageConvert.png
===================================================================
(Binary files differ)
Property changes on: branches/work_Ed/org.maemo.esbox.help/html/images/ImportPackageConvert.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: branches/work_Ed/org.maemo.esbox.help/html/images/ImportPackageFetch0.png
===================================================================
(Binary files differ)
Property changes on: branches/work_Ed/org.maemo.esbox.help/html/images/ImportPackageFetch0.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: branches/work_Ed/org.maemo.esbox.help/html/images/ImportPackageFetch1.png
===================================================================
(Binary files differ)
Property changes on: branches/work_Ed/org.maemo.esbox.help/html/images/ImportPackageFetch1.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: branches/work_Ed/org.maemo.esbox.help/html/images/ImportPackageProject.png
===================================================================
(Binary files differ)
Property changes on: branches/work_Ed/org.maemo.esbox.help/html/images/ImportPackageProject.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: branches/work_Ed/org.maemo.esbox.help/html/images/ImportPackageSelect.png
===================================================================
(Binary files differ)
Property changes on: branches/work_Ed/org.maemo.esbox.help/html/images/ImportPackageSelect.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: branches/work_Ed/org.maemo.esbox.help/html/images/ImportPackageWizard.png
===================================================================
(Binary files differ)
Property changes on: branches/work_Ed/org.maemo.esbox.help/html/images/ImportPackageWizard.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Modified: branches/work_Ed/org.maemo.esbox.help/html/reference/FAQ.html
===================================================================
--- branches/work_Ed/org.maemo.esbox.help/html/reference/FAQ.html 2009-02-02 19:07:17 UTC (rev 1189)
+++ branches/work_Ed/org.maemo.esbox.help/html/reference/FAQ.html 2009-02-03 21:29:58 UTC (rev 1190)
@@ -19,11 +19,11 @@
<h4>General questions:</h4>
<p></p>
<ul>
- <li><a href="#what">What is the ESbox?</a></li>
- <li><a href="#licensed">How is the ESbox licensed?</a></li>
+ <li><a href="#what">What is ESbox?</a></li>
+ <li><a href="#licensed">How is ESbox licensed?</a></li>
<li><a href="#organized">How is the ESbox Project organized?</a></li>
<li><a href="#releases">How do I find out about future releases of the ESbox?</a></li>
- <li><a href="#support">Which operating systems does the ESbox support?</a></li>
+ <li><a href="#support">Which operating systems does ESbox support?</a></li>
<li><a href="#ask">How do I ask questions?</li>
<li><a href="#bug">How do I report a bug or request a feature?</a></li>
</ul>
@@ -48,23 +48,29 @@
<h2>General questions:</h2>
<div class="h3" id="what" title="what">
-<h3>What is the ESbox?</h3>
+<h3>What is ESbox?</h3>
<p>
-ESbox is an extension of the CDT plug-in, strongly integrated with Scratchbox,
-reducing time and effort for configuration, and increasing the productivity for
+ESbox is an Eclipse product for developing applications and libraries
+on the Maemo software platform.
+</p>
+<p>
+ESbox is strongly integrated with Scratchbox,
+reducing time and effort for configuration and increasing the productivity for
Linux-based embedded systems development. It supports C/C++ and Python programming
-languages. Maemo 4.x SDKs will be supported.
-
-<p>ESbox offers a middle layer between Scratchbox and the programmer, which eliminates the use of command line and archaic text editors.</p>
-
+languages. Maemo 4.x and future SDKs will be supported.
+</p>
+<p>
+ESbox also supports deploying, running, and debugging applications and
+libraries on the Nokia Internet Tablet.
+</p>
</div>
<![CDATA[-----------------------------------------------------------]]>
<div class="h3" id="licensed" title="licensed">
-<h3>How is the ESbox licensed?</h3>
+<h3>How is ESbox licensed?</h3>
<p>
This software is produced by the ESbox team combined with third party
@@ -81,14 +87,37 @@
<h3>How is the ESbox Project organized?</h3>
<p>
-Both Eclipse and Scratchbox run over
-Linux. ESbox has two modules: the framework, which calls Scratchbox services and
-manipulate the streams of the processes properly; and the plug-in, which changes data
-with framework, requests Scratchbox services, displays information from Scratchbox
-to the programmer and implements features for helping editing, launching and
-debugging. Tools which use Scratchbox, like Maemo, can also be plugged into ESbox.
-</p>
-<p></p>
+ESbox consists of three major layers:
+
+<ul>
+<li>Eclipse platform </li>
+
+<blockquote>
+A popular and extensible framework for developing IDEs. See <a href="http://www.eclipse.org">the eclipse.org website</a>.
+</blockquote>
+
+<li>Maemo IDE Common Architecture</li>
+<blockquote>
+A plugin framework supporting both the ESbox and PluThon products, which provides
+an extensible platform for Maemo development:
+<ul>
+<li>Unified project model, with C/C++ and Python implementations</li>
+<li>Linux development (e.g. Debian packaging)</li>
+<li>SSH, SBRSH, and RSE support for connecting with Maemo devices</li>
+<li>and more! See <a href="https://garage.maemo.org/projects/mica/">the Mica project website</a>
+for more information.</li>
+</ul>
+</blockquote>
+
+<li>ESbox product</li>
+<blockquote>
+A targeted set of product plugins, providing the top-level project and import
+wizards, this help, graphics, and user interface modifications giving ESbox its
+unique feel as a product.
+</blockquote>
+
+</ul>
+
</div>
<![CDATA[-----------------------------------------------------------]]>
@@ -99,7 +128,7 @@
<p>
To find out about futures releases see:
-<a href="https://garage.maemo.org/forum/forum.php?forum_id=2291">Futures releases</a>
+<a href="https://garage.maemo.org/news/?group_id=192">ESbox News</a>
</p>
</div>
@@ -111,11 +140,20 @@
<h3>Which operating systems does ESbox support?</h3>
<p>
-The ESbox plug-in runs on the Linux open source operating system. Linux is open source
-software, which is freely available; however, the full distribution of Linux
-along with technical support and training are available for a fee from vendors
-such as Red Hat Software and Caldera. Due to its stability, Linux has gained
-popularity with ISPs as the OS for hosting Web servers.</p>
+The ESbox product runs on Linux (32 or 64 bit), Windows XP/Vista, and Mac OS X.
+</p>
+<p>
+The underlying Scratchbox, on the other hand, only runs on Linux/i386. To support
+non-Linux hosts, ESbox can communicate with a virtual machine hosting the Maemo SDK.
+(Currently these are available through links on the
+<a href="https://garage.maemo.org/plugins/wiki/index.php?ESboxOutsideLinuxWithVirtualMachine&id=192&type=g">
+Preleases wiki page</a>.)
+</p>
+<p>ESbox, though Mica, operates essentially the same way regardless of which host you're
+running on. A limitation, though, is that your projects or workspace must be visible
+to both Scratchbox and the host. When Scratchbox is running on a virtual machine,
+we support this via Samba sharing from the host to the VM.
+</p>
</div>
@@ -125,7 +163,7 @@
<h3>How do I ask questions?</h3>
<p>
-The <a href="https://garage.maemo.org/">garage.maemo</a> website provides some mailing
+The <a href="https://garage.maemo.org/">garage.maemo.org</a> website provides some mailing
<a href="https://garage.maemo.org/mail/?group_id=192">lists</a>. Choose a list
to browse, search, and post messages. Keep in mind that these newsgroups are public,
so do not include any confidential information in your questions. You should
@@ -143,12 +181,16 @@
<h3>How do I report a bug or request a feature?</h3>
<p>
+The bug and feature trackers are stored at the
+<a href="https://garage.maemo.org/tracker/?group_id=192">ESbox project page</a>.
+</p>
+<p>
Before entering a bug report, you should search to see if someone else
has already entered a bug report similar to yours. If you find a bug report
that outlines the problem you are seeing, you can simply annotate it with your
comments to let the developers know that you have also hit the bug. Also you
-can add yourself to the <a href="https://garage.maemo.org/tracker/?func=browse&group_id=192&atid=1420">ESbox list</a>
-of the bug so that you will be notified when the status of the bug changes or
+can add yourself to the "Monitor" list of the bug so that you will be notified
+when the status of the bug changes or
someone adds comments.</p>
@@ -162,29 +204,38 @@
<![CDATA[-----------------------------------------------------------]]>
<div class="h3" id="howtos" title="howtos">
-<h3>Are there complete HowTos for setting up the ESbox?</h3>
+<h3>Are there complete HowTos for setting up ESbox?</h3>
+<p>
+ESbox itself is fully packaged and ready to run. You only need to unzip it somewhere
+and run the "ESbox" executable inside.
+</p>
<p>
-Yes. Integration information is supplied here <a href="http://maemo.org/development/documentation/ide_integration/">http://maemo.org/development/documentation/ide_integration/</a>.</p>
+Setting up the Scratchbox and Maemo SDKs is still a bit of a manual effort, though,
+if you do not use a virtual machine.
+See <a href="http://maemovmware.garage.maemo.org/">the Maemo VMware Appliance</a>
+site for a convenient image with everything (Linux, Scratchbox, Maemo SDKs, and ESbox) installed .
+</p>
+<p>
+Full integration information is supplied here <a href="http://maemo.org/development/documentation/ide_integration/">http://maemo.org/development/documentation/ide_integration/</a>.
+</p>
<h3>Which ESbox build should I download? </h3>
+<p>Download one of the 2.0.0 product builds for your operating system from
+<a href="https://garage.maemo.org/frs/?group_id=192">the ESbox Files section</a>.
+
+This will provide a full Eclipse environment with Eclipse, Mica, and ESbox.
+</p>
+
+<b>Manual installation</b>
+
<p>
-First of all to use the ESbox plugin, you need:
-<ul>
- <li>Linux with SSH Client</li>
- <li>Maemo SDK</li>
- <li>Sun version of Java</li>
- <li>Eclipse SDK 3.3.1.1</li>
- <li>Eclipse CDT 4.0.2</li>
- <li>PyDev >= 1.3.7</li>
- <li>Python interpreter configured</li>
- <li>Sbrsh (Scratchbox Remote Shell)</li>
-</ul>
+If you want to add ESbox features to your existing Ganymede installation, see the
+<a href="http://esbox.garage.maemo.org/esbox_installation.html">
+instructions</a> for installing from the ESbox update site.
</p>
-<p>With everything set up, you are able to get the latest version of the ESbox plugin.</p>
-
<div class="h3" id="uninstall" title="uninstall">
<h3>How do I uninstall ESbox?</h3>
Added: branches/work_Ed/org.maemo.esbox.help/html/tasks/ImportDebianPackage.html
===================================================================
--- branches/work_Ed/org.maemo.esbox.help/html/tasks/ImportDebianPackage.html (rev 0)
+++ branches/work_Ed/org.maemo.esbox.help/html/tasks/ImportDebianPackage.html 2009-02-03 21:29:58 UTC (rev 1190)
@@ -0,0 +1,237 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+ <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=windows-1252">
+ <TITLE>Validate Installed Packages</TITLE>
+ <META NAME="GENERATOR" CONTENT="OpenOffice.org 2.3 (Win32)">
+ <META NAME="CREATED" CONTENT="0;0">
+ <META NAME="CHANGEDBY" CONTENT="Ed Swartz">
+ <META NAME="CHANGED" CONTENT="20090203;15073630">
+ <META NAME="copyright" CONTENT="Copyright (c) INdT 2007-2008. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page.">
+ <META NAME="CHANGEDBY" CONTENT="Ed Swartz">
+ <META NAME="CHANGEDBY" CONTENT="Ed Swartz">
+ <META NAME="CHANGEDBY" CONTENT="Ed Swartz">
+ <STYLE TYPE="text/css">
+ <!--
+ @page { size: 8.5in 11in }
+ P { color: #000000; font-family: "Arial", sans-serif; font-size: 10pt }
+ H2 { color: #000000; font-family: "Arial", sans-serif; font-size: 14pt }
+ H3 { color: #000000; font-family: "Arial", sans-serif; font-size: 11pt }
+ H2.style1 { font-family: "Arial", sans-serif; font-size: 14pt }
+ A:link { color: #006699 }
+ -->
+ </STYLE>
+</HEAD>
+<BODY LANG="en-US" TEXT="#000000" LINK="#006699" BGCOLOR="#ffffff" DIR="LTR">
+<H2 CLASS="style1">Importing Projects from Debian Repositories</H2>
+<P>With ESbox you can choose a <FONT FACE="Arial, sans-serif"><FONT SIZE=2><SPAN LANG="en-US"><SPAN STYLE="font-weight: medium">package
+from a scratchbox rootstraps and import its sources as an ESbox
+project. The project can be built using standard Debian build
+commands and repackaged.</SPAN></SPAN></FONT></FONT></P>
+<H3>Background
+</H3>
+<P>This feature assumes you know a little bit about the workings of
+Debian packages. If not, the full details are here, in the “The
+Debian GNU/Linux FAQ; Chapter 7 - Basics of the Debian package
+management system“:
+</P>
+<P><<A HREF="http://www.debian.org/doc/FAQ/ch-pkg_basics.en.html">http://www.debian.org/doc/FAQ/ch-pkg_basics.en.html</A>></P>
+<P>And a more concise explanation follows.</P>
+<H3 STYLE="font-weight: medium">Repositories and package types</H3>
+<P>In the Debian package manager “apt” (used in
+scratchbox and Maemo devices), the <B>sources.list </B><SPAN STYLE="font-weight: medium">repository
+configuration files contain two kinds of entries: “deb”
+and “deb-src” repositories. Both point to external or
+local repositories of packages (called </SPAN><I><SPAN STYLE="font-weight: medium">system
+packages </SPAN></I><SPAN STYLE="font-style: normal"><SPAN STYLE="font-weight: medium">here).
+“deb” repositories point to binary packages while
+“deb-src” repositories point to the (usually in sync)
+source packages for those binary packages.</SPAN></SPAN></P>
+<P STYLE="font-style: normal; font-weight: medium">One source package
+may generate several binary packages; for instance, one for programs
+and primary data, one for auxiliary data, one for libraries, and one
+for development.
+</P>
+<P><SPAN STYLE="font-style: normal"><SPAN STYLE="font-weight: medium">In
+“apt”, when fetching the sources for a binary package,
+you start with an interesting binary package and find its
+corresponding source package (e.g. “</SPAN></SPAN><FONT FACE="Courier New, monospace"><SPAN STYLE="font-style: normal"><SPAN STYLE="font-weight: medium">apt-get
+source <package></SPAN></SPAN></FONT>”<SPAN STYLE="font-style: normal"><SPAN STYLE="font-weight: medium">).
+</SPAN></SPAN>
+</P>
+<H3 STYLE="font-style: normal; font-weight: medium">Source package
+structure</H3>
+<P><SPAN STYLE="font-style: normal"><SPAN STYLE="font-weight: medium">The
+sources for a package come usually in three files: a </SPAN></SPAN><SPAN STYLE="font-style: normal"><B>control
+file </B></SPAN><SPAN STYLE="font-style: normal"><SPAN STYLE="font-weight: medium">(*.dsc),
+an </SPAN></SPAN><SPAN STYLE="font-style: normal"><B>archive
+</B></SPAN><SPAN STYLE="font-style: normal"><SPAN STYLE="font-weight: medium">(*.tar.gz
+or *.tar.bz2), and </SPAN></SPAN><SPAN STYLE="font-style: normal"><B>a
+patch </B></SPAN><SPAN STYLE="font-style: normal"><SPAN STYLE="font-weight: medium">(*.diff.gz).
+“apt-get source” will invoke “dpkg-source” to
+expand the archive and apply the patch. The control file is used when
+rebuilding the binary package.</SPAN></SPAN></P>
+<P STYLE="font-style: normal; font-weight: medium">Once extracted,
+the contents of the original patched sources vary wildly. The
+contents may contain a bare-bones Makefile project, an
+autotools-based project, a nest of programs and libraries and test
+code, or even another archive.
+</P>
+<P><SPAN STYLE="font-style: normal"><SPAN STYLE="font-weight: medium">There
+is one guarantee, though: the package will expand to contain a </SPAN></SPAN><SPAN STYLE="font-style: normal"><B>debian
+</B></SPAN><SPAN STYLE="font-style: normal"><SPAN STYLE="font-weight: medium">directory
+and its various control files (see the “Source packages”
+chapter of the “Debian Policy Manual” at
+<A HREF="http://www.debian.org/doc/debian-policy/ch-source.html">http://www.debian.org/doc/debian-policy/ch-source.html</A>
+for more details).</SPAN></SPAN></P>
+<P><SPAN STYLE="font-style: normal"><SPAN STYLE="font-weight: medium">The
+</SPAN></SPAN><SPAN STYLE="font-style: normal"><B>debian/rules </B></SPAN><SPAN STYLE="font-style: normal"><SPAN STYLE="font-weight: medium">file
+is an executable Makefile which is the primary means of interaction
+with the source from the perspective of a Debian package. In other
+words, even if the extracted sources contain autoconf files or
+Makefiles, you should use </SPAN></SPAN><SPAN STYLE="font-style: normal"><B>debian/rules</B></SPAN>
+<SPAN STYLE="font-style: normal"><SPAN STYLE="font-weight: medium">to
+configure, build, clean, install, and re-package the package.</SPAN></SPAN></P>
+<P STYLE="font-style: normal; font-weight: medium">For example,
+“debian/rules configure”, “debian/rules build”,
+“debian/rules install” are typical ways to use a source
+package.</P>
+<P><SPAN STYLE="font-style: normal"><SPAN STYLE="font-weight: medium">It
+should be mentioned that even </SPAN></SPAN><SPAN STYLE="font-style: normal"><B>debian/rules
+</B></SPAN><SPAN STYLE="font-style: normal"><SPAN STYLE="font-weight: medium">can
+have varying degrees of fluctuation in the targets it provides. Most
+packages not developed in the Debian project itself come from a large
+community of people who think differently, and the targets will vary
+accordingly. While the utility “dh_make” tries to promote
+a standard set of guidelines, some projects may, for instance, lack a
+“configure” target (or have several), lack a “build”
+target (or have several), etc.</SPAN></SPAN></P>
+<P STYLE="font-style: normal; font-weight: medium">ESbox attempts to
+corral this kind of diversity in its import wizard.</P>
+<H3>Using the Wizard</H3>
+<OL>
+ <LI><P>Find the wizard under <B>File > Import > ESbox >
+ Project from Debian Repository.</B></P>
+ <P><IMG SRC="../images/ImportPackageWizard.png" NAME="graphics8" ALIGN=LEFT BORDER=0>
+ <br clear=left>Select
+ the package to import.</P>
+ <P><IMG SRC="../images/ImportPackageSelect.png" NAME="graphics9" ALIGN=LEFT BORDER=0><BR CLEAR=LEFT>The
+ target providing packages will be one of the Scratchbox targets on
+ the build machine.
+ </P>
+ <UL>
+ <LI><P><B>NOTE: </B>This page assumes the target has the necessary
+ “deb-src” entries in <B>sources.list</B><SPAN STYLE="font-weight: medium">.
+ Standard Maemo SDKs have such entries.</SPAN></P>
+ <LI><P>The package selector shows a tree of packages organized by
+ category. You can search by typing in the filter (for words in the
+ name or description) or typing in the tree (for the name alone).</P>
+ <LI><P>The “Fetch build dependencies” option ensures
+ that, in addition to fetching the source for the selected package,
+ any packages needed to build the source will be installed as well.</P>
+ <LI><P>The “Always re-fetch source components” option
+ will ask the wizard to always go to the network and find the source
+ components (the .dsc file, archives, and patches) for the package.
+ This may be necessary if you've modified the package locally.</P>
+ <LI><P>The “D<FONT FACE="Arial, sans-serif"><FONT SIZE=2><SPAN LANG="en-US">elete
+ source components” option deletes the .dsc file, source
+ archives, and patches after extraction.</SPAN></FONT></FONT></P>
+ </UL>
+ <LI><P>The next page prepares for the source fetch.
+ </P>
+ <P><IMG SRC="../images/ImportPackageFetch0.png" NAME="graphics10" ALIGN=LEFT BORDER=0><BR CLEAR=LEFT>Visit
+ the link to ensure your proxy is configured, or else the download
+ will not work.</P>
+ <P>Hit Next to start the process.</P>
+ <P><IMG SRC="../images/ImportPackageFetch1.png" NAME="graphics11" ALIGN=LEFT BORDER=0><BR CLEAR=LEFT><B>HINT</B><SPAN STYLE="font-weight: medium">:
+ if the fetch fails – usually indicated by a long pause after
+ “Building dependency tree”, hit Cancel to abort the
+ process. You can select “View Log” from the dialog, hit
+ Back, then hit Next again to retry.</SPAN></P>
+ <LI><P STYLE="font-weight: medium">The next page lets you deal with
+ packages that do not have the expected source layout (the archived
+ packages mentioned above). This page allows you to preconfigure the
+ project so you can (hopefully) extract the sources and decide
+ whether the project is really the one you're looking for.
+ </P>
+ <P STYLE="font-weight: medium">This is a normal case:</P>
+ <P STYLE="font-weight: medium"><IMG SRC="../images/ImportPackageConfig.png" NAME="graphics12" ALIGN=LEFT BORDER=0><BR CLEAR=LEFT>Here,
+ the project (<B>sysstat </B>from earlier pages) expands into a
+ project with a Makefile. Also (off-screen) there are C sources and
+ headers. Thus, the wizard is able to guess the project type. This
+ page, then, is merely informative and you can hit Next.</P>
+ <P STYLE="font-weight: medium">The following screenshot shows the
+ inimitable bash shell, however, which is packaged as an archive.</P>
+ <P STYLE="font-weight: medium"><IMG SRC="../images/ImportPackageConfig2.png" NAME="graphics13" ALIGN=LEFT BORDER=0><BR CLEAR=LEFT>To
+ handle this case, select a build rule which appears to be a
+ configuration rule and select “Setup project...” to
+ build it. Build results go to the Console under the wizard.
+ </P>
+ <P STYLE="font-weight: medium"><B>NOTE: </B>For bash, this
+ “configure” step actually proceeds to build the entire
+ program and run its tests – you may Cancel after the archive
+ has been extracted and the patches have been applied, then proceed
+ with the wizard.</P>
+ <P STYLE="font-weight: medium">This shows the results after running
+ (and canceling) the “bash-configure” build:</P>
+ <IMG SRC="../images/ImportPackageConfig3.png" NAME="graphics14" ALIGN=LEFT BORDER=0><BR CLEAR=LEFT>
+ <li><p>The
+ last page lets you convert the project from a generic one into one
+ that ESbox can build:</P>
+ <P><IMG SRC="../images/ImportPackageConvert.png" NAME="graphics15" ALIGN=LEFT BORDER=0><BR CLEAR=LEFT>In
+ this page, select the targets from <B>debian/rules </B><SPAN STYLE="font-weight: medium">which
+ will handle the various kinds of build steps. This page shows the
+ same settings available under </SPAN><B>Project > Properties >
+ C/C++ Build Settings</B><SPAN STYLE="font-weight: medium">. Any of
+ them may be left blank to fall back to the behavior for normal ESbox
+ projects.</SPAN></P>
+ <UL>
+ <LI><P>“<SPAN STYLE="font-weight: medium">Configure build
+ rule” is used when switching targets and/or running </SPAN><B>Project
+ > Build Application > Generate Configure</B><SPAN STYLE="font-weight: medium">.
+ It resets the project to a state where it can be rebuilt from
+ scratch for a new target or with a new configuration. In a Debian
+ package, this is done through </SPAN><B>debian/rules </B><SPAN STYLE="font-weight: medium">instead
+ of through </SPAN><B>autoconf </B><SPAN STYLE="font-weight: medium">or
+ the like. </SPAN>
+ </P>
+ <P><SPAN STYLE="font-weight: medium">You </SPAN><I><SPAN STYLE="font-weight: medium">may
+ </SPAN></I><SPAN STYLE="font-style: normal"><SPAN STYLE="font-weight: medium">leave
+ this blank if the rules provide no useful default, or if you want
+ to take control of the configuration yourself, but ESbox will fall
+ back to launching </SPAN></SPAN><SPAN STYLE="font-style: normal"><B>autogen.sh
+ </B></SPAN><SPAN STYLE="font-style: normal"><SPAN STYLE="font-weight: medium">or
+ </SPAN></SPAN><SPAN STYLE="font-style: normal"><B>autoconf </B></SPAN><SPAN STYLE="font-style: normal"><SPAN STYLE="font-weight: medium">(if
+ available). But the wizard will warn you that this isn't the intent
+ of the package maintainers. (In fact, in some projects, like “apt”
+ itself, directly running </SPAN></SPAN><SPAN STYLE="font-style: normal"><B>configure</B></SPAN>
+ <SPAN STYLE="font-style: normal"><SPAN STYLE="font-weight: medium">will
+ lead to an infinitely recursing Makefile!)</SPAN></SPAN></P>
+ <LI><P>“Incremental/full build rule” is used in the
+ case where you build a project with <B>Project > Build Project</B><SPAN STYLE="font-weight: medium">,
+ or on a build-before-launch.</SPAN></P>
+ <LI><P>“<SPAN STYLE="font-weight: medium">Auto build rule”
+ is used when </SPAN><B>Project > Build Automatically </B><SPAN STYLE="font-weight: medium">is
+ enabled and you save a resource in the project. The C/C++ Build
+ Settings must be configured to allows automatic builds, though. </SPAN>
+ </P>
+ <LI><P>“<SPAN STYLE="font-weight: medium">Clean build rule”
+ is used when cleaning projects with </SPAN><B>Project > Clean.</B></P>
+ </UL>
+</OL>
+<H3>Using Debian source projects</H3>
+<P>Projects imported from Debian packages can be edited, navigated,
+build, and launched like normal ESbox projects. You can, of course,
+recreate Debian packages from them too.</P>
+<P>The only difference is, build and configure commands will use
+<B>debian/rules </B><SPAN STYLE="font-weight: medium">to do their
+work instead of directly invoking autoconf or make. If you wish to
+“de-Debianize” a project, edit </SPAN><B>Project >
+Properties > C/C++ Build Settings </B><SPAN STYLE="font-weight: medium">and
+check “Use default” for the “Build Command”.
+</SPAN>
+</P>
+<P><BR><BR>
+</P>
+</BODY>
+</HTML>
\ No newline at end of file
Modified: branches/work_Ed/org.maemo.esbox.help/html/tasks/validatepackages.html
===================================================================
--- branches/work_Ed/org.maemo.esbox.help/html/tasks/validatepackages.html 2009-02-02 19:07:17 UTC (rev 1189)
+++ branches/work_Ed/org.maemo.esbox.help/html/tasks/validatepackages.html 2009-02-03 21:29:58 UTC (rev 1190)
@@ -17,7 +17,13 @@
<h2 class="style1">Validate Installed Packages</h2>
-<p>The Validate Installed Packages wizard allows you to configure multiple projects at once and select which targets to update (including devices behind RSE connections). Repositories can also be added. To set up new repositories on a tablet, it will need root access. Root access is not needed for scratchbox.</p>
+<p>The Validate Installed Packages wizard is a useful tool for ensuring your rootstraps and Maemo devices
+have all the necessary software to support building, debugging, and launching your application.
+</p>
+<p>You may configure multiple projects at once and select which targets to update.
+Repositories like Maemo Extras will be automatically added as needed.</p>
+<p><b>NOTE:</b> to install software to a Nokia Internet Tablet, you will need root access.
+Root access is not needed for Scratchbox targets.</p>
<p>To validate installed packages:</p>
<ol>
<li>Select a project in Project Explorer and select <strong>Project > Validate Installed Packages</strong> to start the wizard.</li>
Modified: branches/work_Ed/org.maemo.esbox.help/html/toc.html
===================================================================
--- branches/work_Ed/org.maemo.esbox.help/html/toc.html 2009-02-02 19:07:17 UTC (rev 1189)
+++ branches/work_Ed/org.maemo.esbox.help/html/toc.html 2009-02-03 21:29:58 UTC (rev 1190)
@@ -53,9 +53,11 @@
<h3>Tasks</h3>
<ul>
<li><a href="tasks/CreateMakeTarget.html">Creating a Make Target</a></li>
+ <li><a href="tasks/validatepackages.html">Validating Build and Runtime Environment</a></li>
+ <li><a href="tasks/ImportDebianPackage.html">Importing Projects from a Debian Repository</a></li>
+ <li><a href="tasks/DebianPackage.html">Debian Package Management</a></li>
<li><a href="tasks/CreateNewTarget.html">Creating a New Target</a></li>
<li><a href="tasks/CreateOprofileconfig.html">Creating a OProfile Launch Configuration</a></li>
- <li><a href="tasks/DebianPackage.html">Debian Package Management</a></li>
</ul>
<p></p>
</body>
Modified: branches/work_Ed/org.maemo.esbox.help/toctasks.xml
===================================================================
--- branches/work_Ed/org.maemo.esbox.help/toctasks.xml 2009-02-02 19:07:17 UTC (rev 1189)
+++ branches/work_Ed/org.maemo.esbox.help/toctasks.xml 2009-02-03 21:29:58 UTC (rev 1190)
@@ -2,24 +2,26 @@
<?NLS TYPE="org.eclipse.help.toc"?>
<toc label="Tasks" link_to="toc.xml#tasks">
- <topic label="Create a new Scratchbox target" href="html/gettingstarted/SettingPreferences.html#int">
- </topic>
- <topic label="Create Make Target" href="html/tasks/CreateMakeTarget.html">
+ <topic label="Validating Installed Packages" href="html/tasks/validatepackages.html">
</topic>
- <topic label="Creating a New Target" href="html/tasks/CreateNewTarget.html">
- </topic>
- <topic label="Creating a OProfile Launch Configuration" href="html/tasks/CreateOprofileconfig.html">
- </topic>
<topic label="Local Launching" href="html/concepts/LocalLaunching.html">
</topic>
<topic label="Remote Launching" href="html/concepts/RemoteLaunching.html">
</topic>
+ <topic label="Importing Projects from Debian Repositories" href="html/tasks/ImportDebianPackage.html">
+ </topic>
<topic label="Debian Package Management" href="html/tasks/DebianPackage.html">
</topic>
- <topic label="Profiling Maemo Applications" href="html/tasks/ProfilingMaemoApplications.html">
+ <topic label="Create Make Target" href="html/tasks/CreateMakeTarget.html">
</topic>
<topic label="Extracting Strings" href="html/tasks/ExternalizeString.html">
</topic>
- <topic label="Validating Installed Packages" href="html/tasks/validatepackages.html">
+ <topic label="Create a new Scratchbox target" href="html/gettingstarted/SettingPreferences.html#int">
+ </topic>
+ <topic label="Creating a New Target" href="html/tasks/CreateNewTarget.html">
</topic>
+ <topic label="Profiling Maemo Applications" href="html/tasks/ProfilingMaemoApplications.html">
+ </topic>
+ <topic label="Creating a OProfile Launch Configuration" href="html/tasks/CreateOprofileconfig.html">
+ </topic>
</toc>
More information about the Esbox-commits
mailing list