[jira] Commented: (XMLBEANS-117) Missing documentation

["Robert H. Pollack (JIRA)" <xm...@xml.apache.org>]

    [ https://issues.apache.org/jira/browse/XMLBEANS-117?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12469814 ] 

Robert H. Pollack commented on XMLBEANS-117:
--------------------------------------------

FYI, the reason this is a major issue is that the problem appears in *generated* code.  The warnings from JavaDoc (and there can be literally hundreds of them) appear when you JavaDoc the source code generated by XMLBeans.  (Doing this can often be a useful way of seeing how to navigate the objects that correspond to your XSD elements.)

The links given in earlier comments on this issue all show you methods for fixing such warnings by changing your source code.  This is not an option when the source code is generated.

> Missing documentation
> ---------------------
>
>                 Key: XMLBEANS-117
>                 URL: https://issues.apache.org/jira/browse/XMLBEANS-117
>             Project: XMLBeans
>          Issue Type: Bug
>    Affects Versions: Version 1.0.3, Version 1.0.4, Version 2 Beta 1
>         Environment: Compiling with Ant 1.6 , using javadoc
>            Reporter: Yair Ohayon
>            Priority: Trivial
>         Attachments: build.xml
>
>
> After generating code with xmlbeans compiler , and linking properly to the reference .
> Javadoc announces warning about missing link - XMLInputStream, and about the self generated clss system.s276527457457(some number).

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@xmlbeans.apache.org
For additional commands, e-mail: dev-help@xmlbeans.apache.org