X-Git-Url: http://www.project-moonshot.org/gitweb/?p=jansson.git;a=blobdiff_plain;f=doc%2Fapiref.rst;h=dcc0cbfd299061bf96c0641503039967339f0c99;hp=e37cb8c1bf0c7350b3596b3399e017b8bfb7f56b;hb=269e86b72572a6ba546270e8d22409efc40c2fbd;hpb=bf32f6cd75a6a809f685a02cd0ac574c96824049

diff --git a/doc/apiref.rst b/doc/apiref.rst
index e37cb8c..dcc0cbf 100644
--- a/doc/apiref.rst
+++ b/doc/apiref.rst
@@ -306,6 +306,10 @@ U+10FFFF are allowed.
    Returns the associated value of *string* as a null terminated UTF-8
    encoded string, or *NULL* if *string* is not a JSON string.
 
+   The retuned value is read-only and must not be modified or freed by
+   the user. It is valid as long as *string* exists, i.e. as long as
+   its reference count has not dropped to zero.
+
 .. function:: int json_string_set(const json_t *string, const char *value)
 
    Sets the associated value of *string* to *value*. *value* must be a