From b32feea59ece0b6591071b57bb935ce6505246f5 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Wed, 6 Jan 2021 11:45:26 +0100 Subject: [PATCH] Various pages: Formatting tweaks after "Improve formatting in ATTRIBUTES" Various ATTRIBUTES table improvements following the previous commit. In particular, make use of T{...T} to allow wrapping in table cells that have a lot of text. Signed-off-by: Michael Kerrisk --- man3/bindresvport.3 | 4 ++-- man3/ctime.3 | 18 +++++++++++++----- man3/error.3 | 4 ++-- man3/fmtmsg.3 | 4 ++-- man3/getdate.3 | 10 +++++++--- man3/getfsent.3 | 10 +++++++--- man3/getgrent.3 | 6 ++++-- man3/getgrent_r.3 | 10 +++++++--- man3/getgrnam.3 | 10 +++++++--- man3/gethostid.3 | 10 +++++++--- man3/getmntent.3 | 10 +++++++--- man3/getopt.3 | 6 ++++-- man3/getpwent.3 | 4 +++- man3/getpwent_r.3 | 6 ++++-- man3/getpwnam.3 | 14 ++++++++++---- man3/getspnam.3 | 16 ++++++++++++---- man3/localeconv.3 | 6 ++++-- man3/makecontext.3 | 10 +++++++--- man3/mallinfo.3 | 6 ++++-- man3/mbsnrtowcs.3 | 6 ++++-- man3/mbsrtowcs.3 | 6 ++++-- man3/posix_fallocate.3 | 6 ++++-- man3/pthread_setcancelstate.3 | 2 +- man3/setnetgrent.3 | 4 +++- man3/siginterrupt.3 | 6 ++++-- man3/strerror.3 | 6 ++++-- man3/strfromd.3 | 4 ++-- man3/strsignal.3 | 6 ++++-- man3/unlocked_stdio.3 | 14 ++++++++++---- man3/wcsnrtombs.3 | 6 ++++-- man3/wcsrtombs.3 | 6 ++++-- 31 files changed, 161 insertions(+), 75 deletions(-) diff --git a/man3/bindresvport.3 b/man3/bindresvport.3 index 5a5b2e258..9bcecd047 100644 --- a/man3/bindresvport.3 +++ b/man3/bindresvport.3 @@ -105,9 +105,9 @@ Interface Attribute Value T{ .BR bindresvport () T} Thread safety T{ -glibc >= 2.17: MT-Safe +glibc\ >=\ 2.17: MT-Safe; .\" commit f6da27e53695ad1cc0e2a9490358decbbfdff5e5 -glibc < 2.17: MT-Unsafe +glibc\ <\ 2.17: MT-Unsafe T} .TE .hy diff --git a/man3/ctime.3 b/man3/ctime.3 index 05d60b029..b06640a61 100644 --- a/man3/ctime.3 +++ b/man3/ctime.3 @@ -323,15 +323,19 @@ For an explanation of the terms used in this section, see .nh .TS allbox; -lbx lb lb +lb lb lbx l l l. Interface Attribute Value T{ .BR asctime () -T} Thread safety MT-Unsafe race:asctime locale +T} Thread safety T{ +MT-Unsafe race:asctime locale +T} T{ .BR asctime_r () -T} Thread safety MT-Safe locale +T} Thread safety T{ +MT-Safe locale +T} T{ .BR ctime () T} Thread safety T{ @@ -343,11 +347,15 @@ T{ .BR gmtime_r (), .BR localtime_r (), .BR mktime () -T} Thread safety MT-Safe env locale +T} Thread safety T{ +MT-Safe env locale +T} T{ .BR gmtime (), .BR localtime () -T} Thread safety MT-Unsafe race:tmbuf env locale +T} Thread safety T{ +MT-Unsafe race:tmbuf env locale +T} .TE .hy .ad diff --git a/man3/error.3 b/man3/error.3 index 44d19caed..c3b4ccba4 100644 --- a/man3/error.3 +++ b/man3/error.3 @@ -123,7 +123,7 @@ For an explanation of the terms used in this section, see .nh .TS allbox; -lbx lb lb +lb lb lbx l l l. Interface Attribute Value T{ @@ -132,7 +132,7 @@ T} Thread safety MT-Safe locale T{ .BR error_at_line () T} Thread safety T{ -MT-Unsafe\ race: error_at_line/error_one_per_line locale +MT-Unsafe\ race: error_at_line/\:error_one_per_line locale T} .TE .hy diff --git a/man3/fmtmsg.3 b/man3/fmtmsg.3 index b7bb8856e..7323f2e3b 100644 --- a/man3/fmtmsg.3 +++ b/man3/fmtmsg.3 @@ -232,8 +232,8 @@ Interface Attribute Value T{ .BR fmtmsg () T} Thread safety T{ -glibc >= 2.16: MT-Safe -glibc < 2.16: MT-Unsafe +glibc\ >=\ 2.16: MT-Safe; +glibc\ <\ 2.16: MT-Unsafe T} .TE .hy diff --git a/man3/getdate.3 b/man3/getdate.3 index cf93872a4..efa35a2de 100644 --- a/man3/getdate.3 +++ b/man3/getdate.3 @@ -202,15 +202,19 @@ For an explanation of the terms used in this section, see .nh .TS allbox; -lbx lb lb +lb lb lbx l l l. Interface Attribute Value T{ .BR getdate () -T} Thread safety MT-Unsafe race:getdate env locale +T} Thread safety T{ +MT-Unsafe race:getdate env locale +T} T{ .BR getdate_r () -T} Thread safety MT-Safe env locale +T} Thread safety T{ +MT-Safe env locale +T} .TE .hy .ad diff --git a/man3/getfsent.3 b/man3/getfsent.3 index 696916a27..88db2de88 100644 --- a/man3/getfsent.3 +++ b/man3/getfsent.3 @@ -118,18 +118,22 @@ For an explanation of the terms used in this section, see .nh .TS allbox; -lbx lb lb +lb lb lbx l l l. Interface Attribute Value T{ .BR endfsent (), .BR setfsent () -T} Thread safety MT-Unsafe race:fsent +T} Thread safety T{ +MT-Unsafe race:fsent +T} T{ .BR getfsent (), .BR getfsspec (), .BR getfsfile () -T} Thread safety MT-Unsafe race:fsent locale +T} Thread safety T{ +MT-Unsafe race:fsent locale +T} .TE .hy .ad diff --git a/man3/getgrent.3 b/man3/getgrent.3 index 6bf7048df..ab22cf266 100644 --- a/man3/getgrent.3 +++ b/man3/getgrent.3 @@ -172,7 +172,7 @@ For an explanation of the terms used in this section, see .nh .TS allbox; -lbx lb lb +lb lb lbx l l l. Interface Attribute Value T{ @@ -184,7 +184,9 @@ T} T{ .BR setgrent (), .BR endgrent () -T} Thread safety MT-Unsafe race:grent locale +T} Thread safety T{ +MT-Unsafe race:grent locale +T} .TE .hy .ad diff --git a/man3/getgrent_r.3 b/man3/getgrent_r.3 index c2a5d9056..1c8749d46 100644 --- a/man3/getgrent_r.3 +++ b/man3/getgrent_r.3 @@ -123,15 +123,19 @@ For an explanation of the terms used in this section, see .nh .TS allbox; -lbx lb lb +lb lb lbx l l l. Interface Attribute Value T{ .BR getgrent_r () -T} Thread safety MT-Unsafe race:grent locale +T} Thread safety T{ +MT-Unsafe race:grent locale +T} T{ .BR fgetgrent_r () -T} Thread safety MT-Safe +T} Thread safety T{ +MT-Safe +T} .TE .hy .ad diff --git a/man3/getgrnam.3 b/man3/getgrnam.3 index c22aeeab5..ffd4b6d92 100644 --- a/man3/getgrnam.3 +++ b/man3/getgrnam.3 @@ -208,15 +208,19 @@ For an explanation of the terms used in this section, see .nh .TS allbox; -lbx lb lb +lb lb lbx l l l. Interface Attribute Value T{ .BR getgrnam () -T} Thread safety MT-Unsafe race:grnam locale +T} Thread safety T{ +MT-Unsafe race:grnam locale +T} T{ .BR getgrgid () -T} Thread safety MT-Unsafe race:grgid locale +T} Thread safety T{ +MT-Unsafe race:grgid locale +T} T{ .BR getgrnam_r (), .BR getgrgid_r () diff --git a/man3/gethostid.3 b/man3/gethostid.3 index ff2f20582..746fd44dd 100644 --- a/man3/gethostid.3 +++ b/man3/gethostid.3 @@ -105,15 +105,19 @@ For an explanation of the terms used in this section, see .nh .TS allbox; -lbx lb lb +lb lb lbx l l l. Interface Attribute Value T{ .BR gethostid () -T} Thread safety MT-Safe hostid env locale +T} Thread safety T{ +MT-Safe hostid env locale +T} T{ .BR sethostid () -T} Thread safety MT-Unsafe const:hostid +T} Thread safety T{ +MT-Unsafe const:hostid +T} .TE .hy .ad diff --git a/man3/getmntent.3 b/man3/getmntent.3 index 0ad5f1a1d..097391ba9 100644 --- a/man3/getmntent.3 +++ b/man3/getmntent.3 @@ -217,7 +217,7 @@ For an explanation of the terms used in this section, see .nh .TS allbox; -lbx lb lb +lb lb lbx l l l. Interface Attribute Value T{ @@ -227,10 +227,14 @@ T{ T} Thread safety MT-Safe T{ .BR getmntent () -T} Thread safety MT-Unsafe race:mntentbuf locale +T} Thread safety T{ +MT-Unsafe race:mntentbuf locale +T} T{ .BR addmntent () -T} Thread safety MT-Safe race:stream locale +T} Thread safety T{ +MT-Safe race:stream locale +T} T{ .BR getmntent_r () T} Thread safety MT-Safe locale diff --git a/man3/getopt.3 b/man3/getopt.3 index 9bff8104e..4a657381b 100644 --- a/man3/getopt.3 +++ b/man3/getopt.3 @@ -335,14 +335,16 @@ For an explanation of the terms used in this section, see .nh .TS allbox; -lbx lb lb +lb lb lbx l l l. Interface Attribute Value T{ .BR getopt (), .BR getopt_long (), .BR getopt_long_only () -T} Thread safety MT-Unsafe race:getopt env +T} Thread safety T{ +MT-Unsafe race:getopt env +T} .TE .hy .ad diff --git a/man3/getpwent.3 b/man3/getpwent.3 index e24aa349d..72252c60e 100644 --- a/man3/getpwent.3 +++ b/man3/getpwent.3 @@ -167,7 +167,9 @@ T} T{ .BR setpwent (), .BR endpwent () -T} Thread safety MT-Unsafe race:pwent locale +T} Thread safety T{ +MT-Unsafe race:pwent locale +T} .TE .hy .ad diff --git a/man3/getpwent_r.3 b/man3/getpwent_r.3 index 4442add4a..1fc1d6a97 100644 --- a/man3/getpwent_r.3 +++ b/man3/getpwent_r.3 @@ -125,12 +125,14 @@ For an explanation of the terms used in this section, see .nh .TS allbox; -lbx lb lb +lb lb lbx l l l. Interface Attribute Value T{ .BR getpwent_r () -T} Thread safety MT-Unsafe race:pwent locale +T} Thread safety T{ +MT-Unsafe race:pwent locale +T} T{ .BR fgetpwent_r () T} Thread safety MT-Safe diff --git a/man3/getpwnam.3 b/man3/getpwnam.3 index feefa331c..922c160c0 100644 --- a/man3/getpwnam.3 +++ b/man3/getpwnam.3 @@ -214,19 +214,25 @@ For an explanation of the terms used in this section, see .nh .TS allbox; -lbx lb lb +lb lb lbx l l l. Interface Attribute Value T{ .BR getpwnam () -T} Thread safety MT-Unsafe race:pwnam locale +T} Thread safety T{ +MT-Unsafe race:pwnam locale +T} T{ .BR getpwuid () -T} Thread safety MT-Unsafe race:pwuid locale +T} Thread safety T{ +MT-Unsafe race:pwuid locale +T} T{ .BR getpwnam_r (), .BR getpwuid_r () -T} Thread safety MT-Safe locale +T} Thread safety T{ +MT-Safe locale +T} .TE .hy .ad diff --git a/man3/getspnam.3 b/man3/getspnam.3 index 47829e6fc..d7d781c76 100644 --- a/man3/getspnam.3 +++ b/man3/getspnam.3 @@ -265,20 +265,28 @@ MT-Unsafe race:getspent locale T} T{ .BR fgetspent () -T} Thread safety MT-Unsafe race:fgetspent +T} Thread safety T{ +MT-Unsafe race:fgetspent +T} T{ .BR sgetspent () -T} Thread safety MT-Unsafe race:sgetspent +T} Thread safety T{ +MT-Unsafe race:sgetspent +T} T{ .BR putspent (), .BR getspnam_r (), .BR sgetspent_r () -T} Thread safety MT-Safe locale +T} Thread safety T{ +MT-Safe locale +T} T{ .BR lckpwdf (), .BR ulckpwdf (), .BR fgetspent_r () -T} Thread safety MT-Safe +T} Thread safety T{ +MT-Safe +T} .TE .hy .ad diff --git a/man3/localeconv.3 b/man3/localeconv.3 index 53fea1743..9c89a731a 100644 --- a/man3/localeconv.3 +++ b/man3/localeconv.3 @@ -69,12 +69,14 @@ For an explanation of the terms used in this section, see .nh .TS allbox; -lbx lb lb +lb lb lbx l l l. Interface Attribute Value T{ .BR localeconv () -T} Thread safety MT-Unsafe race:localeconv locale +T} Thread safety T{ +MT-Unsafe race:localeconv locale +T} .TE .hy .ad diff --git a/man3/makecontext.3 b/man3/makecontext.3 index 16e98a7ae..c0cf5f8a8 100644 --- a/man3/makecontext.3 +++ b/man3/makecontext.3 @@ -110,15 +110,19 @@ For an explanation of the terms used in this section, see .nh .TS allbox; -lbx lb lb +lb lb lbx l l l. Interface Attribute Value T{ .BR makecontext () -T} Thread safety MT-Safe race:ucp +T} Thread safety T{ +MT-Safe race:ucp +T} T{ .BR swapcontext () -T} Thread safety MT-Safe race:oucp race:ucp +T} Thread safety T{ +MT-Safe race:oucp race:ucp +T} .TE .hy .ad diff --git a/man3/mallinfo.3 b/man3/mallinfo.3 index e9ab40e14..a225b4c33 100644 --- a/man3/mallinfo.3 +++ b/man3/mallinfo.3 @@ -145,13 +145,15 @@ For an explanation of the terms used in this section, see .nh .TS allbox; -lbx lb lb +lb lb lbx l l l. Interface Attribute Value T{ .BR mallinfo (), .BR mallinfo2 () -T} Thread safety MT-Unsafe init const:mallopt +T} Thread safety T{ +MT-Unsafe init const:mallopt +T} .TE .hy .ad diff --git a/man3/mbsnrtowcs.3 b/man3/mbsnrtowcs.3 index 833cde57e..0bbc44428 100644 --- a/man3/mbsnrtowcs.3 +++ b/man3/mbsnrtowcs.3 @@ -168,12 +168,14 @@ For an explanation of the terms used in this section, see .nh .TS allbox; -lbx lb lb +lb lb lbx l l l. Interface Attribute Value T{ .BR mbsnrtowcs () -T} Thread safety MT-Unsafe race:mbsnrtowcs/!ps +T} Thread safety T{ +MT-Unsafe race:mbsnrtowcs/!ps +T} .TE .hy .ad diff --git a/man3/mbsrtowcs.3 b/man3/mbsrtowcs.3 index ad5e03d53..429af329e 100644 --- a/man3/mbsrtowcs.3 +++ b/man3/mbsrtowcs.3 @@ -130,12 +130,14 @@ For an explanation of the terms used in this section, see .nh .TS allbox; -lbx lb lb +lb lb lbx l l l. Interface Attribute Value T{ .BR mbsrtowcs () -T} Thread safety MT-Unsafe race:mbsrtowcs/!ps +T} Thread safety T{ +MT-Unsafe race:mbsrtowcs/!ps +T} .TE .hy .ad diff --git a/man3/posix_fallocate.3 b/man3/posix_fallocate.3 index e1736adbd..34a9d46fb 100644 --- a/man3/posix_fallocate.3 +++ b/man3/posix_fallocate.3 @@ -117,12 +117,14 @@ For an explanation of the terms used in this section, see .nh .TS allbox; -lbx lb lb +lb lb lbx l l l. Interface Attribute Value T{ .BR posix_fallocate () -T} Thread safety MT-Safe (but see NOTES) +T} Thread safety T{ +MT-Safe (but see NOTES) +T} .TE .hy .ad diff --git a/man3/pthread_setcancelstate.3 b/man3/pthread_setcancelstate.3 index a41c0298d..1440ce3e7 100644 --- a/man3/pthread_setcancelstate.3 +++ b/man3/pthread_setcancelstate.3 @@ -134,7 +134,7 @@ T} T{ .BR pthread_setcancelstate (), .BR pthread_setcanceltype () -T} Async-cancel-safety T{ +T} Async-cancel safety T{ AC-Safe T} .TE diff --git a/man3/setnetgrent.3 b/man3/setnetgrent.3 index a4769b1f1..440cf2846 100644 --- a/man3/setnetgrent.3 +++ b/man3/setnetgrent.3 @@ -114,7 +114,9 @@ locale T} T{ .BR endnetgrent () -T} Thread safety MT-Unsafe race:netgrent +T} Thread safety T{ +MT-Unsafe race:netgrent +T} T{ .BR getnetgrent () T} Thread safety T{ diff --git a/man3/siginterrupt.3 b/man3/siginterrupt.3 index c6d785197..9b0efe427 100644 --- a/man3/siginterrupt.3 +++ b/man3/siginterrupt.3 @@ -89,12 +89,14 @@ For an explanation of the terms used in this section, see .nh .TS allbox; -lbx lb lb +lb lb lbx l l l. Interface Attribute Value T{ .BR siginterrupt () -T} Thread safety MT-Unsafe const:sigintr +T} Thread safety T{ +MT-Unsafe const:sigintr +T} .TE .hy .ad diff --git a/man3/strerror.3 b/man3/strerror.3 index 00f6e1211..731221fb2 100644 --- a/man3/strerror.3 +++ b/man3/strerror.3 @@ -242,12 +242,14 @@ For an explanation of the terms used in this section, see .nh .TS allbox; -lbx lb lb +lb lb lbx l l l. Interface Attribute Value T{ .BR strerror () -T} Thread safety MT-Unsafe race:strerror +T} Thread safety T{ +MT-Unsafe race:strerror +T} T{ .BR strerrorname_np (), .BR strerrordesc_np () diff --git a/man3/strfromd.3 b/man3/strfromd.3 index 4380cd840..a3cec4bd5 100644 --- a/man3/strfromd.3 +++ b/man3/strfromd.3 @@ -190,8 +190,8 @@ T{ .BR strfromf (), .BR strfroml () T} Thread safety MT-Safe locale -\^ Asynchronous signal safety AS-Unsafe heap -\^ Asynchronous cancellation safety AC-Unsafe mem +\^ Async-signal safety AS-Unsafe heap +\^ Async-cancel safety AC-Unsafe mem .TE .hy .ad diff --git a/man3/strsignal.3 b/man3/strsignal.3 index 2d30259e9..d75040f35 100644 --- a/man3/strsignal.3 +++ b/man3/strsignal.3 @@ -142,12 +142,14 @@ For an explanation of the terms used in this section, see .nh .TS allbox; -lbx lb lb +lb lb lbx l l l. Interface Attribute Value T{ .BR strsignal () -T} Thread safety MT-Unsafe race:strsignal locale +T} Thread safety T{ +MT-Unsafe race:strsignal locale +T} T{ .BR sigdescr_np (), .BR sigabbrev_np () diff --git a/man3/unlocked_stdio.3 b/man3/unlocked_stdio.3 index bc5c65558..74c07456c 100644 --- a/man3/unlocked_stdio.3 +++ b/man3/unlocked_stdio.3 @@ -125,7 +125,7 @@ For an explanation of the terms used in this section, see .nh .TS allbox; -lbx lb lb +lb lb lbx l l l. Interface Attribute Value T{ @@ -145,15 +145,21 @@ T{ .BR putwc_unlocked (), .BR fgetws_unlocked (), .BR fputws_unlocked () -T} Thread safety MT-Safe race:stream +T} Thread safety T{ +MT-Safe race:stream +T} T{ .BR getchar_unlocked (), .BR getwchar_unlocked () -T} Thread safety MT-Unsafe race:stdin +T} Thread safety T{ +MT-Unsafe race:stdin +T} T{ .BR putchar_unlocked (), .BR putwchar_unlocked () -T} Thread safety MT-Unsafe race:stdout +T} Thread safety T{ +MT-Unsafe race:stdout +T} T{ .BR feof_unlocked (), .BR ferror_unlocked (), diff --git a/man3/wcsnrtombs.3 b/man3/wcsnrtombs.3 index 9bf88e7e7..99c38f31c 100644 --- a/man3/wcsnrtombs.3 +++ b/man3/wcsnrtombs.3 @@ -158,12 +158,14 @@ For an explanation of the terms used in this section, see .nh .TS allbox; -lbx lb lb +lb lb lbx l l l. Interface Attribute Value T{ .BR wcsnrtombs () -T} Thread safety MT-Unsafe race:wcsnrtombs/!ps +T} Thread safety T{ +MT-Unsafe race:wcsnrtombs/!ps +T} .TE .hy .ad diff --git a/man3/wcsrtombs.3 b/man3/wcsrtombs.3 index 106d1422f..df5518080 100644 --- a/man3/wcsrtombs.3 +++ b/man3/wcsrtombs.3 @@ -130,12 +130,14 @@ For an explanation of the terms used in this section, see .nh .TS allbox; -lbx lb lb +lb lb lbx l l l. Interface Attribute Value T{ .BR wcsrtombs () -T} Thread safety MT-Unsafe race:wcsrtombs/!ps +T} Thread safety T{ +MT-Unsafe race:wcsrtombs/!ps +T} .TE .hy .ad