Remove old ARM cross-compilation (2004)

Software versions are totally out-of-date.
Platforms don't even exist anymore.
And this predated ARM support in the contrib.

doc/Makefile.am

@@ -33,7 +33,6 @@ EXTRA_DIST = \
 	fortunes.txt \
 	intf-vcd.txt \
 	release-howto.txt \
-	arm-crosscompile-howto.sgml \
 	Doxyfile.in \
 	lirc/example.lircrc \
 	skins/skins-howto.txt \

doc/arm-crosscompile-howto.sgml

-<!doctype linuxdoc system>
-<linuxdoc><article>
-<titlepag>
-  <title>Cross compiling VLC for ARM-Linux based platforms</title>
-  <author>Marc Ariberti <tt><htmlurl url="mailto:marcari@videolan.org" name="<marcari@videolan.org>"></tt></author>
-  <author>Jean-Paul Saman <tt><htmlurl url="mailto:jpsaman@wxs.nl" name="<jpsaman@wxs.nl>"></tt></author>
-  <date>v0.0.2, 19 march 2004</date>
-  <abstract>
-    This document describes all the steps to cross compile vlc for ARM based
-    platforms. It describes how to build a cross compilation toolchain, how to
-    build the libraries needed by vlc and the compilation of the vlc itself.
-  </abstract>
-</titlepag>
-
-<toc>
-
-<sect>
-  <heading>Introduction</heading>
-  <p>
-  This document is only a first draft. It does not intend to cover all the 
-  subject. You may still have some problems at some steps or find better 
-  way to do them. If you have any comment do not hesitate to contact us.
-  </p>
-  <sect1>
-    <heading>Which platforms are targeted ?</heading>
-    <p>
-      I will describe here how to compile vlc for an ARM based
-      PDA running linux. It includes for example :
-      <itemize>
-      <item>Compaq - iPaq (H36xx, H38xx,...), using Familiar Linux
-        <itemize>
-          <item>GNU Portable Environment (GPE)
-          <item>Opie
-        </itemize>
-      </item>
-      <item>YOPY/Linupy</item>
-      <item>Zaurus</item>
-      </itemize>
-    </p>
-  </sect1> 
-  <sect1>
-    <heading>Requirements for cross-compilation</heading>
-  </sect1>
-  <sect1>
-    <heading>Why cross-compiling ?</heading>
-    <p>
-      It is of course possible to compile directly on the targeted platform.
-      But there are a lot of great advantages to cross-compile :
-      <itemize>
-      <item>The most important one is probably the speed, because a
-        desktop computer is most of the time faster than a PDA for
-        compilation.</item>
-      <item>Another big problem is that a complete compilation toolchain
-        does take a great amount of disk space. And this space is usually
-        very limited on embedded systems.</item>
-      <item>And there also may not be enough memory to compile big files.</item>
-      </itemize>
-    </p>
-  </sect1>
-</sect>
-
-<sect>
-  <heading>Building the toolchain</heading>
-  <sect1>
-    <heading>Prerequisite</heading>
-    <sect2>
-      <heading>Importants paths</heading>
-      <p>
-        During this section, we will use the following paths :
-      </p>
-      <p>I would personally advise to compile everything as a normal user and
-      then install everything as root.</p>
-      <sect3>
-        <heading>${SRCDIR}</heading>
-        <p>
-        This is where the sources will be located and where the compilation
-        will be done.
-        (eg: <tt>/usr/src</tt> or <tt>/home/foobar/arm-src</tt>).
-        </p>
-      </sect3>
-      <sect3>
-        <heading>${PREFIX}</heading>
-        <p>This is where you want to install your cross compilation toolchain.
-        It can be either installed system-wide (in <tt>/usr/local/arm/2.95.3</tt> for example). Installation steps (i.e. <tt>make install</tt>) will have
-        to be done as <tt>root</tt>.
-        Or it can be installed in user-land, for the user's own use (<tt>/home/foobar/arm/2.95.3</tt> for example).
-        In this paper, the chosen prefix is <tt>/usr/local/arm/2.95.3</tt>,
-        you will have to adapt the commands to what you choose..
-        </p>
-      </sect3>
-    </sect2>
-    <sect2>
-      <heading>Files needed</heading>
-      <p>Download the following files and put them in the <bf>${SRCDIR}</bf>.
-      Most of them are available on the <htmlurl url="http://www.videolan.org/vlc/download-sources.html" name="VideoLAN website">.
-        <itemize>
-          <item><tt>binutils-2.11.2.tar.gz</tt></item>
-          <item><tt>linux-2.4.19.tar.bz2</tt></item>
-          <item><tt>patch-2.4.19-rmk4.bz2</tt></item>
-          <item><tt>gcc-2.95.3.tar.gz</tt></item>
-          <item><tt>gcc-2.95.3.diff.bz2</tt></item>
-          <item><tt>gcc-2.95.3.diffbis.bz2</tt></item>
-          <item><tt>gcc-2.95.3.diff2</tt></item>
-          <item><tt>glibc-2.2.5.tar.gz</tt></item>
-          <item><tt>glibc-linuxthreads-2.2.5.tar.gz</tt></item>
-          <item><tt>SDL-1.2.5.tar.gz</tt></item>
-          <item><tt>glib-1.2.10.tar.gz</tt></item>
-          <item><tt>ffmpeg.tar.gz</tt></item>
-          <item><tt>mad-0.14.2b.tar.gz</tt></item>
-          <item><tt>flac-1.1.0.tar.gz</tt></item>
-          <item><tt>libdvbpsi-0.1.2.tar.gz</tt></item>
-          <item><tt>a52dec-0.7.4.tar.gz</tt></item>
-        </itemize>
-      </p>
-    </sect2>
-  </sect1>
-  <sect1>
-    <heading>Binutils</heading>
-    <p>Compiling binutils is pretty simple :
-    <tscreen><verb>
-tar -xzf binutils-2.11.2.tar.gz
-cd binutils-2.11.2
-./configure --target=arm-linux --prefix=/usr/local/arm/2.95.3
-make
-make install
-    </verb></tscreen>
-    </p>
-  </sect1>
-  <sect1>
-    <heading>Preparing linux kernel</heading>
-    <p>
-    <tscreen><verb>
-tar -xzf linux-2.4.19.tar.bz2
-bunzip2 patch-2.4.19-rmk4.bz2
-cd linux-2.4.19
-patch -p1 &lt; ../patch-2.4.19-rmk4.bz2
-make clean ARCH=arm CROSS_COMPILE=arm-linux-
-make ARCH=arm h3600_config
-  </verb></tscreen>
-  <bf>Do not forget</bf> to save the configuration even if no changes 
-  are made !
-  <tscreen><verb>
-make ARCH=arm menuconfig
-make symlinks ARCH=arm CROSS_COMPILE=arm-linux-
-mkdir -p /usr/local/arm/2.95.3/arm-linux/include
-cp -Rf include/asm include/asm-arm include/linux \
-                      /usr/local/arm/2.95.3/arm-linux/include
-cd /usr/local/arm/2.95.3/arm-linux
-ln -s include sys-linux
-    </verb></tscreen>
-    </p>
-  </sect1>
-  <sect1>
-    <heading>Basic cross compiler (gcc)</heading>
-    <p>
-    <tscreen><verb>
-tar -xvzf gcc-2.95.3.tar.gz
-bunzip2 gcc-2.95.3.diff.bz2
-bunzip2 gcc-2.95.3.diffbis.bz2
-patch -p1 -d gcc-2.95.3 &lt; gcc-2.95.3.diff
-patch -p1 -d gcc-2.95.3 &lt; gcc-2.95.3.diffbis
-cd gcc-2.95.3
-./configure --target=arm-linux --disable-threads --enable-languages=c \
-        --prefix=/usr/local/arm/2.95.3 --with-headers=linux-2.4.19/include
-make
-make install
-    </verb></tscreen>
-    </p>
-
-  </sect1>
-  <sect1>
-    <heading>Compiling glibc</heading>
-    <p>
-    Depending on your target, you may choose another glibc version (eg: 2.1.3 for linupy 1.4)
-    <tscreen><verb>
-tar -xvzf glibc-2.2.5.tar.gz
-cd glibc-2.2.5
-tar -xvzf ../glibc-linuxthreads-2.2.5.tar.gz
-CC=arm-linux-gcc ./configure arm-linux --target=arm-linux \
-          --prefix=/usr/local/arm/2.95.3/arm-linux --enable-add-ons
-    </verb></tscreen>
-
-The following step is quite long !
-
-    <tscreen><verb>
-CC=arm-linux-gcc make
-    </verb></tscreen>
-
-If you have problems compiling glibc due to pread/pwrite, edit <tt>sysdeps/unix/sysv/linux/kernel-features.h</tt>
-and turn <tt>__ASSUME_PREAD_SYSCALL</tt> and 
-<tt>__ASSUME_PWRITE_SYSCALL</tt> from 1 to 0.
-
-    <tscreen><verb>
-CC=arm-linux-gcc make install
-    </verb></tscreen>
-    </p>
-  </sect1>
-  <sect1>
-    <heading>Full cross compiler (gcc)</heading>
-    <p>
-    <tscreen><verb>
-rm -Rf gcc-2.95.3
-tar -xvzf gcc-2.95.3.tar.gz
-patch -p1 -d gcc-2.95.3 &lt; gcc-2.95.3.diff
-patch -p1 -d gcc-2.95.3 &lt; gcc-2.95.3.diff2
-cd gcc-2.95.3
-./configure --target=arm-linux --prefix=/usr/local/arm/2.95.3
-make
-make install
-    </verb></tscreen>
-    </p>
-  </sect1>
-  <sect1>
-    <heading>Compiling linux kernel</heading>
-  </sect1>
-  <sect1>
-    <heading>Misc</heading>
-    <p>
-    Add <tt>/usr/local/arm/2.95.3/bin</tt> to your PATH. Add the following line (depends on your shell)
-    to your shell's configuration file :
-    <tscreen><verb>
-export PATH=/usr/local/arm/2.95.3/bin:$PATH
-    </verb></tscreen>
-    I would advise you to completely log out and then log in again, so that
-    the change would be taken into account. You can now check that when you
-    type <tt>arm-linux-gcc</tt>, it launches the cross-compiler.
-    </p>
-
-    <p>
-    Next are some packages that you may compile by yourself, but I found
-    it was easier to use the precompiled packages. You can take them
-    at <htmlurl url="http://ipkgfind.handhelds.org/" name="ipkgfind">.
-    You may find packages with other version numbers which should not be
-    a problem.
-    <descrip>
-    <tag><tt>libgcc1_3.1.1-1_arm.ipk</tt></tag>
-        This provides libgcc.so.1 which is needed to compile some libraries.
-    <tag><tt>xlibs_4.1-5_arm.ipk</tt>, <tt>xlibs-dev_4.1.0-16_arm.ipk</tt></tag>
-        Those are the libraries ans the development files for X windows.
-    <tag><tt>zlib1g_1.1.4-3_arm.ipk</tt>, <tt>zlib1g-dev_1.1.3-fam1_arm.ipk</tt></tag>
-        These libraries are needed by some libraries to compile.
-    </descrip>
-    
-    Install these packages on your compiler box in <tt>/usr/local/arm/2.95.3/arm-linux</tt> :
-     You can use the script <tt>install.sh</tt> :
-    <tscreen><verb>
-#!/bin/sh
-# script to install .ipk into the arm-toolchain
-# usage : ./install.sh foobar.ipk
-
-if ! tar -xvzf $1 2> /dev/null
-then
-    ar xv $1 2> /dev/null
-fi
-cp data.tar.gz /usr/local/arm/2.95.3/arm-linux
-cd /usr/local/arm/2.95.3/arm-linux
-tar -xvzf data.tar.gz
-    </verb></tscreen>
-    </p>
-  </sect1>
-</sect>
-
-<sect>
-  <heading>Setting up Opie cross-compile environment</heading>
-  <p>Download the Opie SDK from the website <htmlurl url="http://opie.handhelds.org/" name="OPIE website">
-using the menuitem "Download Opie SDK" or try the direct link here: <htmlurl url="ftp://ftp.handhelds.org/zecke/" name="Download Opie SDK">.
-Download all files to your ${SOURCES}/opie directory.
-  </p>
-  <sect1>
-    <heading>Opie SDK</heading>
-    <p>The Opie SDK does not come with a README file or installation instructions.
-I give them here instead. There are two tar files in the download a OpieSDK.tar.gz2 and a kdevelop_src.tar.bz2.
-The last file is a modified kdevelop for use with the OpieSDK. In this tutorial we will not use that.
-Unpack OpieSDK.tar.bz2 in your sources <tt>cd ${SOURCES}/opie</tt> directory.
-    <tscreen><verb>
-cd ${SOURCES}/opie
-tar -xjvf OpieSdk.tar.bz2
-    </verb></tscreen>
-    It creates a directories structure <tt>${SOURCES}/opie/opt/OpieSDK</tt>. Inside that directory a script is present to
-<tt>start_kdevelop</tt>. Modify this script so that it uses the correct paths for you setup.
-    <tscreen><verb>
-#!/bin/sh
-source ${SOURCES}/opie/opt/OpieSdk/dev_env
-
-export KDEDIR=${SOURCES}/opie/opt/OpieSdk/kde
-export PATH=${SOURCES}/opie/opt/OpieSdk/kde/bin:$PATH
-kbuildsycoca
-kdevelop
-    </verb></tscreen>
-    Save the script. Do the same with the script <tt>arm_source</tt>
-    <tscreen><verb>
-source ${SOURCES}/opie/opt/OpieSdk/dev_env
-export QTDIR=$QTDIR_ARM
-export OPIEDIR=$OPIEDIR_ARM
-    </verb></tscreen>
-    Save the script and modify the script <tt>host_source</tt> in the same manner as above.
-    <tscreen><verb>
-source ${SOURCES}/opie/opt/OpieSdk/dev_env
-export QTDIR=$QTDIR_NAT
-export OPIEDIR=$OPIEDIR_NAT
-    </verb></tscreen>
-    Save the script and modify the script <tt>dev_env</tt> in the same manner as above.
-    <tscreen><verb>
-export PYTHONPATH=${SOURCES}/opie/opt/OpieSdk/python/opie:${SOURCES}/opie/opt/OpieSdk/python/sip
-export PATH=/usr/local/arm/2.95.3/bin:/opt/OpieSdk/host_tools:${SOURCES}/opie/opt/OpieSdk/opie/x86/qt-2.3.7/bin:$PATH
-export PATH=${SOURCES}/opie/opt/OpieSdk/opie/x86/qmake:$PATH
-export QTDIR_NAT=${SOURCES}/opie/opt/OpieSdk/opie/x86/qt-2.3.7
-export OPIEDIR_NAT=${SOURCES}/opie/opt/OpieSdk/opie/x86/sdk
-export QTDIR_ARM=${SOURCES}/opie/opt/OpieSdk/opie/arm/qt-2.3.7
-export OPIEDIR_ARM=${SOURCES}/opie/opt/OpieSdk/opie/arm/sdk
-export OPIE_SDK_BASE=${SOURCES}/opie/opt/OpieSdk/
-export OPIE_SDK_QMAKE_BASE=${SOURCES}/opie/opt/OpieSdk/opie/x86/sdk/mkspecs/qws/
-export OPIE_DOC=${SOURCES}/opie/opt/OpieSdk/apidocs
-
-export LD_LIBRARY_PATH=${SOURCES}/opie/opt/OpieSdk/sip/lib:$OPIEDIR_NAT/lib:$QTDIR_NAT/lib:$LD_LIBRARY_PATH
-export OPIE_LANGUAGES=de:en:cz:da:dk:es:fr:hu:it:ja:ko:lv:mk:nl:no:pl:pt:pt_BR:ru:sl:zh_CN:zh_TW
-    </verb></tscreen>
-    The symbolic linke to the tool <tt>qmake</tt> points now to the wrong place. We need to fix this symbolic link.
-Here is the way to do that.
-    <tscreen><verb>
-cd host_tools
-ln -sf /home/jpsaman/src/opie/opt/OpieSdk/opie/x86/sdk/qmake/qmake qmake
-cd ../
-    </verb></tscreen>
-    Now it is time to fire up our development environment and start hacking in Opie.
-    </p>
-  </sect1>
-</sect>
-
-<sect>
-  <heading>Cross compiling libraries needed by vlc</heading>
-  <p>
-  Download <tt>ipaq-config.site</tt> to ${SOURCES}.
-  When downloading source tarballs copy them to your ${SOURCES} directory.
-  Each section is supposed to begin with <tt>cd ${SOURCES}</tt>.
-  </p>
-  <sect1>
-    <heading>SDL</heading>
-    <p>
-    It is not clean at all but did not found a better working method.
-    Using config.site
-    it compiles well, but when linking with vlc there are problems !
-    </p>
-    <p>
-    <tt>/usr/local/arm/2.95.3/arm-linux/bin</tt> should contain the cross 
-    compiler without the prefix <tt>arm-linux-</tt>.
-    
-    <tscreen><verb>
-tar -xvzf SDL-1.2.5.tar.gz
-cd SDL-1.2.5
-./configure --enable-release --target=arm-linux --host=arm-linux \
-      --disable-esd \
-      --prefix=/usr/local/arm/2.95.3/arm-linux/usr \
-      --x-includes=/usr/local/arm/2.95.3/arm-linux/usr/X11R6/include \
-      --x-libraries=/usr/local/arm/2.95.3/arm-linux/usr/X11R6/lib \
-      --disable-video-opengl
-
-export PATH=/usr/local/arm/2.95.3/arm-linux/bin:$PATH
-
-make && make install
-    </verb></tscreen>
-    </p>
-  </sect1>
-  <sect1>
-    <heading>Glib/GTK+</heading>
-    <p>
-    <tscreen><verb>
-tar -xvzf glib-1.2.10.tar.gz
-cd glib-1.2.10
-CONFIG_SITE=../ipaq-config.site ./configure \
-      --prefix=/usr/local/arm/2.95.3/arm-linux/usr
-make
-make install
-cd ..
-tar -xvzf gtk+-1.2.10.tar.gz
-cd gtk+-1.2.10
-CONFIG_SITE=../ipaq-config.site ./configure \
-      --prefix=/usr/local/arm/2.95.3/arm-linux/usr --with-glib=../glib-1.2.10
-make 
-make install
-    </verb></tscreen>
-    </p>
-  </sect1>
-  <sect1>
-    <heading>ffmpeg</heading>
-    <p>
-    <tscreen><verb>
-tar -xvzf ffmpeg.tar.gz
-cd ffmpeg
-./configure --cpu=armv4l --cc=arm-linux-gcc --disable-mmx \
-        --prefix=/usr/local/arm/2.95.3/arm-linux/usr --enable-shared
-cd libavcodec
-make
-    </verb></tscreen>
-
-    Vlc does not require that you install ffmpeg.
-    </p>
-  </sect1>
-  <sect1>
-    <heading>mad</heading>
-    <p>
-    <tscreen><verb>
-tar -xvzf mad-0.14.2b.tar.gz
-cd mad-0.14.2b
-./configure --enable-release --target=arm-linux --host=arm-linux \
-      --disable-esd \
-      --prefix=/usr/local/arm/2.95.3/arm-linux/usr \
-      --x-includes=/usr/local/arm/2.95.3/arm-linux/usr/X11R6/include \
-      --x-libraries=/usr/local/arm/2.95.3/arm-linux/usr/X11R6/lib \
-      --disable-video-opengl
-export PATH=/usr/local/arm/2.95.3/arm-linux/bin:$PATH
-make
-    </verb></tscreen>
-    </p>
-  </sect1>
-  <sect1>
-    <heading>gpe</heading>
-  </sect1>
-  <sect1>
-    <heading>tremor</heading>
-    <p>
-    Tremor is an integer decoder for the vorbis audio codec. Download the
-    source through CVS at the <htmlurl url="http://www.xiph.org/" name="xiph.org"> website.
-    </p>
-    <p>
-    Log into CVS using the password : <tt>anoncvs</tt>.
-    <tscreen><verb>
-cvs -d :pserver:anoncvs@xiph.org:/usr/local/cvsroot login
-cvs -d :pserver:anoncvs@xiph.org:/usr/local/cvsroot co Tremor
-cd Tremor
-CONFIG_SITE=../ipaq-config.site ./configure \
-              --prefix=/usr/local/arm/2.95.3/arm-linux/usr
-make
-</verb></tscreen>
-    </p>
-  </sect1>
-  <sect1>
-    <heading>ogg</heading>
-    <p>
-    For ogg, it is the same as Tremor.
-    <tscreen><verb>
-cvs -d :pserver:anoncvs@xiph.org:/usr/local/cvsroot login
-cvs -d :pserver:anoncvs@xiph.org:/usr/local/cvsroot co ogg
-cd ogg
-CONFIG_SITE=../ipaq-config.site ./configure \
-             --prefix=/usr/local/arm/2.95.3/arm-linux/usr
-make
-    </verb></tscreen>
-    </p>
-  </sect1>
-  <sect1>
-    <heading>flac</heading>
-    <p>
-    <tscreen><verb>
-tar -xvzf flac-1.1.0.tar.gz
-cd flac-1.1.0
-./configure --enable-release --host=arm-linux --target=arm-linux \
-            --prefix=/usr/local/arm/2.95.3/arm-linux/usr
-    </verb></tscreen>
-    It will probably fail (due to the xmms plugin), but it is not a problem, 
-    we will continue installation by hand.
-    <tscreen><verb>
-cp -Rf include/FLAC /usr/local/arm/2.95.3/arm-linux/include
-cd src/libFLAC
-make install
-    </verb></tscreen>
-    </p>
-  </sect1>
-  <sect1>
-    <heading>libdvbpsi</heading>
-    <p>
-    <tscreen><verb>
-tar -xvzf libdvbpsi-0.1.2.tar.gz
-cd libdvbpsi-0.1.2
-./bootstrap
-./configure --target=arm-linux --host=arm-linux
-make
-    </verb></tscreen>
-    </p>
-  </sect1>
-  <sect1>
-    <heading>a52</heading>
-    <p>
-    <tscreen><verb>
-tar -xvzf a52dec-0.7.4.tar.gz
-cd a52dec-0.7.4
-./configure --enable-release --host=arm-linux --target=arm-linux \
-            --prefix=/usr/local/arm/2.95.3/arm-linux/usr
-make && make install
-    </verb></tscreen>
-    </p>
-  </sect1>
-</sect>
-
-<sect>
-  <heading>Cross compiling vlc itself</heading>
-  <p>
-  First of all, run the <tt>./bootstrap</tt> script.
-  Then run one of the <tt>ipkg/rules.*</tt>, according to what you want to compile.
-  Finally you just have to type make and you'll get a stand alone vlc.
-  </p>
-  <p>
-  Run <tt>arm-linux-strip</tt> to remove symbols and so the size of the file,
-  and now you can test it easily on your PDA.
-  </p>
-  <p>
-    Enjoy !
-  </p>
-</sect>
-
-
-</article></linuxdoc>