Perl::Critic::Annotation represents a single "## no critic" annotation in a PPI:Document. The Annotation takes care of parsing the annotation and keeps track of which lines and Policies it affects. It is intended to encapsulate the details of the no-critic annotations, and to provide a way for Policy objects to interact with the annotations (via a Perl::Critic::Document).

Given a Perl::Critic::Document, finds all the "## no critic" annotations and constructs a new Perl::Critic::Annotation for each one and returns them. The order of the returned objects is not defined. It is generally expected that clients will use this interface rather than calling the Perl::Critic::Annotation constructor directly.

Returns a list of the names of the Policies that are affected by this Annotation. If this list is empty, then it means that all Policies are affected by this Annotation, and disables_all_policies() should return true.