minor improvment to docs and code
;