Build in _build dir

doc/Doxyfile

@@ -58,7 +58,7 @@ PROJECT_LOGO           =
 # entered, it will be relative to the location where doxygen was started. If
 # left blank the current directory will be used.
 
-OUTPUT_DIRECTORY       = .
+OUTPUT_DIRECTORY       = _build
 
 # If the CREATE_SUBDIRS tag is set to YES then doxygen will create 4096 sub-
 # directories (in 2 levels) under the output directory of each output format and
@@ -1624,7 +1624,7 @@ FORMULA_MACROFILE      =
 # The default value is: NO.
 # This tag requires that the tag GENERATE_HTML is set to YES.
 
-USE_MATHJAX            = NO
+USE_MATHJAX            = YES
 
 # When MathJax is enabled you can set the default output format to be used for
 # the MathJax output. See the MathJax site (see:
@@ -2064,7 +2064,7 @@ MAN_LINKS              = NO
 # captures the structure of the code including all documentation.
 # The default value is: NO.
 
-GENERATE_XML           = YES
+GENERATE_XML           = NO
 
 # The XML_OUTPUT tag is used to specify where the XML pages will be put. If a
 # relative path is entered the value of OUTPUT_DIRECTORY will be put in front of

doc/Makefile

@@ -1,19 +1,19 @@
 # Makefile for HiPerC documentation
 
-all: html/index.html
+all: _build/html/index.html
 .PHONY: all
 
-latex/hiperc.tex:
-	doxygen && mv latex/refman.tex $@
+_build/latex/hiperc.tex:
+	doxygen && mv _build/latex/refman.tex $@
 
-latex/hiperc.pdf: latex/hiperc.tex
+_build/latex/hiperc.pdf: _build/latex/hiperc.tex
 	latexmk -cd $<
 
-html/index.html: latex/hiperc.tex
+_build/html/index.html: _build/latex/hiperc.tex
 	sphinx-build -b html . _build
 
 .PHONY: clean html pdf
 clean:
 	rm -rf _build _static html latex rst
-html: html/index.html
-pdf:  latex/hiperc.pdf
+html: _build/html/index.html
+pdf:  _build/latex/hiperc.pdf