Good news: I managed to reproduce the problem locally, and it seems to be related to this part:
osmo-gsm-manuals$ cat tests/Makefile.am
...
# Generate adoc file that includes all chapters (OS#4183: glossary.adoc must be the last file)
ASCIIDOC = test-usermanual.adoc
ASCIIDOC_DEPS =
COMMON_CHAPTERS = $(shell find $(OSMO_GSM_MANUALS_DIR)/common/chapters -name '*.adoc' | grep -v glossary\.adoc) \
$(OSMO_GSM_MANUALS_DIR)/common/chapters/glossary.adoc
$(ASCIIDOC): $(COMMON_CHAPTERS)
echo ":gfdl-enabled:" > $@
echo ":program-name: Test" >> $@
echo "" >> $@
echo "Osmo GSM Manuals Shared Content Test" >> $@
echo "====================================" >> $@
echo "Oliver Smith <osmith@sysmocom.de>" >> $@
echo "" >> $@
for chapter in $(COMMON_CHAPTERS); do \
echo "include::$${chapter}[]" >> $@; \
done;
CLEAN_FILES = $(ASCIIDOC)
...
Here file 'test-usermanual.adoc' is generated dynamically, basically by including all \*.asciidoc files. Note that the list of includes is generated using 'find' command, which sometimes may by in different order. This can be seen in the logs:
Successful build¶
for chapter in ../common/chapters/preface.adoc ../common/chapters/osmux/osmux.adoc ../common/chapters/osmux/mgcp_extension_osmux.adoc ../common/chapters/bibliography.adoc ../common/chapters/cs7-config.adoc ../common/chapters/gfdl.adoc ../common/chapters/control_if.adoc ../common/chapters/sigtran-osmocom.adoc ../common/chapters/abis.adoc ../common/chapters/counters-overview.adoc ../common/chapters/trx_if.adoc ../common/chapters/mncc.adoc ../common/chapters/gb-pool.adoc ../common/chapters/gb.adoc ../common/chapters/oap.adoc ../common/chapters/cell-broadcast.adoc ../common/chapters/spectrum.adoc ../common/chapters/sigtran.adoc ../common/chapters/logging.adoc ../common/chapters/vty_cpu_sched.adoc ../common/chapters/port_numbers.adoc ../common/chapters/smpp.adoc ../common/chapters/gsup.adoc ../common/chapters/vty.adoc ../common/chapters/rf.adoc ../common/chapters/gb-variants.adoc ../common/chapters/glossary.adoc; do \
Failed build¶
for chapter in ../common/chapters/osmux/mgcp_extension_osmux.adoc ../common/chapters/osmux/osmux.adoc ../common/chapters/abis.adoc ../common/chapters/bibliography.adoc ../common/chapters/cell-broadcast.adoc ../common/chapters/control_if.adoc ../common/chapters/counters-overview.adoc ../common/chapters/cs7-config.adoc ../common/chapters/gb-pool.adoc ../common/chapters/gb-variants.adoc ../common/chapters/gb.adoc ../common/chapters/gfdl.adoc ../common/chapters/gsup.adoc ../common/chapters/logging.adoc ../common/chapters/mncc.adoc ../common/chapters/oap.adoc ../common/chapters/port_numbers.adoc ../common/chapters/preface.adoc ../common/chapters/rf.adoc ../common/chapters/sigtran-osmocom.adoc ../common/chapters/sigtran.adoc ../common/chapters/smpp.adoc ../common/chapters/spectrum.adoc ../common/chapters/trx_if.adoc ../common/chapters/vty.adoc ../common/chapters/vty_cpu_sched.adoc ../common/chapters/glossary.adoc; do \
I tried to re-create the same order of includes (see attached patch), and gave it a run in my setup. Now it fails.