extended API doc
minor changes