jansson/doc/Makefile.am

EXTRA_DIST = \
	conf.py apiref.rst gettingstarted.rst github_commits.c index.rst \
	tutorial.rst ext/refcounting.py

SPHINXBUILD = sphinx-build
SPHINXOPTS = -d _build/doctrees -W

# Convert json_*() functions to :cfunc: cross references in
# ../CHANGES, and add a header from changes.rst.in
changes.rst: changes.rst.in ../CHANGES
	set -e; \
	cat changes.rst.in >$@; \
	sed -r -e 's/``(json_[a-z_]+\(\))``/:cfunc:`\1`/g' ../CHANGES \
		>>$@

html-local: changes.rst
	$(SPHINXBUILD) -b html $(SPHINXOPTS) $(srcdir) _build/html

install-html-local: html
	mkdir -p $(DESTDIR)$(htmldir)
	cp -r _build/html $(DESTDIR)$(htmldir)

uninstall-local:
	rm -rf $(DESTDIR)$(htmldir)

clean-local:
	rm -rf _build
	rm -f ext/refcounting.pyc changes.rst
Distribute all the docs 2009-10-24 18:41:39 +08:00			`EXTRA_DIST = \`
Really distribute all the docs The tutorial example github_commits.c was still left out. 2009-10-25 05:17:16 +08:00			`conf.py apiref.rst gettingstarted.rst github_commits.c index.rst \`
Distribute all the docs 2009-10-24 18:41:39 +08:00			`tutorial.rst ext/refcounting.py`
Add README and API reference 2009-08-03 02:26:37 +08:00
Build documentation in make html target To keep the distchecks for the documentation, the documentation has to be built in the check target instead of distcheck-hook. While at it, rename doc/.build to doc/_build. This naming is the default with sphinx 0.6.2. 2009-11-04 05:07:43 +08:00			`SPHINXBUILD = sphinx-build`
			`SPHINXOPTS = -d _build/doctrees -W`

doc: Convert CHANGES to reStructuredText and add it to HTML docs CHANGES is preprocessed to convert json_*() function names to Sphinx :cfunc: cross references. This is to keep CHANGES more readable in both plain text and HTML. 2010-01-13 03:58:52 +08:00			`# Convert json_*() functions to :cfunc: cross references in`
			`# ../CHANGES, and add a header from changes.rst.in`
			`changes.rst: changes.rst.in ../CHANGES`
			`set -e; \`
			`cat changes.rst.in >$@; \`
			sed -r -e 's/``(json_[a-z_]+\(\))``/:cfunc:`\1`/g' ../CHANGES \
			`>>$@`

			`html-local: changes.rst`
Build documentation in make html target To keep the distchecks for the documentation, the documentation has to be built in the check target instead of distcheck-hook. While at it, rename doc/.build to doc/_build. This naming is the default with sphinx 0.6.2. 2009-11-04 05:07:43 +08:00			`$(SPHINXBUILD) -b html $(SPHINXOPTS) $(srcdir) _build/html`

			`install-html-local: html`
			`mkdir -p $(DESTDIR)$(htmldir)`
			`cp -r _build/html $(DESTDIR)$(htmldir)`

			`uninstall-local:`
			`rm -rf $(DESTDIR)$(htmldir)`

Add README and API reference 2009-08-03 02:26:37 +08:00			`clean-local:`
Build documentation in make html target To keep the distchecks for the documentation, the documentation has to be built in the check target instead of distcheck-hook. While at it, rename doc/.build to doc/_build. This naming is the default with sphinx 0.6.2. 2009-11-04 05:07:43 +08:00			`rm -rf _build`
doc: Convert CHANGES to reStructuredText and add it to HTML docs CHANGES is preprocessed to convert json_*() function names to Sphinx :cfunc: cross references. This is to keep CHANGES more readable in both plain text and HTML. 2010-01-13 03:58:52 +08:00			`rm -f ext/refcounting.pyc changes.rst`