doc/API: correct inaccurate waveform documentation