From 9cea8ac983d00a4b000f702e72f8b7ed5a3801f7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Denis=20=C5=BDoljom?= <dingo-d@users.noreply.github.com>
Date: Sun, 25 Sep 2022 11:48:05 +0200
Subject: [PATCH] Update docs for the sniff

Will probably need some fixup.
---
 .../DeclareStatements/BlockModeStandard.xml   | 56 +++++++++++++++++++
 1 file changed, 56 insertions(+)
 create mode 100644 Universal/Docs/DeclareStatements/BlockModeStandard.xml

diff --git a/Universal/Docs/DeclareStatements/BlockModeStandard.xml b/Universal/Docs/DeclareStatements/BlockModeStandard.xml
new file mode 100644
index 00000000..a64c7549
--- /dev/null
+++ b/Universal/Docs/DeclareStatements/BlockModeStandard.xml
@@ -0,0 +1,56 @@
+<?xml version="1.0"?>
+<documentation xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:noNamespaceSchemaLocation="https://phpcsstandards.github.io/PHPCSDevTools/phpcsdocs.xsd"
+    title="Declare Statements Block Mode"
+    >
+    <standard>
+    <![CDATA[
+    Defines the block mode usage of declare directives.
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: Declare statement written in non-block mode.">
+        <![CDATA[
+declare(strict_types=1);
+
+declare(encoding='utf-8');
+
+declare(ticks=10):
+	// Code.
+enddeclare;
+        ]]>
+        </code>
+        <code title="Invalid: Declare statement written with curly braces or alternative syntax.">
+        <![CDATA[
+declare(encoding='ISO-8859-1', ticks=1) {
+    // Code.
+}
+
+declare(encoding='ISO-8859-1', ticks=10):
+    declare(encoding='utf-8'):
+    // Code.
+    enddeclare;
+enddeclare;
+        ]]>
+        </code>
+    </code_comparison>
+    <standard>
+    <![CDATA[
+        strict_types declaration directive mustn't be written using curly braces, or with alternative syntax.
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: strict_types written without curly braces.">
+        <![CDATA[
+declare(strict_types=1);
+        ]]>
+        </code>
+        <code title="Invalid: strict_types written using alternative syntax/curly braces.">
+        <![CDATA[
+declare(strict_types=1, ticks=1) <em>{</em>
+   // Code.
+<em>}</em>
+        ]]>
+        </code>
+    </code_comparison>
+</documentation>