From 7b5d39f48fb41e1f31c8fd162bf321a759ad9e1f Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Fri, 1 Jan 2021 22:24:55 +0100 Subject: [PATCH] Various pages: clean-ups after "bring more whitespace consistency in SYNOPSIS" Cleann-ups after commit 15d6565317dad749ef57e69023139bc405caab88. Reported-by: Alejandro Colomar (man-pages) Signed-off-by: Michael Kerrisk --- man2/brk.2 | 2 ++ man2/pread.2 | 2 ++ man3/a64l.3 | 2 ++ man3/atan.3 | 2 +- man3/backtrace.3 | 20 +++++--------------- man3/catopen.3 | 3 ++- man3/fmax.3 | 2 ++ man3/getaddrinfo_a.3 | 2 -- man3/getdirentries.3 | 6 ++++-- man3/getspnam.3 | 8 ++++---- man3/login.3 | 2 ++ man3/mq_getattr.3 | 2 +- man3/random_r.3 | 2 -- 13 files changed, 27 insertions(+), 28 deletions(-) diff --git a/man2/brk.2 b/man2/brk.2 index 27bceebfc..067ad4a7f 100644 --- a/man2/brk.2 +++ b/man2/brk.2 @@ -30,10 +30,12 @@ .SH NAME brk, sbrk \- change data segment size .SH SYNOPSIS +.nf .B #include .PP .BI "int brk(void *" addr ); .BI "void *sbrk(intptr_t " increment ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man2/pread.2 b/man2/pread.2 index fa030a1ad..8e31be79c 100644 --- a/man2/pread.2 +++ b/man2/pread.2 @@ -26,12 +26,14 @@ .SH NAME pread, pwrite \- read from or write to a file descriptor at a given offset .SH SYNOPSIS +.nf .B #include .PP .BI "ssize_t pread(int " fd ", void *" buf ", size_t " count \ ", off_t " offset ); .BI "ssize_t pwrite(int " fd ", const void *" buf ", size_t " count \ ", off_t " offset ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man3/a64l.3 b/man3/a64l.3 index e41d863ce..16a73977b 100644 --- a/man3/a64l.3 +++ b/man3/a64l.3 @@ -11,10 +11,12 @@ .SH NAME a64l, l64a \- convert between long and base-64 .SH SYNOPSIS +.nf .B #include .PP .BI "long a64l(const char *" str64 ); .BI "char *l64a(long " value ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man3/atan.3 b/man3/atan.3 index d4688d4e0..b20b4e0b2 100644 --- a/man3/atan.3 +++ b/man3/atan.3 @@ -41,7 +41,7 @@ atan, atanf, atanl \- arc tangent function .PP .BI "double atan(double " x ); .BI "float atanf(float " x ); -.BI "long double atanl( long double " x ); +.BI "long double atanl(long double " x ); .PP .fi Link with \fI\-lm\fP. diff --git a/man3/backtrace.3 b/man3/backtrace.3 index 542ad87f2..066fa6bad 100644 --- a/man3/backtrace.3 +++ b/man3/backtrace.3 @@ -29,24 +29,14 @@ backtrace, backtrace_symbols, backtrace_symbols_fd \- support for application self-debugging .SH SYNOPSIS +.nf .B #include .PP -.B int backtrace(void -.BI ** buffer , -.B int -.IB size ); +.BI "int backtrace(void **" buffer ", int " size ); .PP -.B char **backtrace_symbols(void *const -.BI * buffer , -.B int -.IB size ); -.PP -.B void backtrace_symbols_fd(void *const -.BI * buffer , -.B int -.IB size , -.B int -.IB fd ); +.BI "char **backtrace_symbols(void *const *" buffer ", int " size ); +.BI "void backtrace_symbols_fd(void *const *" buffer ", int " size ", int " fd ); +.fi .SH DESCRIPTION .BR backtrace () returns a backtrace for the calling program, diff --git a/man3/catopen.3 b/man3/catopen.3 index f005d7002..7b1a8b4a1 100644 --- a/man3/catopen.3 +++ b/man3/catopen.3 @@ -29,11 +29,12 @@ .SH NAME catopen, catclose \- open/close a message catalog .SH SYNOPSIS +.nf .B #include .PP .BI "nl_catd catopen(const char *" name ", int " flag ); -.PP .BI "int catclose(nl_catd " catalog ); +.fi .SH DESCRIPTION The function .BR catopen () diff --git a/man3/fmax.3 b/man3/fmax.3 index fe44ee776..f8bd8983f 100644 --- a/man3/fmax.3 +++ b/man3/fmax.3 @@ -10,11 +10,13 @@ .SH NAME fmax, fmaxf, fmaxl \- determine maximum of two floating-point numbers .SH SYNOPSIS +.nf .B #include .PP .BI "double fmax(double " x ", double " y ); .BI "float fmaxf(float " x ", float " y ); .BI "long double fmaxl(long double " x ", long double " y ); +.fi .PP Link with \fI\-lm\fP. .PP diff --git a/man3/getaddrinfo_a.3 b/man3/getaddrinfo_a.3 index aed652349..6cf3513ce 100644 --- a/man3/getaddrinfo_a.3 +++ b/man3/getaddrinfo_a.3 @@ -38,12 +38,10 @@ network address and service translation .PP .BI "int getaddrinfo_a(int " "mode" ", struct gaicb *" "list[]" , .BI " int " "nitems" ", struct sigevent *" "sevp" ); -.PP .BI "int gai_suspend(const struct gaicb * const " "list[]" ", int " "nitems" , .BI " const struct timespec *" "timeout" ); .PP .BI "int gai_error(struct gaicb *" "req" ); -.PP .BI "int gai_cancel(struct gaicb *" "req" ); .PP Link with \fI\-lanl\fP. diff --git a/man3/getdirentries.3 b/man3/getdirentries.3 index 1aafd1a69..a179a8099 100644 --- a/man3/getdirentries.3 +++ b/man3/getdirentries.3 @@ -28,10 +28,12 @@ .SH NAME getdirentries \- get directory entries in a filesystem-independent format .SH SYNOPSIS +.nf .B #include .PP -.BI "ssize_t getdirentries(int " fd ", char *" buf ", size_t " \ -nbytes ", off_t *" basep ); +.BI "ssize_t getdirentries(int " fd ", char *" buf ", size_t " nbytes , +.BI " off_t *" basep ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man3/getspnam.3 b/man3/getspnam.3 index 728437725..55eec96c6 100644 --- a/man3/getspnam.3 +++ b/man3/getspnam.3 @@ -33,14 +33,14 @@ lckpwdf, ulckpwdf \- get shadow password file entry .B #include .PP .BI "int getspent_r(struct spwd *" spbuf , -.BI " char *" buf ", size_t " buflen ", struct spwd **" spbufp ); +.BI " char *" buf ", size_t " buflen ", struct spwd **" spbufp ); .BI "int getspnam_r(const char *" name ", struct spwd *" spbuf , -.BI " char *" buf ", size_t " buflen ", struct spwd **" spbufp ); +.BI " char *" buf ", size_t " buflen ", struct spwd **" spbufp ); .PP .BI "int fgetspent_r(FILE *" stream ", struct spwd *" spbuf , -.BI " char *" buf ", size_t " buflen ", struct spwd **" spbufp ); +.BI " char *" buf ", size_t " buflen ", struct spwd **" spbufp ); .BI "int sgetspent_r(const char *" s ", struct spwd *" spbuf , -.BI " char *" buf ", size_t " buflen ", struct spwd **" spbufp ); +.BI " char *" buf ", size_t " buflen ", struct spwd **" spbufp ); .fi .PP .RS -4 diff --git a/man3/login.3 b/man3/login.3 index 985fc93cd..e82a0907e 100644 --- a/man3/login.3 +++ b/man3/login.3 @@ -26,10 +26,12 @@ .SH NAME login, logout \- write utmp and wtmp entries .SH SYNOPSIS +.nf .B #include .PP .BI "void login(const struct utmp *" ut ); .BI "int logout(const char *" ut_line ); +.fi .PP Link with \fI\-lutil\fP. .SH DESCRIPTION diff --git a/man3/mq_getattr.3 b/man3/mq_getattr.3 index 7b87d6bae..be572d426 100644 --- a/man3/mq_getattr.3 +++ b/man3/mq_getattr.3 @@ -31,7 +31,7 @@ mq_getattr, mq_setattr \- get/set message queue attributes .PP .BI "int mq_getattr(mqd_t " mqdes ", struct mq_attr *" attr ); .BI "int mq_setattr(mqd_t " mqdes ", const struct mq_attr *" newattr "," -.BI " struct mq_attr *" oldattr ); +.BI " struct mq_attr *" oldattr ); .fi .PP Link with \fI\-lrt\fP. diff --git a/man3/random_r.3 b/man3/random_r.3 index e4d85b676..e85e604b2 100644 --- a/man3/random_r.3 +++ b/man3/random_r.3 @@ -32,12 +32,10 @@ random number generator .B #include .PP .BI "int random_r(struct random_data *" buf ", int32_t *" result ); -.PP .BI "int srandom_r(unsigned int " seed ", struct random_data *" buf ); .PP .BI "int initstate_r(unsigned int " seed ", char *" statebuf , .BI " size_t " statelen ", struct random_data *" buf ); -.PP .BI "int setstate_r(char *" statebuf ", struct random_data *" buf ); .fi .PP