May I also suggest replacing `\n` with `\1...\9`? Maybe that way it is easier to visually identify if you're looking for it, and less ambiguous (a literal `\n` means newline, and maybe someone reading the docs quickly just ignores that entry because they assume it's talking about the newline).
(And maybe it is a good idea to add a note in the documentation highlighting that `&` and `$1...$9` don't work as they do in other regex "dialects" such as Perl; it's `\0` and `\1...\9` here. After all, the documentation does claim that *"the syntax is Perl compatible"*, so one might assume this also applies to substitution patterns.)