So... let's document dmd

[tsbockman via Digitalmars-d]

On Saturday, 16 January 2016 at 07:52:11 UTC, Jack Stouffer wrote:
> dmd is now in D; theoretically that should allow for other 
> projects to import from it like a normal D project. So why not 
> make all of the ddmd modules available from any code that is 
> complied with it, i.e. just like Phobos?
>
> The parser was just an example, there are any number of things 
> that one could use from the code base.

That would be cool in theory, but it would likely become a major 
drag on development of the compiler itself.

Once you start promoting the compiler's internals as part of the 
standard library, you can expect sooner or later that pressure 
will mount to bring them up to the same high standards of API 
design and stability as Phobos.

While this process would be beneficial to the overall quality of 
the DMD code being exposed, it would also turn internal 
refactorings into public breaking changes. I really doubt that's 
a good trade-off at this point in DMD's development.