<div dir="ltr">Hello,<br>I am facing a problem while creating the configuration. I am trying to make a clang-format that formats codes without changing any codebases. Here is the question:<br><br>clang-format related config:<br>...<br>BraceWrapping:<br>        AfterFunction: true<br>...<br><br>If the configuration supports braces after function, then MACRO's formats fail. <div><br></div><div>An example of the formatted MACRO is given below:<br>...<br>#define RTE_RX_OFFLOAD_BIT2STR(_name)              \<br>       {                                          \<br>...<br><br>If the AfterFunction is false, the functions' formats fail; here is a formatted example.<br><div>...<br> if (devargs_str == NULL) {<br>...<br><br>I will send the current configuration as v2. You can test it. <br><br><br></div></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Mon, Apr 29, 2024 at 6:43 PM Stephen Hemminger <<a href="mailto:stephen@networkplumber.org">stephen@networkplumber.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">On Mon, 29 Apr 2024 14:32:43 +0100<br>
Ferruh Yigit <<a href="mailto:ferruh.yigit@amd.com" target="_blank">ferruh.yigit@amd.com</a>> wrote:<br>
<br>
> On 4/29/2024 2:04 PM, Abdullah Ömer Yamaç wrote:<br>
> > clang-format is a tool to format C/C++/Objective-C code. It can be used<br>
> > to reformat code to match a given coding style, or to ensure that code<br>
> > adheres to a specific coding style. It helps to maintain a consistent<br>
> > coding style across the DPDK codebase.<br>
> > <br>
> > .clang-format file overrides the default style options provided by<br>
> > clang-format and large set of IDEs and text editors support it.<br>
> > <br>
> > Signed-off-by: Abdullah Ömer Yamaç <<a href="mailto:aomeryamac@gmail.com" target="_blank">aomeryamac@gmail.com</a>><br>
> >  <br>
> <br>
> Overall +1 to have a format file, specially to help non-frequent<br>
> contributors.<br>
> <br>
> 1. Some options are failing for me [1], I don't know if it requires a<br>
> specific version of clang-format<br>
> <br>
> 2. Current options are not fully aligned with coding convention, it is<br>
> easier to see what is not compatible by running the tool on an existing<br>
> file [2].<br>
> we need to fix them.<br>
> <br>
> <br>
> <br>
> [1]<br>
> `clang-format -i ./lib/ethdev/rte_ethdev.c`<br>
> a.<br>
> /home/amd/development/dpdk-next-net/./.clang-format:28:1: error: unknown<br>
> key 'Whitespace'<br>
> Whitespace:<br>
> ^~~~~~~~~~<br>
> Error reading /home/amd/development/dpdk-next-net/./.clang-format:<br>
> Invalid argument<br>
> <br>
> b.<br>
> /home/amd/development/dpdk-next-net/./.clang-format:12:1: error: unknown<br>
> key 'EndOfLine'<br>
> EndOfLine: lf<br>
> ^~~~~~~~~<br>
> Error reading /home/amd/development/dpdk-next-net/./.clang-format:<br>
> Invalid argument<br>
> <br>
> c.<br>
> /home/amd/development/dpdk-next-net/./.clang-format:15:1: error: unknown<br>
> key 'File'<br>
> File:<br>
> ^~~~<br>
> Error reading /home/amd/development/dpdk-next-net/./.clang-format:<br>
> Invalid argument<br>
> <br>
> <br>
> <br>
> [2]<br>
> `clang-format -i ./lib/ethdev/rte_ethdev.c` (with failing part commented<br>
> out)<br>
> `git diff`<br>
> <br>
> A few diff samples to fix at first glance:<br>
> ```<br>
>  static const struct rte_eth_xstats_name_off eth_dev_txq_stats_strings[] = {<br>
>  -       {"packets", offsetof(struct rte_eth_stats, q_opackets)},<br>
>  -       {"bytes", offsetof(struct rte_eth_stats, q_obytes)},<br>
>  +    {"packets", offsetof(struct rte_eth_stats, q_opackets)},<br>
>  +    {"bytes", offsetof(struct rte_eth_stats, q_obytes)},<br>
>  };<br>
> ```<br>
> <br>
> ```<br>
>  -enum {<br>
>  -       STAT_QMAP_TX = 0,<br>
>  -       STAT_QMAP_RX<br>
>  -};<br>
>  +enum { STAT_QMAP_TX = 0, STAT_QMAP_RX };<br>
> ```<br>
> <br>
> ```<br>
>  -int<br>
>  -rte_eth_iterator_init(struct rte_dev_iterator *iter, const char<br>
> *devargs_str)<br>
>  +int rte_eth_iterator_init(struct rte_dev_iterator *iter, const char<br>
> *devargs_str)<br>
> ```<br>
> <br>
> ```<br>
>          RTE_ETH_FOREACH_DEV(p)<br>
<br>
Add this<br>
<br>
# Take from<br>
# <br>
# git grep -h '^#define [^[:space:]]*FOREACH[^[:space:]]*(' lib/ \<br>
#  | sed "s,^#define \([^[:space:]]*FOREACH[^[:space:]]*\)(.*$,  - '\1'," \<br>
#  | LC_ALL=C sort -u<br>
ForeachMacros: <br>
 - 'CIRBUF_FOREACH'<br>
  - 'RTE_BBDEV_FOREACH'<br>
  - 'RTE_DEV_FOREACH'<br>
  - 'RTE_DMA_FOREACH_DEV'<br>
  - 'RTE_EAL_DEVARGS_FOREACH'<br>
  - 'RTE_ETH_FOREACH_DEV'<br>
  - 'RTE_ETH_FOREACH_DEV_OF'<br>
  - 'RTE_ETH_FOREACH_DEV_OWNED_BY'<br>
  - 'RTE_ETH_FOREACH_DEV_SIBLING'<br>
  - 'RTE_ETH_FOREACH_MATCHING_DEV'<br>
  - 'RTE_ETH_FOREACH_VALID_DEV'<br>
  - 'RTE_GPU_FOREACH'<br>
  - 'RTE_GPU_FOREACH_CHILD'<br>
  - 'RTE_GPU_FOREACH_PARENT'<br>
  - 'RTE_LCORE_FOREACH'<br>
  - 'RTE_LCORE_FOREACH_WORKER'<br>
  - 'RTE_TAILQ_FOREACH'<br>
  - 'RTE_TAILQ_FOREACH_SAFE'<br>
<br>
<br>
</blockquote></div>