From: ES <ruby-ml@...>
Date: 2005-10-20T13:14:08+09:00
Subject: Re: Method annotation and anonymous functions

stevetuckner wrote:
> <snip intro>
 >
> Annotated functions:
> 
> class A
>    def foo(a, b)
>    .visibility   :private      # how can this be parsed? (the above line 
> has no trailing marker to signal it as one expression
>    .returns Integer
>    begin
>        ....
>    end
> 
>    def foo2(a, b).visibility(private).returns(Integer) { ... }
> 
>    f3 = def foo3(a,b)
>    end
>      f3.visibility(:private).returns(Integer)

Oh please no! Annotations are, as can be inferred from the name, comments on the
code. Could we just keep these in the comment section? Then we will have a tool
which reads the documentation and can

1) Do RDoc-like external documentation
2) embed documentation in the code itself (in the objects or as separate data)
3) do both 1 and 2 at the same time
4) do nothing if the user wants to disable it.


 > <snip rest>
> 
> Steve Tuckner

E