[PATCH 3/3] manual: Add new header and standards annotations.
Rical Jasan
ricaljasan@pacific.net
Mon Dec 5 07:59:00 GMT 2016
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
More information about the Libc-alpha
mailing list