PLL blocks parameters units


the documentation for the PLL blocks in GNURadio says: “All settings
max_freq and min_freq are in terms of radians per sample, NOT HERTZ.”

Therefore I thought that to specify a bandwidth bw it would have to
converted from natural frequency units (Hz) into radians per sample with
something like:

bw_rad_per_sample = bw * 2*pi / sampl_rate

where sampl_rate is of course the sampling rate in Hz.

However, looking at the PSD of the input and outputs to the PLL blocks,
it looks like my understanding is wrong and that the bandwidth should be
computed as

bw_rad_per_sample = bw * pi / sampl_rate

with a missing factor of 2.

Is the documentation right, and my understanding of it wrong, or the
documentation is wrong? In the former case, I think it would be better
to clarify it a bit.

Thanks! Cheers,