file Trap.java - updated javadoc