summaryrefslogtreecommitdiff
path: root/README
authormickeyl <mickeyl>2003-12-09 23:11:46 (UTC)
committer mickeyl <mickeyl>2003-12-09 23:11:46 (UTC)
commita18b79ad644cfc1a48a87b7d0d06266737d21cbf (patch) (side-by-side diff)
tree44d9e2449048ee3978d575fba22059cca77f497a /README
parentb2dc1cd012f2426b3ffa5b29879cf1760cfbc2e6 (diff)
downloadopie-a18b79ad644cfc1a48a87b7d0d06266737d21cbf.zip
opie-a18b79ad644cfc1a48a87b7d0d06266737d21cbf.tar.gz
opie-a18b79ad644cfc1a48a87b7d0d06266737d21cbf.tar.bz2
improve wording and correct facts
Diffstat (limited to 'README') (more/less context) (ignore whitespace changes)
-rw-r--r--README81
1 files changed, 23 insertions, 58 deletions
diff --git a/README b/README
index 2d04968..f1788b2 100644
--- a/README
+++ b/README
@@ -1,80 +1,49 @@
-1. How to use the new build system
-===============================
-There's a great document at:
-
+1. How to use the Opie build system
+====================================
+There's a tutorial document at:
http://www.uv-ac.de/opiedev/opiedev.html
-and the API is at:
+The API reference currently is at:
http://handhelds.org/~zecke/apidocs/index.html
-
-You will need qvfb, designer, and uic from a qt-x11-2.3.2 package.
+You will need qvfb, uic and
+(if you want to develop applications) designer
+compiled and linked against qt-x11.
That means you must download and configure/make it.
wget ftp://ftp.trolltech.com/qt/source/qt-x11-2.3.2.tar.gz
-
+(Alternatively, you can get static binaries from http://www.vanille.de/tools)
The recommended version of Qt embedded is qt-embedded-2.3.7
You can get it from:
ftp://ftp.trolltech.com/qt/source/qt-embedded-2.3.7.tar.bz2
-Other version will found in that directory.
-
Set QTDIR to point to your qt/embedded source tree, such as:
-
export QTDIR=/opt/qt-2.3.7
-Then you need to do
+You need to do set the OPIEDIR environment variable:
export OPIEDIR=`pwd`
or
export OPIEDIR=~/projects/sources/opie
-or where ever you placed Opie sources.
+or whereever you placed the Opie sources.
-and then do:
+You need to adjust your runtime library search path,
+so that the Qt/Embedded and Opie libraries can be found:
export LD_LIBRARY_PATH=$OPIEDIR/lib:$QTDIR/lib:$LD_LIBRARY_PATH
-You will want to apply the patches in the $OPIEDIR/qt directory to qt-embedded
-*NOTE* You can skip the qte234-for-opie091-simpad.patch
-patch, unless you are compiling for simpad.
-
+You have to apply the qte<version>-all.patch to the Qt/Embedded
+sources and copy the qconfig-qpe.h file to $QTDIR/src/tools:
cd $QTDIR; cat $OPIEDIR/qt/qte<version>*.patch | patch -p0
+cp $OPIEDIR/qt/qpe-config.h $QTDIR/src/tools
+You are now ready to configure and build Qt/Embedded
-
-
-Now Qt Embedded is patched and ready to go! You are ready to configure and make qt embedded.
-
-I run this script to configure qte
-------------------- start script
-#!/bin/bash
-## this file is for easy configuring of qt embedded for Qtopia development, on x86
-
-configure_make () {
- if configure_qt; then
- make;
- else exit -1
-fi
-}
-
-configure_qt () {
- cd $QTDIR;
- echo 'yes' | ./configure -qconfig qpe -depths 4,16,24,32 -system-jpeg -system-libpng -system-zlib -no-xft -qvfb;
-
-}
-
-# default configuration of Qt embedded for Opie
-echo "Configuring Qt Embedded for Opie development....";
-if [ ! -e $QTDIR/src/tools/qconfig-qpe.h ]; then
- cp $OPIEDIR/qt/qconfig-qpe.h $QTDIR/src/tools
-fi
-
-configure_make;
-
-
-------------------- end script
+cd $QTDIR
+echo 'yes' | ./configure -qconfig qpe -depths 4,16,24,32 -system-jpeg -system-libpng -system-zlib -no-xft -qvfb
+make
Once you have these compiled, be sure to set the PATH to ensure your (cross)compiler
is available.
Then do the following in the opie source tree:
@@ -83,39 +52,35 @@ make menuconfig
Now you can move through the menu and select or deselect anything..
Exit and save the configuration and enter "make" to create opie...
Have fun with it !
-If you get into trouble there are other make's
+If you get into trouble there are other makefile targets
make clean-configs
is a useful one.
-
-Ciao, Stefan
-and ljp <lpotter@trolltech.com>
-
-
2. Used Libraries
================
The following Libraries are used in Opie.
For a successfull build you must install these librarys and headers.
The versions are known-good versions. If you successfully try newer ones,
-commit a new README or send mail to opie-devel@handhelds.org
+commit a new README or send a mail to opie-devel@handhelds.org
* libsdl 1.2
http://www.libsdl.org/download-1.2.php
* libxine 1.0 beta 11
http://prdownloads.sourceforge.net/xine/
* libpcap 0.7.2
http://www.tcpdump.org/release/
-* libetpan 0.30 + patch (in CVS)
+* libetpan 0.30 + patch (in $OPIEDIR/noncore/net/mail/libetpan)
http://prdownloads.sourceforge.net/libetpan/
* libsqlite 2.8.6
http://www.sqlite.org/download.html
+