JTextPane: No Glitch + More Thorough Commenting

Turns out the glitch only shows up on my machine so you guys should be
fine. Might be something we want to fix later since inconsistency
between machines is probably bad