cxf-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Daniel Kulp (JIRA)" <j...@apache.org>
Subject [jira] Commented: (CXF-2486) Specify units for method arguments where relevant
Date Wed, 21 Oct 2009 15:04:59 GMT

    [ 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.


Mime
View raw message