better javadoc for ttl