@@ -222,7 +222,7 @@ in the Installation Guide.
222222 more details.
223223
224224 - Python 3.4 or later, or Python 2.7, a full installation including
225- ` urllib ` ; but ideally version 3.9.x, 3.10.x, 3. 11.x, 3.12.x , which
225+ ` urllib ` ; but ideally version 3.11.x or later , which
226226 will avoid having to build Sage's own copy of Python 3.
227227 See [ build/pkgs/python3/SPKG.rst] ( build/pkgs/python3/SPKG.rst )
228228 for more details.
@@ -334,12 +334,18 @@ in the Installation Guide.
33433411 . Optional, but highly recommended: Set some environment variables to
335335 customize the build.
336336
337- For example, the ` MAKE ` environment variable controls whether to
338- run several jobs in parallel. On a machine with 4 processors, say,
339- typing ` export MAKE="make -j4" ` will configure the build script to
340- perform a parallel compilation of Sage using 4 jobs. On some
341- powerful machines, you might even consider ` -j16 ` , as building with
342- more jobs than CPU cores can speed things up further.
337+ The ` MAKEFLAGS ` variable controls whether to run several jobs in parallel.
338+ To saturate all the execution threads of your CPU, we recommend to run
339+ ` export MAKEFLAGS="-j$(nproc) -l$(nproc).5" ` if you are on Linux, and
340+ ` export MAKEFLAGS="-j$(sysctl -n hw.ncpu) -l$(sysctl -n hw.ncpu).5" ` if you
341+ are on macOS.
342+
343+ Note that the compilation may nonetheless use a different number of
344+ processes, e.g., for parts that are built with ` ninja ` which automatically
345+ decides on the amount of parallelity to use. In practice, you might
346+ therefore see twice as many processes during the build process than your
347+ CPU has execution threads. Unless your system is low on RAM, this should
348+ not affect the time the compilation takes substantially.
343349
344350 To reduce the terminal output during the build, type ` export V=0 ` .
345351 (` V ` stands for "verbosity".)
@@ -551,11 +557,11 @@ SAGE_ROOT Root directory (create by git clone)
551557│ │ ├── installed/
552558│ │ │ Records of installed non-Python packages
553559│ │ ├── scripts/ Scripts for uninstalling installed packages
554- │ │ └── venv-python3.9 (SAGE_VENV)
560+ │ │ └── venv-python (SAGE_VENV)
555561│ │ │ Installation hierarchy (virtual environment)
556562│ │ │ for Python packages
557563│ │ ├── bin/ Executables and installed scripts
558- │ │ ├── lib/python3.9 /site-packages/
564+ │ │ ├── lib/python /site-packages/
559565│ │ │ Python modules/packages are installed here
560566│ │ └── var/lib/sage/
561567│ │ └── wheels/
0 commit comments