diff --git a/nixos/doc/manual/from_md/release-notes/rl-2111.section.xml b/nixos/doc/manual/from_md/release-notes/rl-2111.section.xml
index a64379b19ef6..f1d803136aa0 100644
--- a/nixos/doc/manual/from_md/release-notes/rl-2111.section.xml
+++ b/nixos/doc/manual/from_md/release-notes/rl-2111.section.xml
@@ -1365,6 +1365,17 @@ Superuser created successfully.
gnat11 instead of gnat9.
+
+
+ retroArchCores has been removed. This means
+ that using nixpkgs.config.retroarch to
+ customize RetroArch cores is not supported anymore. Instead,
+ use package overrides, for example:
+ retroarch.override { cores = with libretro; [ citra snes9x ]; };.
+ Also, retroarchFull derivation is available
+ for those who want to have all RetroArch cores available.
+
+
@@ -1966,6 +1977,16 @@ Superuser created successfully.
1.5.4.
+
+
+ RetroArch has been upgraded from version
+ 1.8.5 to 1.9.13.2. Since
+ the previous release was quite old, if you’re having issues
+ after the upgrade, please delete your
+ $XDG_CONFIG_HOME/retroarch/retroarch.cfg
+ file.
+
+
diff --git a/nixos/doc/manual/release-notes/rl-2111.section.md b/nixos/doc/manual/release-notes/rl-2111.section.md
index 9a76b4cca449..275ee7142d0e 100644
--- a/nixos/doc/manual/release-notes/rl-2111.section.md
+++ b/nixos/doc/manual/release-notes/rl-2111.section.md
@@ -407,6 +407,8 @@ In addition to numerous new and upgraded packages, this release has the followin
- The default GNAT version has been changed: The `gnat` attribute now points to `gnat11`
instead of `gnat9`.
+- `retroArchCores` has been removed. This means that using `nixpkgs.config.retroarch` to customize RetroArch cores is not supported anymore. Instead, use package overrides, for example: `retroarch.override { cores = with libretro; [ citra snes9x ]; };`. Also, `retroarchFull` derivation is available for those who want to have all RetroArch cores available.
+
## Other Notable Changes {#sec-release-21.11-notable-changes}
@@ -539,3 +541,5 @@ In addition to numerous new and upgraded packages, this release has the followin
- Loki has had another release. Some default values have been changed for the configuration and some configuration options have been renamed. For more details, please check [the upgrade guide](https://grafana.com/docs/loki/latest/upgrading/#240).
- `julia` now refers to `julia-stable` instead of `julia-lts`. In practice this means it has been upgraded from `1.0.4` to `1.5.4`.
+
+- RetroArch has been upgraded from version `1.8.5` to `1.9.13.2`. Since the previous release was quite old, if you're having issues after the upgrade, please delete your `$XDG_CONFIG_HOME/retroarch/retroarch.cfg` file.