From 2bd3ba2aee633f51c1b2dce662c8082b3bd0116c Mon Sep 17 00:00:00 2001
From: Svjatoslav Agejenko <svjatoslav@svjatoslav.eu>
Date: Sun, 22 Feb 2026 12:18:34 +0200
Subject: [PATCH] Refine `1-` opcode documentation: clarify description,
 enhance usage notes, and improve readability.

---
 doc/opcodes_00_09.org | 15 +++++++--------
 1 file changed, 7 insertions(+), 8 deletions(-)

diff --git a/doc/opcodes_00_09.org b/doc/opcodes_00_09.org
index 0de3b7b..2713a94 100644
--- a/doc/opcodes_00_09.org
+++ b/doc/opcodes_00_09.org
@@ -146,14 +146,13 @@
 :ID:       523f93a3-359e-4a6d-b296-df25008db403
 :END:
 - *Stack Effect:* =n -- n-1=
-- *Description:* Decrements the top value on the data stack by 1.
-- *Notes:* Directly decrements the dword at the data stack pointer.
-- *Example:*
-  #+begin_example
-  10
-  1-
-  #+end_example
-  After execution, stack contains 9.
+- *Description:* Decrements the top value on the data stack by exactly
+  one. The operation modifies the value IN PLACE at the data stack
+  pointer.
+
+=1-= is commonly used for:
+- Iteration counters (decrementing and testing)
+- Reference counting (decrementing and checking for zero)
 
 * 8: dup
 :PROPERTIES:
-- 
2.20.1