This patch adds support for "info" and "texinfo" targets to
doc/Makefile. This lets me build info pages for use in Emacs. This
works at least with python-sphinx 1.1.3, which is in Fedora 18.
---
docs/Makefile | 12 ++++++++++++
docs/conf.py | 10 +++++++++-
2 files changed, 21 insertions(+), 1 deletion(-)
diff --git a/docs/Makefile b/docs/Makefile
index 2fe488c..991f4fd 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -29,6 +29,8 @@ help:
@echo " latexpdf to make LaTeX files and run them through pdflatex"
@echo " text to make text files"
@echo " man to make manual pages"
+ @echo " texinfo to make a Texinfo document"
+ @echo " info to make an info page"
@echo " changes to make an overview of all changed/added/deprecated items"
@echo " linkcheck to check all external links for integrity"
@echo " doctest to run all doctests embedded in the documentation (if enabled)"
@@ -113,6 +115,16 @@ man:
@echo
@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
+texinfo:
+ $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
+ @echo
+ @echo "Build finished. The Texinfo pages are in $(BUILDDIR)/texinfo."
+
+info: texinfo
+ cd $(BUILDDIR)/texinfo && $(MAKE) info
+ @echo
+ @echo "Build finished. The info pages are in $(BUILDDIR)/texinfo."
+
changes:
$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
@echo
diff --git a/docs/conf.py b/docs/conf.py
index 052455c..a181d76 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -1,4 +1,4 @@
-# Copyright 2011, 2012 David Malcolm <dmalcolm(a)redhat.com>
+# Copyright 2011, 2012, 2013 David Malcolm <dmalcolm(a)redhat.com>
# Copyright 2011, 2012 Red Hat, Inc.
#
# This is free software: you can redistribute it and/or modify it
@@ -233,3 +233,11 @@ man_pages = [
('gcc-with-python', 'gcc-with-python', u'Run GCC whilst invoking a Python script',
[u'David Malcolm'], 1)
]
+
+# -- Options for Texinfo output ------------------------------------------------
+
+texinfo_documents = [
+ (master_doc, 'gcc-python-plugin', 'gcc-python-plugin Documentation',
+ 'David Malcolm', 'gcc-python-plugin', 'gcc-python-plugin Documentation',
+ 'Software development', False)
+]
--
1.8.1.4