Adding javadoc to AbstractComposite explaining how it works

thanks to ed and nate for helping me figure out how AbstractComposite
works. hopefully other contributors can benefit from the javadoc and
avoid the confusion I had.
Merge pull request #632 from woolfel/master

Adding javadoc to AbstractComposite explaining how it works