| lists.openwall.net | lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC | |
|
Open Source and information security mailing list archives
| ||
|
Message-ID: <1328391283.7008.17.camel@joe2Laptop> Date: Sat, 04 Feb 2012 13:34:43 -0800 From: Joe Perches <joe@...ches.com> To: David Miller <davem@...emloft.net> Cc: shawn.lu@...csson.com, eric.dumazet@...il.com, netdev@...r.kernel.org, xiaoclu@...il.com, Randy Dunlap <rdunlap@...otime.net> Subject: [PATCH] CodingStyle: Add net and drivers/net preferred commenting style Perhaps adding something to CodingStyle is useful? --- Documentation/CodingStyle | 8 ++++++++ 1 files changed, 8 insertions(+), 0 deletions(-) diff --git a/Documentation/CodingStyle b/Documentation/CodingStyle index 2b90d32..65e82e4 100644 --- a/Documentation/CodingStyle +++ b/Documentation/CodingStyle @@ -454,6 +454,14 @@ The preferred style for long (multi-line) comments is: * with beginning and ending almost-blank lines. */ +Unless the files are in net or drivers/net where David Miller +prefers the vertically shorter: + + /* This is the preferred style for multi-line + * comments in the net and drivers/net directories. + * Please use it consistently. + */ + It's also important to comment data, whether they are basic types or derived types. To this end, use just one data declaration per line (no commas for multiple data declarations). This leaves you room for a small comment on each -- To unsubscribe from this list: send the line "unsubscribe netdev" in the body of a message to majordomo@...r.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html
Powered by blists - more mailing lists