manual: updates to theory part