Outdated/incorrect docu is worse than no documentation

I was struggling with this How to use JDBC and transactions in Tomcat with JOTM. JOTM was always throwing java:comp away after the first request (the first lookup went through nicely). Thanks to a bug report from Matt Raible, I found out that carol now needs more options in the property file:

carol.protocols=jrmp

# do not use CAROL JNDI wrapper
carol.start.jndi=false

# do not start a name server
carol.start.ns=false

# use the apache naming factory
carol.jndi.java.naming.factory.url.pkgs=org.apache.naming

While browsing more tracker items, more and more things come clear.
Please: update the documentation if you make such big changes in a project. Wrong documentation is worse than none.