X-Git-Url: https://gerrit.opnfv.org/gerrit/gitweb?a=blobdiff_plain;f=utils%2Fdocs-build.sh;h=4d95836d51df3ec7a52185ecbfc3574494c9b447;hb=b2feb8edf2b28a0c174d022e69e825e00f66e701;hp=b397094c60231c4644465137f243ced33c23a0a1;hpb=b4799364f18f0fe4413a7c494b9211a036b5864c;p=releng.git diff --git a/utils/docs-build.sh b/utils/docs-build.sh index b397094c6..4d95836d5 100755 --- a/utils/docs-build.sh +++ b/utils/docs-build.sh @@ -1,8 +1,14 @@ #!/bin/bash -e - +# SPDX-license-identifier: Apache-2.0 +############################################################################## +# Copyright (c) 2016 NEC and others. +# All rights reserved. This program and the accompanying materials +# are made available under the terms of the Apache License, Version 2.0 +# which accompanies this distribution, and is available at +# http://www.apache.org/licenses/LICENSE-2.0 +############################################################################## export PATH=$PATH:/usr/local/bin/ - DOCS_DIR=${DOCS_DIR:-docs} INDEX_RST=${INDEX_RST:-index.rst} BUILD_DIR=${BUILD_DIR:-docs_build} @@ -35,7 +41,7 @@ revision="$(git rev-parse --short HEAD)" rev_full="$(git rev-parse HEAD)" version="$(git describe --abbrev=0 2> /dev/null || echo draft) ($revision)" project="$(basename $(git rev-parse --show-toplevel))" -html_notes="\n Revision: $rev_full\n\n Build date: |today|" +html_notes=" Revision: $rev_full\n Build date: $(date -u +'%Y-%m-%d')" default_conf='releng/docs/etc/conf.py' opnfv_logo='releng/docs/etc/opnfv-logo.png' @@ -49,8 +55,8 @@ function check_rst_doc() { # Note: This check may fail in many jobs for building project docs, since # the old sample has lines more than 120. We ignore failures on this # check right now, but these have to be fixed before OPNFV B release. - _out=$(doc8 --max-line-length 120 --ignore D000 "$_src") || { - _msg='Error: rst validatino (doc8) has failed, please fix the following error(s).' + _out=$(doc8 --max-line-length 240 --ignore D000 "$_src") || { + _msg='Warning: rst validation (doc8) has failed, please fix the following error(s).' _errs=$(echo "$_out" | sed -n -e "/^$_src/s/^/ /p") echo echo -e "$_msg\n$_errs" @@ -72,7 +78,7 @@ function add_html_notes() { echo sed -i "s/ _sha1_/ $git_sha1/g" "$file" fi - sed -i -e "\$a\\\n.. only:: html\n$html_notes" "$file" + sed -i -e "\$a\\\n..\n$html_notes" "$file" done }