rtd test storing doxygen in a svn repo

doc/rtd/conf.py

@@ -1,3 +1,5 @@
+import subprocess, os
+
 # Configuration file for the Sphinx documentation builder.
 #
 # This file only contains a selection of the most common options. For a full
@@ -23,17 +25,25 @@
 
 # -- General configuration ---------------------------------------------------
 
-import subprocess, os
 
-doxygen_enabled = True
+if not os.path.exists('_build/html'):
+    os.makedirs('_build/html')
+
+subprocess.call('cat /etc/issue', shell=True)
+subprocess.call('doxygen --version', shell=True)
 
-if doxygen_enabled:
-    if not os.path.exists('_build/html'):
-        os.makedirs('_build/html')
-    subprocess.call('cat /etc/issue', shell=True)
-    subprocess.call('doxygen --version', shell=True)
+# RTD version of Doxygen has a bug that crashes it on our code due to a fixed
+# buffer size. When RTD updates to Ubuntu 20.04 this will be resolved. See
+# issue 613
+resolved_613 = False
+if resolved_613:
     subprocess.call('doxygen', shell=True)
     subprocess.call('./parse_xml.py', shell=True)
+else:
+    #subprocess.call('tar xzfv teca_doxygen.tgz -C _build/html/', shell=True)
+    #subprocess.call('cp -r ./generated_pages _build/rst', shell=True)
+    subprocess.call('svn checkout svn://svn.code.sf.net/p/teca/rtd_extras/doxygen _build/html/doxygen', shell=True)
+    subprocess.call('svn checkout svn://svn.code.sf.net/p/teca/rtd_extras/rst _build/html/rst', shell=True)
 
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom