You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@cxf.apache.org by "Aleksander Adamowski (JIRA)" <ji...@apache.org> on 2009/10/21 10:31:59 UTC
[jira] Created: (CXF-2486) Specify units for method arguments where
relevant
Specify units for method arguments where relevant
-------------------------------------------------
Key: CXF-2486
URL: https://issues.apache.org/jira/browse/CXF-2486
Project: CXF
Issue Type: Task
Components: Documentation
Reporter: Aleksander Adamowski
There are places in javadoc, where there's no way to know what kinf of unit is accepted for a numeric argument. E.g.:
timeout values in HTTPClientPolicy (http://cxf.apache.org/javadoc/latest/org/apache/cxf/transports/http/configuration/HTTPClientPolicy.html).
After closer inspection of the code it seems that the values are in milliseconds. Adding this simple information in Javadoc would be of great help to many developers.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Updated: (CXF-2486) Specify units for method arguments where
relevant
Posted by "Daniel Kulp (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/CXF-2486?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Daniel Kulp updated CXF-2486:
-----------------------------
CXF Fields: [Blocked on External]
> Specify units for method arguments where relevant
> -------------------------------------------------
>
> Key: CXF-2486
> URL: https://issues.apache.org/jira/browse/CXF-2486
> Project: CXF
> Issue Type: Task
> Components: Documentation
> Reporter: Aleksander Adamowski
>
> There are places in javadoc, where there's no way to know what kinf of unit is accepted for a numeric argument. E.g.:
> timeout values in HTTPClientPolicy (http://cxf.apache.org/javadoc/latest/org/apache/cxf/transports/http/configuration/HTTPClientPolicy.html).
> After closer inspection of the code it seems that the values are in milliseconds. Adding this simple information in Javadoc would be of great help to many developers.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
[jira] Commented: (CXF-2486) Specify units for method arguments
where relevant
Posted by "Daniel Kulp (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/CXF-2486?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12768272#action_12768272 ]
Daniel Kulp commented on CXF-2486:
----------------------------------
The class for this (and thus the javadoc) is generated via JAXB from the schema. The schema does have proper annotation/documentation things in it. See:
http://cxf.apache.org/schemas/wsdl/http-conf.xsd
This is really a JAXB bug:
https://jaxb.dev.java.net/issues/show_bug.cgi?id=172
Feel free to vote on it there, but with 72 votes already, it's obviously not something they care too much about. :-(
I was going to comment on their issue pointing back to here, but they seem to have taken away my ability to comment there. dev.java.net has had a BUNCH of issues lately so something might be amiss there.
> Specify units for method arguments where relevant
> -------------------------------------------------
>
> Key: CXF-2486
> URL: https://issues.apache.org/jira/browse/CXF-2486
> Project: CXF
> Issue Type: Task
> Components: Documentation
> Reporter: Aleksander Adamowski
>
> There are places in javadoc, where there's no way to know what kinf of unit is accepted for a numeric argument. E.g.:
> timeout values in HTTPClientPolicy (http://cxf.apache.org/javadoc/latest/org/apache/cxf/transports/http/configuration/HTTPClientPolicy.html).
> After closer inspection of the code it seems that the values are in milliseconds. Adding this simple information in Javadoc would be of great help to many developers.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.