re-import del sito, in ReST, da ritoccare parecchio

git-svn-id: svn://luxion/repos/thenautilus@331 fcb26f47-9200-0410-b104-b98ab5b095f3

1 files changed, 129 insertions, 0 deletions

diff --git a/qtopia-dev/document.en.rest.txt b/qtopia-dev/document.en.rest.txt
new file mode 100644
index 0000000..55d4231
--- /dev/null
+++ b/qtopia-dev/document.en.rest.txt
@@ -0,0 +1,129 @@
+Installing QTopia today
+=======================
+
+If you have `GCC 2.95.x`_ installed
+===================================
+
+You can just follow the instruction from `this how-to`_, and all will be good.
+
+If you have a newer version
+===========================
+
+If for example you actually do C++ development, you can't use a GCC before 3.1, as it
+would lack some fundamental components (stingstream, just to say one) and have several
+quite big bugs.
+
+Here lies the problem: the packages suggested by `the afore-mentioned how-to`_ are
+compiled using GCC 2.95.2, and since the ABI has changed radically, programs compiled
+with GCC 3.x will not link against those qt-embedded libraries.
+
+So we just install GCC 2.95.2, right? **Wrong!** GCC 2.95.2 has a bug in the libio
+library (basis for C++ streams) which makes it impossible to compile it against glibc
+2.2 (and since you have an up-to-date GCC, I'm sure you'll have an up-to-date glibc,
+too) (the type for file offsets has changed: from int to a struct containing two int,
+to allow for 64 bit file positions). We need to use GCC 2.95.3, which contains a fix
+for this problem (as far as I could see from the diff, it shouldn't support files
+larger than 4GB, but since we are going to use to test programs intended for a Zaurus,
+it's not such a limitation) (the ABI of .3 is the same as the .2 one)
+
+Now we don't want 2.95 to overwrite our 3: we want to install it in a separate
+directory. This is accomplished passing the --prefix option to the configure script.
+
+Step-by-step instructions
+-------------------------
+
+Ready-made packages
+```````````````````
+
+Download:
+
+*   `gcc 2.95.2 cross compiler x86-arm`_
+
+*   `binutils 2.11.2 cross x86-arm`_
+
+*   `glibc 2.2.2 arm`_
+
+*   `header Linux 2.4.6 arm`_
+
+*   `QTopia 1.5.0 free edition, both x86 and arm`_
+
+Install all of them (using rpm, as root). Two directories will be created:
+/opt/Embedix with the arm toolchain, and /opt/Qtopia with libraries and programs to
+compile both for x86 and arm.
+
+GCC
+```
+
+Download gcc-core-2.95.3.tar.gz and gcc-g++-2.95.3.tar.gz from a `GNU mirror`_.
+
+To compile (I assume you put the GCC tarballs in /tmp):
+
+*   cd /tmp
+
+*   tar zxvf gcc-core-2.95.3.tar.gz;tar zxvf gcc-g++-2.95.3.tar.gz
+
+*   mkdir gcc-obj;cd gcc-obj
+
+*   ../gcc-2.95.3/configure --prefix=/opt/Embedix/native --enable-shared
+
+*   make bootstrap
+
+*   make install (this should be done as root, unless you gave your normal user write
+    permissions on /opt/Embedix)
+
+It might be a bit strange to put a native compiler under /opt/Embedix, but it looked
+convenient, to make it clear in which context it is used.
+
+Some script
+```````````
+
+A couple of scripts are very usefule to set up enviornment variables in the two cases:
+native compilation (during development) and cross-compilation (at the end, to deploy
+the program for the Zaurus).
+
+Get them from Sharp: `dev-x86-qpe`_ and `dev-arm-qpe`_.
+
+In dev-x86-qpe change the lines setting PATH and LD_LIBRARY_PATH with the following:
+
+::
+
+    PATH=$QTDIR/bin:$QPEDIR/bin:/opt/Embedix/tools/bin:/opt/Embedix/native/bin:${ORG_PATH}
+    LD_LIBRARY_PATH=$QTDIR/lib:/opt/Embedix/native/lib:${ORG_LD_LIBRARY_PATH}
+..
+
+
+
+In this way you'll get the GCC 2.95.3 we just compiled.
+
+.. _`dev-x86-qpe`:
+    http://docs.zaurus.com/downloads/dev-x86-qpe.sh
+
+.. _`binutils 2.11.2 cross x86-arm`:
+    http://docs.zaurus.com/downloads/binutils-cross-arm-2.11.2-0.i386.rpm
+
+.. _`gnu mirror`:
+    http://www.gnu.org/server/list-mirrors.html
+
+.. _`qtopia 1.5.0 free edition, both x86 and arm`:
+    http://docs.zaurus.com/downloads/qtopia-free-1.5.0-1.i386.rpm
+
+.. _`glibc 2.2.2 arm`:
+    http://docs.zaurus.com/downloads/glibc-arm-2.2.2-0.i386.rpm
+
+.. _`header linux 2.4.6 arm`:
+    http://docs.zaurus.com/downloads/linux-headers-arm-sa1100-2.4.6-3.i386.rpm
+
+.. _`the afore-mentioned how-to`:
+    http://docs.zaurus.com/linux_compiler_setup_howto.shtml
+
+.. _`this how-to`:
+    http://docs.zaurus.com/linux_compiler_setup_howto.shtml
+
+.. _`dev-arm-qpe`:
+    http://docs.zaurus.com/downloads/dev-arm-qpe.sh
+
+.. _`gcc 2.95.x`:
+    http://gcc.gnu.org/gcc-2.95/
+
+.. _`gcc 2.95.2 cross compiler x86-arm`:
+    http://docs.zaurus.com/downloads/gcc-cross-sa1100-2.95.2-0.i386.rpm