PERFORCE change 124950 for review

[Gabor Kovesdan]

http://perforce.freebsd.org/chv.cgi?CH=124950

Change 124950 by gabor at gabor_server on 2007/08/09 14:06:28

	- Rework header documentation.  Only leave the "interface knobs" in
	  bsd.port.mk, which imply the inclusion of bsd.perl.mk, move the
	  other ones into bsd.perl.mk.
	- Add some examples about the use of USE_PERL5 and USE_PERL5_REASON

Affected files ...

.. //depot/projects/soc2007/gabor_perlmk/Mk/bsd.perl.mk#13 edit
.. //depot/projects/soc2007/gabor_perlmk/Mk/bsd.port.mk#7 edit

Differences ...

==== //depot/projects/soc2007/gabor_perlmk/Mk/bsd.perl.mk#13 (text+ko) ====

@@ -8,6 +8,53 @@
 # Please send all suggested changes to the maintainer instead of committing
 # them to CVS yourself.
 #
+#
+# PERL5			- Set to full path of perl5, either in the system or
+#				installed from a port.
+# PERL			- Set to full path of perl5, either in the system or
+#				installed from a port, but without the version number.
+#				Use this if you need to replace "#!" lines in scripts.
+# PERL_VERSION		- Full version of perl5 (see below for current value).
+# PERL_VER		- Short version of perl5 (see below for current value).
+# PERL_LEVEL		- Perl version as an integer of the form MNNNPP, where
+#				M is major version, N is minor version, and P is
+#				the patch level. E.g., PERL_VERSION=5.6.1 would give
+#				a PERL_LEVEL of 500601. This can be used in comparisons
+#				to determine if the version of perl is high enough,
+#				whether a particular dependency is needed, etc.
+# PERL_ARCH		- Directory name of architecture dependent libraries
+#				(value: ${ARCH}-freebsd).
+# PERL_PORT		- Name of the perl port that is installed
+#				(value: perl5)
+# SITE_PERL		- Directory name where site specific perl packages go.
+#				This value is added to PLIST_SUB.
+# USE_PERL5		- If your port needs a specific version of Perl, you
+#				can easily specify that with this knob.  If
+#				you need a certain minimal version, but don't
+#				care if about the upperversion, just put the
+#				+ sign behind the version.  If you want to
+#				specify a latest version your port can be used
+#				with, suffix the version number with a - sign.
+#				Exact version can also be specified if you just
+#				set USE_PERL5 to the desired version.  If you
+#				just set USE_PERL5 to "yes", Perl will be
+#				pulled in as a dependency but no version check
+#				is done.
+#
+# USE_PERL5_REASON	- Along with USE_PERL5, you can set a specific reason,
+#				why a given version is required.
+#
+# Examples:
+# 	USE_PERL5=	yes	# port requires any version of Perl5 to build.
+# 	USE_PERL5=	5.6.0+	# port requires at least Perl 5.6.0 to build.
+#	USE_PERL5=	5.8.2	# port is only usable with Perl 5.8.2.
+#	USE_PERL5=	5.8.6-	# port is only usbale with Perl 5.8.6 or prior.
+#
+# This line along with a properly set USE_PERL5 will give the user a reason,
+# why the specific ports cannot be installed into the given environment.
+#
+#	USE_PERL5_REASON=	this module is already part of your Perl version
+#
 # $FreeBSD$
 #
 

==== //depot/projects/soc2007/gabor_perlmk/Mk/bsd.port.mk#7 (text+ko) ====

@@ -324,25 +324,6 @@
 #				- If set, this port uses perl5 in one or more of the extract,
 #				  patch, build or install phases.
 # USE_PERL5_RUN	- If set, this port uses perl5 for running.
-# PERL5			- Set to full path of perl5, either in the system or
-#				  installed from a port.
-# PERL			- Set to full path of perl5, either in the system or
-#				  installed from a port, but without the version number.
-#				  Use this if you need to replace "#!" lines in scripts.
-# PERL_VERSION	- Full version of perl5 (see below for current value).
-# PERL_VER		- Short version of perl5 (see below for current value).
-# PERL_LEVEL	- Perl version as an integer of the form MNNNPP, where
-#				  M is major version, N is minor version, and P is
-#				  the patch level. E.g., PERL_VERSION=5.6.1 would give
-#				  a PERL_LEVEL of 500601. This can be used in comparisons
-#				  to determine if the version of perl is high enough,
-#				  whether a particular dependency is needed, etc.
-# PERL_ARCH		- Directory name of architecture dependent libraries
-#				  (value: ${ARCH}-freebsd).
-# PERL_PORT		- Name of the perl port that is installed
-#				  (value: perl5)
-# SITE_PERL		- Directory name where site specific perl packages go.
-#				  This value is added to PLIST_SUB.
 # PERL_MODBUILD	- Use Module::Build to configure, build and install port.
 ##
 # USE_GHOSTSCRIPT