> The way I see it what happened was that I wrote an email with aspects of > perlipc.pod that I found lacking, and not idiomatic up to recent best > practices, thcrist replying that he doesn't like any of the changes and > VETOing them (without saying why the status quo was better, just by giving > other irrelevant reasons),
Both of those are falsely stated. First, your notion of irrelevance is mere opinion. Second, I had previously explained my reasoning in full, and so saw no need of pasting the same redundant explanation at each point as some aide-mémoire for those of short attention spans. > I also think that the Perl 5 documentation *should* reflect > the agreed best practices (and I don't necessarily mean > Damian's PBP). You bend that word "agreed" into something it does not mean. When--and only when--you've worked your way down this list far enough that you've finally reached my stuff, do give me a holler. # 1 STRICT 0% success 368 runs = 0 passed + 368 failed < pod/perlapi.pod # 2 Warnings 7% success 368 runs = 24 passed + 344 failed < pod/perlapi.pod # 3 STRICT 33% success 275 runs = 90 passed + 185 failed < pod/perlfunc.pod # 4 STRICT 18% success 200 runs = 37 passed + 163 failed < pod/perlfaq4.pod # 5 Warnings 49% success 275 runs = 136 passed + 139 failed < pod/perlfunc.pod # 6 STRICT 12% success 148 runs = 18 passed + 130 failed < dist/Math-BigInt/lib/Math/BigInt.pm # 7 STRICT 12% success 148 runs = 18 passed + 130 failed < lib/Math/BigInt.pm # 8 Warnings 36% success 200 runs = 72 passed + 128 failed < pod/perlfaq4.pod # 9 STRICT 29% success 150 runs = 44 passed + 106 failed < cpan/CGI/lib/CGI.pm # 10 STRICT 29% success 150 runs = 44 passed + 106 failed < lib/CGI.pm # 11 Warnings 29% success 148 runs = 43 passed + 105 failed < dist/Math-BigInt/lib/Math/BigInt.pm # 12 Warnings 29% success 148 runs = 43 passed + 105 failed < lib/Math/BigInt.pm # 13 STRICT 3% success 98 runs = 3 passed + 95 failed < pod/perlguts.pod # 14 Warnings 4% success 98 runs = 4 passed + 94 failed < pod/perlguts.pod # 15 STRICT 35% success 141 runs = 49 passed + 92 failed < pod/perlretut.pod # 16 Warnings 42% success 150 runs = 63 passed + 87 failed < cpan/CGI/lib/CGI.pm # 17 Warnings 42% success 150 runs = 63 passed + 87 failed < lib/CGI.pm # 18 STRICT 37% success 126 runs = 47 passed + 79 failed < pod/perlop.pod # 19 normal 79% success 368 runs = 290 passed + 78 failed < pod/perlapi.pod # 20 STRICT 4% success 80 runs = 3 passed + 77 failed < pod/perlxs.pod # 21 STRICT 24% success 99 runs = 24 passed + 75 failed < pod/perlfaq5.pod # 22 Warnings 8% success 80 runs = 6 passed + 74 failed < pod/perlxs.pod # 23 STRICT 8% success 78 runs = 6 passed + 72 failed < ext/POSIX/lib/POSIX.pod # 24 STRICT 8% success 78 runs = 6 passed + 72 failed < lib/POSIX.pod # 25 STRICT 5% success 75 runs = 4 passed + 71 failed < cpan/Test-Simple/lib/Test/Builder.pm # 26 STRICT 5% success 75 runs = 4 passed + 71 failed < lib/Test/Builder.pm # 27 STRICT 16% success 83 runs = 13 passed + 70 failed < pod/perltrap.pod # 28 Warnings 11% success 75 runs = 8 passed + 67 failed < cpan/Test-Simple/lib/Test/Builder.pm # 29 Warnings 11% success 75 runs = 8 passed + 67 failed < lib/Test/Builder.pm # 30 Warnings 14% success 78 runs = 11 passed + 67 failed < ext/POSIX/lib/POSIX.pod # 31 Warnings 14% success 78 runs = 11 passed + 67 failed < lib/POSIX.pod # 32 STRICT 0% success 65 runs = 0 passed + 65 failed < cpan/ExtUtils-MakeMaker/lib/ExtUtils/MM_Any.pm # 33 STRICT 0% success 65 runs = 0 passed + 65 failed < lib/ExtUtils/MM_Any.pm # 34 Warnings 2% success 65 runs = 1 passed + 64 failed < cpan/ExtUtils-MakeMaker/lib/ExtUtils/MM_Any.pm # 35 Warnings 2% success 65 runs = 1 passed + 64 failed < lib/ExtUtils/MM_Any.pm # 36 normal 21% success 80 runs = 17 passed + 63 failed < pod/perlxs.pod # 37 STRICT 18% success 76 runs = 14 passed + 62 failed < cpan/Test-Simple/lib/Test/More.pm # 38 STRICT 18% success 76 runs = 14 passed + 62 failed < lib/Test/More.pm # 39 Warnings 51% success 126 runs = 64 passed + 62 failed < pod/perlop.pod # 40 STRICT 21% success 76 runs = 16 passed + 60 failed < pod/perlpacktut.pod # 41 STRICT 15% success 68 runs = 10 passed + 58 failed < pod/perldiag.pod # 42 Warnings 24% success 76 runs = 18 passed + 58 failed < cpan/Test-Simple/lib/Test/More.pm # 43 Warnings 24% success 76 runs = 18 passed + 58 failed < lib/Test/More.pm # 44 STRICT 0% success 56 runs = 0 passed + 56 failed < cpan/Test-Harness/lib/TAP/Parser.pm # 45 STRICT 0% success 56 runs = 0 passed + 56 failed < lib/TAP/Parser.pm # 46 STRICT 17% success 66 runs = 11 passed + 55 failed < pod/perlhack.pod # 47 STRICT 35% success 84 runs = 29 passed + 55 failed < pod/perlsub.pod # 48 Warnings 18% success 66 runs = 12 passed + 54 failed < pod/perlhack.pod # 49 Warnings 46% success 99 runs = 46 passed + 53 failed < pod/perlfaq5.pod # 50 normal 48% success 98 runs = 47 passed + 51 failed < pod/perlguts.pod # 51 Warnings 65% success 141 runs = 92 passed + 49 failed < pod/perlretut.pod # 52 normal 26% success 66 runs = 17 passed + 49 failed < pod/perlhack.pod # 53 Warnings 29% success 68 runs = 20 passed + 48 failed < pod/perldiag.pod # 54 Warnings 43% success 84 runs = 36 passed + 48 failed < pod/perlsub.pod # 55 Warnings 38% success 76 runs = 29 passed + 47 failed < pod/perlpacktut.pod # 56 STRICT 8% success 50 runs = 4 passed + 46 failed < pod/perldata.pod # 57 STRICT 37% success 73 runs = 27 passed + 46 failed < pod/perlfaq8.pod # 58 Warnings 21% success 56 runs = 12 passed + 44 failed < cpan/Test-Harness/lib/TAP/Parser.pm # 59 Warnings 21% success 56 runs = 12 passed + 44 failed < lib/TAP/Parser.pm # 60 Warnings 47% success 83 runs = 39 passed + 44 failed < pod/perltrap.pod # 61 STRICT 7% success 46 runs = 3 passed + 43 failed < cpan/File-Temp/Temp.pm # 62 STRICT 7% success 46 runs = 3 passed + 43 failed < lib/File/Temp.pm # 63 STRICT 22% success 55 runs = 12 passed + 43 failed < pod/perlfaq7.pod # 64 STRICT 32% success 63 runs = 20 passed + 43 failed < pod/perlopentut.pod # 65 STRICT 5% success 44 runs = 2 passed + 42 failed < cpan/Pod-Parser/lib/Pod/Parser.pm # 66 STRICT 5% success 44 runs = 2 passed + 42 failed < lib/Pod/Parser.pm # 67 STRICT 34% success 62 runs = 21 passed + 41 failed < pod/perltoot.pod # 68 Warnings 7% success 44 runs = 3 passed + 41 failed < cpan/Pod-Parser/lib/Pod/Parser.pm # 69 Warnings 7% success 44 runs = 3 passed + 41 failed < lib/Pod/Parser.pm # 70 STRICT 9% success 44 runs = 4 passed + 40 failed < lib/Text/Balanced.pm # 71 STRICT 11% success 45 runs = 5 passed + 40 failed < pod/perlref.pod # 72 STRICT 2% success 40 runs = 1 passed + 39 failed < pod/perlintern.pod # 73 STRICT 9% success 43 runs = 4 passed + 39 failed < cpan/Text-Balanced/lib/Text/Balanced.pm # 74 STRICT 32% success 56 runs = 18 passed + 38 failed < pod/perlcall.pod # 75 Warnings 5% success 40 runs = 2 passed + 38 failed < pod/perlintern.pod # 76 Warnings 14% success 44 runs = 6 passed + 38 failed < lib/Text/Balanced.pm # 77 Warnings 17% success 46 runs = 8 passed + 38 failed < cpan/File-Temp/Temp.pm # 78 Warnings 17% success 46 runs = 8 passed + 38 failed < lib/File/Temp.pm # 79 STRICT 3% success 38 runs = 1 passed + 37 failed < dist/Locale-Maketext/lib/Locale/Maketext.pod # 80 STRICT 3% success 38 runs = 1 passed + 37 failed < lib/Locale/Maketext.pod # 81 STRICT 12% success 42 runs = 5 passed + 37 failed < pod/perliol.pod # 82 Warnings 12% success 42 runs = 5 passed + 37 failed < pod/perliol.pod # 83 Warnings 14% success 43 runs = 6 passed + 37 failed < cpan/Text-Balanced/lib/Text/Balanced.pm # 84 Warnings 26% success 50 runs = 13 passed + 37 failed < pod/perldata.pod # 85 Warnings 49% success 73 runs = 36 passed + 37 failed < pod/perlfaq8.pod # 86 STRICT 27% success 48 runs = 13 passed + 35 failed < pod/perlebcdic.pod # 87 STRICT 41% success 59 runs = 24 passed + 35 failed < pod/perlipc.pod .... # 214 Warnings 64% success 59 runs = 38 passed + 21 failed < pod/perlipc.pod .... #1026 normal 93% success 59 runs = 55 passed + 4 failed < pod/perlipc.pod This witch-hunt is counter-productive and harmful. You should not be offended, or even surprised, if its results are not agreed to. Again I urge you to look first to the beam in your own eye before worrying about the speck in your brother's. Just because it's old advice doesn't make it lose one scintilla of its applicability. --tom
