From owner-svn-src-head@freebsd.org Wed May 3 10:57:17 2017 Return-Path: Delivered-To: svn-src-head@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 E2866D5B51A; Wed, 3 May 2017 10:57:17 +0000 (UTC) (envelope-from brde@optusnet.com.au) Received: from mail107.syd.optusnet.com.au (mail107.syd.optusnet.com.au [211.29.132.53]) by mx1.freebsd.org (Postfix) with ESMTP id 9AAA0C59; Wed, 3 May 2017 10:57:16 +0000 (UTC) (envelope-from brde@optusnet.com.au) Received: from besplex.bde.org (c122-106-153-191.carlnfd1.nsw.optusnet.com.au [122.106.153.191]) by mail107.syd.optusnet.com.au (Postfix) with ESMTPS id BF8B4D4A0F3; Wed, 3 May 2017 20:57:13 +1000 (AEST) Date: Wed, 3 May 2017 20:57:10 +1000 (EST) From: Bruce Evans X-X-Sender: bde@besplex.bde.org To: Konstantin Belousov cc: Bruce Evans , emaste@freebsd.org, src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: Re: svn commit: r317681 - head/share/man/man7 In-Reply-To: <20170503100632.GQ1622@kib.kiev.ua> Message-ID: <20170503203449.E1771@besplex.bde.org> References: <201705021452.v42EqZSB010115@repo.freebsd.org> <20170503013818.F2099@besplex.bde.org> <20170502174455.GJ1622@kib.kiev.ua> <20170503035045.Q2870@besplex.bde.org> <20170502194525.GL1622@kib.kiev.ua> <20170503153946.M910@besplex.bde.org> <20170503100632.GQ1622@kib.kiev.ua> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Optus-CM-Score: 0 X-Optus-CM-Analysis: v=2.2 cv=KeqiiUQD c=1 sm=1 tr=0 a=Tj3pCpwHnMupdyZSltBt7Q==:117 a=Tj3pCpwHnMupdyZSltBt7Q==:17 a=kj9zAlcOel0A:10 a=ln2-go5XBsRzc8yLV5wA:9 a=CjuIK1q_8ugA:10 X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 03 May 2017 10:57:18 -0000 On Wed, 3 May 2017, Konstantin Belousov wrote: > On Wed, May 03, 2017 at 04:19:08PM +1000, Bruce Evans wrote: >> On Tue, 2 May 2017, Konstantin Belousov wrote: >>> +.Pp >>> +.Sy time_t >>> +is always signed, it is 64-bits everywere except on i386 and 32-bit powerpc. >> >> Change "is always" to "On all supported arches" as elsewhere. >> >> "everywhere" >> >> "everywhere" is redundant. > Ok. > >> >> The whole second clause is redundant. Remove it. Leave it to the reader >> to notice that the table has more 8's than 4's, and where the 4's are. > No, this is one of the important reasons why this narrative text added > at all. Why? You just added time_t to the table. It needs to be described twice less than most types. Now I don't like the indirection long -> sizeof(void *) in the first table. This is the only place where the size is not given as a literal. There used to be space in the second table to give the size of long explicitly. Now the space is used for time_t. It doesn't belong in the same table, since it is not a basic type. Also, intptr_t and intmax_t are not in the tables. > diff --git a/share/man/man7/arch.7 b/share/man/man7/arch.7 > index 47a72a1986d..62781430329 100644 > --- a/share/man/man7/arch.7 > +++ b/share/man/man7/arch.7 > @@ -36,8 +36,9 @@ > Differences between CPU architectures and platforms supported by > .Fx . > .Pp > +If not explicitly mentioned, sizes are in bytes. The first clause is redundant. There are no explicit mentions of non-byte sizes. > .Ss Type sizes > -On all supported architectures, > +On all supported architectures: I see a further problem with this clause. It is separated from the table that it applies to, by both indentation and a blank line, so it appears to apply to the second table also. Later sections don't have a blank line where they reasonably could. They start with a section header, then no blank line between that and the single table in the section. Bruce