2020-03-16 release

2025-09-30 15:04:24 +03:00 · 2020-09-06 19:02:03 +02:00
parent 0e8fffd4de
commit 383e2b06c8
26 changed files with 2352 additions and 2020 deletions
--- a/doc/jsbignum.html
+++ b/doc/jsbignum.html
@@ -1,8 +1,7 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
 <html>
-<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
+<!-- Created by GNU Texinfo 6.1, http://www.gnu.org/software/texinfo/ -->
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
 <title>Javascript Bignum Extensions</title>

 <meta name="description" content="Javascript Bignum Extensions">
@@ -10,6 +9,7 @@
 <meta name="resource-type" content="document">
 <meta name="distribution" content="global">
 <meta name="Generator" content="makeinfo">
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
 <link href="#SEC_Contents" rel="contents" title="Table of Contents">
 <style type="text/css">
 <!--
@@ -121,7 +121,7 @@ changes were done in order to simplify the implementation.
 <ul>
 <li> <code>with operators from</code> is not supported. Operator overloading is always enabled.

-</li><li> The dispatch is not based on a static <code>[[OperatorSet]]</code> field in all instances. Instead, a dynamic lookup the of the <code>Symbol.operatorSet</code> property is done. This property is typically added in the prototype of each object.
+</li><li> The dispatch is not based on a static <code>[[OperatorSet]]</code> field in all instances. Instead, a dynamic lookup of the <code>Symbol.operatorSet</code> property is done. This property is typically added in the prototype of each object.

 </li><li> <code>Operators.create(...dictionaries)</code> is used to create a new OperatorSet object. The <code>Operators</code> function is supported as an helper to be closer to the TC39 proposal.

@@ -194,7 +194,7 @@ raised if <em>a &lt; 0</em>.
 <h3 class="section">4.1 Introduction</h3>

 <p>This extension adds the <code>BigFloat</code> primitive type. The
-<code>BigFloat</code> type represents floating point numbers are in base 2
+<code>BigFloat</code> type represents floating point numbers in base 2
 with the IEEE 754 semantics. A floating
 point number is represented as a sign, mantissa and exponent. The
 special values <code>NaN</code>, <code>+/-Infinity</code>, <code>+0</code> and <code>-0</code>
@@ -216,15 +216,13 @@ point environment is used.
 <code>RNDN</code> (&ldquo;round to nearest with ties to even&rdquo;)<a name="DOCF1" href="#FOOT1"><sup>1</sup></a>. The status flags of the global environment cannot be
 read<a name="DOCF2" href="#FOOT2"><sup>2</sup></a>. The precision of the global environment is
 <code>BigFloatEnv.prec</code>. The number of exponent bits of the global
-environment is <code>BigFloatEnv.expBits</code>.  If <code>BigFloatEnv.expBits</code> is
-strictly smaller than the maximum allowed number of exponent bits
-(<code>BigFloatEnv.expBitsMax</code>), then the global environment subnormal
-flag is set to <code>true</code>. Otherwise it is set to <code>false</code>;
+environment is <code>BigFloatEnv.expBits</code>. The global environment
+subnormal flag is set to <code>true</code>.
 </p>
-<p>For example, <code>prec = 53</code> and <code> expBits = 11</code> give exactly
-the same precision as the IEEE 754 64 bit floating point. The
+<p>For example, <code>prec = 53</code> and <code> expBits = 11</code> exactly give
+the same precision as the IEEE 754 64 bit floating point format. The
 default precision is <code>prec = 113</code> and <code> expBits = 15</code> (IEEE
-754 128 bit floating point).
+754 128 bit floating point format).
 </p>
 <p>The global floating point environment can only be modified temporarily
 when calling a function (see <code>BigFloatEnv.setPrec</code>). Hence a
@@ -433,9 +431,8 @@ environment. The initial value is <code>113</code>.
 </dd>
 <dt><code>expBits</code></dt>
 <dd><p>Getter. Return the exponent size in bits of the global floating point
-environment assuming an IEEE 754 representation. If <code>expBits &lt;
-expBitsMax</code>, then subnormal numbers are supported. The initial value
-is <code>15</code>.
+environment assuming an IEEE 754 representation. The initial value is
+<code>15</code>.
 </p>
 </dd>
 <dt><code>setPrec(f, p[, e])</code></dt>
@@ -608,7 +605,7 @@ Number value.

 <p>It returns <code>0m</code> if no parameter is provided. Otherwise the first
 parameter is converted to a bigdecimal by using ToString(). Hence
-Number value are not converted to their exact numerical value as
+Number values are not converted to their exact numerical value as
 BigDecimal.
 </p>
 <a name="Properties-of-the-BigDecimal-object"></a>
@@ -702,12 +699,12 @@ always represented as BigFloat.

 </li><li> The logical xor operator is still available with the <code>^^</code> operator.

-</li><li> The integer division operator can be overloaded by modifying the corresponding operator in <code>BigInt.prototype.[[OperatorSet]]</code>.
-
-</li><li> The integer power operator with a non zero negative exponent can be overloaded by modifying the corresponding operator in <code>BigInt.prototype.[[OperatorSet]]</code>.
-
 </li><li> The modulo operator (<code>%</code>) returns the Euclidian remainder (always positive) instead of the truncated remainder.

+</li><li> The integer division operator can be overloaded with <code>Operators.updateBigIntOperators(dictionary)</code>.
+
+</li><li> The integer power operator with a non zero negative exponent can be overloaded with <code>Operators.updateBigIntOperators(dictionary)</code>.
+
 </li></ul>

 <div class="footnote">
--- a/doc/jsbignum.pdf
+++ b/doc/jsbignum.pdf
--- a/doc/jsbignum.texi
+++ b/doc/jsbignum.texi
@@ -57,7 +57,7 @@ More precisely, the following modifications were made:

@item @code{with operators from} is not supported. Operator overloading is always enabled.

-@item The dispatch is not based on a static @code{[[OperatorSet]]} field in all instances. Instead, a dynamic lookup the of the @code{Symbol.operatorSet} property is done. This property is typically added in the prototype of each object.
+@item The dispatch is not based on a static @code{[[OperatorSet]]} field in all instances. Instead, a dynamic lookup of the @code{Symbol.operatorSet} property is done. This property is typically added in the prototype of each object.

@item @code{Operators.create(...dictionaries)} is used to create a new OperatorSet object. The @code{Operators} function is supported as an helper to be closer to the TC39 proposal.

@@ -119,7 +119,7 @@ Return the number of trailing zeros in the two's complement binary representatio
@section Introduction

 This extension adds the @code{BigFloat} primitive type. The
-@code{BigFloat} type represents floating point numbers are in base 2
+@code{BigFloat} type represents floating point numbers in base 2
 with the IEEE 754 semantics. A floating
 point number is represented as a sign, mantissa and exponent. The
 special values @code{NaN}, @code{+/-Infinity}, @code{+0} and @code{-0}
@@ -143,15 +143,13 @@ explicit.}. The status flags of the global environment cannot be
 read@footnote{The rationale is to avoid side effects for the built-in
 operators.}. The precision of the global environment is
@code{BigFloatEnv.prec}. The number of exponent bits of the global
-environment is @code{BigFloatEnv.expBits}.  If @code{BigFloatEnv.expBits} is
-strictly smaller than the maximum allowed number of exponent bits
-(@code{BigFloatEnv.expBitsMax}), then the global environment subnormal
-flag is set to @code{true}. Otherwise it is set to @code{false};
+environment is @code{BigFloatEnv.expBits}. The global environment
+subnormal flag is set to @code{true}.

-For example, @code{prec = 53} and @code{ expBits = 11} give exactly
-the same precision as the IEEE 754 64 bit floating point. The
+For example, @code{prec = 53} and @code{ expBits = 11} exactly give
+the same precision as the IEEE 754 64 bit floating point format. The
 default precision is @code{prec = 113} and @code{ expBits = 15} (IEEE
-754 128 bit floating point).
+754 128 bit floating point format).

 The global floating point environment can only be modified temporarily
 when calling a function (see @code{BigFloatEnv.setPrec}). Hence a
