<html><head></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div><div>On 31 mar 2011, at 17:25, David Simcha wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite"><br><br><div class="gmail_quote">On Thu, Mar 31, 2011 at 11:21 AM, Jacob Carlborg <span dir="ltr"><<a href="mailto:doob@me.com">doob@me.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
<div style="word-wrap: break-word;"><div><div class="im"><blockquote type="cite"><div><br>- All public declarations should have proper ddoc documentation.<br></div></blockquote><div><br></div></div><div>And protected methods as well, they're a part of the API just as much as the public methods.</div>
<div><div></div><br></div></div></div></blockquote></div><br>Somewhat agree, but sometimes you make a protected method to be overridden internally in your hierarchy, but it's not designed to be messed with by external clients. Omitting ddoc for it sends a strong "don't mess with this" message.<br>
_______________________________________________<br>phobos mailing list<br><a href="mailto:phobos@puremagic.com">phobos@puremagic.com</a><br>http://lists.puremagic.com/mailman/listinfo/phobos</blockquote></div><div><br></div><div>That's true. Would that be worth a comment (not doc comment) saying it's only for internal use?</div><br><div>
<span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-border-horizontal-spacing: 0px; -webkit-border-vertical-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; font-size: medium; ">-- <br>/Jacob Carlborg</span>
</div>
<br></body></html>