Re: [8u] Review request: (RT-37168) Mention if a property is configurable via CSS in the javadocs.

2014-05-22 Thread Kevin Rushforth
I'll comment in JIRA a bit later; as a quick note, though, there are two places in the build.gradle that need to be updated. -- Kevin David Grieve wrote: Only if someone runs javadoc without adding a "-tag css" arg, which will result in an 'unknown tag' error. On 5/22/14, 3:35 PM, Stephen F

Re: [8u] Review request: (RT-37168) Mention if a property is configurable via CSS in the javadocs.

2014-05-22 Thread David Grieve
Time. And, even with the annotation, the tag would still be needed - http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#annotations On 5/22/14, 5:00 PM, Tom Schindl wrote: The real question is why javadoc tag and not a real annotation which would be toolable much easi

Re: [8u] Review request: (RT-37168) Mention if a property is configurable via CSS in the javadocs.

2014-05-22 Thread Tom Schindl
The real question is why javadoc tag and not a real annotation which would be toolable much easier! Tom On 22.05.14 21:42, David Grieve wrote: > Only if someone runs javadoc without adding a "-tag css" arg, which will > result in an 'unknown tag' error. > > On 5/22/14, 3:35 PM, Stephen F Northov

Re: [8u] Review request: (RT-37168) Mention if a property is configurable via CSS in the javadocs.

2014-05-22 Thread David Grieve
Only if someone runs javadoc without adding a "-tag css" arg, which will result in an 'unknown tag' error. On 5/22/14, 3:35 PM, Stephen F Northover wrote: Hi David, I didn't see a problem with this. Is there a downside to adding arbitrary tags to JavaDoc? Steve On 2014-05-22 3:23 PM, Davi

Re: [8u] Review request: (RT-37168) Mention if a property is configurable via CSS in the javadocs.

2014-05-22 Thread Stephen F Northover
Hi David, I didn't see a problem with this. Is there a downside to adding arbitrary tags to JavaDoc? Steve On 2014-05-22 3:23 PM, David Grieve wrote: Steve, Kevin, I'm looking for your ok on a change to rt/build.gradle that will allow me to add @css tags in javadoc. The diff is in the bug