Skip to content

bpo-41203: Replace OS X with macOS #21316

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 10 commits into from
Closed

bpo-41203: Replace OS X with macOS #21316

wants to merge 10 commits into from

Conversation

pxeger
Copy link
Contributor

@pxeger pxeger commented Jul 4, 2020

I've made separate commits for changes in old whatsnew files because maybe they should be kept as is, for historical reasons?

Also I've committed changes from "Macintosh" to "Mac".

All of these changes were made with sed so I can't guarantee there are no false-positives, although I tried...

https://bugs.python.org/issue41203

@the-knights-who-say-ni
Copy link

Hello, and thanks for your contribution!

I'm a bot set up to make sure that the project can legally accept this contribution by verifying everyone involved has signed the PSF contributor agreement (CLA).

CLA Missing

Our records indicate the following people have not signed the CLA:

@pxeger

For legal reasons we need all the people listed to sign the CLA before we can look at your contribution. Please follow the steps outlined in the CPython devguide to rectify this issue.

If you have recently signed the CLA, please wait at least one business day
before our records are updated.

You can check yourself to see if the CLA has been received.

Thanks again for the contribution, we look forward to reviewing it!

Copy link
Contributor

@ronaldoussoren ronaldoussoren left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm generally in favour of this change, with some reservations:

  1. I'd like to keep using "Macintosh" to refer to Mac systems before Darwin (Mac OS 9 and earlier)

  2. There are changes to the various NEWS file, I'm not sure if this is a good idea. As far as I know we usually don't edit these.

There's also a number of incorrect changes (see detailed comments).

I haven't reviewed the change to the PDF file.

@@ -675,7 +675,7 @@ information is sometimes used to indicate sub-releases. These are
'Intended Audience :: Developers',
'Intended Audience :: System Administrators',
'License :: OSI Approved :: Python Software Foundation License',
'Operating System :: MacOS :: MacOS X',
'Operating System :: MacOS :: MacmacOS',
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This one is incorrect for two reasons:

  1. Spelling error in the new text
  2. This value is a PyPI classifier, and those still use "MacOS X"

Please revert this change until "macOS" is added as an alternatieve to the PyPI classifiers.

Doc/glossary.rst Outdated
@@ -1118,7 +1118,7 @@ Glossary
universal newlines
A manner of interpreting text streams in which all of the following are
recognized as ending a line: the Unix end-of-line convention ``'\n'``,
the Windows convention ``'\r\n'``, and the old Macintosh convention
the Windows convention ``'\r\n'``, and the old Mac convention
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd prefer to keep Macintosh here. This is referring to MacOS 9 and earlier, when Macintosh was commonly used to describe the system.

@@ -211,7 +211,7 @@ The :mod:`binascii` module defines the following functions:
and 85.

Module :mod:`binhex`
Support for the binhex format used on the Macintosh.
Support for the binhex format used on the Mac.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same here, I'd prefer to keep Macintosh.

If you code or decode textfiles on non-Macintosh platforms they will still use
the old Macintosh newline convention (carriage-return as end of line).
If you code or decode textfiles on non-Mac platforms they will still use
the old Mac newline convention (carriage-return as end of line).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Likewise (for both lines).

@@ -1201,7 +1201,7 @@ particular, the following variants typically exist:
| mac_latin2 | maclatin2, maccentraleurope, | Central and Eastern Europe |
| | mac_centeuro | |
+-----------------+--------------------------------+--------------------------------+
| mac_roman | macroman, macintosh | Western Europe |
| mac_roman | macroman, Mac | Western Europe |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"macintosh" is the name of an encoding, don't change.

@@ -50,7 +50,7 @@ A physical line is a sequence of characters terminated by an end-of-line
sequence. In source files and strings, any of the standard platform line
termination sequences can be used - the Unix form using ASCII LF (linefeed),
the Windows form using the ASCII sequence CR LF (return followed by linefeed),
or the old Macintosh form using the ASCII CR (return) character. All of these
or the old Mac form using the ASCII CR (return) character. All of these
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd prefer to keep the name "Macintosh" here as well.

@@ -574,7 +574,7 @@ mostly by Trent Mick of ActiveState. (Confusingly, ``sys.platform`` is still
treats code as 32 bit on Itanium.) PythonWin also supports Windows CE; see the
Python CE page at http://pythonce.sourceforge.net/ for more information.

Another new platform is Darwin/MacOS X; initial support for it is in Python 2.0.
Another new platform is Darwin/MacmacOS; initial support for it is in Python 2.0.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo, this should be "macOS" instead of "MacmacOS".

@@ -773,7 +773,7 @@ the 'patches' and 'python-dev' lists at python.org.

