summaryrefslogtreecommitdiff
path: root/doc/source/user/using.rst
diff options
context:
space:
mode:
Diffstat (limited to 'doc/source/user/using.rst')
-rw-r--r--doc/source/user/using.rst12
1 files changed, 12 insertions, 0 deletions
diff --git a/doc/source/user/using.rst b/doc/source/user/using.rst
index b9659d0..7070e01 100644
--- a/doc/source/user/using.rst
+++ b/doc/source/user/using.rst
@@ -34,6 +34,18 @@ something like this::
While one can pass any arguments supported by setuptools to ``setup()``,
any conflicting arguments supplied in ``setup.cfg`` will take precedence.
+``pyproject.toml``
+------------------
+
+As an alternative to writing a ``setup.py`` you can instead setup PBR
+through the PEP 517 build-system configuration in ``pyproject.toml``.
+Your build-system block in ``pyproject.toml`` will need to look something
+like this::
+
+ [build-system]
+ requires = ["pbr>=5.7.0", "setuptools>=36.6.0", "wheel"]
+ build-backend = "pbr.build"
+
.. _setup_cfg:
``setup.cfg``