CVS commit: pkgsrc/mk

["Greg Troxel" <gdt%netbsd.org@localhost>]

Module Name:    pkgsrc
Committed By:   gdt
Date:           Tue Jul  4 14:35:55 UTC 2017

Modified Files:
        pkgsrc/mk: compiler.mk

Log Message:
Improve USE_LANGUAGES explanation

Reference the notion of making compilers visible to the build
environment.  Mention setting --std flags.  Note that the text is
currently aspirtational relative to gcc and C++.

(Comment change only.)


To generate a diff of this commit:
cvs rdiff -u -r1.86 -r1.87 pkgsrc/mk/compiler.mk

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: pkgsrc/mk/compiler.mk
diff -u pkgsrc/mk/compiler.mk:1.86 pkgsrc/mk/compiler.mk:1.87
--- pkgsrc/mk/compiler.mk:1.86  Sat Jun 10 11:32:32 2017
+++ pkgsrc/mk/compiler.mk       Tue Jul  4 14:35:55 2017
@@ -1,4 +1,4 @@
-# $NetBSD: compiler.mk,v 1.86 2017/06/10 11:32:32 kamil Exp $
+# $NetBSD: compiler.mk,v 1.87 2017/07/04 14:35:55 gdt Exp $
 #
 # This Makefile fragment implements handling for supported C/C++/Fortran
 # compilers.
@@ -40,12 +40,18 @@
 # The following variables may be set by a package:
 #
 # USE_LANGUAGES
-#      Lists the languages used in the source code of the package,
-#      and is used to determine the correct compilers to install.
+
+#      Declares the languages used in the source code of the package.
+#      This is used to determine the correct compilers to make
+#      visible to the build environment, installing them if
+#      necessary.  Flags such as --std=c++99 are also added.
 #      Valid values are: c, c99, c++, c++0x, gnu++0x, c++11, gnu++11,
 #      c++14, gnu++14, fortran, fortran77, java, objc, obj-c++, and
 #      ada.  The default is "c".
 #
+#       The above is partly aspirational.  As an example c++11 does
+#       not force a new enough version of gcc.
+
 # The following variables are defined, and available for testing in
 # package Makefiles:
 #