Issue #15661: Update OS X installer welcome and readme files for 3.4.2.
python.org OS X installers are now distributed as signed installer
packages compatible with the Gatekeeper security feature.
diff --git a/Mac/BuildScript/README.txt b/Mac/BuildScript/README.txt
index 3ced066..66d9935 100644
--- a/Mac/BuildScript/README.txt
+++ b/Mac/BuildScript/README.txt
@@ -1,14 +1,27 @@
Building a Python Mac OS X distribution
=======================================
-The ``build-install.py`` script creates Python distributions, including
+The ``build-installer.py`` script creates Python distributions, including
certain third-party libraries as necessary. It builds a complete
framework-based Python out-of-tree, installs it in a funny place with
$DESTROOT, massages that installation to remove .pyc files and such, creates
an Installer package from the installation plus other files in ``resources``
and ``scripts`` and placed that on a ``.dmg`` disk image.
-For Python 3.4.0, PSF practice is to build two installer variants
+This installers built by this script are legacy bundle installers that have
+been supported from the early days of OS X. In particular, they are supported
+on OS X 10.3.9, the earliest supported release for builds from this script.
+
+Beginning with Python 3.4.2, PSF practice is to build two installer variants
+using the newer flat package format, supported on 10.5+, and signed with the
+builder's Apple developer key, allowing downloaded packages to satisfy Apple's
+default Gatekeeper policy (e.g. starting with 10.8, Apple store downloads and
+Apple developer ID signed apps and installer packages). The process for
+transforming the output build artifacts into signed flat packages is not
+yet integrated into ``build-installer.py``. The steps prior to the flat
+package creation are the same as for 3.4.1 below.
+
+For Python 3.4.0 and 3.4.1, PSF practice was to build two installer variants
for each release.
1. 32-bit-only, i386 and PPC universal, capable on running on all machines