[ 
https://issues.apache.org/jira/browse/AVRO-152?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Philip Zeyliger updated AVRO-152:
---------------------------------

    Attachment: AVRO-152.patch.txt

Finally got a chance to re-visit this.  Attaching a new patch; it applies 
against trunk.

I added "doc" messages to protocols.

bq. Note that this will require that the specific compiler generate a 
per-interface constant with the protocol definition, which is probably a good 
idea anyway. (Currently we use reflection to re-construct specific protocols, 
which is fragile.)

I'm not quite sure what you mean here.  Docs aren't being generated when a 
schema is retrieved via reflection.

I haven't added per-parameter docs (akin to "@param" in javadoc) yet.  That's a 
natural next thing to do, though.  I'd like to get this in with the current 
functionality, though.

-- Philip

> Adding "doc" to record schemas, a la javadoc field and class comments.
> ----------------------------------------------------------------------
>
>                 Key: AVRO-152
>                 URL: https://issues.apache.org/jira/browse/AVRO-152
>             Project: Avro
>          Issue Type: New Feature
>            Reporter: Philip Zeyliger
>            Assignee: Philip Zeyliger
>         Attachments: AVRO-149.patch.txt, AVRO-152.patch.txt, 
> AVRO-152.patch.txt, AVRO-152.patch.txt
>
>
> The patch to follow adds "doc" to the understood schema language (for records 
> and enums), and uses said doc when it generates java in SpecificCompiler.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Reply via email to