This file is indexed.

/usr/share/perl5/Alt/Assert.pod is in libalt-perl 0.10-1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
=pod

=for comment
DO NOT EDIT. This Pod was generated by Swim.
See http://github.com/ingydotnet/swim-pm#readme

=encoding utf8

=head1 NAME

Alt::Assert - Assert alternate module implementation

=head1 SYNOPSIS

Assuming there is a CPAN module Foo::Bar and mst wants to write an ALTernate
called Alt::Foo::Bar::MSTROUT.

In mst's Foo::Bar, there is the following line:

    use constant ALT => 'MSTROUT';

In the alt module:

    package Alt::Foo::Bar::MSTROUT;
    use Alt::Assert; # imports assert()
    1;

Users use mst's Foo::Bar as normal, just like they would use the
original Foo::Bar:

    use Foo::Bar -various => [qw(weird import)], {API=>'things'};

or:

    require Foo::Bar;

If they want to assert they have the mst version, they can:

    use Foo::Bar -various => [qw(weird import)], {API=>'things'};
    use Alt::Foo::Bar::MSTROUT;

or:

    require Foo::Bar;
    require Alt::Foo::Bar::MSTROUT;
    Alt::Foo::Bar::MSTROUT->assert;

=head1 DESCRIPTION

Alt::Assert can be used to assert that the loaded module is the wanted
alternate implementation. Using the Synopsis' example, there can be different
Foo::Bar installed, either from the original distribution, or from one of the
alternate ones. Each alternate might be slightly incompatible with the
original. The existence of Alt::Foo::Bar::MSTROUT in the installation does not
necessarily ensure that the installed Foo::Bar is from the same alternate
distribution, since an installer can replace Foo::Bar from another
distribution. That is why one might need to do this assertion.

=head1 SEE ALSO

=over

=item * L<Alt>

=back

=head1 AUTHOR

Ingy döt Net <ingy@cpan.org>

=head1 COPYRIGHT

Copyright 2012-2014. Ingy döt Net.

See L<http://www.perl.com/perl/misc/Artistic.html>

=cut