corrected some javadoc and simplified java calls

@andresaraujo that applies when it comes to `ArrayList` and other Java containers but we're using Libgdx based ones. Those cache iterators the first time they're created and thus, avoid garbage collection.