Maybe the comment style is bikeshedding, but definitely the placement of comments always starting on the leftmost column affects the ability to read the code for me.
-Steve P.S. aren't all style guide discussions some form of bikeshedding? >________________________________ >From: David Simcha <[email protected]> >To: Discuss the phobos library for D <[email protected]> >Sent: Thursday, March 31, 2011 11:57 AM >Subject: Re: [phobos] Initial Phobos style guide proposal > > >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'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 <[email protected]> >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 >>[email protected] >>http://lists.puremagic.com/mailman/listinfo/phobos >> > >_______________________________________________ >phobos mailing list >[email protected] >http://lists.puremagic.com/mailman/listinfo/phobos > >
_______________________________________________ phobos mailing list [email protected] http://lists.puremagic.com/mailman/listinfo/phobos
