perlfunc - update each documentation with foreach examples

[Grinnz]

Also mention multiple-value foreach as a new alternative, and fix a hash dereference in a previous example.

---

• This set of changes does not require a perldelta entry.

[tonycoz]

You've used a different commit author here, which upsets porting/authors.t

[Grinnz]

Updated mailmap and rebased