DPDK patches and discussions
 help / color / mirror / Atom feed
* [dpdk-dev] [PATCH] editorconfig: bump line length to 100
@ 2021-10-20 13:48 Bruce Richardson
  2021-10-20 13:57 ` Andrew Rybchenko
  2021-10-20 14:26 ` [dpdk-dev] [PATCH v2] devtools: clarify that lines up to 100 characters are ok Bruce Richardson
  0 siblings, 2 replies; 11+ messages in thread
From: Bruce Richardson @ 2021-10-20 13:48 UTC (permalink / raw)
  To: dev; +Cc: Bruce Richardson

Since we allow line lengths of up to 100, adjust the editorconfig to use
that value, to save editors (such as vim) from automatically wrapping
lines at 80 characters when typing.

Since python checkers all seem to expect 79 character lines max, add for
python only a 79-char max line length.

Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
---
 .editorconfig | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.editorconfig b/.editorconfig
index 5101630c8c..ab41c95085 100644
--- a/.editorconfig
+++ b/.editorconfig
@@ -11,11 +11,12 @@ trim_trailing_whitespace = true
 charset = utf-8
 indent_style = tab
 tab_width = 8
-max_line_length = 80
+max_line_length = 100
 
 [*.py]
 indent_style = space
 indent_size = 4
+max_line_length = 79
 
 [meson.build]
 indent_style = space
-- 
2.30.2


^ permalink raw reply	[flat|nested] 11+ messages in thread

* Re: [dpdk-dev] [PATCH] editorconfig: bump line length to 100
  2021-10-20 13:48 [dpdk-dev] [PATCH] editorconfig: bump line length to 100 Bruce Richardson
@ 2021-10-20 13:57 ` Andrew Rybchenko
  2021-10-20 14:11   ` Bruce Richardson
  2021-10-20 14:14   ` Bruce Richardson
  2021-10-20 14:26 ` [dpdk-dev] [PATCH v2] devtools: clarify that lines up to 100 characters are ok Bruce Richardson
  1 sibling, 2 replies; 11+ messages in thread
From: Andrew Rybchenko @ 2021-10-20 13:57 UTC (permalink / raw)
  To: Bruce Richardson, dev

On 10/20/21 4:48 PM, Bruce Richardson wrote:
> Since we allow line lengths of up to 100, adjust the editorconfig to use
> that value, to save editors (such as vim) from automatically wrapping
> lines at 80 characters when typing.

DPDK_CHECKPATCH_LINE_LENGTH default is 80 in
devtools/checkpatches.sh

> 
> Since python checkers all seem to expect 79 character lines max, add for
> python only a 79-char max line length.
> 
> Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
> ---
>  .editorconfig | 3 ++-
>  1 file changed, 2 insertions(+), 1 deletion(-)
> 
> diff --git a/.editorconfig b/.editorconfig
> index 5101630c8c..ab41c95085 100644
> --- a/.editorconfig
> +++ b/.editorconfig
> @@ -11,11 +11,12 @@ trim_trailing_whitespace = true
>  charset = utf-8
>  indent_style = tab
>  tab_width = 8
> -max_line_length = 80
> +max_line_length = 100
>  
>  [*.py]
>  indent_style = space
>  indent_size = 4
> +max_line_length = 79
>  
>  [meson.build]
>  indent_style = space
> 


^ permalink raw reply	[flat|nested] 11+ messages in thread

* Re: [dpdk-dev] [PATCH] editorconfig: bump line length to 100
  2021-10-20 13:57 ` Andrew Rybchenko
@ 2021-10-20 14:11   ` Bruce Richardson
  2021-10-20 14:14   ` Bruce Richardson
  1 sibling, 0 replies; 11+ messages in thread
From: Bruce Richardson @ 2021-10-20 14:11 UTC (permalink / raw)
  To: Andrew Rybchenko; +Cc: dev

On Wed, Oct 20, 2021 at 04:57:41PM +0300, Andrew Rybchenko wrote:
> On 10/20/21 4:48 PM, Bruce Richardson wrote:
> > Since we allow line lengths of up to 100, adjust the editorconfig to use
> > that value, to save editors (such as vim) from automatically wrapping
> > lines at 80 characters when typing.
> 
> DPDK_CHECKPATCH_LINE_LENGTH default is 80 in
> devtools/checkpatches.sh
> 

Yes, but all the CIs run with it set to 100.


^ permalink raw reply	[flat|nested] 11+ messages in thread

* Re: [dpdk-dev] [PATCH] editorconfig: bump line length to 100
  2021-10-20 13:57 ` Andrew Rybchenko
  2021-10-20 14:11   ` Bruce Richardson
@ 2021-10-20 14:14   ` Bruce Richardson
  1 sibling, 0 replies; 11+ messages in thread
