Nicholas Clark writes:
A fair chunk of November was spent on disentangling pod/buildtoc
Originally pod/buildtoc was a script run by the pumpking to rebuild pod/buildtoc.pod, and pod/buildtoc.pod was shipped in the distribution. In 2003 I extended it to add code to regenerate the lists of Pod files in various Makefiles, which were repetitive to maintain manually, and contained several errors where particular files were omitted. The assumption was that pod/buildtoc would be run by the pumpking, against a built tree. This all made sense then.
Subsequently the build process was changed to build pod/buildtoc.pod, instead of shipping it, meaning that pod/buildtoc is run at build time.
Meanwhile the release process has been documented and regularised, and the stage where one would add a new perldelta would ideally happen against a clean build tree. But pod/buildtoc would seem to demand a build tree for its consistency checks.
Also, we've switched the direction of the symlink, such that pod/perldelta.pod is now always a file, and pod/perl5155delta.pod is the symlink to it, deleted by the 'distclean' target in the Makefile. But adding a new version's perldelta changes the name of the symlink, turns the pathname that was a symlink into a file, updates Makefile.SH, but doesn't change the makefile actually run for distclean. So confusion could happen. It would be much better to do this part against a clean tree.
So I refactored pod/buildtoc to split it into 3 parts - a small library to parse pod.lst and run consistency checks, a script run by the release manager to update Makefiles, that runs against a clean tree, leaving pod/buildtoc to just run at build time, building pod/perltoc.pod
Steve Hay used it in the 5.15.5 release, and all reports are that it worked quite nicely. [Certainly, I haven't woken up to find a Camel's head in my bed, which is a good sign :-)]
After the 5.15.5 release I amended pod/buildtoc to also build pod/roffitall. This is a shell script to convert all the man pages to printed documentation, which previously was shipped in the distribution tarball, and kept up to date manually. Or not. Now it's built with a current list of man pages. However, an open bug (RT #103202) needs to be resolved before it can correctly generate the table of contents.
Thanks to Rainer Tammer providing me with access to an AIX system, we did finally get to the bottom of the AIX stdbool.h problem. It turned out to be a bug in xlc (the default AIX compiler), which caused it to generate bad code. Much pain and gnashing of teeth was worked around with this minimal tweak:
Author: Nicholas Clark
Date: Tue Nov 15 19:44:18 2011 +0100
Tweak the cBOOL() macro to avoid problems with the AIX compiler.
(cherry picked from commit 0cebf65582f924952bfee1472749d442d51e43e6)
diff --git a/handy.h b/handy.h
index 2c2311a..8777644 100644
@ -115,9 +115,10 @ Null SV pointer. (No longer available when C is defined.)
/* a simple (bool) cast may not do the right thing: if bool is defined
* as char for example, then the cast from int is implementation-defined
+ * (bool)!!(cbool) in a ternary triggers a bug in xlc on AIX
-#define cBOOL(cbool) ((bool)!!(cbool))
+#define cBOOL(cbool) ((cbool) ? (bool)1 : (bool)0)
/* Try to figure out func or FUNCTION equivalent, if any.
* XXX Should really be a Configure probe, with HAS__FUNCTION__
I also discovered and fixed a subtle parallel make race condition on AIX (and presumably OS/2) in the process of getting the bisect runner to build on AIX. (Figuring out this make bug turned out to be 90% of the work needed). The bisect runner should now also be useful to the vast majority of OS X users. It now detects a case sensitive file system, limiting itself to perl-5.005 or later, and patches the OS X hints file appropriately to get
perl-5.6.0 and perl-5.000 to build. I hope this makes it more useful to more people.
The largest and most "exciting" part of last week was spent single stepping in gdb to determine the cause of a global destruction "panic" related to weak references, that Karl Williamson accidentally stumbled upon whilst innocently refactoring completely unrelated code. It took the better part of the 30th November to locate and understand the cause, which means that the analysis and (hopeful solution) will have to wait until next month's
report. Stay tuned... :-)
A more detailed breakdown summarised from the weekly reports. In these:
16 hex digits refer to commits in http://perl5.git.perl.org/perl.git
RT #... is a bug in https://rt.perl.org/rt3/
CPAN #... is a bug in https://rt.cpan.org/Public/
BBC is "bleadperl breaks CPAN" - Andreas König's test reports for CPAN modules
|7.25||AIX parallel build failure|
|0.50||BBC, CPAN #72133|
|0.50||OpenBSD and MirBSD smoke failure|
|7.25||Porting/bisect-runner.pl (refactoring for maintainability)|
|0.25||Porting/bisect-runner.pl (start,end for validate)|
|0.25||Solaris -xO3 failure|
|1.50||bisect.pl (OS X for HFS+)|
|0.50||bisect.pl (fatal build regression)|
|1.50||bisect.pl (feedback from Ricardo)|
|8.50||bisect.pl (fixing parallel make bugs)|
|1.50||delete vs splice on arrays|
|2.25||global destruction backref panic (analysis)|
|6.75||global destruction backref panic (diagnosis)|
|6.00||parallel make race condition for SDBM_File|
|3.25||process, scalability, mentoring|
|35.00||reading/responding to list mail|
|roffitall (RT #103202)|
|3.25||sitecustomize/relocatableinc RT #104112|
144.50 hours total