glob2-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [glob2-devel] User Manual


From: Martin Voelkle
Subject: Re: [glob2-devel] User Manual
Date: Mon, 11 Aug 2003 16:54:29 +0200
User-agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.4) Gecko/20030714 Debian/1.4-2

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.







reply via email to

[Prev in Thread] Current Thread [Next in Thread]