From af28ed71949cd653f8cac608f077e3a4c5eba91a Mon Sep 17 00:00:00 2001 From: "Erlend E. Aasland" Date: Thu, 5 Oct 2023 14:41:53 +0200 Subject: [PATCH] Adjustments: - Don't treat the docs build as a separate build system; it is not - Don't call GNU Autoconf a 'fragile project' - Remove TODO comments --- peps/pep-0755.rst | 23 ++++++----------------- 1 file changed, 6 insertions(+), 17 deletions(-) diff --git a/peps/pep-0755.rst b/peps/pep-0755.rst index 3ba18f12b32..6c5a66dd75f 100644 --- a/peps/pep-0755.rst +++ b/peps/pep-0755.rst @@ -53,11 +53,10 @@ we asked: [...] what do you consider pain points of todays build system? The desire of a unified build system was mentioned several times. -This need was accompanied by the pain point that we currently have _three_ build systems: +This need was accompanied by the pain point that we currently have _two_ build systems: 1. A Windows build system -2. The GNU Autoconf/Make build system -3. The docs build system +2. A GNU Autoconf/Make build system It is hard to keep the Windows and \*nix build systems in sync. Windows developers often find the GNU build system incomprehensible; @@ -115,23 +114,15 @@ Keeping the Makefile compatible with both BSD and GNU Make is a pain point. Few developers, core devs included, have deep M4 and GNU Autoconf knowledge, and it is hard to find contributors and new core developers with these skills. -Also, GNU Autoconf seems to me a fragile project; -there are no regular releases, and it has few active core developers. +Also, GNU Autoconf has no regular releases, and it has few active core developers. The Windows Build System ------------------------ -The Windows build consists of a collection of .xml and .bat files that was generated using VSCode many years ago, -and is now manually updated whenever needed. - -*TODO: write more stuff here* - - -The ``Docs/`` Build -------------------- - -*TODO: write something here* +The Windows build consists of a collection of :file:`.xml` and :file:`.bat` +files that was originally generated using VSCode, +and are now manually updated whenever needed. Use Cases @@ -173,8 +164,6 @@ this will affect how easy it will be to port Python to new architectures and pla Good documentation will help mitigate issues that arise. -*PERHAPS THIS SECTION BELONGS TO THE FOLLOW-UP PEP, INSTEAD OF HERE* - Copyright =========