bnoordhuis: so should the docs be updated until then?