[Vm-dev] [commit][2774] add instructions for --enableFastBlt on arm/linux

[commits at squeakvm.org]

Revision: 2774
Author:   piumarta
Date:     2013-08-19 18:18:13 -0700 (Mon, 19 Aug 2013)
Log Message:
-----------
add instructions for --enableFastBlt on arm/linux

Modified Paths:
--------------
    trunk/platforms/unix/ChangeLog

Added Paths:
-----------
    trunk/platforms/unix/doc/README.FastBitBlt

Modified: trunk/platforms/unix/ChangeLog
===================================================================
--- trunk/platforms/unix/ChangeLog	2013-08-17 21:49:08 UTC (rev 2773)
+++ trunk/platforms/unix/ChangeLog	2013-08-20 01:18:13 UTC (rev 2774)
@@ -1,3 +1,8 @@
+2013-08-19  Ian Piumarta  <com -dot- gmail -at- piumarta (backwards)>
+
+	* doc/README.FastBitBlt: Added instructions for compiling on ARM
+	running Linux.
+
 2013-08-15  Ian Piumarta  <piumarta at raspberrypi>
 
 	* cmake/Plugins.cmake: Process ${plugin}_extra_sources in both

Added: trunk/platforms/unix/doc/README.FastBitBlt
===================================================================
--- trunk/platforms/unix/doc/README.FastBitBlt	                        (rev 0)
+++ trunk/platforms/unix/doc/README.FastBitBlt	2013-08-20 01:18:13 UTC (rev 2774)
@@ -0,0 +1,56 @@
+If you enable fast BitBlt using 'configure --enableFastBlt' then you
+might need to install or build additional assembly language tools for
+your platform.
+
+Linux on ARM (e.g., Rapsberry Pi)
+---------------------------------
+
+You will need to build 'asasm' from source.  It is currenly not
+provided as an installable package in any of the ARM repositories that
+I use.
+
+1.  Install packages to satisfy its dependencies:
+
+    sudo apt-get install bison flex libarchive-dev
+
+    (Depending on your setup, you might also need to install automake,
+    autoconf, and libtool.)
+
+2.  Obtain the asasm sources:
+
+    svn co svn://svn.riscos.info/gccsdk/trunk/tools/asasm
+    cd asasm
+
+3.  Kludge a workaround for a bug that the maintainer seems unwilling
+    to fix:
+
+    - open src/output.c with your favourite editor
+    - at the very top, insert the line
+
+    	#define ELF_EABI
+
+4.  Fix the maintainer's incomplete packaging of the sources so that
+    'configure' will actually work:
+
+    autoreconf --install
+
+    You should now have a 'configure' script and all the paraphernalia
+    that it requires (config.guess, ltmain.sh, etc.); if not then
+    perhaps running 'autoconf' will generate some stuff for you.  If
+    not, complain to the maintainer of asasm that the whole point of
+    autotools is that you should never, ever have to do any of the
+    nonsense in step 4 of these instructions.
+
+5. Generate a Makefile:
+
+   ./configure --target=arm-linux-gnueabihf
+
+6.  Build an assember:
+
+    make
+
+7.  Install it so that the Squeak build process can find it:
+
+    sudo make install
+
+You should now be able to build Squeak with fast BitBlt enabled.