Changes between Version 5 and Version 6 of BuildingExamples

Timestamp:

Jun 16, 2010, 12:46:10 AM (14 years ago)

Author:

becoulet

Comment:

--

BuildingExamples

@@ -8 +8 @@
 Building MutekH requires the following software packages:
 
- - A GNU compiler or cross-compiler. You can use the [source:trunk/mutekh/tools/crossgen.mk] script to compile and install a tool chain easily.
+ - A GNU compiler or cross-compiler. See below.
  - GNU make (>=3.81) and a perl interpreter (>=5.8), available in most GNU/Linux and BSD operating system.
 
 Some builds may require the following additional tools
 
- - The [FlattenedDeviceTree flattened device tree] compiler (dtc): http://git.jdl.com/gitweb/
- - The heterogeneous linker found in [source:trunk/mutekh/tools/hlink]
+ - The [FlattenedDeviceTree flattened device tree] compiler (dtc): http://git.jdl.com/gitweb/ . This tool is included in precompiled toolchains.
+ - The heterogeneous linker found in [source:trunk/mutekh/tools/hlink], for heterogeneous platforms only.
 
 You may need real hardware or a simulator to run MutekH:
 
- - [http://www.qemu.org/ Qemu] to run native x86 binaries
- - [https://www.soclib.fr/ SoCLib] to experiment with various multiprocessor platforms (see soclib:InstallationNotes)
+ - [http://www.qemu.org/ Qemu] to run native x86 binaries, available in most GNU/Linux distributions.
+ - [https://www.soclib.fr/ SoCLib] to experiment with various multiprocessor platforms. A precompiled SoCLib platform is available [https://www.mutekh.org/www/tools/ here] for test purpose. We suggest building your own platforms by installing SoCLib (see soclib:InstallationNotes).
 
 You may need extra tools to deals with kernel images for some targets:
 
- - GNU mtools or mkisofs to create a x86 bootable disk images.
- - GNU grub or etherboot to boot compiled kernel images.
+ - GNU mtools or mkisofs to create a x86 bootable disk images, available in most GNU/Linux distributions.
+ - GNU grub or etherboot to boot compiled kernel images, included in boot image in [source:trunk/mutekh/tools/] directory.
 
 The [source:trunk/mutekh/tools/x86_cdrom.sh] and [source:trunk/mutekh/tools/x86_floppy.sh] scripts are available to easily create boot disk images.
 
-== Building cross-compilers ==
+=== GNU toolchain ===
 
-MutekH comes with a tool to build a complete cross-compilation toolchain:
+MutekH comes with a script to build a complete cross-compilation toolchain for you.
+Some precompiled toolchains are avaialble [https://www.mutekh.org/www/tools/ here] as static i386 Linux binaries for convenience and quick start purpose. It should work on any GNU/Linux i386 and x86_64 distributions.
 
-The script is [source:trunk/mutekh/tools/crossgen.mk tools/crossgen.mk].
+We suggest building your own toolchain if you plan to work with MutekH. The [source:trunk/mutekh/tools/crossgen.mk tools/crossgen.mk] script is able to download, build and install toolchains for you.
 
 There is an inline help: