Adam Spiers > Stow > Stow::Util

Download:
Stow-v2.2.0.tar.gz

Dependencies

Annotate this POD

Website

CPAN RT

Open  0
View/Report Bugs
Source  

NAME ^

Stow::Util - general utilities

SYNOPSIS ^

    use Stow::Util qw(debug set_debug_level error ...);

DESCRIPTION ^

Supporting utility routines for Stow.

IMPORTABLE SUBROUTINES ^

error($format, @args)

Outputs an error message in a consistent form and then dies.

set_debug_level($level)

Sets verbosity level for debug().

set_test_mode($on_or_off)

Sets testmode on or off.

debug($level, $msg)

Logs to STDERR based on $debug_level setting. $level is the minimum verbosity level required to output $msg. All output is to STDERR to preserve backward compatibility, except for in test mode, when STDOUT is used instead. In test mode, the verbosity can be overridden via the TEST_VERBOSE environment variable.

Verbosity rules:

0: errors only
>= 1: print operations: LINK/UNLINK/MKDIR/RMDIR/MV
>= 2: print operation exceptions

e.g. "_this_ already points to _that_", skipping, deferring, overriding, fixing invalid links

>= 3: print trace detail: trace: stow/unstow/package/contents/node
>= 4: debug helper routines
>= 5: debug ignore lists

BUGS ^

SEE ALSO ^

syntax highlighting: