From owner-freebsd-doc Wed Jan 30 10:30:12 2002 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id EE05E37B41B for ; Wed, 30 Jan 2002 10:30:01 -0800 (PST) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id g0UIU1240223; Wed, 30 Jan 2002 10:30:01 -0800 (PST) (envelope-from gnats) Date: Wed, 30 Jan 2002 10:30:01 -0800 (PST) Message-Id: <200201301830.g0UIU1240223@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Peter Pentchev Subject: Re: docs/34460: potential minor error in Developer's Handbook + mem(4) man page Reply-To: Peter Pentchev Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org The following reply was made to PR docs/34460; it has been noted by GNATS. From: Peter Pentchev To: Bruce Dang Cc: freebsd-gnats-submit@freebsd.org Subject: Re: docs/34460: potential minor error in Developer's Handbook + mem(4) man page Date: Wed, 30 Jan 2002 20:22:59 +0200 On Wed, Jan 30, 2002 at 10:05:25AM -0800, Bruce Dang wrote: > > >Number: 34460 > >Category: docs > >Synopsis: potential minor error in Developer's Handbook + mem(4) man page > >Originator: Bruce Dang > >Description: > On page 40 of the Developer's Handbook (PDF version), there's > something like "will always null terminate the string." Shouldn't > this be NUL terinated, instead of NULL (ptr). I think this came up recently in another context, and the resolution was that both "NUL-terminated" and "null-terminated" were correct, and "NULL-terminated" is definitely wrong. NUL is right in the sense of the ASCII character NUL, and 'null' is right in its semantical sense of 'zero', 'emptiness' or something like that. So, although the tide may have turned since then, I doubt it, and I think that "null terminated" would be right. > In addition to that, the mem(4) man page makes references to > for various #defines, but it is actually > that defines them... This looks genuine. Patch attached for the benefit of -doc committers. G'luck, Peter -- If there were no counterfactuals, this sentence would not have been paradoxical. Index: src/share/man/man4/mem.4 =================================================================== RCS file: /home/ncvs/src/share/man/man4/mem.4,v retrieving revision 1.13 diff -u -r1.13 mem.4 --- src/share/man/man4/mem.4 21 Jan 2002 12:09:13 -0000 1.13 +++ src/share/man/man4/mem.4 30 Jan 2002 18:21:20 -0000 @@ -77,7 +77,7 @@ calls performed on .Nm /dev/mem . Declarations and data types are to be found in -.Pa +.Pa .Pp The specific attributes, and number of programmable ranges may vary between architectures. The full set of supported attributes is: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message