File Coverage

blib/lib/Module/Install/Deprecated.pm
Criterion Covered Total %
statement 12 22 54.5
branch n/a
condition n/a
subroutine 4 9 44.4
pod 5 5 100.0
total 21 36 58.3


line stmt bran cond sub pod time code
1             package Module::Install::Deprecated;
2              
3 1     1   1509 use strict;
  1         2  
  1         37  
4 1     1   6 use Module::Install::Base ();
  1         2  
  1         19  
5              
6 1     1   4 use vars qw{$VERSION @ISA $ISCORE};
  1         2  
  1         80  
7             BEGIN {
8 1     1   4 $VERSION = '1.21';
9 1         17 @ISA = 'Module::Install::Base';
10 1         175 $ISCORE = 1;
11             }
12              
13              
14              
15              
16              
17             #####################################################################
18             # Previous API for Module::Install::Compoler
19              
20             sub c_files {
21 0     0 1   warn "c_files has been changed to cc_files to reduce confusion and keep all compiler commands as cc_";
22 0           shift()->cc_files(@_);
23             }
24              
25             sub inc_paths {
26 0     0 1   warn "inc_paths has been changed to cc_inc_paths due to confusion between Perl and C";
27 0           shift()->cc_inc_paths(@_);
28             }
29              
30             sub lib_paths {
31 0     0 1   warn "lib_paths has been changed to cc_lib_paths due to confusion between Perl and C";
32 0           shift()->cc_lib_paths(@_);
33             }
34              
35             sub lib_links {
36 0     0 1   warn "lib_links has been changed to cc_lib_links due to confusion between Perl and C";
37 0           shift()->cc_lib_links(@_);
38             }
39              
40             sub optimize_flags {
41 0     0 1   warn "optimize_flags has been changed to cc_optimize_flags for consistency reasons";
42 0           shift()->cc_optimize_flags(@_);
43             }
44              
45             1;
46              
47             __END__
48              
49             =pod
50              
51             =head1 NAME
52              
53             Module::Install::Deprecated - Warnings and help for deprecated commands
54              
55             =head1 DESCRIPTION
56              
57             One of the nicest features of L<Module::Install> is that as it improves,
58             there is no need to take into account user compatibility, because users do
59             not need to install L<Module::Install> itself.
60              
61             As a result, the L<Module::Install> API changes at a faster rate than usual,
62             and this results in deprecated commands.
63              
64             C<Module::Install::Deprecated> provides implementations of the deprecated
65             commands, so that when an author is upgrading their L<Module::Install> and
66             they are using a deprecated command they will be told that the command has
67             been deprecated, and what the author should use instead.
68              
69             This extension should NEVER end up bundled into the distribution tarball.
70              
71             =head1 COMMANDS
72              
73             =head2 c_files
74              
75             The C<c_files> command has been changed to C<cc_files> to reduce confusion
76             and keep all compiler commands within a consistent C<ff_foo> naming scheme.
77              
78             =head2 inc_paths
79              
80             The C<inc_paths> command has been changed to C<cc_inc_paths> due to
81             confusion between Perl and C.
82              
83             =head2 lib_paths
84              
85             The C<lib_paths> command has been changed to C<cc_lib_paths> due to confusion
86             between Perl and C.
87              
88             =head2 lib_links
89              
90             The C<lib_links> command has been changed to C<cc_lib_links> due to confusion
91             between Perl and C.
92              
93             =head2 optimize_flags
94              
95             The C<optimize_flags> command has been changed to C<cc_optimize_flags> for
96             consistency reasons.
97              
98             =head1 AUTHORS
99              
100             Adam Kennedy E<lt>adamk@cpan.orgE<gt>
101              
102             =head1 SEE ALSO
103              
104             L<Module::Install>
105              
106             =head1 COPYRIGHT
107              
108             Copyright 2006 Adam Kennedy.
109              
110             This program is free software; you can redistribute it and/or modify it
111             under the same terms as Perl itself.
112              
113             See L<http://www.perl.com/perl/misc/Artistic.html>
114              
115             =cut