From f66f498bd43efaa6883f12ca5988a282eef09697 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 | 8 ++++++++
 1 file changed, 8 insertions(+)
 create mode 100644 doc/manual/rl-next/shebang-relative.md

diff --git a/doc/manual/rl-next/shebang-relative.md b/doc/manual/rl-next/shebang-relative.md
new file mode 100644
index 00000000000..dbda0db4c88
--- /dev/null
+++ b/doc/manual/rl-next/shebang-relative.md
@@ -0,0 +1,8 @@
+synopsis: ensure nix-shell shebang uses relative path
+prs: #5088
+description: {
+
+`nix-shell` shebangs use the script file's relative location to resolve relative paths to files passed as command line arguments, but expression arguments were still evaluated using the current working directory as a base path.
+The new behavior is that evalutations are performed relative to the script.
+
+}