diff --git a/README.md b/README.md
index f65b8ad..7897409 100644
--- a/README.md
+++ b/README.md
@@ -2,9 +2,7 @@
 Lightweight ISO-6937 to UTF-8 conversion library.
 
 ## SYNOPSIS
-``
-int xconv(char *inbuf, char *outbuf, size_t outbuflen);
-``
+int xconv(char \*inbuf, char \*outbuf, size\_t outbuflen);
 
 ## DESCRIPTION
 
@@ -16,7 +14,7 @@ If a UTF-8 sequence is found within the input string, processing is aborted.
 ## RETURN VALUE
 
 On successful conversion, the xconv() function returns the number of
-characters placed into _outbuf_.
+characters placed into _outbuf_ excluding the string terminator.
 
 If no conversion is necessary (plain ASCII input string or a UTF-8 sequence
 was found) then the function returns 0. In this case, the state of the