From: Bruce Richardson @ 2021-10-20 14:14 UTC (permalink / raw)
  To: Andrew Rybchenko; +Cc: dev

On Wed, Oct 20, 2021 at 04:57:41PM +0300, Andrew Rybchenko wrote:
> On 10/20/21 4:48 PM, Bruce Richardson wrote:
> > Since we allow line lengths of up to 100, adjust the editorconfig to use
> > that value, to save editors (such as vim) from automatically wrapping
> > lines at 80 characters when typing.
> 
> DPDK_CHECKPATCH_LINE_LENGTH default is 80 in
> devtools/checkpatches.sh
> 
I'll do a v2 with that changed in it too, just to keep things consistent.
It better reflects the state of reality in the code base.

/Bruce

^ permalink raw reply	[flat|nested] 11+ messages in thread

* [dpdk-dev] [PATCH v2] devtools: clarify that lines up to 100 characters are ok
  2021-10-20 13:48 [dpdk-dev] [PATCH] editorconfig: bump line length to 100 Bruce Richardson
  2021-10-20 13:57 ` Andrew Rybchenko
@ 2021-10-20 14:26 ` Bruce Richardson
  2021-10-20 14:28   ` Andrew Rybchenko
                     ` (3 more replies)
  1 sibling, 4 replies; 11+ messages in thread
From: Bruce Richardson @ 2021-10-20 14:26 UTC (permalink / raw)
  To: dev; +Cc: Andrew Rybchenko, Bruce Richardson

Since we allow line lengths of up to 100, and the CI checkpatches job
only check for that amount, the rest of our tooling and docs should
reflect this reality. Therefore we can:

* adjust the editorconfig to use that value, to save editors (e.g. vim)
  from automatically wrapping lines at 80 characters when typing.
  [Since python checkers all seem to expect 79 character lines max, add
  for python only a 79-char max line length.]

* change the default line length setting in checkpatches script to 100
  so as it matches CI and pre-merge checks.

* update the docs to clarify that while 80 chars is recommended, up to
  100 characters is acceptable.

Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
---
V2: update the checkpatches default and the docs.

---
 .editorconfig                            | 3 ++-
 devtools/checkpatches.sh                 | 2 +-
 doc/guides/contributing/coding_style.rst | 2 +-
 3 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/.editorconfig b/.editorconfig
index 5101630c8c..ab41c95085 100644
--- a/.editorconfig
+++ b/.editorconfig
@@ -11,11 +11,12 @@ trim_trailing_whitespace = true
 charset = utf-8
 indent_style = tab
 tab_width = 8
-max_line_length = 80
+max_line_length = 100
 
 [*.py]
 indent_style = space
 indent_size = 4
+max_line_length = 79
 
 [meson.build]
 indent_style = space
diff --git a/devtools/checkpatches.sh b/devtools/checkpatches.sh
index c314d83a29..205b8a52bf 100755
--- a/devtools/checkpatches.sh
+++ b/devtools/checkpatches.sh
@@ -15,7 +15,7 @@ VALIDATE_NEW_API=$(dirname $(readlink -f $0))/check-symbol-change.sh
 # Codespell can also be enabled by setting DPDK_CHECKPATCH_CODESPELL to a valid path
 # to a dictionary.txt file if dictionary.txt is not in the default location.
 codespell=${DPDK_CHECKPATCH_CODESPELL:-enable}
-length=${DPDK_CHECKPATCH_LINE_LENGTH:-80}
+length=${DPDK_CHECKPATCH_LINE_LENGTH:-100}
 
 # override default Linux options
 options="--no-tree"
