Skip to content

Commit 1dc3e30

Browse files
committed
Update the Updating Ruby document
1 parent c65c017 commit 1dc3e30

File tree

1 file changed

+6
-3
lines changed

1 file changed

+6
-3
lines changed

doc/contributor/updating-ruby.md

+6-3
Original file line numberDiff line numberDiff line change
@@ -166,8 +166,9 @@ Update all of these:
166166

167167
* Update `.ruby-version`, `TruffleRuby.LANGUAGE_VERSION`
168168
* Reset `truffleruby-abi-version.h` to `$RUBY_VERSION.1` and `lib/cext/ABI_check.txt` to `1` if `RUBY_VERSION` was updated.
169+
* use `$RUBY_VERSION.$GRAALVM_VERSION.1` for releases in `truffleruby-abi-version.h`
169170
* Update `versions.json`
170-
* with bundled gem versions provided by `cat ../ruby/gems/bundled_gems | sort`,
171+
* with bundled gem versions provided by `cat ../ruby/gems/bundled_gems | sort` (ensure the target Ruby version is checked out in the `../ruby` directory),
171172
* default gem versions provided by `ls -l lib/gems/specifications/default`
172173
* and `gem` gem version provided by `grep 'VERSION =' lib/mri/rubygems.rb`
173174
* Also update version numbers for `debug`, `racc`, and `rbs` in `src/main/c/Makefile`, `mx.truffleruby/suite.py` and `lib/gems/gems/debug-*/ext/debug/extconf.rb`.
@@ -176,9 +177,11 @@ Update all of these:
176177
* Copy and paste the TruffleRuby `--help` output to `doc/user/options.md` (e.g., with `jt ruby --help | xsel -b`)
177178
* Update `doc/user/compatibility.md` and `README.md`
178179
* Update `doc/legal/legal.md`, notably the `Bundled gems` section
179-
* Update method lists - see `spec/truffle/methods_spec.rb`
180+
* Update method lists (see `spec/truffle/methods_spec.rb`)
181+
* run `jt -u ruby test spec/truffle/methods_spec.rb` to add new methods
182+
* run `jt purge spec/truffle/methods_spec.rb` to remove tags for implemented methods
180183
* Build TruffleRuby (`jt build`).
181-
* Run `jt test gems default-bundled-gems`
184+
* Run `jt test gems default-bundled-gems` and commit generated `Gemfile` and `Gemfile.lock` files
182185
* Get `jt test spec/truffle/rubygems/default_gems_list_spec.rb` to pass
183186
* Grep for the old Ruby version with `git grep -F x.y.z`
184187
* Grep for the old Bundler version with `git grep -F x.y.z`

0 commit comments

Comments
 (0)