Lisaac/Librairie Lisaac

Un article de Loria Wiki.

Norme

@Benoit, modifié : "Bon, déjà, j'aime pas les # ou tout autre caractère qui vont poluer le code source comme en Java. Je préfère établir des convensions drastiques pour le shorter.

Pour commencer, les commentaires sont dans cette position :

 - ma_function <-
 // Mon commentaire
 (
   debut de la fonction
 );

 - ma_data:INTEGER; // Mon commentaire
 
      ou

 - ma_data:INTEGER; 
 // Mon commentaire

Les commentaire sont toujours avec // et non /* */ les commentaires /* */ sont la pour désactiver des bouts de code, pas pour mettre un commentaire.

Ensuite, dans les commentaires la syntaxe sera la suivantes: // Cela commence par une explication de la fonction `ma_function' // On ne répéte pas le profil, (elle est déjà juste au dessus). // Pour les paramètres: // - `param1' : un tiret, le nom du param en `', puis :, puis une // explication.

Grammaire:

"//" '*' idf {',' idf} ':'

Exemple

// * Idf:

// * English:
// kjgkgk jhg g

// * French:
// kjgjgjkgk
// jkkgjg

// * English,Note:
// Contenu de la note en anglais

// *French,Syntax, Parameter,name :
// position
// *French,Syntax, Parameter, type :
// INTEGER
// *French,Syntax, Parameter, description :
// description du paramètre

// Rmq.:

[modifier]