This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perlapi: Remove per-thread section; move to real scns
[perl5.git] / README.macosx
index 7cec377..e57bb1b 100644 (file)
@@ -10,9 +10,9 @@ perlmacosx - Perl under Mac OS X
 
 This document briefly describes Perl under Mac OS X.
 
 
 This document briefly describes Perl under Mac OS X.
 
-  curl -O http://www.cpan.org/src/perl-5.19.12.tar.gz
-  tar -xzf perl-5.19.12.tar.gz
-  cd perl-5.19.12
+  curl -O https://www.cpan.org/src/perl-5.33.5.tar.gz
+  tar -xzf perl-5.33.5.tar.gz
+  cd perl-5.33.5
   ./Configure -des -Dprefix=/usr/local/
   make
   make test
   ./Configure -des -Dprefix=/usr/local/
   make
   make test
@@ -20,7 +20,7 @@ This document briefly describes Perl under Mac OS X.
 
 =head1 DESCRIPTION
 
 
 =head1 DESCRIPTION
 
-The latest Perl release (5.19.12 as of this writing) builds without changes
+The latest Perl release (5.33.5 as of this writing) builds without changes
 under all versions of Mac OS X from 10.3 "Panther" onwards. 
 
 In order to build your own version of Perl you will need 'make',
 under all versions of Mac OS X from 10.3 "Panther" onwards. 
 
 In order to build your own version of Perl you will need 'make',
@@ -63,7 +63,7 @@ on a file server and used by many Macs.
 
 First, export the path to the SDK into the build environment:
 
 
 First, export the path to the SDK into the build environment:
 
   export SDK=/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.8.sdk
+ export SDK=/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.8.sdk
 
 Please make sure the SDK version (i.e. the numbers right before '.sdk')
 matches your system's (in this case, Mac OS X 10.8 "Mountain Lion"), as it is
 
 Please make sure the SDK version (i.e. the numbers right before '.sdk')
 matches your system's (in this case, Mac OS X 10.8 "Mountain Lion"), as it is
@@ -100,11 +100,12 @@ Mac OS X 10.5 "Leopard" and above do not require the 'u' variant.
 In addition to the compiler flags used to select the SDK, also add the flags
 for creating a universal binary:
 
 In addition to the compiler flags used to select the SDK, also add the flags
 for creating a universal binary:
 
-    ./Configure -Accflags="-arch i686 -arch ppc -nostdinc -B$SDK/usr/include/gcc \
-                           -B$SDK/usr/lib/gcc -isystem$SDK/usr/include \
-                           -F$SDK/System/Library/Frameworks" \
-                -Aldflags="-arch i686 -arch ppc -Wl,-syslibroot,$SDK" \
-                -de
+ ./Configure -Accflags="-arch i686 -arch ppc -nostdinc               \
+                         -B$SDK/usr/include/gcc                      \
+                        -B$SDK/usr/lib/gcc -isystem$SDK/usr/include  \
+                        -F$SDK/System/Library/Frameworks"            \
+             -Aldflags="-arch i686 -arch ppc -Wl,-syslibroot,$SDK"   \
+             -de
 
 Keep in mind that these compiler and linker settings will also be used when
 building CPAN modules. For XS modules to be compiled as a universal binary, any
 
 Keep in mind that these compiler and linker settings will also be used when
 building CPAN modules. For XS modules to be compiled as a universal binary, any
@@ -121,8 +122,8 @@ on G5-based hosts.
 
 Support for 64-bit addressing is experimental: some aspects of Perl may be
 omitted or buggy. Note the messages output by F<Configure> for further 
 
 Support for 64-bit addressing is experimental: some aspects of Perl may be
 omitted or buggy. Note the messages output by F<Configure> for further 
-information. Please use C<perlbug> to submit a problem report in the
-event that you encounter difficulties.
+information. Please use L<https://github.com/Perl/perl5/issues> to submit a
+problem report in the event that you encounter difficulties.
 
 When building 64-bit modules, it is your responsibility to ensure that linked
 external libraries and frameworks provide 64-bit support: if they do not,
 
 When building 64-bit modules, it is your responsibility to ensure that linked
 external libraries and frameworks provide 64-bit support: if they do not,
@@ -140,8 +141,8 @@ modules (C<Mac::*>), as the required Apple frameworks do not provide PPC64
 support. Similarly, downloads from Fink or Darwinports are unlikely to provide
 64-bit support; the libraries must be rebuilt from source with the appropriate
 compiler and linker flags. For further information, see Apple's
 support. Similarly, downloads from Fink or Darwinports are unlikely to provide
 64-bit support; the libraries must be rebuilt from source with the appropriate
 compiler and linker flags. For further information, see Apple's
-I<64-Bit Transition Guide> at 
-L<http://developer.apple.com/documentation/Darwin/Conceptual/64bitPorting/index.html>.
+I<64-Bit Transition Guide> at
+L<https://developer.apple.com/library/archive/documentation/Darwin/Conceptual/64bitPorting/transition/transition.html>.
 
 =head2 libperl and Prebinding
 
 
 =head2 libperl and Prebinding
 
@@ -222,7 +223,7 @@ access Foundation (i.e. non-GUI) classes and objects.
 An alternative is CamelBones, a framework that allows access to both
 Foundation and AppKit classes and objects, so that full GUI applications
 can be built in Perl. CamelBones can be found on SourceForge, at
 An alternative is CamelBones, a framework that allows access to both
 Foundation and AppKit classes and objects, so that full GUI applications
 can be built in Perl. CamelBones can be found on SourceForge, at
-L<http://www.sourceforge.net/projects/camelbones/>.
+L<https://www.sourceforge.net/projects/camelbones/>.
 
 
 =head1 Starting From Scratch
 
 
 =head1 Starting From Scratch
@@ -257,7 +258,7 @@ or rebuild Perl from the source code with C<Configure -Dprefix=/usr
 works much better with Perl 5.8.1 and later, in Perl 5.8.0 the
 settings were not quite right.
 
 works much better with Perl 5.8.1 and later, in Perl 5.8.0 the
 settings were not quite right.
 
-"Pacifist" from CharlesSoft (L<http://www.charlessoft.com/>) is a nice
+"Pacifist" from CharlesSoft (L<https://www.charlessoft.com/>) is a nice
 way to extract the Perl binaries from the OS media, without having to
 reinstall the entire OS.
 
 way to extract the Perl binaries from the OS media, without having to
 reinstall the entire OS.