Topic/plt 557

- Added ``combine`` and ``flatCombine`` methods, together with code
samples in the javadoc
- Added tests to show usage
- Minor other fixups to javadoc
I think the complexity of the example obscures what the method does. Would it be better to do something simple like summing some values or doing a simple map?