r8211: documentation improvements, fix typo in error string