Michael McCandless created LUCENE-4010:
------------------------------------------

             Summary: AttributeSource api has broken documentation due to java 
generics bug
                 Key: LUCENE-4010
                 URL: https://issues.apache.org/jira/browse/LUCENE-4010
             Project: Lucene - Java
          Issue Type: Improvement
          Components: general/javadocs
            Reporter: Michael McCandless
            Priority: Minor


There seems to be a javadocs generation bug, whereby generic type params are 
not properly escaped.  So if you use <A> as a type param (which we do in 
AttributeSource.java), it produces invalid HTML.  The bug seems to be fixed in 
java 7...

You can see the bug here (search for "after adding"):

    
http://lucene.apache.org/core/old_versioned_docs/versions/3_5_0/api/all/org/apache/lucene/util/AttributeSource.html

The <A> generic type is gone, and that closing paren is red but should be blue.

The 3.6.0 javadocs are OK because we used java7 to generate them...

I think we should avoid <A> to workaround it until we are on java 7...

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: 
https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to