Build system improvements; Documentation WIP.

Author: redcode

documentation/CMakeLists.txt

@@ -62,13 +62,13 @@ if(${PROJECT_NAME}_WITH_HTML_DOCUMENTATION)
 		OUTPUT  "${_html_documentation_output}"
 		COMMAND "${SPHINX_BUILD_EXECUTABLE}"
 			-b html
-			-Dproject="${PROJECT_NAME}"
-			-Dversion="${PROJECT_VERSION}"
-			-Drelease="${PROJECT_VERSION}"
+			"-Dproject=${PROJECT_NAME}"
+			"-Dversion=${PROJECT_VERSION}"
+			"-Drelease=${PROJECT_VERSION}"
 			${_html_theme_option}
-			-Dhtml_title="${PROJECT_NAME}"
-			-Dbreathe_default_project="${PROJECT_NAME}"
-			-Dbreathe_projects.${PROJECT_NAME}="${_api_xml_output}"
+			"-Dhtml_title=${PROJECT_NAME} Documentation"
+			"-Dbreathe_default_project=${PROJECT_NAME}"
+			"-Dbreathe_projects.${PROJECT_NAME}=${_api_xml_output}"
 			"${CMAKE_CURRENT_SOURCE_DIR}"
 			"${_html_documentation_output}"
 		DEPENDS ${PROJECT_NAME}-API-XML
@@ -95,12 +95,11 @@ if(${PROJECT_NAME}_WITH_PDF_DOCUMENTATION)
 		OUTPUT  "${_latex_documentation_output}"
 		COMMAND "${SPHINX_BUILD_EXECUTABLE}"
 			-b latex
-			-Dproject="${PROJECT_NAME}"
-			-Dversion="${PROJECT_VERSION}"
-			-Drelease="${PROJECT_VERSION}"
-			-Dhtml_title="${PROJECT_NAME}"
-			-Dbreathe_default_project="${PROJECT_NAME}"
-			-Dbreathe_projects.${PROJECT_NAME}="${_api_xml_output}"
+			"-Dproject=${PROJECT_NAME}"
+			"-Dversion=${PROJECT_VERSION}"
+			"-Drelease=${PROJECT_VERSION}"
+			"-Dbreathe_default_project=${PROJECT_NAME}"
+			"-Dbreathe_projects.${PROJECT_NAME}=${_api_xml_output}"
 			"${CMAKE_CURRENT_SOURCE_DIR}"
 			"${_latex_documentation_output}"
 		DEPENDS ${PROJECT_NAME}-API-XML

documentation/index.rst

@@ -3,32 +3,21 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-===
-Z80
-===
+========
+Contents
+========
 
 .. toctree::
    :maxdepth: 2
-   :caption: Contents
 
    Introduction
    InstallationFromSources
    Tests
    Integration
    Usage
    APIReference
-
-.. toctree::
-   :maxdepth: 2
-   :caption: Project
-
    Thanks
    VersionHistory
    License
-
-.. toctree::
-   :maxdepth: 2
-   :caption: Indices and tables
-
    genindex
    search