Como escrevo um comentário para um item que defini no Flex?

Question

Quero adicionar um comentário a alguns elementos em um documento flexível e processar os comentários usando o ASDOC. Eu posso fazer isso facilmente para a parte do script, mas acabo com uma tonelada de feia "Esta propriedade pode ser usada como fonte de ligação de dados". mensagens para cada elemento que declarei no Flex.

Existe alguma maneira de incorporar um comentário em um elemento flexível para que ele possa ser lido pelo ASDOC? Eu tentei usar o padrão

<!-- --> 

Notação, mas isso não parecia funcionar.

EDIT: A notação parece ser engolida como um comentário HTML, presumo que você saiba como é ...

Answer 1

Você está tentando colocar comentários na marcação?

De acordo com a documentação flexível aqui, "Como o formato de um comentário do ASDOC usa a Sintaxe do ActionScript, você só pode inserir um comentário ASDOC em um bloco de um arquivo MXML".

Answer 2

Sem ver seu código, é um pouco difícil dizer exatamente o que está acontecendo. Nada sobre asdocs deve estar gerando um erro de compilador vinculável. Você está recebendo esse erro do compilador Flex ou do compilador ASDOC? Você está tentando documentar um documento MXML ou um documento ActionScript?

Você leu esses documentos?

Sobre ActionScript:

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

E em Mxml? Os comentários do MXML ASDOC devem usar três traços, não 2 para o primeiro marcador de comentários. Assim:

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

Answer 3

Você pode usar esses // e / * * / (dentro de blocos de ação) para comentar um uso do nó MXML <!-- and end with -->