more javadocs

I had post-commit regrets right after I made the last PR. I knew the part about draw order was too specific.

I threw in a style formatting to make up for it.