README revision 4139
4139N/A#
4139N/A# CDDL HEADER START
4139N/A#
4139N/A# The contents of this file are subject to the terms of the
4139N/A# Common Development and Distribution License (the "License").
4139N/A# You may not use this file except in compliance with the License.
4139N/A#
4139N/A# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
4139N/A# or http://www.opensolaris.org/os/licensing.
4139N/A# See the License for the specific language governing permissions
4139N/A# and limitations under the License.
4139N/A#
4139N/A# When distributing Covered Code, include this CDDL HEADER in each
4139N/A# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
4139N/A# If applicable, add the following below this CDDL HEADER, with the
4139N/A# fields enclosed by brackets "[]" replaced with your own identifying
4139N/A# information: Portions Copyright [yyyy] [name of copyright owner]
4139N/A#
4139N/A# CDDL HEADER END
4139N/A#
4139N/A# Copyright (c) 2014, 2015, Oracle and/or its affiliates. All rights reserved.
4139N/A#
4139N/A
4139N/AThe manpage and the HTML documentation is generated using Sphinx -
4139N/Asphinx-doc.org. The last Oracle approved (TPNO 18268) version is 1.2.2.
4139N/AThe tool is not delivered as part of Solaris, so there's no way to generate
4139N/Athis automatically on build server(s), therefore whenever one is updating the
4139N/Alibrary, the documentation should be manually re-generated and the resulting
4139N/Afiles added here.
4139N/A
4139N/AThe 'html' subdirectory is added as generated.
4139N/A
4139N/AThe jansson.3lib in 'man3lib' subdirectory needed to be manually modified after
4139N/Ageneration so that Solaris nroff(1) is able to read it (GNU nroff is needed
4139N/Aotherwise).
4139N/A
4139N/ABecause we deliver the header files to /usr/include/jansson, it's necessary to
4139N/Amake sure the examples in the manpage and HTML documentation are correct when
4139N/Aupdating the library.