Go to file
Petri Lehtinen bad16ea52a Fix API tests for object
Because of a typo in test/testprogs/Makefile.am, the tests for object
were never compiled or run.
2009-10-11 21:38:42 +03:00
doc jansson 1.0.3 2009-09-14 14:32:41 +03:00
src Fix a few more compilation issues 2009-10-06 13:22:27 +03:00
test Fix API tests for object 2009-10-11 21:38:42 +03:00
.gitignore Remove config.h.in 2009-10-11 21:38:41 +03:00
CHANGES jansson 1.0.3 2009-09-14 14:32:41 +03:00
configure.ac Relax Autoconf version prereq 2009-10-01 21:54:29 +03:00
LICENSE Add LICENSE and a copyright note to all sources 2009-07-30 11:32:24 +03:00
Makefile.am Distribute CHANGES 2009-09-08 16:57:45 +03:00
README.rst Add README and API reference 2009-08-13 18:38:03 +03:00

Jansson README
==============

Jansson_ is a C library for encoding, decoding and manipulating JSON
data. Its main features and design principles are:

- Simple and intuitive API and data model

- Good documentation

- Full Unicode support (UTF-8)

- Extensive test suite

- No dependencies on other libraries

Jansson is licensed under the `MIT license`_; see LICENSE in the
source distribution for details.


Compilation and Installation
----------------------------

If you obtained a source tarball, just use the standard autotools
commands::

   $ ./configure && make && make install

If the source has been checked out from a Git repository, the
./configure script has to be generated fist. The easiest way is to use
autoreconf::

   $ autoreconf -i

To run the test suite, invoke::

   $ make check

Python_ is required to run the tests.


Documentation
-------------

Documentation is in the ``doc/`` subdirectory. It's written in
reStructuredText_ with Sphinx_ annotations, so reading it in plain may
be inconvenient. For this reason, prebuilt HTML documentation is
available at http://www.digip.org/jansson/doc/.

To generate HTML documentation yourself, invoke::

   cd doc/
   sphinx-build . .build/html

... and point your browser to ``.build/html/index.html``. Sphinx_ is
required to generate the documentation.


.. _Jansson: http://www.digip.org/jansson/
.. _`MIT license`: http://www.opensource.org/licenses/mit-license.php
.. _Python: http://www.python.org/
.. _reStructuredText: http://docutils.sourceforge.net/rst.html
.. _Sphinx: http://sphinx.pocoo.org/