doc: update doc generation tooling to only work within the $BUILDDIR

Modify the documentation Makefile (doc/Makefile) and scripts to only modify and
create content inside the $BUILDDIR folder.

The folders that were created inside 'doc/' previously are now all created
inside '$BUILDDIR/rst'. The '.gitignore' file has also been updated accordingly.

Tracked-On: #3686
Signed-off-by: Geoffroy Van Cutsem <geoffroy.vancutsem@intel.com>
This commit is contained in:
Geoffroy Van Cutsem
2019-09-10 12:18:44 +02:00
committed by deb-intel
parent 0dac373d93
commit 1794d994b6
3 changed files with 24 additions and 19 deletions

View File

@@ -10,6 +10,7 @@ KI_SCRIPT=scripts/filter-known-issues.py
CONFIG_DIR=.known-issues/doc
LOG_FILE=$1
BUILDDIR=$(dirname $LOG_FILE)
if [ -z "${LOG_FILE}" ]; then
echo "Error in $0: missing input parameter <logfile>"
@@ -29,7 +30,7 @@ else
fi
if [ -s "${LOG_FILE}" ]; then
$KI_SCRIPT --config-dir ${CONFIG_DIR} ${LOG_FILE} > doc.warnings 2>&1
$KI_SCRIPT --config-dir ${CONFIG_DIR} ${LOG_FILE} > ${BUILDDIR}/doc.warnings 2>&1
if [ -s doc.warnings ]; then
echo
echo -e "${red}New errors/warnings found, please fix them:"