Thanks for the comments!

>>>>> "Mark" == Mark J Nelson <Mark.J.Nelson at Sun.COM> writes:

Mark> devref.xml 329-334: Where it says "Download the installed image
Mark> (not the full product)," it would be nice to have an additional
Mark> note.  I know this isn't OpenSolaris instructions, but on those
Mark> systems, it's more dramatic--you can't simply "pkg install
Mark> sunstudio," even though it's there.  Something like "Because ON
Mark> only switches to a new compiler release after extensive testing,
Mark> you can't simply download and install the latest compiler release.
Mark> Instead, you should grab a tarbell of the tested, installed
Mark> image."  This warning is technically already present at line 964,
Mark> but we're repeating (perhaps) too much info here?  

I think it's worth repeating the warning here, so I'll do that.

Mark> And at 964, should the text be augmented to include the "can't
Mark> just pkg install sunstudio" bit for OpenSolaris?

Yes; will add.

Mark> 734: Does this call for a link to Liane's page at
Mark> http://opensolaris.org/os/project/indiana/building_on/ ?

I'll add links to the sections for installing those particular
distributions (1.3.2.1 for OpenSolaris, 1.3.2.2 for Solaris Express).

Mark> 775-777: OpenSolaris is kind of mentioned multiple times, and I'm
Mark> not sure that Solaris 10 should be listed here.  If so, don't we
Mark> also need a caveat that you should use a build that is "close to"
Mark> (formally, within two builds of?) the code you're building?

The DevRef distinguishes the development environment from the build
environment. 

        The simplest set of requirements applies to a development
        environment: you need only have sufficient space to store the
        source tree and enough CPU and memory to run text editors and
        tools such as cscope.

In that context, I think it's reasonable to continue mentioning S10, and
I think it's friendlier for newcomers.

I'll make changes to Section 1.3.2 (Installing a Binary Distribution)
and Section 2.1.2 (Build Environment) to reflect the "recent build"
requirement.

mike

Reply via email to