Clarifying documentation for CloudWatchConnection.list_metrics().

- Multiple values for the same dimension are not supported by the API
- Max 10 dimensions allowed
Merge pull request #1962 from oxtopus/documentation-fix-for-list_metrics

Clarifying documentation for CloudWatchConnection.list_metrics(). Fixes #1962.