documentation improvements.
Slow and steady...
new function 'spectral_properties'
doc improvements