Generate doc/man/isympy.1 from the isympy.xml source

zxo102 · Jun 16, 2014 · b53d8d0 · b53d8d0
1 parent c8e7fb8
commit b53d8d0
Show file tree

Hide file tree

Showing 5 changed files with 10 additions and 4 deletions.
diff --git a/.travis.yml b/.travis.yml
@@ -122,7 +122,7 @@ before_install:
     fi
   - if [[ "${TEST_SPHINX}" == "true" ]]; then
       sudo apt-get update;
-      sudo apt-get install --no-install-recommends graphviz inkscape texlive texlive-xetex texlive-fonts-recommended texlive-latex-extra lmodern librsvg2-bin imagemagick;
+      sudo apt-get install --no-install-recommends graphviz inkscape texlive texlive-xetex texlive-fonts-recommended texlive-latex-extra lmodern librsvg2-bin imagemagick docbook2x;
       pip install "sphinx==1.1.3";
     fi
   - if [[ "${TEST_MATPLOTLIB}" == "true" ]]; then

diff --git a/bin/test_travis.sh b/bin/test_travis.sh
@@ -9,6 +9,7 @@ if [[ "${TEST_SPHINX}" == "true" ]]; then
     cd doc
     make html-errors
     make clean
+    make man
     make latex
     cd _build/latex
     export LATEXOPTIONS="-interaction=nonstopmode"

diff --git a/doc/Makefile b/doc/Makefile
@@ -19,7 +19,7 @@ ALLSPHINXOPTSlatex = -d _build/doctrees-latex -D latex_paper_size=$(PAPER) \
 
 .PHONY: changes cheatsheet clean help html html-errors \
         htmlapi htmlhelp info latex linkcheck livehtml \
-        texinfo web logo
+        texinfo web logo man
 
 .SUFFIXES: .pdf .svg
 
@@ -39,6 +39,7 @@ help:
 	@echo "  texinfo     to make Texinfo files"
 	@echo "  web         to make files usable by Sphinx.web"
 	@echo "  logo        generate logos from src/logo/sympy.svg"
+	@echo "  man         build manpage"
 
 clean:
 	-rm -rf _build
@@ -131,6 +132,9 @@ info:
 	make -C _build/texinfo info
 	@echo "makeinfo finished; the Info files are in _build/texinfo."
 
+man: man/isympy.xml
+	docbook2x-man --to-stdout $< > man/isympy.1
+
 _build/logo/sympy-notailtext-favicon.ico: logo
 
 logo: src/logo/sympy.svg

diff --git a/doc/README.rst b/doc/README.rst
@@ -4,7 +4,7 @@ How to Build Documentation
 To make the html documentation, install the prerequisites, e.g. on
 Debian/Ubuntu (similarly for other distributions)::
 
-    apt-get install python-sphinx texlive-latex-recommended dvipng librsvg2-bin imagemagick
+    apt-get install python-sphinx texlive-latex-recommended dvipng librsvg2-bin imagemagick docbook2x
 
 and do::
 

diff --git a/release/fabfile.py b/release/fabfile.py
@@ -138,7 +138,7 @@ def prepare_apt():
     sudo("apt-get -qq update")
     sudo("apt-get -y install git python3 make python-virtualenv zip python-dev")
     # Needed to build the docs
-    sudo("apt-get -y install graphviz inkscape texlive texlive-xetex texlive-fonts-recommended texlive-latex-extra librsvg2-bin")
+    sudo("apt-get -y install graphviz inkscape texlive texlive-xetex texlive-fonts-recommended texlive-latex-extra librsvg2-bin docbook2x")
     # Our Ubuntu is too old to include Python 3.3
     sudo("apt-get -y install python-software-properties")
     sudo("add-apt-repository -y ppa:fkrull/deadsnakes")
@@ -303,6 +303,7 @@ def build_docs():
             with cd("/home/vagrant/repos/sympy/doc"):
                 run("make clean")
                 run("make html-errors")
+                run("make man")
                 with cd("/home/vagrant/repos/sympy/doc/_build"):
                     run("mv html {html-nozip}".format(**tarball_formatter()))
                     run("zip -9lr {html} {html-nozip}".format(**tarball_formatter()))