Sign Up
Log In
Log In
or
Sign Up
Places
All Projects
Status Monitor
Collapse sidebar
home:Ledest:erlang:23
erlang
0366-kernel-Clarify-file-pwrite-pread-documenta...
Overview
Repositories
Revisions
Requests
Users
Attributes
Meta
File 0366-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> <p>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:</p> - <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> - <p>As the position is specified as a byte-offset, take special caution + time.</p> + <p><c><anno>Location</anno></c> is only allowed to be an + integer for <c>raw</c> and <c>ram</c> modes.</p> + <p>The current position of the file after the operation + is undefined for <c>raw</c> mode and unchanged for <c>ram</c> mode.</p> + <p>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.</p> @@ -1303,14 +1300,12 @@ f.txt: {person, "kalle", 25}. <desc> <p>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:</p> - <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. + </p> + <p><c><anno>Location</anno></c> is only allowed to be an + integer for <c>raw</c> and <c>ram</c> modes.</p> + <p>The current position of the file after the operation + is undefined for <c>raw</c> mode and unchanged for <c>ram</c> mode.</p> <p>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 <seemfa marker="#position/2"><c>position/2</c></seemfa>.</p> -- 2.26.2
Locations
Projects
Search
Status Monitor
Help
OpenBuildService.org
Documentation
API Documentation
Code of Conduct
Contact
Support
@OBShq
Terms
openSUSE Build Service is sponsored by
The Open Build Service is an
openSUSE project
.
Sign Up
Log In
Places
Places
All Projects
Status Monitor