From cdf7846e3cbb256fddd67f786c6d9c6a4ad2920d Mon Sep 17 00:00:00 2001
From: mjkalyan <34904034+mjkalyan@users.noreply.github.com>
Date: Wed, 9 Jun 2021 21:00:56 -0600
Subject: [PATCH 1/3] getting_started.org: Gentoo Linux install guide

---
 docs/getting_started.org | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/docs/getting_started.org b/docs/getting_started.org
index 1d476212a..f71de26ea 100644
--- a/docs/getting_started.org
+++ b/docs/getting_started.org
@@ -25,6 +25,7 @@ us know!
       - [[#arch-linux][Arch Linux]]
       - [[#nixos][NixOS]]
       - [[#opensuse][openSUSE]]
+      - [[#gentoo-linux][Gentoo Linux]]
     - [[#on-macos][On macOS]]
       - [[#with-homebrew][With Homebrew]]
       - [[#with-macports][With MacPorts]]
@@ -224,6 +225,40 @@ zypper install rust
 
 See the [[https://github.com/BurntSushi/ripgrep#building][ripgrep documentation]] for instructions on building from source.
 
+**** Gentoo Linux
+Everything you need is in Gentoo's official =::gentoo= repository.
+
+***** Emacs
+For the latest unmasked version compatible with Doom:
+#+begin_src sh
+emerge '>=app-editors/emacs-26.3'
+#+end_src
+
+Or, for GCCEmacs/Native Compilation, use the live ebuild for version 28.0 with the =jit= USE flag:
+
+Unmask the desired ebuild by adding the following to =package.accept_keywords=:
+#+begin_src
+=app-editors/emacs-28.0.9999 **
+#+end_src
+
+Add the =jit= USE flag to =package.use=:
+#+begin_src
+=app-editors/emacs-28.0.9999 jit
+#+end_src
+
+And emerge:
+#+begin_src sh
+emerge =app-editors/emacs-28.0.9999
+#+end_src
+
+***** Other Dependencies
+#+begin_src sh
+# required
+emerge '>=dev-vcs/git-2.23' '>=sys-apps/ripgrep-11.0' sys-apps/findutils
+# optional
+emerge '>=sys-apps/fd-7.3.0'
+#+end_src
+
 *** On macOS
 MacOS users have many options for installing Emacs, but not all of them are well
 suited to Doom. Before we get to that you'll need either the Homebrew or

From 2d53f12f1c852d81e13bd2f328c84d0080da792d Mon Sep 17 00:00:00 2001
From: mjkalyan <34904034+mjkalyan@users.noreply.github.com>
Date: Thu, 24 Jun 2021 05:41:38 -0600
Subject: [PATCH 2/3] getting_started.org: Gentoo xft and gui flags

As suggested by @TheGreatMcPain here: https://github.com/hlissner/doom-emacs/pull/5165#issuecomment-863747913
---
 docs/getting_started.org | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/docs/getting_started.org b/docs/getting_started.org
index f71de26ea..21f50a953 100644
--- a/docs/getting_started.org
+++ b/docs/getting_started.org
@@ -229,7 +229,13 @@ See the [[https://github.com/BurntSushi/ripgrep#building][ripgrep documentation]
 Everything you need is in Gentoo's official =::gentoo= repository.
 
 ***** Emacs
-For the latest unmasked version compatible with Doom:
+To use Emacs graphically, enable the =gui= USE flag. And enable the =xft= USE flag to render fonts correctly (see
+[[https://github.com/hlissner/doom-emacs/issues/4876][issue #4876]])
+#+begin_src sh
+echo "app-editors/emacs gui xft" >> /etc/portage/package.use/emacs
+#+end_src
+
+To install the latest unmasked version compatible with Doom:
 #+begin_src sh
 emerge '>=app-editors/emacs-26.3'
 #+end_src

From d217ae334392b6abf0e23424516a37b4cd8ac261 Mon Sep 17 00:00:00 2001
From: mjkalyan <34904034+mjkalyan@users.noreply.github.com>
Date: Thu, 22 Jul 2021 20:12:54 -0600
Subject: [PATCH 3/3] getting_started.org: use Emacs v27.x or later

---
 docs/getting_started.org | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/getting_started.org b/docs/getting_started.org
index fab3c7b7c..0997640c1 100644
--- a/docs/getting_started.org
+++ b/docs/getting_started.org
@@ -233,7 +233,7 @@ echo "app-editors/emacs gui xft" >> /etc/portage/package.use/emacs
 
 To install the latest unmasked version compatible with Doom:
 #+begin_src sh
-emerge '>=app-editors/emacs-26.3'
+emerge '>=app-editors/emacs-27.0'
 #+end_src
 
 Or, for GCCEmacs/Native Compilation, use the live ebuild for version 28.0 with the =jit= USE flag: