From 9c787f0e89e0d3f6cb35bb3f72175330a854aad8 Mon Sep 17 00:00:00 2001
From: Josh Holtrop <jholtrop@gmail.com>
Date: Mon, 9 Feb 2026 22:08:20 -0500
Subject: [PATCH] Update CHANGELOG.md and UPGRADING.md for v3.0.0

---
 CHANGELOG.md | 18 ++++++++++++++++++
 UPGRADING.md |  7 +++++++
 2 files changed, 25 insertions(+)
 create mode 100644 UPGRADING.md

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 94b65cf..879babc 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,21 @@
+## v3.0.0
+
+### New Features
+
+- Add support for multiple starting rules (#38)
+- Add `p_free_tree()` functions to reclaim generated tree memory
+- Add `free_token_node` grammar statement to reclaim user-allocated memory stored in a Token tree node `pvalue` field
+- Add valgrind memory leak tests to unit tests
+- Fix build issues for C++ to officially support C++ target output
+
+### Improvements
+
+- Document `p_lex()` and `p_token_info_t` in user guide (#37)
+
+### Breaking changes
+
+- Rename AST generation mode to tree generation mode (see [UPGRADING.md]())
+
 ## v2.3.0
 
 ### New Features
diff --git a/UPGRADING.md b/UPGRADING.md
new file mode 100644
index 0000000..b638dcf
--- /dev/null
+++ b/UPGRADING.md
@@ -0,0 +1,7 @@
+## v3.0.0
+
+### Grammar changes
+
+- Rename `ast;` statement to `tree;`.
+- Rename `ast_prefix;` statement to `tree_prefix;`.
+- Rename `ast_suffix;` statement to `tree_suffix;`.