Fixes incorrect `TokenBucket` comment, adds details

The documentation about `kombu.util.limits.TokenBucket` could be better. It was actually wrong about `TokenBucket.expected_time()` consuming a token: `TokenBucket.can_consume(tokens)` will consume `tokens` tokens if they are available, but `TokenBucket.expected_time()` is idempotent.