Update scene2d javadoc.

Add more text to class descriptions to give a bit of an overview of how
the pieces fit together.  Add an example.  Fix a bunch of minor typos
and one javadoc warning.
Merge pull request #231 from bitiotic/docfixes.scene2d

Update scene2d javadoc