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@redhat.com +# Copyright 2011, 2012, 2013 David Malcolm dmalcolm@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) +]
On Tue, 2013-04-16 at 13:32 -0600, Tom Tromey wrote:
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.
Thanks! I've applied and pushed this as 03a9bf480e69bffd78e0dbe13dbf8262e28c7874
gcc-python-plugin@lists.fedorahosted.org