More ddoc complaints

[Stewart Gordon]

On 08/04/2012 02:08, Adam D. Ruppe wrote:
> I have a pull request up to remove the big misfeature
> of embedded html in ddoc, and it is pending action,
> from me, to answer some of Walter's concerns.

What have you done - just made it convert < > & in documentation 
comments to < > & before processing?

What is the user who wants some output format other than HTML or XML to do?

<snip>
> http://arsdnet.net/web.d/std_dom.html#Form.addValueArray
>
> It is extremely difficult to document a HTML library
> when your HTML examples are mis-interpreted as
> markup!

Create LT, GT and AMP macros and use them in your code examples.

> Also, ddoc should outdent the code examples:
>
> http://arsdnet.net/web.d/std_cgi.html#Cgi.request
>
> The examples are indented in my source to line up
> with the declarations, but this indentation doesn't
> make sense in the output!

I agree.  Ddoc should remove the lowest common level of indentation from 
each code sample it picks up.

Stewart.

Stewart.