Major documentation for doc DocStringTag.

Extend DocStringTag to include "all" known types, along with document
how each of them behaves. This also forced a few changes to its
behaviour, which is reflected in the updated tests. The biggest change
is that we now barely test for valid "tag_name" values, since a valid
tag should always have a valid (albeit unknown) tag name.