X-Git-Url: https://gerrit.fd.io/r/gitweb?a=blobdiff_plain;f=docs%2FMakefile;h=71ee034b331d49de3a141fccad814f83f041876d;hb=5297447bd64ab253ab3ab3e144605dd39f995f12;hp=ca4a3acdb9c27d1bd167f0d767f92ddaa22a3cdc;hpb=9ad39c026c8a3c945a7003c4aa4f5cb1d4c80160;p=vpp.git diff --git a/docs/Makefile b/docs/Makefile index ca4a3acdb9c..71ee034b331 100644 --- a/docs/Makefile +++ b/docs/Makefile @@ -1,4 +1,15 @@ -# Minimal makefile for Sphinx documentation +# Copyright (c) 2021 Cisco and/or its affiliates. +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at: +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. # # We support MacOS for docs generation ifeq ($(shell uname),Darwin) @@ -20,9 +31,10 @@ PIP_VERSION ?= $(shell grep 'PIP_VERSION=' ${WS_ROOT}/test/Makefile | cut -d'=' PIP_TOOLS_VERSION ?= $(shell grep 'PIP_TOOLS_VERSION=' ${WS_ROOT}/test/Makefile | cut -d'=' -f2) PYTHON ?= "python3" - -DOC_DEB_DEPENDS = enchant -DOC_RPM_DEPENDS = enchant +PYTHON_VERSION_OK := $(shell $(PYTHON) -c "exec('import sys\nif sys.hexversion >= 0x03070000: print(\"true\")\nelse: print(\"false\")')") +ifneq ($(PYTHON_VERSION_OK),true) +$(error "ERROR: docs build requires python version >= to 3.7") +endif # You can set these variables from the command line. SPHINXOPTS = --keep-going -n -W @@ -55,8 +67,6 @@ ifeq ($(OS_ID),ubuntu) sudo apt-get update; \ sudo apt-get $(CONFIRM) $(FORCE) install $$inst; \ fi -else ifneq ("$(wildcard /etc/redhat-release)","") - @sudo yum install $(CONFIRM) $(DOC_RPM_DEPENDS) endif .PHONY: spell @@ -94,9 +104,8 @@ docs: clean venv ${BUILDDIR_SRC} .PHONY: clean clean: - @rm -rf $(BUILDDIR) + @rm -rf $(BUILDDIR) ${VENV_DIR} @make -C ${SCRIPTS_DIR} clean .PHONY: build build: docs -