This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
ExtUtils::CBuilder: add support information
authorDavid Golden <dagolden@cpan.org>
Wed, 22 Feb 2012 22:45:06 +0000 (17:45 -0500)
committerDavid Golden <dagolden@cpan.org>
Wed, 22 Feb 2012 22:45:09 +0000 (17:45 -0500)
Adds a documentation note about support.  Adds a README.patching
file with instructions for bumping versions, Changes, etc.

16 files changed:
MANIFEST
dist/ExtUtils-CBuilder/Changes
dist/ExtUtils-CBuilder/README.patching [new file with mode: 0644]
dist/ExtUtils-CBuilder/lib/ExtUtils/CBuilder.pm
dist/ExtUtils-CBuilder/lib/ExtUtils/CBuilder/Base.pm
dist/ExtUtils-CBuilder/lib/ExtUtils/CBuilder/Platform/Unix.pm
dist/ExtUtils-CBuilder/lib/ExtUtils/CBuilder/Platform/VMS.pm
dist/ExtUtils-CBuilder/lib/ExtUtils/CBuilder/Platform/Windows.pm
dist/ExtUtils-CBuilder/lib/ExtUtils/CBuilder/Platform/Windows/BCC.pm
dist/ExtUtils-CBuilder/lib/ExtUtils/CBuilder/Platform/Windows/GCC.pm
dist/ExtUtils-CBuilder/lib/ExtUtils/CBuilder/Platform/Windows/MSVC.pm
dist/ExtUtils-CBuilder/lib/ExtUtils/CBuilder/Platform/aix.pm
dist/ExtUtils-CBuilder/lib/ExtUtils/CBuilder/Platform/cygwin.pm
dist/ExtUtils-CBuilder/lib/ExtUtils/CBuilder/Platform/darwin.pm
dist/ExtUtils-CBuilder/lib/ExtUtils/CBuilder/Platform/dec_osf.pm
dist/ExtUtils-CBuilder/lib/ExtUtils/CBuilder/Platform/os2.pm

index a56baa4..3a5fe21 100644 (file)
--- a/MANIFEST
+++ b/MANIFEST
@@ -3116,6 +3116,7 @@ dist/ExtUtils-CBuilder/lib/ExtUtils/CBuilder.pm                   Compile and link C code for Pe
 dist/ExtUtils-CBuilder/LICENSE         EU-CB license
 dist/ExtUtils-CBuilder/Makefile.PL             EU-CB configuration script
 dist/ExtUtils-CBuilder/MANIFEST.SKIP           EU-CB release support
+dist/ExtUtils-CBuilder/README.patching         EU-CB patching nstructions
 dist/ExtUtils-CBuilder/README.release          EU-CB release instructions
 dist/ExtUtils-CBuilder/t/00-have-compiler.t                    ExtUtils::CBuilder tests
 dist/ExtUtils-CBuilder/t/01-basic.t                            tests for ExtUtils::CBuilder
index 3f731fb..b06f94d 100644 (file)
@@ -1,5 +1,11 @@
 Revision history for Perl extension ExtUtils::CBuilder.
 
+0.280206 - 2012-03-20 (Perl v5.15.9)
+
+  Documented:
+
+  - Added a SUPPORT section to indicate that upstream is Perl 5 core
+
 0.280205 - 2011-12-20 (Perl v5.15.6)
 
   Fixed:
diff --git a/dist/ExtUtils-CBuilder/README.patching b/dist/ExtUtils-CBuilder/README.patching
new file mode 100644 (file)
index 0000000..77e608e
--- /dev/null
@@ -0,0 +1,27 @@
+Patching instructions for ExtUtils::CBuilder
+
+1. Check for any changes to .pm files since dev or stable Perl release.  E.g.
+to check for changes since v5.15.8:
+
+    $ cd dist/ExtUtils-CBuilder
+    $ git log v5.15.8..blead -- .
+
+2. If you are making the first change since the last Perl release, you need to
+bump the $VERSION in all .pm files and update the Changes file with the new
+version.  In the Changes file, put the expected *NEXT* release of Perl (dev or
+stable) as the release date and version.  E.g. after v5.15.8, I added this line
+to Changes to indicate what will be next release:
+
+    0.280206 - 2012-03-20 (Perl v5.15.9)
+
+3. Add an entry to Changes for your work
+
+4. Update Makefile.PL, MANIFEST.SKIP or other support files as necessary. E.g.
+update Makefile.PL with any changes to prerequisites.
+
+5. Commit all changes (preferably to a branch)
+
+6. Run Configure/make/make test and check for errors.  If there are any, fix them.
+
+7. If all is well, push your commits to blead or send a patch to p5p if you do
+not have commit access to the Perl 5 repository
index 413c765..aff607d 100644 (file)
@@ -6,7 +6,7 @@ use File::Basename ();
 use Perl::OSType qw/os_type/;
 
 use vars qw($VERSION @ISA);
-$VERSION = '0.280205';
+$VERSION = '0.280206';
 $VERSION = eval $VERSION;
 
 # We only use this once - don't waste a symbol table entry on it.
@@ -265,10 +265,23 @@ other platform-specific issues.  Ilya Zakharevich has contributed
 fixes for OS/2; John E. Malmberg and Peter Prymmer have done likewise
 for VMS.
 
+=head1 SUPPORT
+
+ExtUtils::CBuilder is maintained as part of the Perl 5 core.  Please
+submit any bug reports via the F<perlbug> tool included with Perl 5.
+Bug reports will be included in the Perl 5 ticket system at
+L<http://rt.perl.org>.
+
+The Perl 5 source code is available at <http://perl5.git.perl.org/perl.git>
+and ExtUtils-CBuilder may be found in the F<dist/ExtUtils-CBuilder> directory
+of the repository.
+
 =head1 AUTHOR
 
 Ken Williams, kwilliams@cpan.org
 
+Additional contributions by The Perl 5 Porters.
+
 =head1 COPYRIGHT
 
 Copyright (c) 2003-2005 Ken Williams.  All rights reserved.
index 44cf441..6d983cd 100644 (file)
@@ -12,7 +12,7 @@ use IPC::Cmd qw(can_run);
 use File::Temp qw(tempfile);
 
 use vars qw($VERSION);
-$VERSION = '0.280205';
+$VERSION = '0.280206';
 
 # More details about C/C++ compilers:
 # http://developers.sun.com/sunstudio/documentation/product/compiler.jsp
index a8e7d80..4bc7193 100644 (file)
@@ -4,7 +4,7 @@ use strict;
 use ExtUtils::CBuilder::Base;
 
 use vars qw($VERSION @ISA);
-$VERSION = '0.280205';
+$VERSION = '0.280206';
 @ISA = qw(ExtUtils::CBuilder::Base);
 
 sub link_executable {
index fed4b84..47238e8 100644 (file)
@@ -4,7 +4,7 @@ use strict;
 use ExtUtils::CBuilder::Base;
 
 use vars qw($VERSION @ISA);
-$VERSION = '0.280205';
+$VERSION = '0.280206';
 @ISA = qw(ExtUtils::CBuilder::Base);
 
 use File::Spec::Functions qw(catfile catdir);
index e4fe72a..080f2b4 100644 (file)
@@ -10,7 +10,7 @@ use ExtUtils::CBuilder::Base;
 use IO::File;
 
 use vars qw($VERSION @ISA);
-$VERSION = '0.280205';
+$VERSION = '0.280206';
 @ISA = qw(ExtUtils::CBuilder::Base);
 
 =begin comment
index dd83813..01acec5 100644 (file)
@@ -1,7 +1,7 @@
 package ExtUtils::CBuilder::Platform::Windows::BCC;
 
 use vars qw($VERSION);
-$VERSION = '0.280205';
+$VERSION = '0.280206';
 
 sub format_compiler_cmd {
   my ($self, %spec) = @_;
index 37d9483..ccc575f 100644 (file)
@@ -1,7 +1,7 @@
 package ExtUtils::CBuilder::Platform::Windows::GCC;
 
 use vars qw($VERSION);
-$VERSION = '0.280205';
+$VERSION = '0.280206';
 
 sub format_compiler_cmd {
   my ($self, %spec) = @_;
index 434e735..a847699 100644 (file)
@@ -1,7 +1,7 @@
 package ExtUtils::CBuilder::Platform::Windows::MSVC;
 
 use vars qw($VERSION);
-$VERSION = '0.280205';
+$VERSION = '0.280206';
 
 sub arg_exec_file {
   my ($self, $file) = @_;
index 27fe242..2ed318b 100644 (file)
@@ -5,7 +5,7 @@ use ExtUtils::CBuilder::Platform::Unix;
 use File::Spec;
 
 use vars qw($VERSION @ISA);
-$VERSION = '0.280205';
+$VERSION = '0.280206';
 @ISA = qw(ExtUtils::CBuilder::Platform::Unix);
 
 sub need_prelink { 1 }
index 775671a..b30497e 100644 (file)
@@ -5,7 +5,7 @@ use File::Spec;
 use ExtUtils::CBuilder::Platform::Unix;
 
 use vars qw($VERSION @ISA);
-$VERSION = '0.280205';
+$VERSION = '0.280206';
 @ISA = qw(ExtUtils::CBuilder::Platform::Unix);
 
 # TODO: If a specific exe_file name is requested, if the exe created
index 2907c56..62eddd7 100644 (file)
@@ -4,7 +4,7 @@ use strict;
 use ExtUtils::CBuilder::Platform::Unix;
 
 use vars qw($VERSION @ISA);
-$VERSION = '0.280205';
+$VERSION = '0.280206';
 @ISA = qw(ExtUtils::CBuilder::Platform::Unix);
 
 sub compile {
index 461f53e..587dbbd 100644 (file)
@@ -6,7 +6,7 @@ use File::Spec;
 
 use vars qw($VERSION @ISA);
 @ISA = qw(ExtUtils::CBuilder::Platform::Unix);
-$VERSION = '0.280205';
+$VERSION = '0.280206';
 
 sub link_executable {
   my $self = shift;
index e97e2df..531a812 100644 (file)
@@ -4,7 +4,7 @@ use strict;
 use ExtUtils::CBuilder::Platform::Unix;
 
 use vars qw($VERSION @ISA);
-$VERSION = '0.280205';
+$VERSION = '0.280206';
 @ISA = qw(ExtUtils::CBuilder::Platform::Unix);
 
 sub need_prelink { 1 }