From c7db92b96a3f88dc146a35d6851453e3b354f4fc Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Sun, 3 Jan 2021 12:49:03 +0100 Subject: [PATCH] Various pages: Use .nf/.fi in SYNOPSIS The majority of pages use .nf/.fi in SYNOPSIS, but there are still many that don't and use .br to achieve newlines. Fix many of those. This brings greater consistency to the pages, which eases editing and may ease future scripted edits to the pages. Many of these changes were script-assisted, with some additional manual edits. Signed-off-by: Michael Kerrisk --- man1/getent.1 | 2 ++ man1/ldd.1 | 2 ++ man1/memusage.1 | 2 ++ man1/memusagestat.1 | 2 ++ man1/mtrace.1 | 2 ++ man2/_exit.2 | 2 ++ man2/_syscall.2 | 2 ++ man2/chdir.2 | 3 ++- man2/epoll_ctl.2 | 2 ++ man2/eventfd.2 | 2 ++ man2/execve.2 | 3 ++- man2/execveat.2 | 4 ++-- man2/fanotify_init.2 | 3 ++- man2/flock.2 | 2 ++ man2/fork.2 | 3 ++- man2/fsync.2 | 2 ++ man2/getgid.2 | 4 ++-- man2/getgroups.2 | 3 ++- man2/getpeername.2 | 2 ++ man2/getpid.2 | 4 ++-- man2/getpriority.2 | 4 ++-- man2/getrandom.2 | 2 ++ man2/getresuid.2 | 4 ++-- man2/getrlimit.2 | 8 +++----- man2/getrusage.2 | 3 ++- man2/getsid.2 | 3 ++- man2/getuid.2 | 4 ++-- man2/idle.2 | 2 ++ man2/inotify_add_watch.2 | 2 ++ man2/inotify_rm_watch.2 | 2 ++ man2/ioctl.2 | 2 ++ man2/ioctl_ficlonerange.2 | 4 ++-- man2/ioctl_fideduperange.2 | 3 ++- man2/ioctl_fslabel.2 | 4 ++-- man2/ioctl_getfsmap.2 | 4 ++-- man2/ioctl_tty.2 | 2 ++ man2/ioperm.2 | 5 +++-- man2/iopl.2 | 2 ++ man2/lookup_dcookie.2 | 2 ++ man2/lseek.2 | 3 ++- man2/madvise.2 | 2 ++ man2/mincore.2 | 3 ++- man2/msync.2 | 2 ++ man2/nanosleep.2 | 2 ++ man2/nice.2 | 2 ++ man2/pause.2 | 2 ++ man2/personality.2 | 2 ++ man2/pivot_root.2 | 2 ++ man2/reboot.2 | 4 ++-- man2/restart_syscall.2 | 2 ++ man2/rmdir.2 | 2 ++ man2/sched_rr_get_interval.2 | 2 ++ man2/sched_yield.2 | 2 ++ man2/sendfile.2 | 9 ++------- man2/seteuid.2 | 4 ++-- man2/setfsgid.2 | 2 ++ man2/setfsuid.2 | 2 ++ man2/setgid.2 | 3 ++- man2/setresuid.2 | 4 ++-- man2/setreuid.2 | 4 ++-- man2/setsid.2 | 4 ++-- man2/setuid.2 | 3 ++- man2/setup.2 | 2 ++ man2/shmctl.2 | 3 ++- man2/shmget.2 | 3 ++- man2/shutdown.2 | 2 ++ man2/sigaltstack.2 | 2 ++ man2/signal.2 | 2 ++ man2/signalfd.2 | 2 ++ man2/sigpending.2 | 2 ++ man2/sigreturn.2 | 2 ++ man2/sigsuspend.2 | 2 ++ man2/socket.2 | 3 ++- man2/socketcall.2 | 2 ++ man2/socketpair.2 | 3 ++- man2/statfs.2 | 3 ++- man2/stime.2 | 2 ++ man2/swapon.2 | 4 ++-- man2/sync.2 | 2 ++ man2/syscalls.2 | 2 ++ man2/sysinfo.2 | 2 ++ man2/time.2 | 2 ++ man2/times.2 | 2 ++ man2/truncate.2 | 4 ++-- man2/umask.2 | 3 ++- man2/uname.2 | 2 ++ man2/unimplemented.2 | 2 ++ man2/uselib.2 | 2 ++ man2/write.2 | 2 ++ man3/__ppc_set_ppr_med.3 | 6 ++---- man3/__ppc_yield.3 | 4 ++-- man3/__setfpucw.3 | 2 ++ man3/aio_cancel.3 | 2 ++ man3/aio_error.3 | 2 ++ man3/aio_fsync.3 | 2 ++ man3/aio_read.3 | 2 ++ man3/aio_return.3 | 2 ++ man3/aio_write.3 | 2 ++ man3/alloca.3 | 2 ++ man3/bsd_signal.3 | 2 ++ man3/cabs.3 | 4 ++-- man3/cacos.3 | 4 ++-- man3/cacosh.3 | 4 ++-- man3/canonicalize_file_name.3 | 3 ++- man3/carg.3 | 4 ++-- man3/casin.3 | 4 ++-- man3/casinh.3 | 4 ++-- man3/catan.3 | 4 ++-- man3/catanh.3 | 4 ++-- man3/ccos.3 | 4 ++-- man3/ccosh.3 | 4 ++-- man3/cexp.3 | 4 ++-- man3/cexp2.3 | 4 ++-- man3/cimag.3 | 4 ++-- man3/clog.3 | 4 ++-- man3/clog10.3 | 5 ++--- man3/clog2.3 | 4 ++-- man3/conj.3 | 4 ++-- man3/cproj.3 | 4 ++-- man3/creal.3 | 4 ++-- man3/csin.3 | 4 ++-- man3/csinh.3 | 4 ++-- man3/csqrt.3 | 4 ++-- man3/ctan.3 | 4 ++-- man3/ctanh.3 | 4 ++-- man3/dirfd.3 | 3 ++- man3/dlerror.3 | 2 ++ man3/dlsym.3 | 3 ++- man3/dysize.3 | 2 ++ man3/errno.3 | 2 ++ man3/fclose.3 | 2 ++ man3/fdim.3 | 4 ++-- man3/fflush.3 | 2 ++ man3/fmin.3 | 4 ++-- man3/ftime.3 | 2 ++ man3/gamma.3 | 4 ++-- man3/get_nprocs_conf.3 | 3 ++- man3/getcontext.3 | 3 ++- man3/getdate.3 | 2 ++ man3/getentropy.3 | 2 ++ man3/getgrouplist.3 | 3 ++- man3/getsubopt.3 | 2 ++ man3/getumask.3 | 4 ++-- man3/getutent.3 | 5 ++--- man3/grantpt.3 | 2 ++ man3/group_member.3 | 2 ++ man3/ilogb.3 | 4 ++-- man3/killpg.3 | 2 ++ man3/lockf.3 | 2 ++ man3/logb.3 | 4 ++-- man3/lseek64.3 | 4 ++-- man3/malloc_stats.3 | 2 ++ man3/malloc_trim.3 | 2 ++ man3/malloc_usable_size.3 | 2 ++ man3/mallopt.3 | 2 ++ man3/nan.3 | 4 ++-- man3/nextafter.3 | 6 ++---- man3/perror.3 | 4 ++-- man3/ptsname.3 | 3 ++- man3/putgrent.3 | 3 ++- man3/remove.3 | 2 ++ man3/scalb.3 | 4 ++-- man3/scalbln.3 | 6 ++---- man3/signbit.3 | 2 ++ man3/significand.3 | 4 ++-- man3/sigqueue.3 | 2 ++ man3/sockatmark.3 | 2 ++ man3/statvfs.3 | 3 ++- man3/stdarg.3 | 5 ++--- man3/stdio.3 | 4 ++-- man3/strptime.3 | 6 +++--- man3/strtod.3 | 4 ++-- man3/syslog.3 | 4 ++-- man3/sysv_signal.3 | 3 ++- man3/tcgetsid.3 | 3 ++- man3/tgamma.3 | 4 ++-- man3/ttyslot.3 | 2 ++ man3/ulimit.3 | 2 ++ man3/undocumented.3 | 2 ++ man3/unlockpt.3 | 3 ++- man4/loop.4 | 2 ++ man4/lp.4 | 2 ++ man4/random.4 | 2 ++ man4/rtc.4 | 2 ++ man4/wavelan.4 | 2 ++ man5/acct.5 | 2 ++ man5/hosts.5 | 2 ++ man5/resolv.conf.5 | 2 ++ man5/rpc.5 | 2 ++ man5/slabinfo.5 | 2 ++ man5/utmp.5 | 2 ++ man7/address_families.7 | 3 ++- man7/complex.7 | 2 ++ man7/ddp.7 | 4 ++-- man7/epoll.7 | 2 ++ man7/ip.7 | 6 ++---- man7/ipv6.7 | 5 ++--- man7/netdevice.7 | 3 ++- man7/raw.7 | 4 ++-- man7/rtnetlink.7 | 5 ++--- man7/socket.7 | 2 ++ man7/tcp.7 | 4 ++-- man7/udp.7 | 4 ++-- man7/udplite.7 | 3 ++- man7/unix.7 | 4 ++-- man7/vdso.7 | 2 ++ man7/vsock.7 | 4 ++-- man7/x25.7 | 3 ++- man8/sln.8 | 3 ++- man8/tzselect.8 | 2 ++ 210 files changed, 423 insertions(+), 205 deletions(-) diff --git a/man1/getent.1 b/man1/getent.1 index c55d5af37..e4c9a5bde 100644 --- a/man1/getent.1 +++ b/man1/getent.1 @@ -26,7 +26,9 @@ .SH NAME getent \- get entries from Name Service Switch libraries .SH SYNOPSIS +.nf .B getent\ [\fIoption\fP]...\ \fIdatabase\fP\ \fIkey\fP... +.fi .SH DESCRIPTION The .B getent diff --git a/man1/ldd.1 b/man1/ldd.1 index 761417f97..01f44671e 100644 --- a/man1/ldd.1 +++ b/man1/ldd.1 @@ -15,7 +15,9 @@ .SH NAME ldd \- print shared object dependencies .SH SYNOPSIS +.nf .BR ldd " [\fIoption\fP]... \fIfile\fP..." +.fi .SH DESCRIPTION .B ldd prints the shared objects (shared libraries) required by each program or diff --git a/man1/memusage.1 b/man1/memusage.1 index 7ceaece56..ee6d44cfe 100644 --- a/man1/memusage.1 +++ b/man1/memusage.1 @@ -25,7 +25,9 @@ .SH NAME memusage \- profile memory usage of a program .SH SYNOPSIS +.nf .BR memusage " [\fIoption\fR]... \fIprogram\fR [\fIprogramoption\fR]..." +.fi .SH DESCRIPTION .B memusage is a bash script which profiles memory usage of the program, diff --git a/man1/memusagestat.1 b/man1/memusagestat.1 index 9426469f5..30c903726 100644 --- a/man1/memusagestat.1 +++ b/man1/memusagestat.1 @@ -24,7 +24,9 @@ .SH NAME memusagestat \- generate graphic from memory profiling data .SH SYNOPSIS +.nf .BR memusagestat " [\fIoption\fR]... \fIdatafile\fR [\fIoutfile\fR]" +.fi .SH DESCRIPTION .B memusagestat creates a PNG file containing a graphical representation of the diff --git a/man1/mtrace.1 b/man1/mtrace.1 index d8fcc606f..7a87c7fd6 100644 --- a/man1/mtrace.1 +++ b/man1/mtrace.1 @@ -24,7 +24,9 @@ .SH NAME mtrace \- interpret the malloc trace log .SH SYNOPSIS +.nf .BR mtrace " [\fIoption\fR]... [\fIbinary\fR] \fImtracedata\fR" +.fi .SH DESCRIPTION .B mtrace is a Perl script used to interpret and provide human readable output diff --git a/man2/_exit.2 b/man2/_exit.2 index f62a0f544..b0ff38a53 100644 --- a/man2/_exit.2 +++ b/man2/_exit.2 @@ -30,6 +30,7 @@ .SH NAME _exit, _Exit \- terminate the calling process .SH SYNOPSIS +.nf .B #include .PP .BI "void _exit(int " status ); @@ -37,6 +38,7 @@ _exit, _Exit \- terminate the calling process .B #include .PP .BI "void _Exit(int " status ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man2/_syscall.2 b/man2/_syscall.2 index 8d45f6c74..e1fbe0176 100644 --- a/man2/_syscall.2 +++ b/man2/_syscall.2 @@ -39,11 +39,13 @@ .SH NAME _syscall \- invoking a system call without library support (OBSOLETE) .SH SYNOPSIS +.nf .B #include .PP A _syscall macro .PP desired system call +.fi .SH DESCRIPTION The important thing to know about a system call is its prototype. You need to know how many arguments, their types, diff --git a/man2/chdir.2 b/man2/chdir.2 index 10c642e67..31509ea67 100644 --- a/man2/chdir.2 +++ b/man2/chdir.2 @@ -34,11 +34,12 @@ .SH NAME chdir, fchdir \- change working directory .SH SYNOPSIS +.nf .B #include .PP .BI "int chdir(const char *" path ); -.br .BI "int fchdir(int " fd ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man2/epoll_ctl.2 b/man2/epoll_ctl.2 index e966f8c40..3ee192fab 100644 --- a/man2/epoll_ctl.2 +++ b/man2/epoll_ctl.2 @@ -22,10 +22,12 @@ .SH NAME epoll_ctl \- control interface for an epoll file descriptor .SH SYNOPSIS +.nf .B #include .PP .BI "int epoll_ctl(int " epfd ", int " op ", int " fd \ ", struct epoll_event *" event ); +.fi .SH DESCRIPTION This system call is used to add, modify, or remove entries in the interest list of the diff --git a/man2/eventfd.2 b/man2/eventfd.2 index a891943e7..a3999b060 100644 --- a/man2/eventfd.2 +++ b/man2/eventfd.2 @@ -23,9 +23,11 @@ .SH NAME eventfd \- create a file descriptor for event notification .SH SYNOPSIS +.nf .B #include .PP .BI "int eventfd(unsigned int " initval ", int " flags ); +.fi .SH DESCRIPTION .BR eventfd () creates an "eventfd object" that can be used as diff --git a/man2/execve.2 b/man2/execve.2 index 5e995f289..b6698da45 100644 --- a/man2/execve.2 +++ b/man2/execve.2 @@ -38,11 +38,12 @@ .SH NAME execve \- execute program .SH SYNOPSIS +.nf .B #include .PP .BI "int execve(const char *" pathname ", char *const " argv [], -.br .BI " char *const " envp []); +.fi .SH DESCRIPTION .BR execve () executes the program referred to by \fIpathname\fP. diff --git a/man2/execveat.2 b/man2/execveat.2 index 7c31d8f17..b5d1cd57e 100644 --- a/man2/execveat.2 +++ b/man2/execveat.2 @@ -27,13 +27,13 @@ .SH NAME execveat \- execute program relative to a directory file descriptor .SH SYNOPSIS +.nf .B #include .PP .BI "int execveat(int " dirfd ", const char *" pathname "," -.br .BI " char *const " argv "[], char *const " envp "[]," -.br .BI " int " flags ); +.fi .SH DESCRIPTION .\" commit 51f39a1f0cea1cacf8c787f652f26dfee9611874 The diff --git a/man2/fanotify_init.2 b/man2/fanotify_init.2 index ca03b11dc..62d07a465 100644 --- a/man2/fanotify_init.2 +++ b/man2/fanotify_init.2 @@ -25,11 +25,12 @@ .SH NAME fanotify_init \- create and initialize fanotify group .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .BI "int fanotify_init(unsigned int " flags ", unsigned int " event_f_flags ); +.fi .SH DESCRIPTION For an overview of the fanotify API, see .BR fanotify (7). diff --git a/man2/flock.2 b/man2/flock.2 index 2dce918b0..beb89d128 100644 --- a/man2/flock.2 +++ b/man2/flock.2 @@ -36,9 +36,11 @@ .SH NAME flock \- apply or remove an advisory lock on an open file .SH SYNOPSIS +.nf .B #include .PP .BI "int flock(int " fd ", int " operation ); +.fi .SH DESCRIPTION Apply or remove an advisory lock on the open file specified by .IR fd . diff --git a/man2/fork.2 b/man2/fork.2 index 7632d2dbe..ffc1bc1f6 100644 --- a/man2/fork.2 +++ b/man2/fork.2 @@ -40,11 +40,12 @@ .SH NAME fork \- create a child process .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .B pid_t fork(void); +.fi .SH DESCRIPTION .BR fork () creates a new process by duplicating the calling process. diff --git a/man2/fsync.2 b/man2/fsync.2 index f00bd6cdc..9deaf871a 100644 --- a/man2/fsync.2 +++ b/man2/fsync.2 @@ -39,11 +39,13 @@ .SH NAME fsync, fdatasync \- synchronize a file's in-core state with storage device .SH SYNOPSIS +.nf .B #include .PP .BI "int fsync(int " fd ); .PP .BI "int fdatasync(int " fd ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man2/getgid.2 b/man2/getgid.2 index 00c0dd67a..713fbfdc9 100644 --- a/man2/getgid.2 +++ b/man2/getgid.2 @@ -26,13 +26,13 @@ .SH NAME getgid, getegid \- get group identity .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .B gid_t getgid(void); -.br .B gid_t getegid(void); +.fi .SH DESCRIPTION .BR getgid () returns the real group ID of the calling process. diff --git a/man2/getgroups.2 b/man2/getgroups.2 index bae901f28..4b670d601 100644 --- a/man2/getgroups.2 +++ b/man2/getgroups.2 @@ -33,8 +33,8 @@ .SH NAME getgroups, setgroups \- get/set list of supplementary group IDs .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .BI "int getgroups(int " size ", gid_t " list []); @@ -42,6 +42,7 @@ getgroups, setgroups \- get/set list of supplementary group IDs .B #include .PP .BI "int setgroups(size_t " size ", const gid_t *" list ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man2/getpeername.2 b/man2/getpeername.2 index 3b71b3c7a..5b7eacce6 100644 --- a/man2/getpeername.2 +++ b/man2/getpeername.2 @@ -43,10 +43,12 @@ .SH NAME getpeername \- get name of connected peer socket .SH SYNOPSIS +.nf .B #include .PP .BI "int getpeername(int " sockfd ", struct sockaddr *" addr \ ", socklen_t *" addrlen ); +.fi .SH DESCRIPTION .BR getpeername () returns the address of the peer connected to the socket diff --git a/man2/getpid.2 b/man2/getpid.2 index b49c726a9..f2bf232ca 100644 --- a/man2/getpid.2 +++ b/man2/getpid.2 @@ -26,13 +26,13 @@ .SH NAME getpid, getppid \- get process identification .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .B pid_t getpid(void); -.br .B pid_t getppid(void); +.fi .SH DESCRIPTION .BR getpid () returns the process ID (PID) of the calling process. diff --git a/man2/getpriority.2 b/man2/getpriority.2 index 518c4a130..4646ca533 100644 --- a/man2/getpriority.2 +++ b/man2/getpriority.2 @@ -46,13 +46,13 @@ .SH NAME getpriority, setpriority \- get/set program scheduling priority .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .BI "int getpriority(int " which ", id_t " who ); -.br .BI "int setpriority(int " which ", id_t " who ", int " prio ); +.fi .SH DESCRIPTION The scheduling priority of the process, process group, or user, as indicated by diff --git a/man2/getrandom.2 b/man2/getrandom.2 index 41199336b..1a9fea7bf 100644 --- a/man2/getrandom.2 +++ b/man2/getrandom.2 @@ -28,9 +28,11 @@ .SH NAME getrandom \- obtain a series of random bytes .SH SYNOPSIS +.nf .B #include .PP .BI "ssize_t getrandom(void *"buf ", size_t " buflen ", unsigned int " flags ); +.fi .SH DESCRIPTION The .BR getrandom () diff --git a/man2/getresuid.2 b/man2/getresuid.2 index 5e6ed0dd4..ce24005b4 100644 --- a/man2/getresuid.2 +++ b/man2/getresuid.2 @@ -29,13 +29,13 @@ .SH NAME getresuid, getresgid \- get real, effective and saved user/group IDs .SH SYNOPSIS +.nf .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" -.br .B #include .PP .BI "int getresuid(uid_t *" ruid ", uid_t *" euid ", uid_t *" suid ); -.br .BI "int getresgid(gid_t *" rgid ", gid_t *" egid ", gid_t *" sgid ); +.fi .SH DESCRIPTION .BR getresuid () returns the real UID, the effective UID, and the saved set-user-ID diff --git a/man2/getrlimit.2 b/man2/getrlimit.2 index 198e285d8..417532ea0 100644 --- a/man2/getrlimit.2 +++ b/man2/getrlimit.2 @@ -65,18 +65,16 @@ .SH NAME getrlimit, setrlimit, prlimit \- get/set resource limits .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .BI "int getrlimit(int " resource ", struct rlimit *" rlim ); -.br .BI "int setrlimit(int " resource ", const struct rlimit *" rlim ); .PP -.BI "int prlimit(pid_t " pid ", int " resource \ -", const struct rlimit *" new_limit , -.br +.BI "int prlimit(pid_t " pid ", int " resource ", const struct rlimit *" new_limit , .BI " struct rlimit *" old_limit ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man2/getrusage.2 b/man2/getrusage.2 index 202eb0ece..398e33cd9 100644 --- a/man2/getrusage.2 +++ b/man2/getrusage.2 @@ -40,11 +40,12 @@ .SH NAME getrusage \- get resource usage .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .BI "int getrusage(int " who ", struct rusage *" usage ); +.fi .SH DESCRIPTION .BR getrusage () returns resource usage measures for diff --git a/man2/getsid.2 b/man2/getsid.2 index e01624372..12b833e7f 100644 --- a/man2/getsid.2 +++ b/man2/getsid.2 @@ -28,11 +28,12 @@ .SH NAME getsid \- get session ID .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .BI "pid_t getsid(pid_t" " pid" ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man2/getuid.2 b/man2/getuid.2 index ca2ccecc4..76ffe8b60 100644 --- a/man2/getuid.2 +++ b/man2/getuid.2 @@ -27,13 +27,13 @@ .SH NAME getuid, geteuid \- get user identity .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .B uid_t getuid(void); -.br .B uid_t geteuid(void); +.fi .SH DESCRIPTION .BR getuid () returns the real user ID of the calling process. diff --git a/man2/idle.2 b/man2/idle.2 index b39dfdb8c..bee2adfeb 100644 --- a/man2/idle.2 +++ b/man2/idle.2 @@ -33,9 +33,11 @@ .SH NAME idle \- make process 0 idle .SH SYNOPSIS +.nf .B #include .PP .B int idle(void); +.fi .SH DESCRIPTION .BR idle () is an internal system call used during bootstrap. diff --git a/man2/inotify_add_watch.2 b/man2/inotify_add_watch.2 index dcff071f7..f35ede144 100644 --- a/man2/inotify_add_watch.2 +++ b/man2/inotify_add_watch.2 @@ -29,9 +29,11 @@ .SH NAME inotify_add_watch \- add a watch to an initialized inotify instance .SH SYNOPSIS +.nf .B #include .PP .BI "int inotify_add_watch(int " fd ", const char *" pathname ", uint32_t " mask ); +.fi .SH DESCRIPTION .BR inotify_add_watch () adds a new watch, or modifies an existing watch, diff --git a/man2/inotify_rm_watch.2 b/man2/inotify_rm_watch.2 index 38e5c150d..eae66d59d 100644 --- a/man2/inotify_rm_watch.2 +++ b/man2/inotify_rm_watch.2 @@ -28,11 +28,13 @@ .SH NAME inotify_rm_watch \- remove an existing watch from an inotify instance .SH SYNOPSIS +.nf .B #include .PP .BI "int inotify_rm_watch(int " fd ", int " wd ); .\" Before glibc 2.10, the second argument was types as uint32_t. .\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=7040 +.fi .SH DESCRIPTION .BR inotify_rm_watch () removes the watch associated with the watch descriptor diff --git a/man2/ioctl.2 b/man2/ioctl.2 index 907cc9953..562bf2728 100644 --- a/man2/ioctl.2 +++ b/man2/ioctl.2 @@ -42,11 +42,13 @@ .SH NAME ioctl \- control device .SH SYNOPSIS +.nf .B #include .PP .BI "int ioctl(int " fd ", unsigned long " request ", ...);" .\" POSIX says 'request' is int, but glibc has the above .\" See https://bugzilla.kernel.org/show_bug.cgi?id=42705 +.fi .SH DESCRIPTION The .BR ioctl () diff --git a/man2/ioctl_ficlonerange.2 b/man2/ioctl_ficlonerange.2 index 4b9b95024..a7b8a4787 100644 --- a/man2/ioctl_ficlonerange.2 +++ b/man2/ioctl_ficlonerange.2 @@ -24,13 +24,13 @@ .SH NAME ioctl_ficlonerange, ioctl_ficlone \- share some the data of one file with another file .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .BI "int ioctl(int " dest_fd ", FICLONERANGE, struct file_clone_range *" arg ); -.br .BI "int ioctl(int " dest_fd ", FICLONE, int " src_fd ); +.fi .SH DESCRIPTION If a filesystem supports files sharing physical storage between multiple files ("reflink"), this diff --git a/man2/ioctl_fideduperange.2 b/man2/ioctl_fideduperange.2 index 8b846c0a7..5282893dd 100644 --- a/man2/ioctl_fideduperange.2 +++ b/man2/ioctl_fideduperange.2 @@ -24,11 +24,12 @@ .SH NAME ioctl_fideduperange \- share some the data of one file with another file .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .BI "int ioctl(int " src_fd ", FIDEDUPERANGE, struct file_dedupe_range *" arg ); +.fi .SH DESCRIPTION If a filesystem supports files sharing physical storage between multiple files, this diff --git a/man2/ioctl_fslabel.2 b/man2/ioctl_fslabel.2 index dcd3ba86a..06e475631 100644 --- a/man2/ioctl_fslabel.2 +++ b/man2/ioctl_fslabel.2 @@ -24,13 +24,13 @@ .SH NAME ioctl_fslabel \- get or set a filesystem label .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .BI "int ioctl(int " fd ", FS_IOC_GETFSLABEL, char " label [FSLABEL_MAX]); -.br .BI "int ioctl(int " fd ", FS_IOC_SETFSLABEL, char " label [FSLABEL_MAX]); +.fi .SH DESCRIPTION If a filesystem supports online label manipulation, these .BR ioctl (2) diff --git a/man2/ioctl_getfsmap.2 b/man2/ioctl_getfsmap.2 index 1771d46eb..5830e99f9 100644 --- a/man2/ioctl_getfsmap.2 +++ b/man2/ioctl_getfsmap.2 @@ -24,13 +24,13 @@ .SH NAME ioctl_getfsmap \- retrieve the physical layout of the filesystem .SH SYNOPSIS +.nf .B #include -.br .B #include -.br .B #include .PP .BI "int ioctl(int " fd ", FS_IOC_GETFSMAP, struct fsmap_head * " arg ); +.fi .SH DESCRIPTION This .BR ioctl (2) diff --git a/man2/ioctl_tty.2 b/man2/ioctl_tty.2 index a4c21c833..1e5337202 100644 --- a/man2/ioctl_tty.2 +++ b/man2/ioctl_tty.2 @@ -9,9 +9,11 @@ .SH NAME ioctl_tty \- ioctls for terminals and serial lines .SH SYNOPSIS +.nf .B "#include " .PP .BI "int ioctl(int " fd ", int " cmd ", ...);" +.fi .SH DESCRIPTION The .BR ioctl (2) diff --git a/man2/ioperm.2 b/man2/ioperm.2 index 86639daca..991f8c49d 100644 --- a/man2/ioperm.2 +++ b/man2/ioperm.2 @@ -35,10 +35,11 @@ .SH NAME ioperm \- set port input/output permissions .SH SYNOPSIS -.B #include -/* for glibc */ +.nf +.BR "#include " " /* for glibc */" .PP .BI "int ioperm(unsigned long " from ", unsigned long " num ", int " turn_on ); +.fi .SH DESCRIPTION .BR ioperm () sets the port access permission bits for the calling thread for diff --git a/man2/iopl.2 b/man2/iopl.2 index 722780da9..8e4ef95f4 100644 --- a/man2/iopl.2 +++ b/man2/iopl.2 @@ -34,9 +34,11 @@ .SH NAME iopl \- change I/O privilege level .SH SYNOPSIS +.nf .B #include .PP .BI "int iopl(int " level ); +.fi .SH DESCRIPTION .BR iopl () changes the I/O privilege level of the calling thread, diff --git a/man2/lookup_dcookie.2 b/man2/lookup_dcookie.2 index 24ae1d538..f98d771dc 100644 --- a/man2/lookup_dcookie.2 +++ b/man2/lookup_dcookie.2 @@ -28,7 +28,9 @@ .SH NAME lookup_dcookie \- return a directory entry's path .SH SYNOPSIS +.nf .BI "int lookup_dcookie(u64 " cookie ", char *" buffer ", size_t " len ); +.fi .SH DESCRIPTION Look up the full path of the directory entry specified by the value .IR cookie . diff --git a/man2/lseek.2 b/man2/lseek.2 index e35e410a6..ad5526b66 100644 --- a/man2/lseek.2 +++ b/man2/lseek.2 @@ -47,11 +47,12 @@ .SH NAME lseek \- reposition read/write file offset .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .BI "off_t lseek(int " fd ", off_t " offset ", int " whence ); +.fi .SH DESCRIPTION .BR lseek () repositions the file offset of the open file description diff --git a/man2/madvise.2 b/man2/madvise.2 index 8f4a3039a..af1040bc6 100644 --- a/man2/madvise.2 +++ b/man2/madvise.2 @@ -36,9 +36,11 @@ .SH NAME madvise \- give advice about use of memory .SH SYNOPSIS +.nf .B #include .PP .BI "int madvise(void *" addr ", size_t " length ", int " advice ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man2/mincore.2 b/man2/mincore.2 index 7d3ea51e4..b43f19843 100644 --- a/man2/mincore.2 +++ b/man2/mincore.2 @@ -35,11 +35,12 @@ .SH NAME mincore \- determine whether pages are resident in memory .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .BI "int mincore(void *" addr ", size_t " length ", unsigned char *" vec ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man2/msync.2 b/man2/msync.2 index 647a29a6a..22aae6bb7 100644 --- a/man2/msync.2 +++ b/man2/msync.2 @@ -26,9 +26,11 @@ .SH NAME msync \- synchronize a file with a memory map .SH SYNOPSIS +.nf .B #include .PP .BI "int msync(void *" addr ", size_t " length ", int " flags ); +.fi .SH DESCRIPTION .BR msync () flushes changes made to the in-core copy of a file that was mapped diff --git a/man2/nanosleep.2 b/man2/nanosleep.2 index 71c7666c6..248cfb157 100644 --- a/man2/nanosleep.2 +++ b/man2/nanosleep.2 @@ -35,9 +35,11 @@ .SH NAME nanosleep \- high-resolution sleep .SH SYNOPSIS +.nf .B #include .PP .BI "int nanosleep(const struct timespec *" req ", struct timespec *" rem ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man2/nice.2 b/man2/nice.2 index 80d1d3e91..7cfca9e32 100644 --- a/man2/nice.2 +++ b/man2/nice.2 @@ -32,9 +32,11 @@ .SH NAME nice \- change process priority .SH SYNOPSIS +.nf .B #include .PP .BI "int nice(int " inc ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man2/pause.2 b/man2/pause.2 index 0ebdc3206..c8b2f9f48 100644 --- a/man2/pause.2 +++ b/man2/pause.2 @@ -31,9 +31,11 @@ .SH NAME pause \- wait for signal .SH SYNOPSIS +.nf .B #include .PP .B int pause(void); +.fi .SH DESCRIPTION .BR pause () causes the calling process (or thread) to sleep diff --git a/man2/personality.2 b/man2/personality.2 index 7358bba06..4931635f3 100644 --- a/man2/personality.2 +++ b/man2/personality.2 @@ -34,9 +34,11 @@ .SH NAME personality \- set the process execution domain .SH SYNOPSIS +.nf .B #include .PP .BI "int personality(unsigned long " persona ); +.fi .SH DESCRIPTION Linux supports different execution domains, or personalities, for each process. diff --git a/man2/pivot_root.2 b/man2/pivot_root.2 index 51e308cce..3871b6e5b 100644 --- a/man2/pivot_root.2 +++ b/man2/pivot_root.2 @@ -28,7 +28,9 @@ .SH NAME pivot_root \- change the root mount .SH SYNOPSIS +.nf .BI "int pivot_root(const char *" new_root ", const char *" put_old ); +.fi .PP .IR Note : There is no glibc wrapper for this system call; see NOTES. diff --git a/man2/reboot.2 b/man2/reboot.2 index c3d9dee1b..869971ea7 100644 --- a/man2/reboot.2 +++ b/man2/reboot.2 @@ -29,11 +29,11 @@ .SH NAME reboot \- reboot or enable/disable Ctrl-Alt-Del .SH SYNOPSIS +.nf /* Since kernel version 2.1.30 there are symbolic names LINUX_REBOOT_* for the constants and a fourth argument to the call: */ .PP .B #include -.br .B #include .PP .BI "int reboot(int " magic ", int " magic2 ", int " cmd ", void *" arg ); @@ -44,10 +44,10 @@ reboot \- reboot or enable/disable Ctrl-Alt-Del wrapper around the system call: */ .PP .B #include -.br .B #include .PP .BI "int reboot(int " cmd ); +.fi .SH DESCRIPTION The .BR reboot () diff --git a/man2/restart_syscall.2 b/man2/restart_syscall.2 index d0c46043d..3fb8ad29a 100644 --- a/man2/restart_syscall.2 +++ b/man2/restart_syscall.2 @@ -34,7 +34,9 @@ .SH NAME restart_syscall \- restart a system call after interruption by a stop signal .SH SYNOPSIS +.nf .B long restart_syscall(void); +.fi .PP .IR Note : There is no glibc wrapper for this system call; see NOTES. diff --git a/man2/rmdir.2 b/man2/rmdir.2 index 0ee02573d..366af448f 100644 --- a/man2/rmdir.2 +++ b/man2/rmdir.2 @@ -31,9 +31,11 @@ .SH NAME rmdir \- delete a directory .SH SYNOPSIS +.nf .B #include .PP .BI "int rmdir(const char *" pathname ); +.fi .SH DESCRIPTION .BR rmdir () deletes a directory, which must be empty. diff --git a/man2/sched_rr_get_interval.2 b/man2/sched_rr_get_interval.2 index 04f0725be..bce1ee0d3 100644 --- a/man2/sched_rr_get_interval.2 +++ b/man2/sched_rr_get_interval.2 @@ -30,9 +30,11 @@ .SH NAME sched_rr_get_interval \- get the SCHED_RR interval for the named process .SH SYNOPSIS +.nf .B #include .PP .BI "int sched_rr_get_interval(pid_t " pid ", struct timespec *" tp ); +.fi .SH DESCRIPTION .BR sched_rr_get_interval () writes into the diff --git a/man2/sched_yield.2 b/man2/sched_yield.2 index 92dd1c52b..515fc0b83 100644 --- a/man2/sched_yield.2 +++ b/man2/sched_yield.2 @@ -30,9 +30,11 @@ .SH NAME sched_yield \- yield the processor .SH SYNOPSIS +.nf .B #include .PP .B int sched_yield(void); +.fi .SH DESCRIPTION .BR sched_yield () causes the calling thread to relinquish the CPU. diff --git a/man2/sendfile.2 b/man2/sendfile.2 index f0ead4a9b..5e3380cb8 100644 --- a/man2/sendfile.2 +++ b/man2/sendfile.2 @@ -20,6 +20,7 @@ .SH NAME sendfile \- transfer data between file descriptors .SH SYNOPSIS +.nf .B #include .PP .BI "ssize_t sendfile(int" " out_fd" ", int" " in_fd" ", off_t *" \ @@ -28,22 +29,16 @@ sendfile \- transfer data between file descriptors .\" in the notes, not in the header. .\" .\" .B #include -.\" .br .\" .B #if (__GLIBC__==2 && __GLIBC_MINOR__>=1) || __GLIBC__>2 -.\" .br .\" .B #include -.\" .br .\" #else -.\" .br .\" .B #include -.\" .br .\" .B /* No system prototype before glibc 2.1. */ -.\" .br .\" .BI "ssize_t sendfile(int" " out_fd" ", int" " in_fd" ", off_t *" \ .\" offset ", size_t" " count" ) -.\" .br .\" .B #endif .\" +.fi .SH DESCRIPTION .BR sendfile () copies data between one file descriptor and another. diff --git a/man2/seteuid.2 b/man2/seteuid.2 index 7fff19b87..00587eb33 100644 --- a/man2/seteuid.2 +++ b/man2/seteuid.2 @@ -30,13 +30,13 @@ .SH NAME seteuid, setegid \- set effective user or group ID .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .BI "int seteuid(uid_t " euid ); -.br .BI "int setegid(gid_t " egid ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man2/setfsgid.2 b/man2/setfsgid.2 index 672a9c355..e2d4d09f3 100644 --- a/man2/setfsgid.2 +++ b/man2/setfsgid.2 @@ -33,9 +33,11 @@ .SH NAME setfsgid \- set group identity used for filesystem checks .SH SYNOPSIS +.nf .B #include .PP .BI "int setfsgid(uid_t " fsgid ); +.fi .SH DESCRIPTION On Linux, a process has both a filesystem group ID and an effective group ID. The (Linux-specific) filesystem group ID is used diff --git a/man2/setfsuid.2 b/man2/setfsuid.2 index bce1be1b9..93aabe9cd 100644 --- a/man2/setfsuid.2 +++ b/man2/setfsuid.2 @@ -33,9 +33,11 @@ .SH NAME setfsuid \- set user identity used for filesystem checks .SH SYNOPSIS +.nf .B #include .PP .BI "int setfsuid(uid_t " fsuid ); +.fi .SH DESCRIPTION On Linux, a process has both a filesystem user ID and an effective user ID. The (Linux-specific) filesystem user ID is used diff --git a/man2/setgid.2 b/man2/setgid.2 index fedb9ed95..4135e8713 100644 --- a/man2/setgid.2 +++ b/man2/setgid.2 @@ -31,11 +31,12 @@ .SH NAME setgid \- set group identity .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .BI "int setgid(gid_t " gid ); +.fi .SH DESCRIPTION .BR setgid () sets the effective group ID of the calling process. diff --git a/man2/setresuid.2 b/man2/setresuid.2 index 19e3c9253..21d81c6ee 100644 --- a/man2/setresuid.2 +++ b/man2/setresuid.2 @@ -28,13 +28,13 @@ .SH NAME setresuid, setresgid \- set real, effective and saved user or group ID .SH SYNOPSIS +.nf .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" -.br .B #include .PP .BI "int setresuid(uid_t " ruid ", uid_t " euid ", uid_t " suid ); -.br .BI "int setresgid(gid_t " rgid ", gid_t " egid ", gid_t " sgid ); +.fi .SH DESCRIPTION .BR setresuid () sets the real user ID, the effective user ID, and the diff --git a/man2/setreuid.2 b/man2/setreuid.2 index 01c28fc06..dca5ebee6 100644 --- a/man2/setreuid.2 +++ b/man2/setreuid.2 @@ -47,13 +47,13 @@ .SH NAME setreuid, setregid \- set real and/or effective user or group ID .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .BI "int setreuid(uid_t " ruid ", uid_t " euid ); -.br .BI "int setregid(gid_t " rgid ", gid_t " egid ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man2/setsid.2 b/man2/setsid.2 index d2f4cc3b2..38d5fb1fb 100644 --- a/man2/setsid.2 +++ b/man2/setsid.2 @@ -32,14 +32,14 @@ .SH NAME setsid \- creates a session and sets the process group ID .SH SYNOPSIS +.nf .ad l .B #include -.br .B #include .PP .B pid_t setsid(void); -.br .ad b +.fi .SH DESCRIPTION .BR setsid () creates a new session if the calling process is not a diff --git a/man2/setuid.2 b/man2/setuid.2 index f4726dcf0..fa4636fcb 100644 --- a/man2/setuid.2 +++ b/man2/setuid.2 @@ -32,11 +32,12 @@ .SH NAME setuid \- set user identity .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .BI "int setuid(uid_t " uid ); +.fi .SH DESCRIPTION .BR setuid () sets the effective user ID of the calling process. diff --git a/man2/setup.2 b/man2/setup.2 index 9b803ff1d..60e5b90e7 100644 --- a/man2/setup.2 +++ b/man2/setup.2 @@ -35,9 +35,11 @@ .SH NAME setup \- setup devices and filesystems, mount root filesystem .SH SYNOPSIS +.nf .B #include .PP .B int setup(void); +.fi .SH DESCRIPTION .BR setup () is called once from within diff --git a/man2/shmctl.2 b/man2/shmctl.2 index f67e32d9d..3ff58f1e4 100644 --- a/man2/shmctl.2 +++ b/man2/shmctl.2 @@ -47,13 +47,14 @@ .SH NAME shmctl \- System V shared memory control .SH SYNOPSIS +.nf .ad l .B #include -.br .B #include .PP .BI "int shmctl(int " shmid ", int " cmd ", struct shmid_ds *" buf ); .ad b +.fi .SH DESCRIPTION .BR shmctl () performs the control operation specified by diff --git a/man2/shmget.2 b/man2/shmget.2 index 4f58c8a4f..d931ee34e 100644 --- a/man2/shmget.2 +++ b/man2/shmget.2 @@ -39,13 +39,14 @@ .SH NAME shmget \- allocates a System V shared memory segment .SH SYNOPSIS +.nf .ad l .B #include -.br .B #include .PP .BI "int shmget(key_t " key ", size_t " size ", int " shmflg ); .ad b +.fi .SH DESCRIPTION .BR shmget () returns the identifier of the System\ V shared memory segment diff --git a/man2/shutdown.2 b/man2/shutdown.2 index 9c85fa1fa..1c865be90 100644 --- a/man2/shutdown.2 +++ b/man2/shutdown.2 @@ -41,9 +41,11 @@ .SH NAME shutdown \- shut down part of a full-duplex connection .SH SYNOPSIS +.nf .B #include .PP .BI "int shutdown(int " sockfd ", int " how ); +.fi .SH DESCRIPTION The .BR shutdown () diff --git a/man2/sigaltstack.2 b/man2/sigaltstack.2 index c2d9b95b5..2584a2dea 100644 --- a/man2/sigaltstack.2 +++ b/man2/sigaltstack.2 @@ -27,9 +27,11 @@ .SH NAME sigaltstack \- set and/or get signal stack context .SH SYNOPSIS +.nf .B #include .PP .BI "int sigaltstack(const stack_t *" ss ", stack_t *" old_ss ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man2/signal.2 b/man2/signal.2 index ad1b38d41..b389b429c 100644 --- a/man2/signal.2 +++ b/man2/signal.2 @@ -37,11 +37,13 @@ .SH NAME signal \- ANSI C signal handling .SH SYNOPSIS +.nf .B #include .PP .B typedef void (*sighandler_t)(int); .PP .BI "sighandler_t signal(int " signum ", sighandler_t " handler ); +.fi .SH DESCRIPTION .BR WARNING : the behavior of diff --git a/man2/signalfd.2 b/man2/signalfd.2 index a22f840d9..703b1302c 100644 --- a/man2/signalfd.2 +++ b/man2/signalfd.2 @@ -21,9 +21,11 @@ .SH NAME signalfd \- create a file descriptor for accepting signals .SH SYNOPSIS +.nf .B #include .PP .BI "int signalfd(int " fd ", const sigset_t *" mask ", int " flags ); +.fi .SH DESCRIPTION .BR signalfd () creates a file descriptor that can be used to accept signals diff --git a/man2/sigpending.2 b/man2/sigpending.2 index f825139dd..b04a17d50 100644 --- a/man2/sigpending.2 +++ b/man2/sigpending.2 @@ -30,9 +30,11 @@ .SH NAME sigpending, rt_sigpending \- examine pending signals .SH SYNOPSIS +.nf .B #include .PP .BI "int sigpending(sigset_t *" set ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man2/sigreturn.2 b/man2/sigreturn.2 index c4f49b9d7..d0f5eb829 100644 --- a/man2/sigreturn.2 +++ b/man2/sigreturn.2 @@ -31,7 +31,9 @@ .SH NAME sigreturn, rt_sigreturn \- return from signal handler and cleanup stack frame .SH SYNOPSIS +.nf .BI "int sigreturn(...);" +.fi .SH DESCRIPTION If the Linux kernel determines that an unblocked signal is pending for a process, then, diff --git a/man2/sigsuspend.2 b/man2/sigsuspend.2 index c17b352d7..217703ed3 100644 --- a/man2/sigsuspend.2 +++ b/man2/sigsuspend.2 @@ -30,9 +30,11 @@ .SH NAME sigsuspend, rt_sigsuspend \- wait for a signal .SH SYNOPSIS +.nf .B #include .PP .BI "int sigsuspend(const sigset_t *" mask ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man2/socket.2 b/man2/socket.2 index 96860c102..e780426ac 100644 --- a/man2/socket.2 +++ b/man2/socket.2 @@ -43,11 +43,12 @@ .SH NAME socket \- create an endpoint for communication .SH SYNOPSIS +.nf .BR "#include " " /* See NOTES */" -.br .B #include .PP .BI "int socket(int " domain ", int " type ", int " protocol ); +.fi .SH DESCRIPTION .BR socket () creates an endpoint for communication and returns a file descriptor diff --git a/man2/socketcall.2 b/man2/socketcall.2 index c4514c7cc..a3012d4c7 100644 --- a/man2/socketcall.2 +++ b/man2/socketcall.2 @@ -26,9 +26,11 @@ .SH NAME socketcall \- socket system calls .SH SYNOPSIS +.nf .B #include .PP .BI "int socketcall(int " call ", unsigned long *" args ); +.fi .SH DESCRIPTION .BR socketcall () is a common kernel entry point for the socket system calls. diff --git a/man2/socketpair.2 b/man2/socketpair.2 index 0cc6e5ae1..d09d897b7 100644 --- a/man2/socketpair.2 +++ b/man2/socketpair.2 @@ -43,12 +43,13 @@ .SH NAME socketpair \- create a pair of connected sockets .SH SYNOPSIS +.nf .BR "#include " " /* See NOTES */" -.br .B #include .PP .BI "int socketpair(int " domain ", int " type ", int " protocol \ ", int " sv [2]); +.fi .SH DESCRIPTION The .BR socketpair () diff --git a/man2/statfs.2 b/man2/statfs.2 index 4f5fc6948..a47bec9a9 100644 --- a/man2/statfs.2 +++ b/man2/statfs.2 @@ -29,11 +29,12 @@ .SH NAME statfs, fstatfs \- get filesystem statistics .SH SYNOPSIS +.nf .BR "#include " "/* or */" .PP .BI "int statfs(const char *" path ", struct statfs *" buf ); -.br .BI "int fstatfs(int " fd ", struct statfs *" buf ); +.fi .SH DESCRIPTION The .BR statfs () diff --git a/man2/stime.2 b/man2/stime.2 index 3ff0ebe97..53726f235 100644 --- a/man2/stime.2 +++ b/man2/stime.2 @@ -31,9 +31,11 @@ .SH NAME stime \- set time .SH SYNOPSIS +.nf .B #include .PP .BI "int stime(const time_t *" t ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man2/swapon.2 b/man2/swapon.2 index 887a4f3a6..f9c5d23d9 100644 --- a/man2/swapon.2 +++ b/man2/swapon.2 @@ -43,13 +43,13 @@ .SH NAME swapon, swapoff \- start/stop swapping to file/device .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .BI "int swapon(const char *" path ", int " swapflags ); -.br .BI "int swapoff(const char *" path ); +.fi .SH DESCRIPTION .BR swapon () sets the swap area to the file or block device specified by diff --git a/man2/sync.2 b/man2/sync.2 index 701ac9a4a..25bd2a8b5 100644 --- a/man2/sync.2 +++ b/man2/sync.2 @@ -37,11 +37,13 @@ .SH NAME sync, syncfs \- commit filesystem caches to disk .SH SYNOPSIS +.nf .B #include .PP .B void sync(void); .PP .BI "int syncfs(int " fd ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man2/syscalls.2 b/man2/syscalls.2 index a74005715..e8cb489b1 100644 --- a/man2/syscalls.2 +++ b/man2/syscalls.2 @@ -32,7 +32,9 @@ .SH NAME syscalls \- Linux system calls .SH SYNOPSIS +.nf Linux system calls. +.fi .SH DESCRIPTION The system call is the fundamental interface between an application and the Linux kernel. diff --git a/man2/sysinfo.2 b/man2/sysinfo.2 index a4b1e50d0..ab58dae88 100644 --- a/man2/sysinfo.2 +++ b/man2/sysinfo.2 @@ -36,9 +36,11 @@ .SH NAME sysinfo \- return system information .SH SYNOPSIS +.nf .B #include .PP .BI "int sysinfo(struct sysinfo *" info ); +.fi .SH DESCRIPTION .BR sysinfo () returns certain statistics on memory and swap usage, diff --git a/man2/time.2 b/man2/time.2 index a3087dfec..3cc215339 100644 --- a/man2/time.2 +++ b/man2/time.2 @@ -30,9 +30,11 @@ .SH NAME time \- get time in seconds .SH SYNOPSIS +.nf .B #include .PP .BI "time_t time(time_t *" tloc ); +.fi .SH DESCRIPTION .BR time () returns the time as the number of seconds since the diff --git a/man2/times.2 b/man2/times.2 index 4b00dcaa4..f9a53d2be 100644 --- a/man2/times.2 +++ b/man2/times.2 @@ -39,9 +39,11 @@ .SH NAME times \- get process times .SH SYNOPSIS +.nf .B #include .PP .BI "clock_t times(struct tms *" buf ); +.fi .SH DESCRIPTION .BR times () stores the current process times in the diff --git a/man2/truncate.2 b/man2/truncate.2 index 0f752d390..9716625d1 100644 --- a/man2/truncate.2 +++ b/man2/truncate.2 @@ -44,13 +44,13 @@ .SH NAME truncate, ftruncate \- truncate a file to a specified length .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .BI "int truncate(const char *" path ", off_t " length ); -.br .BI "int ftruncate(int " fd ", off_t " length ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man2/umask.2 b/man2/umask.2 index a4e7a935c..c4ce9ea60 100644 --- a/man2/umask.2 +++ b/man2/umask.2 @@ -35,11 +35,12 @@ .SH NAME umask \- set file mode creation mask .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .BI "mode_t umask(mode_t " mask ); +.fi .SH DESCRIPTION .BR umask () sets the calling process's file mode creation mask (umask) to diff --git a/man2/uname.2 b/man2/uname.2 index 8cd7a7c3e..897ba0e11 100644 --- a/man2/uname.2 +++ b/man2/uname.2 @@ -28,9 +28,11 @@ .SH NAME uname \- get name and information about current kernel .SH SYNOPSIS +.nf .B #include .PP .BI "int uname(struct utsname *" buf ); +.fi .SH DESCRIPTION .BR uname () returns system information in the structure pointed to by diff --git a/man2/unimplemented.2 b/man2/unimplemented.2 index 2aca7b66d..9924a3f7f 100644 --- a/man2/unimplemented.2 +++ b/man2/unimplemented.2 @@ -29,7 +29,9 @@ afs_syscall, break, fattach, fdetach, ftime, getmsg, getpmsg, gtty, isastream, lock, madvise1, mpx, prof, profil, putmsg, putpmsg, security, stty, tuxcall, ulimit, vserver \- unimplemented system calls .SH SYNOPSIS +.nf Unimplemented system calls. +.fi .SH DESCRIPTION These system calls are not implemented in the Linux kernel. .SH RETURN VALUE diff --git a/man2/uselib.2 b/man2/uselib.2 index bc031d11f..9c4ca5bf2 100644 --- a/man2/uselib.2 +++ b/man2/uselib.2 @@ -32,9 +32,11 @@ .SH NAME uselib \- load shared library .SH SYNOPSIS +.nf .B #include .PP .BI "int uselib(const char *" library ); +.fi .PP .IR Note : No declaration of this system call is provided in glibc headers; see NOTES. diff --git a/man2/write.2 b/man2/write.2 index 2c4c0c2c5..37b251d9f 100644 --- a/man2/write.2 +++ b/man2/write.2 @@ -40,9 +40,11 @@ .SH NAME write \- write to a file descriptor .SH SYNOPSIS +.nf .B #include .PP .BI "ssize_t write(int " fd ", const void *" buf ", size_t " count ); +.fi .SH DESCRIPTION .BR write () writes up to diff --git a/man3/__ppc_set_ppr_med.3 b/man3/__ppc_set_ppr_med.3 index 732e8b8e0..c50d957cb 100644 --- a/man3/__ppc_set_ppr_med.3 +++ b/man3/__ppc_set_ppr_med.3 @@ -28,17 +28,15 @@ Programmer's Manual" __ppc_set_ppr_med, __ppc_set_ppr_very_low, __ppc_set_ppr_low, __ppc_set_ppr_med_low, __ppc_set_ppr_med_high \- Set the Program Priority Register .SH SYNOPSIS +.nf .B #include .PP .B void __ppc_set_ppr_med(void); -.br .B void __ppc_set_ppr_very_low(void); -.br .B void __ppc_set_ppr_low(void); -.br .B void __ppc_set_ppr_med_low(void); -.br .B void __ppc_set_ppr_med_high(void); +.fi .SH DESCRIPTION These functions provide access to the .I Program Priority Register diff --git a/man3/__ppc_yield.3 b/man3/__ppc_yield.3 index b9bfc739e..57c6c593f 100644 --- a/man3/__ppc_yield.3 +++ b/man3/__ppc_yield.3 @@ -28,13 +28,13 @@ Manual" __ppc_yield, __ppc_mdoio, __ppc_mdoom \- Hint the processor to release shared resources .SH SYNOPSIS +.nf .B #include .PP .B void __ppc_yield(void); -.br .B void __ppc_mdoio(void); -.br .B void __ppc_mdoom(void); +.fi .SH DESCRIPTION These functions provide hints about the usage of resources that are shared with other diff --git a/man3/__setfpucw.3 b/man3/__setfpucw.3 index be546d6b9..3c3d3a095 100644 --- a/man3/__setfpucw.3 +++ b/man3/__setfpucw.3 @@ -9,9 +9,11 @@ .SH NAME __setfpucw \- set FPU control word on i386 architecture (obsolete) .SH SYNOPSIS +.nf .B #include .PP .BI "void __setfpucw(unsigned short " control_word ); +.fi .SH DESCRIPTION .BR __setfpucw () transfers diff --git a/man3/aio_cancel.3 b/man3/aio_cancel.3 index 3cc9bbef4..36e9f126e 100644 --- a/man3/aio_cancel.3 +++ b/man3/aio_cancel.3 @@ -25,11 +25,13 @@ .SH NAME aio_cancel \- cancel an outstanding asynchronous I/O request .SH SYNOPSIS +.nf .B "#include " .PP .BI "int aio_cancel(int " fd ", struct aiocb *" aiocbp ); .PP Link with \fI\-lrt\fP. +.fi .SH DESCRIPTION The .BR aio_cancel () diff --git a/man3/aio_error.3 b/man3/aio_error.3 index f35fc72b5..776c61697 100644 --- a/man3/aio_error.3 +++ b/man3/aio_error.3 @@ -25,11 +25,13 @@ .SH NAME aio_error \- get error status of asynchronous I/O operation .SH SYNOPSIS +.nf .B "#include " .PP .BI "int aio_error(const struct aiocb *" aiocbp ); .PP Link with \fI\-lrt\fP. +.fi .SH DESCRIPTION The .BR aio_error () diff --git a/man3/aio_fsync.3 b/man3/aio_fsync.3 index 537782bb3..48f15c173 100644 --- a/man3/aio_fsync.3 +++ b/man3/aio_fsync.3 @@ -25,11 +25,13 @@ .SH NAME aio_fsync \- asynchronous file synchronization .SH SYNOPSIS +.nf .B "#include " .PP .BI "int aio_fsync(int " op ", struct aiocb *" aiocbp ); .PP Link with \fI\-lrt\fP. +.fi .SH DESCRIPTION The .BR aio_fsync () diff --git a/man3/aio_read.3 b/man3/aio_read.3 index 2f796c391..c5d177858 100644 --- a/man3/aio_read.3 +++ b/man3/aio_read.3 @@ -25,11 +25,13 @@ .SH NAME aio_read \- asynchronous read .SH SYNOPSIS +.nf .B "#include " .PP .BI "int aio_read(struct aiocb *" aiocbp ); .PP Link with \fI\-lrt\fP. +.fi .SH DESCRIPTION The .BR aio_read () diff --git a/man3/aio_return.3 b/man3/aio_return.3 index 21e8d21ad..50bac70db 100644 --- a/man3/aio_return.3 +++ b/man3/aio_return.3 @@ -25,11 +25,13 @@ .SH NAME aio_return \- get return status of asynchronous I/O operation .SH SYNOPSIS +.nf .B "#include " .PP .BI "ssize_t aio_return(struct aiocb *" aiocbp ); .PP Link with \fI\-lrt\fP. +.fi .SH DESCRIPTION The .BR aio_return () diff --git a/man3/aio_write.3 b/man3/aio_write.3 index f499210e2..286a00a26 100644 --- a/man3/aio_write.3 +++ b/man3/aio_write.3 @@ -25,11 +25,13 @@ .SH NAME aio_write \- asynchronous write .SH SYNOPSIS +.nf .B "#include " .PP .BI "int aio_write(struct aiocb *" aiocbp ); .PP Link with \fI\-lrt\fP. +.fi .SH DESCRIPTION The .BR aio_write () diff --git a/man3/alloca.3 b/man3/alloca.3 index 9dc7695e8..1171dbeda 100644 --- a/man3/alloca.3 +++ b/man3/alloca.3 @@ -44,9 +44,11 @@ .SH NAME alloca \- allocate memory that is automatically freed .SH SYNOPSIS +.nf .B #include .PP .BI "void *alloca(size_t " size ); +.fi .SH DESCRIPTION The .BR alloca () diff --git a/man3/bsd_signal.3 b/man3/bsd_signal.3 index e831e9bb1..13617c407 100644 --- a/man3/bsd_signal.3 +++ b/man3/bsd_signal.3 @@ -26,11 +26,13 @@ .SH NAME bsd_signal \- signal handling with BSD semantics .SH SYNOPSIS +.fi .B #include .PP .B typedef void (*sighandler_t)(int); .PP .BI "sighandler_t bsd_signal(int " signum ", sighandler_t " handler ); +.nf .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man3/cabs.3 b/man3/cabs.3 index 64a6ae679..36901bd3a 100644 --- a/man3/cabs.3 +++ b/man3/cabs.3 @@ -8,15 +8,15 @@ .SH NAME cabs, cabsf, cabsl \- absolute value of a complex number .SH SYNOPSIS +.nf .B #include .PP .BI "double cabs(double complex " z ); -.br .BI "float cabsf(float complex " z ); -.br .BI "long double cabsl(long double complex " z ); .PP Link with \fI\-lm\fP. +.fi .SH DESCRIPTION These functions return the absolute value of the complex number .IR z . diff --git a/man3/cacos.3 b/man3/cacos.3 index 2478deb5d..fea5efdf4 100644 --- a/man3/cacos.3 +++ b/man3/cacos.3 @@ -9,15 +9,15 @@ .SH NAME cacos, cacosf, cacosl \- complex arc cosine .SH SYNOPSIS +.nf .B #include .PP .BI "double complex cacos(double complex " z ); -.br .BI "float complex cacosf(float complex " z ); -.br .BI "long double complex cacosl(long double complex " z ); .PP Link with \fI\-lm\fP. +.fi .SH DESCRIPTION These functions calculate the complex arc cosine of .IR z . diff --git a/man3/cacosh.3 b/man3/cacosh.3 index aefb43f02..6c367d241 100644 --- a/man3/cacosh.3 +++ b/man3/cacosh.3 @@ -9,15 +9,15 @@ .SH NAME cacosh, cacoshf, cacoshl \- complex arc hyperbolic cosine .SH SYNOPSIS +.nf .B #include .PP .BI "double complex cacosh(double complex " z ); -.br .BI "float complex cacoshf(float complex " z ); -.br .BI "long double complex cacoshl(long double complex " z ); .PP Link with \fI\-lm\fP. +.fi .SH DESCRIPTION These functions calculate the complex arc hyperbolic cosine of .IR z . diff --git a/man3/canonicalize_file_name.3 b/man3/canonicalize_file_name.3 index 065be723d..7b1a008ea 100644 --- a/man3/canonicalize_file_name.3 +++ b/man3/canonicalize_file_name.3 @@ -27,11 +27,12 @@ .SH NAME canonicalize_file_name \- return the canonicalized absolute pathname .SH SYNOPSIS +.nf .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" -.br .B #include .PP .BI "char *canonicalize_file_name(const char *" path ");" +.fi .SH DESCRIPTION The .BR canonicalize_file_name () diff --git a/man3/carg.3 b/man3/carg.3 index 4ad733883..bc0d48cf0 100644 --- a/man3/carg.3 +++ b/man3/carg.3 @@ -8,15 +8,15 @@ .SH NAME carg, cargf, cargl \- calculate the complex argument .SH SYNOPSIS +.nf .B #include .PP .BI "double carg(double complex " z ");" -.br .BI "float cargf(float complex " z ");" -.br .BI "long double cargl(long double complex " z ");" .PP Link with \fI\-lm\fP. +.fi .SH DESCRIPTION These functions calculate the complex argument (also called phase angle) of .IR z , diff --git a/man3/casin.3 b/man3/casin.3 index 9456e0be8..bb244e700 100644 --- a/man3/casin.3 +++ b/man3/casin.3 @@ -8,15 +8,15 @@ .SH NAME casin, casinf, casinl \- complex arc sine .SH SYNOPSIS +.nf .B #include .PP .BI "double complex casin(double complex " z ); -.br .BI "float complex casinf(float complex " z ); -.br .BI "long double complex casinl(long double complex " z ); .PP Link with \fI\-lm\fP. +.fi .SH DESCRIPTION These functions calculate the complex arc sine of .IR z . diff --git a/man3/casinh.3 b/man3/casinh.3 index 27b4ddbc9..48d68276e 100644 --- a/man3/casinh.3 +++ b/man3/casinh.3 @@ -8,15 +8,15 @@ .SH NAME casinh, casinhf, casinhl \- complex arc sine hyperbolic .SH SYNOPSIS +.nf .B #include .PP .BI "double complex casinh(double complex " z ); -.br .BI "float complex casinhf(float complex " z ); -.br .BI "long double complex casinhl(long double complex " z ); .PP Link with \fI\-lm\fP. +.fi .SH DESCRIPTION These functions calculate the complex arc hyperbolic sine of .IR z . diff --git a/man3/catan.3 b/man3/catan.3 index f2f7b01ce..db7c1b93a 100644 --- a/man3/catan.3 +++ b/man3/catan.3 @@ -9,15 +9,15 @@ .SH NAME catan, catanf, catanl \- complex arc tangents .SH SYNOPSIS +.nf .B #include .PP .BI "double complex catan(double complex " z ); -.br .BI "float complex catanf(float complex " z ); -.br .BI "long double complex catanl(long double complex " z ); .PP Link with \fI\-lm\fP. +.fi .SH DESCRIPTION These functions calculate the complex arc tangent of .IR z . diff --git a/man3/catanh.3 b/man3/catanh.3 index e90956f19..a07b31308 100644 --- a/man3/catanh.3 +++ b/man3/catanh.3 @@ -9,15 +9,15 @@ .SH NAME catanh, catanhf, catanhl \- complex arc tangents hyperbolic .SH SYNOPSIS +.nf .B #include .PP .BI "double complex catanh(double complex " z ); -.br .BI "float complex catanhf(float complex " z ); -.br .BI "long double complex catanhl(long double complex " z ); .PP Link with \fI\-lm\fP. +.fi .SH DESCRIPTION These functions calculate the complex arc hyperbolic tangent of .IR z . diff --git a/man3/ccos.3 b/man3/ccos.3 index 88782addc..3f6b84803 100644 --- a/man3/ccos.3 +++ b/man3/ccos.3 @@ -8,15 +8,15 @@ .SH NAME ccos, ccosf, ccosl \- complex cosine function .SH SYNOPSIS +.nf .B #include .PP .BI "double complex ccos(double complex " z ");" -.br .BI "float complex ccosf(float complex " z ");" -.br .BI "long double complex ccosl(long double complex " z ");" .PP Link with \fI\-lm\fP. +.fi .SH DESCRIPTION These functions calculate the complex cosine of .IR z . diff --git a/man3/ccosh.3 b/man3/ccosh.3 index 7b68fa19a..16ca32ab5 100644 --- a/man3/ccosh.3 +++ b/man3/ccosh.3 @@ -8,15 +8,15 @@ .SH NAME ccosh, ccoshf, ccoshl \- complex hyperbolic cosine .SH SYNOPSIS +.nf .B #include .PP .BI "double complex ccosh(double complex " z ");" -.br .BI "float complex ccoshf(float complex " z ");" -.br .BI "long double complex ccoshl(long double complex " z ");" .PP Link with \fI\-lm\fP. +.fi .SH DESCRIPTION These functions calculate the complex hyperbolic cosine of .IR z . diff --git a/man3/cexp.3 b/man3/cexp.3 index 387f8fdca..6d308d652 100644 --- a/man3/cexp.3 +++ b/man3/cexp.3 @@ -8,15 +8,15 @@ .SH NAME cexp, cexpf, cexpl \- complex exponential function .SH SYNOPSIS +.nf .B #include .PP .BI "double complex cexp(double complex " z ");" -.br .BI "float complex cexpf(float complex " z ");" -.br .BI "long double complex cexpl(long double complex " z ");" .PP Link with \fI\-lm\fP. +.fi .SH DESCRIPTION These functions calculate e (2.71828..., the base of natural logarithms) raised to the power of diff --git a/man3/cexp2.3 b/man3/cexp2.3 index 359c517b6..9239ce180 100644 --- a/man3/cexp2.3 +++ b/man3/cexp2.3 @@ -8,15 +8,15 @@ .SH NAME cexp2, cexp2f, cexp2l \- base-2 exponent of a complex number .SH SYNOPSIS +.nf .B #include .PP .BI "double complex cexp2(double complex " z ");" -.br .BI "float complex cexp2f(float complex " z ");" -.br .BI "long double complex cexp2l(long double complex " z ");" .PP Link with \fI\-lm\fP. +.fi .SH DESCRIPTION The function returns 2 raised to the power of .IR z . diff --git a/man3/cimag.3 b/man3/cimag.3 index 4121423ac..5fc41ab22 100644 --- a/man3/cimag.3 +++ b/man3/cimag.3 @@ -8,15 +8,15 @@ .SH NAME cimag, cimagf, cimagl \- get imaginary part of a complex number .SH SYNOPSIS +.nf .B #include .PP .BI "double cimag(double complex " z ");" -.br .BI "float cimagf(float complex " z ");" -.br .BI "long double cimagl(long double complex " z ");" .PP Link with \fI\-lm\fP. +.fi .SH DESCRIPTION These functions return the imaginary part of the complex number .IR z . diff --git a/man3/clog.3 b/man3/clog.3 index 61a035099..3cd507306 100644 --- a/man3/clog.3 +++ b/man3/clog.3 @@ -8,15 +8,15 @@ .SH NAME clog, clogf, clogl \- natural logarithm of a complex number .SH SYNOPSIS +.nf .B #include .PP .BI "double complex clog(double complex " z ); -.br .BI "float complex clogf(float complex " z ); -.br .BI "long double complex clogl(long double complex " z ); .PP Link with \fI\-lm\fP. +.fi .SH DESCRIPTION These functions calculate the complex natural logarithm of .IR z , diff --git a/man3/clog10.3 b/man3/clog10.3 index aa943a7a7..22c196b81 100644 --- a/man3/clog10.3 +++ b/man3/clog10.3 @@ -8,17 +8,16 @@ .SH NAME clog10, clog10f, clog10l \- base-10 logarithm of a complex number .SH SYNOPSIS +.nf .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" -.br .B #include .PP .BI "double complex clog10(double complex " z ); -.br .BI "float complex clog10f(float complex " z ); -.br .BI "long double complex clog10l(long double complex " z ); .PP Link with \fI\-lm\fP. +.fi .SH DESCRIPTION The call .I clog10(z) diff --git a/man3/clog2.3 b/man3/clog2.3 index 9cb0d5587..8c4c910de 100644 --- a/man3/clog2.3 +++ b/man3/clog2.3 @@ -8,15 +8,15 @@ .SH NAME clog2, clog2f, clog2l \- base-2 logarithm of a complex number .SH SYNOPSIS +.nf .B #include .PP .BI "double complex clog2(double complex " z ); -.br .BI "float complex clog2f(float complex " z ); -.br .BI "long double complex clog2l(long double complex " z ); .\" .PP .\" Link with \fI\-lm\fP. +.fi .SH DESCRIPTION The call .I clog2(z) diff --git a/man3/conj.3 b/man3/conj.3 index 22de09f0a..188957890 100644 --- a/man3/conj.3 +++ b/man3/conj.3 @@ -8,15 +8,15 @@ .SH NAME conj, conjf, conjl \- calculate the complex conjugate .SH SYNOPSIS +.nf .B #include .PP .BI "double complex conj(double complex " z ); -.br .BI "float complex conjf(float complex " z ); -.br .BI "long double complex conjl(long double complex " z ); .PP Link with \fI\-lm\fP. +.fi .SH DESCRIPTION These functions return the complex conjugate value of .IR z . diff --git a/man3/cproj.3 b/man3/cproj.3 index 403cd193d..6ac108b5e 100644 --- a/man3/cproj.3 +++ b/man3/cproj.3 @@ -8,15 +8,15 @@ .SH NAME cproj, cprojf, cprojl \- project into Riemann Sphere .SH SYNOPSIS +.nf .B #include .PP .BI "double complex cproj(double complex " z ");" -.br .BI "float complex cprojf(float complex " z ");" -.br .BI "long double complex cprojl(long double complex " z ");" .PP Link with \fI\-lm\fP. +.fi .SH DESCRIPTION These functions project a point in the plane onto the surface of a Riemann Sphere, the one-point compactification of the complex plane. diff --git a/man3/creal.3 b/man3/creal.3 index a89ba051b..abb12162e 100644 --- a/man3/creal.3 +++ b/man3/creal.3 @@ -8,15 +8,15 @@ .SH NAME creal, crealf, creall \- get real part of a complex number .SH SYNOPSIS +.nf .B #include .PP .BI "double creal(double complex " z ); -.br .BI "float crealf(float complex " z ); -.br .BI "long double creall(long double complex " z ); .PP Link with \fI\-lm\fP. +.fi .SH DESCRIPTION These functions return the real part of the complex number .IR z . diff --git a/man3/csin.3 b/man3/csin.3 index 4da6d7544..fe90444dd 100644 --- a/man3/csin.3 +++ b/man3/csin.3 @@ -8,15 +8,15 @@ .SH NAME csin, csinf, csinl \- complex sine function .SH SYNOPSIS +.nf .B #include .PP .BI "double complex csin(double complex " z ");" -.br .BI "float complex csinf(float complex " z ); -.br .BI "long double complex csinl(long double complex " z ");" .PP Link with \fI\-lm\fP. +.fi .SH DESCRIPTION These functions calculate the complex sine of .IR z . diff --git a/man3/csinh.3 b/man3/csinh.3 index 3c3362dd8..78bbdf76c 100644 --- a/man3/csinh.3 +++ b/man3/csinh.3 @@ -8,15 +8,15 @@ .SH NAME csinh, csinhf, csinhl \- complex hyperbolic sine .SH SYNOPSIS +.nf .B #include .PP .BI "double complex csinh(double complex " z ");" -.br .BI "float complex csinhf(float complex " z ");" -.br .BI "long double complex csinhl(long double complex " z ");" .PP Link with \fI\-lm\fP. +.fi .SH DESCRIPTION These functions calculate the complex hyperbolic sine of .IR z . diff --git a/man3/csqrt.3 b/man3/csqrt.3 index 4baa0f826..6ad681db2 100644 --- a/man3/csqrt.3 +++ b/man3/csqrt.3 @@ -8,15 +8,15 @@ .SH NAME csqrt, csqrtf, csqrtl \- complex square root .SH SYNOPSIS +.nf .B #include .PP .BI "double complex csqrt(double complex " z ");" -.br .BI "float complex csqrtf(float complex " z ");" -.br .BI "long double complex csqrtl(long double complex " z ");" .PP Link with \fI\-lm\fP. +.fi .SH DESCRIPTION These functions calculate the complex square root of .IR z , diff --git a/man3/ctan.3 b/man3/ctan.3 index 1e7c6b033..67d7844c9 100644 --- a/man3/ctan.3 +++ b/man3/ctan.3 @@ -8,15 +8,15 @@ .SH NAME ctan, ctanf, ctanl \- complex tangent function .SH SYNOPSIS +.nf .B #include .PP .BI "double complex ctan(double complex " z ");" -.br .BI "float complex ctanf(float complex " z ); -.br .BI "long double complex ctanl(long double complex " z ");" .PP Link with \fI\-lm\fP. +.fi .SH DESCRIPTION These functions calculate the complex tangent of .IR z . diff --git a/man3/ctanh.3 b/man3/ctanh.3 index 469454808..a14a66c94 100644 --- a/man3/ctanh.3 +++ b/man3/ctanh.3 @@ -8,15 +8,15 @@ .SH NAME ctanh, ctanhf, ctanhl \- complex hyperbolic tangent .SH SYNOPSIS +.nf .B #include .PP .BI "double complex ctanh(double complex " z ");" -.br .BI "float complex ctanhf(float complex " z ); -.br .BI "long double complex ctanhl(long double complex " z ");" .PP Link with \fI\-lm\fP. +.fi .SH DESCRIPTION These functions calculate the complex hyperbolic tangent of .IR z . diff --git a/man3/dirfd.3 b/man3/dirfd.3 index 5d6f5976e..8af16414d 100644 --- a/man3/dirfd.3 +++ b/man3/dirfd.3 @@ -26,11 +26,12 @@ .SH NAME dirfd \- get directory stream file descriptor .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .BI "int dirfd(DIR *" dirp ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man3/dlerror.3 b/man3/dlerror.3 index 333490b98..a431505ff 100644 --- a/man3/dlerror.3 +++ b/man3/dlerror.3 @@ -26,11 +26,13 @@ .SH NAME dlerror \- obtain error diagnostic for functions in the dlopen API .SH SYNOPSIS +.nf .B #include .PP .B "char *dlerror(void);" .PP Link with \fI\-ldl\fP. +.fi .SH DESCRIPTION The .BR dlerror () diff --git a/man3/dlsym.3 b/man3/dlsym.3 index 4bcf2217a..95c26ae3c 100644 --- a/man3/dlsym.3 +++ b/man3/dlsym.3 @@ -26,17 +26,18 @@ .SH NAME dlsym, dlvsym \- obtain address of a symbol in a shared object or executable .SH SYNOPSIS +.nf .B #include .PP .BI "void *dlsym(void *" handle ", const char *" symbol ); .PP .B #define _GNU_SOURCE -.br .B #include .PP .BI "void *dlvsym(void *" handle ", char *" symbol ", char *" version ); .PP Link with \fI\-ldl\fP. +.fi .SH DESCRIPTION The function .BR dlsym () diff --git a/man3/dysize.3 b/man3/dysize.3 index ccd08ed9e..1e7cd07e8 100644 --- a/man3/dysize.3 +++ b/man3/dysize.3 @@ -27,9 +27,11 @@ .SH NAME dysize \- get number of days for a given year .SH SYNOPSIS +.nf .B "#include " .PP .BI "int dysize(int " year ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man3/errno.3 b/man3/errno.3 index 504c22af5..62e720ac4 100644 --- a/man3/errno.3 +++ b/man3/errno.3 @@ -32,9 +32,11 @@ .SH NAME errno \- number of last error .SH SYNOPSIS +.nf .B #include .\".PP .\".BI "extern int " errno ; +.fi .SH DESCRIPTION The .I diff --git a/man3/fclose.3 b/man3/fclose.3 index 7ba9091bc..c8f863951 100644 --- a/man3/fclose.3 +++ b/man3/fclose.3 @@ -45,9 +45,11 @@ .SH NAME fclose \- close a stream .SH SYNOPSIS +.nf .B #include .PP .BI "int fclose(FILE *" stream ); +.fi .SH DESCRIPTION The .BR fclose () diff --git a/man3/fdim.3 b/man3/fdim.3 index 740d3ee8d..42a51257c 100644 --- a/man3/fdim.3 +++ b/man3/fdim.3 @@ -10,13 +10,13 @@ .SH NAME fdim, fdimf, fdiml \- positive difference .SH SYNOPSIS +.nf .B #include .PP .BI "double fdim(double " x ", double " y ); -.br .BI "float fdimf(float " x ", float " y ); -.br .BI "long double fdiml(long double " x ", long double " y ); +.fi .PP Link with \fI\-lm\fP. .PP diff --git a/man3/fflush.3 b/man3/fflush.3 index a3ed8aad0..b8841910e 100644 --- a/man3/fflush.3 +++ b/man3/fflush.3 @@ -46,9 +46,11 @@ .SH NAME fflush \- flush a stream .SH SYNOPSIS +.nf .B #include .PP .BI "int fflush(FILE *" stream ); +.fi .SH DESCRIPTION For output streams, .BR fflush () diff --git a/man3/fmin.3 b/man3/fmin.3 index f1c8990bc..2adee0c52 100644 --- a/man3/fmin.3 +++ b/man3/fmin.3 @@ -10,13 +10,13 @@ .SH NAME fmin, fminf, fminl \- determine minimum of two floating-point numbers .SH SYNOPSIS +.nf .B #include .PP .BI "double fmin(double " x ", double " y ); -.br .BI "float fminf(float " x ", float " y ); -.br .BI "long double fminl(long double " x ", long double " y ); +.fi .PP Link with \fI\-lm\fP. .PP diff --git a/man3/ftime.3 b/man3/ftime.3 index 658ed300c..cf40abb82 100644 --- a/man3/ftime.3 +++ b/man3/ftime.3 @@ -31,9 +31,11 @@ .SH NAME ftime \- return date and time .SH SYNOPSIS +.nf .B "#include " .PP .BI "int ftime(struct timeb *" tp ); +.fi .SH DESCRIPTION .BR NOTE : This function is no longer provided by the GNU C library. diff --git a/man3/gamma.3 b/man3/gamma.3 index 42f0ab315..acea46810 100644 --- a/man3/gamma.3 +++ b/man3/gamma.3 @@ -10,13 +10,13 @@ .SH NAME gamma, gammaf, gammal \- (logarithm of the) gamma function .SH SYNOPSIS +.nf .B #include .PP .BI "double gamma(double " x ");" -.br .BI "float gammaf(float " x ");" -.br .BI "long double gammal(long double " x ");" +.fi .PP Link with \fI\-lm\fP. .PP diff --git a/man3/get_nprocs_conf.3 b/man3/get_nprocs_conf.3 index 08045538f..ad1d31685 100644 --- a/man3/get_nprocs_conf.3 +++ b/man3/get_nprocs_conf.3 @@ -27,11 +27,12 @@ .SH NAME get_nprocs, get_nprocs_conf \- get number of processors .SH SYNOPSIS +.nf .B #include .PP .BI "int get_nprocs(void);" -.br .BI "int get_nprocs_conf(void);" +.fi .SH DESCRIPTION The function .BR get_nprocs_conf () diff --git a/man3/getcontext.3 b/man3/getcontext.3 index 7c5d3facf..aa4881d19 100644 --- a/man3/getcontext.3 +++ b/man3/getcontext.3 @@ -26,11 +26,12 @@ .SH NAME getcontext, setcontext \- get or set the user context .SH SYNOPSIS +.nf .B #include .PP .BI "int getcontext(ucontext_t *" ucp ); -.br .BI "int setcontext(const ucontext_t *" ucp ); +.fi .SH DESCRIPTION In a System V-like environment, one has the two types .I mcontext_t diff --git a/man3/getdate.3 b/man3/getdate.3 index 5c686e938..32b812b2d 100644 --- a/man3/getdate.3 +++ b/man3/getdate.3 @@ -31,6 +31,7 @@ .SH NAME getdate, getdate_r \- convert a date-plus-time string to broken-down time .SH SYNOPSIS +.nf .B "#include " .PP .BI "struct tm *getdate(const char *" string ); @@ -40,6 +41,7 @@ getdate, getdate_r \- convert a date-plus-time string to broken-down time .B "#include " .PP .BI "int getdate_r(const char *" string ", struct tm *" res ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man3/getentropy.3 b/man3/getentropy.3 index 9b0e5fe07..7925ef86e 100644 --- a/man3/getentropy.3 +++ b/man3/getentropy.3 @@ -26,9 +26,11 @@ .SH NAME getentropy \- fill a buffer with random bytes .SH SYNOPSIS +.nf .B #include .PP .BI "int getentropy(void *" buffer ", size_t " length ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man3/getgrouplist.3 b/man3/getgrouplist.3 index 7ac04a933..a9f2feccf 100644 --- a/man3/getgrouplist.3 +++ b/man3/getgrouplist.3 @@ -30,11 +30,12 @@ .SH NAME getgrouplist \- get list of groups to which a user belongs .SH SYNOPSIS +.nf .B #include .PP .BI "int getgrouplist(const char *" user ", gid_t " group , -.br .BI " gid_t *" groups ", int *" ngroups ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man3/getsubopt.3 b/man3/getsubopt.3 index 90b251a40..58536cacd 100644 --- a/man3/getsubopt.3 +++ b/man3/getsubopt.3 @@ -26,10 +26,12 @@ .SH NAME getsubopt \- parse suboption arguments from a string .SH SYNOPSIS +.nf .B #include .PP .BI "int getsubopt(char **"optionp ", char * const *" tokens \ ", char **" valuep ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man3/getumask.3 b/man3/getumask.3 index 2b9e53196..bfd54e474 100644 --- a/man3/getumask.3 +++ b/man3/getumask.3 @@ -29,13 +29,13 @@ .SH NAME getumask \- get file creation mask .SH SYNOPSIS +.nf .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" -.br .B "#include " -.br .B "#include " .PP .B "mode_t getumask(void);" +.fi .SH DESCRIPTION This function returns the current file creation mask. It is equivalent to diff --git a/man3/getutent.3 b/man3/getutent.3 index 074f7e0d5..7ad31ce9a 100644 --- a/man3/getutent.3 +++ b/man3/getutent.3 @@ -33,19 +33,18 @@ getutent, getutid, getutline, pututline, setutent, endutent, utmpname \- access utmp file entries .SH SYNOPSIS +.nf .B #include .PP .B struct utmp *getutent(void); -.br .BI "struct utmp *getutid(const struct utmp *" ut ); -.br .BI "struct utmp *getutline(const struct utmp *" ut ); .PP .BI "struct utmp *pututline(const struct utmp *" ut ); .PP .B void setutent(void); -.br .B void endutent(void); +.fi .PP .BI "int utmpname(const char *" file ); .SH DESCRIPTION diff --git a/man3/grantpt.3 b/man3/grantpt.3 index 8d902b118..cae0a3b64 100644 --- a/man3/grantpt.3 +++ b/man3/grantpt.3 @@ -6,9 +6,11 @@ .SH NAME grantpt \- grant access to the slave pseudoterminal .SH SYNOPSIS +.nf .B #include .PP .BI "int grantpt(int " fd ");" +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man3/group_member.3 b/man3/group_member.3 index 6af537534..6647eef34 100644 --- a/man3/group_member.3 +++ b/man3/group_member.3 @@ -26,9 +26,11 @@ .SH NAME group_member \- test whether a process is in a group .SH SYNOPSIS +.nf .B #include .PP .BI "int group_member(gid_t " gid ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man3/ilogb.3 b/man3/ilogb.3 index f758886a9..303b4a5d3 100644 --- a/man3/ilogb.3 +++ b/man3/ilogb.3 @@ -30,13 +30,13 @@ .SH NAME ilogb, ilogbf, ilogbl \- get integer exponent of a floating-point value .SH SYNOPSIS +.nf .B #include .PP .BI "int ilogb(double " x ); -.br .BI "int ilogbf(float " x ); -.br .BI "int ilogbl(long double " x ); +.fi .PP Link with \fI\-lm\fP. .PP diff --git a/man3/killpg.3 b/man3/killpg.3 index e831d8620..b19cdb269 100644 --- a/man3/killpg.3 +++ b/man3/killpg.3 @@ -43,9 +43,11 @@ .SH NAME killpg \- send signal to a process group .SH SYNOPSIS +.nf .B #include .PP .BI "int killpg(int " pgrp ", int " sig ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man3/lockf.3 b/man3/lockf.3 index ce45ab1b6..5f974e703 100644 --- a/man3/lockf.3 +++ b/man3/lockf.3 @@ -29,9 +29,11 @@ .SH NAME lockf \- apply, test or remove a POSIX lock on an open file .SH SYNOPSIS +.nf .B #include .PP .BI "int lockf(int " fd ", int " cmd ", off_t " len ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man3/logb.3 b/man3/logb.3 index b64521a0b..e35c6b2bc 100644 --- a/man3/logb.3 +++ b/man3/logb.3 @@ -30,13 +30,13 @@ .SH NAME logb, logbf, logbl \- get exponent of a floating-point value .SH SYNOPSIS +.nf .B #include .PP .BI "double logb(double " x ); -.br .BI "float logbf(float " x ); -.br .BI "long double logbl(long double " x ); +.fi .PP Link with \fI\-lm\fP. .PP diff --git a/man3/lseek64.3 b/man3/lseek64.3 index 68aa46138..df63accdb 100644 --- a/man3/lseek64.3 +++ b/man3/lseek64.3 @@ -27,13 +27,13 @@ .SH NAME lseek64 \- reposition 64-bit read/write file offset .SH SYNOPSIS +.nf .BR "#define _LARGEFILE64_SOURCE" " /* See feature_test_macros(7) */" -.br .B #include -.br .B #include .PP .BI "off64_t lseek64(int " fd ", off64_t " offset ", int " whence ); +.fi .SH DESCRIPTION The .BR lseek () diff --git a/man3/malloc_stats.3 b/man3/malloc_stats.3 index 7e240c001..85e43ff56 100644 --- a/man3/malloc_stats.3 +++ b/man3/malloc_stats.3 @@ -26,9 +26,11 @@ .SH NAME malloc_stats \- print memory allocation statistics .SH SYNOPSIS +.nf .B #include .PP .B void malloc_stats(void); +.fi .SH DESCRIPTION The .BR malloc_stats () diff --git a/man3/malloc_trim.3 b/man3/malloc_trim.3 index 25fb67f09..37dcf23f0 100644 --- a/man3/malloc_trim.3 +++ b/man3/malloc_trim.3 @@ -26,9 +26,11 @@ .SH NAME malloc_trim \- release free memory from the heap .SH SYNOPSIS +.nf .B #include .PP .BI "int malloc_trim(size_t " pad ); +.fi .SH DESCRIPTION The .BR malloc_trim () diff --git a/man3/malloc_usable_size.3 b/man3/malloc_usable_size.3 index 38342f56b..2aa139be9 100644 --- a/man3/malloc_usable_size.3 +++ b/man3/malloc_usable_size.3 @@ -26,9 +26,11 @@ .SH NAME malloc_usable_size \- obtain size of block of memory allocated from heap .SH SYNOPSIS +.nf .B #include .PP .BI "size_t malloc_usable_size (void *" ptr ); +.fi .SH DESCRIPTION The .BR malloc_usable_size () diff --git a/man3/mallopt.3 b/man3/mallopt.3 index ccf5ac363..44111e3d3 100644 --- a/man3/mallopt.3 +++ b/man3/mallopt.3 @@ -26,9 +26,11 @@ .SH NAME mallopt \- set memory allocation parameters .SH SYNOPSIS +.nf .B #include .PP .BI "int mallopt(int " param ", int " value ); +.fi .SH DESCRIPTION The .BR mallopt () diff --git a/man3/nan.3 b/man3/nan.3 index e412ae4c1..1f48d3915 100644 --- a/man3/nan.3 +++ b/man3/nan.3 @@ -12,13 +12,13 @@ .SH NAME nan, nanf, nanl \- return 'Not a Number' .SH SYNOPSIS +.nf .B #include .PP .BI "double nan(const char *" tagp ); -.br .BI "float nanf(const char *" tagp ); -.br .BI "long double nanl(const char *" tagp ); +.fi .PP Link with \fI\-lm\fP. .PP diff --git a/man3/nextafter.3 b/man3/nextafter.3 index 681fc3ba3..a1143a359 100644 --- a/man3/nextafter.3 +++ b/man3/nextafter.3 @@ -13,19 +13,17 @@ nextafter, nextafterf, nextafterl, nexttoward, nexttowardf, nexttowardl \- floating-point number manipulation .SH SYNOPSIS +.nf .B #include .PP .BI "double nextafter(double " x ", double " y ); -.br .BI "float nextafterf(float " x ", float " y ); -.br .BI "long double nextafterl(long double " x ", long double " y ); .PP .BI "double nexttoward(double " x ", long double " y ); -.br .BI "float nexttowardf(float " x ", long double " y ); -.br .BI "long double nexttowardl(long double " x ", long double " y ); +.fi .PP Link with \fI\-lm\fP. .PP diff --git a/man3/perror.3 b/man3/perror.3 index 05e274635..43ceff60e 100644 --- a/man3/perror.3 +++ b/man3/perror.3 @@ -32,6 +32,7 @@ .SH NAME perror \- print a system error message .SH SYNOPSIS +.nf .B #include .PP .BI "void perror(const char *" s ); @@ -39,10 +40,9 @@ perror \- print a system error message .B #include .PP .BI "const char * const " sys_errlist []; -.br .BI "int " sys_nerr ; -.br .BI "int " errno "; \fR/* Not really declared this way; see errno(3) */" +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man3/ptsname.3 b/man3/ptsname.3 index 4110a33a9..e63353ce2 100644 --- a/man3/ptsname.3 +++ b/man3/ptsname.3 @@ -8,11 +8,12 @@ .SH NAME ptsname, ptsname_r \- get the name of the slave pseudoterminal .SH SYNOPSIS +.nf .B #include .PP .BI "char *ptsname(int " fd ");" -.br .BI "int ptsname_r(int " fd ", char *" buf ", size_t " buflen ");" +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man3/putgrent.3 b/man3/putgrent.3 index b8fd36167..729ff41bf 100644 --- a/man3/putgrent.3 +++ b/man3/putgrent.3 @@ -8,11 +8,12 @@ .SH NAME putgrent \- write a group database entry to a file .SH SYNOPSIS +.nf .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" -.br .B #include .PP .BI "int putgrent(const struct group *" grp ", FILE *" stream ); +.fi .SH DESCRIPTION The .BR putgrent () diff --git a/man3/remove.3 b/man3/remove.3 index 06ba3ae12..d0ade5634 100644 --- a/man3/remove.3 +++ b/man3/remove.3 @@ -32,9 +32,11 @@ .SH NAME remove \- remove a file or directory .SH SYNOPSIS +.nf .B #include .PP .BI "int remove(const char *" pathname ); +.fi .SH DESCRIPTION .BR remove () deletes a name from the filesystem. diff --git a/man3/scalb.3 b/man3/scalb.3 index 802da3523..cf009e9a1 100644 --- a/man3/scalb.3 +++ b/man3/scalb.3 @@ -29,13 +29,13 @@ scalb, scalbf, scalbl \- multiply floating-point number by integral power of radix (OBSOLETE) .SH SYNOPSIS +.nf .B #include .PP .BI "double scalb(double " x ", double " exp ); -.br .BI "float scalbf(float " x ", float " exp ); -.br .BI "long double scalbl(long double " x ", long double " exp ); +.fi .PP Link with \fI\-lm\fP. .PP diff --git a/man3/scalbln.3 b/man3/scalbln.3 index e7317ed3a..3fdfb378d 100644 --- a/man3/scalbln.3 +++ b/man3/scalbln.3 @@ -29,19 +29,17 @@ scalbn, scalbnf, scalbnl, scalbln, scalblnf, scalblnl \- multiply floating-point number by integral power of radix .SH SYNOPSIS +.nf .B #include .PP .BI "double scalbln(double " x ", long " exp ); -.br .BI "float scalblnf(float " x ", long " exp ); -.br .BI "long double scalblnl(long double " x ", long " exp ); .PP .BI "double scalbn(double " x ", int " exp ); -.br .BI "float scalbnf(float " x ", int " exp ); -.br .BI "long double scalbnl(long double " x ", int " exp ); +.fi .PP Link with \fI\-lm\fP. .PP diff --git a/man3/signbit.3 b/man3/signbit.3 index ad4d8833d..90fee73f9 100644 --- a/man3/signbit.3 +++ b/man3/signbit.3 @@ -12,9 +12,11 @@ .SH NAME signbit \- test sign of a real floating-point number .SH SYNOPSIS +.nf .B "#include " .PP .BI "int signbit(" x ");" +.fi .PP Link with \fI\-lm\fP. .PP diff --git a/man3/significand.3 b/man3/significand.3 index 4a0872ea1..f9f67656c 100644 --- a/man3/significand.3 +++ b/man3/significand.3 @@ -11,13 +11,13 @@ significand, significandf, significandl \- get mantissa of floating-point number .SH SYNOPSIS +.nf .B #include .PP .BI "double significand(double " x ); -.br .BI "float significandf(float " x ); -.br .BI "long double significandl(long double " x ); +.fi .PP Link with \fI\-lm\fP. .PP diff --git a/man3/sigqueue.3 b/man3/sigqueue.3 index bb9cb6218..34028bae9 100644 --- a/man3/sigqueue.3 +++ b/man3/sigqueue.3 @@ -29,9 +29,11 @@ .SH NAME sigqueue \- queue a signal and data to a process .SH SYNOPSIS +.nf .B #include .PP .BI "int sigqueue(pid_t " pid ", int " sig ", const union sigval " value ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man3/sockatmark.3 b/man3/sockatmark.3 index 17da18514..8cddd17f9 100644 --- a/man3/sockatmark.3 +++ b/man3/sockatmark.3 @@ -26,9 +26,11 @@ .SH NAME sockatmark \- determine whether socket is at out-of-band mark .SH SYNOPSIS +.nf .B #include .PP .BI "int sockatmark(int " sockfd ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man3/statvfs.3 b/man3/statvfs.3 index f379894f2..15af637eb 100644 --- a/man3/statvfs.3 +++ b/man3/statvfs.3 @@ -31,11 +31,12 @@ .SH NAME statvfs, fstatvfs \- get filesystem statistics .SH SYNOPSIS +.nf .B #include .PP .BI "int statvfs(const char *" path ", struct statvfs *" buf ); -.br .BI "int fstatvfs(int " fd ", struct statvfs *" buf ); +.fi .SH DESCRIPTION The function .BR statvfs () diff --git a/man3/stdarg.3 b/man3/stdarg.3 index d86404d15..8cfa8b0a4 100644 --- a/man3/stdarg.3 +++ b/man3/stdarg.3 @@ -44,15 +44,14 @@ .SH NAME stdarg, va_start, va_arg, va_end, va_copy \- variable argument lists .SH SYNOPSIS +.nf .B #include .PP .BI "void va_start(va_list " ap ", " last ); -.br .IB type " va_arg(va_list " ap ", " type ); -.br .BI "void va_end(va_list " ap ); -.br .BI "void va_copy(va_list " dest ", va_list " src ); +.fi .SH DESCRIPTION A function may be called with a varying number of arguments of varying types. diff --git a/man3/stdio.3 b/man3/stdio.3 index 00b28b72b..7fd0aa8bc 100644 --- a/man3/stdio.3 +++ b/man3/stdio.3 @@ -40,13 +40,13 @@ .SH NAME stdio \- standard input/output library functions .SH SYNOPSIS +.nf .B #include .PP .BI "FILE *" stdin ; -.br .BI "FILE *" stdout ; -.br .BI "FILE *" stderr ; +.fi .SH DESCRIPTION The standard I/O library provides a simple and efficient buffered stream I/O interface. diff --git a/man3/strptime.3 b/man3/strptime.3 index 722942788..a2111585b 100644 --- a/man3/strptime.3 +++ b/man3/strptime.3 @@ -32,12 +32,12 @@ .SH NAME strptime \- convert a string representation of time to a time tm structure .SH SYNOPSIS +.nf .BR "#define _XOPEN_SOURCE" " /* See feature_test_macros(7) */" -.br .B #include .PP -.BI "char *strptime(const char *" s ", const char *" format , -.BI "struct tm *" tm ); +.BI "char *strptime(const char *" s ", const char *" format ", struct tm *" tm ); +.fi .SH DESCRIPTION The .BR strptime () diff --git a/man3/strtod.3 b/man3/strtod.3 index f738414fc..483cb0f90 100644 --- a/man3/strtod.3 +++ b/man3/strtod.3 @@ -46,13 +46,13 @@ .SH NAME strtod, strtof, strtold \- convert ASCII string to floating-point number .SH SYNOPSIS +.nf .B #include .PP .BI "double strtod(const char *" nptr ", char **" endptr ); -.br .BI "float strtof(const char *" nptr ", char **" endptr ); -.br .BI "long double strtold(const char *" nptr ", char **" endptr ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man3/syslog.3 b/man3/syslog.3 index e93cab4a8..bac3ecdb1 100644 --- a/man3/syslog.3 +++ b/man3/syslog.3 @@ -38,15 +38,15 @@ .SH NAME closelog, openlog, syslog, vsyslog \- send messages to the system logger .SH SYNOPSIS +.nf .B #include .PP .BI "void openlog(const char *" ident ", int " option ", int " facility ); -.br .BI "void syslog(int " priority ", const char *" format ", ...);" -.br .B "void closelog(void);" .PP .BI "void vsyslog(int " priority ", const char *" format ", va_list " ap ); +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man3/sysv_signal.3 b/man3/sysv_signal.3 index 35a15f2a1..5fbf85b90 100644 --- a/man3/sysv_signal.3 +++ b/man3/sysv_signal.3 @@ -26,13 +26,14 @@ .SH NAME sysv_signal \- signal handling with System V semantics .SH SYNOPSIS +.nf .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" -.br .B #include .PP .B typedef void (*sighandler_t)(int); .PP .BI "sighandler_t sysv_signal(int " signum ", sighandler_t " handler ); +.fi .SH DESCRIPTION The .BR sysv_signal () diff --git a/man3/tcgetsid.3 b/man3/tcgetsid.3 index 057c2867e..8d7c5c995 100644 --- a/man3/tcgetsid.3 +++ b/man3/tcgetsid.3 @@ -26,11 +26,12 @@ .SH NAME tcgetsid \- get session ID .SH SYNOPSIS +.nf .BR "#define _XOPEN_SOURCE 500" " /* See feature_test_macros(7) */" -.br .B "#include " .PP .BI "pid_t tcgetsid(int " fd ); +.fi .SH DESCRIPTION The function .BR tcgetsid () diff --git a/man3/tgamma.3 b/man3/tgamma.3 index 2db934ba0..7e9bb1ffb 100644 --- a/man3/tgamma.3 +++ b/man3/tgamma.3 @@ -14,13 +14,13 @@ .SH NAME tgamma, tgammaf, tgammal \- true gamma function .SH SYNOPSIS +.nf .B #include .PP .BI "double tgamma(double " x ); -.br .BI "float tgammaf(float " x ); -.br .BI "long double tgammal(long double " x ); +.fi .PP Link with \fI\-lm\fP. .PP diff --git a/man3/ttyslot.3 b/man3/ttyslot.3 index 91d74fe2c..933634669 100644 --- a/man3/ttyslot.3 +++ b/man3/ttyslot.3 @@ -29,9 +29,11 @@ .SH NAME ttyslot \- find the slot of the current user's terminal in some file .SH SYNOPSIS +.nf .BR "#include " " /See NOTES */" .PP .B "int ttyslot(void);" +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man3/ulimit.3 b/man3/ulimit.3 index 451fc3f91..b2c2dd8a0 100644 --- a/man3/ulimit.3 +++ b/man3/ulimit.3 @@ -28,9 +28,11 @@ .SH NAME ulimit \- get and set user limits .SH SYNOPSIS +.nf .B #include .PP .BI "long ulimit(int " cmd ", long " newlimit ); +.fi .SH DESCRIPTION Warning: this routine is obsolete. Use diff --git a/man3/undocumented.3 b/man3/undocumented.3 index 6e4fb4339..17f35b539 100644 --- a/man3/undocumented.3 +++ b/man3/undocumented.3 @@ -31,7 +31,9 @@ .SH NAME undocumented \- undocumented library functions .SH SYNOPSIS +.nf Undocumented library functions +.fi .SH DESCRIPTION This man page mentions those library functions which are implemented in the standard libraries but not yet documented in man pages. diff --git a/man3/unlockpt.3 b/man3/unlockpt.3 index 76f7846a8..f4317ac90 100644 --- a/man3/unlockpt.3 +++ b/man3/unlockpt.3 @@ -6,11 +6,12 @@ .SH NAME unlockpt \- unlock a pseudoterminal master/slave pair .SH SYNOPSIS +.nf .B #define _XOPEN_SOURCE -.br .B #include .PP .BI "int unlockpt(int " fd ");" +.fi .PP .RS -4 Feature Test Macro Requirements for glibc (see diff --git a/man4/loop.4 b/man4/loop.4 index 8b281a335..07b6be8f1 100644 --- a/man4/loop.4 +++ b/man4/loop.4 @@ -27,7 +27,9 @@ .SH NAME loop, loop-control \- loop devices .SH SYNOPSIS +.nf #include +.fi .SH DESCRIPTION The loop device is a block device that maps its data blocks not to a physical device such as a hard disk or optical disk drive, diff --git a/man4/lp.4 b/man4/lp.4 index 87793ff8d..06b3c03dd 100644 --- a/man4/lp.4 +++ b/man4/lp.4 @@ -27,7 +27,9 @@ .SH NAME lp \- line printer devices .SH SYNOPSIS +.nf .B #include +.fi .SH CONFIGURATION \fBlp\fP[0\(en2] are character devices for the parallel line printers; they have major number 6 and minor number 0\(en2. diff --git a/man4/random.4 b/man4/random.4 index 95fee6ed0..bc5ef184c 100644 --- a/man4/random.4 +++ b/man4/random.4 @@ -18,9 +18,11 @@ .SH NAME random, urandom \- kernel random number source devices .SH SYNOPSIS +.nf #include .PP .BI "int ioctl(" fd ", RND" request ", " param ");" +.fi .SH DESCRIPTION The character special files \fI/dev/random\fP and \fI/dev/urandom\fP (present since Linux 1.3.30) diff --git a/man4/rtc.4 b/man4/rtc.4 index 932c04afa..136d3e212 100644 --- a/man4/rtc.4 +++ b/man4/rtc.4 @@ -31,9 +31,11 @@ .SH NAME rtc \- real-time clock .SH SYNOPSIS +.nf #include .PP .BI "int ioctl(" fd ", RTC_" request ", " param ");" +.fi .SH DESCRIPTION This is the interface to drivers for real-time clocks (RTCs). .PP diff --git a/man4/wavelan.4 b/man4/wavelan.4 index c615b748e..70906a90e 100644 --- a/man4/wavelan.4 +++ b/man4/wavelan.4 @@ -16,7 +16,9 @@ .SH NAME wavelan \- AT&T GIS WaveLAN ISA device driver .SH SYNOPSIS +.nf .BI "insmod wavelan_cs.o [io=" B,B.. "] [ irq=" I,I.. "] [name=" N,N.. ] +.fi .SH DESCRIPTION .I This driver is obsolete: it was removed from the kernel in version 2.6.35. diff --git a/man5/acct.5 b/man5/acct.5 index 798eb01d4..5a43373eb 100644 --- a/man5/acct.5 +++ b/man5/acct.5 @@ -26,7 +26,9 @@ .SH NAME acct \- process accounting file .SH SYNOPSIS +.nf .B #include +.fi .SH DESCRIPTION If the kernel is built with the process accounting option enabled .RB ( CONFIG_BSD_PROCESS_ACCT ), diff --git a/man5/hosts.5 b/man5/hosts.5 index 1230f9303..f71a826d1 100644 --- a/man5/hosts.5 +++ b/man5/hosts.5 @@ -28,7 +28,9 @@ .SH NAME hosts \- static table lookup for hostnames .SH SYNOPSIS +.nf .B /etc/hosts +.fi .SH DESCRIPTION This manual page describes the format of the .I /etc/hosts diff --git a/man5/resolv.conf.5 b/man5/resolv.conf.5 index e3be2df5c..c1b3d017a 100644 --- a/man5/resolv.conf.5 +++ b/man5/resolv.conf.5 @@ -25,7 +25,9 @@ .SH NAME resolv.conf \- resolver configuration file .SH SYNOPSIS +.nf .B /etc/resolv.conf +.fi .SH DESCRIPTION The .I resolver diff --git a/man5/rpc.5 b/man5/rpc.5 index a3e849fbe..510324bc4 100644 --- a/man5/rpc.5 +++ b/man5/rpc.5 @@ -9,7 +9,9 @@ .SH NAME rpc \- RPC program number data base .SH SYNOPSIS +.nf .B /etc/rpc +.fi .SH DESCRIPTION The .I rpc diff --git a/man5/slabinfo.5 b/man5/slabinfo.5 index 2f42117ff..51ea96e63 100644 --- a/man5/slabinfo.5 +++ b/man5/slabinfo.5 @@ -27,7 +27,9 @@ .SH NAME slabinfo \- kernel slab allocator statistics .SH SYNOPSIS +.nf .B cat /proc/slabinfo +.fi .SH DESCRIPTION Frequently used objects in the Linux kernel (buffer heads, inodes, dentries, etc.) diff --git a/man5/utmp.5 b/man5/utmp.5 index 641553196..c77c34488 100644 --- a/man5/utmp.5 +++ b/man5/utmp.5 @@ -31,7 +31,9 @@ .SH NAME utmp, wtmp \- login records .SH SYNOPSIS +.nf .B #include +.fi .SH DESCRIPTION The .I utmp diff --git a/man7/address_families.7 b/man7/address_families.7 index e97efc892..4533ccea1 100644 --- a/man7/address_families.7 +++ b/man7/address_families.7 @@ -27,11 +27,12 @@ .SH NAME address_families \- socket address families (domains) .SH SYNOPSIS +.nf .BR "#include " " /* See NOTES */" -.br .B #include .PP .BI "int socket(int " domain ", int " type ", int " protocol ); +.fi .SH DESCRIPTION The .I domain diff --git a/man7/complex.7 b/man7/complex.7 index 8f990e014..f957872c5 100644 --- a/man7/complex.7 +++ b/man7/complex.7 @@ -8,7 +8,9 @@ .SH NAME complex \- basics of complex mathematics .SH SYNOPSIS +.nf .B #include +.fi .SH DESCRIPTION Complex numbers are numbers of the form z = a+b*i, where a and b are real numbers and i = sqrt(\-1), so that i*i = \-1. diff --git a/man7/ddp.7 b/man7/ddp.7 index 023811c6d..bc05b1c24 100644 --- a/man7/ddp.7 +++ b/man7/ddp.7 @@ -13,13 +13,13 @@ .SH NAME ddp \- Linux AppleTalk protocol implementation .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .IB ddp_socket " = socket(AF_APPLETALK, SOCK_DGRAM, 0);" -.br .IB raw_socket " = socket(AF_APPLETALK, SOCK_RAW, " protocol ");" +.fi .SH DESCRIPTION Linux implements the AppleTalk protocols described in .IR "Inside AppleTalk" . diff --git a/man7/epoll.7 b/man7/epoll.7 index 3e823376c..5a4a4ae6a 100644 --- a/man7/epoll.7 +++ b/man7/epoll.7 @@ -22,7 +22,9 @@ .SH NAME epoll \- I/O event notification facility .SH SYNOPSIS +.nf .B #include +.fi .SH DESCRIPTION The .B epoll diff --git a/man7/ip.7 b/man7/ip.7 index cfc881d7f..ffb890250 100644 --- a/man7/ip.7 +++ b/man7/ip.7 @@ -43,19 +43,17 @@ .SH NAME ip \- Linux IPv4 protocol implementation .SH SYNOPSIS +.nf .B #include -.br .\" .B #include -- does not exist anymore .\" .B #include -- never include .B #include -.br .B #include \fR/* superset of previous */ .PP .IB tcp_socket " = socket(AF_INET, SOCK_STREAM, 0);" -.br .IB udp_socket " = socket(AF_INET, SOCK_DGRAM, 0);" -.br .IB raw_socket " = socket(AF_INET, SOCK_RAW, " protocol ");" +.fi .SH DESCRIPTION Linux implements the Internet Protocol, version 4, described in RFC\ 791 and RFC\ 1122. diff --git a/man7/ipv6.7 b/man7/ipv6.7 index 31c9c7591..eac853156 100644 --- a/man7/ipv6.7 +++ b/man7/ipv6.7 @@ -87,15 +87,14 @@ .SH NAME ipv6 \- Linux IPv6 protocol implementation .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .IB tcp6_socket " = socket(AF_INET6, SOCK_STREAM, 0);" -.br .IB raw6_socket " = socket(AF_INET6, SOCK_RAW, " protocol ");" -.br .IB udp6_socket " = socket(AF_INET6, SOCK_DGRAM, " protocol ");" +.fi .SH DESCRIPTION Linux 2.2 optionally implements the Internet Protocol, version 6. This man page contains a description of the IPv6 basic API as diff --git a/man7/netdevice.7 b/man7/netdevice.7 index 488e83d9a..15930807c 100644 --- a/man7/netdevice.7 +++ b/man7/netdevice.7 @@ -18,9 +18,10 @@ .SH NAME netdevice \- low-level access to Linux network devices .SH SYNOPSIS +.nf .B "#include " -.br .B "#include " +.fi .SH DESCRIPTION This man page describes the sockets interface which is used to configure network devices. diff --git a/man7/raw.7 b/man7/raw.7 index 51a5ca14b..b478c9b3d 100644 --- a/man7/raw.7 +++ b/man7/raw.7 @@ -13,11 +13,11 @@ .SH NAME raw \- Linux IPv4 raw sockets .SH SYNOPSIS +.nf .B #include -.br .B #include -.br .BI "raw_socket = socket(AF_INET, SOCK_RAW, int " protocol ); +.fi .SH DESCRIPTION Raw sockets allow new IPv4 protocols to be implemented in user space. A raw socket receives or sends the raw datagram not diff --git a/man7/rtnetlink.7 b/man7/rtnetlink.7 index d18380a42..cd6809320 100644 --- a/man7/rtnetlink.7 +++ b/man7/rtnetlink.7 @@ -15,15 +15,14 @@ .SH NAME rtnetlink \- Linux IPv4 routing socket .SH SYNOPSIS +.nf .B #include -.br .B #include -.br .B #include -.br .B #include .PP .BI "rtnetlink_socket = socket(AF_NETLINK, int " socket_type ", NETLINK_ROUTE);" +.fi .SH DESCRIPTION Rtnetlink allows the kernel's routing tables to be read and altered. It is used within the kernel to communicate between diff --git a/man7/socket.7 b/man7/socket.7 index 041edfd02..a4ef99125 100644 --- a/man7/socket.7 +++ b/man7/socket.7 @@ -55,9 +55,11 @@ .SH NAME socket \- Linux socket interface .SH SYNOPSIS +.nf .B #include .PP .IB sockfd " = socket(int " socket_family ", int " socket_type ", int " protocol ); +.fi .SH DESCRIPTION This manual page describes the Linux networking socket layer user interface. diff --git a/man7/tcp.7 b/man7/tcp.7 index 6c91f058b..d6836f3a8 100644 --- a/man7/tcp.7 +++ b/man7/tcp.7 @@ -97,13 +97,13 @@ .SH NAME tcp \- TCP protocol .SH SYNOPSIS +.nf .B #include -.br .B #include -.br .B #include .PP .B tcp_socket = socket(AF_INET, SOCK_STREAM, 0); +.fi .SH DESCRIPTION This is an implementation of the TCP protocol defined in RFC\ 793, RFC\ 1122 and RFC\ 2001 with the NewReno and SACK diff --git a/man7/udp.7 b/man7/udp.7 index fff0bd46d..931668dea 100644 --- a/man7/udp.7 +++ b/man7/udp.7 @@ -13,13 +13,13 @@ .SH NAME udp \- User Datagram Protocol for IPv4 .SH SYNOPSIS +.nf .B #include -.br .B #include -.br .B #include .PP .B udp_socket = socket(AF_INET, SOCK_DGRAM, 0); +.fi .SH DESCRIPTION This is an implementation of the User Datagram Protocol described in RFC\ 768. diff --git a/man7/udplite.7 b/man7/udplite.7 index f5b36f9ea..aec1f44eb 100644 --- a/man7/udplite.7 +++ b/man7/udplite.7 @@ -28,13 +28,14 @@ .SH NAME udplite \- Lightweight User Datagram Protocol .SH SYNOPSIS +.nf .B #include -.br .\" FIXME . see #defines under `BUGS', .\" when glibc supports this, add .\" #include .PP .B sockfd = socket(AF_INET, SOCK_DGRAM, IPPROTO_UDPLITE); +.fi .SH DESCRIPTION This is an implementation of the Lightweight User Datagram Protocol (UDP-Lite), as described in RFC\ 3828. diff --git a/man7/unix.7 b/man7/unix.7 index c3372e28f..2e90b119b 100644 --- a/man7/unix.7 +++ b/man7/unix.7 @@ -21,13 +21,13 @@ .SH NAME unix \- sockets for local interprocess communication .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .IB unix_socket " = socket(AF_UNIX, type, 0);" -.br .IB error " = socketpair(AF_UNIX, type, 0, int *" sv ");" +.fi .SH DESCRIPTION The .B AF_UNIX diff --git a/man7/vdso.7 b/man7/vdso.7 index 9b426f823..584c5f241 100644 --- a/man7/vdso.7 +++ b/man7/vdso.7 @@ -14,9 +14,11 @@ .SH NAME vdso \- overview of the virtual ELF dynamic shared object .SH SYNOPSIS +.nf .B #include .PP .B void *vdso = (uintptr_t) getauxval(AT_SYSINFO_EHDR); +.fi .SH DESCRIPTION The "vDSO" (virtual dynamic shared object) is a small shared library that the kernel automatically maps into the diff --git a/man7/vsock.7 b/man7/vsock.7 index 5ddfc9d44..a0b4d19e7 100644 --- a/man7/vsock.7 +++ b/man7/vsock.7 @@ -26,13 +26,13 @@ .SH NAME vsock \- Linux VSOCK address family .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .IB stream_socket " = socket(AF_VSOCK, SOCK_STREAM, 0);" -.br .IB datagram_socket " = socket(AF_VSOCK, SOCK_DGRAM, 0);" +.fi .SH DESCRIPTION The VSOCK address family facilitates communication between virtual machines and the host they are running on. diff --git a/man7/x25.7 b/man7/x25.7 index 944cd2273..1c92c6288 100644 --- a/man7/x25.7 +++ b/man7/x25.7 @@ -13,11 +13,12 @@ .SH NAME x25 \- ITU-T X.25 / ISO-8208 protocol interface .SH SYNOPSIS +.nf .B #include -.br .B #include .PP .B x25_socket = socket(AF_X25, SOCK_SEQPACKET, 0); +.fi .SH DESCRIPTION X25 sockets provide an interface to the X.25 packet layer protocol. This allows applications to diff --git a/man8/sln.8 b/man8/sln.8 index bee6751be..5465dbbfa 100644 --- a/man8/sln.8 +++ b/man8/sln.8 @@ -26,9 +26,10 @@ .SH NAME sln \- create symbolic links .SH SYNOPSIS +.nf .BI sln " source dest" -.br .BI sln " filelist" +.fi .SH DESCRIPTION The .B sln diff --git a/man8/tzselect.8 b/man8/tzselect.8 index e9dcd1265..03a6b7c5e 100644 --- a/man8/tzselect.8 +++ b/man8/tzselect.8 @@ -6,7 +6,9 @@ .SH NAME tzselect \- select a timezone .SH SYNOPSIS +.nf .B tzselect +.fi .SH DESCRIPTION The .B tzselect