D2: std.algorithm.find, but get part before what you were searching for

[Steven Schveighoffer]

On Thu, 04 Mar 2010 03:55:40 -0500, Jonathan M Davis  
<jmdavisProg at gmail.com> wrote:

> On a side note, it would be great if we could figure out a way to make  
> the
> docs more user-friendly - especially in std.algorithm. The functions are
> great, and they're really versatile, but that seems to come at the cost  
> of
> incredibly nasty signatures. It can make it hard to find the function  
> itself
> among all of its parameters and its return type (especially the return
> type). Right now, I'd expect it to scare a fair number of potential users
> away. What the best solution would be, I don't know (perhaps making it so
> that it lists information on the function without its signature and then
> lists the signature at the end, or maybe we could find some way to give  
> an
> abstracted signature which gave the basic idea without all of the  
> details),
> but right now std.algorthm is definitely scary-looking. It's got great
> stuff, but the docs could definitely use some improvement.

It is an issue with DDoc.  I think the signatures are not that nasty if  
you look at the actual code.  I think DDoc expands all aliases so you get  
the full template-expanded signature.

-Steve