Skip to content

Commit d80aea3

Browse files
committed
Address @willingc's review
1 parent 26d3fb9 commit d80aea3

File tree

1 file changed

+7
-8
lines changed

1 file changed

+7
-8
lines changed

source/guides/writing-pyproject-toml.rst

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -15,11 +15,10 @@ three possible TOML tables in this file.
1515
- The ``[project]`` table is the format that most build backends use to specify
1616
your project's basic metadata, such as the dependencies, your name, etc.
1717

18-
- The ``[tool]`` table has arbitrary subtables corresponding to tools, whether
19-
packaging-related or not, e.g., ``[tool.hatch]``, ``[tool.black]``,
20-
``[tool.mypy]``. We only touch upon this table here because its contents are
21-
entirely tool-specific. Consult each tool's documentation to know what it can
22-
contain.
18+
- The ``[tool]`` table has tool-specific subtables, e.g., ``[tool.hatch]``,
19+
``[tool.black]``, ``[tool.mypy]``. We only touch upon this table here because
20+
its contents are defined by each tool. Consult the particular tool's
21+
documentation to know what it can contain.
2322

2423
.. note::
2524

@@ -36,7 +35,7 @@ three possible TOML tables in this file.
3635
Also, the setuptools_ build backend supports both the ``[project]`` table,
3736
and the older format in ``setup.cfg`` or ``setup.py``. For new projects, it
3837
is recommended to use the ``[project]`` table, and keep ``setup.py`` only if
39-
some programmatic configuration is needed (especially building C extensions),
38+
some programmatic configuration is needed (such as building C extensions),
4039
but the ``setup.cfg`` and ``setup.py`` formats are still valid. See
4140
:ref:`setup-py-deprecated`.
4241

@@ -88,12 +87,12 @@ Here are the values for some common build backends:
8887
build-backend = "pdm.backend"
8988
9089
91-
The rest of this guide is devoted to the ``[project]`` table.
92-
9390
9491
Static vs. dynamic metadata
9592
===========================
9693

94+
The rest of this guide is devoted to the ``[project]`` table.
95+
9796
Most of the time, you will directly write the value of a ``[project]``
9897
field. For example: ``requires-python = ">= 3.8"``, or ``version =
9998
"1.0"``.

0 commit comments

Comments
 (0)