From ca355f48a6010250ce7b1c53ae05a28934b9965b Mon Sep 17 00:00:00 2001
From: Echedey Luis <80125792+echedey-ls@users.noreply.github.com>
Date: Sun, 1 Nov 2026 12:39:36 +0100
Subject: [PATCH 1/5] Add .git-blame-ignore-revs

---
 .git-blame-ignore-revs | 14 ++++++++++++++
 1 file changed, 14 insertions(+)
 create mode 100644 .git-blame-ignore-revs

diff --git a/.git-blame-ignore-revs b/.git-blame-ignore-revs
new file mode 100644
index 0000000000..f20dd31fd1
--- /dev/null
+++ b/.git-blame-ignore-revs
@@ -0,0 +1,14 @@
+# .git-blame-ignore-revs
+# List of commits that are irrelevant when traversing the blame history.
+# GitHub automatically reads and interprets this file when present.
+# Developers should run `git config blame.ignoreRevsFile .git-blame-ignore-revs`
+# to automatically exclude commits in this file.
+#
+# WARNING: DO NOT MIX HASH AND COMMENTS IN THE SAME LINE.
+#
+# More info at [^1] and [^2]:
+# [^1] https://stackoverflow.com/questions/34957237/can-i-configure-git-blame-to-always-ignore-certain-commits-want-to-fix-git-blam
+# [^2] https://docs.github.com/en/repositories/working-with-files/using-files/viewing-and-understanding-files#ignore-commits-in-the-blame-view
+
+# 2026-07-14 : Line ending normalization
+3e903d3662525a2fb9b7cc0b8248508c99a13f5d

From acb6fdbe99c5a35cfecf5092258b1f6bfbe7732d Mon Sep 17 00:00:00 2001
From: Echedey Luis <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 3 Nov 2026 11:58:53 +0100
Subject: [PATCH 2/5] Improve/fix instructions in blame file

---
 .git-blame-ignore-revs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/.git-blame-ignore-revs b/.git-blame-ignore-revs
index f20dd31fd1..6ec2456796 100644
--- a/.git-blame-ignore-revs
+++ b/.git-blame-ignore-revs
@@ -1,10 +1,10 @@
 # .git-blame-ignore-revs
 # List of commits that are irrelevant when traversing the blame history.
 # GitHub automatically reads and interprets this file when present.
-# Developers should run `git config blame.ignoreRevsFile .git-blame-ignore-revs`
-# to automatically exclude commits in this file.
-#
-# WARNING: DO NOT MIX HASH AND COMMENTS IN THE SAME LINE.
+# Developers should run blame command as follows to exclude commits in this file:
+# `git blame --ignore-revs-file .git-blame-ignore-revs <file-to-blame>`
+# Or, to persist the exclusion, change the repo's configuration via:
+# `git config blame.ignoreRevsFile .git-blame-ignore-revs`
 #
 # More info at [^1] and [^2]:
 # [^1] https://stackoverflow.com/questions/34957237/can-i-configure-git-blame-to-always-ignore-certain-commits-want-to-fix-git-blam

From 5e3a3f9b51a0ca14b27b27f37333b8112ee8de20 Mon Sep 17 00:00:00 2001
From: Echedey Luis <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 3 Nov 2026 12:07:10 +0100
Subject: [PATCH 3/5] Add whatsnew entry with instructions

---
 docs/sphinx/source/whatsnew/v0.16.2.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/sphinx/source/whatsnew/v0.16.2.rst b/docs/sphinx/source/whatsnew/v0.16.2.rst
index 67e908862a..f01e6157c1 100644
--- a/docs/sphinx/source/whatsnew/v0.16.2.rst
+++ b/docs/sphinx/source/whatsnew/v0.16.2.rst
@@ -63,6 +63,9 @@ Requirements
 
 Maintenance
 ~~~~~~~~~~~
+* Add file ``.git-blame-ignore-revs`` to exclude commits from blame history.
+  It is used automatically by GitHub. Developers may set this behavior locally with
+  ``git config blame.ignoreRevsFile .git-blame-ignore-revs``.
 
 
 Contributors

From c29cb47bc6a479a34bd02f55acc463d84a13aaaf Mon Sep 17 00:00:00 2001
From: Echedey Luis <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 3 Nov 2026 12:12:27 +0100
Subject: [PATCH 4/5] Add PR number to whatsnew

---
 docs/sphinx/source/whatsnew/v0.16.2.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/sphinx/source/whatsnew/v0.16.2.rst b/docs/sphinx/source/whatsnew/v0.16.2.rst
index f01e6157c1..9250fa902d 100644
--- a/docs/sphinx/source/whatsnew/v0.16.2.rst
+++ b/docs/sphinx/source/whatsnew/v0.16.2.rst
@@ -65,7 +65,7 @@ Maintenance
 ~~~~~~~~~~~
 * Add file ``.git-blame-ignore-revs`` to exclude commits from blame history.
   It is used automatically by GitHub. Developers may set this behavior locally with
-  ``git config blame.ignoreRevsFile .git-blame-ignore-revs``.
+  ``git config blame.ignoreRevsFile .git-blame-ignore-revs``. (:pull:`2933`)
 
 
 Contributors

From 2079c63022d63e296f507362679cce08d56575e4 Mon Sep 17 00:00:00 2001
From: Echedey Luis <80125792+echedey-ls@users.noreply.github.com>
Date: Tue, 3 Nov 2026 12:13:57 +0100
Subject: [PATCH 5/5] Add ignored commit PR number for context

---
 .git-blame-ignore-revs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.git-blame-ignore-revs b/.git-blame-ignore-revs
index 6ec2456796..0e907b2a75 100644
--- a/.git-blame-ignore-revs
+++ b/.git-blame-ignore-revs
@@ -10,5 +10,5 @@
 # [^1] https://stackoverflow.com/questions/34957237/can-i-configure-git-blame-to-always-ignore-certain-commits-want-to-fix-git-blam
 # [^2] https://docs.github.com/en/repositories/working-with-files/using-files/viewing-and-understanding-files#ignore-commits-in-the-blame-view
 
-# 2026-07-14 : Line ending normalization
+# 2026-07-14 : GH#2805 Line end normalization
 3e903d3662525a2fb9b7cc0b8248508c99a13f5d