added more options documentation and listed known issues