        -------------------------------------------
                         chemeq V1.10-1 
        -------------------------------------------
                              (c)2000 G. Khaznadar
                  <georgesk@boltz.univ-littoral.fr>
        -------------------------------------------

chemeq est un filtre simple et autonome crit en langage C,
flex et bison. Il accepte des entres telles que :
2H2 + O2 ---> 2 H2O
et produit sur sa sortie standard du code LaTeX et des messages relatifs
 l'quilibre d'une quation de raction chimique.

exemple:~/src$ echo "2H2 + O2 ---> 2 H2O" | chemeq -lc
2\,H_{2}\,+\,O_{2}\,\rightarrow\,2\,H_{2}O
OK
exemple:~/src$


ce qui signifie : 2 molcules de dihydrogne ragissent avec une molcule de
dioxygne pour donner deux molcules d'eau.
La premire ligne, "2\,H_{2}\,+\,O_{2}\,\rightarrow\,2\,H_{2}O" est une
rcriture de l'quation en langage LaTeX.
La deuxime ligne "OK" signifie que l'quation de raction est quilibre.


Quand la chane d'entre n'est pas reconnue, le filtre choue et 
renvoie un code 1.

exemple:~/src$ echo "2H^2 + O2 ---> 2 H2O" | chemeq -lc
ERROR parse error at 4
exemple:~/src$

NOTE : syntaxe des ions.
Bien que dans certains cas, une expression plus courte soit accepte,
il est prfrable de mettre une flche haute (^) devant les symboles
de charge d'un ion.
Exemples : H3O^+, Fe(CN)6^4-, OH^-

NOTE : crochets
L'criture de crochets est autorise autour de la notation d'un corps simple,
comme pour [Fe(CN)6]4-, et seulement dans ce cas.

NOTE : constantes d'quilibre chimique.
Pour les quilibres chiliques, la constante pour l'quation de Gulder-Waage
ou le potentiel pour l'quation de Nernst peut tre crite  la fin de
l'quation, entre parenthses. Voir quelques exemples dans src/test.1, et
typographiez-les grce  LaTeX par la commande src/chemreport

Ce filtre peut tre utilis au sein de systmes d'examens ducatifs,
pour analyser la rponse d'un tudiant  un problme de physique ou
de chimie.

Ce petit bout de code est sous GPL, voyez le fichier COPYING.

Les suggestions sont bienvenues.

--
Georges.

-----------------------------------------------------------
			Les options de chemeq
-----------------------------------------------------------

On peut choisir le format de sortie de chemeq en spcifiant quelques options.
Les options valides sont les suivantes :


  -h	produit un message d'aide en anglais (*H*elp)
  -m	Produit une sortie *M*inimale. Ainsi chemeq est idempotent,
	c'est  dire que les commandes 'chemeq | chemeq' et 'chemeq' sont
	quivalentes.
  -l	Prouduit une chane *L*atex reprsentant l'quation chimique.
  -c	Produit un message donnant des indications sur la *C*onservation des
	lments et des charges. 'OK' signifie que les lments et les charges
	sont conservs.
  -w	Produit la chane LaTeX qui reprsente l'quation de Gulder-*W*aage
	relative  l'quation chimique, ou l'quation de Nernst, si l'quation
	de dpart est une demi-raction rdox.
  -n	Produit une chane *N*ormalise reprsentant l'quation de dpart.
	Deux quations chimiques ayant la mme chane normalise sont 
	chimiquement quivalentes, mme si l'ordre des molcules est diffrent,
	et si les coefficients ne sont pas gaux mais proportionnels.

Par dfaut, 'chemeq' est quivalent  'chemeq -mlcwn'.

-----------------------------------------------------------
			INSTALLATION
-----------------------------------------------------------
Pour compiler chemeq, lancez 'make' dans le rpertoire principal chemeq.
Pour l'installer avec sa page de manuel, lancez 'make install' dans ce
mme rpertoire.

-----------------------------------------------------------
			TEST et DEMONSTRATION
-----------------------------------------------------------

Si on modifie le code source, il est possible de tester sa conformit
aux versions prcdentes en lanant 'make test' dans le rpertoire principal.

Si 'make test' rpond 'OK'  chaque item, et que latex et xdvi sont installs,
on peut lancer 'make demo' pour voir quelques exemples de traitement 
typographique.
