diff options
| author | Michael Kerrisk <mtk.manpages@gmail.com> | 2021-01-06 10:52:04 +0100 |
|---|---|---|
| committer | Michael Kerrisk <mtk.manpages@gmail.com> | 2021-01-06 13:46:39 +0100 |
| commit | c466875ecd64ed3d3cd3e578406851b7dfb397bf (patch) | |
| tree | 6030e6475aef7d47f23475c99ce97f296f811da0 /man3/stdarg.3 | |
| parent | daaf6d327bdc6d7ccc910c8eca146a374c4202a9 (diff) | |
| download | man-pages-c466875ecd64ed3d3cd3e578406851b7dfb397bf.tar.gz | |
Various pages: Improve formatting in ATTRIBUTES
Make the formatting more consistent inside the tables in the
ATTRIBUTES sections. Make the source code more uniform; in
particular, eliminate the use of custom tweaks using
'lbwNN'/'lwNN' and .br macros. In addition, ensure that
hyphenation and text justification do not occur inside the tables.
This is a script-driven edit:
[[
PAGE_LIST=$(git grep -l 'SH ATTRIBUTES' man[23])
# Strip out any preexisting .sp/.br/.ad macros
sed -i '/SH ATTR/,/^\.SH/{/^\.sp/d; /^\.br/d; /\.ad/d}' $PAGE_LIST
# Eliminate any use of 'wNN' in tables; default first column
# to fill unused space
sed -i '/SH ATTR/,/^\.SH/s/lbw[0-9]*/lb/g' $PAGE_LIST
sed -i '/SH ATTR/,/^\.SH/s/lw[0-9]*/l/g' $PAGE_LIST
sed -i '/SH ATTR/,/^\.SH/s/^lb /lbx /' $PAGE_LIST
# Nest the tables inside ".ad l"+".nh" and ".hy"+".ad"+".sp 1"
# ".ad l" ==> no right justification of text in table cells
# ".nh" ==> No hyphenation in table cells
# ".sp 1" ==> ensure a blank line before the next section heading
sed -i '/SH ATTR/,/^\.SH/{/\.TS/i.ad l\n.nh
}' $PAGE_LIST
sed -i '/SH ATTR/,/^\.SH/{/\.TE/a.hy\n.ad\n.sp 1
}' $PAGE_LIST
# In a few of the tables, the third column has a lot of text, so
# make that column wide (rather than the first column)
sed -i '/^lbx/{s/lbx/lb/;s/lb$/lbx/}' \
man3/bindresvport.3 \
man3/fmtmsg.3 man3/gethostbyname.3 man3/getlogin.3 \
man3/getnetent.3 man3/getprotoent.3 man3/getpwent.3 \
man3/getservent.3 man3/getspnam.3 man3/getutent.3 man3/glob.3 \
man3/login.3 \
man3/setnetgrent.3 \
man3/wordexp.3
]]
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Diffstat (limited to 'man3/stdarg.3')
| -rw-r--r-- | man3/stdarg.3 | 7 |
1 files changed, 6 insertions, 1 deletions
diff --git a/man3/stdarg.3 b/man3/stdarg.3 index 8cfa8b0a41..a4e1e91368 100644 --- a/man3/stdarg.3 +++ b/man3/stdarg.3 @@ -228,9 +228,11 @@ instead, since that was the name used in the draft proposal. .SH ATTRIBUTES For an explanation of the terms used in this section, see .BR attributes (7). +.ad l +.nh .TS allbox; -lbw21 lb lb +lbx lb lb l l l. Interface Attribute Value T{ @@ -242,6 +244,9 @@ T{ .BR va_arg () T} Thread safety MT-Safe race:ap .TE +.hy +.ad +.sp 1 .SH CONFORMING TO The .BR va_start (), |