From c72480119a620e6dd3a90a3a3440831686ce514e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Alejandro=20S=C3=A1nchez=20Medina?= Date: Mon, 7 Aug 2023 23:48:22 +0200 Subject: [PATCH] nixpkgs manual, doc Python: render interpreters in a table (#246956) * nixpkgs manual, doc Python: render interpreters in a table The current paragraph presenting Python interpreters is verbose and hinders clarity. The information provided is well suited to be rendered as a table. Co-authored-by: Shahar "Dawn" Or * nixpkgs manual, doc Python: fix typos in interpreters' table * nixpkgs manual, doc Python: update header in interpreters' table * nixpkgs manual, doc Python: get rid of empty block code workaround in interpreters' table --------- Co-authored-by: Shahar "Dawn" Or --- doc/languages-frameworks/python.section.md | 19 ++++++++++++------- 1 file changed, 12 insertions(+), 7 deletions(-) diff --git a/doc/languages-frameworks/python.section.md b/doc/languages-frameworks/python.section.md index 947ce6028659..4d6dd876abd1 100644 --- a/doc/languages-frameworks/python.section.md +++ b/doc/languages-frameworks/python.section.md @@ -997,13 +997,18 @@ and in this case the `python3` interpreter is automatically used. ### Interpreters {#interpreters} -Versions 2.7, 3.8, 3.9, 3.10 and 3.11 of the CPython interpreter are available -as respectively `python27`, `python38`, `python39`, `python310` and `python311`. -The aliases `python2` and `python3` correspond to respectively `python27` and -`python310`. The attribute `python` maps to `python2`. The PyPy interpreters -compatible with Python 2.7 and 3 are available as `pypy27` and `pypy3`, with -aliases `pypy2` mapping to `pypy27` and `pypy` mapping to `pypy2`. The Nix -expressions for the interpreters can be found in +| Package | Aliases | Interpreter | +|------------|-----------------|-------------| +| python27 | python2, python | CPython 2.7 | +| python38 | | CPython 3.8 | +| python39 | | CPython 3.9 | +| python310 | python3 | CPython 3.10 | +| python311 | | CPython 3.11 | +| python312 | | CPython 3.12 | +| pypy27 | pypy2, pypy | PyPy2.7 | +| pypy39 | pypy3 | PyPy 3.9 | + +The Nix expressions for the interpreters can be found in `pkgs/development/interpreters/python`. All packages depending on any Python interpreter get appended