From b7f7dd50b929a29399e36e7e21101408a0720d0b Mon Sep 17 00:00:00 2001 From: CoderSilicon <149225177+CoderSilicon@users.noreply.github.com> Date: Sat, 13 Jun 2026 23:53:40 +0530 Subject: [PATCH 1/2] Enhance README formatting and content clarity Updated formatting and added emphasis to copyright and license information. Improved clarity in several sections. --- README.rst | 38 ++++++++++++++++++++++++++------------ 1 file changed, 26 insertions(+), 12 deletions(-) diff --git a/README.rst b/README.rst index 48f86cdb86ed1d2..780aa824fb43ac4 100644 --- a/README.rst +++ b/README.rst @@ -1,24 +1,31 @@ +.. image:: https://www.python.org/static/community_logos/python-logo-master-v3-TM.png + :align: center + :alt: Python Logo + :width: 400px + This is Python version 3.16.0 alpha 0 ===================================== .. image:: https://github.com/python/cpython/actions/workflows/build.yml/badge.svg?branch=main&event=push :alt: CPython build status on GitHub Actions :target: https://github.com/python/cpython/actions - .. image:: https://dev.azure.com/python/cpython/_apis/build/status/Azure%20Pipelines%20CI?branchName=main :alt: CPython build status on Azure DevOps :target: https://dev.azure.com/python/cpython/_build/latest?definitionId=4&branchName=main - .. image:: https://img.shields.io/badge/discourse-join_chat-brightgreen.svg :alt: Python Discourse chat :target: https://discuss.python.org/ -Copyright © 2001 Python Software Foundation. All rights reserved. +**Copyright © 2001 Python Software Foundation. All rights reserved.** -See the end of this file for further copyright and license information. +*See the end of this file for further copyright and license information.* -.. contents:: +.. contents:: **Table of Contents** + :local: + :depth: 2 + +---- General Information ------------------- @@ -45,10 +52,14 @@ Installable Python kits, and information about using Python, are available at .. _python.org: https://www.python.org/ +---- + Build Instructions ------------------ -On Unix, Linux, BSD, macOS, and Cygwin:: +On Unix, Linux, BSD, macOS, and Cygwin: + +.. code-block:: shell ./configure make @@ -80,7 +91,9 @@ To build Windows installer, see `Tools/msi/README.txt `_. If you wish, you can create a subdirectory and invoke configure from there. -For example:: +For example: + +.. code-block:: shell mkdir debug cd debug @@ -122,7 +135,6 @@ The final step is to build the actual interpreter, using the information collected from the instrumented one. The end result will be a Python binary that is optimized; suitable for distribution or production installation. - Link Time Optimization ^^^^^^^^^^^^^^^^^^^^^^ @@ -131,6 +143,7 @@ ability of recent compiler toolchains to optimize across the otherwise arbitrary ``.o`` file boundary when building final executables or shared libraries for additional performance gains. +---- What's New ---------- @@ -145,7 +158,6 @@ accounting of changes can only be gleaned from the `commit history If you want to install multiple versions of Python, see the section below entitled "Installing multiple versions". - Documentation ------------- @@ -160,6 +172,7 @@ formatting requirements. For information about building Python's documentation, refer to `Doc/README.rst `_. +---- Testing ------- @@ -174,7 +187,9 @@ By default, tests are prevented from overusing resources like disk space and memory. To enable these tests, run ``make buildbottest``. If any tests fail, you can re-run the failing test(s) in verbose mode. For -example, if ``test_os`` and ``test_gdb`` failed, you can run:: +example, if ``test_os`` and ``test_gdb`` failed, you can run: + +.. code-block:: shell make test TESTOPTS="-v test_os test_gdb" @@ -204,17 +219,16 @@ For example, if you want to install Python 2.7, 3.6, and 3.15 with 3.15 being th primary version, you would execute ``make install`` in your 3.15 build directory and ``make altinstall`` in the others. - Release Schedule ---------------- See `PEP 826 `__ for Python 3.16 release details. +---- Copyright and License Information --------------------------------- - Copyright © 2001 Python Software Foundation. All rights reserved. Copyright © 2000 BeOpen.com. All rights reserved. From e2c3babc6d4fc3153ebf029635c5e93ca260833e Mon Sep 17 00:00:00 2001 From: CoderSilicon <149225177+CoderSilicon@users.noreply.github.com> Date: Sun, 14 Jun 2026 00:10:55 +0530 Subject: [PATCH 2/2] Fix formatting of Table of Contents in README --- README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.rst b/README.rst index 780aa824fb43ac4..a473962974cdc00 100644 --- a/README.rst +++ b/README.rst @@ -21,7 +21,7 @@ This is Python version 3.16.0 alpha 0 *See the end of this file for further copyright and license information.* -.. contents:: **Table of Contents** +.. contents:: Table of Contents :local: :depth: 2