[doc] update format specs
[mod] more fixes for py3