allow XHTML inside wadl:doc

[TheConstructor]

Hi,

with the current version of your wadl.xsl any tag inside a wadl:doc-tag is discarded upon displaying.
To me a nice documentation should contain e.g. new-lines to be easy to read. To achieve this XHTML-tags like

or
are required.

I modified the wadl.xsl to copy tags contained in wadl:doc-tags for wadl:application and presumably most other wadl:doc-tags.

Please have a look into this pull-request.

Regards

Matthias

[restsql]

Matthias,

Thanks for trying to help make this better!

Unfortunately it makes it better for Chrome and Firefox but worse for IE9 and Xalan 2.7.1. The example block is formatted as regular text when running example_wadl.xml through IE9 or transforming it with Xalan. Enclosing it in pre seems to be the only cross-tool approach that carries through formatting.

I don't like the way the stylesheet decides if the block should be pre'd. Looking for the text 'Example' in the content is goofy. It requires users to understand to change their content to get it to work. Maybe there's another way to check if the content includes XML?

At the very least we can add the rel nofollow.

Please let me know what you'd like to do with the example formatting.

Mark