\chapter{Development Tools}

\section{AutoTools}

On va écrire une description du makefile que l'on veut obtenir.

\subsection{AutoMake}

On crée la première règle bin\_PROGRAMS, puis le/les noms des programmes que
l'on veut générer. Il s'agit d'une variable primaire.
hello-world sera installé dans bin/ avec make install. On peut changer le
prefix pour envoyer le fichier ailleurs.

Automake n'est cependant pas capable de compiler le programme, il a besoin
d'autoconf.

\subsection{AutoConf}

Le script configure se charge de regarder où sont les bibliothèques standard
ainsi que le compilateur et tout et tout.

On a la flemme d'écrire le script pour autotools ... donc : \texttt{autoscan} !
Première chose à faire : renommer le fichier en configure.ac

Il crée un fichier configure.scan. C'est un script shell mélangé avec du M4 (le
\og language d'AutoConf\fg).
\c Ca fonctionne sur le même principe que cpp, le préprocesseur.

M4 = Macro = M + 4 lettre

Les crochets bloquent l'extension des macros. Conseil : toujours mettre des
crochets autour des variables.

On retrouve des infos pour autoconf et automake.

\verb+AC_PREREQ+ vérifier la version requise.

\verb+AC_INIT+~: initialisation du package (nom, version, adresse de bug report)

\verb+AC_PROG_CXX+~: macro qui cherche un compilateur C++, on peut préciser le
compilateur obligatoire à utiliser (on lui passe en argument de
\texttt{./configure CXX=g++}) et il vérifie que le compilateur fonctionne (il
compile un petit code pour voir :p)

Si le compilateur fonctionne pas par exemple, il dira ce qui va pas, plus de
détails sont dispo dans le fichier config.log (énormément !)


\verb+AC_CONFIG_FILES+~: fichiers à générer, typiquement des Makefiles !
Il prend des fichiers en .in et il génére des fichiers dont le nom est écrit
dans la variable : Makefile.in => Makefile ; c'est donc le script configure qui
transforme le .in en véritable fichier.
C'est à ce moment là qu'il précise les variables genre CXX, ...

\verb+AC_OUTPUT+ déclenche la génération de tout ce qu'on a prévu jusque là.


Pour le moment, il nous manque donc les .in ; c'est automake qui va les générer
à partir des .am :)
Et puis, on va appeler autoconf pour générer le configure

Pour dire à autoconf qu'on veut utiliser automake, on va ajouter une macro :
\verb+AM_INIT_AUTOMAKE()+
On va ajouter deux arguments : foreign pour dire qu'on veut pas les contraintes
d'un projet GNU et 1.11 pour la version minimale d'automake


Bon en fait on va utiliser \texttt{aclocal} :p
C'est pour préparer autoconf : pour récupérer les macros que l'on va utiliser
dans les fichiers.

Le but de M4 est de faciliter la maintenance, c'est plein de bouts de script
shell qui sont concaténé.

Allé hop, \texttt{automake} !
Hmmm ... il a besoin de certain script
\begin{itemize}
  \item \textbf{depcomp~:} comment le compilateur gère les dépendances
    (makedepend outdated : il regarde les fichiers dans tous les répertoires et
    calcul les dépendances pour chaque fichier et il génère un bout de makefile
    qui est à inclure. Mais c'est chiant, c'est pas automatisé, ...)~;\\
    La première fois qu'on compile, le compilateur se balade et détecte les
    dépendances entre les .h et les .c (avec des options louches -MT -MD) il
    inscrit les dépendances dans un fichier et c'est automatisé ! depcomp teste
    donc le compilateur pour déterminer les options à utiliser.
\end{itemize}

Pour avoir les scripts manquant on fait : \texttt{automake -ac}

Youpla, on lance \texttt{autoconf}. Il dit rien, mais il bosse dur !

C'est tout pour la partie mainteneur du paquet.

\subsection{Let's play !}

\texttt{./configure}

Il vérifie tout un tas de truc useless : faut lire il parle beaucoup trop vite.

Il prépare le mécanisme de dépendance et à la fin, il crée le Makefile.

Le Makefile est composé de régles classiques et d'une multitude de variables.

\texttt{make}

Bon ba voilà, ça compile donc ça marche !
Il y a plein de trucs sur la ligne de compilation : plein de \texttt{-D} qui
définissent des constantes (du style~: \texttt{HAVE\_STRNCMP} qui dit si strncmp
a un comportement correct, quand c'est mélangé avec autoconf, ça s'utilise
comme une constante de préprocesseur).
Le problème de l'approche c'est qu'elle est limité : on a moins d'une dizaine
d'options. Dans un grand projet, le compilo ou le shell peuvent dire que la
ligne est trop longue.
Pour ça, on peut demander à autoconf de générer un fichier config.h


\section{Mooooaaaaarrree}

Tips Doxygen \a dit que c'est un attribut ce qui suit.

\subsection{Ajouter une bibliothèque}

Nouvelle variable primaire : LIBRARIES, préfixée par le nom du répertoire où se
sera installé.

Idem, on prend le nom de la lib à générer (libgreet.a) qui devient le
préfixe. Puis on ajoute les SOURCES...

Si on fait les choses bien, \texttt{make} devrait tout régénérer si on modifie
comme ça !

Arg, il a pas trouvé RANLIB pour faire des lib. M'enfin, il dit qu'il faut le
rajouter...

Tips \texttt{nm} : on peut utiliser c++filt pour retirer le mangling :
\texttt{nm libgreet.a | c++filt}

\subsection{Utiliser la bibliothèque}

Cette fois, on a une dépendance. Il ne faudra donc pas oublié de dire qu'on a
besoin de la libgreet !
On utilise pour ça le suffixe \texttt{LDADD}, on indique ensuite le nom de la
lib à utiliser.


\section{Suite de tests}

\texttt{TESTS} : appel un ou plusieurs programmes

Dans les machins, si on remplace le préfixe \texttt{bin} par \texttt{check}, le
programme ainsi listé ne sera compilé que si on lance un \texttt{make check}.

\subsection{make distcheck}

Tarball via dist + detar ailleurs + check

"Parallel build" : on peut se placer dans un dossier build par exemple et
appeler ../configure. Il va alors tout compiler dans ce dossier.
(genre, on se place dans le goinfre local pour éviter de compiler sur l'AFS)

Moment historique, faut verser une petite larme :( Le bocal avait l'air
compétent ... Lulz le boulot perdu car sauvé dans le goinfre effacé à 3h42 :p

Tips pour débugger : \texttt{../configure CXXFLAGS="-O0 -g"} à faire dans un
répertoire \texttt{build\_debug}, avoir un autre répertoire \texttt{build\_fast}
avec \texttt{-O3 -DNDEBUG}, \ldots un build par architecture, \ldots

\paragraph{C'est parti~!}

Il trouve pas un fichier : hop on l'ajoute dans le Makefile.am :
\texttt{EXTRA\_DIST}.

Maintenant, il ne trouve pas un fichier qui a une adresse relative ! Vu que
distcheck est dans un répertoire \texttt{build/}.

Il faut changer le script~: le générer (il sera donc généré dans le builddir).
On crée donc \texttt{test-cat.in}~:

On ajoute la variable \texttt{@srcdir@} à l'endroit où l'on veut que se soit
remplacé.
Dans le \texttt{configure.ac}, on ajoute un fichier à générer aux côtés du
Makefile. Arf, mais il est pas exécutable dans ce cas. Donc, on lui dit que
c'est exécutable en ajoute un second argument qui est une commande qui est
exécuté après~: \texttt{[chmod +x mon-test]}

