Second Round CURL Wrapper Review

[Jonathan M Davis]

On Saturday, December 17, 2011 09:21:42 Justin C Calvarese wrote:
> On Sat, Dec 17, 2011 at 5:56 AM, jdrewsen <jdrewsen at nospam.com> wrote:
> > On Thursday, 15 December 2011 at 07:46:56 UTC, Jonathan M Davis wrote:
> >>> ...
> >  
> >  I'd argue that the acronyms should be in all caps if camelcasing would
> >  
> >> require that the first letter of the acronym be capitalized and all
> >> lower case if camelcasing would require that the first letter of the
> >> acronym be lower case. We're not completely consistent in how we
> >> using acronyms in names in Phobos, but I believe that we primarily
> >> follow that rule when putting them in symbol names. So, for instance,
> >> it would be HTTP, FTP, and SMTP rather than Http, Ftp, and Smtp.
> > 
> > I like Http better as personal taste. But if HTTP is preferred then I'll
> > do that. Actually I think I will make a pull request to extend the
> > dlang.org/dstyle.html doc with and example that we can point to when
> > someone asks about styling. I've spend too much time restyling because
> > there is no such style doc already and people are complaining about
> > style
> > in reviews anyway.
> 
> I absolutely agree that the "D Style" page should be revised and extended
> to reflect the current standards that new Phobos modules are expected to
> adhere to.
> 
> I found an open pull request that indicates a past effort in this regard:
> https://github.com/D-Programming-Language/d-programming-language.org/pull/16
> 
> (I thought that another document was also floating around that was a
> proposed new "Style Guide for Phobos", but I don't recall who authored it
> and I don't remember where it was located.)

Yeah. I need to get back to that. Portions of it were completely agreed upon 
and others need further discussion, and I keep forgetting to get those 
discussed among the Phobos devs and get those questions settled.

- Jonathan m Davis