@@ -552,6 +552,17 @@ Now that the configuration is in place, it remains to compile the project:
552
552
553
553
* ``make regen-configure `` updates the :cpy-file: `configure ` script.
554
554
555
+ The :cpy-file: `configure ` script must be generated using a specific version
556
+ of ``autoconf ``. To that end, the :cpy-file: `Tools/build/regen-configure.sh `
557
+ script which the ``regen-configure `` rule is based on either requires Docker
558
+ or Podman, the latter being assumed by default.
559
+
560
+ .. tip ::
561
+
562
+ We recommend installing `Podman <https://podman.io/docs/installation >`_
563
+ instead of Docker since the former does not require a background service
564
+ and avoids creating files owned by the ``root `` user in some cases.
565
+
555
566
* ``make regen-all `` is responsible for regenerating header files and
556
567
invoking other scripts, such as :ref: `Argument Clinic <clinic >`.
557
568
Execute this rule if you do not know which files should be updated.
@@ -590,37 +601,13 @@ by executing :cpy-file:`Tools/build/regen-configure.sh`:
590
601
./Tools/build/regen-configure.sh # create an up-to-date 'configure'
591
602
./configure # create an up-to-date 'Makefile'
592
603
593
- ``make regen-configure `` and missing permissions
594
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
595
-
596
- Since this rule requires `Docker <https://docs.docker.com/desktop >`_ to be
597
- running, the following can be done on Linux platforms (``systemctl ``-based):
598
-
599
- .. code-block :: shell
600
-
601
- systemctl status docker # is the Docker service running?
602
- sudo systemctl start docker # start it if it is not
603
- sudo systemctl restart docker # or restart it if the issue persists
604
+ ``make regen-configure `` and missing permissions with Docker
605
+ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
604
606
605
607
If Docker complains about missing permissions, this Stack Overflow post
606
608
could be useful in solving the issue: `How to fix docker: permission denied
607
- <https://stackoverflow.com/q/48957195/9579194> `_.
608
-
609
- Once the Docker service is running, check that you have an `Ubuntu
610
- $CONFIGURE_UBUNTU_VERSION$ image <https://hub.docker.com/_/ubuntu> `_,
611
- or pull it if it is not case:
612
-
613
- .. code-block :: shell
614
-
615
- # check for the Docker image presence
616
- docker images ubuntu:$CONFIGURE_UBUNTU_VERSION $
617
- # pull the Docker image if needed
618
- docker image pull ubuntu:$CONFIGURE_UBUNTU_VERSION $
619
-
620
- .. tip ::
621
-
622
- If the issue persists, you may try `podman <https://podman.io/ >`_.
623
- The commands for listing or pulling an image are the same as ``docker ``.
609
+ <https://stackoverflow.com/q/48957195/9579194> `_. Alternatively, you may try
610
+ using `Podman <https://podman.io/docs/installation >`_.
624
611
625
612
Missing ``Py_BUILD_CORE `` define when using internal headers
626
613
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
0 commit comments