From: Eric S. Raymond <esr@thyrsus.com>
Date: Fri, 26 Sep 2014 20:15:01 +0000 (-0400)
Subject: Document bugs.
X-Git-Tag: 1.2~5
X-Git-Url: http://thyrsus.com/gitweb/?a=commitdiff_plain;h=1292d3b6e31c760982010051a57c8f062f568bcb;p=microjson.git

Document bugs.
---

diff --git a/mjson.asc b/mjson.asc
index e8e1ab8..a96e678 100644
--- a/mjson.asc
+++ b/mjson.asc
@@ -43,11 +43,24 @@ _Building Static JSON Parsers With Microjson_ shipped with the
 distribution.
 
 == RETURN VALUE ==
-
 The two main functions return 0 for success, a nonzero error code for
 failure.  The function +json_error_string()+ maps error codes to
 explanatory messages.
 
+== BUGS ==
+A backslash escape of "\0000" in a string value will drop a NUL in the 
+string that is likely to confuse C code looking at the storage.  In
+general, the high byte of a \uxxxxx escape will be ignored and the
+ASCII high-half byte named by the last two hex digits will be
+inserted in the string.
+
+There is no way to make a parser accept the typeless special JSON
+value "null", because there is nothing in C's type ontology to map it
+to. 
+
+JSON arrays are restricted to having a single homogenous element type.
+However, the type mayy itself be a JSON object.
+
 == REPORTING BUGS ==
 Report bugs to Eric S. Raymond <esr@thyrsus.com>.  The project page is
 at http://catb.org/~esr/microjson