improve doc comments. add convenience start+stop functions