Doc plot spectra overlap

I have changed the plot_spectra_overlap example to avoid using "private" functionality and fixed some little things in the documentation on the way.