minor API improvements and doc updates