Mostly documentation tweaks and warnings

Fixed some issues with documentation. Added additional warnings when the beam power is changed, this warning will be removed in version 2 (and the units will be fixed).