docs: netdev: broaden the new vs old code formatting guidelines

Convert the "should I use new or old comment formatting" to cover
all formatting. This makes the question itself shorter.

Signed-off-by: Jakub Kicinski <kuba@kernel.org>
Reviewed-by: Florian Fainelli <f.fainelli@gmail.com>
Signed-off-by: Paolo Abeni <pabeni@redhat.com>
This commit is contained in:
Jakub Kicinski 2022-03-29 21:25:04 -07:00 committed by Paolo Abeni
parent 99eba4e5cb
commit 08767a26f0

View File

@ -183,10 +183,10 @@ it is requested that you make it look like this::
* another line of text * another line of text
*/ */
I am working in existing code that has the former comment style and not the latter. Should I submit new code in the former style or the latter? I am working in existing code which uses non-standard formatting. Which formatting should I use?
----------------------------------------------------------------------------------------------------------------------------------------------- ------------------------------------------------------------------------------------------------
Make it the latter style, so that eventually all code in the domain Make your code follow the most recent guidelines, so that eventually all code
of netdev is of this format. in the domain of netdev is in the preferred format.
I found a bug that might have possible security implications or similar. Should I mail the main netdev maintainer off-list? I found a bug that might have possible security implications or similar. Should I mail the main netdev maintainer off-list?
--------------------------------------------------------------------------------------------------------------------------- ---------------------------------------------------------------------------------------------------------------------------