From a6e8bef77434f69f1483c9e16b405f7f74a201d2 Mon Sep 17 00:00:00 2001
From: falkTX <falktx@falktx.com>
Date: Mon, 7 Feb 2022 19:49:47 +0000
Subject: [PATCH] FreeBSD related fixes

Signed-off-by: falkTX <falktx@falktx.com>
---
 .gitmodules     |  2 +-
 carla           |  2 +-
 deps/QuickJS    |  2 +-
 doc/BUILDING.md | 35 ++++++++++++++++++++++++++++++-----
 4 files changed, 33 insertions(+), 8 deletions(-)

diff --git a/.gitmodules b/.gitmodules
index af51fdf..f795620 100644
--- a/.gitmodules
+++ b/.gitmodules
@@ -129,7 +129,7 @@
 	url = https://github.com/CardinalModules/ihtsyn.git
 [submodule "deps/QuickJS"]
 	path = deps/QuickJS
-	url = https://github.com/JerrySievert/QuickJS.git
+	url = https://github.com/CardinalModules/QuickJS.git
 [submodule "plugins/Autinn"]
 	path = plugins/Autinn
 	url = https://github.com/NikolaiVChr/Autinn.git
diff --git a/carla b/carla
index afc25ae..b8d38e3 160000
--- a/carla
+++ b/carla
@@ -1 +1 @@
-Subproject commit afc25ae3137be9cb7addedd16ff45fbe0ab4ea97
+Subproject commit b8d38e395c215eed189a4849972f90af810ef971
diff --git a/deps/QuickJS b/deps/QuickJS
index b70d534..9ed1187 160000
--- a/deps/QuickJS
+++ b/deps/QuickJS
@@ -1 +1 @@
-Subproject commit b70d5344013836544631c361ae20569b978176c9
+Subproject commit 9ed118744671f1e257ebb0d731300ba115f6cfce
diff --git a/doc/BUILDING.md b/doc/BUILDING.md
index 4b81a7f..0be87db 100644
--- a/doc/BUILDING.md
+++ b/doc/BUILDING.md
@@ -38,7 +38,23 @@ Advanced options:
 
 ## FreeBSD
 
-TODO
+Dependencies for using system libraries, that is, with `SYSDEPS=true`:
+
+```
+# common
+sudo pkg install -A dbus libglvnd liblo libsndfile libX11 libXcursor libXext libXrandr
+# system libraries
+sudo pkg install -A libarchive libsamplerate jansson speexdsp
+```
+
+Dependencies for vendored libraries:
+
+```
+# common
+sudo pkg install -A dbus libglvnd liblo libsndfile libX11 libXcursor libXext libXrandr
+# nedeed by vendored libraries
+sudo pkg install -A cmake
+```
 
 ## Linux
 
@@ -105,7 +121,7 @@ You can either cross-compile Cardinal for Windows from Linux, or install and use
 
 ### Cross-compile
 
-For cross-compilation, first install the relevant mingw packages.
+For cross-compilation, first install the relevant mingw packages.  
 On Ubuntu these are `binutils-mingw-w64-x86-64 g++-mingw-w64-x86-64 mingw-w64`.  
 Then build with `CC` and `CXX` pointing to the mingw compiler, like so:
 
@@ -121,6 +137,9 @@ After a successful build you will find the plugin binaries in the `bin/` directo
 You can either install them to your system using e.g. `make install PREFIX=/some/prefix` (not recommended for local source builds)
 or preferably just create a symbolic link on the respective plugin format folders.
 
+Cardinal plugin binaries expect to remain *within* their parent bundle/folder.  
+If you move them around make sure to keep their folder structure intact.
+
 If you are a packager you pretty much already know what to do at this point, otherwise regular users might want to do something like:
 
 ```
@@ -130,6 +149,8 @@ ln -s $(pwd)/bin/*.vst ~/.vst/
 ln -s $(pwd)/bin/*.vst3 ~/.vst3/
 ```
 
+## macOS
+
 If running macOS, use this instead:
 
 ```
@@ -139,10 +160,14 @@ ln -s $(pwd)/bin/*.vst ~/Library/Audio/Plug-Ins/VST/
 ln -s $(pwd)/bin/*.vst3 ~/Library/Audio/Plug-Ins/VST3/
 ```
 
-Symbolic links are not supported on Windows, so this approach doesn't work there.
+Note: Official macOS Cardinal builds install in the system-wide `/Library/Audio/Plug-Ins` location.  
+Watch out for conflicts if switching between the two builds.
 
-Note that the plugins expect to remain *within* their parent folder.  
-If you move them around make sure to keep their folder structure intact.
+## Windows
+
+Symbolic links are not supported on Windows, so this approach doesn't work there.  
+On Windows you will have to copy or move the plugin bundles.  
+If you are building from source, it is expected you know where they should go.
 
 # Keeping up to date