NAME

       Lintian::Tag::Info - Lintian interface to tag metadata

SYNOPSIS

           my $cs = Lintian::CheckScript->new ("$ENV{'LINTIAN_ROOT'}/checks/",
                                               'files');
           my $tag_info = $cs->get_tag ('some-tag');
           print "Tag info is:\n";
           print $tag_info->description('text', '   ');
           print "\nTag info in HTML is:\n";
           print $tag_info->description('html', '   ');

DESCRIPTION

       This module provides an interface to tag metadata as gleaned from the *.desc files describing the checks.
       It can be used to retrieve specific metadata elements or to format the tag description.

CLASS METHODS

       new(HASH, SCRIPT_NAME, SCRIPT_TYPE)
           Creates a new Lintian::Tag:Info.

INSTANCE METHODS

       certainty()
           Returns the certainty of the tag.

       code()
           Returns  the  one-letter  code for the tag.  This will be a letter chosen from "E", "W", "I", or "P",
           based on the tag severity, certainty, and other attributes (such as  whether  experimental  is  set).
           This code will never be "O" or "X"; overrides and experimental tags are handled separately.

       description([FORMAT [, INDENT]])
           Returns the formatted description (the Info field) for a tag.  FORMAT must be either "text" or "html"
           and defaults to "text" if no format is specified.  If "text", returns wrapped paragraphs formatted in
           plain  text  with  a  right margin matching the Text::Wrap default, preserving as verbatim paragraphs
           that begin with whitespace.  If "html", return paragraphs formatted in HTML.

           If INDENT is specified, the string INDENT is prepended to each line of the formatted output.

       experimental()
           Returns true if this tag is experimental, false otherwise.

       severity([$real])
           Returns the severity of the tag; if $real is a truth value the real (original) severity is  returned,
           otherwise the effective severity is returned.

           See set_severity()

       set_severity($severity)
           Modifies the effective severity of the tag.

       script()
           Returns the check script corresponding to this tag.

       sources()
           Returns,  as  a  list,  the keywords for the sources of this tag from the references header.  This is
           only the top-level source, not any more-specific section or chapter.

       tag()
           Returns the tag name.

DIAGNOSTICS

       The following exceptions may be thrown:

       no tag specified
           The Lintian::Tag::Info::new constructor was called without passing a tag as an argument.

       unknown output format %s
           An unknown output format was passed as the FORMAT argument of description().  FORMAT must  be  either
           "text" or "html".

       The following fatal internal errors may be reported:

       can't open %s: %s
           The  specified  file,  which  should be part of the standard Lintian data files, could not be opened.
           The file may be missing or have the wrong permissions.

       missing Check-Script field in %s
           The specified check description file has no Check-Script field in its header section.  This  probably
           indicates the file doesn't exist or has some significant formatting error.

       missing Tag field in %s
           The specified check description file has a tag section that has no Tag field.

FILES

       LINTIAN_ROOT/checks/*.desc
           The  tag  description  files,  from  which  tag metadata is read.  All files matching this shell glob
           expression will be read looking for tag data.

       LINTIAN_ROOT/data/output/manual-references
           Information about manual references.  Each non-comment, non-empty line of  this  file  contains  four
           fields separated by "::".  The first field is the name of the manual, the second field is the section
           or  empty  for data about the whole manual, the third field is the title, and the fourth field is the
           URL.  The URL is optional.

ENVIRONMENT

       LINTIAN_ROOT
           This variable specifies Lintian's root directory.  It defaults to /usr/share/lintian if not set.  The
           lintian program normally takes care of setting it.

AUTHOR

       Originally written by Russ Allbery <rra@debian.org> for Lintian.

SEE ALSO

       lintian(1)

Lintian v2.5.81ubuntu1                             2018-04-08                              Lintian::Tag::Info(3)