Comentários Flex/ ActionScript

Question

Não é possível exibir os comentários no arquivo ActionScript ao executar asdoc. Este é um bug conhecido?

[Bindable]
/** test comment */
public var currentSearchTextValue:String;

Não mostra nada na documentação gerada ... estou fazendo algo errado?

Answer 1

[Bindable] Na verdade, gera código que envolve a propriedade, para que não seja possível. Tente mover [Bindable] Após os seus comentários, mas falhando que você pode estar sem sorte, tenho medo.

Answer 2

Embora eu não veja nada de errado aqui, seguiria as melhores práticas do ASDOC - colocando os comentários em linha separada com um asterisco anteriores, conforme sugerido aqui E veja se isso funciona.

[Bindable]
/**
* Test comment
*/
public var currentSearchTextValue:String;

Answer 3

Estou tendo o mesmo problema e publiquei uma pergunta detalhada aqui. Sem respostas ainda.

Uma solução alternativa é usar um nome de evento junto com a tag bindable

[Bindable("someEvent")]
/*
* asdoc comment
* */
public var currentSearchTextValue:String;

Mas esse wud exige que você despache "algum evento" manualmente para obter trabalho vinculativo. Então você pode querer usar isso para gerar ASDOC sozinho e alterá -lo de volta para a versão mais antiga depois.