How about adding an explanation about how the diagnostics pragma works? It simply looks up error messages in perldiag and includes the descriptions in the error output.

I think it will be useful for Perl programmers to know that there is a whole document that lists all of Perl's error messages (not to mention a few error messages from other sources), and that error messages can be looked up there when one doesn't use diagnostics.