tt-tools, des outils pour le TwinTact
=====================================

Intro:
Ce package regroupe le nécessaire pour compiler des outils OpenSource pour le
TwinTact.

Public concerné:
A priori des développeurs ou hackers désirant utiliser des fonctions standards
d'un système linux sur leur Twintact
Si vous ne savez pas ce qu'est un shell et comment l'utilisez cet outil n'est
pas pour vous. Mais rien ne vous empêche de demander des outils qui vous
sembleraient utiles pour votre TwinTact. Pour ça, commencez par faire un tour sur
http://www.opentwin.org, ensuite pour nous contacter, faites le par la liste de
diffusion ou encore sur IRC (voir le site) ou encore sur http://source.pkg.fr

Pré-requis pour compiler :
un environnement unix... sous windows, l'environnement cygwin pourrait faire
l'affaire, mais je ne l'ai pas testé et surtout il faudrait peut-être recompiler
le toolchain... avis aux amateurs
Remarque: ce package a été développé et testé sur une distribution Fedora 8

Licence: voir les licences des packages utilisés

Installation pour recompiler:
 1. Créer un dossier quelconque, y mettre l'archive tt-tools-X.X.tar.gz 
    et y ouvrir un shell
 2. Décompressez l'archive depuis ce dossier avec:
    $ tar xzf tt-tools-X.X.tar.gz
    où X.X est le numéro de la version du package de tt-tools

Cross-compilation:
 1. Commencez par faire la procédure d'installation
 2. Lancez le script 'telecharge.sh' avec
    $ ./telecharge.sh
    pour télécharger directement le package à utiliser, notamment busybox,
    dropbear & le toolchain. Le script vérifie aussi l'empreinte SHA1 des
    package
    Remarque: vous pouvez télécharger manuellement les packages et les mettre
    dans un sous-dossier archives
 3. Lancez le script 'dossiers-de-cross-compilation.sh' pour préparer
    l'environnement de cross-compilation à partir des archives disponibles:
    $ ./dossiers-de-cross-compilation.sh
 4. Enfin, exécutez './compile-YYYYYYY.sh' où YYYYYYY correspond à l'outil que
    vous voulez recompiler

Installation sur le TwinTact:
 1. Utiliser le package tt-tools-X.Y-on-tt.tar.gz ou le générer avec le
    script generer-archive.sh
 2. Télécharger l'archive sur le TwinTact dans le dossier /usr/share
 3. Décompresser l'archive depuis ce dossier
 4. Exécuter le script /usr/share/bin/maj-tt-tools.sh:
    * busybox et dropbear sont installés
    * une clé privée pour le service dropbear est éventuellement générée

Contribuer:
 1. Vous pouvez modifier ensuite les sources dans les dossiers utilisés
 2. Recompilez en utilisant les scripts ci-dessus ou encore manuellement:
    $ source environnement-de-cross-compilation.sh
    et lancez vous même les commandes adéquates de compilation en vous inspirant
    éventuellement de celle disponibles dans les scripts compile-YYYYYYY.sh
 3. Une fois que vos modifs sont testées utilisez les scripts 'creer-patchs.sh et
    generer-archive.sh pour nous soumettre vos modifications sur la liste de
    diffusion par exemple ou dans un ticket sur http://source.pkg.fr
 4. Si vous avez besoin d'un coup de pouce essayez le canal IRC (voir le site
    http://www.opentwin.org)
 5. N'oubliez pas de jeter un oeil au ChangeLog

Merci d'être arrivé jusqu'ici ;-)