SYNOPSIS
	cross [command|package] package

DESCRIPTION
	Cross is a tool to build a cross toolchain on SliTaz GNU/Linux. It
	was written for the ARM platform (arm, armv6hf, armv7) and also has an
	x86_64 configuration. Note: SliTaz x86_64 is now cooked natively, in
	its own x86_64 chroot, not with this cross toolchain, and the tools
	versions in the configs are old (binutils 2.22, gcc 4.6).

COMMANDS
	Run: cross usage

OPTIONS
	--log      clean: Will also clean log files
	--config=  Use specified configuration file

CONFIGURATION
	/usr/share/cross/cross-<arch>.conf  Config templates, one per arch
	/etc/slitaz/cross.conf              Active config, copied from the
	                                    template by 'cross <arch>-setup'
	./cross.conf                        Read after it, if present

HOWTO:
	When building a cross toolchain it's better to understand what is a
	linker or C compiler such as GCC. The configure option --target is
	used by 'cross' to build cross-tools. When the toolchain is built on
	your machine you can then build packages with cook and the wok. Cross
	uses by default the same source tarballs as cook but the path can be
	changed via the config file. Configuration is: cross.conf. Here is a
	cmdline howto:

	Create a chroot (use last tazdev)
	---------------------------------
	# tazdev gen-chroot --arch=arm
	# tazdev chroot --arch=arm

	Clone cookutils to get last cook and cross
	------------------------------------------
	# tazpkg -gi mercurial
	# tazpkg -gi make
	# cd && hg clone https://hg.slitaz.org/cookutils
	# cd cookutils
	# make install-cross

	Setup the build environment, get source and compile a cross toolchain
	---------------------------------------------------------------------
	'cross setup' is 'cross arm-setup': it installs the build packages,
	copies the arch config to /etc/slitaz/cross.conf and runs
	'cook-setup <arch>', which rewrites ARCH, CFLAGS and HOST_SYSTEM in
	/etc/slitaz/cook.conf.

	# cross arm-setup
	# cross download
	# cross compile

	Test the cross toolchain
	------------------------
	# cross testsuite

AUTHORS
	Written by Christophe Lincoln
