Date: Wed, 21 May 2014 21:30:00 GMT From: Mark Linimon <linimon@lonesome.com> To: freebsd-doc@FreeBSD.org Subject: Re: docs/188786: Bug in inet(3) man page (inet_aton()) Message-ID: <201405212130.s4LLU0HO016441@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/188786; it has been noted by GNATS. From: Mark Linimon <linimon@lonesome.com> To: bug-followup@FreeBSD.org Cc: Subject: Re: docs/188786: Bug in inet(3) man page (inet_aton()) Date: Wed, 21 May 2014 16:21:16 -0500 ----- Forwarded message from "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com> ----- Date: Sat, 17 May 2014 07:30:18 +0200 From: "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com> To: bjk@freebsd.org Cc: freebsd-doc@freebsd.org Subject: Re: docs/188786: Bug in inet(3) man page (inet_aton()) Ben, Okay -- I see what you mean--I was focused on that one piece, and didn't note the other uses of "network address". I think that what makes the page a little confusing is that it uses both terms "Internet address" and "network address" without making it clear that they are synonymous (and thus leaving the potential for the reader to think they are not). This might not normally be problematic, but given that the page is also talking about the 'network' and 'host' components of the address, there is scope for confusion. Not a big thing, I guess, but FWIW that's the confusion that I tried to avoid in the Linux man page by using the term "binary address"; see http://man7.org/linux/man-pages/man3/inet.3.html#DESCRIPTION Cheers, Michael ----- End forwarded message -----
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201405212130.s4LLU0HO016441>