From df5de8b7ec26b6fbc9bd6a7beb3de0f82707d12a Mon Sep 17 00:00:00 2001
From: Najeeb Al-Shabibi <najeeb.al.shabibi@gmail.com>
Date: Fri, 29 Sep 2023 14:21:44 +0100
Subject: [PATCH] added doc and changelog entry for preserve-tombs plugin

---
 docs/changelog.txt              |  1 +
 docs/plugins/preserve-tombs.rst | 22 ++++++++++++++++++++++
 2 files changed, 23 insertions(+)
 create mode 100644 docs/plugins/preserve-tombs.rst

diff --git a/docs/changelog.txt b/docs/changelog.txt
index f819587de..07ed84ebf 100644
--- a/docs/changelog.txt
+++ b/docs/changelog.txt
@@ -52,6 +52,7 @@ Template for new versions:
 # Future
 
 ## New Tools
+- `preserve-tombs`: tracks tomb assignments to living units and ensures that the tomb stays assigned to them when they die.
 
 ## New Features
 
diff --git a/docs/plugins/preserve-tombs.rst b/docs/plugins/preserve-tombs.rst
new file mode 100644
index 000000000..7c148e3ee
--- /dev/null
+++ b/docs/plugins/preserve-tombs.rst
@@ -0,0 +1,22 @@
+preserve-tombs
+==============
+
+.. dfhack-tool::
+    :summary: Fix tombs being unassigned to units on death
+    :tags: fort bugfix
+
+If you find that the tombs you assign to units get unassigned from them when
+they die (e.g. your nobles), this tool can help fix that.
+
+Usage
+-----
+
+::
+
+    enable preserve-tombs
+    preserve-tombs status
+
+This tool runs in the background. You can check the status of the plugin
+by running ``preserve-tombs status`` which will show whether the plugin
+is enabled and if so, display a list of all tracked tomb assignments
+to living units.