[Issue 9737] std.net.curl and SSL - documentation missing

[d-bugmail at puremagic.com]

https://d.puremagic.com/issues/show_bug.cgi?id=9737



--- Comment #5 from Brad Roberts <braddr at puremagic.com> 2013-11-12 18:42:59 PST ---
I agree that the line of documentation added is not a 'how does https' work, or
even a 'what does libcurl need to have done to make https work'.  However, it
is a reasonable description of what that api does.

This issue boils down, I believe, to be essentially, libcurl was incompletely
setup on the reporters box and a faq entry would be handy.  A properly
installed libcurl  includes the cert bundle that libcurl uses automatically by
default, allows https urls to 'just work'.  For non-windows platforms, this is
done by the platforms' packaging of libcurl.  For the windows platform, it's
libcurl doesn't have one by default and the urls in the original report address
the situation pretty well.

So, some additional documentation near the top of the std.net.curl (and
etc.c.curl) would be useful.  A few pointers off to the those curl doc pages,
maybe one or two good https background docs.  However, I do not believe that
inside the phobos docs is a reasonable place to put documentation about the
general topic of how https works and even more generally how encryption works.

-- 
Configure issuemail: https://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------