add warnings description to manual, fix some typos