Worst Phobos documentation evar!

[H. S. Teoh via Digitalmars-d]

On Wed, Dec 31, 2014 at 02:50:34PM +0100, 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.  As things are, it's convenient -- in terms
> of reading the code -- to have different functions ordered from simple
> to complex signatures, with one documentation block for the first, and
> everything else sharing the same documentation using /// ditto.
> However, this won't work with a Params: list because ddoc attempts to
> match listed parameters to those of the immediately following function
> signature.

This is a known issue:

	https://issues.dlang.org/show_bug.cgi?id=13270


T

-- 
Some ideas are so stupid that only intellectuals could believe them. -- George Orwell