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

2014-05-22 Thread David Grieve

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. This isn't the 
fix for the bug, but if you don't want to allow the tag option, then I 
need to approach this bug in a different way.


https://javafx-jira.kenai.com/browse/RT-37168


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. This isn't the 
fix for the bug, but if you don't want to allow the tag option, then I 
need to approach this bug in a different way.


https://javafx-jira.kenai.com/browse/RT-37168




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, 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. This 
isn't the fix for the bug, but if you don't want to allow the tag 
option, then I need to approach this bug in a different way.


https://javafx-jira.kenai.com/browse/RT-37168






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 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, 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. This
 isn't the fix for the bug, but if you don't want to allow the tag
 option, then I need to approach this bug in a different way.

 https://javafx-jira.kenai.com/browse/RT-37168

 



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 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 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, 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. This
isn't the fix for the bug, but if you don't want to allow the tag
option, then I need to approach this bug in a different way.

https://javafx-jira.kenai.com/browse/RT-37168