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