From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 107929 invoked by alias); 5 Dec 2016 07:59:50 -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 107903 invoked by uid 89); 5 Dec 2016 07:59: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=unistd.h, UD:unistd.h, unistdh, 1221 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> <64fa1a5a-4af3-5e3f-b192-e79203c3e328@pacific.net> <951c0013-8227-46c3-6d05-678bca61f2ce@pacific.net> Cc: Florian Weimer , libc-alpha@sourceware.org, Michael Kerrisk , "Carlos O'Donell" From: Rical Jasan Message-ID: <912c288b-d2f2-6ef0-7bd7-ee93b0f734ac@pacific.net> Date: Mon, 05 Dec 2016 07:59: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: 7bit X-Null-Tag: f99dd1e9a7c5219e9c26a05dcdfddbf0 X-SW-Source: 2016-12/txt/msg00082.txt.bz2 On 12/02/2016 05:55 AM, Joseph Myers wrote: > 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.) I don't think that's possible using Texinfo. The @*ref-commands allow some variance in their rendering, but nothing that overrides the entire rendered string like that, from what I can see. Rical