---
status: documented
name: Errata
---
# 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.

```{toctree}
:maxdepth: 1

identifier-length
```