dpldocs: xlinking and Documented destructors and postblits

Adam D. Ruppe via Digitalmars-d digitalmars-d at puremagic.com
Wed Mar 1 16:06:17 PST 2017


On Wednesday, 1 March 2017 at 23:21:14 UTC, Seb wrote:
> https://github.com/dlang/phobos/pulls?utf8=%E2%9C%93&q=is%3Apr%20label%3Adocumentation%20
>
> Most of these changes are independent from 
> Ddoc/Ddox/Adrdox/..., so everyone should be able to enjoy 
> cleaner documentation soon.

Actually, almost none of that affects me! (Except perhaps causing 
more merge conflicts for me when I pull, alas, but that's the 
downside of doing a fork. I already killed most the LUCKY links, 
for example, and the booktables are redundant (though basically 
harmless) with my automatically generated listings.

My diff from upstream is now over 5300 lines long, including a 
mix of formatting, syntax, linking, and some content changes...

> @Adam: I like your docs as well!
> Have you ever considered adding vibe.d to them?

Once I'm happy with it, I might scrape code.dlang.org and pull it.

Though it is important to note that adrdox does NOT support 
user-defined ddoc macros, so not everything with ddoc will just 
work. I hardcoded a bunch of the common Phobos ones, but my goal 
ideally is to eliminate most macros in favor of things taking 
care of themselves with lightweight syntax (which ironically, was 
part of ddoc's original charter!)


More information about the Digitalmars-d mailing list