[Issue 14680] Investigate the use of .di files for Phobos

via Digitalmars-d-bugs digitalmars-d-bugs at puremagic.com
Thu Jun 11 21:58:31 PDT 2015


https://issues.dlang.org/show_bug.cgi?id=14680

--- Comment #2 from Steven Schveighoffer <schveiguy at yahoo.com> ---
one thing to consider: Your error messages will go into the comment-less no-doc
versions, requiring you to go open the manual, or map the code back to the
original source if you don't see immediately what is happening in the source.

I don't know if it's a bad thing to require people to use the html docs, but I
know it's not going to go over well with some people. I'd say our doc
generation has to be really good in order to go this route.

Even with great HTML documentation, the inline comments may be invaluable when
reading the code that has failed.

The lack of unit tests would be awesome though. It would solve other problems
too -- such as the accidental building of unit tests from phobos templates in
user code.

--


More information about the Digitalmars-d-bugs mailing list