<div dir="ltr">On Wed, Oct 19, 2016 at 1:07 PM, katja <span dir="ltr"><<a href="mailto:katjavetter@gmail.com" target="_blank">katjavetter@gmail.com</a>></span> wrote:<br><div class="gmail_extra"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">On Wed, Oct 19, 2016 at 4:25 PM, Jonathan Wilkes <<a href="mailto:jancsika@yahoo.com">jancsika@yahoo.com</a>> wrote:<br>
> When implemented in C, which approach takes the least amount of time<br>
> to read, reason about, and fully comprehend?<br>
<br>
That is an important question. Pd code is full of clever tricks and<br>
bit hacks for dsp efficiency. What is the origin of q8_rsqrt(), why<br>
and how does it work? What about PD_BIGORSMALL() in m_pd.h? And the<br>
mysterious UNITBIT32 number in d_osc.c? Ideally such code should be<br>
commented not only to denote its function (if necessary) but also to<br>
reference the origin so you may be able to find info.<br>
<br></blockquote><br></div><div class="gmail_quote">I agree that Pd's code is very sparsely commented. I imagine Miller keeps another copy with all the comments.<br></div><div class="gmail_quote">I was mystified by UNITBIT32 as well. I tried to explain it in the comments of my sqosc~ object at<br><a href="https://sourceforge.net/p/pure-data/svn/HEAD/tree/trunk/externals/mrpeach/sqosc%7E/sqosc%7E.c">https://sourceforge.net/p/pure-data/svn/HEAD/tree/trunk/externals/mrpeach/sqosc%7E/sqosc%7E.c</a><br><br><br></div><div class="gmail_quote">Martin<br></div><div class="gmail_quote"><br></div></div></div>