From owner-freebsd-doc@FreeBSD.ORG Fri May 23 02:47:40 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id BBBB8B8; Fri, 23 May 2014 02:47:40 +0000 (UTC) Received: from dmz-mailsec-scanner-1.mit.edu (dmz-mailsec-scanner-1.mit.edu [18.9.25.12]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 32A662626; Fri, 23 May 2014 02:47:39 +0000 (UTC) X-AuditID: 1209190c-f79946d000000c3b-5c-537eb6c9b2ac Received: from mailhub-auth-4.mit.edu ( [18.7.62.39]) (using TLS with cipher AES256-SHA (256/256 bits)) (Client did not present a certificate) by dmz-mailsec-scanner-1.mit.edu (Symantec Messaging Gateway) with SMTP id 96.91.03131.9C6BE735; Thu, 22 May 2014 22:47:37 -0400 (EDT) Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11]) by mailhub-auth-4.mit.edu (8.13.8/8.9.2) with ESMTP id s4N2labj012906; Thu, 22 May 2014 22:47:36 -0400 Received: from multics.mit.edu (system-low-sipb.mit.edu [18.187.2.37]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id s4N2lYLu017528 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Thu, 22 May 2014 22:47:35 -0400 Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id s4N2lX6Q008390; Thu, 22 May 2014 22:47:33 -0400 (EDT) Date: Thu, 22 May 2014 22:47:33 -0400 (EDT) From: Benjamin Kaduk X-X-Sender: kaduk@multics.mit.edu To: "Michael Kerrisk (man-pages)" Subject: Re: docs/188786: Bug in inet(3) man page (inet_aton()) In-Reply-To: Message-ID: References: <201405170408.s4H48Xff021996@freefall.freebsd.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFmpgleLIzCtJLcpLzFFi42IRYrdT1z25rS7Y4NYZXotJc16zWpw60wUk Jjxgd2D2mPFpPovHzll32QOYorhsUlJzMstSi/TtErgytlw+zFbwhLNi7cJzzA2MT9i7GDk5 JARMJF43/oKyxSQu3FvP1sXIxSEkMJtJ4sqdq1DORkaJ3U1/2CGcQ0wSF6b+Y4RwGhglzv94 xgbSzyKgLbGseQsTiM0moCbxeG8zK8RcRYnNpyYxg9giAlYSE558A6thFtCR2DqjE2y3sIC9 RP/tXjCbUyBQ4uP8u2D1vAKOEocnPYM6o5lR4svhQ2DNokDNq/dPYYEoEpQ4OfMJC8RQS4lz f66zTWAUmoUkNQtJagEj0ypG2ZTcKt3cxMyc4tRk3eLkxLy81CJdQ73czBK91JTSTYyggOaU 5NnB+Oag0iFGAQ5GJR5eC9a6YCHWxLLiytxDjJIcTEqivHVbgEJ8SfkplRmJxRnxRaU5qcWH GCU4mJVEeH1CgXK8KYmVValF+TApaQ4WJXHet9ZWwUIC6YklqdmpqQWpRTBZGQ4OJQleG2Dk CgkWpaanVqRl5pQgpJk4OEGG8wANX7gVZHhxQWJucWY6RP4Uo6KUOG8+SEIAJJFRmgfXC0s4 rxjFgV4R5v0OUsUDTFZw3a+ABjMBDX6xsBZkcEkiQkqqgbG8wUFD96pSTuWKGe8m5jCKF6/j dJ7wdSm/1K4Dk24ahAgGSER9uykhzHt8wjLunH9hkou3291MYpvqFxEQaae+8n2h4zGF+zse B3Zr3Qnan95muvSVsthK/cwpPM/ePLu3cLO2+1H7I677dzmKpMX/XK524drSd1XJSR/n/RHQ 1fZSuHqx+pkSS3FGoqEWc1FxIgCSwpG9EwMAAA== Cc: bjk@freebsd.org, freebsd-doc@freebsd.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2014 02:47:40 -0000 Hi Michael, Sorry it took me so long to reply. I had a lot of catching up to do after BSDCan... On Sat, 17 May 2014, Michael Kerrisk (man-pages) wrote: > 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 I see how there could be confusion, and we could probably do better. I'll put taking a look at this man page in general on my todo list, but leave this PR cloesd for now. (I do remember that a lot of the functional parts of classful addressing have actually been removed from FreeBSD, but not whether this part in particular was removed. I'll have to check.) Thanks again for the submission, it's always good to get suggestions. -Ben