You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@camel.apache.org by "James Strachan (JIRA)" <ji...@apache.org> on 2008/06/24 11:29:00 UTC

[jira] Created: (CAMEL-632) hack the XSD generator (patching JAXB's mvn plugin) so that the javadoc is included in the generated XSD as documentation

hack the XSD generator (patching JAXB's mvn plugin) so that the javadoc is included in the generated XSD as documentation
-------------------------------------------------------------------------------------------------------------------------

                 Key: CAMEL-632
                 URL: https://issues.apache.org/activemq/browse/CAMEL-632
             Project: Apache Camel
          Issue Type: Improvement
            Reporter: James Strachan
            Assignee: Jonas Lim
             Fix For: 1.5.0


In tools like Eclipse/IDEA there is smart completion when editing the XML with the XSD; however there's no documentation for elements/attributes.

We should extract the JavaDoc from the Java code and include it into the generated XSD. There's an existing issue here...

https://jaxb.dev.java.net/issues/show_bug.cgi?id=369

as part of this we need to improve the javadoc too :)



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


[jira] Commented: (CAMEL-632) hack the XSD generator (patching JAXB's mvn plugin) so that the javadoc is included in the generated XSD as documentation

Posted by "Claus Ibsen (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/activemq/browse/CAMEL-632?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=59367#action_59367 ] 

Claus Ibsen commented on CAMEL-632:
-----------------------------------

We wont hack the JAXB generator as we use pure JAXB now. But that ticket was target for JAXB 2.1.13 which is the next release. So may SUN get it into the JAXB eventually.

> hack the XSD generator (patching JAXB's mvn plugin) so that the javadoc is included in the generated XSD as documentation
> -------------------------------------------------------------------------------------------------------------------------
>
>                 Key: CAMEL-632
>                 URL: https://issues.apache.org/activemq/browse/CAMEL-632
>             Project: Apache Camel
>          Issue Type: Improvement
>            Reporter: James Strachan
>
> In tools like Eclipse/IDEA there is smart completion when editing the XML with the XSD; however there's no documentation for elements/attributes.
> We should extract the JavaDoc from the Java code and include it into the generated XSD. There's an existing issue here...
> https://jaxb.dev.java.net/issues/show_bug.cgi?id=369
> as part of this we need to improve the javadoc too :)

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


[jira] Commented: (CAMEL-632) hack the XSD generator (patching JAXB's mvn plugin) so that the javadoc is included in the generated XSD as documentation

Posted by "James Strachan (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/activemq/browse/CAMEL-632?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=44505#action_44505 ] 

James Strachan commented on CAMEL-632:
--------------------------------------

are you still working on this Jonas, or could someone else dive in?

> hack the XSD generator (patching JAXB's mvn plugin) so that the javadoc is included in the generated XSD as documentation
> -------------------------------------------------------------------------------------------------------------------------
>
>                 Key: CAMEL-632
>                 URL: https://issues.apache.org/activemq/browse/CAMEL-632
>             Project: Apache Camel
>          Issue Type: Improvement
>            Reporter: James Strachan
>            Assignee: Jonas Lim
>             Fix For: 1.5.0
>
>
> In tools like Eclipse/IDEA there is smart completion when editing the XML with the XSD; however there's no documentation for elements/attributes.
> We should extract the JavaDoc from the Java code and include it into the generated XSD. There's an existing issue here...
> https://jaxb.dev.java.net/issues/show_bug.cgi?id=369
> as part of this we need to improve the javadoc too :)

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


[jira] Commented: (CAMEL-632) hack the XSD generator (patching JAXB's mvn plugin) so that the javadoc is included in the generated XSD as documentation

Posted by "James Strachan (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/activemq/browse/CAMEL-632?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=44583#action_44583 ] 

James Strachan commented on CAMEL-632:
--------------------------------------

Yeah - I think we need to hack the RI code to fix this. We can submit a patch to them (they've been responsive in the past - I've submitted a number of patches in the past, particularly in the Java -> XSD generation part).

In a short term we could have our own custom build of the RI for XSD generation (which we did for quite a while - as I'd fixed a load of issues with the Java -> XSD generation).

So I'd say, lets 

* patch the RI code to fix this
* submit a patch to the RI
* we use our own build of the RI for XSD generation only - until the RI contains our patch

> hack the XSD generator (patching JAXB's mvn plugin) so that the javadoc is included in the generated XSD as documentation
> -------------------------------------------------------------------------------------------------------------------------
>
>                 Key: CAMEL-632
>                 URL: https://issues.apache.org/activemq/browse/CAMEL-632
>             Project: Apache Camel
>          Issue Type: Improvement
>            Reporter: James Strachan
>            Assignee: Jonas Lim
>             Fix For: 1.5.0
>
>
> In tools like Eclipse/IDEA there is smart completion when editing the XML with the XSD; however there's no documentation for elements/attributes.
> We should extract the JavaDoc from the Java code and include it into the generated XSD. There's an existing issue here...
> https://jaxb.dev.java.net/issues/show_bug.cgi?id=369
> as part of this we need to improve the javadoc too :)

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


[jira] Assigned: (CAMEL-632) hack the XSD generator (patching JAXB's mvn plugin) so that the javadoc is included in the generated XSD as documentation

Posted by "Claus Ibsen (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/activemq/browse/CAMEL-632?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Claus Ibsen reassigned CAMEL-632:
---------------------------------

    Assignee:     (was: Jonas Lim)

> hack the XSD generator (patching JAXB's mvn plugin) so that the javadoc is included in the generated XSD as documentation
> -------------------------------------------------------------------------------------------------------------------------
>
>                 Key: CAMEL-632
>                 URL: https://issues.apache.org/activemq/browse/CAMEL-632
>             Project: Apache Camel
>          Issue Type: Improvement
>            Reporter: James Strachan
>             Fix For: Future
>
>
> In tools like Eclipse/IDEA there is smart completion when editing the XML with the XSD; however there's no documentation for elements/attributes.
> We should extract the JavaDoc from the Java code and include it into the generated XSD. There's an existing issue here...
> https://jaxb.dev.java.net/issues/show_bug.cgi?id=369
> as part of this we need to improve the javadoc too :)

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


[jira] Resolved: (CAMEL-632) hack the XSD generator (patching JAXB's mvn plugin) so that the javadoc is included in the generated XSD as documentation

Posted by "Claus Ibsen (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/activemq/browse/CAMEL-632?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Claus Ibsen resolved CAMEL-632.
-------------------------------

    Fix Version/s:     (was: Future)
       Resolution: Won't Fix

> hack the XSD generator (patching JAXB's mvn plugin) so that the javadoc is included in the generated XSD as documentation
> -------------------------------------------------------------------------------------------------------------------------
>
>                 Key: CAMEL-632
>                 URL: https://issues.apache.org/activemq/browse/CAMEL-632
>             Project: Apache Camel
>          Issue Type: Improvement
>            Reporter: James Strachan
>
> In tools like Eclipse/IDEA there is smart completion when editing the XML with the XSD; however there's no documentation for elements/attributes.
> We should extract the JavaDoc from the Java code and include it into the generated XSD. There's an existing issue here...
> https://jaxb.dev.java.net/issues/show_bug.cgi?id=369
> as part of this we need to improve the javadoc too :)

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


[jira] Commented: (CAMEL-632) hack the XSD generator (patching JAXB's mvn plugin) so that the javadoc is included in the generated XSD as documentation

Posted by "Jonas Lim (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/activemq/browse/CAMEL-632?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=44522#action_44522 ] 

Jonas Lim commented on CAMEL-632:
---------------------------------

Hey James, just got back from a long break.  I'll go ahead  have a look at this. 

> hack the XSD generator (patching JAXB's mvn plugin) so that the javadoc is included in the generated XSD as documentation
> -------------------------------------------------------------------------------------------------------------------------
>
>                 Key: CAMEL-632
>                 URL: https://issues.apache.org/activemq/browse/CAMEL-632
>             Project: Apache Camel
>          Issue Type: Improvement
>            Reporter: James Strachan
>            Assignee: Jonas Lim
>             Fix For: 1.5.0
>
>
> In tools like Eclipse/IDEA there is smart completion when editing the XML with the XSD; however there's no documentation for elements/attributes.
> We should extract the JavaDoc from the Java code and include it into the generated XSD. There's an existing issue here...
> https://jaxb.dev.java.net/issues/show_bug.cgi?id=369
> as part of this we need to improve the javadoc too :)

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


[jira] Updated: (CAMEL-632) hack the XSD generator (patching JAXB's mvn plugin) so that the javadoc is included in the generated XSD as documentation

Posted by "Claus Ibsen (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/activemq/browse/CAMEL-632?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Claus Ibsen updated CAMEL-632:
------------------------------

    Fix Version/s:     (was: 2.0.0)
                   Future

> hack the XSD generator (patching JAXB's mvn plugin) so that the javadoc is included in the generated XSD as documentation
> -------------------------------------------------------------------------------------------------------------------------
>
>                 Key: CAMEL-632
>                 URL: https://issues.apache.org/activemq/browse/CAMEL-632
>             Project: Apache Camel
>          Issue Type: Improvement
>            Reporter: James Strachan
>            Assignee: Jonas Lim
>             Fix For: Future
>
>
> In tools like Eclipse/IDEA there is smart completion when editing the XML with the XSD; however there's no documentation for elements/attributes.
> We should extract the JavaDoc from the Java code and include it into the generated XSD. There's an existing issue here...
> https://jaxb.dev.java.net/issues/show_bug.cgi?id=369
> as part of this we need to improve the javadoc too :)

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


[jira] Commented: (CAMEL-632) hack the XSD generator (patching JAXB's mvn plugin) so that the javadoc is included in the generated XSD as documentation

Posted by "Jonas Lim (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/activemq/browse/CAMEL-632?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=44567#action_44567 ] 

Jonas Lim commented on CAMEL-632:
---------------------------------

I was initially thinking of creating a plugin for this but the schema generator class does not seem to be extensible  to be able to create a "plugin" to intercept it before the generated schema is written down to the xsd document.

the other  option here is to hack the jaxb ri and add this functionality


> hack the XSD generator (patching JAXB's mvn plugin) so that the javadoc is included in the generated XSD as documentation
> -------------------------------------------------------------------------------------------------------------------------
>
>                 Key: CAMEL-632
>                 URL: https://issues.apache.org/activemq/browse/CAMEL-632
>             Project: Apache Camel
>          Issue Type: Improvement
>            Reporter: James Strachan
>            Assignee: Jonas Lim
>             Fix For: 1.5.0
>
>
> In tools like Eclipse/IDEA there is smart completion when editing the XML with the XSD; however there's no documentation for elements/attributes.
> We should extract the JavaDoc from the Java code and include it into the generated XSD. There's an existing issue here...
> https://jaxb.dev.java.net/issues/show_bug.cgi?id=369
> as part of this we need to improve the javadoc too :)

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