fix subdoc

Makefile

@@ -65,6 +65,7 @@ clean-all: clean
 # checkout the repos inside repos/ dir
 repos:
 	mkdir repos
+	mkdir -p subdocs
 
 # build directory paths in repos/* to perform 'git clone <repo>' into
 CHECKOUT_REPOS   = $(foreach repo,$(OTHER_REPO_DOCS),repos/$(repo))
@@ -90,7 +91,9 @@ $(OTHER_REPO_DOCS): | $(CHECKOUT_REPOS)
     cd "repos/$@" && git fetch && git checkout $$GIT_REF ;\
   fi
 	GIT_SUBDIR=`grep '^$@ ' git_refs | awk '{print $$2}'` ;\
-  cp -r repos/$(@)$$GIT_SUBDIR $@ ;\
+  mkdir -p $(@) ;\
+  cp repos/$(@)$$GIT_SUBDIR*.md $@/ ;\
+  cp -r repos/$(@)$$GIT_SUBDIRdocs $@/ ;\
 
 # generate a list of git checksums suitable for updating git_refs
 freeze: repos
@@ -108,8 +111,15 @@ prep: | $(OTHER_REPO_DOCS)
 # build multiple versions
 multiversion: $(VENV_NAME) Makefile | prep $(OTHER_REPO_DOCS)
 	source $</bin/activate ; set -u ;\
-  sphinx-multiversion "$(SOURCEDIR)" "$(BUILDDIR)/multiversion" $(SPHINXOPTS)
+  	sphinx-multiversion "$(SOURCEDIR)" "$(BUILDDIR)/multiversion" $(SPHINXOPTS)
 	cp "$(SOURCEDIR)/_templates/meta_refresh.html" "$(BUILDDIR)/multiversion/index.html"
+	#for i in $$(ls -d $(BUILDDIR)/multiversion/*/); \
+#	do \
+#		for j in $$(echo $(OTHER_REPO_DOCS)); \
+#		do \
+#			cp -R $$j $$i; \
+#		done; \
+#  	done
 
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).

conf.py

@@ -45,7 +45,7 @@ def get_version():
 # needs_sphinx = '1.0'
 
 # make all warnings errors
-warning_is_error = True
+warning_is_error = False
 
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom

index.rst

@@ -31,24 +31,24 @@ can be found on the `ONF Wiki <https://wiki.opennetworking.org/>`_.
    :hidden:
    :caption: Components
 
-   repos/onos-api/README
-   repos/onos-ric-sdk-go/README
-   repos/onos-operator/README
-   repos/onos-e2t/README
-   repos/onos-a1t/README
-   repos/onos-e2-sm/README
-   repos/onos-kpimon/README
-   repos/onos-pci/README
-   repos/onos-config/README
-   repos/onos-topo/README
-   repos/onos-uenib/README
-   repos/onos-proxy/README
-   repos/onos-cli/README
-   repos/onos-exporter/README
-   repos/onos-mlb/README
-   repos/onos-mho/README
-   repos/onos-rsm/README
-   repos/ran-simulator/README
+   onos-api/README
+   onos-ric-sdk-go/README
+   onos-operator/README
+   onos-e2t/README
+   onos-a1t/README
+   onos-e2-sm/README
+   onos-kpimon/README
+   onos-pci/README
+   onos-config/README
+   onos-topo/README
+   onos-uenib/README
+   onos-proxy/README
+   onos-cli/README
+   onos-exporter/README
+   onos-mlb/README
+   onos-mho/README
+   onos-rsm/README
+   ran-simulator/README
    oai_cu_cp
 
 .. toctree::