[Gnash-commit] gnash ./ChangeLog doc/C/Makefile.am doc/C/sourc...

[Rob Savoye]

CVSROOT:        /sources/gnash
Module name:    gnash
Branch:         
Changes by:     Rob Savoye <address@hidden>     06/02/24 02:48:15

Modified files:
        .              : ChangeLog 
        doc/C          : Makefile.am sources.xml 
Added files:
        doc/C          : amf.xml 

Log message:
        * doc/C/sources.html: Add section on cross compiling Gnash.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/gnash/gnash/ChangeLog.diff?tr1=1.153&tr2=1.154&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/gnash/gnash/doc/C/Makefile.am.diff?tr1=1.10&tr2=1.11&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/gnash/gnash/doc/C/amf.xml?rev=1.1
http://cvs.savannah.gnu.org/viewcvs/gnash/gnash/doc/C/sources.xml.diff?tr1=1.4&tr2=1.5&r1=text&r2=text

Patches:
Index: gnash/ChangeLog
diff -u gnash/ChangeLog:1.153 gnash/ChangeLog:1.154
--- gnash/ChangeLog:1.153       Fri Feb 24 00:06:21 2006
+++ gnash/ChangeLog     Fri Feb 24 02:48:15 2006
@@ -1,5 +1,6 @@
 2006-02-23  Rob Savoye  <address@hidden>
 
+       * doc/C/sources.html: Add section on cross compiling Gnash.
        * libgeometry/kd_tree_packed.cpp: Comment out the two somewhat
        bogus assertions so this file can be cross compiled.
        * configure.ac: If the plugin is disabled, or glext is disabled,
Index: gnash/doc/C/Makefile.am
diff -u gnash/doc/C/Makefile.am:1.10 gnash/doc/C/Makefile.am:1.11
--- gnash/doc/C/Makefile.am:1.10        Sat Feb 11 16:52:44 2006
+++ gnash/doc/C/Makefile.am     Fri Feb 24 02:48:15 2006
@@ -28,10 +28,10 @@
 docname = gnash
 lang = C
 omffile = gnash-C.omf
-entities = legal.xml           \
-       gnash.xml               \
+entities = \
        sources.xml             \
        internals.xml           \
+       amf.xml                 \
        accessibility.xml       \
        appendix.xml            \
        array.xml               \
@@ -69,6 +69,7 @@
        textsnapshot.xml        \
        video.xml               \
        xml.xml                 \
+       xmlnode.xml             \
        xmlsocket.xml
 
 xml_files = $(entities) $(docname).xml
@@ -88,6 +89,8 @@
 EXTRA_DIST = \
        $(xml_files)            \
        $(omffile)              \
+       gnash.texi              \
+       gnash-man.xml           \
        gnash.info              \
        gnash.html              \
        gnash.1
@@ -106,23 +109,24 @@
        touch $@
 endif
 
+#      basefile=$(notdir $(basename $<));
 .xml.texi:
 if ENABLE_TEXI
-       basefile=$(notdir $(basename $<)); \
+       basefile=`echo $< | sed -e  's,^.*/,,' -e 's,\.xml$$,,'`; \
        $(DB2X_XSLTPROC) -s texi $< --output $${basefile}.txml; \
-       if test x"$(DB2X_VERSION)" = "0.8.5"; then \
-         $(DB2X_TEXIXML) --to-stdout $${basefile}.txml; \
-        sed -e '/setfilename/d' $${basefile}_manual_v*.texi > 
$${basefile}.texi; \
-       else\
-         $(DB2X_TEXIXML) --to-stdout $${basefile}.txml >  $${basefile}.texi ; \
-        fi
-       $(RM) $${basefile}_manual_v*.texi
+       if test x"$(DB2X_VERSION)" = x"0.8.5"; then \
+         $(DB2X_TEXIXML) $${basefile}.txml; \
+         sed -e "s/setfilename $${basefile}_manual_v.*\.info/setfilename 
$${basefile}.texi"; \
+       else \
+         $(DB2X_TEXIXML) --to-stdout $${basefile}.txml > $${basefile}.texi ; \
+       fi
+       -$(RM) $${basefile}_manual_v*.texi
 else
        touch $@
 endif
 
 .texi.info:
-       $(MAKEINFO) --force gnash.texi
+       $(MAKEINFO) --force $<
 
 gnash.1: gnash-man.xml
 if ENABLE_MAN
@@ -139,7 +143,7 @@
        @xmllint $(srcdir)/gnash.xml
 
 CLEANFILES = \
-       gnash.omf.out \
+       gnash-C.omf.out \
        manpage.links  \
        manpage.refs  \
        gnash.tex  \
Index: gnash/doc/C/sources.xml
diff -u gnash/doc/C/sources.xml:1.4 gnash/doc/C/sources.xml:1.5
--- gnash/doc/C/sources.xml:1.4 Sun Jan 29 17:14:42 2006
+++ gnash/doc/C/sources.xml     Fri Feb 24 02:48:15 2006
@@ -649,6 +649,93 @@
       </variablelist>
     </sect3>
 
+    <sect3 id="crossconf">
+      <title>Cross Compiling And Configuration</title>
+
+      <para>
+       To cross configure and compile Gnash, you first need to build
+       a target system on your workstation. This includes cross
+       compilers for the target architecture, and typically some
+       system headers. You will also need <code>libxml2</code>,
+       <code>libpng</code>, <code>libjpeg</code>, <code>sdl</code>,
+       <code>sdl mixer</code>, <code>opengl</code>, and
+       <code>ogg</code> development packages built for the target
+       system.
+      </para>
+
+      <para>
+       If you need to build up a targe system from scratch, there is
+       a good document and shell script at this web site: <ulink
+       type="http"
+       url="http://frank.harvard.edu/~coldwell/toolchain/";>
+       http://frank.harvard.edu/~coldwell/toolchain/</ulink>.
+      </para>
+
+      <para>
+       After I built up an arm system in /usr/arm using the shell
+       script from this web sitem, I then cross compiled all the
+       other libraries I needed. The fun part is trying to get
+       libMesa to cross compile, because it's not really setup for 
+       it.  
+      </para>
+
+      <para>
+       So to build for an arm based system on an x86 based systems,
+       configure like this: 
+      </para>
+
+      <programlisting>
+       ../gnash/configure --target=arm-unknown-linux-gnu --prefix=/usr/arm 
--host=arm-unknown-linux-gnu --build=i686-pc-linux-gnu --disable-plugin
+      </programlisting>
+      
+      <para>
+       The important options here are the ones that specify the
+       architectures for the build.
+
+       <variablelist>
+         <varlistentry>
+           <term>--target</term>
+           <listitem>
+             <para>
+               The target architecture. This is the architecture the
+               final executables are supposed to run on.
+             </para>
+           </listitem>
+         </varlistentry>
+         <varlistentry>
+           <term>--host</term>
+           <listitem>
+             <para>
+               The host architecture. This is the architecture the
+               executables are supposed to run on. This is usally the
+               same as <code>--target</code> except when building a
+               Canadian Cross. This is when you build a cross
+               compiler on a Unix machine, that runs on a
+               <code>win32</code> machine, producing code for yet
+               a third architecture, like the <code>ARM</code>.
+             </para>
+           </listitem>
+         </varlistentry>
+         <varlistentry>
+           <term>--build</term>
+           <listitem>
+             <para>
+               This is the system this build is running on.
+             </para>
+           </listitem>
+         </varlistentry>
+       </variablelist>
+      </para>
+
+      <para>
+       You also want to use <code>--disable-plugin</code>, since it's
+       doubtful you have a full Firefox development system for your
+       target architecture. This will drop all the plugin specific
+       configuration tests, and not try to compile the plugin.
+      </para>
+
+    </sect3>
+    
   </sect2>
 
   <sect2 id="building">
@@ -659,7 +746,6 @@
       simple. Gnash is built using <code>GNU make</code>.
     </para>
 
-
     <sect3 id="compile">
       <title>Compiling The Code</title>