Extend and clarify the documentation for USE_GCC, making it explicit

that the form requesting a minimum version is preferred over the one
requesting just one version (as I had enhanced portlint to advise a
while ago).

1 files changed, 5 insertions, 5 deletions

diff --git a/Mk/bsd.gcc.mk b/Mk/bsd.gcc.mk
index cad2ef6d80ed..0dd2f4788e6f 100644
--- a/Mk/bsd.gcc.mk
+++ b/Mk/bsd.gcc.mk
@@ -6,11 +6,11 @@
 # Created by: Edwin Groothuis <edwin@freebsd.org>
 #
 # For port developers:
-# If your port needs a specific version of GCC, you can easily specify
-# that with the "USE_GCC=" statement. If you need a certain minimal version,
-# but don't care if about the upperversion, just the + sign behind
-# the version.  Note that the Fortran compiler is specified with the
-# USE_FORTRAN knob.
+# If your port needs a specific (minimum) version of GCC, you can easily
+# specify that with a "USE_GCC=" statement.  Unless absolutely necessary
+# do so by specifying "USE_GCC=X.Y+" which requests at least GCC version
+# X.Y.  To request a specific version omit the trailing + sign.  Use of
+# a Fortran compiler is declared by the USE_FORTRAN knob, not USE_GCC.
 #
 # As of 2010-06-06, USE_GCC=4.3 is deprecated and USE_GCC=4.3+ is
 # transparently rewritten to USE_GCC=4.4+.