Improving ddoc

[Jacob Carlborg via Digitalmars-d]

On 2015-01-02 15:12, Mathias LANG wrote:

> I don't see it being useful for Phobos, or any other library. Have one
> doc with the public API available, optionally another one for the
> framework/lib devs (but those often prefers the code).

I see that being useful for any open source library. I don't mind having 
an option to enable/disable generating documentation for private symbols.

> Strongly agree for the constraints. For __FILE__ & __LINE__, what would
> it affects ? I can think of exception-related stuff, anything else ?

A perfect example where this is a big issue is the upcoming std.logger 
[1]. It looks absolutely horrible. Every logging functions has five of 
these arguments and in 99.99% of the cases you do not need to pass these 
arguments manually.

[1] http://burner.github.io/phobos/phobos-prerelease/std_logger_core.html

-- 
/Jacob Carlborg