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