Update port-modules.5 to reflect recent (and not-so-recent)
changes to ruby.port.mk.
OK?
Jeremy
Index: port-modules.5
===================================================================
RCS file: /cvs/src/share/man/man5/port-modules.5,v
retrieving revision 1.106
diff -u -p -r1.106 port-modules.5
--- port-modules.5 3 Oct 2011 11:01:32 -0000 1.106
+++ port-modules.5 17 Nov 2011 19:01:19 -0000
@@ -515,13 +515,21 @@ MODPY_BIN_ADJ called on them at the end
Also affects CATEGORIES, MAKE_ENV, CONFIGURE_ENV, SHARED_ONLY, and SUBST_VARS.
May affect the regress target.
.It lang/ruby
-Sets MODRUBY_REV, RUBY, RAKE, RSPEC, MODRUBY_RUN_DEPENDS, MODRUBY_LIB_DEPENDS,
-MODRUBY_BUILD_DEPENDS, MODRUBY_ICONV_DEPENDS, MODRUBY_LIBDIR, MODRUBY_DOCDIR,
-MODRUBY_EXAMPLEDIR, MODRUBY_ARCH, MODRUBY_REGRESS, MODRUBY_RUBY_ADJ,
-MODRUBY_ADJ_FILES, GEM_BIN_SUFFIX, MODRUBY_LIBREV, MODRUBY_BINREV,
-MODRUBY_PKGSPEC, MODRUBY_PKG_PREFIX, MODRUBY_RAKE_DEPENDS,
-MODRUBY_RSPEC_DEPENDS, MODRUBY_WANTLIB, MODRUBY_FLAVOR.
-RUBY, RAKE, and RSPEC are the path to the ruby, rake, and rspec binaries.
+Sets MODRUBY_REV, RUBY, RAKE, RSPEC, MODRUBY_BIN_TESTRB, MODRUBY_BIN_RSPEC
+MODRUBY_RUN_DEPENDS, MODRUBY_LIB_DEPENDS, MODRUBY_BUILD_DEPENDS,
+MODRUBY_ICONV_DEPENDS, MODRUBY_LIBDIR, MODRUBY_DOCDIR, MODRUBY_SITEARCHDIR,
+MODRUBY_SITEDIR, MODRUBY_ARCH, MODRUBY_EXAMPLEDIR, MODRUBY_ARCH,
+MODRUBY_RUBY_ADJ, MODRUBY_ADJ_FILES, GEM_BIN_SUFFIX, GEM_MAN_SUFFIX,
+MODRUBY_LIBREV, MODRUBY_BINREV, MODRUBY_PKGSPEC, MODRUBY_PKG_PREFIX,
+MODRUBY_RAKE_DEPENDS, MODRUBY_RSPEC_DEPENDS, MODRUBY_WANTLIB, MODRUBY_FLAVOR,
+MODRUBY_REGRESS, MODRUBY_REGRESS_TARGET, MODRUBY_REGRESS_DIR,
+MODRUBY_REGRESS_ENV, MODRUBY_BUILD_TARGET, MODRUBY_INSTALL_TARGET,
+MODRUBY_EXTRACT_TARGET, GEM, GEM_BIN, GEM_LIB, GEM_BASE_LIB, GEM_ABS_PATH,
+GEM_BASE_BIN, GEM_FLAGS.
+RUBY, RAKE, and MODRUBY_BIN_TESTRB are the path to the ruby, rake, and
+testrb binaries for the related ruby implementation.
+RSPEC and MODRUBY_BIN_RSPEC are the path to the spec (rspec 1) and
+rspec (rspec 2) binaries for the related ruby implementation.
MODRUBY_RUBY_ADJ is a command that takes filename arguments and replaces
the /usr/bin/env ruby shebang lines with RUBY.
MODRUBY_ADJ_FILES is a list of filename patterns that will automatically
@@ -530,7 +538,11 @@ Appends to CATEGORIES and SUBST_VARS.
Appends to BUILD_DEPENDS unless MODRUBY_BUILDDEP is set to No or NO_BUILD
is set to Yes.
Appends to RUN_DEPENDS unless MODRUBY_RUNDEP is set to No.
-May affect the regress target if MODRUBY_REGRESS is used.
+Creats a do-regress target if MODRUBY_REGRESS is used and one is not already
+defined.
+MODRUBY_REGRESS can be set to ruby, rake, rspec, rspec2, or testrb to
+choose the appropriate binary to run the regress tests, with the related
+MODRUBY_REGRESS_* variables affecting the related parts of the regress tests.
Supports additional CONFIGURE_STYLEs, and setting specific CONFIGURE_STYLEs
modifies some additional parameters.
The "ruby gem" CONFIGURE_STYLE should be used for pure ruby gems without
@@ -554,10 +566,13 @@ Specifying MODRUBY_FLAVOR is necessary s
package for the current port, it depends on the ruby 1.9 package of the
dependencies.
For ruby gem ports that can work on both ruby 1.8 and ruby 1.9, any binary
-file entries in the PLIST should be appended with ${GEM_BIN_SUFFIX}.
-This is because the ruby 1.9 gem binaries are installed with a 19 suffix.
-make update-plist tends to remove ${GEM_BIN_SUFFIX}, so be careful when
-updating such ports.
+file entries in the PLIST should be appended with ${GEM_BIN_SUFFIX},
+and any man pages should use ${GEM_MAN_SUFFIX} before the extension.
+This is because the ruby 1.9 gem binaries are installed with a 19 suffix,
+and man pages are installed to places where they would conflict if the
+name was the same in all FLAVORs.
+make update-plist currently removes ${GEM_BIN_SUFFIX} and ${GEM_MAN_SUFFIX},
+so be careful when updating such ports.
.It lang/tcl
Sets MODTCL_VERSION, MODTCL_BIN, MODTCL_INCDIR, MODTCL_LIBDIR,
MODTCL_BUILD_DEPENDS, MODTCL_RUN_DEPENDS, MODTCL_LIB, MODTCL_LIB_DEPENDS,
