summaryrefslogtreecommitdiff
path: root/share/man/man5
diff options
context:
space:
mode:
authorJeremy Evans <jeremy@cvs.openbsd.org>2017-11-01 10:32:13 +0000
committerJeremy Evans <jeremy@cvs.openbsd.org>2017-11-01 10:32:13 +0000
commit1742652e05cbbeeca5b35ab7386daf86f08fcc14 (patch)
tree68a22a1b2b0aa238bf82264fd1f5611687e2f889 /share/man/man5
parent7354052e3df145fcc5d0177dfaad57c6a122ff7d (diff)
Update ruby-module.5 for default ruby version switch from 2.3 to 2.4
Also remove ruby 1.8, 2.1, and 2.2 information, as that support was removed. Additionally, extconf CONFIGURE_STYLE support was removed, so remove mention of that as well.
Diffstat (limited to 'share/man/man5')
-rw-r--r--share/man/man5/ruby-module.540
1 files changed, 16 insertions, 24 deletions
diff --git a/share/man/man5/ruby-module.5 b/share/man/man5/ruby-module.5
index 25a00ad8a15..58c182674f3 100644
--- a/share/man/man5/ruby-module.5
+++ b/share/man/man5/ruby-module.5
@@ -1,4 +1,4 @@
-.\" $OpenBSD: ruby-module.5,v 1.21 2017/01/06 16:11:22 jeremy Exp $
+.\" $OpenBSD: ruby-module.5,v 1.22 2017/11/01 10:32:12 jeremy Exp $
.\"
.\" Copyright (c) 2008 Marc Espie, Jeremy Evans
.\"
@@ -24,7 +24,7 @@
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: January 6 2017 $
+.Dd $Mdocdate: November 1 2017 $
.Dt RUBY-MODULE 5
.Os
.Sh NAME
@@ -152,7 +152,7 @@ The "ruby gem"
should be used for pure ruby gems without C extensions.
This adds
.Ev PKG_ARCH
-= * and adds ruby18, ruby21, ruby22, ruby23, ruby24, and jruby
+= * and adds ruby23, ruby24, and jruby
.Ev FLAVOR Ns s
to the port, so the same port can build packages for multiple versions of ruby.
.It
@@ -168,30 +168,22 @@ the appropriate libraries and
.Ev MODRUBY_WANTLIB
to
.Ev WANTLIB .
-It also adds ruby18, ruby21, ruby22, ruby23, and ruby24
+It also adds ruby23 and ruby24
.Ev FLAVOR Ns s
to the port.
If the C extension in the gem requires specific arguments to extconf.rb, set those
via
.Ev CONFIGURE_ARGS .
-.It
-The "ruby extconf"
-.Ev CONFIGURE_STYLE
-is similar to the "ruby gem ext"
-.Ev CONFIGURE_STYLE ,
-except that it is used when the package is distributed with an extconf.rb file
-and not as a ruby gem.
-.El
.Pp
To ensure that dependencies use the same ruby implementation as the
-current port, all ruby gem/extconf dependencies specified in the port
+current port, all ruby gem dependencies specified in the port
should use this format:
.Pp
.Dl category/ruby-foo,${MODRUBY_FLAVOR}
.Pp
-Use of a ruby21, ruby22, ruby23, ruby24, or jruby
-.Ev FLAVOR
-causes the
+The "ruby gem" and "ruby gem ext"
+.Ev CONFIGURE_STYLE Ns s
+cause the
.Ev FULLPKGNAME
to use the
.Ev FLAVOR
@@ -202,30 +194,30 @@ is necessary so that if a ruby x.y package is being built for the current
port, it depends on the ruby x.y package of the
dependencies.
.Pp
-The ports system defaults to using ruby 2.3 if the version of ruby is not
+The ports system defaults to using ruby 2.4 if the version of ruby is not
specified.
-If you want to specify a version for a gem/extconf port, use a specific
+If you want to specify a version for a gem port, use a specific
.Ev FLAVOR ,
-such as ruby18 to use ruby 1.8.
-If you want to specify a version for a non-gem/extconf port, set
+such as ruby24 to use ruby 2.4.
+If you want to specify a version for a non-gem port, set
.Ev MODRUBY_REV
-for the version of ruby you want to use (1.8, 2.1, 2.2, 2.3, 2.4, jruby).
+for the version of ruby you want to use (2.3, 2.4, jruby).
.Pp
If you do not want the ports system to automatically set up
.Ev FLAVOR Ns s
-when using a gem/extconf port, set
+when using a gem port, set
.Ev MODRUBY_HANDLE_FLAVORS
to No.
Similarly, if you want the ports system to automatically set up
.Ev FLAVOR Ns s
-when using a non-gem/extconf port, set
+when using a non-gem port, set
.Ev MODRUBY_HANDLE_FLAVORS
to Yes.
When
.Ev MODRUBY_HANDLE_FLAVORS
is Yes, the ports system automatically adds the appropriate prefix to the
.Ev FULLPKGNAME
-(e.g. ruby- for ruby 1.8, ruby23- for ruby 2.3).
+(e.g. jruby- for jruby, ruby24- for ruby 2.4).
Additionally, it adds
.Ev GEM_BIN_SUFFIX
and