docbook5 | ../../doc/postgis_comments.sql: No such file or directory

[ImreSamu]

The recent updates to the master version of PostGIS related to 'docbook5' caused a building problem in the Docker PostGIS master images. ( postgis/postgis:15-master ) An error message showed up, saying a certain file couldn't be found.

cat: ../../doc/postgis_comments.sql: No such file or directory

Ideally, there should've been a warning about missing components, or no error at all.

The issue was resolved by including the following building components:

• docbook-xml
• docbook5-xml
• libxml2-utils

patch/workaround: ​https://github.com/postgis/docker-postgis/pull/359/commits/b1591edf1351ea3141934d3996253e84686afcc0

original log:

#17 173.8 	| /usr/bin/perl ../../utils/create_extension_unpackage.pl postgis >> sql/raster_unpackage.sql
#17 173.8 /usr/bin/perl ../../utils/create_upgrade.pl sql/postgis_for_extension.sql > sql/postgis_upgrade_for_extension.sql.in
#17 173.8 sed -ne '/UNPACKAGE_CODE/{s///; :a' -e 'n;p;ba' -e '}' \
#17 173.8 	./unpackage_raster_if_needed.sql  >> sql/raster_unpackage.sql
#17 173.8 printf '\\echo Use "CREATE EXTENSION postgis" to load this file. \\quit\n' > sql/postgis--3.5.0dev.sql
#17 173.8 cat sql/postgis_for_extension.sql ../../doc/postgis_comments.sql sql/spatial_ref_sys_config_dump.sql sql/spatial_ref_sys.sql >> sql/postgis--3.5.0dev.sql
#17 173.8 cat: ../../doc/postgis_comments.sql: No such file or directory
#17 173.8 make[2]: *** [Makefile:95: sql/postgis--3.5.0dev.sql] Error 1
#17 173.8 make[2]: *** Deleting file 'sql/postgis--3.5.0dev.sql'
#17 173.8 make[2]: *** Waiting for unfinished jobs....
#17 173.8 make[2]: Leaving directory '/usr/src/postgis/extensions/postgis'
#17 173.9 make[1]: Leaving directory '/usr/src/postgis/extensions'
#17 173.9 make[1]: *** [Makefile:29: all] Error 1
#17 173.9 make: *** [GNUmakefile:25: all] Error 1