Blah

1 files changed, 40 insertions, 5 deletions

diff --git a/doc/description.tex b/doc/description.tex
index 0ad1062..4924468 100644
--- a/doc/description.tex
+++ b/doc/description.tex
@@ -23,15 +23,50 @@ décroissants ( il est à noter que le tri est effectué par construction, on ne fa
 de type tri de monome ). Cet ordre de tri est très pratique pour des algorithmes comme la division ou l'addition.
 Comme dans le module précédent, nous y avons ajouté une routine de conversion d'un polynome en une chaine de caractères formatée
 dépendant notamment de la variable globale smartprint.
-
 \subsection{fonctions.c}
 
 
-\section{module d interprétation des lignes de commande}
-parser.c pile.c numbers.c
+
+
+
+
+\section{Module d'interprétation des lignes de commande}
+\subsection{parser.c}
+Ce module est la clé de voute de notre ensemble. Il est décrit plus en détail dans la section suivante. Il s'occupe de lire
+une chaîne qui lui a été passé par l'interface, et va la décomposer en une série d'appel vers une pile, codée dans un autre module.
+Il va simplement dégager les opérateurs et les opérandes pour les fournir à la pile sous la forme d'une pile polonaise inversée.
+\subsection{pile.c}
+Ce module possède principalement deux fonctions (push\_pile() et act\_pile()) qui sont appelées par le parser. La fonction
+push\_pile() va tenter de dégager une opérande de l'entrée qui est faite sous forme d'une string. En particulier, elle va tenter
+d'analyser l'entrée suivant trois critères:
+\begin{itemize}
+\item Est-ce un entier?
+\item Est-ce un flottant?
+\item Est-ce une variable déjà enregistrée?
+\end{itemize}
+En cas d'échec de ces trois critères, elle considèrera qu'il s'agit d'un symbole. La fonction act\_pile() va simplement
+dépiler suffisemment d'opérande de la pile, effectuer l'opération demandée, et réinsérer le résultat sur la pile.
+\subsection{numbers.c}
+Ce tout petit module contient des fonctions qui peuvent convertir n'importe quelle chaîne contenant un nombre en son équivalent.
+char\_to\_number() est capable de convertir un entier écrit en décimal, octal ou héxadécimal. char\_to\_rat() se charge de lire
+un nombre flottant et de le stocker directement dans notre structure 'rationnel'.
 
 \section{Modules de saisie et  d'affichage}
-interface.c terminal.c
+\subsection{interface.c}
+Ce module est l'interface de saisie. Les fonctions implémentées ne sont pas portables, au sens où elles dépendent du
+terminal utilisé, en particulier pour l'usage des touches droites, gauches, F3, CTRL-C, insert, home et end. Mais dans
+tous les cas, elles seront capable de lire une entrée "classique", ne présentant aucun caractère particulier. Une fois la
+touche 'entrée' enfoncée, elle va appeler la fonction parse\_line(), provenant du module parser.c.
+\subsection{terminal.c}
+Ces quelques fonctions nous permettent d'initialiser le terminal à notre convenance. Ces fonctions sont typiques UNIX et
+nous servent à imiter le comportement DOS de la fonction getche() en ce qui concerne l'entrée au clavier. En particulier,
+une fois la fonction initterm() appelée, il n'y a plus d'écho à l'écran des touches enfoncées, et surtout, chaque touche
+enfoncée est disponible immédiatement dans le buffer d'entrée.
 
 \section{Module de gestion des erreurs}
-exceptions.c
+\subsection{exceptions.c}
+Ce module nous sert à "imiter" le comportement C++ des exceptions. Dans un premier temps, nous pouvons faire appel aux fonctions
+pushcontext() et popcontext() pour empiler ou dépiler un contexte d'erreur. Ensuite, un appel à exception() va se traduire
+par un affichage sur stderr de la pile de contexte en cours, et du message d'erreur donné en paramètre. Un deuxième paramètre
+sert à indiquer le niveau de l'exception (erreur fatale ou non). Si une erreur fatale se produit, le programme sort directement.
+Si une erreur non fatale se produit, toutes les piles sont vidées et la main est rendue à l'interface.