<html><body><div style="color:#000; background-color:#fff; font-family:arial, helvetica, sans-serif;font-size:12pt"><div><span>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.</span></div><div style="color: rgb(0, 0, 0); font-size: 16px; font-family: arial,helvetica,sans-serif; background-color: transparent; font-style: normal;"><br><span></span></div><div style="color: rgb(0, 0, 0); font-size: 16px; font-family: arial,helvetica,sans-serif; background-color: transparent; font-style: normal;"><span>-Steve</span></div><div style="color: rgb(0, 0, 0); font-size: 16px; font-family: arial,helvetica,sans-serif; background-color: transparent; font-style: normal;"><br><span></span></div><div style="color: rgb(0, 0, 0); font-size: 16px; font-family: arial,helvetica,sans-serif; background-color: transparent; font-style: normal;"><span>P.S. aren't
all style guide discussions some form of bikeshedding?<br></span></div><div><br><blockquote style="border-left: 2px solid rgb(16, 16, 255); margin-left: 5px; padding-left: 5px;"><div style="font-family: arial,helvetica,sans-serif; font-size: 12pt;"><div style="font-family: times new roman,new york,times,serif; font-size: 12pt;"><font face="Arial" size="2"><hr size="1"><b><span style="font-weight: bold;">From:</span></b> David Simcha <dsimcha@gmail.com><br><b><span style="font-weight: bold;">To:</span></b> Discuss the phobos library for D <phobos@puremagic.com><br><b><span style="font-weight: bold;">Sent:</span></b> Thursday, March 31, 2011 11:57 AM<br><b><span style="font-weight: bold;">Subject:</span></b> Re: [phobos] Initial Phobos style guide proposal<br></font><br> <meta http-equiv="x-dns-prefetch-control" content="off"><div id="yiv1139000366">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. <br>
<br>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.<br>
<br><div class="yiv1139000366gmail_quote">On Thu, Mar 31, 2011 at 11:37 AM, Andrei Alexandrescu <span dir="ltr"><<a rel="nofollow" ymailto="mailto:andrei@erdani.com" target="_blank" href="mailto:andrei@erdani.com">andrei@erdani.com</a>></span> wrote:<br><blockquote class="yiv1139000366gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
<div class="yiv1139000366im">On 3/31/11 10:13 AM, Jacob Carlborg wrote:<br>
<blockquote class="yiv1139000366gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
I sugest people start using an editor that handles the *'s automatically.<br>
</blockquote>
<br></div>
Mine does, but in past discussions people have complained about overly specific requirements for editor capabilities.<br><font color="#888888">
<br>
Andrei</font><div><div></div><div class="yiv1139000366h5"><br>
_______________________________________________<br>
phobos mailing list<br>
<a rel="nofollow" ymailto="mailto:phobos@puremagic.com" target="_blank" href="mailto:phobos@puremagic.com">phobos@puremagic.com</a><br>
<a rel="nofollow" target="_blank" href="http://lists.puremagic.com/mailman/listinfo/phobos">http://lists.puremagic.com/mailman/listinfo/phobos</a><br>
</div></div></blockquote></div><br>
</div><meta http-equiv="x-dns-prefetch-control" content="on"><br>_______________________________________________<br>phobos mailing list<br><a ymailto="mailto:phobos@puremagic.com" href="mailto:phobos@puremagic.com">phobos@puremagic.com</a><br><a href="http://lists.puremagic.com/mailman/listinfo/phobos" target="_blank">http://lists.puremagic.com/mailman/listinfo/phobos</a><br><br></div></div></blockquote></div></div><br>
</body></html>