From db5708045037a159458de741b46e9c47fe430284 Mon Sep 17 00:00:00 2001
From: Nobuyoshi Nakada <nobu@ruby-lang.org>
Date: Sat, 1 Nov 2025 19:10:19 +0900
Subject: [PATCH] [DOC] How to use `make matz`

---
 defs/gmake.mk | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/defs/gmake.mk b/defs/gmake.mk
index 4069a4b8c9..3dcfe9f639 100644
--- a/defs/gmake.mk
+++ b/defs/gmake.mk
@@ -537,8 +537,13 @@ spec/%/ spec/%_spec.rb: programs exts PHONY
 
 ruby.pc: $(filter-out ruby.pc,$(ruby_pc))
 
-matz: up
+# `make matz`: bump up the MINOR;
+#    Copying NEWS.md to doc/NEWS/, and empty the details in NEWS.md.
+#
+# `make matz NEW=x.y`: bump up to x.y.0;
+#    Just update the version in the title of NEWS.md.
 
+matz: up
 matz: OLD := $(MAJOR).$(MINOR).0
 ifdef NEW
 matz: MAJOR := $(word 1,$(subst ., ,$(NEW)))