documentation updated, close #235