Issue #3259471: Improve str_replace documentation re: regex (preg_replace)

Alison Jorequested to merge
issue/migrate_plus-3259471:3259471-improve-strreplace-documentation into 8.x-5.x

Merge request reports