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/booleans.md | 14 +++++---------
 1 file changed, 5 insertions(+), 9 deletions(-)

(limited to 'docs/booleans.md')

diff --git a/docs/booleans.md b/docs/booleans.md
index a08faa9f..5610d863 100644
--- a/docs/booleans.md
+++ b/docs/booleans.md
@@ -16,13 +16,12 @@ boolean values are case-insensitive variations of `yes`/`no`, `y`/`n`,
 
 **Signature:**  
 ```tomo
-func from_text(text: Text, success: Bool = !&Bool -> Bool)
+func from_text(text: Text -> Bool?)
 ```
 
 **Parameters:**
 
 - `text`: The string containing the boolean value.
-- `success`: If provided, this boolean value reference will be set to `yes` if the given text is a recognizable boolean value or `no` otherwise.
 
 **Returns:**  
 `yes` if the string matches a recognized truthy boolean value; otherwise return `no`.
@@ -30,14 +29,11 @@ func from_text(text: Text, success: Bool = !&Bool -> Bool)
 **Example:**  
 ```tomo
 >> Bool.from_text("yes")
-= yes
+= yes?
 >> Bool.from_text("no")
-= no
->> success := yes
->> Bool.from_text("???", &success)
-= no
->> success
-= no
+= no?
+>> Bool.from_text("???")
+= !Bool
 ```
 
 ---
-- 
cgit v1.2.3