makes sense to show these (version X11), but that could be done using dmd and a special flag instead of having to rely on a new parser (which would need to be kept updated)
On Thu, Feb 8, 2018 at 6:49 AM, Adam D. Ruppe via Digitalmars-d-learn <digitalmars-d-learn@puremagic.com> wrote: > On Thursday, 8 February 2018 at 09:42:08 UTC, Timothee Cour wrote: >> >> I guess you mean `version(StdDdoc)` ? >> >> On that note, I see things like this, which are not DRY: > > > This is actually one of the reasons why I abandoned dmd for my dpldocs.info > fork and used an independent parser. > > dmd tries to build docs as it builds the program, but these are slightly > contradictory - when building the program, you need to honor versioned out > blocks. When building the docs, you just want it documented, not ignored. > dmd is (rightfully) prioritized toward building actual code, but that leaves > doc generation a bit second-hand. > > To work around dmd's clashing goals, version(StdDdoc) manually makes a > separate doc branch. > > Whereas my doc generator just shows them all, bringing the version into the > definition. > http://dpldocs.info/experimental-docs/arsd.simpledisplay.XDisplayConnection.html >