From ce2aebe91085f987aab31bd2a49820fb605cf386 Mon Sep 17 00:00:00 2001
From: Bruce Hill <bruce@bruce-hill.com>
Date: Sun, 27 Oct 2024 21:14:27 -0400
Subject: Update docs to reflect deprecation of "&" stack references

---
 docs/integers.md | 29 +++++++++++------------------
 1 file changed, 11 insertions(+), 18 deletions(-)

(limited to 'docs/integers.md')

diff --git a/docs/integers.md b/docs/integers.md
index 60ccd71b..ef30b74d 100644
--- a/docs/integers.md
+++ b/docs/integers.md
@@ -144,39 +144,32 @@ Converts a text representation of an integer into an integer.
 
 **Signature:**  
 ```tomo
-func from_text(text: Text, success: Bool = !&Bool? -> Int)
+func from_text(text: Text -> Int?)
 ```
 
 **Parameters:**
 
 - `text`: The text containing the integer.
-- `success`: If non-null, this pointer will be set to `yes` if the whole text
-  is a valid integer that fits within the representable range of the integer
-  type, otherwise `no`.
 
 **Returns:**  
 The integer represented by the text. If the given text contains a value outside
-of the representable range, the number will be truncated to the minimum or
-maximum representable value. Other failures to parse the number will return
-zero.
+of the representable range or if the entire text can't be parsed as an integer,
+a null value will be returned.
 
 **Example:**  
 ```tomo
 >> Int.from_text("123")
-= 123
+= 123?
 >> Int.from_text("0xFF")
-= 255
+= 255?
 
-success := no
->> Int.from_text("asdf", &success)
-= 0
->> success
-= no
+# Can't parse:
+>> Int.from_text("asdf")
+= !Int
 
->> Int8.from_text("9999999", &success)
-= 127
->> success
-= no
+# Outside valid range:
+>> Int8.from_text("9999999")
+= !Int
 ```
 
 ---
-- 
cgit v1.2.3