From: Svjatoslav Agejenko <svjatoslav@svjatoslav.eu>
Date: Sun, 22 Feb 2026 10:18:34 +0000 (+0200)
Subject: Refine `1-` opcode documentation: clarify description, enhance usage notes, and impro... 
X-Git-Url: http://www2.svjatoslav.eu/gitweb/?a=commitdiff_plain;h=2bd3ba2aee633f51c1b2dce662c8082b3bd0116c;p=fifth.git

Refine `1-` opcode documentation: clarify description, enhance usage notes, and improve readability.
---

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: