From ba56f8b95334756045fe2d48cd3912095ef6a4ce Mon Sep 17 00:00:00 2001
From: Tom Bereknyei <tomberek@gmail.com>
Date: Sat, 25 Nov 2023 19:07:29 -0500
Subject: [PATCH] notes: document change in nix-shell behavior

---
 doc/manual/rl-next/shebang-relative.md  | 7 +++++++
 doc/manual/src/release-notes/rl-next.md | 8 ++++++++
 2 files changed, 15 insertions(+)
 create mode 100644 doc/manual/rl-next/shebang-relative.md
 create mode 100644 doc/manual/src/release-notes/rl-next.md

diff --git a/doc/manual/rl-next/shebang-relative.md b/doc/manual/rl-next/shebang-relative.md
new file mode 100644
index 000000000..725c1cdeb
--- /dev/null
+++ b/doc/manual/rl-next/shebang-relative.md
@@ -0,0 +1,7 @@
+synopsis: ensure nix-shell shebang uses relative path
+prs: #5088
+description: {
+
+`nix-shell` shebangs use relative paths for files, but expressions were still evaluated using the current working directory. The new behavior is that evalutations are performed relative to the script.
+
+}
diff --git a/doc/manual/src/release-notes/rl-next.md b/doc/manual/src/release-notes/rl-next.md
new file mode 100644
index 000000000..961e6de30
--- /dev/null
+++ b/doc/manual/src/release-notes/rl-next.md
@@ -0,0 +1,8 @@
+# Release X.Y (202?-??-??)
+
+- Fixed a bug where `nix-env --query` ignored `--drv-path` when `--json` was set.
+
+- Introduced the store [`mounted-ssh-ng://`](@docroot@/command-ref/new-cli/nix3-help-stores.md).
+  This store allows full access to a Nix store on a remote machine and additionally requires that the store be mounted in the local filesystem.
+
+- [`nix-shell`](../command-ref/nix-shell.md) shebangs now interpret "-E" with relative paths