##############################################################################
# Copyright (c) 2013-2018, Lawrence Livermore National Security, LLC.
# Produced at the Lawrence Livermore National Laboratory.
#
# This file is part of Spack.
# Created by Todd Gamblin, tgamblin@llnl.gov, All rights reserved.
# LLNL-CODE-647188
#
# For details, see https://github.com/spack/spack
# Please also see the NOTICE and LICENSE files for our notice and the LGPL.
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU Lesser General Public License (as
# published by the Free Software Foundation) version 2.1, February 1999.
#
# This program is distributed in the hope that it will be useful, but
# WITHOUT ANY WARRANTY; without even the IMPLIED WARRANTY OF
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the terms and
# conditions of the GNU Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
##############################################################################
from spack import *


class Opengl(Package):
    """Placeholder for external OpenGL libraries from hardware vendors"""

    homepage = "https://www.opengl.org/"
    url      = "https://www.opengl.org/"

    version('3.2', 'N/A')

    provides('gl@:4.5', when='@4.5:')
    provides('gl@:4.4', when='@4.4:')
    provides('gl@:4.3', when='@4.3:')

    def install(self, spec, prefix):
        msg = """This package is intended to be a placeholder for
        system-provided OpenGL libraries from hardware vendors.  Please
        download and install OpenGL drivers/libraries for your graphics
        hardware separately, and then set that up as an external package.
        An example of a working packages.yaml:

        packages:
          opengl:
            paths:
              opengl@4.5.0: /opt/opengl
            buildable: False

        In that case, /opt/opengl/ should contain these two folders:

        include/GL/       (opengl headers, including "gl.h")
        lib               (opengl libraries, including "libGL.so")"""

        raise InstallError(msg)

@@ -1431,16 +1431,218 @@
 .org/%22%0A%0A
+    # A second argument (usually the hash) must be supplied to the%0A    # version directive, but 'n/a' is used here because this package%0A    # is a placeholder for a system/vendor installation of OpenGL%0A
     vers
@@ -1657,11 +1657,11 @@
 ', '
-N/A
+n/a
 ')%0A%0A
@@ -1778,43 +1778,347 @@
 :')%0A
-%0A    def install(self, spec, prefix
+    provides('gl@:4.2', when='@4.2:')%0A    provides('gl@:4.1', when='@4.1:')%0A    provides('gl@:3.3', when='@3.3:')%0A%0A    # Override the fetcher method to throw a useful error message;%0A    # fixes GitHub issue (#7061) in which this package threw a%0A    # generic, uninformative error during the %60fetch%60 step,%0A    @property%0A    def fetcher(self
 ):%0A 
@@ -2774,41 +2774,797 @@
 so%22)
-%22%22%22%0A%0A        raise InstallError(msg)
+%0A%0A        On Apple Darwin (e.g., OS X, macOS) systems, this package is%0A        normally installed as part of the XCode Command Line Tools in%0A        /usr/X11R6, so a working packages.yaml would be%0A%0A        packages:%0A          opengl:%0A            paths:%0A              opengl@4.1: /usr/X11R6%0A            buildable: False%0A%0A        In that case, /usr/X11R6 should contain%0A%0A        include/GL/      (OpenGL headers, including %22gl.h%22)%0A        lib              (OpenGL libraries, including %22libGL.dylib%22)%0A%0A        On OS X/macOS, note that the version of OpenGL provided%0A        depends on your hardware. Look at%0A        https://support.apple.com/en-us/HT202823 to see what version%0A        of OpenGL your Mac uses.%22%22%22%0A        raise InstallError(msg)%0A%0A    def install(self, spec, prefix):%0A        pass
 %0A

make error throw on install, not fetch (#7063)