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
Would it be clearer if the results were ``Set<String>``?