--- a/components/libgsl/Makefile	Wed Feb 17 12:42:41 2016 -0800
+++ b/components/libgsl/Makefile	Tue Feb 23 09:35:42 2016 -0800
@@ -18,7 +18,7 @@
 #
 # CDDL HEADER END
 #
-# Copyright (c) 2015, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2015, 2016, Oracle and/or its affiliates. All rights reserved.
 #
 
 include ../../make-rules/shared-macros.mk
@@ -47,6 +47,19 @@
 include $(WS_MAKE_RULES)/configure.mk
 include $(WS_MAKE_RULES)/ips.mk
 
+# NOTE:
+# The libgsl package on Solaris is getting GSL CBLAS routines from
+# libsunperf.so. Programs wishing to use this functionality should use the
+# /usr/include/sunperf.h header file for the associated definitions and
+# function prototypes and link against -lsunperf.
+#
+# To retain compatibility with libgsl on other platforms, and to require
+# no changes to FOSS software being ported to Solaris, the libgsl package
+# manifest will also include the /usr/include/gsl/gsl_cblas.h header file
+# and provide links from /usr/lib/libgslcblas.so and
+# /usr/lib/$(MACH64)/libgslcblas.so to their equivalent libsunperf.so
+# library files.
+
 # By default, tests in each GSL sub-directory are linked statically against
 # a set of .la files. We don't deliver those in the GSL package, so we
 # adjust all the tests to link against the dynamic GSL library instead.