On 02/12/2014 11:31 PM, Carlos O'Donell wrote: >> Yes, maybe it is better. >> But in Oracle Solaris's manpages, iswblank is marked "MT-Safe with exceptions". >> I also think "MT-Safe with exceptions" is OK. > > My suggestion is: > > "The function iswblank() is thread safe with exceptions (locale). See > "Safety Concepts" for more information." > I think we should tell users where can look up "Safety Concepts". The description may be: "The function iswblank() is thread safe with exceptions (locale). See "Safety Concepts" for more information in pthreads(7)." Maybe pthreads(7) is man-pages(7) or others. Before the decision is made, I will only send the patch without exceptions. Thanks. -- Best Regards, Peng > Then describe the locale issue once in the "Safety Concepts" section. > > This reduces duplicated text and simplifies each man page. > > Users that know what "locale" means can scroll quickly, users that > don't can look it up and learn. > > Does that make sense? > > My further suggestion is to use the same ~20 exception notes as glibc e.g. > race, const, locale, env, hostid, sigintr, init, lock, corrupt, heap, > dlopen, plugin, i18ln, fd, mem, sig, term, and cwd (we also have > !posix to indicate it is known not to conform with posix). > > The glibc manual is marked with them now, you can see iswblank here: > http://www.gnu.org/software/libc/manual/html_mono/libc.html#index-iswblank-486 > > Cheers, > Carlos. > -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
