From 6d495b92717dfe8c4f80f6a687d8fa0d2e0d5d15 Mon Sep 17 00:00:00 2001
From: speedie <speedie@duck.com>
Date: Wed, 26 Jul 2023 03:32:15 +0200
Subject: [PATCH] Add FreeBSD article

---
 articles/Installing spmenu.md       |  3 ++-
 articles/Using spmenu on FreeBSD.md | 29 +++++++++++++++++++++++++++++
 2 files changed, 31 insertions(+), 1 deletion(-)
 create mode 100644 articles/Using spmenu on FreeBSD.md

diff --git a/articles/Installing spmenu.md b/articles/Installing spmenu.md
index cc9e33b..db6776f 100644
--- a/articles/Installing spmenu.md	
+++ b/articles/Installing spmenu.md	
@@ -24,7 +24,7 @@ here, I will not be providing support due to having a lack of experience with
 said operating system. The main operating system that doesn't support
 spmenu is Microsoft Windows. UNIX like operating systems are most likely to run
 it. macOS is not officially supported as of 2.0, but it is possible to install
-spmenu on macOS using `Xquartz`.
+spmenu on macOS using `Xquartz`. See [[Using spmenu on macOS]].
 
 - GNU/Linux distributions
   - Some distros (such as NixOS or GNU Guix) may require specific instructions,
@@ -33,6 +33,7 @@ spmenu on macOS using `Xquartz`.
   - There are likely more BSDs that can run spmenu, but I cannot support all
     of them. Try it and see if it works. If it doesn't please try and fix it.
     You know more about the BSDs than I do.
+  - If you use FreeBSD, see [[Using spmenu on FreeBSD]].
 
 ## Dependencies
 
diff --git a/articles/Using spmenu on FreeBSD.md b/articles/Using spmenu on FreeBSD.md
new file mode 100644
index 0000000..06c5a6e
--- /dev/null
+++ b/articles/Using spmenu on FreeBSD.md	
@@ -0,0 +1,29 @@
+# Using spmenu on FreeBSD
+
+This article is a compatibility tracker for running spmenu on the FreeBSD
+operating system.
+
+## Works
+
+Everything except what's listed in 'Doesn't work'
+
+## Doesn't work
+
+- Wayland
+  - Reason: Depends on Linux kernel functions
+  - Solution: Disable Wayland support when compiling
+- Profile menu
+  - Reason: Unknown
+  - Solution: Run your profile manager using a separate program or spmenu_run
+
+## Bugs
+
+- For some reason, a weird white line can appear sometimes inside of the items.
+This is likely a bug in the version of Cairo or Pango FreeBSD ships with. I have
+also had this same issue occur on Void Linux, but all other distributions seem
+fine.
+
+## Building
+
+Building works the exact same, except you must append `-Dwayland=false` to disable
+Wayland support due to issues listed above.