jansson/doc/Makefile.am

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

SPHINXBUILD = sphinx-build
SPHINXOPTS = -d _build/doctrees $(SPHINXOPTS_EXTRA)

html-local:
	$(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
doc: Distribute conformance.rst 2010-04-03 18:49:38 +08:00			`EXTRA_DIST = conf.py apiref.rst changes.rst conformance.rst \`
			`gettingstarted.rst github_commits.c index.rst 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`
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. 2010-09-07 01:46:14 +08:00			`SPHINXOPTS = -d _build/doctrees $(SPHINXOPTS_EXTRA)`
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
Remove CHANGES preprocessing, as it didn't work with VPATH builds The problem is that Sphinx can only read input files from a single directory. In VPATH builds, the source and build trees are separate, and the changes.rst went into the build tree. This patch solves the issue by using cfunc as the Sphinx default role. 2010-01-22 02:53:05 +08:00			`html-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			`$(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/Makefile.am: Don't remove changes.rst in clean 2010-01-27 03:19:48 +08:00			`rm -f ext/refcounting.pyc`