docs: use bulleted list for deprecation; pydoc for shared dir pydoc update for embedded/released docs isn't working quite right. The html file is generated but no docs are extracted into it. But the error emitted by the presence of pydoc.txt is suppressed.