[Kos-dev] Diverses questions et remarques sur KOS

[Thomas Petazzoni]

Salut,

David MENTRE wrote:

>  1. comment je fais pour faire la doc doxygen du code ?

<attention-c-est-pourri>

$ cd modules
$ make doc
$ cd ../doc/src-html-doc
OU
$ cd ../doc/src-latex-doc

</attention-c-est-pourri>

Donc faut aller dans le répertoire modules pour générer la doc, mais 
elle est générée dans un autre répertoire. Oui, oui, c'est moisi ;-)

>  2. à votre place, je supprimerais toutes les docs obsolètes (style
>     genre babel), sauf s'il a besoin de migrer du contenu de l'ancienne
>     vers la nouvelle doc. Pour l'historique, CVS (ou mieux ;) est là
>     pour ça. Bon, à la réflexion, il y a peut-être des idées à y
>     repêcher. Mettre tout ça dans un répertoire historic/ ?

En fait, c'est le merdier. Y'a des docs dans le module CVS kos-doc, y'a 
des docs dans le module CVS kos, sous-répertoire doc, y'a des 
présentations dans le module kos-contrib. Bref, c'est le foutoir, et 
tout ça nécessite un coup de ménage.

J'ai envie de tout passer sous Subversion pour pouvoir faire des svn 
move facilement. Mais avant de me prendre la tête à faire ça, je voulais 
être sûr qu'il y aurait quelqu'un pour l'utiliser ;-)

>  3. dans toutes vos docs : s/éxécut/exécut/ ;

Oui, c'est moi ça. A chaque fois que j'écris un article pour SOS on me 
le dit, et je dois faire un M-%. Je sais pas pourquoi, je tiens 
absolument à ce é.

>  4. ce serait bien qu'il y a un "make html", "make dvi", etc. dans le
>     répertoire principal (kos/) ;

Boarf, tu chipotes. Suffit d'aller dans le répertoire doc et de faire 
make dvi, make ps, etc.. ;-)

>  5. dans le répertoire doc/, ce serait bien de mettre un index.html avec
>     un pointeur sur les docs à lire, dans leur ordre d'importance (comme
>     sur le site web en fait, très bien fait du reste).

Bonne idée.

Thomas
-- 
PETAZZONI Thomas - thomas.petazzoni at enix.org
http://thomas.enix.org - Jabber: thomas.petazzoni at jabber.dk
KOS: http://kos.enix.org/ - SOS: http://sos.enix.org
Fingerprint : 0BE1 4CF3 CEA4 AC9D CC6E  1624 F653 CB30 98D3 F7A7