summaryrefslogtreecommitdiffstats
path: root/README.rst
diff options
context:
space:
mode:
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>2019-10-14 12:35:28 (GMT)
committerGitHub <noreply@github.com>2019-10-14 12:35:28 (GMT)
commit80f8532f0ff22d3473cb6cdb11d5f37ae357f493 (patch)
tree36cef8b705d9c720d15e2d6c6a500c804a473858 /README.rst
parent927f07c816aad9f8ed961d7ace6a367837f7fa8f (diff)
downloadcpython-80f8532f0ff22d3473cb6cdb11d5f37ae357f493.zip
cpython-80f8532f0ff22d3473cb6cdb11d5f37ae357f493.tar.gz
cpython-80f8532f0ff22d3473cb6cdb11d5f37ae357f493.tar.bz2
Update build docs for macOS (GH-16771)
(cherry picked from commit 19d6842c15c145f65178f806048ac1a8ae7d05f6) Co-authored-by: Ned Deily <nad@python.org>
Diffstat (limited to 'README.rst')
-rw-r--r--README.rst23
1 files changed, 12 insertions, 11 deletions
diff --git a/README.rst b/README.rst
index 4837636..74336a4 100644
--- a/README.rst
+++ b/README.rst
@@ -62,18 +62,20 @@ On Unix, Linux, BSD, macOS, and Cygwin::
This will install Python as ``python3``.
You can pass many options to the configure script; run ``./configure --help``
-to find out more. On macOS and Cygwin, the executable is called ``python.exe``;
-elsewhere it's just ``python``.
+to find out more. On macOS case-insensitive file systems and on Cygwin,
+the executable is called ``python.exe``; elsewhere it's just ``python``.
-If you are running on macOS with the latest updates installed, make sure to install
-OpenSSL or some other SSL software along with Homebrew or another package manager.
-If issues persist, see https://devguide.python.org/setup/#macos-and-os-x for more
-information.
+Building a complete Python installation requires the use of various
+additional third-party libraries, depending on your build platform and
+configure options. Not all standard library modules are buildable or
+useable on all platforms. Refer to the
+`Install dependencies <https://devguide.python.org/setup/#install-dependencies>`_
+section of the `Developer Guide`_ for current detailed information on
+dependencies for various Linux distributions and macOS.
-On macOS, if you have configured Python with ``--enable-framework``, you
-should use ``make frameworkinstall`` to do the installation. Note that this
-installs the Python executable in a place that is not normally on your PATH,
-you may want to set up a symlink in ``/usr/local/bin``.
+On macOS, there are additional configure and build options related
+to macOS framework and universal builds. Refer to `Mac/README.rst
+<https://github.com/python/cpython/blob/master/Mac/README.rst>`_.
On Windows, see `PCbuild/readme.txt
<https://github.com/python/cpython/blob/master/PCbuild/readme.txt>`_.
@@ -96,7 +98,6 @@ Profile Guided Optimization (PGO) and may be used to auto-enable Link Time
Optimization (LTO) on some platforms. For more details, see the sections
below.
-
Profile Guided Optimization
^^^^^^^^^^^^^^^^^^^^^^^^^^^