updated documentation [Charles MacDonald]