> C'est exact toutes mes classes ne sont pas au meme endroit.
> Il y a les classes flash, les classes du noyau et mes classes.
> Comment lui dire alors de ne pas créer une doc de toutes les classes.
> Je n'ai pas besoin de documenter les classes de flash ou celles de mon
> collegue, je veux juste les miennes.
> Merci pour asdocr mais je n'ai pas les droits d'admin de mon poste...
> donc pas d'adobe air 2.0 et de asdocr. :(
>
> Pour ce qui est des classes de mon collegues, il n'y a qu'une seule
> classe que j'utilise dont ma classe principale en hérite.
> Le reste de mes classes persos n'utilisent que les classes de flash.
>
> Comment faire?
>

plusieurs choix pour exclure des classes

doc
http://livedocs.adobe.com/flex/3/html/help.html?content=asdoc_9.html
"
* If you specified the class by using the exclude-classes option, the
class is not documented.
* If the ASDoc comment for the class contains the @private tag, the
class is not documented.
* If the class is found in a SWC, the class is not documented.
"

a) tu compiles tes dépendences en swc

   <compiler.library-path dir="${basedir}/${lib}"
includes="foobar.swc" />

   toutes les classes dans foobar.swc ne seront pas documentées
   c'est la solution la plus simple

   le truc chiant c'est qu'il faut générer le swc avant


b) tu utilises <exclude-classes class="" />

   cad que pour chaque classes que tu ne veux pas documenter tu dois
mettre une entrée
   <exclude-classes class="com.foobar.test.Hello" />
   <exclude-classes class="com.foobar.test.World" />
   etc.

   ce qui peut etre assez chiant à la longue si tu as beaucoup de
classes a exclure

c) tu ajouts @private dans le header de la class

   chiant si qlqn veut générer la doc de cette class dans un autre
projet/build

d) tu utilises le metadata [ExcludeClass] dans le header de la class

   ca fera comme @private avec le truc chiant (ou feature) que en plus
   tu n'auras pas la completion de syntax sur cette class


donc dans ton cas p-e utiliser les SWC de flash pour ne pas avoir a
les documenter
cad que la build de ton swf peut utiliser les sources *.as
mais tu peux pour asdoc utiliser les *.swc


et comme tu n'as pas bcp de classes a exclure tu peux utiliser
<exclude-classes class="" />


apres les projets ca grossit, et si tu commences à avoir 3+ projets
interdépendants
au niveau des classes mais avec des doc différentes, bah là il faudra
gérer avec les swc

zwetan

-- 
Vous recevez ce message, car vous êtes abonné au groupe Google Groupes FCNG.
Pour envoyer un message à ce groupe, adressez un e-mail à [email protected].
Pour vous désabonner de ce groupe, envoyez un e-mail à l'adresse 
[email protected].
Pour plus d'options, consultez la page de ce groupe : 
http://groups.google.com/group/fcng?hl=fr

Répondre à