Human unreadable documentation - the ugly seam between simple D and complex D

[CraigDillabaugh via Digitalmars-d]

On Friday, 27 March 2015 at 14:02:55 UTC, CraigDillabaugh wrote:
clip
>
> If the function inputs are trivial (ie. takes an integer or 
> basic
> string) then this isn't an issue. But for functions taking 
> complex
> inputs it can be a bit baffling for someone new to the language.
>
> I must admit when I was new to phobos I struggled with the use 
> of
> unittests as examples, especially for functions taking
for functions taking ranges or other non-trivial inputs.

>
> Anyway, unittests are better than nothing - if that is the other
> option.