[ 
http://jira.xwiki.org/jira/browse/XWIKI-2043?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_22052
 ] 

Vincent Massol commented on XWIKI-2043:
---------------------------------------

An alternative to consider is to move restricted APIs to another class/API.

Note that if we were to use the javadoc tag we could also move to JDK 1.5 and 
then use a real annotation and automatically generate the rights check in the 
annotation. This would serve as both a check and in the javadoc too.


> The API javadoc should mention which methods require programming rights
> -----------------------------------------------------------------------
>
>                 Key: XWIKI-2043
>                 URL: http://jira.xwiki.org/jira/browse/XWIKI-2043
>             Project: XWiki Platform
>          Issue Type: Improvement
>          Components: Build, Infrastructure and Tests, Documentation & 
> xwiki.org
>    Affects Versions: 1.2
>            Reporter: Sergiu Dumitriu
>            Priority: Minor
>
> We should add a new javadoc tag, @programming or @restricted, so that a 
> developer can quickly see if a method requires programming rights or not.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: 
http://jira.xwiki.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        
_______________________________________________
notifications mailing list
[email protected]
http://lists.xwiki.org/mailman/listinfo/notifications

Reply via email to