loff_t.3type, off64_t.3type, off_t.3type, system_data_types.7: Move off_t and off64_t to separate page, and document loff_t

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

4 files changed, 93 insertions, 88 deletions

diff --git a/man3/loff_t.3type b/man3/loff_t.3type
new file mode 100644
index 000000000..37ecada85
--- /dev/null
+++ b/man3/loff_t.3type
@@ -0,0 +1 @@
+.so man3/off_t.3type
diff --git a/man3/off64_t.3type b/man3/off64_t.3type
index db50c0f09..37ecada85 100644
--- a/man3/off64_t.3type
+++ b/man3/off64_t.3type
@@ -1 +1 @@
-.so man7/system_data_types.7
+.so man3/off_t.3type
diff --git a/man3/off_t.3type b/man3/off_t.3type
index db50c0f09..f8bfaef27 100644
--- a/man3/off_t.3type
+++ b/man3/off_t.3type
@@ -1 +1,90 @@
-.so man7/system_data_types.7
+.\" Copyright (c) 2020-2022 by Alejandro Colomar <colomar.6.4.3@gmail.com>
+.\" and Copyright (c) 2020 by Michael Kerrisk <mtk.manpages@gmail.com>
+.\"
+.\" SPDX-License-Identifier: Linux-man-pages-copyleft
+.\"
+.\"
+.TH OFF_T 3type 2022-07-20 Linux "Linux Programmer's Manual"
+.SH NAME
+off_t, off64_t, loff_t \- file sizes
+.SH LIBRARY
+Standard C library
+.RI ( libc )
+.SH SYNOPSIS
+.nf
+.B #include <sys/types.h>
+.PP
+.BR typedef " /* ... */  " off_t;
+.PP
+.B #define _LARGEFILE64_SOURCE
+.B #include <sys/types.h>
+.PP
+.BR typedef " /* ... */  " off64_t;
+.PP
+.B #define _GNU_SOURCE
+.B #include <sys/types.h>
+.PP
+.BR typedef " /* ... */  " loff_t;
+.fi
+.SH DESCRIPTION
+.I off_t
+is used for describing file sizes.
+According to POSIX,
+it shall be a signed integer type.
+.PP
+.I off64_t
+is a 64-bit version of the type,
+used in glibc.
+.PP
+.I loff_t
+is a 64-bit version of the type,
+introduced by the Linux kernel.
+.SH VERSIONS
+.I <aio.h>
+and
+.I <stdio.h>
+define
+.I off_t
+since POSIX.1-2008.
+.SH CONFORMING TO
+.PD 0
+.IR off_t :
+POSIX.1-2001 and later.
+.PP
+.IR off64_t :
+Present in glibc and some BSDs.
+.PP
+.IR loff_t :
+Linux-specific.
+.PD
+.SH NOTES
+On some architectures,
+the width of
+.I off_t
+can be controlled with the feature test macro
+.BR _FILE_OFFSET_BITS .
+.PP
+The following headers also provide
+.IR off_t :
+.IR <aio.h> ,
+.IR <fcntl.h> ,
+.IR <stdio.h> ,
+.IR <sys/mman.h> ,
+.IR <sys/stat.h> ,
+and
+.IR <unistd.h> .
+.SH SEE ALSO
+.BR copy_file_range (2),
+.BR llseek (2),
+.BR lseek (2),
+.BR mmap (2),
+.BR posix_fadvise (2),
+.BR pread (2),
+.BR readahead (2),
+.BR sync_file_range (2),
+.BR truncate (2),
+.BR fseeko (3),
+.BR lockf (3),
+.BR lseek64 (3),
+.BR posix_fallocate (3),
+.BR feature_test_macros (7)
diff --git a/man7/system_data_types.7 b/man7/system_data_types.7
index 5b2401563..99619615b 100644
--- a/man7/system_data_types.7
+++ b/man7/system_data_types.7
@@ -55,93 +55,7 @@ system_data_types \- overview of system data types
 .\"------------------------------------- lldiv_t ----------------------/
 .\"------------------------------------- mode_t -----------------------/
 .\"------------------------------------- off64_t ----------------------/
-.TP
-.I off64_t
-.RS
-.IR Include :
-.IR <sys/types.h> .
-.PP
-Used for file sizes.
-It is a 64-bit signed integer type.
-.PP
-.IR "Conforming to" :
-Present in glibc.
-It is not standardized by the C language standard nor POSIX.
-.PP
-.IR Notes :
-The feature test macro
-.B _LARGEFILE64_SOURCE
-has to be defined for this type to be available.
-.PP
-.IR "See also" :
-.BR copy_file_range (2),
-.BR readahead (2),
-.BR sync_file_range (2),
-.BR lseek64 (3),
-.BR feature_test_macros (7)
-.PP
-See also the
-.\" .I loff_t
-.\" and
-.I off_t
-type in this page.
-.RE
 .\"------------------------------------- off_t ------------------------/
-.TP
-.I off_t
-.RS
-.IR Include :
-.IR <sys/types.h> .
-Alternatively,
-.IR <aio.h> ,
-.IR <fcntl.h> ,
-.IR <stdio.h> ,
-.IR <sys/mman.h> ,
-.IR <sys/stat.h.h> ,
-or
-.IR <unistd.h> .
-.PP
-Used for file sizes.
-According to POSIX,
-this shall be a signed integer type.
-.PP
-.IR Versions :
-.I <aio.h>
-and
-.I <stdio.h>
-define
-.I off_t
-since POSIX.1-2008.
-.PP
-.IR "Conforming to" :
-POSIX.1-2001 and later.
-.PP
-.IR Notes :
-On some architectures,
-the width of this type can be controlled with the feature test macro
-.BR _FILE_OFFSET_BITS .
-.PP
-.IR "See also" :
-.\" .BR fallocate (2),
-.BR lseek (2),
-.BR mmap (2),
-.\" .BR mmap2 (2),
-.BR posix_fadvise (2),
-.BR pread (2),
-.\" .BR preadv (2),
-.BR truncate (2),
-.BR fseeko (3),
-.\" .BR getdirentries (3),
-.BR lockf (3),
-.BR posix_fallocate (3),
-.BR feature_test_macros (7)
-.PP
-See also the
-.\" .I loff_t
-.\" and
-.I off64_t
-type in this page.
-.RE
 .\"------------------------------------- pid_t ------------------------/
 .\"------------------------------------- ptrdiff_t --------------------/
 .TP
@@ -257,6 +171,7 @@ type.
 POSIX.1-2001 and later.
 .PP
 .IR "See also" :
+.BR off_t (3type),
 .BR ssize_t (3type)
 .PP
 See also the