From 7bd578395372f8f7a067c9fb8810f3e1ba46379c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EA=B8=B8=EC=9E=AC=EC=9D=80?= Date: Fri, 11 Aug 2023 15:36:03 +0900 Subject: [PATCH 01/18] Update setup-building.rst add configure optimization options --- getting-started/setup-building.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/getting-started/setup-building.rst b/getting-started/setup-building.rst index 60db82d47..8e534e9ef 100644 --- a/getting-started/setup-building.rst +++ b/getting-started/setup-building.rst @@ -237,6 +237,16 @@ build the :py:mod:`ctypes` module (without the flag the rest of CPython will still build properly). +Optimization +''''' + +To get an optimized build of Python, ``configure --enable-optimizations``. This sets the default make targets up to enable Profile Guided Optimization (PGO) and may be used to auto-enable Link Time Optimization (LTO) on some platforms. Note that configuration including this option takes time to configure. + +```sh +./configure --enable-optimizations --with-lto +``` + + .. _windows-compiling: Windows From 2754f9965fc688581954ee0dbcf7b14f34de3ab8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EA=B8=B8=EC=9E=AC=EC=9D=80?= Date: Fri, 11 Aug 2023 15:37:13 +0900 Subject: [PATCH 02/18] Update setup-building.rst add optimization option --- getting-started/setup-building.rst | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/getting-started/setup-building.rst b/getting-started/setup-building.rst index 8e534e9ef..8eeb62a92 100644 --- a/getting-started/setup-building.rst +++ b/getting-started/setup-building.rst @@ -242,9 +242,7 @@ Optimization To get an optimized build of Python, ``configure --enable-optimizations``. This sets the default make targets up to enable Profile Guided Optimization (PGO) and may be used to auto-enable Link Time Optimization (LTO) on some platforms. Note that configuration including this option takes time to configure. -```sh -./configure --enable-optimizations --with-lto -``` + $ ./configure --enable-optimizations --with-lto .. _windows-compiling: From cda1236d2465114fd4dad0274df0dc427a15b2a5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EA=B8=B8=EC=9E=AC=EC=9D=80?= Date: Fri, 11 Aug 2023 15:38:19 +0900 Subject: [PATCH 03/18] Update setup-building.rst --- getting-started/setup-building.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/getting-started/setup-building.rst b/getting-started/setup-building.rst index 8eeb62a92..b79932d30 100644 --- a/getting-started/setup-building.rst +++ b/getting-started/setup-building.rst @@ -240,7 +240,7 @@ still build properly). Optimization ''''' -To get an optimized build of Python, ``configure --enable-optimizations``. This sets the default make targets up to enable Profile Guided Optimization (PGO) and may be used to auto-enable Link Time Optimization (LTO) on some platforms. Note that configuration including this option takes time to configure. +To get an optimized build of Python, ``configure --enable-optimizations``. This sets the default make targets up to enable Profile Guided Optimization (PGO) and may be used to auto-enable Link Time Optimization (LTO) on some platforms. Note that configuration including this option takes time to configure:: $ ./configure --enable-optimizations --with-lto From 72576c4343fffddcf2066fa8295245cfa0e67002 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EA=B8=B8=EC=9E=AC=EC=9D=80?= Date: Fri, 11 Aug 2023 15:45:36 +0900 Subject: [PATCH 04/18] Update setup-building.rst option doc add --- getting-started/setup-building.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/getting-started/setup-building.rst b/getting-started/setup-building.rst index b79932d30..a9c7cf4c2 100644 --- a/getting-started/setup-building.rst +++ b/getting-started/setup-building.rst @@ -240,7 +240,8 @@ still build properly). Optimization ''''' -To get an optimized build of Python, ``configure --enable-optimizations``. This sets the default make targets up to enable Profile Guided Optimization (PGO) and may be used to auto-enable Link Time Optimization (LTO) on some platforms. Note that configuration including this option takes time to configure:: +To get an optimized build of Python, ``configure --enable-optimizations``. This sets the default make targets up to enable Profile Guided Optimization (PGO) and may be used to auto-enable Link Time Optimization (LTO) on some platforms. Note that configuration including this option takes time to configure. If you want to learn more about these options, please see [configure options > Performance options ](https://docs.python.org/3/using/configure.html?highlight=lto#performance-options) +:: $ ./configure --enable-optimizations --with-lto From 5978eb444b07bb9be16508d60ebb9756442f9ba2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EA=B8=B8=EC=9E=AC=EC=9D=80?= Date: Fri, 11 Aug 2023 15:47:26 +0900 Subject: [PATCH 05/18] Update setup-building.rst --- getting-started/setup-building.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/getting-started/setup-building.rst b/getting-started/setup-building.rst index a9c7cf4c2..24d2606cc 100644 --- a/getting-started/setup-building.rst +++ b/getting-started/setup-building.rst @@ -240,8 +240,7 @@ still build properly). Optimization ''''' -To get an optimized build of Python, ``configure --enable-optimizations``. This sets the default make targets up to enable Profile Guided Optimization (PGO) and may be used to auto-enable Link Time Optimization (LTO) on some platforms. Note that configuration including this option takes time to configure. If you want to learn more about these options, please see [configure options > Performance options ](https://docs.python.org/3/using/configure.html?highlight=lto#performance-options) -:: +To get an optimized build of Python, ``configure --enable-optimizations``. This sets the default make targets up to enable Profile Guided Optimization (PGO) and may be used to auto-enable Link Time Optimization (LTO) on some platforms. Note that configuration including this option takes time to configure. If you want to learn more about these options, please see `Configure options > Performance options `_ :: $ ./configure --enable-optimizations --with-lto From 749ab204fe074c8059cc11ad584045910cf7765a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EA=B8=B8=EC=9E=AC=EC=9D=80?= Date: Fri, 11 Aug 2023 15:53:42 +0900 Subject: [PATCH 06/18] Update setup-building.rst --- getting-started/setup-building.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/getting-started/setup-building.rst b/getting-started/setup-building.rst index 24d2606cc..c38308b76 100644 --- a/getting-started/setup-building.rst +++ b/getting-started/setup-building.rst @@ -240,7 +240,7 @@ still build properly). Optimization ''''' -To get an optimized build of Python, ``configure --enable-optimizations``. This sets the default make targets up to enable Profile Guided Optimization (PGO) and may be used to auto-enable Link Time Optimization (LTO) on some platforms. Note that configuration including this option takes time to configure. If you want to learn more about these options, please see `Configure options > Performance options `_ :: +To get an optimized build of Python, ``configure --enable-optimizations``. This sets the default make targets up to enable Profile Guided Optimization (PGO) and may be used to auto-enable Link Time Optimization (LTO) on some platforms. Note that configuration including this option takes time to configure. If you want to learn more about these options, please see `Configure > Performance options `_ :: $ ./configure --enable-optimizations --with-lto From e0ea7b462a1ac5dc348d88cf2bf08b256036e72e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EA=B8=B8=EC=9E=AC=EC=9D=80?= Date: Fri, 11 Aug 2023 15:55:03 +0900 Subject: [PATCH 07/18] Update setup-building.rst --- getting-started/setup-building.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/getting-started/setup-building.rst b/getting-started/setup-building.rst index c38308b76..9f73f7129 100644 --- a/getting-started/setup-building.rst +++ b/getting-started/setup-building.rst @@ -240,7 +240,7 @@ still build properly). Optimization ''''' -To get an optimized build of Python, ``configure --enable-optimizations``. This sets the default make targets up to enable Profile Guided Optimization (PGO) and may be used to auto-enable Link Time Optimization (LTO) on some platforms. Note that configuration including this option takes time to configure. If you want to learn more about these options, please see `Configure > Performance options `_ :: +To get an optimized build of Python, ``configure --enable-optimizations --with-lto``. This sets the default make targets up to enable Profile Guided Optimization (PGO) and may be used to auto-enable Link Time Optimization (LTO) on some platforms. Note that configuration including this option takes time to configure. If you want to learn more about these options, please see `Configure > Performance options `_ :: $ ./configure --enable-optimizations --with-lto From 925e72f113e7d2bc2a6f41702328b63ddcd1ae16 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EA=B8=B8=EC=9E=AC=EC=9D=80?= Date: Fri, 11 Aug 2023 15:55:26 +0900 Subject: [PATCH 08/18] Update setup-building.rst --- getting-started/setup-building.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/getting-started/setup-building.rst b/getting-started/setup-building.rst index 9f73f7129..999c1ad4b 100644 --- a/getting-started/setup-building.rst +++ b/getting-started/setup-building.rst @@ -240,7 +240,7 @@ still build properly). Optimization ''''' -To get an optimized build of Python, ``configure --enable-optimizations --with-lto``. This sets the default make targets up to enable Profile Guided Optimization (PGO) and may be used to auto-enable Link Time Optimization (LTO) on some platforms. Note that configuration including this option takes time to configure. If you want to learn more about these options, please see `Configure > Performance options `_ :: +To get an optimized build of Python, ``configure --enable-optimizations --with-lto``. This sets the default make targets up to enable Profile Guided Optimization (PGO) and may be used to auto-enable Link Time Optimization (LTO) on some platforms. Note that configuration including this option takes time to configure. If you want to learn more about these options, please see `Configure > Performance options `_ :: $ ./configure --enable-optimizations --with-lto From 5cbed5925ab9eb263db3d7d89ca7a78e9adfd3c5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EA=B8=B8=EC=9E=AC=EC=9D=80?= Date: Fri, 11 Aug 2023 16:08:59 +0900 Subject: [PATCH 09/18] Update setup-building.rst --- getting-started/setup-building.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/getting-started/setup-building.rst b/getting-started/setup-building.rst index 999c1ad4b..580e9a6f4 100644 --- a/getting-started/setup-building.rst +++ b/getting-started/setup-building.rst @@ -238,7 +238,7 @@ still build properly). Optimization -''''' +'''''''''''' To get an optimized build of Python, ``configure --enable-optimizations --with-lto``. This sets the default make targets up to enable Profile Guided Optimization (PGO) and may be used to auto-enable Link Time Optimization (LTO) on some platforms. Note that configuration including this option takes time to configure. If you want to learn more about these options, please see `Configure > Performance options `_ :: From 562c39181599365e91db201e7db5c00301f56c98 Mon Sep 17 00:00:00 2001 From: "jaeeun.kil" Date: Sun, 13 Aug 2023 15:46:19 +0900 Subject: [PATCH 10/18] =?UTF-8?q?feat:=20=F0=9F=8E=B8=20add=20code=20revie?= =?UTF-8?q?w?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- getting-started/setup-building.rst | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/getting-started/setup-building.rst b/getting-started/setup-building.rst index 580e9a6f4..b8f8a4f0a 100644 --- a/getting-started/setup-building.rst +++ b/getting-started/setup-building.rst @@ -240,7 +240,18 @@ still build properly). Optimization '''''''''''' -To get an optimized build of Python, ``configure --enable-optimizations --with-lto``. This sets the default make targets up to enable Profile Guided Optimization (PGO) and may be used to auto-enable Link Time Optimization (LTO) on some platforms. Note that configuration including this option takes time to configure. If you want to learn more about these options, please see `Configure > Performance options `_ :: +If you are trying to improve the performance of Python, you will probably want +to use an optimized build of CPython. It can take a lot longer to build CPython +with optimizations enabled, and it's usually not necessary to do so. However, +it's essential if you want accurate benchmark results for a proposed performance +optimization. To get an optimized build of Python, +``configure --enable-optimizations --with-lto``. +This sets the default make targets up to enable Profile Guided Optimization(PGO) +and may be used to auto-enable Link Time Optimization (LTO) on some platforms. +If you want to learn more about these options, +please see :ref:`Configure options `. + +.. code:: console $ ./configure --enable-optimizations --with-lto From f94ba3c92e81380853d1a2c60c5fb3beeccbbec2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EA=B8=B8=EC=9E=AC=EC=9D=80?= Date: Sun, 13 Aug 2023 21:14:05 +0900 Subject: [PATCH 11/18] Update getting-started/setup-building.rst Co-authored-by: Alex Waygood --- getting-started/setup-building.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/getting-started/setup-building.rst b/getting-started/setup-building.rst index b8f8a4f0a..e9c0f0f0f 100644 --- a/getting-started/setup-building.rst +++ b/getting-started/setup-building.rst @@ -244,7 +244,9 @@ If you are trying to improve the performance of Python, you will probably want to use an optimized build of CPython. It can take a lot longer to build CPython with optimizations enabled, and it's usually not necessary to do so. However, it's essential if you want accurate benchmark results for a proposed performance -optimization. To get an optimized build of Python, +optimization. + +For an optimized build of Python, use ``configure --enable-optimizations --with-lto``. This sets the default make targets up to enable Profile Guided Optimization(PGO) and may be used to auto-enable Link Time Optimization (LTO) on some platforms. From 9a2086a5514cdc37e7b04656ce93ca8dee679a74 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EA=B8=B8=EC=9E=AC=EC=9D=80?= Date: Sun, 13 Aug 2023 21:14:13 +0900 Subject: [PATCH 12/18] Update getting-started/setup-building.rst Co-authored-by: Alex Waygood --- getting-started/setup-building.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/getting-started/setup-building.rst b/getting-started/setup-building.rst index e9c0f0f0f..c9cf53677 100644 --- a/getting-started/setup-building.rst +++ b/getting-started/setup-building.rst @@ -248,7 +248,7 @@ optimization. For an optimized build of Python, use ``configure --enable-optimizations --with-lto``. -This sets the default make targets up to enable Profile Guided Optimization(PGO) +This sets the default make targets up to enable Profile Guided Optimization (PGO) and may be used to auto-enable Link Time Optimization (LTO) on some platforms. If you want to learn more about these options, please see :ref:`Configure options `. From 264d324891b7e57cedb1b20852b28cbf5380217f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EA=B8=B8=EC=9E=AC=EC=9D=80?= Date: Sun, 13 Aug 2023 21:14:20 +0900 Subject: [PATCH 13/18] Update getting-started/setup-building.rst Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> --- getting-started/setup-building.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/getting-started/setup-building.rst b/getting-started/setup-building.rst index c9cf53677..968ca1990 100644 --- a/getting-started/setup-building.rst +++ b/getting-started/setup-building.rst @@ -250,8 +250,8 @@ For an optimized build of Python, use ``configure --enable-optimizations --with-lto``. This sets the default make targets up to enable Profile Guided Optimization (PGO) and may be used to auto-enable Link Time Optimization (LTO) on some platforms. -If you want to learn more about these options, -please see :ref:`Configure options `. +See :ref:`Configure options ` to learn more about +these options. .. code:: console From 56acb09c89f536cc05bfee1134e7322a8ccc2c76 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EA=B8=B8=EC=9E=AC=EC=9D=80?= Date: Sun, 13 Aug 2023 21:15:03 +0900 Subject: [PATCH 14/18] Update getting-started/setup-building.rst Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> --- getting-started/setup-building.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/getting-started/setup-building.rst b/getting-started/setup-building.rst index 968ca1990..6148db1a0 100644 --- a/getting-started/setup-building.rst +++ b/getting-started/setup-building.rst @@ -240,7 +240,7 @@ still build properly). Optimization '''''''''''' -If you are trying to improve the performance of Python, you will probably want +If you are trying to improve CPython's performance, you will probably want to use an optimized build of CPython. It can take a lot longer to build CPython with optimizations enabled, and it's usually not necessary to do so. However, it's essential if you want accurate benchmark results for a proposed performance From a0937148f58bb16bbd3b3f12bcf0559d7088260a Mon Sep 17 00:00:00 2001 From: Alex Waygood Date: Sun, 13 Aug 2023 13:19:02 +0100 Subject: [PATCH 15/18] fix the build --- getting-started/setup-building.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/getting-started/setup-building.rst b/getting-started/setup-building.rst index 6148db1a0..624c108db 100644 --- a/getting-started/setup-building.rst +++ b/getting-started/setup-building.rst @@ -250,7 +250,7 @@ For an optimized build of Python, use ``configure --enable-optimizations --with-lto``. This sets the default make targets up to enable Profile Guided Optimization (PGO) and may be used to auto-enable Link Time Optimization (LTO) on some platforms. -See :ref:`Configure options ` to learn more about +See :ref:`Configure options ` to learn more about these options. .. code:: console From 940eb06e2a2c6ce163e2045c00371787d76ef6fa Mon Sep 17 00:00:00 2001 From: "jaeeun.kil" Date: Sun, 13 Aug 2023 21:24:22 +0900 Subject: [PATCH 16/18] =?UTF-8?q?feat:=20=F0=9F=8E=B8=20add=20detail=20ref?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- getting-started/setup-building.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/getting-started/setup-building.rst b/getting-started/setup-building.rst index b8f8a4f0a..ed1a061dc 100644 --- a/getting-started/setup-building.rst +++ b/getting-started/setup-building.rst @@ -249,7 +249,7 @@ optimization. To get an optimized build of Python, This sets the default make targets up to enable Profile Guided Optimization(PGO) and may be used to auto-enable Link Time Optimization (LTO) on some platforms. If you want to learn more about these options, -please see :ref:`Configure options `. +please see :option:`python:--enable-optimizations`, :option:`python:--with-lto`. .. code:: console From 3a50cb712231fe0e996c8bc78daa6a2573104586 Mon Sep 17 00:00:00 2001 From: Alex Waygood Date: Sun, 13 Aug 2023 13:27:13 +0100 Subject: [PATCH 17/18] Delete file committed by accident --- .idea/workspace.xml | 53 --------------------------------------------- 1 file changed, 53 deletions(-) delete mode 100644 .idea/workspace.xml diff --git a/.idea/workspace.xml b/.idea/workspace.xml deleted file mode 100644 index ad92a9b61..000000000 --- a/.idea/workspace.xml +++ /dev/null @@ -1,53 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - 1691808874623 - - - - - - \ No newline at end of file From 2f9a652ac58f4d42ea67fde866466f5b80fa516f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EA=B8=B8=EC=9E=AC=EC=9D=80?= Date: Sun, 13 Aug 2023 21:45:43 +0900 Subject: [PATCH 18/18] Update getting-started/setup-building.rst Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> --- getting-started/setup-building.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/getting-started/setup-building.rst b/getting-started/setup-building.rst index ae3b306ba..e91ee07b8 100644 --- a/getting-started/setup-building.rst +++ b/getting-started/setup-building.rst @@ -250,8 +250,8 @@ For an optimized build of Python, use ``configure --enable-optimizations --with-lto``. This sets the default make targets up to enable Profile Guided Optimization (PGO) and may be used to auto-enable Link Time Optimization (LTO) on some platforms. -See :option:`python:--enable-optimizations`, :option:`python:--with-lto` to learn more about -these options. +See :option:`python:--enable-optimizations` and :option:`python:--with-lto` +to learn more about these options. .. code:: console