/usr/share/perl5/Alt/Assert.pod is in libalt-perl 0.19-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 v0.1.31.
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
|