What is the WSDL syntax to populate the "Description" column in the html table? about wsdl2html

[chenjianjx]

Just did a research. This is hard to implement (have to extract javadoc from generated java files). And even if you do, its help is limited:

• WSDL Documentation for services and operations can be extracted, because they can show up in generated java files . See https://javaee.github.io/metro/doc/user-guide/ch03.html#generating-javadocs-from-wsdl-documentation
• WSDL Documentation for operations' params can't be extracted because JAX-WS won't put them into java files
• WSDL Documentation in schemas, that is, docs for data classes and their fields, can't be extracted because JAX-WS won't put them into java files

(Also see javaee/jaxb-v2#172)

Their last one may be the most the important one. If it can't be done, then the whole efforts are not worth it

[chenjianjx]

You are right. It's not implemented. Sorry, don't get bandwidth to do it. Have to parse generated java files and extract javadocs. See (https://javaee.github.io/metro/doc/user-guide/ch03.html#generating-javadocs-from-wsdl-documentation)

Pull requests are welcome.

[sco0ter]

I'd be happy to see this feature as well. It's even trickier for my application: We have Java classes, org.apache.cxf:cxf-java2ws-plugin generates WSDL and your plugin generates the documentation from it.

From first glance it's hardly possible to even generate <xs:documentation> tags from JavaDoc (with cxf).