diff --git a/srcpkgs/nix/template b/srcpkgs/nix/template
index 2262edf37aa..44f7dfaf77b 100644
--- a/srcpkgs/nix/template
+++ b/srcpkgs/nix/template
@@ -39,6 +39,7 @@ if [ "$CROSS_BUILD" ]; then
 	make_build_args+=" CROSS_EMULATOR=/usr/bin/qemu-${XBPS_TARGET_QEMU_MACHINE}-static"
 	make_install_args+=" CROSS_EMULATOR=/usr/bin/qemu-${XBPS_TARGET_QEMU_MACHINE}-static"
 	# XXX: documentation generation hangs in cross on arm32 musl
+	# see https://gitlab.com/qemu-project/qemu/-/issues/1729
 	case "$XBPS_TARGET_MACHINE" in
 		arm*musl) configure_args+=" --disable-doc-gen" ;;
 	esac