Test and Documentation changes: dockerfiles and readme

README changes:
- Add documentation on how to test / add support for your favorite
operating system.

Dockerfile changes:
- Rename Dockerfile.in to Dockerfile.common.in, to make the name
clearer.
- Add make as a prerequisite in the Dockerfile.
  + It is needed to run make commands and is not available in some of
  these images.
- Add make targets for printing operating systems that are not yet
supported in Docker testing.
  + This should help contributors with adding support for testing on
  these systems.
  + New targets are `server-test-supported` and
  `server-test-unsupported` at the top level.

Related to: #130

18 files changed, 32 insertions, 14 deletions

diff --git a/server/test/Makefile b/server/test/Makefile
index 5aafa40..1520786 100644
--- a/server/test/Makefile
+++ b/server/test/Makefile
@@ -20,7 +20,7 @@ check: docker/test
 
 # Create the Dockerfile
 docker/%.Dockerfile: docker/templates/%.Dockerfile.in \
-		     docker/templates/Dockerfile.in
+	docker/templates/Dockerfile.common.in
 	@echo Creating Dockerfile for target $*
 	cat $^ > $@
 
@@ -52,4 +52,13 @@ clean: docker/clean
 	rm -f -- docker/*.Dockerfile
 
 print:
-	@for os in $(DOCKER_OS); do echo $$os; done | sort
+	@echo List of Operating systems where server compilation is tested [via Docker]:
+	@for os in $(DOCKER_OS); do echo - $$os; done | sort
+
+print-failing: FAILING_OS := $(patsubst %.Dockerfile.in.FAILING, %, \
+	$(notdir $(wildcard docker/templates/*.Dockerfile.in.FAILING)))
+
+print-failing:
+	@echo List of Operating systems where server compilation is not tested:
+	@for os in $(FAILING_OS); do echo - $$os; done | sort
+	@echo PLEASE help support your favorite OS! More details at: https://pdftools.wiki/A401543C
diff --git a/server/test/docker/templates/Dockerfile.in b/server/test/docker/templates/Dockerfile.common.in
index 083b19a..083b19a 100644
--- a/server/test/docker/templates/Dockerfile.in
+++ b/server/test/docker/templates/Dockerfile.common.in
diff --git a/server/test/docker/templates/debian-10.Dockerfile.in b/server/test/docker/templates/debian-10.Dockerfile.in
index 2f01de7..a2ad6bb 100644
--- a/server/test/docker/templates/debian-10.Dockerfile.in
+++ b/server/test/docker/templates/debian-10.Dockerfile.in
@@ -1,4 +1,6 @@
 # -*- dockerfile -*-
 # Debian 10 is known as buster
 FROM debian:10
-RUN apt-get update -y
+ARG DEBIAN_FRONTEND=noninteractive
+# Need to install make, tzdata here to avoid stupid prompts when running package install via autobuild
+RUN apt-get update -y && apt-get install -y make tzdata
diff --git a/server/test/docker/templates/debian-11.Dockerfile.in b/server/test/docker/templates/debian-11.Dockerfile.in
index cabb29d..dae6b6c 100644
--- a/server/test/docker/templates/debian-11.Dockerfile.in
+++ b/server/test/docker/templates/debian-11.Dockerfile.in
@@ -1,4 +1,6 @@
 # -*- dockerfile -*-
 # Debian 11 is known as bullseye
 FROM debian:11
-RUN apt-get update -y
+ARG DEBIAN_FRONTEND=noninteractive
+# Need to install make, tzdata here to avoid stupid prompts when running package install via autobuild
+RUN apt-get update -y && apt-get install -y make tzdata
diff --git a/server/test/docker/templates/debian-9.Dockerfile.in b/server/test/docker/templates/debian-9.Dockerfile.in
index 8f6e341..b558ade 100644
--- a/server/test/docker/templates/debian-9.Dockerfile.in
+++ b/server/test/docker/templates/debian-9.Dockerfile.in
@@ -1,4 +1,6 @@
 # -*- dockerfile -*-
 # Debian 9 is known as stretch
 FROM debian:9
-RUN apt-get update -y
+ARG DEBIAN_FRONTEND=noninteractive
+# Need to install make, tzdata here to avoid stupid prompts when running package install via autobuild
+RUN apt-get update -y && apt-get install -y make tzdata
diff --git a/server/test/docker/templates/fedora-34.Dockerfile.in b/server/test/docker/templates/fedora-34.Dockerfile.in
index 42dc26d..dbb736e 100644
--- a/server/test/docker/templates/fedora-34.Dockerfile.in
+++ b/server/test/docker/templates/fedora-34.Dockerfile.in
@@ -1,3 +1,4 @@
 # -*- dockerfile -*-
 FROM fedora:34
-RUN dnf update -y
+# Need to install make, tzdata here to avoid stupid prompts when running package install via autobuild
+RUN dnf update -y && dnf install -y make tzdata
diff --git a/server/test/docker/templates/fedora-35.Dockerfile.in b/server/test/docker/templates/fedora-35.Dockerfile.in
index 16a0eb3..915cac4 100644
--- a/server/test/docker/templates/fedora-35.Dockerfile.in
+++ b/server/test/docker/templates/fedora-35.Dockerfile.in
@@ -1,3 +1,4 @@
 # -*- dockerfile -*-
 FROM fedora:35
-RUN dnf update -y
+# Need to install make, tzdata here to avoid stupid prompts when running package install via autobuild
+RUN dnf update -y && dnf install -y make tzdata
diff --git a/server/test/docker/templates/fedora-36.Dockerfile.in b/server/test/docker/templates/fedora-36.Dockerfile.in
index e795d68..c36a716 100644
--- a/server/test/docker/templates/fedora-36.Dockerfile.in
+++ b/server/test/docker/templates/fedora-36.Dockerfile.in
@@ -1,3 +1,4 @@
 # -*- dockerfile -*-
 FROM fedora:36
-RUN dnf update -y
+# Need to install make, tzdata here to avoid stupid prompts when running package install via autobuild
+RUN dnf update -y && dnf install -y make tzdata
diff --git a/server/test/docker/templates/freebsd.Dockerfile.in.FAILING b/server/test/docker/templates/freebsd.Dockerfile.in.FAILING
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/server/test/docker/templates/freebsd.Dockerfile.in.FAILING
diff --git a/server/test/docker/templates/macos.Dockerfile.in.FAILING b/server/test/docker/templates/macos.Dockerfile.in.FAILING
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/server/test/docker/templates/macos.Dockerfile.in.FAILING
diff --git a/server/test/docker/templates/msys2.Dockerfile.in.FAILING b/server/test/docker/templates/msys2.Dockerfile.in.FAILING
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/server/test/docker/templates/msys2.Dockerfile.in.FAILING
diff --git a/server/test/docker/templates/nixos.Dockerfile.in.FAILING b/server/test/docker/templates/nixos.Dockerfile.in.FAILING
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/server/test/docker/templates/nixos.Dockerfile.in.FAILING
diff --git a/server/test/docker/templates/openbsd.Dockerfile.in.FAILING b/server/test/docker/templates/openbsd.Dockerfile.in.FAILING
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/server/test/docker/templates/openbsd.Dockerfile.in.FAILING
diff --git a/server/test/docker/templates/opensuse.Dockerfile.in.FAILING b/server/test/docker/templates/opensuse.Dockerfile.in.FAILING
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/server/test/docker/templates/opensuse.Dockerfile.in.FAILING
diff --git a/server/test/docker/templates/ubuntu-18.Dockerfile.in b/server/test/docker/templates/ubuntu-18.Dockerfile.in
index 8f4cc6b..f49284d 100644
--- a/server/test/docker/templates/ubuntu-18.Dockerfile.in
+++ b/server/test/docker/templates/ubuntu-18.Dockerfile.in
@@ -1,5 +1,5 @@
 # -*- dockerfile -*-
 FROM ubuntu:bionic
 ARG DEBIAN_FRONTEND=noninteractive
-# Need to install tzdata here to avoid stupid prompts when running package install via autobuild
-RUN apt-get update -y && apt-get install -y tzdata
+# Need to install make, tzdata here to avoid stupid prompts when running package install via autobuild
+RUN apt-get update -y && apt-get install -y make tzdata
diff --git a/server/test/docker/templates/ubuntu-20.Dockerfile.in b/server/test/docker/templates/ubuntu-20.Dockerfile.in
index 515e5f5..4b0d3a4 100644
--- a/server/test/docker/templates/ubuntu-20.Dockerfile.in
+++ b/server/test/docker/templates/ubuntu-20.Dockerfile.in
@@ -1,5 +1,5 @@
 # -*- dockerfile -*-
 FROM ubuntu:focal
 ARG DEBIAN_FRONTEND=noninteractive
-# Need to install tzdata here to avoid stupid prompts when running package install via autobuild
-RUN apt-get update -y && apt-get install -y tzdata
+# Need to install make, tzdata here to avoid stupid prompts when running package install via autobuild
+RUN apt-get update -y && apt-get install -y make tzdata
diff --git a/server/test/docker/templates/ubuntu-22.Dockerfile.in b/server/test/docker/templates/ubuntu-22.Dockerfile.in
index 649752d..217daed 100644
--- a/server/test/docker/templates/ubuntu-22.Dockerfile.in
+++ b/server/test/docker/templates/ubuntu-22.Dockerfile.in
@@ -1,5 +1,5 @@
 # -*- dockerfile -*-
 FROM ubuntu:jammy
 ARG DEBIAN_FRONTEND=noninteractive
-# Need to install tzdata here to avoid stupid prompts when running package install via autobuild
-RUN apt-get update -y && apt-get install -y tzdata
+# Need to install make, tzdata here to avoid stupid prompts when running package install via autobuild
+RUN apt-get update -y && apt-get install -y make tzdata
diff --git a/server/test/docker/templates/void.Dockerfile.in.FAILING b/server/test/docker/templates/void.Dockerfile.in.FAILING
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/server/test/docker/templates/void.Dockerfile.in.FAILING