VOL-4840 - gendocs edits
Makefile
--------
o Display an ENTER/LEAVE banner & whitespace for readability.
o Changed ${} to $() to make it clear these are make vars not env vars.
o mkdir one-liner: use make builtin $(addprefix) to construct paths,
spawn one shell -vs- shell mkdir x dirs.
o Join shell commands using '&&' -vs- ';'. Ssemicolon use with
line continuation can mask failures.
Change-Id: Ia2393056350b247b37dd13bcb2d12548e5b66710
diff --git a/Makefile b/Makefile
index 8fd95b1..88291c3 100644
--- a/Makefile
+++ b/Makefile
@@ -729,6 +729,7 @@
@echo "Applying python 3.10.x migration patches"
@echo "========================================"
./patches/python_310_migration.sh 'apply'
+ @echo
##----------------##
##---] LINT [---##
@@ -761,16 +762,22 @@
.PHONY: gendocs lint test
# In future explore use of --docformat REST - integration w/Sphinx?
gendocs: vst_venv
- source ./$</bin/activate ; set -u ;\
- mkdir -p $@ ;\
- mkdir -pv $(LIB_DIRS); \
- for dir in ${LIB_BASENAME}; do\
+ $(HIDE)echo " ** $(make) $@: ENTER"
+ source ./$</bin/activate \
+ && set -u \
+ && echo \
+ && echo " ** $(make) $@: robot.libdoc" \
+ && mkdir -pv $(addprefix $@/,$(LIB_DIRS)) \
+ && for dir in $(LIB_BASENAME); do\
python -m robot.libdoc --format HTML $$dir.robot $@/$$dir.html ;\
- done ;\
- for dir in ${TEST_DIRS}; do mkdir -p $@/$$dir; done;\
- for dir in ${TEST_BASENAME}; do\
+ done \
+ && echo \
+ && echo " ** $(make) $@: robot.testdoc" \
+ && mkdir -vp $(addprefix $@/,$(TEST_DIRS)) \
+ && for dir in $(TEST_BASENAME); do\
python -m robot.testdoc $$dir.robot $@/$$dir.html ;\
done
+ $(HIDE)echo " ** $(make) $@: LEAVE"
## -----------------------------------------------------------------------
## -----------------------------------------------------------------------
diff --git a/VERSION b/VERSION
index 7cd5929..497a78c 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-2.11.4
+2.11.5