Skip to content

Commit 0ddeedf

Browse files
committed
docs/uio: Typo fixes/lexical improvements.
1 parent bdb0d22 commit 0ddeedf

1 file changed

Lines changed: 5 additions & 5 deletions

File tree

docs/library/uio.rst

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -24,8 +24,8 @@ and made implicit to achieve higher efficiencies and save resources.
2424
An important dichotomy in CPython is unbuffered vs buffered streams. In
2525
MicroPython, all streams are currently unbuffered. This is because all
2626
modern OSes, and even many RTOSes and filesystem drivers already perform
27-
buffering on their side. Adding another later of buffering is counter-
28-
productive (an issue known as "bufferbloat") and spends precious memory.
27+
buffering on their side. Adding another layer of buffering is counter-
28+
productive (an issue known as "bufferbloat") and takes precious memory.
2929
Note that there still cases where buffering may be useful, so we may
3030
introduce optional buffering support at a later time.
3131

@@ -34,7 +34,7 @@ it's whether a stream may incur short read/writes or not. A short read
3434
is when a user asks e.g. 10 bytes from a stream, but gets less, similarly
3535
for writes. In CPython, unbuffered streams are automatically short
3636
operation susceptible, while buffered are guarantee against them. The
37-
no short read/writes is an important traits, as it allows to develop
37+
no short read/writes is an important trait, as it allows to develop
3838
more concise and efficient programs - something which is highly desirable
3939
for MicroPython. So, while MicroPython doesn't support buffered streams,
4040
it still provides for no-short-operations streams. Whether there will
@@ -47,7 +47,7 @@ be a port-specific class, where such a need is governed by hardware
4747
peculiarities.
4848

4949
The no-short-operations behavior gets tricky in case of non-blocking
50-
streams, blockedness vs non-blockedness being another CPython dichotomy,
50+
streams, blocking vs non-blocking behavior being another CPython dichotomy,
5151
fully supported by MicroPython. Non-blocking streams never wait for
5252
data either to arrive or be written - they read/write whatever possible,
5353
or signal lack of data (or ability to write data). Clearly, this conflicts
@@ -56,7 +56,7 @@ buffered (and this no-short-ops) streams is convoluted in CPython - in
5656
some places, such combination is prohibited, in some it's undefined or
5757
just not documented, in some cases it raises verbose exceptions. The
5858
matter is much simpler in MicroPython: non-blocking stream are important
59-
for efficient asynchronuous operations, so this property prevails on
59+
for efficient asynchronous operations, so this property prevails on
6060
the "no-short-ops" one. So, while blocking streams will avoid short
6161
reads/writes whenever possible (the only case to get a short read is
6262
if end of file is reached, or in case of error (but errors don't

0 commit comments

Comments
 (0)