#5 Semantic restrictions

[Mattias Bertilsson]

There should be sensible error messages when the
documented semantic restrictions for documentation tags
are violated.

The most common result is now is an exception from deep
down in the machinery.