My answer to the last question. I think that people should be encouraged subtly and unsubtly to rely their local documentation (accessible through perldoc). That is the only way to get documentation with any guarantee that its advice should match the version of Perl that you are using. Any version of Perl that they choose to document here