Minor documentation fixes - change \note entries to \warning where appropriate and remove/update old documentation.
