From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 97143 invoked by alias); 6 Dec 2016 16:36:56 -0000 Mailing-List: contact libc-alpha-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: libc-alpha-owner@sourceware.org Received: (qmail 97124 invoked by uid 89); 6 Dec 2016 16:36:56 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-1.4 required=5.0 tests=AWL,BAYES_00,FREEMAIL_FROM,RCVD_IN_DNSWL_NONE,RCVD_IN_SORBS_SPAM,SPF_PASS autolearn=no version=3.3.2 spammy=1992, organized, Hx-languages-length:2362, lineage X-HELO: mail-qk0-f194.google.com X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:subject:to:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-transfer-encoding; bh=xWbH9eg7C2G4VJBcvz9M3oDVHtUpamh1AsSaUNOtlJQ=; b=BWesH9O+IZzREMCvGiYt38z8f5s4xdZxwgAG+gGJqH88WU88HpFj1WmPhvyVkpHLMk vbhVpGf6ZhblS91IjZ8RNLHbvABOIQoP4C6/IaFiu1CYg5X4ic9TNFn6vDCQUUdpiuWB g+a/kwIqaDXYAPGV15BC84KFFeOFEo2DIpDE9/7vLj9QeDszf1aGll2V27iTlXCVGxey l+H4K+UnxJBDrZp3Wz79FOxIOF+84RjdCt8myIncqmxuVGi0WXhull9TP48pbglEb349 Fq/aXshZIGcT8S35eocgomRUMvSFs839ff3hGvVMDFU7P7pJFidHBQTx5dxsd3ulZLUH KJ/A== X-Gm-Message-State: AKaTC03fns/RyM44/UKj+wAQMumguaYUvqXEfaoANDGqMbObycq+O2wCbCM+uIHS1oAbUA== X-Received: by 10.55.129.4 with SMTP id c4mr53623734qkd.14.1481042204033; Tue, 06 Dec 2016 08:36:44 -0800 (PST) Subject: Re: [PATCH 3/3] manual: Add new header and standards annotations. To: libc-alpha@sourceware.org References: <20161123063807.14845-1-ricaljasan@pacific.net> <20161123063807.14845-4-ricaljasan@pacific.net> <64fa1a5a-4af3-5e3f-b192-e79203c3e328@pacific.net> <45584762-6ee9-2a60-9527-8b79b93da988@pacific.net> From: Zack Weinberg Message-ID: <711cb7c2-a409-8712-4530-318f004aa6ae@panix.com> Date: Tue, 06 Dec 2016 16:36:00 -0000 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Icedove/45.5.1 MIME-Version: 1.0 In-Reply-To: <45584762-6ee9-2a60-9527-8b79b93da988@pacific.net> Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: 8bit X-SW-Source: 2016-12/txt/msg00186.txt.bz2 On 12/06/2016 05:57 AM, Rical Jasan wrote: > As food for thought, since nobody has suggested alternatives yet, and > I've been examining all the variations in current use, what about: If this list is going to appear somewhere in the manual, it would be easier to understand if it was organized first topically and then chronologically. ISO C90, C95, C99, C11, TRs/TSes POSIX.1/2 1990, 1992, 1993, 1995, 2001 (XSI), 2008 (XSI) LFS (2004?) XPG3 (1990), XPG4(.2) (1992?), UNIX 98 (1998) BSD 4.3 (1986), 4.4 (1993) undated: GNU, Linux, BSD, System V, Sun "BSD" includes both things that are really, really old (like a lot of the networking APIs) and things that are brand new (like explicit_bzero, if I ever manage to get that approved). Similarly Linux, BSD, System V, Sun. "SVID" refers to a specific document, I think equivalent to one of the XPG series, but we were using it as a catch-all for "not-standardized thing from the System V lineage", so let's rename it "System V". I don't think tracing history back before 1990 is terribly useful. I'm not even sure we're doing anyone any favors by preserving all those pre-2001 POSIX feature selection knobs. > ISO/IEC TR 27431-2:2010 > ISO/IEC TS 18661-1:2014 > ISO/IEC TS 18661-4:2015 Nobody's going to have any idea what the heck these are. It's not wrong to give them their official ISO/IEC numbers, but we need the short titles as well. > XSI POSIX.1-2001 > XSI POSIX.1-2008 XSI is an add-on module for POSIX, so it should be named *after* the date (POSIX.1-2001 XSI, POSIX.1-2008 XSI) > Sun is a lame attempt; there are all of Sun, SunOS, and SUNRPC in > current use. Suggestions welcome. "Sun" is a good catch-all term for things invented by Sun Microsystems. We're trying (painfully slowly) to get rid of the Sun RPC code, but there will still be other Sun-derived stuff after it's gone. > There is also "IPv6 Basic API", which should probably be an RFC or > something. https://tools.ietf.org/html/rfc3493 "Basic Socket Interface Extensions for IPv6", probably. > POSIX.1g is also used. There were a whole bunch of documents named POSIX.1[a-z]; they were folded into the base standard in either 1995 or 2001, and I'd recommend we just document the point where that happened (so, treat .1g as another name for .1-2001). zw