From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 36545 invoked by alias); 23 Nov 2016 17:42:35 -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 36524 invoked by uid 89); 23 Nov 2016 17:42:34 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-1.9 required=5.0 tests=AWL,BAYES_00,RCVD_IN_DNSWL_NONE,SPF_PASS,URIBL_RED autolearn=ham version=3.3.2 spammy=__USE_XOPEN2K8, __use_xopen2k8, sk:__use_x, Hx-languages-length:1211 X-HELO: relay1.mentorg.com Date: Wed, 23 Nov 2016 17:42:00 -0000 From: Joseph Myers To: Rical Jasan CC: , Michael Kerrisk , Carlos O'Donell Subject: Re: [PATCH 3/3] manual: Add new header and standards annotations. In-Reply-To: <20161123063807.14845-4-ricaljasan@pacific.net> Message-ID: References: <20161123063807.14845-1-ricaljasan@pacific.net> <20161123063807.14845-4-ricaljasan@pacific.net> User-Agent: Alpine 2.20 (DEB 67 2015-01-07) MIME-Version: 1.0 Content-Type: text/plain; charset="US-ASCII" X-ClientProxiedBy: svr-ies-mbx-01.mgc.mentorg.com (139.181.222.1) To svr-ies-mbx-01.mgc.mentorg.com (139.181.222.1) X-SW-Source: 2016-11/txt/msg00847.txt.bz2 On Tue, 22 Nov 2016, Rical Jasan wrote: > The "???" placeholder is used for anything not obvious from a > cursory survey of the glibc sources. All argp facilities should be documented as GNU. Likewise mcheck.h features. Likewise getauxval. The correct standard for posix_fallocate64 is LFS (well, really the combination of both LFS and POSIX.1-2001 enabled, however you denote POSIX.1-2001 && LFS). XOPEN2K is generically an unhelpful name. In the headers it actually means POSIX.1-2001; the X/Open version is __USE_XOPEN2KXSI. Likewise __USE_XOPEN2K8 means POSIX.1-2008 and the X/Open version is __USE_XOPEN2K8XSI. So anywhere you say XOPEN2K because the headers use __USE_XOPEN2K, say POSIX.1-2001 in the manual instead; likewise POSIX.1-2008 for XOPEN2K8. strncpy is in ISO C90, one of several standards all commonly shown as "ISO" (though I think "C90", "C99", "C11", "TS 18661-1:2014" etc. might be better names to use - as always, only listing the oldest standard relevant, not later ones that are generally supersets of it). In stdio.h, SEEK_SET, SEEK_CUR, SEEK_END are all likewise C90. -- Joseph S. Myers joseph@codesourcery.com