search

PortAudio / portaudio

PortAudio is a cross-platform, open-source C language library for real-time audio input and output.
Other
1.37k stars 286 forks source link

Doxygen page on portaudio.com has a content error that isn't present on local generation. #906

Open kurisufriend opened 2 months ago

kurisufriend commented 2 months ago

The 'Writing a Callback' page being served under v19 Tutorial is missing necessary asterisks in the code block.

image ^ what is currently being served.

         out++ = data->left_phase;  /* left */
         out++ = data->right_phase;  /* right */

should instead be 

        *out++ = data->left_phase;  /* left */
        *out++ = data->right_phase;  /* right */

Interestingly, the documentation source doesn't have this issue. In fact, when I built the HTML locally from this repo, it looked as expected: image

The page source hasn't been updated in years, and the offending asterisks have been there for over a decade, so I figure something funny is going on.

curl https://files.portaudio.com/docs/v19-doxydocs/writing_a_callback.html | grep "out++" yields

1<div class="line">         out++ = data-&gt;left_phase;  <span class="comment">/* left */</span></div>
<div class="line">         out++ = data-&gt;right_phase;  <span class="comment">/* right */</span></div>

so it's not a browser thing either.