From patchwork Fri Feb 21 03:26:36 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Heinrich Schuchardt X-Patchwork-Id: 236666 List-Id: U-Boot discussion From: xypron.glpk at gmx.de (Heinrich Schuchardt) Date: Fri, 21 Feb 2020 04:26:36 +0100 Subject: [PATCH 1/2] doc/Makefile: turn warnings into errors In-Reply-To: <20200221032637.142330-1-xypron.glpk@gmx.de> References: <20200221032637.142330-1-xypron.glpk@gmx.de> Message-ID: <20200221032637.142330-2-xypron.glpk@gmx.de> Several patches delivered incorrect restructured text as documentation. We should be able to discover this in Travis CI or Gitlab CI. So let us turn all build warnings into errors. We cannot add --keep-going as Gitlab does not use sphinx-build version 1.8 or later yet. Signed-off-by: Heinrich Schuchardt --- doc/Makefile | 1 + 1 file changed, 1 insertion(+) -- 2.25.0 diff --git a/doc/Makefile b/doc/Makefile index 5135a96e88..0e0da5666f 100644 --- a/doc/Makefile +++ b/doc/Makefile @@ -56,6 +56,7 @@ quiet_cmd_sphinx = SPHINX $@ --> file://$(abspath $(BUILDDIR)/$3/$4) PYTHONDONTWRITEBYTECODE=1 \ BUILDDIR=$(abspath $(BUILDDIR)) SPHINX_CONF=$(abspath $(srctree)/$(src)/$5/$(SPHINX_CONF)) \ $(SPHINXBUILD) \ + -W \ -b $2 \ -c $(abspath $(srctree)/$(src)) \ -d $(abspath $(BUILDDIR)/.doctrees/$3) \ From patchwork Fri Feb 21 03:26:37 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Heinrich Schuchardt X-Patchwork-Id: 236667 List-Id: U-Boot discussion From: xypron.glpk at gmx.de (Heinrich Schuchardt) Date: Fri, 21 Feb 2020 04:26:37 +0100 Subject: [PATCH 2/2] travis: build HTML docs In-Reply-To: <20200221032637.142330-1-xypron.glpk@gmx.de> References: <20200221032637.142330-1-xypron.glpk@gmx.de> Message-ID: <20200221032637.142330-3-xypron.glpk@gmx.de> Several patches delivered incorrect restructured text as documentation. We should be able to discover this in Travis CI. Provide a build step for 'make htmldocs'. Add required package graphviz. Signed-off-by: Heinrich Schuchardt Reviewed-by: Bin Meng --- .travis.yml | 5 +++++ 1 file changed, 5 insertions(+) -- 2.25.0 diff --git a/.travis.yml b/.travis.yml index e6db9d6a72..a5918dd5d9 100644 --- a/.travis.yml +++ b/.travis.yml @@ -38,6 +38,7 @@ addons: - libisl15 - clang-7 - srecord + - graphviz install: # Clone uboot-test-hooks @@ -360,6 +361,10 @@ matrix: - name: "grep FIXME HACK" script: - grep -r FIXME . + # build HTML documentation + - name: "htmldocs" + script: + - make htmldocs # search for HACK within source tree and ignore HACKKIT board script: - grep -r HACK . | grep -v HACKKIT