@@ -345,9 +343,8 @@ environment. The initial value is @code{113}.

@item expBits
 Getter. Return the exponent size in bits of the global floating point
-environment assuming an IEEE 754 representation. If @code{expBits <
-expBitsMax}, then subnormal numbers are supported. The initial value
-is @code{15}.
+environment assuming an IEEE 754 representation. The initial value is
+@code{15}.

@item setPrec(f, p[, e])
 Set the precision of the global floating point environment to @code{p}
@@ -492,7 +489,7 @@ BigDecimal literals are decimal floating point numbers with a trailing

 It returns @code{0m} if no parameter is provided. Otherwise the first
 parameter is converted to a bigdecimal by using ToString(). Hence
-Number value are not converted to their exact numerical value as
+Number values are not converted to their exact numerical value as
 BigDecimal.

@subsection Properties of the @code{BigDecimal} object
@@ -581,12 +578,12 @@ The following changes are made to the Javascript semantics:

@item The logical xor operator is still available with the @code{^^} operator.

-@item The integer division operator can be overloaded by modifying the corresponding operator in @code{BigInt.prototype.[[OperatorSet]]}.
-
-@item The integer power operator with a non zero negative exponent can be overloaded by modifying the corresponding operator in @code{BigInt.prototype.[[OperatorSet]]}.
-
@item The modulo operator (@code{%}) returns the Euclidian remainder (always positive) instead of the truncated remainder.

+@item The integer division operator can be overloaded with @code{Operators.updateBigIntOperators(dictionary)}.
+
+@item The integer power operator with a non zero negative exponent can be overloaded with @code{Operators.updateBigIntOperators(dictionary)}.
+
@end itemize

@bye
--- a/doc/quickjs.html
+++ b/doc/quickjs.html
@@ -1,8 +1,7 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
 <html>
-<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
+<!-- Created by GNU Texinfo 6.1, http://www.gnu.org/software/texinfo/ -->
 <head>
-<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
 <title>QuickJS Javascript Engine</title>

 <meta name="description" content="QuickJS Javascript Engine">
@@ -10,6 +9,7 @@
 <meta name="resource-type" content="document">
 <meta name="distribution" content="global">
 <meta name="Generator" content="makeinfo">
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
 <link href="#SEC_Contents" rel="contents" title="Table of Contents">
 <style type="text/css">
 <!--
@@ -519,50 +519,39 @@ optional properties:
 <dd><p>Evaluate the file <code>filename</code> as a script (global eval).
 </p>
 </dd>
-<dt><code>Error(errno)</code></dt>
-<dd>
-<p><code>std.Error</code> constructor. Error instances contain the field
-<code>errno</code> (error code) and <code>message</code> (result of
-<code>std.Error.strerror(errno)</code>).
-</p>
-<p>The constructor contains the following fields:
-</p>
-<dl compact="compact">
-<dt><code>EINVAL</code></dt>
-<dt><code>EIO</code></dt>
-<dt><code>EACCES</code></dt>
-<dt><code>EEXIST</code></dt>
-<dt><code>ENOSPC</code></dt>
-<dt><code>ENOSYS</code></dt>
-<dt><code>EBUSY</code></dt>
-<dt><code>ENOENT</code></dt>
-<dt><code>EPERM</code></dt>
-<dt><code>EPIPE</code></dt>
-<dd><p>Integer value of common errors (additional error codes may be defined).
-  </p></dd>
-<dt><code>strerror(errno)</code></dt>
-<dd><p>Return a string that describes the error <code>errno</code>.
-  </p></dd>
-</dl>
-
-</dd>
-<dt><code>open(filename, flags)</code></dt>
-<dd><p>Open a file (wrapper to the libc <code>fopen()</code>). Throws 
-<code>std.Error</code> in case of I/O error.
+<dt><code>loadFile(filename)</code></dt>
+<dd><p>Load the file <code>filename</code> and return it as a string assuming UTF-8
+encoding. Return <code>null</code> in case of I/O error.
 </p>
 </dd>
-<dt><code>popen(command, flags)</code></dt>
-<dd><p>Open a process by creating a pipe (wrapper to the libc <code>popen()</code>). Throws 
-<code>std.Error</code> in case of I/O error.
+<dt><code>open(filename, flags, errorObj = undefined)</code></dt>
+<dd><p>Open a file (wrapper to the libc <code>fopen()</code>). Return the FILE
+object or <code>null</code> in case of I/O error. If <code>errorObj</code> is not
+undefined, set its <code>errno</code> property to the error code or to 0 if
+no error occured.
 </p>
 </dd>
-<dt><code>fdopen(fd, flags)</code></dt>
+<dt><code>popen(command, flags, errorObj = undefined)</code></dt>
+<dd><p>Open a process by creating a pipe (wrapper to the libc
+<code>popen()</code>). Return the FILE
+object or <code>null</code> in case of I/O error. If <code>errorObj</code> is not
+undefined, set its <code>errno</code> property to the error code or to 0 if
+no error occured.
+</p>
+</dd>
+<dt><code>fdopen(fd, flags, errorObj = undefined)</code></dt>
 <dd><p>Open a file from a file handle (wrapper to the libc
-<code>fdopen()</code>). Throws <code>std.Error</code> in case of I/O error.
+<code>fdopen()</code>). Return the FILE
+object or <code>null</code> in case of I/O error. If <code>errorObj</code> is not
+undefined, set its <code>errno</code> property to the error code or to 0 if
+no error occured.
 </p>
 </dd>
-<dt><code>tmpfile()</code></dt>
-<dd><p>Open a temporary file. Throws <code>std.Error</code> in case of I/O error.
+<dt><code>tmpfile(errorObj = undefined)</code></dt>
+<dd><p>Open a temporary file. Return the FILE
+object or <code>null</code> in case of I/O error. If <code>errorObj</code> is not
+undefined, set its <code>errno</code> property to the error code or to 0 if
+no error occured.
 </p>
 </dd>
 <dt><code>puts(str)</code></dt>
@@ -589,6 +578,29 @@ optional properties:
 <dd><p>Constants for seek().
 </p>
 </dd>
+<dt><code>Error</code></dt>
+<dd>
+<p>Enumeration object containing the integer value of common errors
+(additional error codes may be defined):
+</p>
+<dl compact="compact">
+<dt><code>EINVAL</code></dt>
+<dt><code>EIO</code></dt>
+<dt><code>EACCES</code></dt>
+<dt><code>EEXIST</code></dt>
+<dt><code>ENOSPC</code></dt>
+<dt><code>ENOSYS</code></dt>
+<dt><code>EBUSY</code></dt>
+<dt><code>ENOENT</code></dt>
+<dt><code>EPERM</code></dt>
+<dt><code>EPIPE</code></dt>
+</dl>
+
+</dd>
+<dt><code>strerror(errno)</code></dt>
+<dd><p>Return a string that describes the error <code>errno</code>.
+</p>
+</dd>
 <dt><code>gc()</code></dt>
 <dd><p>Manually invoke the cycle removal algorithm. The cycle removal
 algorithm is automatically started when needed, so this function is
@@ -614,12 +626,14 @@ optional properties:
 </p>
 </dd>
 <dt><code>full</code></dt>
-<dd><p>Boolean (default = false). If true, return the an object contains
+<dd>  
+<p>Boolean (default = false). If true, return the an object contains
  the properties <code>response</code> (response content),
  <code>responseHeaders</code> (headers separated by CRLF), <code>status</code>
-  (status code). If <code>full</code> is false, only the response is
-  returned if the status is between 200 and 299. Otherwise an
-  <code>std.Error</code> exception is raised.
+  (status code). <code>response</code> is <code>null</code> is case of protocol or
+  network error. If <code>full</code> is false, only the response is
+  returned if the status is between 200 and 299. Otherwise <code>null</code>
+  is returned.
 </p>
 </dd>
 </dl>
@@ -631,7 +645,7 @@ optional properties:
 </p>
 <dl compact="compact">
 <dt><code>close()</code></dt>
-<dd><p>Close the file.
+<dd><p>Close the file. Return 0 if OK or <code>-errno</code> in case of I/O error.
 </p></dd>
 <dt><code>puts(str)</code></dt>
 <dd><p>Outputs the string with the UTF-8 encoding.
@@ -643,17 +657,27 @@ optional properties:
 <dd><p>Flush the buffered file.
 </p></dd>
 <dt><code>seek(offset, whence)</code></dt>
-<dd><p>Seek to a give file position (whence is <code>std.SEEK_*</code>). Throws a
-<code>std.Error</code> in case of I/O error.
+<dd><p>Seek to a give file position (whence is
+<code>std.SEEK_*</code>). <code>offset</code> can be a number or a bigint. Return
+0 if OK or <code>-errno</code> in case of I/O error.
 </p></dd>
 <dt><code>tell()</code></dt>
 <dd><p>Return the current file position.
 </p></dd>
+<dt><code>tello()</code></dt>
+<dd><p>Return the current file position as a bigint.
+</p></dd>
 <dt><code>eof()</code></dt>
 <dd><p>Return true if end of file.
 </p></dd>
 <dt><code>fileno()</code></dt>
 <dd><p>Return the associated OS handle.
+</p></dd>
+<dt><code>error()</code></dt>
+<dd><p>Return true if there was an error.
+</p></dd>
+<dt><code>clearerr()</code></dt>
+<dd><p>Clear the error indication.
 </p>
 </dd>
 <dt><code>read(buffer, position, length)</code></dt>
@@ -727,7 +751,9 @@ error code.
 </p>
 </dd>
 <dt><code>seek(fd, offset, whence)</code></dt>
-<dd><p>Seek in the file. Use <code>std.SEEK_*</code> for <code>whence</code>.
+<dd><p>Seek in the file. Use <code>std.SEEK_*</code> for
+<code>whence</code>. <code>offset</code> is either a number or a bigint. If
+<code>offset</code> is a bigint, a bigint is returned too.
 </p>
 </dd>
 <dt><code>read(fd, buffer, offset, length)</code></dt>
@@ -755,11 +781,11 @@ Return the number of written bytes or &lt; 0 if error.
 </p>
 </dd>
 <dt><code>remove(filename)</code></dt>
-<dd><p>Remove a file. Return 0 if OK or &lt; 0 if error.
+<dd><p>Remove a file. Return 0 if OK or <code>-errno</code>.
 </p>
 </dd>
 <dt><code>rename(oldname, newname)</code></dt>
-<dd><p>Rename a file. Return 0 if OK or &lt; 0 if error.
+<dd><p>Rename a file. Return 0 if OK or <code>-errno</code>.
 </p>
 </dd>
 <dt><code>realpath(path)</code></dt>
@@ -773,11 +799,11 @@ and <code>err</code> the error code.
 </p>
 </dd>
 <dt><code>chdir(path)</code></dt>
-<dd><p>Change the current directory. Return the error code.
+<dd><p>Change the current directory. Return 0 if OK or <code>-errno</code>.
 </p>
 </dd>
 <dt><code>mkdir(path, mode = 0o777)</code></dt>
-<dd><p>Create a directory at <code>path</code>. Return the error code.
+<dd><p>Create a directory at <code>path</code>. Return 0 if OK or <code>-errno</code>.
 </p>
 </dd>
 <dt><code>stat(path)</code></dt>
@@ -809,11 +835,11 @@ itself.
 </dd>
 <dt><code>utimes(path, atime, mtime)</code></dt>
 <dd><p>Change the access and modification times of the file <code>path</code>. The
-times are specified in milliseconds since 1970.
+times are specified in milliseconds since 1970. Return 0 if OK or <code>-errno</code>.
 </p>
 </dd>
 <dt><code>symlink(target, linkpath)</code></dt>
-<dd><p>Create a link at <code>linkpath</code> containing the string <code>target</code>.
+<dd><p>Create a link at <code>linkpath</code> containing the string <code>target</code>. Return 0 if OK or <code>-errno</code>.
 </p>
 </dd>
 <dt><code>readlink(path)</code></dt>
@@ -896,7 +922,8 @@ object containing optional parameters:

 </dd>
 <dt><code>waitpid(pid, options)</code></dt>
-<dd><p><code>waitpid</code> Unix system call. Return the array <code>[ret, status]</code>.
+<dd><p><code>waitpid</code> Unix system call. Return the array <code>[ret,
+status]</code>. <code>ret</code> contains <code>-errno</code> in case of error.
 </p>
 </dd>
 <dt><code>WNOHANG</code></dt>
--- a/doc/quickjs.pdf
+++ b/doc/quickjs.pdf
--- a/doc/quickjs.texi
+++ b/doc/quickjs.texi
@@ -373,44 +373,35 @@ optional properties:
@item loadScript(filename)
 Evaluate the file @code{filename} as a script (global eval).

-@item Error(errno)
+@item loadFile(filename)
+Load the file @code{filename} and return it as a string assuming UTF-8
+encoding. Return @code{null} in case of I/O error.

-@code{std.Error} constructor. Error instances contain the field
-@code{errno} (error code) and @code{message} (result of
-@code{std.Error.strerror(errno)}).
+@item open(filename, flags, errorObj = undefined)
+Open a file (wrapper to the libc @code{fopen()}). Return the FILE
+object or @code{null} in case of I/O error. If @code{errorObj} is not
+undefined, set its @code{errno} property to the error code or to 0 if
+no error occured.

-The constructor contains the following fields:
+@item popen(command, flags, errorObj = undefined)
+Open a process by creating a pipe (wrapper to the libc
+@code{popen()}). Return the FILE
+object or @code{null} in case of I/O error. If @code{errorObj} is not
+undefined, set its @code{errno} property to the error code or to 0 if
+no error occured.

-  @table @code
-  @item EINVAL
-  @item EIO
-  @item EACCES
-  @item EEXIST
-  @item ENOSPC
-  @item ENOSYS
-  @item EBUSY
-  @item ENOENT
-  @item EPERM
-  @item EPIPE
-    Integer value of common errors (additional error codes may be defined).
-  @item strerror(errno)
-    Return a string that describes the error @code{errno}.
-  @end table
-
-@item open(filename, flags)
-Open a file (wrapper to the libc @code{fopen()}). Throws 
-@code{std.Error} in case of I/O error.
-
-@item popen(command, flags)
-Open a process by creating a pipe (wrapper to the libc @code{popen()}). Throws 
-@code{std.Error} in case of I/O error.
-
-@item fdopen(fd, flags)
+@item fdopen(fd, flags, errorObj = undefined)
 Open a file from a file handle (wrapper to the libc
-@code{fdopen()}). Throws @code{std.Error} in case of I/O error.
+@code{fdopen()}). Return the FILE
+object or @code{null} in case of I/O error. If @code{errorObj} is not
+undefined, set its @code{errno} property to the error code or to 0 if
+no error occured.

-@item tmpfile()
-Open a temporary file. Throws @code{std.Error} in case of I/O error.
+@item tmpfile(errorObj = undefined)
+Open a temporary file. Return the FILE
+object or @code{null} in case of I/O error. If @code{errorObj} is not
+undefined, set its @code{errno} property to the error code or to 0 if
+no error occured.

@item puts(str)
 Equivalent to @code{std.out.puts(str)}.
@@ -431,6 +422,27 @@ Wrappers to the libc file @code{stdin}, @code{stdout}, @code{stderr}.
@item SEEK_END
 Constants for seek().

+@item Error
+
+Enumeration object containing the integer value of common errors
+(additional error codes may be defined):
+
+  @table @code
+  @item EINVAL
+  @item EIO
+  @item EACCES
+  @item EEXIST
+  @item ENOSPC
+  @item ENOSYS
+  @item EBUSY
+  @item ENOENT
+  @item EPERM
+  @item EPIPE
+  @end table
+
+@item strerror(errno)
+Return a string that describes the error @code{errno}.
+
@item gc()
 Manually invoke the cycle removal algorithm. The cycle removal
 algorithm is automatically started when needed, so this function is
@@ -453,12 +465,14 @@ optional properties:
  to be UTF-8 encoded.

  @item full
+  
  Boolean (default = false). If true, return the an object contains
  the properties @code{response} (response content),
  @code{responseHeaders} (headers separated by CRLF), @code{status}
-  (status code). If @code{full} is false, only the response is
-  returned if the status is between 200 and 299. Otherwise an
-  @code{std.Error} exception is raised.
+  (status code). @code{response} is @code{null} is case of protocol or
+  network error. If @code{full} is false, only the response is
+  returned if the status is between 200 and 299. Otherwise @code{null}
+  is returned.

  @end table

@@ -468,7 +482,7 @@ FILE prototype:

@table @code
@item close()
-Close the file.
+Close the file. Return 0 if OK or @code{-errno} in case of I/O error.
@item puts(str)
 Outputs the string with the UTF-8 encoding.
@item printf(fmt, ...args)
@@ -476,14 +490,21 @@ Formatted printf, same formats as the libc printf.
@item flush()
 Flush the buffered file.
@item seek(offset, whence)
-Seek to a give file position (whence is @code{std.SEEK_*}). Throws a
-@code{std.Error} in case of I/O error.
+Seek to a give file position (whence is
+@code{std.SEEK_*}). @code{offset} can be a number or a bigint. Return
+0 if OK or @code{-errno} in case of I/O error.
@item tell()
 Return the current file position.
+@item tello()
+Return the current file position as a bigint.
@item eof()
 Return true if end of file.
@item fileno()
 Return the associated OS handle.
+@item error()
+Return true if there was an error.
+@item clearerr()
+Clear the error indication.

@item read(buffer, position, length)
 Read @code{length} bytes from the file to the ArrayBuffer @code{buffer} at byte
@@ -545,7 +566,9 @@ POSIX open flags.
 Close the file handle @code{fd}.

@item seek(fd, offset, whence)
-Seek in the file. Use @code{std.SEEK_*} for @code{whence}.
+Seek in the file. Use @code{std.SEEK_*} for
+@code{whence}. @code{offset} is either a number or a bigint. If
+@code{offset} is a bigint, a bigint is returned too.

@item read(fd, buffer, offset, length)
 Read @code{length} bytes from the file handle @code{fd} to the
@@ -567,10 +590,10 @@ Return the TTY size as @code{[width, height]} or @code{null} if not available.
 Set the TTY in raw mode.

@item remove(filename)
-Remove a file. Return 0 if OK or < 0 if error.
+Remove a file. Return 0 if OK or @code{-errno}.

@item rename(oldname, newname)
-Rename a file. Return 0 if OK or < 0 if error.
+Rename a file. Return 0 if OK or @code{-errno}.

@item realpath(path)
 Return @code{[str, err]} where @code{str} is the canonicalized absolute
@@ -581,10 +604,10 @@ Return @code{[str, err]} where @code{str} is the current working directory
 and @code{err} the error code.

@item chdir(path)
-Change the current directory. Return the error code.
+Change the current directory. Return 0 if OK or @code{-errno}.

@item mkdir(path, mode = 0o777)
-Create a directory at @code{path}. Return the error code.
+Create a directory at @code{path}. Return 0 if OK or @code{-errno}.

@item stat(path)
@item lstat(path)
@@ -613,10 +636,10 @@ Constants to interpret the @code{mode} property returned by

@item utimes(path, atime, mtime)
 Change the access and modification times of the file @code{path}. The
-times are specified in milliseconds since 1970.
+times are specified in milliseconds since 1970. Return 0 if OK or @code{-errno}.

@item symlink(target, linkpath)
-Create a link at @code{linkpath} containing the string @code{target}.
+Create a link at @code{linkpath} containing the string @code{target}. Return 0 if OK or @code{-errno}.

@item readlink(path)
 Return @code{[str, err]} where @code{str} is the link target and @code{err}
@@ -685,7 +708,8 @@ object containing optional parameters:
  @end table

@item waitpid(pid, options)
-@code{waitpid} Unix system call. Return the array @code{[ret, status]}.
+@code{waitpid} Unix system call. Return the array @code{[ret,
+status]}. @code{ret} contains @code{-errno} in case of error.

@item WNOHANG
 Constant for the @code{options} argument of @code{waitpid}.