- - topic: a single word or tuple of words (though word could probably
- be any kind of object, not just a string, but this has not been
- tested). A tuple denotes a hierarchy of topics from most general
- to least. For example, a listener of this topic::
+ - topic: a single word, a tuple of words, or a string containing a
+ set of words separated by dots, for example: 'sports.baseball'.
+ A tuple or a dotted notation string denotes a hierarchy of
+ topics from most general to least. For example, a listener of
+ this topic::