[PATCH 1/1] doc: .clang-format description

[PATCH 1/1] doc: .clang-format description

[Heinrich Schuchardt]

We cannot use .clang-format without modification. For instance U-Boot
has some for each macros that Linux does not have.

Adjust the description.

Signed-off-by: Heinrich Schuchardt <heinrich.schuchardt@canonical.com>
---
 doc/develop/codingstyle.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/doc/develop/codingstyle.rst b/doc/develop/codingstyle.rst
index 2a69162fa95..26881cf3900 100644
--- a/doc/develop/codingstyle.rst
+++ b/doc/develop/codingstyle.rst
@@ -80,8 +80,10 @@ Code Formatting with clang-format
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 U-Boot provides a `.clang-format` configuration file that was copied directly
-from the Linux kernel without any modifications, ensuring complete compatibility
-with kernel coding standards. Here are common ways to use clang-format:
+from the Linux kernel, ensuring complete compatibility with kernel coding
+standards.
+
+Here are common ways to use clang-format:
 
 **Basic usage for single files:**
 
-- 
2.53.0

Re: [PATCH 1/1] doc: .clang-format description

[Heinrich Schuchardt]

On 4/24/26 15:10, Quentin Schulz wrote:
> Hi Heinrich,
> 
> On 4/24/26 3:05 PM, Heinrich Schuchardt wrote:
>> We cannot use .clang-format without modification. For instance U-Boot
>> has some for each macros that Linux does not have.
>>
> 
> Uh?
> 
> sha256sum ../u-boot/.clang-format <(git show v6.16:.clang-format)
> a7a2d4f21d9ff4696498077b71b5589a44b95697eb80c013a94768d05f7d8b54 ../u- 
> boot/.clang-format
> a7a2d4f21d9ff4696498077b71b5589a44b95697eb80c013a94768d05f7d8b54 /proc/ 
> self/fd/11
> 
> Cheers,
> Quentin

Try to format anything with one of these macros:

+  # U-Boot specific
+  - 'alist_for_each'
+  - 'alist_for_each_filter'
+  - 'for_each_bl_params_node'
+  - 'ofnode_for_each_prop'
+  - 'ofnode_for_each_subnode'
+  - 'ofnode_for_each_compatible_node'
+  - 'dev_for_each_subnode'
+  - 'dev_for_each_property'
+  - 'fdt_for_each_node_by_compatible'
+  - 'for_each_console_dev'
+  - 'mtd_for_each_device'
+  - 'for_each_tpm_device'

I have created a separate patch for .clang-format but unfortunately our 
list server is down.

Best regards

Heinrich

Re: [PATCH 1/1] doc: .clang-format description

[Quentin Schulz]

Hi Heinrich,

On 4/24/26 3:05 PM, Heinrich Schuchardt wrote:
> We cannot use .clang-format without modification. For instance U-Boot
> has some for each macros that Linux does not have.
> 
> Adjust the description.
> 

Reviewed-by: Quentin Schulz <quentin.schulz@cherry.de>

Thanks!
Quentin

Re: [PATCH 1/1] doc: .clang-format description

[Mattijs Korpershoek]

Hi Heinrich,

Thank you for the patch.

On Fri, Apr 24, 2026 at 15:05, Heinrich Schuchardt <heinrich.schuchardt@canonical.com> wrote:

> We cannot use .clang-format without modification. For instance U-Boot
> has some for each macros that Linux does not have.
>
> Adjust the description.
>
> Signed-off-by: Heinrich Schuchardt <heinrich.schuchardt@canonical.com>

Reviewed-by: Mattijs Korpershoek <mkorpershoek@kernel.org>

> ---
>  doc/develop/codingstyle.rst | 6 ++++--
>  1 file changed, 4 insertions(+), 2 deletions(-)
>