Merge branch 'rurema:master' into hashimoto-kei-patch-1

Author: hashimoto-kei

.github/workflows/ci.yml

@@ -31,7 +31,7 @@ jobs:
     runs-on: ${{ matrix.os }}
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
     - name: Set up Ruby
       uses: ruby/setup-ruby@v1
       with:
@@ -58,7 +58,7 @@ jobs:
         ls -Name "*.*" | foreach {
           tar acf "../artifact/${_}.tar.xz" $_
         }
-    - uses: actions/upload-artifact@v4
+    - uses: actions/upload-artifact@v7
       with:
         name: statichtml-${{ matrix.os }}-${{ matrix.ruby }}
         path: /tmp/artifact/*.*.tar.xz
@@ -68,7 +68,7 @@ jobs:
         cd /tmp
         mv -v html html.pr
     - name: Checkout base
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
       with:
         ref: ${{ github.event.pull_request.base.sha }}
     - name: Install dependencies (base)
@@ -84,7 +84,7 @@ jobs:
         git diff --no-index html.base html.pr --stat || true
         git diff --no-index html.base html.pr --output artifact/html.diff || true
       if: ${{ steps.generate_base.outcome == 'success' }}
-    - uses: actions/upload-artifact@v4
+    - uses: actions/upload-artifact@v7
       with:
         name: diff-${{ matrix.os }}-${{ matrix.ruby }}
         path: /tmp/artifact/html.diff
@@ -94,7 +94,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
     - name: Install misspell
       run: 'curl -L https://git.io/misspell | bash'
     - name: Run misspell

Dockerfile

@@ -1,4 +1,4 @@
-FROM ruby:3.4.5-bookworm
+FROM ruby:4.0.1-bookworm
 RUN useradd rurema --create-home --shell /bin/bash
 USER rurema:rurema
 ENV BUNDLE_AUTO_INSTALL true

Gemfile.lock

@@ -19,7 +19,7 @@ GEM
     drb (2.2.1)
     nkf (0.2.0)
     progressbar (1.13.0)
-    rack (3.1.16)
+    rack (3.1.20)
     rackup (2.1.0)
       rack (>= 3)
       webrick (~> 1.8)
@@ -38,4 +38,4 @@ DEPENDENCIES
   refe2!
 
 BUNDLED WITH
-   2.5.11
+   2.7.1

Rakefile

@@ -3,8 +3,8 @@ OLD_VERSIONS = %w[
   1.8.7 1.9.3
   2.0.0 2.1.0 2.2.0 2.3.0 2.4.0 2.5.0 2.6.0 2.7.0
 ]
-SUPPORTED_VERSIONS = %w[3.0 3.1 3.2 3.3]
-UNRELEASED_VERSIONS = %w[3.4]
+SUPPORTED_VERSIONS = %w[3.0 3.1 3.2 3.3 3.4 4.0]
+UNRELEASED_VERSIONS = %w[4.1]
 ALL_VERSIONS = [*OLD_VERSIONS, *SUPPORTED_VERSIONS, *UNRELEASED_VERSIONS]
 CI_VERSIONS = [*SUPPORTED_VERSIONS, *UNRELEASED_VERSIONS]
 HTML_DIRECTORY_BASE = ENV.fetch("HTML_DIRECTORY_BASE", "/tmp/html/")

refm/api/src/_builtin/Array

@@ -1517,13 +1517,9 @@ p [1, nil, 3, nil].nitems{|e| e == 1}  #=> 2
 --- none?{|obj| ... }   -> bool
 --- none?(pattern)      -> bool
 
-ブロックを指定しない場合は、 配列のすべての
-要素が偽であれば真を返します。そうでなければ偽を返します。
-
-ブロックを指定した場合は、配列のすべての要素を
-ブロックで評価した結果が、すべて偽であれば真を返します。
-そうでなければ偽を返します。
+すべての要素が偽である場合に true を返します。真である要素があれば、ただちに false を返します。
 
+ブロックを伴う場合は、各要素に対してブロックを評価し、すべての結果が偽である場合に true を返します。ブロックが真を返した時点で、ただちに false を返します。
 要素の数が 0 である配列に対しては true を返します。
 
 @param pattern ブロックの代わりに各要素に対して pattern === item を評価します。
@@ -1902,7 +1898,10 @@ a                  #=> [ "a", "b", "c" ]
 --- sort {|a, b| ... }  -> Array
 --- sort! {|a, b| ... } -> self
 
-配列の内容をソートします。要素同士の比較は <=> 演算子を使って行います。sort はソートされた配列を生成して返します。
+全ての要素を昇順にソートします。
+要素同士の比較は <=> 演算子を使って行います。
+
+sort は self を変更せず、ソートされた配列を生成して返します。
 sort! は self を破壊的にソートし、self を返します。
 
 ブロックとともに呼び出された時には、要素同士の比較をブロックを用いて行います。

refm/api/src/_builtin/ENV

@@ -426,7 +426,7 @@ ENV.slice("unknown")    # => {}
 ENV.slice("foo", "baz") # => {"foo"=>"bar", "baz"=>"qux"}
 #@end
 
-#@since 3.0.0
+#@since 3.0
 @see [[m:Hash#slice]], [[m:ENV.except]]
 #@else
 @see [[m:Hash#slice]]
@@ -436,7 +436,7 @@ ENV.slice("foo", "baz") # => {"foo"=>"bar", "baz"=>"qux"}
 --- freeze -> ()
 ENV.freeze は環境変数の変更を禁止できないため、[[c:TypeError]]を発生させます。
 #@end
-#@since 3.0.0
+#@since 3.0
 --- except(*keys) -> Hash
 
 引数で指定された以外のキーとその値だけを含む Hash を返します。

refm/api/src/_builtin/Encoding

@@ -101,7 +101,7 @@ p Encoding.name_list
 
 Rubyはロケールまたは -E オプションに従って default_external を決定します。ロケールの確認・設定方法については各システムのマニュアルを参照してください。
 
-#@since 3.0.0
+#@since 3.0
 -E オプションを指定していない場合は、WindowsではUTF-8、その他のOSではロケールに従って default_external を決定します。
 #@end
 
@@ -503,7 +503,7 @@ CP437 エンコーディング。
 @see [[url:https://en.wikipedia.org/wiki/Code_page_437]],
      [[m:Encoding::CP869]]
 
-#@since 3.0.0
+#@since 3.0
 --- IBM720 -> Encoding
 --- CP720 -> Encoding
 

refm/api/src/_builtin/GC

@@ -182,7 +182,7 @@ oldmalloc_increase_bytes と呼ばれる。この2つの性質は以下のよう
 
 == Singleton Methods
 
-#@since 3.0.0
+#@since 3.0
 --- auto_compact -> bool
 
 auto compaction が有効化どうかを返します。

refm/api/src/_builtin/Hash

@@ -1573,22 +1573,22 @@ h.transform_values!.with_index {|v, i| "#{v}.#{i}" }
 @see [[m:Hash#transform_keys]]
 @see [[m:Hash#transform_keys!]]
 --- transform_keys {|key| ... } -> Hash
-#@since 3.0.0
+#@since 3.0
 --- transform_keys(hash)        -> Hash
 #@end
 --- transform_keys              -> Enumerator
 
 すべてのキーに対してブロックを呼び出した結果で置き換えたハッシュを返します。
 値は変化しません。
 
-#@since 3.0.0
+#@since 3.0
 @param hash 置き換え前のキーから置き換え後のキーへのハッシュを指定します。
 #@end
 
 #@samplecode 例
 h = { a: 1, b: 2, c: 3 }
 h.transform_keys {|k| k.to_s }   # => {"a"=>1, "b"=>2, "c"=>3}
-#@since 3.0.0
+#@since 3.0
 h.transform_keys(a: "a", d: "d") # => {"a"=>1, :b=>2, :c=>3}
 #@end
 h.transform_keys(&:to_s)         # => {"a"=>1, "b"=>2, "c"=>3}
@@ -1601,15 +1601,15 @@ h.transform_keys.with_index {|k, i| "#{k}.#{i}" }
 @see [[m:Hash#transform_values!]]
 
 --- transform_keys! {|key| ... } -> self
-#@since 3.0.0
+#@since 3.0
 --- transform_keys!(hash)        -> self
 #@end
 --- transform_keys!                -> Enumerator
 
 すべてのキーに対してブロックを呼び出した結果でハッシュのキーを変更します。
 値は変化しません。
 
-#@since 3.0.0
+#@since 3.0
 @param hash 置き換え前のキーから置き換え後のキーへのハッシュを指定します。
 #@end
 @return transform_keys! は常に self を返します。
@@ -1621,7 +1621,7 @@ h.transform_keys.with_index {|k, i| "#{k}.#{i}" }
 h = { a: 1, b: 2, c: 3 }
 h.transform_keys! {|k| k.to_s }   # => {"a"=>1, "b"=>2, "c"=>3}
 h.transform_keys!(&:to_sym)       # => {:a=>1, :b=>2, :c=>3}
-#@since 3.0.0
+#@since 3.0
 h.transform_keys!(a: "a", d: "d") # => {"a"=>1, :b=>2, :c=>3}
 #@end
 h.transform_keys!.with_index {|k, i| "#{k}.#{i}" }
@@ -1643,13 +1643,13 @@ h.slice(:c, :b)       # => {:c=>300, :b=>200}
 h.slice(:b, :c, :d)   # => {:b=>200, :c=>300}
 #@end
 
-#@since 3.0.0
+#@since 3.0
 @see [[m:Hash#except]], [[m:ENV.slice]]
 #@else
 @see [[m:ENV.slice]]
 #@end
 #@end
-#@since 3.0.0
+#@since 3.0
 --- except(*keys) -> Hash
 
 引数で指定された以外のキーとその値だけを含む Hash を返します。

refm/api/src/_builtin/Marshal

@@ -63,15 +63,25 @@ p Marshal.dump(Hash.new {})
 
 @see [[m:Object#marshal_dump]], [[m:Object#marshal_load]]
 
+#@since 3.1
+--- load(port, proc = nil, options = {})      -> object
+--- restore(port, proc = nil, options = {})   -> object
+#@else
 --- load(port, proc = nil)      -> object
 --- restore(port, proc = nil)   -> object
+#@end
 
 port からマーシャルデータを読み込んで、元のオブジェクトと同
 じ状態をもつオブジェクトを生成します。
 
 proc として手続きオブジェクトが与えられた場合には読み込んだ
 オブジェクトを引数にその手続きを呼び出します。
 
+#@since 3.1
+options の :freeze キーに真が指定された場合、読み込んだオブジェクトを freeze して返します。
+同一の文字列が freeze されているときオブジェクトは一つしか生まれないため、この指定によりメモリ使用効率が向上する場合があります。
+#@end
+
 #@samplecode 例
 str = Marshal.dump(["a", 1, 10 ** 10, 1.0, :foo])
 p Marshal.load(str, proc {|obj| p obj})
@@ -90,6 +100,14 @@ p Marshal.load(str, proc {|obj| p obj})
 
 @param proc 手続きオブジェクト。[[c:Proc]]
 
+#@since 3.1
+@param options オプションをハッシュで指定します。指定可能なオプションは以下の通りです。
+
+: :freeze
+  真偽値を指定します。真を指定すると読み込んだオブジェクトを freeze して返します。
+  デフォルトは偽です。
+#@end
+
 @raise TypeError メジャーバージョンが異なるか、バージョンの大きな
                  マーシャルデータを読み込んだ場合に発生します。