Errata#

This chapter records places where the canonical Perl 5 documentation is wrong, ambiguous, or stale, together with what each PetaPerl runtime actually does. Each entry has the same shape:

  1. Upstream wording — the relevant text from the official perl5-upstream/pod/ source, quoted verbatim.

  2. Correction — what the documentation should say, established from upstream’s own C source and from empirical probing.

  3. p5 runtime behavior — what pperl (default, p5 runtime) does. Where this differs from upstream perl5, the divergence is flagged and tracked.

  4. pp runtime behavior — what pperl --pp does. The pp runtime is intentionally not bound to byte-for-byte upstream conformance, so divergences here are sometimes deliberate; the entry says which.

The goal of this chapter is operational, not editorial: if a user hits surprising behavior around one of these topics, they should find an answer here and know which runtime they are running.