I'll post some refs tomorrow. All modern documentors are namespace aware
and recognise imports. Check out symfony api docs for examples.

@package only exists because it has not yet been removed. These are relics
from pre namespace days