From a859b9640e2b198e51ad70bf08a3efe35bce0f42 Mon Sep 17 00:00:00 2001
From: Juerd Waalboer <juerd@tnx.nl>
Date: Sun, 5 Nov 2023 21:25:45 +0100
Subject: [PATCH] Document tiny semantics change for v4.2.0

---
 UPGRADING.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/UPGRADING.md b/UPGRADING.md
index daed605..66b2794 100644
--- a/UPGRADING.md
+++ b/UPGRADING.md
@@ -1,3 +1,19 @@
+# (2023-11-05) RevBank 4.2.0
+
+Accounts that begin with `*` are now special: like hidden accounts, they do not
+count towards the grand total, but unlike hidden accouns, they can be used as
+normal user accounts too.
+
+The intended application is for liabilities accounts that are also used
+directly for revenues and expenses.
+
+They can be used with or without the `*` prefix, e.g. the account
+`*lasercutter` can also be used as `lasercutter`. Such accounts cannot be
+created from within the software: to create a user-accessible special account,
+you need to edit `revbank.accounts` manually.
+
+When upgrading, check that no accounts beginning with `*` already exist.
+
 # (2023-09-20) RevBank 4.0.0
 
 ## You must pick a transaction ID style