local-lib5/lib/perl5/Module/Install/Deprecated.pm

   1 package Module::Install::Deprecated;
   2
   3 use strict;
   4 use Module::Install::Base ();
   5
   6 use vars qw{$VERSION @ISA $ISCORE};
   7 BEGIN {
   8         $VERSION = '0.91';
   9         @ISA     = 'Module::Install::Base';
  10         $ISCORE  = 1;
  11 }
  12
  13
  14
  15
  16
  17 #####################################################################
  18 # Previous API for Module::Install::Compoler
  19
  20 sub c_files {
  21         warn "c_files has been changed to cc_files to reduce confusion and keep all compiler commands as cc_";
  22         shift()->cc_files(@_);
  23 }
  24
  25 sub inc_paths {
  26         warn "inc_paths has been changed to cc_inc_paths due to confusion between Perl and C";
  27         shift()->cc_inc_paths(@_);
  28 }
  29
  30 sub lib_paths {
  31         warn "lib_paths has been changed to cc_lib_paths due to confusion between Perl and C";
  32         shift()->cc_lib_paths(@_);
  33 }
  34
  35 sub lib_links {
  36         warn "lib_links has been changed to cc_lib_links due to confusion between Perl and C";
  37         shift()->cc_lib_links(@_);
  38 }
  39
  40 sub optimize_flags {
  41         warn "optimize_flags has been changed to cc_optimize_flags for consistency reasons";
  42         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