File 0967-kernel-Clarify-file-pwrite-pread-documenta... of Package erlang

Overview Repositories Revisions Requests Users Attributes Meta

File 0967-kernel-Clarify-file-pwrite-pread-documentation.patch of Package erlang

From 9d3a92bc6bc40be676429d06350311d4b154eec7 Mon Sep 17 00:00:00 2001
From: Sverker Eriksson <sverker@erlang.org>
Date: Mon, 24 Aug 2020 15:10:27 +0200
Subject: [PATCH] kernel: Clarify file:pwrite/pread documentation

about ram mode
---
 lib/kernel/doc/src/file.xml | 29 ++++++++++++-----------------
 1 file changed, 12 insertions(+), 17 deletions(-)

diff --git a/lib/kernel/doc/src/file.xml b/lib/kernel/doc/src/file.xml
index fc25e83d40..79c49614d1 100644
--- a/lib/kernel/doc/src/file.xml
+++ b/lib/kernel/doc/src/file.xml
@@ -1268,15 +1268,12 @@ f.txt: {person, "kalle", 25}.
 <desc>
 Combines <c>position/2</c> and <c>read/2</c> in one
 operation, which is more efficient than calling them one at a
- time. If <c><anno>IoDevice</anno></c> is opened in <c>raw</c> mode,
- some restrictions apply:
-	 <list type="bulleted">
-	 <item><c><anno>Location</anno></c> is only allowed to be an
- integer.</item>
-	 <item>The current position of the file is undefined after the
-	 operation.</item>
-	 </list>
-	 As the position is specified as a byte-offset, take special caution
+ time.
+	<c><anno>Location</anno></c> is only allowed to be an
+ integer for <c>raw</c> and <c>ram</c> modes.
+	The current position of the file after the operation
+	 is undefined for <c>raw</c> mode and unchanged for <c>ram</c> mode.
+	As the position is specified as a byte-offset, take special caution
 	 when working with files where <c>encoding</c> is set to something else
 	 than <c>latin1</c>, as not every byte position is a valid character
 	 boundary on such a file.
@@ -1303,14 +1300,12 @@ f.txt: {person, "kalle", 25}.
 <desc>
 Combines <c>position/2</c> and <c>write/2</c> in one
 operation, which is more efficient than calling them one at a
- time. If <c><anno>IoDevice</anno></c> has been opened in <c>raw</c> mode,
- some restrictions apply:
-	 <list type="bulleted">
-	 <item><c><anno>Location</anno></c> is only allowed to be an
- integer.</item>
-	 <item>The current position of the file is undefined after the
-	 operation.</item>
-	 </list>
+ time.
+	
+	<c><anno>Location</anno></c> is only allowed to be an
+ integer for <c>raw</c> and <c>ram</c> modes.
+	The current position of the file after the operation
+	 is undefined for <c>raw</c> mode and unchanged for <c>ram</c> mode.
 	When positioning in a file with other <c>encoding</c> than <c>latin1</c>,
 	caution must be taken to set the position on a correct character boundary.
 	For details, see <seealso marker="#position/2"><c>position/2</c></seealso>.
-- 
2.26.2

Places

File 0967-kernel-Clarify-file-pwrite-pread-documentation.patch of Package erlang

Places