A variety of improvements to the javadoc text.
Zip fix for multiple onCompleted and moved unsubscribe outside the lock.
Merge pull request #765 from Netflix/docs

A variety of improvements to the javadoc text.
Merge pull request #767 from akarnokd/ZipFixes

Zip fix for multiple onCompleted and moved unsubscribe outside the lock.