CHANGES 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495
  1. Version 2.4
  2. ===========
  3. Released 2012-09-23
  4. * New features:
  5. - Add `json_boolean()` macro that returns the JSON true or false
  6. value based on its argument (#86).
  7. - Add `json_load_callback()` that calls a callback function
  8. repeatedly to read the JSON input (#57).
  9. - Add JSON_ESCAPE_SLASH encoding flag to escape all occurences of
  10. ``/`` with ``\/``.
  11. * Bug fixes:
  12. - Check for and reject NaN and Inf values for reals. Encoding these
  13. values resulted in invalid JSON.
  14. - Fix `json_real_set()` to return -1 on error.
  15. * Build:
  16. - Jansson now builds on Windows with Visual Studio 2010, and
  17. includes solution and project files in ``win32/vs2010/``
  18. directory.
  19. - Fix build warnings (#77, #78).
  20. - Add ``-no-undefined`` to LDFLAGS (#90).
  21. * Tests:
  22. - Fix the symbol exports test on Linux/PPC64 (#88).
  23. * Documentation:
  24. - Fix typos (#73, #84).
  25. Version 2.3.1
  26. =============
  27. Released 2012-04-20
  28. * Build issues:
  29. - Only use ``long long`` if ``strtoll()`` is also available.
  30. * Documentation:
  31. - Fix the names of library version constants in documentation. (#52)
  32. - Change the tutorial to use GitHub API v3. (#65)
  33. * Tests:
  34. - Make some tests locale independent. (#51)
  35. - Distribute the library exports test in the tarball.
  36. - Make test run on shells that don't support the ``export FOO=bar``
  37. syntax.
  38. Version 2.3
  39. ===========
  40. Released 2012-01-27
  41. * New features:
  42. - `json_unpack()` and friends: Add support for optional object keys
  43. with the ``{s?o}`` syntax.
  44. - Add `json_object_update_existing()` and
  45. `json_object_update_missing()`, for updating only existing keys or
  46. only adding missing keys to an object. (#37)
  47. - Add `json_object_foreach()` for more convenient iteration over
  48. objects. (#45, #46)
  49. - When decoding JSON, write the number of bytes that were read from
  50. input to ``error.position`` also on success. This is handy with
  51. ``JSON_DISABLE_EOF_CHECK``.
  52. - Add support for decoding any JSON value, not just arrays or
  53. objects. The support is enabled with the new ``JSON_DECODE_ANY``
  54. flag. Patch by Andrea Marchesini. (#4)
  55. * Bug fixes
  56. - Avoid problems with object's serial number growing too big. (#40,
  57. #41)
  58. - Decoding functions now return NULL if the first argument is NULL.
  59. Patch by Andrea Marchesini.
  60. - Include ``jansson_config.h.win32`` in the distribution tarball.
  61. - Remove ``+`` and leading zeros from exponents in the encoder.
  62. (#39)
  63. - Make Jansson build and work on MinGW. (#39, #38)
  64. * Documentation
  65. - Note that the same JSON values must not be encoded in parallel by
  66. separate threads. (#42)
  67. - Document MinGW support.
  68. Version 2.2.1
  69. =============
  70. Released 2011-10-06
  71. * Bug fixes:
  72. - Fix real number encoding and decoding under non-C locales. (#32)
  73. - Fix identifier decoding under non-UTF-8 locales. (#35)
  74. - `json_load_file()`: Open the input file in binary mode for maximum
  75. compatiblity.
  76. * Documentation:
  77. - Clarify the lifecycle of the result of the ``s`` fromat of
  78. `json_unpack()`. (#31)
  79. - Add some portability info. (#36)
  80. - Little clarifications here and there.
  81. * Other:
  82. - Some style fixes, issues detected by static analyzers.
  83. Version 2.2
  84. ===========
  85. Released 2011-09-03
  86. * New features:
  87. - `json_dump_callback()`: Pass the encoder output to a callback
  88. function in chunks.
  89. * Bug fixes:
  90. - `json_string_set()`: Check that target is a string and value is
  91. not NULL.
  92. * Other:
  93. - Documentation typo fixes and clarifications.
  94. Version 2.1
  95. ===========
  96. Released 2011-06-10
  97. * New features:
  98. - `json_loadb()`: Decode a string with a given size, useful if the
  99. string is not null terminated.
  100. - Add ``JSON_ENCODE_ANY`` encoding flag to allow encoding any JSON
  101. value. By default, only arrays and objects can be encoded. (#19)
  102. - Add ``JSON_REJECT_DUPLICATES`` decoding flag to issue a decoding
  103. error if any JSON object in the input contins duplicate keys. (#3)
  104. - Add ``JSON_DISABLE_EOF_CHECK`` decoding flag to stop decoding after a
  105. valid JSON input. This allows other data after the JSON data.
  106. * Bug fixes:
  107. - Fix an additional memory leak when memory allocation fails in
  108. `json_object_set()` and friends.
  109. - Clear errno before calling `strtod()` for better portability. (#27)
  110. * Building:
  111. - Avoid set-but-not-used warning/error in a test. (#20)
  112. * Other:
  113. - Minor clarifications to documentation.
  114. Version 2.0.1
  115. =============
  116. Released 2011-03-31
  117. * Bug fixes:
  118. - Replace a few `malloc()` and `free()` calls with their
  119. counterparts that support custom memory management.
  120. - Fix object key hashing in json_unpack() strict checking mode.
  121. - Fix the parentheses in ``JANSSON_VERSION_HEX`` macro.
  122. - Fix `json_object_size()` return value.
  123. - Fix a few compilation issues.
  124. * Portability:
  125. - Enhance portability of `va_copy()`.
  126. - Test framework portability enhancements.
  127. * Documentation:
  128. - Distribute ``doc/upgrading.rst`` with the source tarball.
  129. - Build documentation in strict mode in ``make distcheck``.
  130. Version 2.0
  131. ===========
  132. Released 2011-02-28
  133. This release is backwards incompatible with the 1.x release series.
  134. See the chapter "Upgrading from older versions" in documentation for
  135. details.
  136. * Backwards incompatible changes:
  137. - Unify unsigned integer usage in the API: All occurences of
  138. unsigned int and unsigned long have been replaced with size_t.
  139. - Change JSON integer's underlying type to the widest signed integer
  140. type available, i.e. long long if it's supported, otherwise long.
  141. Add a typedef json_int_t that defines the type.
  142. - Change the maximum indentation depth to 31 spaces in encoder. This
  143. frees up bits from the flags parameter of encoding functions
  144. `json_dumpf()`, `json_dumps()` and `json_dump_file()`.
  145. - For future needs, add a flags parameter to all decoding functions
  146. `json_loadf()`, `json_loads()` and `json_load_file()`.
  147. * New features
  148. - `json_pack()`, `json_pack_ex()`, `json_vpack_ex()`: Create JSON
  149. values based on a format string.
  150. - `json_unpack()`, `json_unpack_ex()`, `json_vunpack_ex()`: Simple
  151. value extraction and validation functionality based on a format
  152. string.
  153. - Add column, position and source fields to the ``json_error_t``
  154. struct.
  155. - Enhance error reporting in the decoder.
  156. - ``JANSSON_VERSION`` et al.: Preprocessor constants that define the
  157. library version.
  158. - `json_set_alloc_funcs()`: Set custom memory allocation functions.
  159. * Fix many portability issues, especially on Windows.
  160. * Configuration
  161. - Add file ``jansson_config.h`` that contains site specific
  162. configuration. It's created automatically by the configure script,
  163. or can be created by hand if the configure script cannot be used.
  164. The file ``jansson_config.h.win32`` can be used without
  165. modifications on Windows systems.
  166. - Add a section to documentation describing how to build Jansson on
  167. Windows.
  168. - Documentation now requires Sphinx 1.0 or newer.
  169. Version 1.3
  170. ===========
  171. Released 2010-06-13
  172. * New functions:
  173. - `json_object_iter_set()`, `json_object_iter_set_new()`: Change
  174. object contents while iterating over it.
  175. - `json_object_iter_at()`: Return an iterator that points to a
  176. specific object item.
  177. * New encoding flags:
  178. - ``JSON_PRESERVE_ORDER``: Preserve the insertion order of object
  179. keys.
  180. * Bug fixes:
  181. - Fix an error that occured when an array or object was first
  182. encoded as empty, then populated with some data, and then
  183. re-encoded
  184. - Fix the situation like above, but when the first encoding resulted
  185. in an error
  186. * Documentation:
  187. - Clarify the documentation on reference stealing, providing an
  188. example usage pattern
  189. Version 1.2.1
  190. =============
  191. Released 2010-04-03
  192. * Bug fixes:
  193. - Fix reference counting on ``true``, ``false`` and ``null``
  194. - Estimate real number underflows in decoder with 0.0 instead of
  195. issuing an error
  196. * Portability:
  197. - Make ``int32_t`` available on all systems
  198. - Support compilers that don't have the ``inline`` keyword
  199. - Require Autoconf 2.60 (for ``int32_t``)
  200. * Tests:
  201. - Print test names correctly when ``VERBOSE=1``
  202. - ``test/suites/api``: Fail when a test fails
  203. - Enhance tests for iterators
  204. - Enhance tests for decoding texts that contain null bytes
  205. * Documentation:
  206. - Don't remove ``changes.rst`` in ``make clean``
  207. - Add a chapter on RFC conformance
  208. Version 1.2
  209. ===========
  210. Released 2010-01-21
  211. * New functions:
  212. - `json_equal()`: Test whether two JSON values are equal
  213. - `json_copy()` and `json_deep_copy()`: Make shallow and deep copies
  214. of JSON values
  215. - Add a version of all functions taking a string argument that
  216. doesn't check for valid UTF-8: `json_string_nocheck()`,
  217. `json_string_set_nocheck()`, `json_object_set_nocheck()`,
  218. `json_object_set_new_nocheck()`
  219. * New encoding flags:
  220. - ``JSON_SORT_KEYS``: Sort objects by key
  221. - ``JSON_ENSURE_ASCII``: Escape all non-ASCII Unicode characters
  222. - ``JSON_COMPACT``: Use a compact representation with all unneeded
  223. whitespace stripped
  224. * Bug fixes:
  225. - Revise and unify whitespace usage in encoder: Add spaces between
  226. array and object items, never append newline to output.
  227. - Remove const qualifier from the ``json_t`` parameter in
  228. `json_string_set()`, `json_integer_set()` and `json_real_set`.
  229. - Use ``int32_t`` internally for representing Unicode code points
  230. (int is not enough on all platforms)
  231. * Other changes:
  232. - Convert ``CHANGES`` (this file) to reStructured text and add it to
  233. HTML documentation
  234. - The test system has been refactored. Python is no longer required
  235. to run the tests.
  236. - Documentation can now be built by invoking ``make html``
  237. - Support for pkg-config
  238. Version 1.1.3
  239. =============
  240. Released 2009-12-18
  241. * Encode reals correctly, so that first encoding and then decoding a
  242. real always produces the same value
  243. * Don't export private symbols in ``libjansson.so``
  244. Version 1.1.2
  245. =============
  246. Released 2009-11-08
  247. * Fix a bug where an error message was not produced if the input file
  248. could not be opened in `json_load_file()`
  249. * Fix an assertion failure in decoder caused by a minus sign without a
  250. digit after it
  251. * Remove an unneeded include of ``stdint.h`` in ``jansson.h``
  252. Version 1.1.1
  253. =============
  254. Released 2009-10-26
  255. * All documentation files were not distributed with v1.1; build
  256. documentation in make distcheck to prevent this in the future
  257. * Fix v1.1 release date in ``CHANGES``
  258. Version 1.1
  259. ===========
  260. Released 2009-10-20
  261. * API additions and improvements:
  262. - Extend array and object APIs
  263. - Add functions to modify integer, real and string values
  264. - Improve argument validation
  265. - Use unsigned int instead of ``uint32_t`` for encoding flags
  266. * Enhance documentation
  267. - Add getting started guide and tutorial
  268. - Fix some typos
  269. - General clarifications and cleanup
  270. * Check for integer and real overflows and underflows in decoder
  271. * Make singleton values thread-safe (``true``, ``false`` and ``null``)
  272. * Enhance circular reference handling
  273. * Don't define ``-std=c99`` in ``AM_CFLAGS``
  274. * Add C++ guards to ``jansson.h``
  275. * Minor performance and portability improvements
  276. * Expand test coverage
  277. Version 1.0.4
  278. =============
  279. Released 2009-10-11
  280. * Relax Autoconf version requirement to 2.59
  281. * Make Jansson compile on platforms where plain ``char`` is unsigned
  282. * Fix API tests for object
  283. Version 1.0.3
  284. =============
  285. Released 2009-09-14
  286. * Check for integer and real overflows and underflows in decoder
  287. * Use the Python json module for tests, or simplejson if the json
  288. module is not found
  289. * Distribute changelog (this file)
  290. Version 1.0.2
  291. =============
  292. Released 2009-09-08
  293. * Handle EOF correctly in decoder
  294. Version 1.0.1
  295. =============
  296. Released 2009-09-04
  297. * Fixed broken `json_is_boolean()`
  298. Version 1.0
  299. ===========
  300. Released 2009-08-25
  301. * Initial release
粤ICP备19079148号