wip-java-api-fix: Updated manual