DOC: add note to scipy.signal.resample about prime sample numbers.

Resampling a prime number of samples can be really slow.
Add a note about this and link to the fft documentation.
DOC: fix an issue with reST formatting in signal.resample docstring.
Merge branch 'pr/3956' into master.

See https://github.com/scipy/scipy/pull/3956