[phobos] Initial Phobos style guide proposal

Jacob Carlborg doob at me.com
Thu Mar 31 11:21:57 PDT 2011


On 31 mar 2011, at 17:57, David Simcha wrote:

> In general I think this discussion is devolving into silly bikeshed issues.  I find that the stuff being discussed here doesn't have much effect on readability (I can read code in lots of styles) but is annoying to have to remember when writing code.  

I actually do think it effects the readability when someone squeezes in to much code vertically.

> I'm fully on board with specifying anything that affects the public API.  For private implementation details, though, I think inconsistency across modules is the lesser of two evils compared to fighting all these stupid bikeshed wars over what the One True Way will be for Phobos.  I think the most important rule is to just be consistent within a module.  When maintaining a module written by someone else, try to adapt your style to what you see.  When writing a new module, just use common sense and don't do anything horribly unreadable.
> 
> On Thu, Mar 31, 2011 at 11:37 AM, Andrei Alexandrescu <andrei at erdani.com> wrote:
> On 3/31/11 10:13 AM, Jacob Carlborg wrote:
> I sugest people start using an editor that handles the *'s automatically.
> 
> Mine does, but in past discussions people have complained about overly specific requirements for editor capabilities.
> 
> Andrei
> 
> _______________________________________________
> phobos mailing list
> phobos at puremagic.com
> http://lists.puremagic.com/mailman/listinfo/phobos
> 
> _______________________________________________
> phobos mailing list
> phobos at puremagic.com
> http://lists.puremagic.com/mailman/listinfo/phobos

-- 
/Jacob Carlborg

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.puremagic.com/pipermail/phobos/attachments/20110331/a5d18bc4/attachment.html>


More information about the phobos mailing list