Release v1.0.0 preparation; plus fix minor problem with java doc and update readme.md