Need to document using `replace` with a function

The extensions doc says:

replace can be either a string or a function

but then it doesn't document how to use the function. Can you please document this?