From owner-freebsd-doc@FreeBSD.ORG Sat May 24 12:23:34 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 DAE67E24; Sat, 24 May 2014 12:23:34 +0000 (UTC) Received: from mail-we0-x236.google.com (mail-we0-x236.google.com [IPv6:2a00:1450:400c:c03::236]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4CB94277E; Sat, 24 May 2014 12:23:34 +0000 (UTC) Received: by mail-we0-f182.google.com with SMTP id t60so6034830wes.13 for ; Sat, 24 May 2014 05:23:32 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:content-type:content-transfer-encoding; bh=blxIEhl5KrOw16EEmtqhVFu+0thtDzjVpieu7Yrf6cc=; b=lLO4P0TwR6TjI5ik6AovgzYw79TJGddF+LsmfTJHI+44GN2S7SPaxYgTsYzwOTFT1G io1bLLJt9kbQ1woieovyjTgcvLOT4yjfn3fVj42bN2X6UmwimehamLp9WPWm8od0+Lfd FoWOCQetn6qpHbkqNITDZc95XF8IrD8QKNQUzvHEgKv+eoIJDmAS6TqSeDLEpS0aPVid vQAdd+FTxNTR75q91k8UyrRRHAFX6Syi1LsXv9BY8BPcfUVWrGCaZhhehLXRZL/NuJa1 Plt3u7auptd5mXlUktVW44GjMr5PzeOxAon6hnL7qM7JaVYK9DPO58/IxxBuBxHbFfgS Xeaw== X-Received: by 10.180.87.165 with SMTP id az5mr10943790wib.10.1400934212507; Sat, 24 May 2014 05:23:32 -0700 (PDT) Received: from [192.168.232.92] (mail.jambit.com. [95.157.63.22]) by mx.google.com with ESMTPSA id fa10sm9840303wib.18.2014.05.24.05.23.23 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Sat, 24 May 2014 05:23:31 -0700 (PDT) Message-ID: <537EC752.7070808@gmail.com> Date: Fri, 23 May 2014 05:58:10 +0200 From: "Michael Kerrisk (man-pages)" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:24.0) Gecko/20100101 Thunderbird/24.5.0 MIME-Version: 1.0 To: Benjamin Kaduk Subject: Re: docs/188786: Bug in inet(3) man page (inet_aton()) References: <201405170408.s4H48Xff021996@freefall.freebsd.org> In-Reply-To: Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: freebsd-doc@freebsd.org, mtk.manpages@gmail.com 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: Sat, 24 May 2014 12:23:34 -0000 On 05/23/2014 04:47 AM, Benjamin Kaduk wrote: > 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.) Okay. > Thanks again for the submission, it's always good to get suggestions. You're welcome. Thanks for following up, Ben. Cheers, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/