@package
The @package tag assigns an element to a logical package or module grouping, independent of — and often predating — PHP's own namespace system. Documentation generators use it to organize the elements they render into sections, which is especially useful for a codebase whose namespace layout doesn't line up with how its documentation should be structured.
Parsing a @package tag produces a PackageTag instance. Being a pure marker, it adds nothing beyond the $name and optional $description every Tag already carries.
For a finer-grained subdivision within a package, see @subpackage. @package is still part of phpDocumentor's current tag reference and is not deprecated — phpDocumentor tag reference. It is supported here for classic-style docblocks.