Move comment on setting the number of threads to set_nthreads.

Author: FrancescAlted

src/blosc2/core.py

@@ -892,11 +892,6 @@ def free_resources() -> None:
     temporary space.  You can use this function to release these
     resources when you are not going to use Blosc for a long time.
 
-    The number of threads can also be set via the ``BLOSC_NTHREADS`` environment
-    variable (e.g., ``export BLOSC_NTHREADS=1``). Additionally, you may want to set
-    ``NUMEXPR_NUM_THREADS`` as well since numexpr is used under the hood
-    (e.g., ``export NUMEXPR_NUM_THREADS=1``).
-
     Examples
     --------
     >>> blosc2.free_resources()
@@ -925,6 +920,13 @@ def set_nthreads(nthreads: int) -> int:
 
     Notes
     -----
+    The number of threads can also be set via the ``BLOSC_NTHREADS`` environment
+    variable (e.g., ``export BLOSC_NTHREADS=1``). Additionally, you may want to set
+    ``NUMEXPR_NUM_THREADS`` (e.g., ``export NUMEXPR_NUM_THREADS=1``) as well since
+    numexpr is used under the hood when performing some operations.  Note that
+    this function only sets the number of threads used by Blosc, not the number
+    of threads used by numexpr.
+
     The maximum number of threads for Blosc is :math:`2^{31} - 1`. In some
     cases, Blosc gets better results if you set the number of threads
     to a value slightly below your number of cores