[bugfix] Ensure that ProducesAnnotation can match */*. Previously wildcard mediatype was defined as *.* which is incorrect, should have been */*
[javadoc] added explanation
[javadoc] javadoc fixes
[javadoc] further javadoc corrections