[jira] [Comment Edited] (GROOVY-8242) Javadoc for Newify is missing some attribute values

["Eric Milles (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/GROOVY-8242?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16073794#comment-16073794 ] 

Eric Milles edited comment on GROOVY-8242 at 7/4/17 3:07 PM:
-------------------------------------------------------------

But the value attribute does not have a default value.  So if none is set, I get warnings that I must set it.


was (Author: emilles):
But the value attribute does not have a default value.  So if none is set, I get warnings that I must set value.

> Javadoc for Newify is missing some attribute values
> ---------------------------------------------------
>
>                 Key: GROOVY-8242
>                 URL: https://issues.apache.org/jira/browse/GROOVY-8242
>             Project: Groovy
>          Issue Type: Bug
>            Reporter: Eric Milles
>            Priority: Minor
>
> I was looking at thw Newify AST transform.  Some of the Javadoc appears incorrect since the annotation requires a value.
> {code}
>  * or this ("Ruby-style"):
>  * <pre>
>  * {@code @Newify} class MyTreeProcessor {  --  Is this supposed to be @Newify([Tree,Leaf])?
>  *     def myTree = Tree.new(Tree.new(Leaf.new("A"), Leaf.new("B")), Leaf.new("C"))
>  *     def process() { ... }
>  * }
>  * </pre>
> {code}
> {code}
>  * An example showing how to use the annotation at different levels:
>  * <pre>
>  * {@code @Newify(auto=false, value=Foo)}
>  * class Main {
>  *     {@code @Newify} // turn auto on for field  --  Is this supposed to be @Newify(BigInteger)?
>  *     def field1 = java.math.BigInteger.new(42)
>  *     def field2, field3, field4
>  *
>  *     {@code @Newify(Bar)}
>  *     def process() {
>  *         field2 = Bar("my bar")
>  *     }
>  *
>  *     {@code @Newify(Baz)}
>  *     Main() {
>  *         field3 = Foo("my foo")
>  *         field4 = Baz("my baz")
>  *     }
>  * }
>  * </pre>
> {code}



--
This message was sent by Atlassian JIRA
(v6.4.14#64029)