Merge branch '2.1'

doc: Explain the non-constness of the first parameter of json_unpack() et al

Fixes GH-30.

Merge branch '2.1'

Merge branch 'issue-29'

Fixes GH-29.

doc: Add documentation for json_dump_callback()

test file for new json_dump_callback function

new typedef json_dump_callback_t, function json_dump_callback

doc: Fix several typos and other little errors

use size_t for strbuffer writes, and avoid integer overflow

Check that target is string and value is not NULL in json_string_set()

doc: Clarify that removing from containers decrements the refcount

While at it, reword the object iteration protocol description a bit.

CHANGES: Fix v2.1 release date

jansson 2.1

Use ``literal`` syntax with macro and flag names in CHANGES

Prepare for relase: Add CHANGES entry for v2.1

Add JSON_DISABLE_EOF_CHECK decoding flag

With this flag enabled, the decoder stops after a valid JSON input and
thus allows extra data after it.

Fixes GH-25.

Reduce code duplication in the decoder

Clear errno before calling strtod()

Fixes GH-27.

Add JSON_REJECT_DUPLICATES decoding flag

With this flag, a decoding error is issued if any JSON object in the
input contains duplicate keys.

Fixes GH-3.

doc: Clarify that Unicode normalization or comparison algorithms are not used

doc: Add "New in version 2.1" notes to new features

docs: Add a note that object iteration doesn't give any particular order

Closes GH-15.

Add JSON_ENCODE_ANY flag to allow encoding any JSON value

Closes GH-19.

Merge branch '2.0'

Fix a leak when memory allocation fails in json_object_set() & friends

Add json_loadb() for decoding possibly non null-terminated strings

Thanks to Jonathan Landis for the initial patch.

Merge branch '2.0'

Avoid set-but-not-used warning/error in a test

Closes GH-20.

Merge branch '2.0'

Conflicts:
doc/conf.py
src/jansson.h

jansson 2.0.1

Merge branch '2.0'

Fix a few malloc() and free() calls

Replace them with jsonp_malloc() and jsonp_free() to support the
custom memory allocation.

Fix invalid object key hashing in json_unpack() strict checking mode

The keys which are stored temporarily to a hashtable to make sure that
all object keys are unpacked, were hashed with the object key hashing
function. It is meant to compute hashes for object_key_t values, and
it works incorrectly for plain strings.

Fixed by introducing suitable functions for hashing and comparing
strings for string-keyed hashtables.

Merge branch '2.0'

Set JANSSON_MICRO_VERSION to 255 (0xFF) for git master

Also, set documentation release to "2.0+git". This shows up in the
automatically built HTML documentation.

These changes makes it easier for library users to know that this
version is under development.

Closes GH-14.

Use the correct number of parens in JANSSON_VERSION_HEX macro

Test framework enhancements, fix the check_exports test

* Use "printf" instead of "echo -n" as it's more portable
* Treat a test as skipped if it exits with exit status of 77
* Skip the check_exports test if "nm -D" doesn't work

Use the correct number of parens in JANSSON_VERSION_HEX macro

ANSI C requires struct initializers to be constant expressions

Closes GH-17.

Fix json_object_size() return value

Return 0 as documented if the argument is not a JSON object.

Closes GH-18.

Enhance portability of va_copy()

va_copy() is a C99 feature. In C89 implementations, it's sometimes
available as __va_copy(). If not, memcpy() should do the trick.

Fix a declaration after statement

While at it, add -Wdeclaration-after-statement to AM_CFLAGS to catch
these in the future.

Distribute doc/upgrading.rst

Closes GH-16.

Check documentation in make distcheck

It seems that the only way to do this is to use the dvi make target,
as it's built in make distcheck after running configure.

jansson 2.0

Fix packing of invalid UTF-8 strings

Update README

tests: Add missing json_decref() calls to suites/api/test_unpack.c

Remove invalid subdirs from test/suites/Makefile.am

doc: Change the title of the upgrading section

Small documentation tweaks

- Capitalize section titles correctly

- Rename "Building on Windows" to "Building on non-Unix systems" and
  tweak the text accordingly.

- Remove the "Installing Prebuilt Binaries" section. This info is
  better in the web instead, as it may change.

- Mention that Sphinx 1.0 or newer is required.

Add "Upgrading from older releases" to docs, tweak CHANGES a bit

Add a CHANGES entry for version 2.0

Wow, lots of stuff. And it's been a long while after the last release.

Add lots of tests for pack/unpack code, fix bugs found

Closes GH-12.

Move json_error_t documentation to its own section

json_error_t is used in the decoder and in the pack and unpack API's,
so it's better to have a separate section for it.

Truncate error source from start, not end, if it's too long to fit

It's more helpful to see "...bar/baz.json" instead of "/long/path/to".

Refactor decoder input stream

- Add a new field position to the json_error_t structure. This is the
  position in bytes from the beginning of the input.

- Keep track of line, column and input position in the stream level.
  Previously, only line was tracked, and it was in the lexer level, so
  this info was not available for UTF-8 decoding errors.

- While at it, refactor tests so that no separate "stripped" tests are
  required. json_process is now able to strip whitespace from its
  input, and the "valid" and "invalid" test suites now use this to
  test both non-stripped and stripped input.

Closes GH-9.

tests: Use "make STOP=1 check" to stop on first failure

Add custom memory allocation

Thanks to Basile Starynkevitch for the suggestion and initial patch.
Thanks to Jonathan Landis and Deron Meranda for showing how this can
be utilized for implementing secure memory operations.

Resolve __va_list_tag ** -> va_list * type errors with clang and future GCCs

