unit => singleton

Author: kamil-tekiela

language/types.xml

@@ -131,7 +131,7 @@ int(16)
  &language.types.void;
  &language.types.never;
  &language.types.relative-class-types;
- &language.types.unit;
+ &language.types.singleton;
  &language.types.iterable;
  &language.types.declarations;
  &language.types.type-juggling;

language/types/declarations.xml

@@ -271,7 +271,7 @@ Stack trace:
    <title>Union types</title>
    <warning>
     <simpara>
-     It is not possible to combine the two unit types <type>false</type>
+     It is not possible to combine the two singleton types <type>false</type>
      and <type>true</type> together in a union type.
      Use <type>bool</type> instead.
     </simpara>

language/types/unit.xml renamed to language/types/singleton.xml

@@ -1,25 +1,25 @@
 <?xml version="1.0" encoding="utf-8"?>
-<sect1 xml:id="language.types.unit">
- <title>Unit types</title>
+<sect1 xml:id="language.types.singleton">
+ <title>Singleton types</title>
 
  <para>
-  Unit types are those which allow only one value.
-  PHP has support for three unit types:
-  <type>false</type> as of PHP 8.0.0, <type>true</type>
-  as of PHP 8.2.0, and <type>null</type>.
+  Singleton types are those which allow only one value.
+  PHP has support for two singleton types:
+  <type>false</type> as of PHP 8.0.0 and <type>true</type>
+  as of PHP 8.2.0.
  </para>
 
  <warning>
   <simpara>
-   Prior to PHP 8.2.0 the <type>false</type> and <type>null</type> type
+   Prior to PHP 8.2.0 the <type>false</type> type
    could only be used as part of a
    <link linkend="language.types.type-system.composite.union">union type</link>.
   </simpara>
  </warning>
 
  <note>
   <simpara>
-   It is not possible to define custom unit types. Consider using an
+   It is not possible to define custom singleton types. Consider using an
    <link linkend="language.types.enumerations">enumerations</link> instead.
   </simpara>
  </note>

language/types/type-system.xml

@@ -69,7 +69,7 @@
       </listitem>
       <listitem>
        <simpara>
-        <link linkend="language.types.unit">Unit types</link>
+        <link linkend="language.types.singleton">Singleton types</link>
        </simpara>
        <itemizedlist>
         <listitem>
@@ -78,6 +78,13 @@
         <listitem>
          <simpara><type>true</type></simpara>
         </listitem>
+       </itemizedlist>
+      </listitem>
+      <listitem>
+       <simpara>
+        Unit types
+       </simpara>
+       <itemizedlist>
         <listitem>
          <simpara><type>null</type></simpara>
         </listitem>