Date: Wed, 30 Jan 2002 13:51:56 -0800 From: Murray Stokely <murray@FreeBSD.org> To: Peter Pentchev <roam@ringlet.net> Cc: freebsd-doc@freebsd.org Subject: Re: docs/34460: potential minor error in Developer's Handbook + mem(4) man page Message-ID: <20020130215156.GJ9395@freebsdmall.com> In-Reply-To: <200201301830.g0UIU1240223@freefall.freebsd.org> References: <200201301830.g0UIU1240223@freefall.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
Hey Peter,
Good explanation. Can you add this to the Doc Project Primer?
This should probably go near the word list.
- Murray
On Wed, Jan 30, 2002 at 10:30:01AM -0800, Peter Pentchev wrote:
> The following reply was made to PR docs/34460; it has been noted by GNATS.
>
> From: Peter Pentchev <roam@ringlet.net>
> To: Bruce Dang <bruce@research.teamxor.org>
> 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
> > <memrange.h> for various #defines, but it is actually
> > <sys/memrange.h> 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 <memrange.h>
> +.Pa <sys/memrange.h>
> .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
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020130215156.GJ9395>