Functions taking va_args are munged to receive arguments of type
'__va_list_tag *'. This patch uses va_copy to coerce them to the expected type
so we don't get compiler errors.

Tested on x86_64, both 32-bit and 64-bit compiles.

Reported-By: Basile Starynkevitch <basile@starynkevitch.net>

Fix an unpack example in the docs

Tweak the default validation behaviour of the unpack API

Now, by default, unpacking doesn't check that all array and object
items are accessed. The check can be enabled globally by using the
JSON_STRICT flag (formerly JSON_UNPACK_ONLY), or on a per-value basis
by using the new '!' format character. The '*' format character is
still available to disable the global check on a per-value basis.

Use the Sphinx default theme again for documentation

The "haiku" theme doesn't show chapter contents in sidebar.

Documentation for pack and unpack functions

Add the 'I' format for both pack and unpack

Use 'f' for real and 'F' for number (real or integer) in unpack

unpack: Unify and enhance error messages

Give the type name instead of its enum index in the error message when
an unexpected value is encountered while unpacking.

Expand the pack/unpack API, implement unpack flags

Expand the pack/unpack API: json_(un)pack is the simple version with
no error output, json_(un)pack_ex has error output and flags,
json_v(un)pack_ex is a va_list version of json_(un)pack_ex.

Implement unpacking flags:

- JSON_UNPACK_ONLY turns off extra validation, i.e. array and object
  unpacking doesn't check that all items are unpacked. This is really
  just convenience for not adding '*' after each object and array.

- JSON_VALIDATE_ONLY turns off unpacking, i.e. no varargs are expected
  and nothing is unpacked.

Add validation features to json_unpack()

* By default, json_unpack() now checks that all items of arrays and
  objects are unpacked. This is useful for validation.

* Add format specifier '*' to suppress this check for individual
  arrays and objects. '*' must appear as the last format specifier
  before the closing ']' or '}'.

Rename variadic.c to pack_unpack.c

Refactor json_unpack()

* Use the format string scanner from the previous commit (with the
  simpler separator skipping semantics)

* Split json_vnunpack() to three separate functions for unpacking
  objects, arrays and "simple" values

* Always return 0 on success, 1 on error

This shaves around 100 more lines from the original implementation.

Refactor json_pack()

* Implement a "scanner" that reads the format string, maintaining state

* Split json_vnpack() to three separate functions for packing objects,
  arrays and simple values. This makes it more clear what is being
  packed, and the object and array structures become more evident.

* Make the skipping of ignored character simpler, i.e. skip ':' and
  ',' independent of their context

This patch shaves around 80 lines of code from the original
implementation.

Unify style

Update copyright notices for 2011

Build cleanly with gcc's -Werror=declaration-after-statement flag

Remove debugging printf

Make json_pack/json_unpack() recursive

Note that we pass va_list pointers around instead of just va_lists, which
would seem more intuitive. This is necessary since the behaviour of va_lists
passed as function parameters is finicky. Quoth stdarg(3):

If ap is passed to a function that uses va_arg(ap,type) then the value
of ap is undefined after the return of that function.

The pointer-passing strategy is used by Python's Py_BuildValue() for the same
purpose.

Emphasize the constness of the return value of json_string_value()

Closes GH-7.

Document the version info constants

Make int32_t available when the configure script is not used

Add version info to jansson.h

Enhance error reporting

This patch adds two new fields to the json_error_t struct: column and
source. It also adds functions to populate json_error_t internally.

The column field is not currently used, but it will be utilized in the
decoder and pack/unpack functions.

Move and enhance documentation on json_error_t

Make json_error_t transparent again

After looking at the new code for a few days, I didn't like it
anymore. To prepare for the future, a few fields will be added to the
json_error_t struct later.

This reverts commit 23dd078c8dcb17fd29d3b69f082b5b93f5f13b8f. Some
adjustments were needed because of newer commits.

Adds json_pack / json_unpack variadic functions.

Remove all "Added in version 1.x" info from documentation

As 2.0 will be backwards incompatible anyway, there's no need to
record which features were new in which 1.x releases.

Make json_error_t opaque

All decoding functions now accept a json_error_t** parameter and set
it to point to a heap-allocated json_error_t structure if an error
occurs. The contents of json_error_t are no longer exposed directly, a
few functions to do it have been added instead. If an error occurs,
the user must free the json_error_t value.

This makes it possible to enhance the error reporting facilities in
the future without breaking ABI compatibility with older versions.

This is a backwards incompatible change.

Merge branch '1.3'

Run Sphinx without the -W flag when building documentation

In "make html", don't use the -W flag with Sphinx. This makes it
possible to create the documentation with Sphinx 1.0 without errors,
as the warning about using old-style C markup isn't turned to an
error.

Don't build documentation in "make check". Instead, add a new make
target "check-doc" to build the documentation with the -W flag.

Use Sphinx 1.0, change the HTML theme

Add a section describing how to build on Windows

On Windows, typedef int to int32_t

There's no inttypes.h or stdint.h in the stdlib on Windows.

Add jansson_config.h.win32

As the configure script cannot be run on Windows, give the users a
jansson_config.h that they can use directly.

Move max() to jansson_private.h, define only if not already defined

On some platforms (Visual C++ for one) the standard library already
defines max() as a macro.

Don't use designated struct initializers

It's a C99 feature and not available on all compilers (Visual C++, for
example).

Use config.h only if it exists

This makes it easier to compile without the configure script (e.g. on
Windows).

Replace all occurences of inline with JSON_INLINE

This makes it easier to compile without the configure script (e.g. on
Windows).

Merge branch '1.3'

Conflicts:
doc/apiref.rst
src/jansson_private.h

Set the version number to 2.0pre

Clarify and document the integer type configuration