Module Name:    src
Committed By:   rillig
Date:           Fri Apr 14 16:53:14 UTC 2023

Modified Files:
        src/share/misc: style

Log Message:
style: don't require sorting variables in functions

Sorting the variables by size would be platform-dependent and thus is
not possible.

Sorting the variables alphabetically may or may not make the code easier
to read, and the example given below that rule doesn't follow it,
otherwise the correct order would be 'eight, eleven, nine, ten,
thirteen, twelve'.

https://mail-index.netbsd.org/tech-userlevel/2023/04/11/msg013749.html


To generate a diff of this commit:
cvs rdiff -u -r1.70 -r1.71 src/share/misc/style

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/misc/style
diff -u src/share/misc/style:1.70 src/share/misc/style:1.71
--- src/share/misc/style:1.70	Tue Apr 11 14:22:10 2023
+++ src/share/misc/style	Fri Apr 14 16:53:13 2023
@@ -1,4 +1,4 @@
-/* $NetBSD: style,v 1.70 2023/04/11 14:22:10 riastradh Exp $ */
+/* $NetBSD: style,v 1.71 2023/04/14 16:53:13 rillig Exp $ */
 
 /*
  * The revision control tag appears first, with a blank line after it.
@@ -30,7 +30,7 @@
 #include <sys/cdefs.h>
 __COPYRIGHT("@(#) Copyright (c) 2008\
  The NetBSD Foundation, inc. All rights reserved.");
-__RCSID("$NetBSD: style,v 1.70 2023/04/11 14:22:10 riastradh Exp $");
+__RCSID("$NetBSD: style,v 1.71 2023/04/14 16:53:13 rillig Exp $");
 
 /*
  * VERY important single-line comments look like this.
@@ -353,10 +353,10 @@ static char *
 function(int a1, int a2, float fl, int a4)
 {
 	/*
-	 * When declaring variables in functions declare them sorted by size,
-	 * then in alphabetical order; multiple ones per line are okay.
+	 * When declaring variables in functions, multiple variables per line
+	 * are okay. If a line overflows reuse the type keyword.
+	 *
 	 * Function prototypes should go in the include file "extern.h".
-	 * If a line overflows reuse the type keyword.
 	 *
 	 * Avoid initializing variables in the declarations; move
 	 * declarations next to their first use, and initialize

Reply via email to