issue #10 - misc API and doc