Translate "NEWS for Ruby 3.0.0" (ja) #2622

jinroq · 2021-12-03T16:01:00Z

Translate https://github.com/ruby/ruby/blob/ruby_3_0/NEWS.md to ja.
ただし、ローカル環境での動作確認方法が分からなかったので、動作未確認

* Translate [https://github.com/ruby/ruby/blob/ruby_3_0/NEWS.md](https://github.com/ruby/ruby/blob/ruby_3_0/NEWS.md) to ja. * ただし、ローカル環境での動作確認方法が分からなかったので、動作未確認

znz · 2021-12-06T02:43:49Z

GitHub Actions でチェックのために生成したものが Checks タブの Artifacts をクリックしてスクロールした中に statichtml-* があるので、手元で生成しなくても確認できます。

jinroq · 2021-12-07T04:55:35Z

zip ファイルの中の tar.gz ファイルの中ですね。軽微な文言変更の場合の表示も毎回 git push してから確認されていますか？

もうちょっとカジュアルに当該ファイルだけの表示確認とかしたいですが、その方法はないでしょうか？

* タイプライター体の構文を Markdown 形式から RDoc 形式に修正

znz · 2021-12-07T05:58:33Z

個別に確認するのは https://github.com/rurema/doctree/wiki/BitClust#%E9%96%8B%E7%99%BA%E8%80%85%E5%90%91%E3%81%91 の bitclust htmlfile があるようですが、変更の問題なのか指定の仕方の問題なのか、うまくいかないことがあったので、bundle exec rake generate:3.0 statichtml:3.0 などで使えるように自分が使っている方法は Rakefile に入れています。

znz

長いので、とりあえず GC のところまでみました。

znz · 2021-12-28T14:00:26Z

refm/doc/news/3_0_0.rd

+    Ruby 2.7 では非推奨の警告を表示していましたが、ArgumentError を出力するか、異なる振る舞いをします。
+    [[feature:14183]]
+  * 単一の rest 引数とキーワードを受け入れる Proc は、autosplat の対象ではなくなりました。
+    これは、単一の rest 引数を受け入れキーワードを受け入れない Procs の振る舞いと一致するようになっています。


Procs は日本語だと Proc でいいと思います。

修正しました。

znz · 2021-12-28T14:01:11Z

refm/doc/news/3_0_0.rd

@@ -28,7 +27,7 @@ pr.call([1, {a: 1}])
 # 3.0 => [[[1, {:a=>1}]], {}]
 #@end

-  * Arguments forwarding (`...`) now supports leading arguments.
+  * 引数委譲（+...+）は、先頭の引数をサポートするようになりました。


以下も同様ですが、bitclust には inline で code などのマークアップ機能はなかったはずなので、変換結果を確認していないのですが + は不要だと思います。

修正しました。

znz · 2021-12-28T14:03:45Z

refm/doc/news/3_0_0.rd

-    * One-line pattern matching is redesigned.  [EXPERIMENTAL]
-        * `=>` is added. It can be used like a rightward assignment.
+    * パターンマッチ（+case/in+）が正式機能となりました。 [[feature:17260]]
+    * 一行パターンマッチが実験的に再設計されました。


実験的と訳しても良いと思いますが、 [EXPERIMENTAL] は残した方がわかりやすいと思います。

ここも含めて [EXPERIMENTAL] 表記されていた箇所は戻しました。

znz · 2021-12-28T14:04:21Z

refm/doc/news/3_0_0.rd

-    `# frozen-string-literal: true` is used. [[feature:17104]]
-  * Magic comment `shareable_constant_value` added to freeze constants.
-    See {Magic Comments}[rdoc-ref:doc/syntax/comments.rdoc@Magic+Comments] for more details.
+  * +# frozen-string-literal: true+ が使用されている場合、式典会を含む文字列リテラルは freeze されなくなりました。


式典会 → 式展開

修正しました。

znz · 2021-12-28T14:05:36Z

refm/doc/news/3_0_0.rd

-    See {Magic Comments}[rdoc-ref:doc/syntax/comments.rdoc@Magic+Comments] for more details.
+  * +# frozen-string-literal: true+ が使用されている場合、式典会を含む文字列リテラルは freeze されなくなりました。
+    [[feature:17104]]
+  * マジックコメント +shareable_constant_value+ が freeze 定数に導入されました。


「定数を freeze するためのマジックコメント shareable_constant_value が追加」だと思います。

修正しました。

znz · 2021-12-28T14:13:27Z

refm/doc/news/3_0_0.rd

-    * ENV.except has been added, which returns a hash excluding the given keys and their values.  [[feature:15822]]
-    * Windows: Read ENV names and values as UTF-8 encoded Strings [[feature:12650]]
+    * ENV.except が導入されました。与えられたキーとそれらの値を除外したハッシュを返すようになりました。[[feature:15822]]
+    * Windows: ENV の名前を値を UTF-8 でエンコードされた文字列として読み取ります。[[feature:12650]]


名前を値を → 名前と値を

修正しました。

znz · 2021-12-28T14:14:25Z

refm/doc/news/3_0_0.rd

-    * Added new encoding IBM720.  [[feature:16233]]
-    * Changed default for Encoding.default_external to UTF-8 on Windows [[feature:16604]]
+    * 新しく IBM720 というエンコーディングが導入されました。[[feature:16233]]
+    * Windows では UTF-8 形式の Encoding.default_external がデフォルトになりました。[[feature:16604]]


Encoding.default_external のデフォルトが UTF-8 になりました、でしょうか。

修正しました。

znz · 2021-12-28T14:16:09Z

refm/doc/news/3_0_0.rd

+    * Fiber.new(blocking: true/false) は、ノンブロッキング実行コンテキストを生成することを許可するようになりました。[[feature:16786]]
+    * Fiber#blocking? は fiber がノンブロッキングであるかどうかを知らせてくれます。[[feature:16786]]
+    * Fiber#backtrace および Fiber#backtrace_locations は fiber ごとのバックトレースを提供するようになりました。[[feature:16815]]
+    * Fiber#transfer の制限が緩和されるようになりました。[[bug:17221]]


「緩和されるようになりました」は「緩和されました」で良いと思います。

修正しました。

znz · 2021-12-28T14:16:58Z

refm/doc/news/3_0_0.rd

-    * Fiber#backtrace and Fiber#backtrace_locations provide per-fiber backtrace. [[feature:16815]]
-    * The limitation of Fiber#transfer is relaxed. [[bug:17221]]
+    * Fiber.new(blocking: true/false) は、ノンブロッキング実行コンテキストを生成することを許可するようになりました。[[feature:16786]]
+    * Fiber#blocking? は fiber がノンブロッキングであるかどうかを知らせてくれます。[[feature:16786]]


「ノンブロッキングかどうかを返します」ぐらいに意訳しても良いかもしれません。

boolean を返しそうな文面にしてみました。

znz · 2021-12-28T14:18:32Z

refm/doc/news/3_0_0.rd

  * GC
-    * GC.auto_compact= and GC.auto_compact have been added to control when compaction runs.  Setting `auto_compact=` to `true` will cause compaction to occur during major collections.  At the moment, compaction adds significant overhead to major collections, so please test first!  [[feature:17176]]
+    * コンパクションが実行されるタイミングを制御するために GC.auto_compact= および GC.auto_compact が導入されました。
+      +auto_compact=+ を +true+ に設定すると、主要なコレクション中にコンパクションが発生します。


以下も含めて「major collections」は他でも使われている用語の「メジャーGC」で良いと思います。

対応しました。

* Procs -> Proc

* [EXPERIMENTAL] を追記

* fixed typo

* shareable_constant_value の説明文を修正

* fixed typo

* Encoding.default_external の説明文を修正

* ”Fiber#transfer の制限”の説明文を修正

* Fiber#blocking? の説明文を修正

* major collections の日本語訳をメジャー GC に修正

* inline マークアップとして用いた `+` を消去 * see rurema#2622 (comment)

* 不自然な日本語を修正

* 助詞の修正

znz

遅くなってしまいましたが、レビューの続きをしました。

znz · 2022-04-06T05:21:28Z

refm/doc/news/3_0_0.rd

+  * メソッド内のシングルトンクラス定義中の yield は警告ではなく SyntaxError になりました。
+    メソッド外のクラス定義中の yield は LocalJumpError ではなく SyntaxError になりました。
+    [[feature:15575]]
+  * スーパークラス/スーパーモジュールでクラス変数を再定義した場合、RuntimeError が浮揚されるようになりました


「浮揚」という言い方は使われてなさそうです。

修正しました。

znz · 2022-04-06T05:23:09Z

refm/doc/news/3_0_0.rd

-    * GC.auto_compact= and GC.auto_compact have been added to control when compaction runs.  Setting `auto_compact=` to `true` will cause compaction to occur during major collections.  At the moment, compaction adds significant overhead to major collections, so please test first!  [[feature:17176]]
+    * コンパクションが実行されるタイミングを制御するために GC.auto_compact= および GC.auto_compact が導入されました。
+      auto_compact= を true に設定すると、メジャー GC 中にコンパクションが発生します。
+      現時点では、コンパクションによってメジャー GC にかなりのオーバーヘッドが追加されます。よって、まず最初にテストを実行してください！


「テストを実行してください」→「テストしてください」の方が良さそうです。

修正しました。

znz · 2022-04-06T05:24:50Z

refm/doc/news/3_0_0.rd

  * Proc
    * Proc#== and Proc#eql? are now defined and will return true for separate Proc instances if the procs were created from the same block. [[feature:14267]]
+    * Proc#== および Proc#eql? は、Procs が同じブロックから作成される場合、Proc インスタンスと分離して true を返すように定義されました。[[feature:14267]]


Procs → Proc

修正しました。

znz · 2022-04-06T05:25:42Z

refm/doc/news/3_0_0.rd

  * Ractor
-    * New class added to enable parallel execution. See rdoc-ref:ractor.md for more details.
+    * 並列処理を可能にする新しいクラスが追加されました。詳細は {Ractor}[rdoc-ref:ractor.md] を参照してください。


Ractor クラスへのリンクにするのが良さそうです。

en 版の Ractor クラスのリンクに変更しました。

znz · 2022-04-06T05:29:03Z

refm/doc/news/3_0_0.rd

  * Random
-    * `Random::DEFAULT` now refers to the `Random` class instead of being a `Random` instance, so it can work with `Ractor`. [[feature:17322]]
-    * `Random::DEFAULT` is deprecated since its value is now confusing and it is no longer global, use `Kernel.rand`/`Random.rand` directly, or create a `Random` instance with `Random.new` instead. [[feature:17351]]
+    * Random::DEFAULT は Random インスタンスではなく Random クラスから参照されるようになりました。よって、Ractor で機能します。[[feature:17322]]


Random クラスから参照ではなく、 Random クラスをさすようになった、です。

% docker run --rm -it ghcr.io/ruby/all-ruby env ALL_RUBY_SINCE=ruby-2.6 ./all-ruby -e 'p [Random::DEFAULT.class, Random::DEFAULT==Random]' ruby-2.6.0 [Random, false] ... ruby-3.0.0-preview1 [Random, false] ruby-3.0.0-preview2 [Class, true] ... ruby-3.1.1 [Class, true] ruby-3.2.0-preview1 -e:1:in `<main>': uninitialized constant Random::DEFAULT (NameError) p [Random::DEFAULT.class, Random::DEFAULT==Random] ^^^^^^^^^ exit 1

修正しました。

refm/doc/news/3_0_0.rd

znz · 2022-04-06T05:46:41Z

refm/doc/news/3_0_0.rd

-  * C API functions related to `$SAFE` have been removed. [[feature:16131]]
-  * C API header file `ruby/ruby.h` was split. [[url:https://github.com/ruby/ruby/pull/2991]] This should have no impact on extension libraries, but users might experience slow compilations.
+    * net-telnet および xmlrpc は、バンドルされた gem から削除されました。
+      これらを保守したい場合は、https://github.com/ruby/xmlrpc もしくは https://github.com/ruby/net-telnet にあなたのプランをコメントしてください。


このあたりの URL は下の WEBrick のあたりまで含めて [[url: ]] でくくってリンクにすると良さそうです。

対応しました。

refm/doc/news/3_0_0.rd

Co-authored-by: Kazuhiro NISHIYAMA <[email protected]>

…ctree into traslate_news_3_0_0_rd

jinroq · 2022-06-29T14:28:59Z

残タスク

Translate "NEWS for Ruby 3.0.0" (ja) #2622 (comment)

Translate "NEWS for Ruby 3.0.0" (ja)

102340f

* Translate [https://github.com/ruby/ruby/blob/ruby_3_0/NEWS.md](https://github.com/ruby/ruby/blob/ruby_3_0/NEWS.md) to ja. * ただし、ローカル環境での動作確認方法が分からなかったので、動作未確認

タイプライター体の構文を修正

92f2e48

* タイプライター体の構文を Markdown 形式から RDoc 形式に修正

Merge branch 'rurema:master' into traslate_news_3_0_0_rd

eb04c80

znz requested changes Dec 28, 2021

View reviewed changes

jinroq added 15 commits January 1, 2022 16:05

Merge branch 'rurema:master' into traslate_news_3_0_0_rd

f8bde84

レビュー指摘対応

cf910e1

* Procs -> Proc

レビュー指摘対応

1c2b2a6

* [EXPERIMENTAL] を追記

レビュー指摘対応

9e12f77

* fixed typo

レビュー指摘対応

844c91d

* shareable_constant_value の説明文を修正

レビュー指摘対応

421b940

* fixed typo

レビュー指摘対応

18c48dc

* Encoding.default_external の説明文を修正

レビュー指摘対応

a9f81dd

* ”Fiber#transfer の制限”の説明文を修正

レビュー指摘対応

ccb3aea

* Fiber#blocking? の説明文を修正

レビュー指摘対応

d157cad

* major collections の日本語訳をメジャー GC に修正

レビュー指摘対応

492750e

* inline マークアップとして用いた `+` を消去 * see rurema#2622 (comment)

レビュー指摘対応

a13f09b

* 不自然な日本語を修正

レビュー指摘対応

22c7f88

* 助詞の修正

Magic Comments のリンクを修正

565e52a

RDoc のハイパーリンク（？）が有効にならないので削除

25140d4

jinroq requested a review from znz February 3, 2022 01:59

znz requested changes Apr 6, 2022

View reviewed changes

jinroq and others added 6 commits June 29, 2022 22:54

Update refm/doc/news/3_0_0.rd

dc09049

Co-authored-by: Kazuhiro NISHIYAMA <[email protected]>

Update refm/doc/news/3_0_0.rd

0b3231e

Co-authored-by: Kazuhiro NISHIYAMA <[email protected]>

Update refm/doc/news/3_0_0.rd

63a8302

Co-authored-by: Kazuhiro NISHIYAMA <[email protected]>

Update refm/doc/news/3_0_0.rd

9741d8a

Co-authored-by: Kazuhiro NISHIYAMA <[email protected]>

Update refm/doc/news/3_0_0.rd

7196368

Co-authored-by: Kazuhiro NISHIYAMA <[email protected]>

Update refm/doc/news/3_0_0.rd

530f4d6

Co-authored-by: Kazuhiro NISHIYAMA <[email protected]>

jinroq added 2 commits June 29, 2022 23:19

レビュー指摘対応

baf6b77

Merge branch 'traslate_news_3_0_0_rd' of https://github.com/jinroq/do…

d3021e3

…ctree into traslate_news_3_0_0_rd

Merge branch 'rurema:master' into traslate_news_3_0_0_rd

a0ca610

Translate "NEWS for Ruby 3.0.0" (ja) #2622

Are you sure you want to change the base?

Translate "NEWS for Ruby 3.0.0" (ja) #2622

Conversation

jinroq commented Dec 3, 2021

znz commented Dec 6, 2021

jinroq commented Dec 7, 2021

znz commented Dec 7, 2021

znz left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

znz left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

jinroq commented Jun 29, 2022