diff --git a/doc/guides/contributing/coding_style.rst b/doc/guides/contributing/coding_style.rst
index b27b5fcfdb..1ce5d00e36 100644
--- a/doc/guides/contributing/coding_style.rst
+++ b/doc/guides/contributing/coding_style.rst
@@ -27,7 +27,7 @@ Line length is recommended to be not more than 80 characters, including comments
 .. note::
 
 	The above is recommendation, and not a hard limit.
-	However, it is expected that the recommendations should be followed in all but the rarest situations.
+	Generally, line lengths up to 100 characters are acceptable in the code.
 
 C Comment Style
 ---------------
-- 
2.32.0


^ permalink raw reply	[flat|nested] 11+ messages in thread

* Re: [dpdk-dev] [PATCH v2] devtools: clarify that lines up to 100 characters are ok
  2021-10-20 14:26 ` [dpdk-dev] [PATCH v2] devtools: clarify that lines up to 100 characters are ok Bruce Richardson
@ 2021-10-20 14:28   ` Andrew Rybchenko
  2021-10-22  0:11     ` Jerin Jacob
  2021-10-22  8:21   ` Xia, Chenbo
                     ` (2 subsequent siblings)
  3 siblings, 1 reply; 11+ messages in thread
From: Andrew Rybchenko @ 2021-10-20 14:28 UTC (permalink / raw)
  To: Bruce Richardson, dev

On 10/20/21 5:26 PM, Bruce Richardson wrote:
> Since we allow line lengths of up to 100, and the CI checkpatches job
> only check for that amount, the rest of our tooling and docs should
> reflect this reality. Therefore we can:
> 
> * adjust the editorconfig to use that value, to save editors (e.g. vim)
>   from automatically wrapping lines at 80 characters when typing.
>   [Since python checkers all seem to expect 79 character lines max, add
>   for python only a 79-char max line length.]
> 
> * change the default line length setting in checkpatches script to 100
>   so as it matches CI and pre-merge checks.
> 
> * update the docs to clarify that while 80 chars is recommended, up to
>   100 characters is acceptable.
> 
> Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>

Acked-by: Andrew Rybchenko <andrew.rybchenko@oktetlabs.ru>


^ permalink raw reply	[flat|nested] 11+ messages in thread

* Re: [dpdk-dev] [PATCH v2] devtools: clarify that lines up to 100 characters are ok
  2021-10-20 14:28   ` Andrew Rybchenko
@ 2021-10-22  0:11     ` Jerin Jacob
  2021-11-25 10:51       ` Thomas Monjalon
  0 siblings, 1 reply; 11+ messages in thread
From: Jerin Jacob @ 2021-10-22  0:11 UTC (permalink / raw)
  To: Andrew Rybchenko; +Cc: Bruce Richardson, dpdk-dev

On Wed, Oct 20, 2021 at 7:58 PM Andrew Rybchenko
<andrew.rybchenko@oktetlabs.ru> wrote:
>
> On 10/20/21 5:26 PM, Bruce Richardson wrote:
> > Since we allow line lengths of up to 100, and the CI checkpatches job
> > only check for that amount, the rest of our tooling and docs should
> > reflect this reality. Therefore we can:
> >
> > * adjust the editorconfig to use that value, to save editors (e.g. vim)
> >   from automatically wrapping lines at 80 characters when typing.
> >   [Since python checkers all seem to expect 79 character lines max, add
> >   for python only a 79-char max line length.]
> >
> > * change the default line length setting in checkpatches script to 100
> >   so as it matches CI and pre-merge checks.
> >
> > * update the docs to clarify that while 80 chars is recommended, up to
> >   100 characters is acceptable.
> >
> > Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
>
> Acked-by: Andrew Rybchenko <andrew.rybchenko@oktetlabs.ru>

Acked-by: Jerin Jacob <jerinj@marvell.com>


>

^ permalink raw reply	[flat|nested] 11+ messages in thread

* Re: [dpdk-dev] [PATCH v2] devtools: clarify that lines up to 100 characters are ok
  2021-10-20 14:26 ` [dpdk-dev] [PATCH v2] devtools: clarify that lines up to 100 characters are ok Bruce Richardson
  2021-10-20 14:28   ` Andrew Rybchenko
