From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 6777 invoked by alias); 2 Dec 2016 13:56:13 -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 6269 invoked by uid 89); 2 Dec 2016 13:56:08 -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= X-HELO: relay1.mentorg.com Date: Fri, 02 Dec 2016 13:56:00 -0000 From: Joseph Myers To: Rical Jasan CC: Florian Weimer , , Michael Kerrisk , Carlos O'Donell Subject: Re: [PATCH 3/3] manual: Add new header and standards annotations. In-Reply-To: Message-ID: References: <20161123063807.14845-1-ricaljasan@pacific.net> <20161123063807.14845-4-ricaljasan@pacific.net> <64fa1a5a-4af3-5e3f-b192-e79203c3e328@pacific.net> <951c0013-8227-46c3-6d05-678bca61f2ce@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-12/txt/msg00048.txt.bz2 On Fri, 2 Dec 2016, Rical Jasan wrote: > Safety: MT-Safe | AS-Unsafe heap | AC-Unsafe mem fd | See Section > 1.2.2.1 [POSIX Safety Concepts], page 2. > Standards: POSIX.1 (unistd.h), See Section 1.3.4 [Feature Test Macros], > page 15. > Added in: 2.0 I'm envisaging "Safety" and "Standards" being plain links (in the HTML and PDF manuals) to the relevant manual sections, so you don't have the " | See Section 1.2.2.1 [POSIX Safety Concepts], page 2." and ", See Section 1.3.4 [Feature Test Macros], page 15." text at all. That makes things much shorter. (I don't know if you can readily make such plain links from Texinfo at present, but I think it looks a lot better that way when you have such annotations appearing for every interface in the manual.) -- Joseph S. Myers joseph@codesourcery.com