Anša Vernerová writes: > Hello, I would like to report that the current documentation for the > split command is erronerrous. > http://perldoc.perl.org/functions/split.html says:
Hi there. Thanks for spotting this, and taking the time to look into how you can report it. > This must come from some edit of the older version of the > documentation, which can be found e.g. at > http://www.tu-chemnitz.de/docs/perldoc-html/functions/split.html : As it happens you can also get to older versions on the perldoc.perl.org site -- see the 'Perl version' box near the top left, which lets you get to pages like this: http://perldoc.perl.org/5.12.2/functions/split.html However, an easier way to check precisely where this came from is to look at the source repository, which is here: http://perl5.git.perl.org/perl.git Click on 'tree' to browse the files, guess that documentation is in the 'pod' subdirectory, see 'perlfunc.pod' in the list, and click 'blame', which takes you to this page: http://perl5.git.perl.org/perl.git/blame/HEAD:/pod/perlfunc.pod Searching that for '$remainder' takes you to the line in question, then clicking the commit ID at the start of that line goes to this commit: http://perl5.git.perl.org/perl.git/commit/bd4675851936488a7b28a813c5b60248be3e733b?f=pod/perlfunc.pod You can then click 'diff' to see exactly what was changed. > When I wanted to report this, I found it hard to find out where and > how I should report. There is a contacts section at the bottom of the > page, Those are contact details for the perldoc.perl.org site, which takes the documentation that comes with Perl, formats it nicely, and makes it available as a handy website. But JJ doesn't change the content, so that needs to be reported upstream. > reporting to the perl 5 porters list did not seem adequate. The perlfunc documentation comes with perl, so the Perl 5 Porters are indeed the people to report this to, preferably using the perlbug command so that it gets tracked in their queue until resolved. If you have a suggested correction you can submit a patch with your bug report. (This would also get you in the credits of the next version of Perl.) See perlhack for friendly instructions on how to do that: http://perldoc.perl.org/perlhack.html Cheers Smylers -- http://twitter.com/Smylers2
