From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 96367 invoked by alias); 24 Nov 2016 10:22:48 -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 96357 invoked by uid 89); 24 Nov 2016 10:22:48 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-4.7 required=5.0 tests=AWL,BAYES_00,RCVD_IN_DNSWL_NONE,RP_MATCHES_RCVD,SPF_PASS autolearn=ham version=3.3.2 spammy=libchelp, libc-help, you! X-HELO: mail.pacific.net Subject: Re: [PATCH 3/3] manual: Add new header and standards annotations. To: Joseph Myers References: <20161123063807.14845-1-ricaljasan@pacific.net> <20161123063807.14845-4-ricaljasan@pacific.net> Cc: libc-alpha@sourceware.org, Michael Kerrisk , "Carlos O'Donell" From: Rical Jasan Message-ID: <64fa1a5a-4af3-5e3f-b192-e79203c3e328@pacific.net> Date: Thu, 24 Nov 2016 10:22:00 -0000 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Thunderbird/45.4.0 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: 8bit X-Null-Tag: c40fa0c44c7d233af832c90b494747f5 X-SW-Source: 2016-11/txt/msg00881.txt.bz2 On 11/23/2016 09:42 AM, Joseph Myers wrote: > 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. Thank you! > 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). OK. > 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. I'm glad you mention this. Have you seen the related discussion on libc-help? [1] I'm interested in your thoughts on converting standards to feature test macros (or vice versa). Also, if we want long-form standards in the manual, where would we put the feature test macros? It seems more appropriate to document the feature test macros in the Summary, and the current framework uses the standard @comment verbatim there. (There is also the issue that, e.g., XOPEN2K or _USE_XOPEN2K aren't the actual feature test macros one would even use...) > 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. OK, thank you. I'll fix these up and wait for other comments. Rical [1] https://sourceware.org/ml/libc-help/2016-10/msg00014.html