Feature Request - Raw HTML in ddoc comments

Derek Parnell derek at psych.ward
Sat Mar 1 19:51:51 PST 2008


On Sat, 1 Mar 2008 23:13:53 +0000, Janice Caron wrote:

> On 01/03/2008, Walter Bright <newshound1 at digitalmars.com> wrote:
>> Janice Caron wrote:
>>  > In general, any tool which converts SRC -> DST needs to escape all
>>  > characters which would be considered markup in DST.
>>
>> That is not possible, because ddoc cannot escape every markup in every
>>  possible output format past, present, and future. ddoc is output
>>  agnostic - the output is controlled by the macro expansion text.
> 
> Could you be clearer? I don't know what "macro expansion text" means.
> Is that the same thing as ddoc source? If so, then you just said "the
> output is controlled by the input", which is obvious, but incomplete.
> If not, then what is this "macro expansion text" of which you speak?
> 
> Coz, if the "macro expansion text" is what decides how to make HTML,
> then this "macro expansion text" is the thing that should be escaping
> that which needs to be escaped.

Everything that we've been saying re Ddoc is already documented in the DMD
distribution. Read through http://www.digitalmars.com/d/2.0/ddoc.html.

-- 
Derek Parnell
Melbourne, Australia
skype: derek.j.parnell



More information about the Digitalmars-d mailing list