From eddb0126ccf2aad22bf98c47db7d0c440b5dd52a Mon Sep 17 00:00:00 2001
From: Rodrigo Primo <rodrigosprimo@gmail.com>
Date: Fri, 4 Apr 2025 11:48:00 -0300
Subject: [PATCH 1/2] Generic/OpeningFunctionBraceBsdAllman: fix syntax errors
 in the XML doc code examples

---
 .../Docs/Functions/OpeningFunctionBraceBsdAllmanStandard.xml  | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Standards/Generic/Docs/Functions/OpeningFunctionBraceBsdAllmanStandard.xml b/src/Standards/Generic/Docs/Functions/OpeningFunctionBraceBsdAllmanStandard.xml
index 76314c5086..bb24dac0d0 100644
--- a/src/Standards/Generic/Docs/Functions/OpeningFunctionBraceBsdAllmanStandard.xml
+++ b/src/Standards/Generic/Docs/Functions/OpeningFunctionBraceBsdAllmanStandard.xml
@@ -9,14 +9,14 @@
         <![CDATA[
 function fooFunction($arg1, $arg2 = '')
 <em>{</em>
-    ...
+    // Do something
 }
         ]]>
         </code>
         <code title="Invalid: Brace on same line.">
         <![CDATA[
 function fooFunction($arg1, $arg2 = '') <em>{</em>
-    ...
+    // Do something
 }
         ]]>
         </code>

From f6473620736099a1e876ab9f0510c15a858c89da Mon Sep 17 00:00:00 2001
From: Rodrigo Primo <rodrigosprimo@gmail.com>
Date: Wed, 9 Apr 2025 11:05:56 -0300
Subject: [PATCH 2/2] Generic/OpeningFunctionBraceBsdAllman: improve XML doc

- `<documentation>` title matches the sniff name.
- Mention in the `<standard>` description that there must be no content
on the line after the opening brace and makes some other minor
adjustments to the description text.
- Improve the title of the `<code>` blocks.
---
 .../OpeningFunctionBraceBsdAllmanStandard.xml          | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/src/Standards/Generic/Docs/Functions/OpeningFunctionBraceBsdAllmanStandard.xml b/src/Standards/Generic/Docs/Functions/OpeningFunctionBraceBsdAllmanStandard.xml
index bb24dac0d0..9eea8ca801 100644
--- a/src/Standards/Generic/Docs/Functions/OpeningFunctionBraceBsdAllmanStandard.xml
+++ b/src/Standards/Generic/Docs/Functions/OpeningFunctionBraceBsdAllmanStandard.xml
@@ -1,11 +1,13 @@
-<documentation title="Opening Brace in Function Declarations">
+<documentation title="Opening Function Brace Bsd Allman">
     <standard>
     <![CDATA[
-    Function declarations follow the "BSD/Allman style". The function brace is on the line following the function declaration and is indented to the same column as the start of the function declaration.
+    Function declarations must follow the "BSD/Allman style". The opening brace is on the line
+    following the function declaration and is indented to the same column as the start of the
+    function declaration. The brace must be the last content on the line.
     ]]>
     </standard>
     <code_comparison>
-        <code title="Valid: Brace on next line.">
+        <code title="Valid: Opening brace on the next line.">
         <![CDATA[
 function fooFunction($arg1, $arg2 = '')
 <em>{</em>
@@ -13,7 +15,7 @@ function fooFunction($arg1, $arg2 = '')
 }
         ]]>
         </code>
-        <code title="Invalid: Brace on same line.">
+        <code title="Invalid: Opening brace on the same line.">
         <![CDATA[
 function fooFunction($arg1, $arg2 = '') <em>{</em>
     // Do something