Re: kern/45935: Requested change to comments in sys/param.h

[Alan Barrett <apb%cequrux.com@localhost>]

The following reply was made to PR kern/45935; it has been noted by GNATS.

From: Alan Barrett <apb%cequrux.com@localhost>
To: gnats-bugs%NetBSD.org@localhost
Cc: 
Subject: Re: kern/45935: Requested change to comments in sys/param.h
Date: Wed, 8 Feb 2012 15:19:04 +0200

 On Mon, 06 Feb 2012, kre%munnari.OZ.AU@localhost wrote:
 >+ *   #define __NetBSD_Version__ MMmmrrppzz
 >  *
 >  *   M = major version
 >  *   m = minor version; a minor number of 99 indicates current.
 >  *   r = 0 (*)
 >  *   p = patchlevel
 >+ *   z = trivia discriminator
     [...]
 >+ * For releases and other "stable" versions
 >+ *   z == version bump counter
 >+ *           incremented (from 0) if any change is included that would
 >+ *           result in a different release set (even a typo in a comment...)
 >+ *           from any previously released, or almost released, version.
 >+ *           (A version is "almost released" once it is tagged in CVS).
 
 We haven't consistently incremented the zz digits at the end of
 __NetBSD_Version__.  For example, we had:
 
 #define __NetBSD_Version__      400000000       /* NetBSD 4.0_BETA */
 #define __NetBSD_Version__      400000001       /* NetBSD 4.0_BETA2 */
 #define __NetBSD_Version__      400000002       /* NetBSD 4.0_BETA2 */
 #define __NetBSD_Version__      400000003       /* NetBSD 4.0_RC1 */
 #define __NetBSD_Version__      400000003       /* NetBSD 4.0_BETA2 */
 #define __NetBSD_Version__      400000003       /* NetBSD 4.0_RC1 */
 #define __NetBSD_Version__      400000003       /* NetBSD 4.0_RC2 */
 #define __NetBSD_Version__      400000003       /* NetBSD 4.0_RC3 */
 #define __NetBSD_Version__      400000003       /* NetBSD 4.0_RC4 */
 #define __NetBSD_Version__      400000003       /* NetBSD 4.0_RC5 */
 #define __NetBSD_Version__      400000003       /* NetBSD 4.0 */
 
 #define __NetBSD_Version__      501000000       /* NetBSD 5.1 */
 #define __NetBSD_Version__      501000000       /* NetBSD 5.1_RC1 */
 #define __NetBSD_Version__      501000000       /* NetBSD 5.1_RC2 */
 #define __NetBSD_Version__      501000000       /* NetBSD 5.1_RC3 */
 #define __NetBSD_Version__      501000000       /* NetBSD 5.1_RC4 */
 #define __NetBSD_Version__      501000000       /* NetBSD 5.1.0_PATCH */
 
 I think that similar changes in future should all get different zz digits.
 
 --apb (Alan Barrett)