@filesource

The @filesource tag tells documentation tooling to embed a full, syntax-highlighted copy of the current file's source code alongside the documentation generated for it. It is typically placed once, in the file-level docblock near the top of the file, rather than repeated on individual elements.

Parsing a @filesource tag produces a FilesourceTag instance. Being a pure marker, it adds nothing beyond the $name and optional $description every Tag already carries.

This tag is still part of phpDocumentor's current tag reference and is not deprecated — phpDocumentor tag reference. It is parsed here for compatibility with classic-style docblocks.