NAME

Lintian::Output - Lintian messaging handling

SYNOPSIS

    use Lintian::Output;
    my $out = Lintian::Output->new;
    $out->verbosity(-1);
    $out->msg("Something interesting");
    $out->v_msg("Something less interesting");
    $out->debug_msg(3, "Something very specific");

DESCRIPTION

Lintian::Output is used for all interaction between lintian and the user. It is designed to be easily extensible via subclassing.

To simplify usage in the most common cases, many Lintian::Output methods can be used as class methods and will therefore automatically use the object $Lintian::Output::GLOBAL unless their first argument "isa('Lintian::Output')".

ATTRIBUTES

The following fields impact the behavior of Lintian::Output.

html

color

colors

debug

If set to a positive integer, will enable all debug messages issued with a level lower or equal to its value.

perf_debug

perf_log_fd

proc_id2tag_count

showdescription

Whether to show the description of a tag when printing it.

tty_hyperlinks

tag_display_limit

Get/Set the number of times a tag is emitted per processable.

verbosity

Determine how verbose the output should be. "0" is the default value (tags and msg only), "-1" is quiet (tags only) and "1" is verbose (tags, msg and v_msg).

"delimiter"

CLASS/INSTANCE METHODS

These methods can be used both with and without an object. If no object is given, they will fall back to the $Lintian::Output::GLOBAL object.

"msg(@args)"

Will output the strings given in @args, one per line, each line prefixed with 'N: '. Will do nothing if verbosity is less than 0.

"v_msg(@args)"

Will output the strings given in @args, one per line, each line prefixed with 'N: '. Will do nothing unless verbosity is greater than 0.

"debug_msg($level, @args)"

$level should be a positive integer.

Will output the strings given in @args, one per line, each line prefixed with 'N: '. Will do nothing unless debug is set to a positive integer >= $level.

"perf_log(@args)"

Like "v_msg", except output is possibly sent to a dedicated log file.

Will output the strings given in @args, one per line. The lines will not be prefixed. Will do nothing unless perf_debug is set to a positive integer.

SEE ALSO

lintian(1)