typos in comments
add documentation of full syntax
update