summaryrefslogtreecommitdiff
Unidiff
Diffstat (more/less context) (ignore whitespace changes)
-rw-r--r--README9
1 files changed, 7 insertions, 2 deletions
diff --git a/README b/README
index cb7d5d4..3881652 100644
--- a/README
+++ b/README
@@ -1,86 +1,91 @@
11. How to use the Opie build system 11. How to use the Opie build system
2==================================== 2====================================
3There's a tutorial document at: 3There's a tutorial document at:
4http://www.uv-ac.de/opiedev/opiedev.html 4http://www.uv-ac.de/opiedev/opiedev.html
5 5
6The API reference currently is at: 6The API reference currently is at:
7http://handhelds.org/~zecke/apidocs/index.html 7http://handhelds.org/~zecke/apidocs/index.html
8 8
9You will need qvfb, uic and 9You will need qvfb, uic and
10(if you want to develop applications) designer 10(if you want to develop applications) designer
11compiled and linked against qt-x11. 11compiled and linked against qt-x11.
12That means you must download and configure/make it. 12That means you must download and configure/make it.
13wget ftp://ftp.trolltech.com/qt/source/qt-x11-2.3.2.tar.gz 13wget ftp://ftp.trolltech.com/qt/source/qt-x11-2.3.2.tar.gz
14(Alternatively, you can get static binaries from http://www.vanille.de/tools) 14(Alternatively, you can get static binaries from http://www.vanille.de/tools)
15 15
16The recommended version of Qt embedded is qt-embedded-2.3.7 16The recommended version of Qt embedded is qt-embedded-2.3.7
17 17
18You can get it from: 18You can get it from:
19ftp://ftp.trolltech.com/qt/source/qt-embedded-2.3.7.tar.bz2 19ftp://ftp.trolltech.com/qt/source/qt-embedded-2.3.7.tar.bz2
20 20
21Set QTDIR to point to your qt/embedded source tree, such as: 21Set QTDIR to point to your qt/embedded source tree, such as:
22export QTDIR=/opt/qt-2.3.7 22export QTDIR=/opt/qt-2.3.7
23 23
24You need to do set the OPIEDIR environment variable: 24You need to do set the OPIEDIR environment variable:
25export OPIEDIR=`pwd` 25export OPIEDIR=`pwd`
26or 26or
27export OPIEDIR=~/projects/sources/opie 27export OPIEDIR=~/projects/sources/opie
28or whereever you placed the Opie sources. 28or whereever you placed the Opie sources.
29 29
30You need to adjust your runtime library search path, 30You need to adjust your runtime library search path,
31so that the Qt/Embedded and Opie libraries can be found: 31so that the Qt/Embedded and Opie libraries can be found:
32export LD_LIBRARY_PATH=$OPIEDIR/lib:$QTDIR/lib:$LD_LIBRARY_PATH 32export LD_LIBRARY_PATH=$OPIEDIR/lib:$QTDIR/lib:$LD_LIBRARY_PATH
33 33
34You have to apply the qte<version>-all.patch to the Qt/Embedded 34You have to apply the qte<version>-all.patch to the Qt/Embedded
35sources and copy the qconfig-qpe.h file to $QTDIR/src/tools: 35sources and copy the qconfig-qpe.h file to $QTDIR/src/tools:
36cd $QTDIR; cat $OPIEDIR/qt/qte<version>*.patch | patch -p0 36cd $QTDIR; cat $OPIEDIR/qt/qte<version>*.patch | patch -p1
37cp $OPIEDIR/qt/qpe-config.h $QTDIR/src/tools 37cp $OPIEDIR/qt/qconfig-qpe.h $QTDIR/src/tools
38 38
39You are now ready to configure and build Qt/Embedded 39You are now ready to configure and build Qt/Embedded
40 40
41cd $QTDIR 41cd $QTDIR
42echo 'yes' | ./configure -qconfig qpe -depths 4,16,24,32 -system-jpeg -system-libpng -system-zlib -no-xft -qvfb 42echo 'yes' | ./configure -qconfig qpe -depths 4,16,24,32 -system-jpeg -system-libpng -system-zlib -no-xft -qvfb
43make 43make
44 44
45Note that the above command ( -qvfb ) compiles in the Virtual
46Framebuffer and is mostly meant on your host system. For cross
47compiling you will need to use the -xplatform switch but call
48./configure --help to see your options.
49
45Once you have these compiled, be sure to set the PATH to ensure your (cross)compiler 50Once you have these compiled, be sure to set the PATH to ensure your (cross)compiler
46is available. 51is available.
47 52
48Then do the following in the opie source tree: 53Then do the following in the opie source tree:
49 54
50make clean 55make clean
51make menuconfig 56make menuconfig
52 57
53Now you can move through the menu and select or deselect anything.. 58Now you can move through the menu and select or deselect anything..
54Exit and save the configuration and enter "make" to create opie... 59Exit and save the configuration and enter "make" to create opie...
55 60
56Have fun with it ! 61Have fun with it !
57 62
58If you get into trouble there are other makefile targets 63If you get into trouble there are other makefile targets
59 64
60make clean-configs 65make clean-configs
61is a useful one. 66is a useful one.
62 67
632. Used Libraries 682. Used Libraries
64================ 69================
65 70
66The following Libraries are used in Opie. 71The following Libraries are used in Opie.
67For a successful build you must install these librarys and headers. 72For a successful build you must install these librarys and headers.
68The versions are known-good versions. If you successfully try newer ones, 73The versions are known-good versions. If you successfully try newer ones,
69commit a new README or send a mail to opie-devel@handhelds.org 74commit a new README or send a mail to opie-devel@handhelds.org
70 75
71* libsdl 1.2 76* libsdl 1.2
72 http://www.libsdl.org/download-1.2.php 77 http://www.libsdl.org/download-1.2.php
73 78
74* libxine 1.0 beta 11 79* libxine 1.0 beta 11
75 http://prdownloads.sourceforge.net/xine/ 80 http://prdownloads.sourceforge.net/xine/
76 81
77* libpcap 0.7.2 82* libpcap 0.7.2
78 http://www.tcpdump.org/release/ 83 http://www.tcpdump.org/release/
79 84
80* libetpan 0.31 85* libetpan 0.31
81 http://prdownloads.sourceforge.net/libetpan/ + patch in noncore/net/mail/libetpanstuff 86 http://prdownloads.sourceforge.net/libetpan/ + patch in noncore/net/mail/libetpanstuff
82 87
83* libsqlite 2.8.6 88* libsqlite 2.8.6
84 http://www.sqlite.org/download.html 89 http://www.sqlite.org/download.html
85 90
86 91