Recent versions of the GUSI development environment for MacOS support POSIX
threads. Therefore, Python's POSIX threading support now works on the
Macintosh. Threading support using the user-space GNU ``pth`` library was also
Mac. Threading support using the user-space GNU ``pth`` library was also
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Don't change.

@@ -774,7 +774,7 @@ of the more notable changes are:
* The size of the Unicode character database was shrunk by another 340K thanks
to Fredrik Lundh.

* Some new ports were contributed: MacOS X (by Steven Majewski), Cygwin (by
* Some new ports were contributed: MacmacOS (by Steven Majewski), Cygwin (by
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo.

@@ -1137,12 +1137,12 @@ bugs. These figures are likely to be underestimates.
Some of the more notable changes are:

* The code for the MacOS port for Python, maintained by Jack Jansen, is now kept
in the main Python CVS tree, and many changes have been made to support MacOS X.
in the main Python CVS tree, and many changes have been made to support MacmacOS.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo.

@bedevere-bot
Copy link

A Python core developer has requested some changes be made to your pull request before we can consider merging it. If you could please address their requests along with any other requests in other reviews from core developers that would be appreciated.

Once you have made the requested changes, please leave a comment on this pull request containing the phrase I have made the requested changes; please review again. I will then notify any core developers who have left a review that you're ready for them to take another look at this pull request.

@pxeger
Copy link
Contributor Author

pxeger commented Jul 4, 2020

RE changes to the NEWS files, I totally agree (especially the older ones) - it looks a bit anachronistic to have macOS references in the same breath as talking about Mac OS 9 and Macintosh. That's why I did them in separate commits, so it would be easier to cherrypick/rebase/whatever if they weren't wanted. Should I completely reset them?

@pxeger
Copy link
Contributor Author

pxeger commented Jul 4, 2020

I have made the requested changes; please review again

@bedevere-bot
Copy link

Thanks for making the requested changes!

@ronaldoussoren: please review the changes made to this pull request.

Copy link
Member

@serhiy-storchaka serhiy-storchaka left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do not use anachronical macOS for versions which predated the name macOS.

@@ -11,7 +11,7 @@
--------------

This module encodes and decodes files in binhex4 format, a format allowing
representation of Macintosh files in ASCII. Only the data fork is handled.
representation of Mac files in ASCII. Only the data fork is handled.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same as above.

@@ -1420,7 +1420,7 @@ correct library and dependencies are loaded.
.. data:: DEFAULT_MODE
:noindex:

The default mode which is used to load shared libraries. On OSX 10.3, this is
The default mode which is used to load shared libraries. On macOS 10.3, this is
Copy link
Member

@serhiy-storchaka serhiy-storchaka Jul 4, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It was Mac OS X for versions up to 10.7 inclusively.

@@ -301,7 +301,7 @@ process and user.

.. note::

On Mac OS X, :func:`getgroups` behavior differs somewhat from
On macOS, :func:`getgroups` behavior differs somewhat from
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have doubts about this one. If the note refers to 10.5 and earlier, it should be Mac OS X.

@@ -486,7 +486,7 @@ process and user.

.. availability:: Unix.

.. note:: On Mac OS X, the length of *groups* may not exceed the
.. note:: On macOS, the length of *groups* may not exceed the
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same as above.

@@ -26,7 +26,7 @@ copying and removal. For operations on individual files, see also the
:func:`shutil.copy2`) cannot copy all file metadata.

On POSIX platforms, this means that file owner and group are lost as well
as ACLs. On Mac OS, the resource fork and other metadata are not used.
as ACLs. On macOS, the resource fork and other metadata are not used.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is it relevant to modern macOS or only to classic MacOS?

@@ -17,7 +17,7 @@ the IDE and the Package Manager that are worth pointing out.
Getting and Installing MacPython
================================

Mac OS X 10.8 comes with Python 2.7 pre-installed by Apple. If you wish, you
macOS 10.8 comes with Python 2.7 pre-installed by Apple. If you wish, you
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It was Mac OS X.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Current versions of macOS still have Python 2.7 I believe

@@ -148,10 +148,10 @@ X by Apple, and the latest version can be downloaded and installed from
https://www.activestate.com; it can also be built from source.

*wxPython* is another popular cross-platform GUI toolkit that runs natively on
Mac OS X. Packages and documentation are available from https://www.wxpython.org.
macOS. Packages and documentation are available from https://www.wxpython.org.

*PyQt* is another popular cross-platform GUI toolkit that runs natively on Mac
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fix Mac macOS.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

??

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Mac macOS" -> "macOS"


The most significant change is the ability to build Python as a framework,
enabled by supplying the :option:`!--enable-framework` option to the configure
script when compiling Python. According to Jack Jansen, "This installs a
self-contained Python installation plus the OS X framework "glue" into
self-contained Python installation plus the macOS framework "glue" into
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do not change a cite.

left commented out in :file:`setup.py`. People who want to experiment with
these modules can uncomment them manually.

.. Jack's original comments:
The main change is the possibility to build Python as a
framework. This installs a self-contained Python installation plus the
OSX framework "glue" into /Library/Frameworks/Python.framework (or
macOS framework "glue" into /Library/Frameworks/Python.framework (or
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same as above.

@@ -375,7 +375,7 @@ PEP 278: Universal Newline Support
==================================

The three major operating systems used today are Microsoft Windows, Apple's
Macintosh OS, and the various Unix derivatives. A minor irritation of
Mac OS, and the various Unix derivatives. A minor irritation of
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do not change.

Copy link
Member

@serhiy-storchaka serhiy-storchaka left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are incorrect changes. My comments have not yet been addressed.

@bedevere-bot
Copy link

A Python core developer has requested some changes be made to your pull request before we can consider merging it. If you could please address their requests along with any other requests in other reviews from core developers that would be appreciated.

Once you have made the requested changes, please leave a comment on this pull request containing the phrase I have made the requested changes; please review again. I will then notify any core developers who have left a review that you're ready for them to take another look at this pull request.

And if you don't make the requested changes, you will be put in the comfy chair!

@pxeger
Copy link
Contributor Author

pxeger commented Jul 20, 2020

I have made the requested changes; please review again

@bedevere-bot
Copy link

Thanks for making the requested changes!

@ronaldoussoren, @serhiy-storchaka: please review the changes made to this pull request.

@tiran tiran removed their request for review April 18, 2021 09:17
@vstinner vstinner closed this May 3, 2021
@vstinner vstinner deleted the branch python:master May 3, 2021 21:29
@@ -232,13 +232,13 @@ Windows Platform
.. versionadded:: 3.8


Mac OS Platform
macOS Platform
---------------
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The length of the underlying line should be corrected.

@@ -32,7 +32,7 @@ It starts by constructing up to four directories from a head and a tail part.
For the head part, it uses ``sys.prefix`` and ``sys.exec_prefix``; empty heads
are skipped. For the tail part, it uses the empty string and then
:file:`lib/site-packages` (on Windows) or
:file:`lib/python{X.Y}/site-packages` (on Unix and Macintosh). For each
:file:`lib/python{X.Y}/site-packages` (on Unix and Mac). For each
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

macOS

@@ -187,7 +187,7 @@ Module contents

Path to the base directory for the user site-packages. Can be ``None`` if
:func:`getuserbase` hasn't been called yet. Default value is
:file:`~/.local` for UNIX and Mac OS X non-framework builds,
:file:`~/.local` for UNIX and macOS non-framework builds,
:file:`~/Library/Python/{X.Y}` for Mac framework builds, and
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

macOS?

@@ -164,8 +164,8 @@ The :mod:`urllib.request` module defines the following functions:
This helper function returns a dictionary of scheme to proxy server URL
mappings. It scans the environment for variables named ``<scheme>_proxy``,
in a case insensitive approach, for all operating systems first, and when it
cannot find it, looks for proxy information from Mac OSX System
Configuration for Mac OS X and Windows Systems Registry for Windows.
cannot find it, looks for proxy information from macOS System
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

On Apple's site it is called just "System Configuration".

Internet Settings section, and in a Mac OS X environment proxy information
is retrieved from the OS X System Configuration Framework.
Internet Settings section, and in a macOS environment proxy information
is retrieved from the macOS System Configuration Framework.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it is just "the System Configuration framework".

@@ -2,13 +2,13 @@
.. _using-on-mac:

***************************
Using Python on a Macintosh
Using Python on a Mac
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The number of *s should match the length of the title.

@@ -2,13 +2,13 @@
.. _using-on-mac:

***************************
Using Python on a Macintosh
Using Python on a Mac
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

According to Wikipedia "Mac" is a correct name for modern Apple's computers.

@@ -148,10 +148,10 @@ X by Apple, and the latest version can be downloaded and installed from
https://www.activestate.com; it can also be built from source.

*wxPython* is another popular cross-platform GUI toolkit that runs natively on
Mac OS X. Packages and documentation are available from https://www.wxpython.org.
macOS. Packages and documentation are available from https://www.wxpython.org.

*PyQt* is another popular cross-platform GUI toolkit that runs natively on Mac
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Mac macOS" -> "macOS"

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

7 participants