First experience with std.algorithm: I had to resort to writinga

[Nick Sabalausky]

"KennyTM~" <kennytm at gmail.com> wrote in message 
news:hume1m$310o$1 at digitalmars.com...
>
>   Take!(Sequence!("a.field[0] + n * 
> a.field[1]",Tuple!(CommonType!(B,E),uint))) iota(B, E)(B begin, E end);
>
> A better representation is
>
>   auto iota(B, E)(B begin, E end);
>
> Granted, this means some information is lost when reading the signature, 
> but no one is going to actually use the Take!(Sequence!whatever)) type 
> directly, why bother.

Yea, definitely agree. But, of course, there should also be an explanation 
of what type the caller can expect it to return, since auto is dependant on 
implementation and, by itself, doesn't tell the person reading the docs 
anything. Or maybe something like:

{simple description here} iota(B, E)(B begin, E end);

Example:
{element type of range T} getFirstElement(T)(T range);

Or:
{elementTypeOfRange} getFirstElement(T)(T range);
    {elementTypeOfRange}: If needed, a more complete explanation goes here.

I'm doing some things like that for the documentation for Goldie (The 
documentation's still incomplete and only in trunk though. But I'm working 
on it...when I have time...)

>
> (There's no need to modify ddoc, just add a Javascript on the page is 
> enough.)
>

Ugh, oh dear God, no!