RFC curl

[Jonathan M Davis]

On Wednesday, November 09, 2011 17:05 Simen Kjærås wrote:
> On Thu, 10 Nov 2011 01:25:29 +0100, Walter Bright
> 
> <newshound2 at digitalmars.com> wrote:
> > On 11/9/2011 4:24 PM, Walter Bright wrote:
> >> On 11/9/2011 12:53 PM, Jonas Drewsen wrote:
> >>> Before sending it for official review again I would really like some
> >>> comments on
> >>> the new API and if you think it is better or worse etc.
> >>> 
> >>> http://freeze.steamwinter.com/D/web/phobos/etc_curl.html
> >> 
> >> Thank you so much for doing this. I think it's a nice piece of work.
> > 
> > I forgot to mention: I like the cheat sheet a lot.
> 
> Indeed. I am tempted to argue all of our docs should have that.

It's essentially what std.algorithm does now, and std.container does something 
similar. I'd love to do something like that with std.datetime, but the fact 
that the anchors that ddoc generates have no concept of hiearchy (e.g. every 
year function in the file gets #year for its anchor rather than something like 
#Date.year, #DateTime.year, etc.). So, I couldn't provide any links in such a 
cheat sheat. I think that one or two people have said that they'd look into 
fixing it, but no one has actually fixed it yet. If no one else fixes it any 
time soon, I may be forced to go dig into ddoc to figure it out myself, which 
is definitely not where I want to be spending my time if I can avoid it.

- Jonathan M Davis