This is the mail archive of the libc-alpha@sourceware.org mailing list for the glibc project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: [PATCH 3/3] manual: Add new header and standards annotations.


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


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]