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.