From da43b73afc13ee15fb7d9da37b03f00f292e2df5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Denis=20=C5=BDoljom?= <dingo-d@users.noreply.github.com>
Date: Mon, 8 Jan 2024 09:21:46 +0100
Subject: [PATCH] Add the documentation for the PSR12 Return Type Declaration
 sniff

---
 .../ReturnTypeDeclarationStandard.xml         | 41 +++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 src/Standards/PSR12/Docs/Functions/ReturnTypeDeclarationStandard.xml

diff --git a/src/Standards/PSR12/Docs/Functions/ReturnTypeDeclarationStandard.xml b/src/Standards/PSR12/Docs/Functions/ReturnTypeDeclarationStandard.xml
new file mode 100644
index 0000000000..000459c33a
--- /dev/null
+++ b/src/Standards/PSR12/Docs/Functions/ReturnTypeDeclarationStandard.xml
@@ -0,0 +1,41 @@
+<documentation title="Return Type Declaration">
+    <standard>
+    <![CDATA[
+    For function and closure return type declarations, there must be one space after the colon followed by the type declaration, and no space before the colon.
+
+    The colon and the return type declaration have to be on the same line as the argument list closing parenthesis.
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: A single space between the colon and type in a return type declaration.">
+        <![CDATA[
+$closure = function ( $arg ):<em> </em>string {
+   // Closure body.
+};
+        ]]>
+        </code>
+        <code title="Invalid: No space between the colon and the type in a return type declaration.">
+        <![CDATA[
+$closure = function ( $arg ):<em></em>string {
+   // Closure body.
+};
+        ]]>
+        </code>
+    </code_comparison>
+    <code_comparison>
+        <code title="Valid: No space before the colon in a return type declaration.">
+        <![CDATA[
+function someFunction( $arg )<em></em>: string {
+   // Function body.
+};
+        ]]>
+        </code>
+        <code title="Invalid: One or more spaces before the colon in a return type declaration.">
+        <![CDATA[
+function someFunction( $arg )<em>   </em>: string {
+   // Function body.
+};
+        ]]>
+        </code>
+    </code_comparison>
+</documentation>