¿Cómo configuro DoxyGen para documentar los archivos de ActionScript?¿Puedo usar DoxyGen para documentar el código de ActionScript?
He incluido los archivos * .as y * .asi en el patrón de búsqueda de doxygen, pero las clases, funciones y variables no se muestran allí.
En lugar de doxygen, debe utilizar un generador de documentación que admita específicamente el idioma. Para ActionScript 2, que tiene un par de opciones:
Si está utilizando ActionScript 3, Adobe incluye un generador de documentación libre junto con su compilador de fuente abierta (Flex SDK), llamado "ASDoc". Si está usando FlashDevelop, el latest beta tiene una GUI incorporada para ejecutar ASDoc, por lo que no tiene que ensuciarse las manos con la línea de comandos.
que he sido capaz de producir algún tipo de documentación con Doxygen (¿Qué puedo decir - Me gustan sus características y capacidades) de la siguiente manera:
añadir * * .as y .ASI a la lista de archivos tipos para ingresar.
Seleccionar:
OPTIMIZE_OUTPUT_JAVA = YES
EXTRACT_ALL = YES
HIDE_UNDOC_MEMBERS = NO
HIDE_UNDOC_CLASSES = NO
Otro tema en AS3 es la sentencia de paquete. Necesita decirle a DoxyGen que ignore la definición del paquete. Esto es fácil de hacer usando cond. Así que va a cambiar la línea:
package myPackage {
en
/// @cond
package myPackage {
/// @endcond
lo que hará que Doxygen hacer caso omiso de la línea (s) entre cond y endcond. Tenga en cuenta que no parece haber necesidad de hacer lo mismo para el corchete de cierre en la parte inferior de su archivo .as.
También puede usar Ortelius. Es más fácil de usar que ASDoc, ya que viene con una GUI simple, y es más perdonable para tu código. Es gratuito y de código abierto, pero solo para Windows.
No funciona para mí. Doxygen no reconoce la gramática de AS3 en absoluto. Analiza incorrectamente los cuerpos de función como "Funciones de miembro público", etc. –