fix SYNOPSIS since we don't export
[p5sagit/Devel-OverrideGlobalRequire.git] / README.pod
1 =pod
2
3 =head1 NAME
4
5 Devel::OverrideGlobalRequire - Override CORE::GLOBAL::require safely
6
7 =head1 VERSION
8
9 version 0.001
10
11 =head1 SYNOPSIS
12
13   use Devel::OverrideGlobalRequire;
14
15   override_global_require( sub { ... } );
16
17 =head1 DESCRIPTION
18
19 This module overrides C<CORE::GLOBAL::require> with a code reference in a way
20 that plays nice with any existing overloading and ensures the right calling
21 package is in scope.
22
23 =for Pod::Coverage override_global_require
24 TRACE
25
26 =for :stopwords cpan testmatrix url annocpan anno bugtracker rt cpants kwalitee diff irc mailto metadata placeholders metacpan
27
28 =head1 SUPPORT
29
30 =head2 Bugs / Feature Requests
31
32 Please report any bugs or feature requests through the issue tracker
33 at L<https://rt.cpan.org/Public/Dist/Display.html?Name=Devel-OverrideGlobalRequire>.
34 You will be notified automatically of any progress on your issue.
35
36 =head2 Source Code
37
38 This is open source software.  The code repository is available for
39 public review and contribution under the terms of the license.
40
41 L<http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=p5sagit/Devel-OverrideGlobalRequire.git;a=summary>
42
43   git clone git://git.shadowcat.co.uk/p5sagit/Devel-OverrideGlobalRequire.git
44
45 =head1 AUTHORS
46
47 =over 4
48
49 =item *
50
51 Peter Rabbitson <ribasushi@cpan.org>
52
53 =item *
54
55 Andrew Main <zefram@cpan.org>
56
57 =item *
58
59 David Golden <dagolden@cpan.org>
60
61 =back
62
63 =head1 COPYRIGHT AND LICENSE
64
65 This software is copyright (c) 2013 by Peter Rabbitson.
66
67 This is free software; you can redistribute it and/or modify it under
68 the same terms as the Perl 5 programming language system itself.
69