Update documentation for {PYTHON,RUBY,PHP}_VERSION_REQD variables, move them

to "user variables" section.  pkglint is now aware of them.  Bump pkglint
version.  Oked by wiz@

3 files changed, 26 insertions, 13 deletions

diff --git a/lang/php/phpversion.mk b/lang/php/phpversion.mk
index 259e585667a..e30b93b3ff9 100644
--- a/lang/php/phpversion.mk
+++ b/lang/php/phpversion.mk
@@ -1,4 +1,4 @@
-# $NetBSD: phpversion.mk,v 1.22 2012/09/14 15:54:22 taca Exp $
+# $NetBSD: phpversion.mk,v 1.23 2012/09/16 20:03:50 cheusov Exp $
 #
 # This file selects a PHP version, based on the user's preferences and
 # the installed packages. It does not add a dependency on the PHP
@@ -13,6 +13,14 @@
 #	Possible: 53 54
 #	Default: 53
 #
+# PHP_VERSION_REQD
+#	PHP version to use. This is a user variable and
+#	should not be set in packages.
+#	Normally it is used by bulk build tools.
+#
+#	Possible: ${PHP_VERSIONS_ACCEPTED}
+#	Default:  ${PHP_VERSION_DEFAULT}
+#
 # === Package-settable variables ===
 #
 # PHP_VERSIONS_ACCEPTED
@@ -21,13 +29,6 @@
 #	Possible: 53 54
 #	Default: 53 54
 #
-# PHP_VERSION_REQD
-#	If the package works only with a specific PHP version, this
-#	variable can be used to force it.
-#
-#	Possible: (undefined) 53 54
-#	Default: (undefined)
-#
 # === Variables defined by this file ===
 #
 # PKG_PHP_VERSION
diff --git a/lang/python/pyversion.mk b/lang/python/pyversion.mk
index 61503cddc3f..dddfcae19d7 100644
--- a/lang/python/pyversion.mk
+++ b/lang/python/pyversion.mk
@@ -1,4 +1,4 @@
-# $NetBSD: pyversion.mk,v 1.100 2012/08/01 19:07:20 drochner Exp $
+# $NetBSD: pyversion.mk,v 1.101 2012/09/16 20:03:50 cheusov Exp $
 
 # This file determines which Python version is used as a dependency for
 # a package.
@@ -11,6 +11,14 @@
 #	Possible values: 25 26 27 31 32
 #	Default: 27
 #
+# PYTHON_VERSION_REQD
+#	Python version to use. This is a user variable and
+#	should not be set in packages.
+#	Normally it is used by bulk build tools.
+#
+#	Possible: ${PYTHON_VERSIONS_ACCEPTED}
+#	Default:  ${PYTHON_VERSION_DEFAULT}
+#
 # === Package-settable variables ===
 #
 # PYTHON_VERSIONS_ACCEPTED
diff --git a/lang/ruby/rubyversion.mk b/lang/ruby/rubyversion.mk
index fd5b7943db8..ec1d7769e86 100644
--- a/lang/ruby/rubyversion.mk
+++ b/lang/ruby/rubyversion.mk
@@ -1,4 +1,4 @@
-# $NetBSD: rubyversion.mk,v 1.87 2012/09/16 15:27:42 taca Exp $
+# $NetBSD: rubyversion.mk,v 1.88 2012/09/16 20:03:50 cheusov Exp $
 #
 
 # This file determines which Ruby version is used as a dependency for
@@ -27,6 +27,13 @@
 #		Possible values: Yes No
 #		Default: Yes
 #
+# RUBY_VERSION_REQD
+#	Ruby version to use. This is a user variable and
+#	should not be set in packages.
+#	Normally it is used by bulk build tools.
+#
+#		Possible values: ${RUBY_VERSION_SUPPORTED}
+#		Default:         ${RUBY_VERSION_DEFAULT}
 #
 # === Package-settable variables ===
 #
@@ -36,9 +43,6 @@
 #		Possible values: 18 193
 #		Default: 18 193
 #
-# RUBY_VERSION_REQD
-#	The Ruby versions force to build (for pbulk).
-#
 # RUBY_NOVERSION
 #	If "Yes", the package dosen't depend on any version of Ruby, such
 #	as editing mode for emacs.  In this case, package's name would begin