Improve docs for `replace`.

As said on #haskell:

    (09:08:42 PM) c_wraith: Hmm.  that's a function that really does need better
    docs - the type signature doesn't pin down argument order.