doc: replace now-defunct `strchr` with `search`.

Also added a deprecation for good measure since we were documenting
this as working until just now.