Documentation review

Started documentation - tweaked some function interfaces as a result