From 49a47ff3648fd20077fcde1f443dc60521174c5a Mon Sep 17 00:00:00 2001
From: speedie <speedie@speedie.site>
Date: Thu, 27 Jul 2023 23:54:12 +0200
Subject: [PATCH] Add Gentoo article

---
 articles/Installing spmenu.md      | 32 ++++++++++++-----
 articles/Using spmenu on Gentoo.md | 55 ++++++++++++++++++++++++++++++
 2 files changed, 79 insertions(+), 8 deletions(-)
 create mode 100644 articles/Using spmenu on Gentoo.md

diff --git a/articles/Installing spmenu.md b/articles/Installing spmenu.md
index db6776f..cc82128 100644
--- a/articles/Installing spmenu.md	
+++ b/articles/Installing spmenu.md	
@@ -33,7 +33,15 @@ spmenu on macOS using `Xquartz`. See [[Using spmenu on macOS]].
   - 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]].
+
+## Compatibility
+
+There are articles written regarding spmenu compatibility with specific
+distributions and operating systems. Here are some of them.
+
+- If you use FreeBSD, see [[Using spmenu on FreeBSD]].
+- If you use Gentoo Linux, see [[Using spmenu on Gentoo]].
+- If you use macOS, see [[Using spmenu on macOS]].
 
 ## Dependencies
 
@@ -87,12 +95,20 @@ the README try to teach you how to use the build system called meson, we're
 going to just do the installation and not think much about it. If you want
 to truly understand what you're doing, you may refer to the README documentation.
 
-Run `meson setup build` to set up the build itself. Now you can run `cd build` to
-change directory into the build directory. Now, finally run `meson install` to
-install spmenu itself. Run this command as superuser/root. If you don't it will
-attempt to use `sudo` for authentication. If you want to compile spmenu but not
-install spmenu, you can simply run `ninja -C build` in the spmenu root directory.
+Run `meson setup build` to set up the build itself. If you want to specify some
+specific options, you can pass those to meson.  For example, to build spmenu without
+Wayland support, run `meson setup build -Dwayland=false`.
 
-That's it, now we're done. You can now use spmenu.
+**NOTE: If you want to set up spmenu again with different options, pass `--reconfigure`
+to meson.**
 
-I recommend you follow [[Getting Started]] if you're new to spmenu.
+Now you can run `cd build` to change directory into the build directory. Now,
+finally run `meson install` to install spmenu itself. Run this command as
+superuser/root. If you don't it will attempt to use `sudo` for authentication.
+If you want to compile spmenu but not install spmenu, you can simply run
+`ninja -C build` in the spmenu root directory.
+
+That's it, now we're done. You can now use spmenu and spmenu_run.
+
+From here, it is recommended that you follow [[Getting Started]] if
+you're new to spmenu.
diff --git a/articles/Using spmenu on Gentoo.md b/articles/Using spmenu on Gentoo.md
new file mode 100644
index 0000000..e5f93ed
--- /dev/null
+++ b/articles/Using spmenu on Gentoo.md	
@@ -0,0 +1,55 @@
+# Using spmenu on Gentoo
+
+If you're using Gentoo Linux, you can install spmenu from my
+[overlay](https://git.speedie.site/speedie/speedie-overlay). This overlay
+provides the `x11-misc/spmenu` and `x11-misc/spmenuify` packages.
+
+## USE flags
+
+Gentoo has USE flags which can be used to enable/disable certain features.
+The spmenu package has several USE flags which can be set
+in `/etc/portage/package.use`.
+
+- `X`
+  - Enable X11 support
+- `wayland`
+  - Enable Wayland support
+- `imlib2`
+  - Enable support for displaying images (requires USE=ssl)
+- `ssl`
+  - Enable support for displaying images (requires USE=imlib2)
+- `regex`
+  - Enable regex matching
+- `fribidi`
+  - Enable support for RTL text
+- `config`
+  - Enable support for loading configuration files
+- `xinerama`
+  - Enable multi-monitor support on X using libXinerama (requires USE=X)
+- `xrdb`
+  - Enable support for xrdb (requires USE=X)
+- `doc`
+  - Install a configuration file to /usr/share/spmenu and man pages
+- `man`
+  - Install man pages (requires USE=doc)
+- `run`
+  - Install spmenu_run run launcher
+- `test`
+  - Install spmenu_test
+
+## Installation
+
+If you aren't using `~amd64` keywords globally, unmask it in
+`/etc/portage/package.accept_keywords`. If you prefer, you can
+unmask the Git version, if you want to always run the latest commit
+and have Portage manage spmenu.
+
+Then simply emerge `x11-misc/spmenu`, and optionally `x11-misc/spmenuify`.
+
+## Works
+
+Everything.
+
+## Issues
+
+None caused by Gentoo.