Update scene2d javadoc

Add more text to class descriptions to give a bit of an overview of how
the pieces fit together (as far as I can tell).  Add an example.  Fix a 
bunch of minor typos and one javadoc warning.