From: "st0012 (Stan Lo) via ruby-core" Date: 2024-12-25T12:08:51+00:00 Subject: [ruby-core:120405] [Ruby master Feature#20884] reserve "Ruby" toplevel module for Ruby language Issue #20884 has been updated by st0012 (Stan Lo). File Screenshot 2024-12-25 at 12.00.39.png added This change introduced an unexpected side-effect to the [master documentation](https://docs.ruby-lang.org/en/master/index.html) as now all mentions of `Ruby` are linked to this new constant: ![](Screenshot%202024-12-25%20at%2012.00.39.png) I think this should be addressed on the RDoc side so I opened https://github.com/ruby/rdoc/issues/1254 for it. ---------------------------------------- Feature #20884: reserve "Ruby" toplevel module for Ruby language https://bugs.ruby-lang.org/issues/20884#change-111184 * Author: Dan0042 (Daniel DeLorme) * Status: Closed ---------------------------------------- `Ruby` would be a convenient namespace for many features of the Ruby language, in particular APIs related to the interpreter. All these constants: RUBY_VERSION RUBY_RELEASE_DATE RUBY_PLATFORM RUBY_PATCHLEVEL RUBY_REVISION RUBY_COPYRIGHT RUBY_ENGINE RUBY_ENGINE_VERSION RUBY_DESCRIPTION would have made a lot of sense as `Ruby::VERSION` etc. `Thread::Backtrace::Location` would have made a lot of sense as `Ruby::Backtrace::Location` `RubyVM` is considered specific to CRuby; so `RubyVM::AbstractSyntaxTree` should be `Ruby::AbstractSyntaxTree` if it is meant to be present in other implementations. In #6648 there's a bit of contention over where `ruby_args` should be. `RubyVM`, `RbConfig`, `Process` have all been proposed, but `Ruby` would be an excellent choice. `Process.argv0` was added in Ruby 2.1 but the `Process` namespace is really about OS-level process control (fork, signals, euid, limits) while this argv0 is not (in `ps` it's neither value of COMMAND nor CMD) so it would have made sense as `Ruby.argv0` The "ruby" gem name is reserved, so there's no conflict. https://rubygems.org/gems/ruby All in all, "Ruby" is an appropriate namespace for many Ruby things. We don't want to break compatibility over this, but we could at least start small by reserving the namespace, and see how it grows from there. module Ruby VERSION = ::RUBY_VERSION end ---Files-------------------------------- Screenshot 2024-12-25 at 12.00.39.png (499 KB) -- https://bugs.ruby-lang.org/ ______________________________________________ ruby-core mailing list -- ruby-core@ml.ruby-lang.org To unsubscribe send an email to ruby-core-leave@ml.ruby-lang.org ruby-core info -- https://ml.ruby-lang.org/mailman3/lists/ruby-core.ml.ruby-lang.org/