Refactor: libcrmcommon: Clarify replace_text() a bit and add doxygen

For one thing, length now refers to the string length rather than to the
size of the allocated memory chunk.

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>