# HG changeset patch
# User Franz Glasner <fzglas.hg@dom66.de>
# Date 1758080370 -7200
# Node ID bf1744083a54c185ae1ff2380474e4d60c0f039d
# Parent  5ab937c03c2741b1266fca9b261bc4b58dee8ef6
Some documentation notes into Makefile.freebsd

diff -r 5ab937c03c27 -r bf1744083a54 Makefile.freebsd
--- 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