@ 2021-10-22  8:21   ` Xia, Chenbo
  2021-10-26  0:30   ` fengchengwen
  2021-10-28 13:14   ` Walsh, Conor
  3 siblings, 0 replies; 11+ messages in thread
From: Xia, Chenbo @ 2021-10-22  8:21 UTC (permalink / raw)
  To: Richardson, Bruce, dev; +Cc: Andrew Rybchenko, Richardson, Bruce

> -----Original Message-----
> From: dev <dev-bounces@dpdk.org> On Behalf Of Bruce Richardson
> Sent: Wednesday, October 20, 2021 10:26 PM
> To: dev@dpdk.org
> Cc: Andrew Rybchenko <andrew.rybchenko@oktetlabs.ru>; Richardson, Bruce
> <bruce.richardson@intel.com>
> Subject: [dpdk-dev] [PATCH v2] devtools: clarify that lines up to 100
> characters are ok
> 
> Since we allow line lengths of up to 100, and the CI checkpatches job
> only check for that amount, the rest of our tooling and docs should
> reflect this reality. Therefore we can:
> 
> * adjust the editorconfig to use that value, to save editors (e.g. vim)
>   from automatically wrapping lines at 80 characters when typing.
>   [Since python checkers all seem to expect 79 character lines max, add
>   for python only a 79-char max line length.]
> 
> * change the default line length setting in checkpatches script to 100
>   so as it matches CI and pre-merge checks.
> 
> * update the docs to clarify that while 80 chars is recommended, up to
>   100 characters is acceptable.
> 
> Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
> ---
> 2.32.0

Glad to see this :)

Acked-by: Chenbo Xia <chenbo.xia@intel.com>

^ permalink raw reply	[flat|nested] 11+ messages in thread

* Re: [dpdk-dev] [PATCH v2] devtools: clarify that lines up to 100 characters are ok
  2021-10-20 14:26 ` [dpdk-dev] [PATCH v2] devtools: clarify that lines up to 100 characters are ok Bruce Richardson
  2021-10-20 14:28   ` Andrew Rybchenko
  2021-10-22  8:21   ` Xia, Chenbo
@ 2021-10-26  0:30   ` fengchengwen
  2021-10-28 13:14   ` Walsh, Conor
  3 siblings, 0 replies; 11+ messages in thread
From: fengchengwen @ 2021-10-26  0:30 UTC (permalink / raw)
  To: Bruce Richardson, dev; +Cc: Andrew Rybchenko

On 2021/10/20 22:26, Bruce Richardson wrote:
> Since we allow line lengths of up to 100, and the CI checkpatches job
> only check for that amount, the rest of our tooling and docs should
> reflect this reality. Therefore we can:
> 
> * adjust the editorconfig to use that value, to save editors (e.g. vim)
>   from automatically wrapping lines at 80 characters when typing.
>   [Since python checkers all seem to expect 79 character lines max, add
>   for python only a 79-char max line length.]
> 
> * change the default line length setting in checkpatches script to 100
>   so as it matches CI and pre-merge checks.
> 
> * update the docs to clarify that while 80 chars is recommended, up to
>   100 characters is acceptable.
> 
> Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>

Acked-by: Chengwen Feng <fengchengwen@huawei.com>


^ permalink raw reply	[flat|nested] 11+ messages in thread

* Re: [dpdk-dev] [PATCH v2] devtools: clarify that lines up to 100 characters are ok
  2021-10-20 14:26 ` [dpdk-dev] [PATCH v2] devtools: clarify that lines up to 100 characters are ok Bruce Richardson
                     ` (2 preceding siblings ...)
  2021-10-26  0:30   ` fengchengwen
@ 2021-10-28 13:14   ` Walsh, Conor
  3 siblings, 0 replies; 11+ messages in thread
From: Walsh, Conor @ 2021-10-28 13:14 UTC (permalink / raw)
  To: Richardson, Bruce, dev; +Cc: Andrew Rybchenko, Richardson, Bruce

