build: add make command to apply Git notes and fix file extension

Author: Planeshifter

docs/git-notes/9df16105aa2d89808d3395c610334ca9cce35b3c renamed to docs/git-notes/9df16105aa2d89808d3395c610334ca9cce35b3c.txt

@@ -20,7 +20,7 @@
 
 # Note: keep in alphabetical order...
 include $(TOOLS_MAKE_LIB_DIR)/git/commitizen.mk
-
+include $(TOOLS_MAKE_LIB_DIR)/git/notes.mk
 
 # RULES #
 

tools/make/lib/git/Makefile

@@ -78,6 +78,18 @@ $ git add . && make commit
 $ git add . && make retry-commit
 ```
 
+#### apply-git-notes
+
+Applies Git notes from the `docs/git-notes` directory to their corresponding commits.
+
+<!-- run-disable -->
+
+```bash
+$ make apply-git-notes
+```
+
+This is useful for fixing commit messages which contain errors or do not adhere to the project's [Git style guide][stdlib-style-guides-git] and to exclude certain commits from the changelog notes for specific packages.
+
 </section>
 
 <!-- /.usage -->

tools/make/lib/git/README.md

@@ -0,0 +1,46 @@
+#/
+# @license Apache-2.0
+#
+# Copyright (c) 2024 The Stdlib Authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#/
+
+# VARIABLES #
+
+# Define the directory containing git notes:
+GIT_NOTES_DIR ?= $(ROOT_DIR)/docs/git-notes
+
+# RULES #
+
+#/
+# Applies Git notes from the `docs/git-notes` directory.
+#
+# ## Notes
+#
+# -   This rule applies git notes where the file name (without the .txt extension) is the git commit hash and the content is the note.
+#
+# @example
+# make apply-git-notes
+#/
+apply-git-notes:
+	$(QUIET) echo "Applying git notes..."
+	$(QUIET) for note in $(GIT_NOTES_DIR)/*.txt; do \
+		if [ -f "$$note" ]; then \
+			commit_hash=$$(basename "$$note" .txt); \
+			git notes add -f -F "$$note" "$$commit_hash" || echo "Failed to apply note for commit $$commit_hash"; \
+		fi; \
+	done
+	$(QUIET) echo "Git notes application complete."
+
+.PHONY: apply-git-notes