Worst Phobos documentation evar!

[Joseph Rushton Wakeling via Digitalmars-d]

On 31/12/14 14:50, Joseph Rushton Wakeling via Digitalmars-d wrote:
> Second and more importantly, I ran into some tricky cases implementing Params:
> lists for functions that have multiple overloads with different parameter lists.

Slightly more subtle variant of same: if the first, documented code is a struct 
or class definition, and the /// ditto'd code blocks are factory functions to 
generate instances of that code, you get the same warnings, and it means that 
_none_ of the parameters will have type info attached.  (Encountered with e.g. 
randomCover and randomSample.)

On the bright side, PR is in :-)
https://github.com/D-Programming-Language/phobos/pull/2831