On 24/07/2015 10:21 AM, Keegan Witt wrote:
I noticed when looking at a package summary, all I can see is "Licensed to the 
Apache Software Foundation (ASF) under one or more contributor license agreements." 
as the description for every class.  For example, see here: 
http://docs.groovy-lang.org/latest/html/gapi/groovy/lang/package-summary.html
Have we discussed addressing this already?  Or should I open a documentation 
Jira?

If you replace latest with next in the url, you'll see the same problem isn't 
there. We had briefly the header comment accidentally having /** at the 
beginning instead of /*. I fixed it in master but looks like I didn't realise 
the problem also existed in 2_4_X. We can hopefully use the original commits 
(there may have been more than one) and merge them back into 2_4_X. I can do it 
but might not get time for a few days.

Also, are we considering creating package-info.html / package-info.java files?

We have some package.html files but not many package-info.groovy (or Java) 
files.  At one point such files caused problems for Grails (was it Tomcat's 
classloader having issues with classnames containing hyphens?). I think we 
excluded/disabled some part of our package-info support. So it might be easy to 
re-enable but we'll need to test with Grails.

Cheers, Paul.

---
This email has been checked for viruses by Avast antivirus software.
https://www.avast.com/antivirus

Reply via email to