> From: dev <dev-bounces@dpdk.org> On Behalf Of Bruce Richardson
> Sent: Wednesday 20 October 2021 15:26
> To: dev@dpdk.org
> Cc: Andrew Rybchenko <andrew.rybchenko@oktetlabs.ru>; Richardson,
> Bruce <bruce.richardson@intel.com>
> Subject: [dpdk-dev] [PATCH v2] devtools: clarify that lines up to 100
> characters are ok
> 
> Since we allow line lengths of up to 100, and the CI checkpatches job
> only check for that amount, the rest of our tooling and docs should
> reflect this reality. Therefore we can:
> 
> * adjust the editorconfig to use that value, to save editors (e.g. vim)
>   from automatically wrapping lines at 80 characters when typing.
>   [Since python checkers all seem to expect 79 character lines max, add
>   for python only a 79-char max line length.]
> 
> * change the default line length setting in checkpatches script to 100
>   so as it matches CI and pre-merge checks.
> 
> * update the docs to clarify that while 80 chars is recommended, up to
>   100 characters is acceptable.
> 
> Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
> ---

I think it would be great to have clarity around this, since it seems to already be allowed.
Acked-by: Conor Walsh <conor.walsh@intel.com>

^ permalink raw reply	[flat|nested] 11+ messages in thread

* Re: [dpdk-dev] [PATCH v2] devtools: clarify that lines up to 100 characters are ok
  2021-10-22  0:11     ` Jerin Jacob
@ 2021-11-25 10:51       ` Thomas Monjalon
  0 siblings, 0 replies; 11+ messages in thread
From: Thomas Monjalon @ 2021-11-25 10:51 UTC (permalink / raw)
  To: Bruce Richardson
  Cc: Andrew Rybchenko, dev, Jerin Jacob, chenbo.xia, fengchengwen,
	conor.walsh, david.marchand

22/10/2021 02:11, Jerin Jacob:
> On Wed, Oct 20, 2021 at 7:58 PM Andrew Rybchenko
> <andrew.rybchenko@oktetlabs.ru> wrote:
> > On 10/20/21 5:26 PM, Bruce Richardson wrote:
> > > Since we allow line lengths of up to 100, and the CI checkpatches job
> > > only check for that amount, the rest of our tooling and docs should
> > > reflect this reality. Therefore we can:
> > >
> > > * adjust the editorconfig to use that value, to save editors (e.g. vim)
> > >   from automatically wrapping lines at 80 characters when typing.
> > >   [Since python checkers all seem to expect 79 character lines max, add
> > >   for python only a 79-char max line length.]
> > >
> > > * change the default line length setting in checkpatches script to 100
> > >   so as it matches CI and pre-merge checks.
> > >
> > > * update the docs to clarify that while 80 chars is recommended, up to
> > >   100 characters is acceptable.
> > >
> > > Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
> >
> > Acked-by: Andrew Rybchenko <andrew.rybchenko@oktetlabs.ru>
> 
> Acked-by: Jerin Jacob <jerinj@marvell.com>

Acked-by: Chenbo Xia <chenbo.xia@intel.com>
Acked-by: Chengwen Feng <fengchengwen@huawei.com>
Acked-by: Conor Walsh <conor.walsh@intel.com>

As long as we keep a preference/recommandation for 80 chars, I'm fine.
In general I like short lines, but I dislike some "forced" wrapping.
So allowing for longer lines and trusting authors to do what fits best
is a good call.

Acked-by: Thomas Monjalon <thomas@monjalon.net>

Applied, thanks.



^ permalink raw reply	[flat|nested] 11+ messages in thread

end of thread, other threads:[~2021-11-25 10:51 UTC | newest]

Thread overview: 11+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-10-20 13:48 [dpdk-dev] [PATCH] editorconfig: bump line length to 100 Bruce Richardson
2021-10-20 13:57 ` Andrew Rybchenko
2021-10-20 14:11   ` Bruce Richardson
2021-10-20 14:14   ` Bruce Richardson
2021-10-20 14:26 ` [dpdk-dev] [PATCH v2] devtools: clarify that lines up to 100 characters are ok Bruce Richardson
2021-10-20 14:28   ` Andrew Rybchenko
2021-10-22  0:11     ` Jerin Jacob
2021-11-25 10:51       ` Thomas Monjalon
2021-10-22  8:21   ` Xia, Chenbo
2021-10-26  0:30   ` fengchengwen
2021-10-28 13:14   ` Walsh, Conor

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).