--- a/Makefile.freebsd	Tue Sep 16 12:37:32 2025 +0200
+++ b/Makefile.freebsd	Wed Sep 17 05:39:30 2025 +0200
@@ -1,6 +1,27 @@
 # -*- mode: makefile; coding: utf-8 -*-
 #
-# GNU make and binutils/ar
+# Needs GNU make (aka gmake) and binutils/ar (instead of FreeBSD /usr/bin/ar).
+#
+# Building against an installed mupdf package fails because the libmupdfcpp.so
+# is missing.
+#
+# Prepare:
+#
+# - Create a Python  venv and activate it
+#
+# - In the "bin"-directory of the venv symlink "make" to /usr/local/bin/ggmake
+#   and "ar" to /usr/local/bin/ar
+#
+#   * Makefiles have GNU syntax
+#   * ar is called with @-response-files -- which are a GNU feature
+#
+# - At first to not build with tesseract (OCR)
+#
+#     export PYMUPDF_SETUP_MUPDF_TESSERACT=0
+#
+# - Install a LLVM package that has the same version as the libclang
+#   Python package that will be used/installed
+#   (e.g. pkg install llvm18 because of libclang>=18,<19)
 #
 
 .PHONY: build