On Sunday, 18 December 2011 at 01:30:10 UTC, Jonathan M Davis
wrote:
On Saturday, December 17, 2011 09:21:42 Justin C Calvarese
wrote:
On Sat, Dec 17, 2011 at 5:56 AM, jdrewsen
<jdrew...@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
Nice to see that something is in progress. Please also add a note
about acronyms in names then.
/Jonas
