doc: add hypervisor kconfig option reference

Modify the Zephyr project script for creating documentation from Kconfig
files to generate the hypervisor option configuration docs. While Zephyr
uses a modified version of kconfiglib, we can use the standard
kconfiglib from Pypi (added to the requirements.txt file).

Signed-off-by: David B. Kinder <david.b.kinder@intel.com>

Author: dbkinder

.gitignore

@@ -6,8 +6,10 @@ devicemodel/include/version.h
 doc/doxygen
 doc/_build
 doc/tools
+doc/reference/kconfig/*.rst
 build
 *.bak
 *.sav
 *.log
 *.warnings
+*.pyc

doc/Makefile

@@ -14,9 +14,15 @@ SPHINXPROJ    = "Project ACRN"
 SOURCEDIR     = .
 BUILDDIR      ?= _build
 
+# document publication assumes the folder structure is setup
+# with the acrn-hypervisor and projectacrn.github.io repos as
+# sibling folders and make is run inside the acrn-hypervisor/docs
+# folder.
+
+ACRN_BASE     = "$(CURDIR)/../.."
 DOC_TAG      ?= development
 RELEASE      ?= latest
-PUBLISHDIR    = ../../projectacrn.github.io/$(RELEASE)
+PUBLISHDIR    = $(ACRN_BASE)/projectacrn.github.io/$(RELEASE)
 
 # Put it first so that "make" without argument is like "make help".
 help:
@@ -38,7 +44,11 @@ doxy:
 content:
 	$(Q)scripts/extract_content.py
 
-html: doxy content
+kconfig:
+	$(Q)srctree=../hypervisor \
+	    python3 scripts/genrest.py ../hypervisor/Kconfig reference/kconfig/
+
+html: doxy content kconfig
 	-$(Q)$(SPHINXBUILD) -t $(DOC_TAG) -b html -d $(BUILDDIR)/doctrees $(SOURCEDIR) $(BUILDDIR)/html $(SPHINXOPTS) $(OPTS) >> doc.log 2>&1
 	$(Q)./scripts/filter-doc-log.sh doc.log
 
@@ -48,6 +58,7 @@ html: doxy content
 clean:
 	rm -fr $(BUILDDIR) doxygen
 	rm -fr tools
+	rm -fr reference/kconfig/*.rst
 
 # Copy material over to the GitHub pages staging repo
 # along with a README

doc/index.rst

@@ -32,6 +32,7 @@ Sections
    howtos/index.rst
    release_notes.rst
    contribute/index.rst
+   reference/kconfig/index.rst
    api/index.rst
    tools.rst
 

doc/reference/kconfig/readme.txt

@@ -0,0 +1 @@
+This directory has auto-generated files, do not edit any of the files here.