updated documentation in normal modes