Feature Request - Raw HTML in ddoc comments

Leandro Lucarella llucax at gmail.com
Fri Feb 22 12:40:28 PST 2008


Janice Caron, el 22 de febrero a las 08:51 me escribiste:
> On 22/02/2008, Walter Bright <newshound1 at digitalmars.com> wrote:
> > Janice Caron wrote:
> >  > Hi, I'd love to put raw HTML inside ddoc comments,
> >
> > You can do it now. Just put it in! But I don't recommend it, as then the
> >  output is restricted to HTML.
> 
> Bah! HTML is now the single most portable document format on the
> planet. It is almost trivial to convert from HTML to any other format.
> I would think that it would be not too hard to remove the restriction
> that you mention.

But HTML sucks for writing documentation! It's a great format for
computers but a PITA for humans. I think ddoc should use something more in
the lines of ReStructuredText[1].

[1] http://docutils.sourceforge.net/docs/user/rst/quickref.html

-- 
Leandro Lucarella (luca) | Blog colectivo: http://www.mazziblog.com.ar/blog/
----------------------------------------------------------------------------
GPG Key: 5F5A8D05 (F8CD F9A7 BF00 5431 4145  104C 949E BFB6 5F5A 8D05)
----------------------------------------------------------------------------
Ingeniero Juanjo Charlante, Linux es como una mermelada?



More information about the Digitalmars-d mailing list