Tue Apr 5 06:44:21 2022 UTC ()
README.Solaris: be better at prioritizing information, don't
talk about "Sun gcc" any more, NetBSD capitalization police


(nia)
diff -r1.20 -r1.21 pkgsrc/bootstrap/README.Solaris

cvs diff -r1.20 -r1.21 pkgsrc/bootstrap/README.Solaris (expand / switch to unified diff)

--- pkgsrc/bootstrap/README.Solaris 2022/04/04 12:55:03 1.20
+++ pkgsrc/bootstrap/README.Solaris 2022/04/05 06:44:21 1.21
@@ -1,34 +1,32 @@ @@ -1,34 +1,32 @@
1$NetBSD: README.Solaris,v 1.20 2022/04/04 12:55:03 gdt Exp $ 1$NetBSD: README.Solaris,v 1.21 2022/04/05 06:44:21 nia Exp $
2 2
3This README describes pkgsrc on a variety of Solaris-derived operating 3This README describes pkgsrc on a variety of Solaris-derived operating
4systems. It corresponds to pkgsrc/platform/SunOS.mk. The relevant 4systems. It corresponds to pkgsrc/platform/SunOS.mk. The relevant
5operating systems are: 5operating systems are:
6 - Solaris (from Sun/Oracle, also Sun Solaris, Oracle Solaris) 
7 - OpenSolaris (from Sun) 
8 - illumos (open-source fork, OpenIndiana, OmniOS, SmartOS, and others) 6 - illumos (open-source fork, OpenIndiana, OmniOS, SmartOS, and others)
 7 - Solaris (from Sun/Oracle, also Sun Solaris, Oracle Solaris)
 8 - OpenSolaris (from Sun; superseded long ago by illumos)
9 9
10OpenSolaris has not been maintained for a very long time, so the only 10As of 2022, the primary platforms of interest where pkgsrc is known to
11platforms of interest are Oracle Solaris and illumos distributions. 11work well are illumos distributions, Solaris 10, and Solaris 11.
12As of 2022, pkgsrc is believed to work well on Oracle Solaris and 12pkgsrc is not currently known to work on SunOS 4 or OpenSolaris.
13illumos. pkgsrc is not currently known to work on SunOS 4 or 
14OpenSolaris. 
15 13
16Prerequisites 14Prerequisites
17------------- 15-------------
18 16
19You will need a working C compiler. The two known options are gcc and 17You will need a working C compiler. The two known options are gcc and
20Sun/Solaris Studio. gcc can come from Sun, or other places. On some 18Sun/Solaris Studio. gcc can come from the OS vendor, or other places.
21systems, there is only one feasible choice. 19On some systems, there is only one feasible choice.
22 20
23As with pkgsrc on other platforms, one should use the same compiler 21As with pkgsrc on other platforms, one should use the same compiler
24family and ideally the same compiler version for building all packages. 22family and ideally the same compiler version for building all packages.
25 23
26At some time in the past, GNU binutils was not usable on some systems, 24At some time in the past, GNU binutils was not usable on some systems,
27but the status is unclear in 2022. 25but the status is unclear in 2022.
28 26
29The following packages are the minimum required on Solaris 8 to 27The following packages are the minimum required on Solaris 8 to
30bootstrap and build packages. 28bootstrap and build packages.
31 29
32 - SUNWsprot 30 - SUNWsprot
33 - SUNWarc 31 - SUNWarc
34 - SUNWbtool 32 - SUNWbtool
@@ -68,27 +66,27 @@ General @@ -68,27 +66,27 @@ General
68To build 64-bit binaries, pass '--abi=64' to bootstrap, and also see 66To build 64-bit binaries, pass '--abi=64' to bootstrap, and also see
69the crle(1) man page to configure the runtime linking environment. 67the crle(1) man page to configure the runtime linking environment.
70(It is not clear if this is the default on sparc64/amd64, and if not, 68(It is not clear if this is the default on sparc64/amd64, and if not,
71why not.) 69why not.)
72 70
73Generally, illumos-based distributions come with gcc, and gcc is the 71Generally, illumos-based distributions come with gcc, and gcc is the
74standard approach. As of 2022, there are no recent reports of using 72standard approach. As of 2022, there are no recent reports of using
75Sun/Oracle toolchains on illumos. 73Sun/Oracle toolchains on illumos.
76 74
77 75
78If you are using gcc 76If you are using gcc
79-------------------- 77--------------------
80 78
81See https://wiki.netbsd.org/pkgsrc/solarish/ for information about 79See https://wiki.NetBSD.org/pkgsrc/solarish/ for information about
82installing gcc on various illumos distributions. One can use a 80installing gcc on various illumos distributions. One can use a
83distribution-provided gcc, or a gcc that has been built from sources. 81distribution-provided gcc, or a gcc that has been built from sources.
84 82
85If the gcc installation is not in your $PATH you will need to pass 83If the gcc installation is not in your $PATH you will need to pass
86additional flags to bootstrap, for example: 84additional flags to bootstrap, for example:
87 85
88 env CC=/opt/gcc-4.6.3/bin/gcc \ 86 env CC=/opt/gcc-4.6.3/bin/gcc \
89 GCCBASE=/opt/gcc-4.6.3 \ 87 GCCBASE=/opt/gcc-4.6.3 \
90 ./bootstrap --abi=64 88 ./bootstrap --abi=64
91 89
92It is recommended that an external gcc be used only for bootstrapping, 90It is recommended that an external gcc be used only for bootstrapping,
93and that you set USE_PKGSRC_GCC=yes in mk.conf so that the appropriate 91and that you set USE_PKGSRC_GCC=yes in mk.conf so that the appropriate
94pkgsrc gcc is installed and used. 92pkgsrc gcc is installed and used.