update doc generation

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       = build
+OUTPUT_DIRECTORY       = doxyoutput
 
 # 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
@@ -1985,7 +1985,7 @@ XML_OUTPUT             = xml
 # The default value is: YES.
 # This tag requires that the tag GENERATE_XML is set to YES.
 
-XML_PROGRAMLISTING     = NO
+XML_PROGRAMLISTING     = YES
 
 #---------------------------------------------------------------------------
 # Configuration options related to the DOCBOOK output

doc/conf.py

@@ -21,6 +21,17 @@
 # import sys
 # sys.path.insert(0, os.path.abspath('.'))
 
+import subprocess, os
+
+read_the_docs_build = os.environ.get('READTHEDOCS', None) == 'True'
+
+if read_the_docs_build:
+	subprocess.call('cd ..; wget https://sourceforge.net/projects/plantuml/files/plantuml.jar', shell=True)
+
+subprocess.call('doxygen', shell=True)
+subprocess.call('mv ./doxyoutput/html/index.html ./doxyoutput/html/index_doxygen.html', shell=True)
+html_extra_path = ['./doxyoutput/html']
+
 # -- General configuration ------------------------------------------------
 
 # If your documentation needs a minimal Sphinx version, state it here.
@@ -31,13 +42,13 @@
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
-    'sphinx.ext.autodoc',
+#    'sphinx.ext.autodoc',
-    'sphinx.ext.doctest',
+#    'sphinx.ext.doctest',
     'sphinx.ext.intersphinx',
-    'sphinx.ext.todo',
+#    'sphinx.ext.todo',
-    'sphinx.ext.coverage',
+#    'sphinx.ext.coverage',
-    'sphinx.ext.mathjax',
+#    'sphinx.ext.mathjax',
-    'sphinx.ext.ifconfig',
+#    'sphinx.ext.ifconfig',
 	'breathe',
     'exhale'
 ]
@@ -59,8 +70,9 @@ exhale_args = {
     "createTreeView":        True,
     # TIP: if using the sphinx-bootstrap-theme, you need
     # "treeViewIsBootstrap": True,
-    "exhaleExecutesDoxygen": True,
+    "exhaleExecutesDoxygen": False,
-    "exhaleDoxygenStdin":    "INPUT = ../src ../knx-linux ../examples"
+    #"exhaleDoxygenStdin":    "INPUT = ../src ../knx-linux ../examples"
+	#"exhaleUseDoxyfile": True
 }
 
 # Tell sphinx what the primary language being documented is.

doc/index.rst

@@ -14,6 +14,9 @@ Contents:
    api/library_root
 
 
+`Doxgen documentation <index_doxygen.html>`_ is also available.
+
+
 Indices and tables
 ==================
 

doc_old/example_list.h

@@ -0,0 +1,7 @@
+/**
+ * @example main.cpp
+ * @example knx-demo.ino
+ * @example knx-hdc1008.ino
+ * @example knx-bme680.ino
+ * 
+**/

doc_old/references.bib

@@ -0,0 +1,23 @@
+@manual{knx:3/4/1,
+    organization  = "KNX Association",
+    title         = "KNX System Specifications Chapter 3/4/1 Application Interface Layer",
+    year          =  2013,
+    month         =  12,    
+    note          = "v01.01.02"
+}
+
+@manual{knx:3/5/1,
+    organization  = "KNX Association",
+    title         = "KNX System Specifications Chapter 3/5/1 Resources",
+    year          =  2013,
+    month         =  12,    
+    note          = "v01.09.03"
+}
+
+@manual{knx:3/7/3,
+    organization  = "KNX Association",
+    title         = "KNX System Specifications Chapter 3/7/3 Standardized Identifier Tables",
+    year          =  2013,
+    month         =  12,    
+    note          = "v01.03.01"
+}