djsundog
/
circuitpython
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs/library/gc: Fix grammar and improve readability of gc.threshold().

This commit is contained in:
Damien George 2017-06-26 15:25:51 +10:00
parent 0a54b6dce9
commit 7a4694fc4e
1 changed files with 14 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
docs/library/gc.rst
View File

@ -41,24 +41,24 @@ Functions
.. function:: threshold([amount]) .. function:: threshold([amount])
Set or query additional GC allocation threshold. Normally, GC is Set or query the additional GC allocation threshold. Normally, a collection
triggered when new allocation cannot be satisfied, i.e. on out of is triggered only when a new allocation cannot be satisfied, i.e. on an
memory (OOM) condition. If this function is called, in addition to out-of-memory (OOM) condition. If this function is called, in addition to
OOM, GC will be triggered each time after *amount* of bytes has been OOM, a collection will be triggered each time after *amount* bytes have been
allocated (in total, since the previous time such amount of bytes allocated (in total, since the previous time such an amount of bytes
had been allocated). *amount* is usually specified as less than the have been allocated). *amount* is usually specified as less than the
full heap size, with the intention to trigger GC earlier than the full heap size, with the intention to trigger a collection earlier than when the
heap will be exhausted, and in the hope that early GC will prevent heap becomes exhausted, and in the hope that an early collection will prevent
excessive memory fragmentation. This is a heuristic measure, effect excessive memory fragmentation. This is a heuristic measure, the effect
of which will vary from an application to application, as well as of which will vary from application to application, as well as
the optimal value of *amount* parameter. the optimal value of the *amount* parameter.
Calling the function without argument will return current value of Calling the function without argument will return the current value of
the threshold. Value of -1 means a disabled allocation threshold. the threshold. A value of -1 means a disabled allocation threshold.
.. admonition:: Difference to CPython .. admonition:: Difference to CPython
:class: attention :class: attention
This function is MicroPython extension. CPython has a similar This function is a MicroPython extension. CPython has a similar
function - ``set_threshold()``, but due to different GC function - ``set_threshold()``, but due to different GC
implementations, its signature and semantics are different. implementations, its signature and semantics are different.