better documentaion, change default to 'replace'

replace is a better default as it at least shows that there
were odd characters there if you're looking at output.

correctly return bytes if capture rather than an empty string.

Also more throrough test here.