From e97e8e9d946306e42fbc2e923d3f03d03afe7e4f Mon Sep 17 00:00:00 2001
From: Larry Garfield <larry@garfieldtech.com>
Date: Wed, 20 Nov 2024 12:09:49 -0600
Subject: [PATCH] More nit picks.

Co-authored-by: Gina Peter Banyard <girgias@php.net>
---
 language/oop5/abstract.xml       | 10 +++++-----
 language/oop5/property-hooks.xml |  5 +++--
 2 files changed, 8 insertions(+), 7 deletions(-)

diff --git a/language/oop5/abstract.xml b/language/oop5/abstract.xml
index 3b33d57f5633..d612d7a49a83 100644
--- a/language/oop5/abstract.xml
+++ b/language/oop5/abstract.xml
@@ -158,8 +158,8 @@ class C extends A
     // This would NOT satisfy the requirement, as it is not publicly readable.
     protected string $readable;
 
-    // This satisfies the requirement exactly, so is sufficient. It may only
-    // be written to, and only from protected scope.
+    // This satisfies the requirement exactly, so is sufficient.
+    // It may only be written to, and only from protected scope.
     protected string $writeable {
         set => $value;
     }
@@ -173,7 +173,7 @@ class C extends A
   </example>
   <para>
    An abstract property on an abstract class may provide implementations for any hook,
-   but must have either get or set declared but not defined (as in the example above).
+   but must have either <literal>get</literal> or <literal>set</literal> declared but not defined (as in the example above).
   </para>
   <example>
    <title>Abstract property example</title>
@@ -182,8 +182,8 @@ class C extends A
 <?php
 abstract class A
 {
-    // This provides a default (but overridable) set implementation, and requires
-    // child classes to provide a get implementation.
+    // This provides a default (but overridable) set implementation,
+    // and requires child classes to provide a get implementation.
     abstract public string $foo {
         get;
         set { $this->foo = $value };
diff --git a/language/oop5/property-hooks.xml b/language/oop5/property-hooks.xml
index 96ad1ef36e76..3a6eb21a3a98 100644
--- a/language/oop5/property-hooks.xml
+++ b/language/oop5/property-hooks.xml
@@ -39,7 +39,7 @@
    Property hooks are incompatible with <literal>readonly</literal> properties.
    If there is a need to restrict access to a <literal>get</literal> or <literal>set</literal>
    operation in addition to altering its behavior, use
-   <link linkend="language.oop5.visibility-members-aviz">Asymmetric Property Visibility</link>.
+   <link linkend="language.oop5.visibility-members-aviz">asymmetric property visibility</link>.
   </simpara>
   <sect2>
    <title>Basic Hook Syntax</title>
@@ -321,7 +321,8 @@ class Person {
    <sect3>
     <title>Final hooks</title>
     <simpara>
-     Hooks may also be declared final, in which case they may not be overridden.
+     Hooks may also be declared <link linkend="language.oop5.final">final</link>,
+     in which case they may not be overridden.
     </simpara>
     <example>
      <title>Final hooks</title>