From 9a0b65989e464b1daa3436fcb59cb0ef136c7294 Mon Sep 17 00:00:00 2001
From: CIIDMike <yarns_purport0n@icloud.com>
Date: Tue, 20 May 2025 19:22:20 +1000
Subject: [PATCH] confusing use of terms

MAY   This word, or the adjective "OPTIONAL", mean that an item is truly optional. RFC2119

in the property hooks example
// A "virtual" property.  It **may** not be set explicitly.
could mean that the virtual property may OR may not be set explicitly.
updated to
// A "virtual" property. It **can** not be set explicitly.
also added to the example to show the error that would be thrown if the property was set
---
 appendices/migration84/new-features.xml | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/appendices/migration84/new-features.xml b/appendices/migration84/new-features.xml
index 61b95db924f9..e88094e3b857 100644
--- a/appendices/migration84/new-features.xml
+++ b/appendices/migration84/new-features.xml
@@ -23,7 +23,7 @@
 <?php
 class Person
 {
-    // A "virtual" property.  It may not be set explicitly.
+    // A "virtual" property.  It can not be set explicitly.
     public string $fullName {
         get => $this->firstName . ' ' . $this->lastName;
     }
@@ -52,6 +52,8 @@ $p->firstName = 'peter';
 print $p->firstName; // Prints "Peter"
 $p->lastName = 'Peterson';
 print $p->fullName; // Prints "Peter Peterson"
+
+$p->fullName = "Peter 'Pete' Peterson"; // Fatal error: Property is read-only
 ]]>
     </programlisting>
    </informalexample>