¿Cómo se escribe un comentario de un artículo que se define en la flexión?

Question

Quiero dejar un comentario a algunos elementos en un documento Flex y procesar los comentarios usando ASDoc. Puedo hacer esto fácilmente para la porción de la escritura, pero terminar con un montón de feo "Esta propiedad se puede utilizar como fuente para el enlace de datos." mensajes para cada elemento declaré en Flex.

¿Hay alguna manera de incrustar un comentario en un elemento flexible para que pueda ser leído por ASDoc? He intentado usar el estándar

<!-- --> 

notación, pero eso no parece funcionar.

EDIT: La notación parece ser tragado como un comentario HTML, supongo que sabes lo que parece ...

Answer 1

¿Estás tratando de poner comentarios en el marcado?

De acuerdo con la documentación Flex aquí "Debido a que el formato de un comentario ASDoc utiliza la sintaxis de ActionScript, sólo se puede insertar un comentario ASDoc en un bloque de un archivo MXML."

Answer 2

Sin ver su código es un poco difícil saber exactamente lo que está pasando. Nada sobre ASdocs debe generar un error del compilador enlazable. ¿Usted está consiguiendo que el error del compilador de Flex o el compilador ASDoc? ¿Estás tratando de documentar un documento MXML o un documento ActionScript?

¿Ha leído estos documentos?

ActionScript :

/**
* Your Comment Goes Here
*/
ActionScript Element

Y en MXML ? MXML ASDoc comentarios deben usuario tres guiones, no 2 para el primer marcador de comentario. De esta manera:

<!--- Your comment goes here -->
MXML Element

Answer 3

Puede utilizar estos // y / * * / (dentro de los bloques de ActionScript) Para comentar una <!-- and end with --> uso nodo MXML