Bug 1427 – Generated .di files look ugly and are hard to read

Header files can be a good source of documentation for competent programmers. By stripping out all the implementation cruft, a header file gives you a concise summary of all the types and functions a module provides in a format that is easy to navigate and search with a simple text editor. HTML Docs provide a concise summary too, but require firing up a browser and since we are programmers who spend the majority of our time writing code, it's usually easier to just open up a header file than dig through a bunch of web pages. So the point of all this is to say that .di files should be generated with a human reader in mind. Currently the generated files throw away almost all formatting, which makes them very hard for a human to read. There's no reason why the di generator can not also be a source beautifier at the same time, generating source code with even more consistent indentation and formatting than the original code.

D2 patch: https://github.com/D-Programming-Language/dmd/pull/538

Commits pushed to master at https://github.com/D-Programming-Language/dmd https://github.com/D-Programming-Language/dmd/commit/8664473ee4bf6bc5d51e390a697848afe769eced Issue 1427 - Generated .di files look ugly and are hard to read https://github.com/D-Programming-Language/dmd/commit/0c93ce24e80087ad2beb59db723955dbd5e2715b Merge pull request #538 from 9rnsr/fix1427 Issue 1427 - Generated .di files look ugly and are hard to read

Fixed for D2 only.

Closing as WONTFIX as this has been fixed in D2.