[
https://issues.apache.org/jira/browse/AVRO-1472?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13933854#comment-13933854
]
Hudson commented on AVRO-1472:
------------------------------
SUCCESS: Integrated in AvroJava #444 (See
[https://builds.apache.org/job/AvroJava/444/])
AVRO-1472. Java: Clarify parse method in getting started guide. Contributed by
Michael Knapp. (cutting: rev 1577264)
* /avro/trunk/CHANGES.txt
* /avro/trunk/doc/src/content/xdocs/gettingstartedjava.xml
> Usage of Parser is Wrong in Getting Started Guide
> -------------------------------------------------
>
> Key: AVRO-1472
> URL: https://issues.apache.org/jira/browse/AVRO-1472
> Project: Avro
> Issue Type: Improvement
> Affects Versions: 1.7.4, 1.7.5, 1.7.6
> Reporter: Michael Knapp
> Assignee: Doug Cutting
> Priority: Minor
> Fix For: 1.7.7
>
>
> In the Getting Started Guide for java, in the "Serializing and deserializing
> without code generation" section, for versions 1.7.3 and later, I still see
> this:
> Schema schema = new Parser().parse(new File("user.avsc"));
> This is COMPLETELY confusing to people, I am assuming now that you have
> imported org.apache.avro.Schema.Parser, but that is not clear to the users.
> There is also a class in avro called org.apache.avro.io.parsing.Parser, most
> users would look at your "Parser" in the example and think you are talking
> about "org.apache.avro.io.parsing.Parser", when you are actually talking
> about "org.apache.avro.Schema.Parser"
> I just wasted the last hour of my life trying to figure this out. Please fix
> your documentation. Either tell people exactly what parser you are
> importing, or explicitly state it like this:
> Schema schema = new Schema.Parser().parse(in);
--
This message was sent by Atlassian JIRA
(v6.2#6252)
