More ddoc complaints

[Stewart Gordon]

On 09/04/2012 14:34, Adam D. Ruppe wrote:
> On Monday, 9 April 2012 at 11:05:10 UTC, Stewart Gordon wrote:
<snip>
>> Create LT, GT and AMP macros and use them in your code examples.
>
> There's two problems with that: 1) it is hideous
> and 2) what if the user wants some format other
> than html?

Then they would define LT, GT and AMP differently.

> Suppose your format escapes \. Should I defensively
> make a $(BACKSLASH) macro too?
<snip>

No, since you don't have any idea in what formats I might want to 
generate docs for your lib.  But I would know I need to be on the 
lookout for characters that have a special meaning in my chosen output 
format.

But indeed, the ESCAPES macro is a much better solution.

Stewart.