add details on cross-compiler compilation

3 files changed, 39 insertions, 5 deletions

diff --git a/src/HW/makerbot/arduino-on-gentoo/document.en.rest.txt b/src/HW/makerbot/arduino-on-gentoo/document.en.rest.txt
index 908bb10..dbd1391 100644
--- a/src/HW/makerbot/arduino-on-gentoo/document.en.rest.txt
+++ b/src/HW/makerbot/arduino-on-gentoo/document.en.rest.txt
@@ -18,6 +18,21 @@ I start by downloading the sources for the Arduino_ software. You see,
 I run a 64-bit machine, and the pre-built Linux binaries are 32
 bits. Not good enough.
 
+Of course, I have to build the cross-compiling tool-chain… easy
+enough: crossdev_ has a special target for it::
+
+  # crossdev -t avr
+
+Only it does not work: ``avr-libc-headers`` requires the compiler to
+be already build. I don't go fixing it the proper way, I just follow
+the `hint found in a mailing list post`_, and do (after the failed
+``crossdev`` run):
+
+  # USE='-nls -fortran -gtk -openmp -mudflap' emerge -v cross-avr/gcc
+  # crossdev -t avr
+
+and I have a (hopefully) working cross-compiler.
+
 Then, following the `Arduino instructions`_, I say::
 
   ~/arduino-src/build/linux$ ./make.sh
@@ -124,6 +139,8 @@ the appropriate boards. We'll see if it actually works.
 
 .. _CupCake: http://wiki.makerbot.com/cupcake
 .. _`MakerBot instructions`: http://wiki.makerbot.com/cupcake-motherboard-firmware-update
+.. _crossdev: http://en.gentoo-wiki.com/wiki/Crossdev
+.. _`hint found in a mailing list post`: http://www.mail-archive.com/avr-libc-dev@nongnu.org/msg03019.html
 .. _Arduino: http://arduino.cc/
 .. _`Arduino instructions`: http://code.google.com/p/arduino/wiki/BuildingArduino
 .. _Sanguino: http://sanguino.cc/
diff --git a/src/HW/makerbot/arduino-on-gentoo/document.it.rest.txt b/src/HW/makerbot/arduino-on-gentoo/document.it.rest.txt
index 6b919b5..1678924 100644
--- a/src/HW/makerbot/arduino-on-gentoo/document.it.rest.txt
+++ b/src/HW/makerbot/arduino-on-gentoo/document.it.rest.txt
@@ -1,6 +1,6 @@
-=============================
-HW/makerbot/arduino-on-gentoo
-=============================
+==============================================
+ Compilare Arduino / Sanguino su Gentoo amd64
+==============================================
 :CreationDate: 2009-09-01 17:27:01
 :Id: HW/makerbot/arduino-on-gentoo
 :tags: - hardware
@@ -19,6 +19,21 @@ Comincio scaricando i sorgenti per il software Arduino_. Vedete, la
 mia macchina è a 64 bit, e i binari pre-compilati sono a 32. Non
 buono.
 
+Ovviamente, devo compilare il cross-compilatore e accessori…
+abbastanza facile: crossdev_ ha un "target" apposito::
+
+  # crossdev -t avr
+
+Peccato che non funzioni: ``avr-libc-headers`` ha bisogno che il
+compilatore sia già stato compilato. Non mi metto a correggerlo nel
+modo giusto, mi limito a seguire il `consiglio trovato su una mailing
+list`_, e (dopo la fallita invocazione di ``crossdev``) faccio:
+
+  # USE='-nls -fortran -gtk -openmp -mudflap' emerge -v cross-avr/gcc
+  # crossdev -t avr
+
+e finalmente ho un cross-compilatore (che speriamo funzioni).
+
 Quindi, seguendo le `istruzioni Arduino`_, faccio::
 
   ~/arduino-src/build/linux$ ./make.sh
@@ -124,6 +139,8 @@ le "boards" che mi servono. Vedremo se funziona davvero.
 
 .. _CupCake: http://wiki.makerbot.com/cupcake
 .. _`istruzioni di MakerBot`: http://wiki.makerbot.com/cupcake-motherboard-firmware-update
+.. _crossdev: http://en.gentoo-wiki.com/wiki/Crossdev
+.. _`consiglio trovato su una mailing list`: http://www.mail-archive.com/avr-libc-dev@nongnu.org/msg03019.html
 .. _Arduino: http://arduino.cc/
 .. _`istruzioni Arduino`: http://code.google.com/p/arduino/wiki/BuildingArduino
 .. _Sanguino: http://sanguino.cc/
diff --git a/src/HW/makerbot/document.en.rest.txt b/src/HW/makerbot/document.en.rest.txt
index ccad24e..262c53c 100644
--- a/src/HW/makerbot/document.en.rest.txt
+++ b/src/HW/makerbot/document.en.rest.txt
@@ -6,8 +6,8 @@
 :tags: - hardware
        - 3dPrint
 
- I received a `MakerBot CupCake`_ on 2009-08-20, and here I'll
- document everything I do with it.
+I received a `MakerBot CupCake`_ on 2009-08-20, and here I'll
+document everything I do with it.
 
 First step: `build the Arduino development environment
 <arduino-on-gentoo/>`_.