release ready; escape of weird characters in documentation pending
escaping docs