updating doc (following apigen doc tags) + PSR-1 PSR-2 fix
[skip ci]
fix inconsistencies in some tests
simplified Facade code
removed forgotten todo doc [skip ci]
corrected bug AnnotationsBag::useNamespace accepted namespace with trailling dot
modified parser rules to match new expectations
better tests for namespace invalidation
removed duplicated code from AnnotationsBag