Updating ddoc to support modern HTML tags
Gary Willoughby via Digitalmars-d
digitalmars-d at puremagic.com
Mon Apr 20 12:42:42 PDT 2015
I've just done a little bit of work on the ddoc documentation and
it was brought to my attention that the HTML output of ddoc is
actually quite old. Some of the current tags are deprecated. I've
raised this as an issue here:
https://issues.dlang.org/show_bug.cgi?id=14473
Before starting on any work however, I thought there should be a
discussion on what impact this would have and what tags should be
used instead.
Here's a list of the current ddoc symbols (and tag output) that
IMHO would need updating:
https://gist.github.com/nomad-software/333cd658ad88090dcb0a
and here are some proposed substitutions:
https://gist.github.com/nomad-software/20d2ab1f7d4c9e55a343
The changes seem quite simple but I'm wondering what knock on
effect this would have on anything else? Can you see any problems
this might create? Any comments on the new tags used?
The following files would need updating:
https://github.com/D-Programming-Language/dmd/blob/master/src/doc.c#L143-L186
https://github.com/D-Programming-Language/dlang.org/blob/master/ddoc.dd#L687-L720
More information about the Digitalmars-d
mailing list