[castor-dev] SourceGenerator annotation to javadoc question

[PETER . SCHAFFRATH]

Hi,

I have a problem with generating javadoc comments from the a XML schema
using annotation/documentation tags. Isn't it possible to get schema
documentation for a simple type into the generated java code?

If this topic has already been discussed here, please provide a hint to the
topic. I couldn't find anything in the list archive. Thanks a lot!

Detailed example:

A simple schema with only 2 elements looks like this:

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema";>
        <xsd:element name="Command" type="xsd:string">
                <xsd:annotation>
                        <xsd:documentation>
                                Command description.
                        </xsd:documentation>
                </xsd:annotation>
        </xsd:element>
        <xsd:element name="Command_Query">
                <xsd:annotation>
                        <xsd:documentation>
                                Executes a command.
                        </xsd:documentation>
                </xsd:annotation>
                <xsd:complexType>
                        <xsd:sequence>
                                <xsd:element ref="Command"/>
                        </xsd:sequence>
                </xsd:complexType>
        </xsd:element>
</xsd:schema>

A class "Command_Query" is generated with correct comment. But the "Command"
documentation does not show up in the java code. The valid parts look like:

/**
 * Field _command
 */
private java.lang.String _command;

/**
 * Method getCommandReturns the value of field 'command'.
 * 
 * @return the value of field 'command'.
*/
public java.lang.String getCommand()
{
    return this._command;
} //-- java.lang.String getCommand() 

/**
 * Method setCommandSets the value of field 'command'.
 * 
 * @param command the value of field 'command'.
 */
public void setCommand(java.lang.String command)
{
    this._command = command;
} //-- void setCommand(java.lang.String) 

It would be perfect if the ducomentation from the schema would show up at
the get and set methods...

Thanks, Peter

----------------------------------------------------------- 
If you wish to unsubscribe from this mailing, send mail to
[EMAIL PROTECTED] with a subject of:
        unsubscribe castor-dev