[metaas-dev] New comment block

[David Holroyd]

Hi there,

On Thu, Jul 19, 2007 at 08:39:46AM +0100, Hodges, Richard wrote:
[...]
>                         /**
>                          * TODO: Add your method comments here.
>                          * @param value : Object
>                          * @return String
>                          */
> 
> 
> This new comment block is added using the setDescription,
> setReturnDescription and  on ASMethod and getDocumentation to get to the
> DocComment for addParaTag.

FYI, you can also use ASMethod#getArgs() and then setDescription() on
each resulting ASArg object, if you where using addParaTag to create the
@param tags by hand.


> The problem I have is that the method signature
> is present on the same line as the newly generated end comment block tag
> e.g.
> 
>                         /**
>                          * TODO: Add your constructor comments here.
>                          */public function DateFormatter():void

Well, I use this stuff myself and dodn't see that problem.  Maybe
because I've been adding comments in 'new' .as files, rather than
modifying existing ones.  Are you doing the code generation on Windows?
I suspect there may be some hardcoded *nix-style "\n" line-endings in
various places.

I'll try to have a look into it soon.


ta,
dave

-- 
http://david.holroyd.me.uk/