Re: [glob2-devel] User Manual

[Martin Voelkle]

Martin S Nyffenegger wrote:

> > J'ai oublié de dire:
> >
> > - J'ai besoin de relecture. Surtout concernant sgsl. Certaines choses 
> > ne me semblaient pas clair, je les ai écrites autrement. D'autres 
> > m'ont donné beaucoup de mal à comprendre, j'ai essayé d'interpréter.
>
>
> je jette un coup d'oeuil ! ... ça va aussi (c.f. plus bas)
>
> > - Je n'ai rien compris à la syntaxe: quand faut-il mettre entre 
> > parenthèses, entre '_', entre '*'?
>
>
> JAMAIS. Aufait SGSL n'est pas finalisé donc pour le moment il s'en 
> fout (tu peux très bien faire un "show()()()((((,,,, "ce 
> text",,,,,.,.,))))) "  ). Quand le language sera terminé (on va devoir 
> ajouter des mots-clefs) on fixera la syntaxe à quelque chose de plus 
> intellignet. Pour le moment, c'est agréable de mettre les arguments à 
> un mot clef entre () et de les séparer avec des "," .
>
> donc c'est pas:
>
> flag*( name )*you
>
> mais
> flag (/name/) you

Pourquoi c'est pas flag(name, you)?
Faut-il remplacer *friend* (/player/ . /player/) par friend(player, 
player)?*
**activate* /player par activate(player)?
variable (level)(player)comparison value par variable(level, player, 
comparison, value)?
/*summon* (/globulesAmount/ _globuleType_ ( /playerInt/ . /level/ ) 
/flagName par summon(globulesAmount, globuleType, playerInt, level)/
/Faut-il ajouter des () aux fonctions qui n'ont pas d'arguments (hide, 
win, loose, story)?
/Tu peux corriger la page SgSl ou UserManualEnglish pour savoir quelle 
est la syntaxe qu'il faudra garder?

Il faudrait écrire une section sur les types, car mettre des * et des " 
au milieu des prototypes, c'est pas joli (et ça confond).

> > - Le docbook a foutu en l'air la syntaxe des keywords (c.f. source 
> > docbook), j'ai donc essayé de faire autrement pour les conditions. 
> > Qu'est-ce qui convient le mieux (comparer entre les pages SgSl et 
> > UserManualEnglish)?
>
>
> Les deux me vont.

A moi pas: les keywords ont des lignes inutiles, car docbook essaie de 
faire avec de la syntaxe c. Il faut soit typer sgsl pour que ces lignes 
deviennent utiles et lui donner une syntaxe c ou taper ces headers à la 
main (sans les tags docbook), comme je l'ai fait pour conditions.

> Parcontre il serait préférable de faire un tableau avec les levels des 
> maisons parce que ce qu'il y a dans UserManualEnglish est un peux 
> illisible.

C'est fait. L'ancienne formule était sensée s'afficher comme une table, 
mais apparament, ça dépend du xslt.

> En ce qui concerne l'installation (depuis le CVS) sous MacOS X j'ai 
> fait une description complète dans le fichier glob2/README

Qqun peut la retranscrire en docbook? merci. Au pire, les sections 
binary distribution, source distribution et cvs sont valides pour MacOS X.