llseek.2: Some mild rewriting to ease reading of the info in this page

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

diff --git a/man2/llseek.2 b/man2/llseek.2
index 8947d4ca1378248a89558caf3916829ad4e6e17b..7b60203ab35e5dd55150c08e617db89a0b707c4c 100644 (file)
--- a/man2/llseek.2
+++ b/man2/llseek.2
@@ -1,5 +1,6 @@
 .\" Copyright (C) 1995 Andries Brouwer (aeb@cwi.nl)
 .\" Written 10 June 1995 by Andries Brouwer <aeb@cwi.nl>
+.\" and Copyright (C) 2007, 2015, 2020, Michael Kerrisk <mtk.manpages@gmail.com>
 .\"
 .\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
@@ -46,9 +47,12 @@ The
 system call repositions the offset of the open file description associated
 with the file descriptor
 .I fd
-to
-.I (offset_high<<32) | offset_low
-bytes relative to the beginning of the file, the current file offset,
+to the value
+.IP
+(offset_high << 32) | offset_low
+.PP
+This new offset is a byte offset
+relative to the beginning of the file, the current file offset,
 or the end of the file, depending on whether
 .I whence
 is
@@ -57,7 +61,8 @@ is
 or
 .BR SEEK_END ,
 respectively.
-It returns the resulting file position in the argument
+.PP
+The new file offset is returned in the argument
 .IR result .
 .PP
 This system call exists on various 32-bit platforms to support