Fix JavaDoc of SubscriptionManager.Subscription to be consistent with the introduction of the "Client" class:
- Also improve some areas while I'm at it.