mark HOscillator.createCopy() for deprecation + update documentation