guest-file-seek accepts both symbolic and numeric @whence values, but
the former is documented as "preferred interface".  Remove or replace
mentions of numeric values by symbolic ones.

Signed-off-by: Markus Armbruster <[email protected]>
Message-ID: <[email protected]>
Reviewed-by: John Snow <[email protected]>
[Straightforward conflict with commit ae42905b2a (qapi: convert simple
intros for qga/qapi-schema.json) resolved]
---
 qga/qapi-schema.json | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/qga/qapi-schema.json b/qga/qapi-schema.json
index a6cda5eae1..de42dfe77d 100644
--- a/qga/qapi-schema.json
+++ b/qga/qapi-schema.json
@@ -327,11 +327,11 @@
 # @QGASeek:
 #     Symbolic names for use in `guest-file-seek`
 #
-# @set: Set to the specified offset (same effect as 'whence':0)
+# @set: Set to the specified offset
 #
-# @cur: Add offset to the current location (same effect as 'whence':1)
+# @cur: Add offset to the current location
 #
-# @end: Add offset to the end of the file (same effect as 'whence':2)
+# @end: Add offset to the end of the file
 #
 # Since: 2.6
 ##
@@ -356,7 +356,7 @@
 # @guest-file-seek:
 #     Seek to a position in the file, as with fseek(), and return the
 #     current file position afterward.  Also encapsulates ftell()'s
-#     functionality, with offset=0 and whence=1.
+#     functionality, with offset=0 and whence=cur.
 #
 # @handle: filehandle returned by `guest-file-open`
 #
-- 
2.55.0


Reply via email to