From owner-svn-src-all@freebsd.org  Wed Mar 16 20:32:42 2016
Return-Path: <owner-svn-src-all@freebsd.org>
Delivered-To: svn-src-all@mailman.ysv.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 by mailman.ysv.freebsd.org (Postfix) with ESMTP id 30873AD3676;
 Wed, 16 Mar 2016 20:32:42 +0000 (UTC)
 (envelope-from glebius@FreeBSD.org)
Received: from cell.glebi.us (glebi.us [96.95.210.25])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client CN "cell.glebi.us", Issuer "cell.glebi.us" (not verified))
 by mx1.freebsd.org (Postfix) with ESMTPS id 19CF2D23;
 Wed, 16 Mar 2016 20:32:41 +0000 (UTC)
 (envelope-from glebius@FreeBSD.org)
Received: from cell.glebi.us (localhost [127.0.0.1])
 by cell.glebi.us (8.15.2/8.15.2) with ESMTPS id u2GKWffp077560
 (version=TLSv1.2 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO);
 Wed, 16 Mar 2016 13:32:41 -0700 (PDT)
 (envelope-from glebius@FreeBSD.org)
Received: (from glebius@localhost)
 by cell.glebi.us (8.15.2/8.15.2/Submit) id u2GKWfh7077559;
 Wed, 16 Mar 2016 13:32:41 -0700 (PDT)
 (envelope-from glebius@FreeBSD.org)
X-Authentication-Warning: cell.glebi.us: glebius set sender to
 glebius@FreeBSD.org using -f
Date: Wed, 16 Mar 2016 13:32:41 -0700
From: Gleb Smirnoff <glebius@FreeBSD.org>
To: Hans Petter Selasky <hselasky@FreeBSD.org>
Cc: src-committers@freebsd.org, svn-src-all@freebsd.org,
 svn-src-head@freebsd.org
Subject: Re: svn commit: r296933 - in head: share/man/man9 sys/sys
Message-ID: <20160316203241.GM1328@FreeBSD.org>
References: <201603160837.u2G8bqgr087126@repo.freebsd.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <201603160837.u2G8bqgr087126@repo.freebsd.org>
User-Agent: Mutt/1.5.24 (2015-08-30)
X-BeenThere: svn-src-all@freebsd.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: "SVN commit messages for the entire src tree \(except for &quot;
 user&quot; and &quot; projects&quot; \)" <svn-src-all.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/svn-src-all>,
 <mailto:svn-src-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-src-all/>
List-Post: <mailto:svn-src-all@freebsd.org>
List-Help: <mailto:svn-src-all-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/svn-src-all>,
 <mailto:svn-src-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 16 Mar 2016 20:32:42 -0000

On Wed, Mar 16, 2016 at 08:37:52AM +0000, Hans Petter Selasky wrote:
H> Author: hselasky
H> Date: Wed Mar 16 08:37:52 2016
H> New Revision: 296933
H> URL: https://svnweb.freebsd.org/changeset/base/296933
H> 
H> Log:
H>   Improve the implementation and documentation of the
H>   SYSCTL_COUNTER_U64_ARRAY() macro.
H>   
H>   - Add proper asserts to the SYSCTL_COUNTER_U64_ARRAY() macro that checks
H>     the size of the first element of the array.
H>   - Add an example to the counter(9) manual page how to use the
H>     SYSCTL_COUNTER_U64_ARRAY() macro.
H>   - Add some missing symbolic links for counter(9) while at it.

...

H> +.Sh EXAMPLES
H> +The following example creates a static counter array exported to
H> +userspace through a sysctl:
H> +.Bd -literal -offset indent
H> +#define MY_SIZE 8
H> +static counter_u64_t array[MY_SIZE];
H> +SYSCTL_COUNTER_U64_ARRAY(_debug, OID_AUTO, counter_array, CTLFLAG_RW,
H> +    &array[0], MY_SIZE, "Test counter array");

I always wondered what is stylistically better: array or &array[0]? I
usually prefer the former.

-- 
Totus tuus, Glebius.