Skip to content

ヘルプと記号ページのモジュール関数表記を 4.0 以降は ?. にする#3263

Merged
znz merged 1 commit into
rurema:masterfrom
znz:c-question-dot-doc
Jul 22, 2026
Merged

ヘルプと記号ページのモジュール関数表記を 4.0 以降は ?. にする#3263
znz merged 1 commit into
rurema:masterfrom
znz:c-question-dot-doc

Conversation

@znz

@znz znz commented Jul 22, 2026

Copy link
Copy Markdown
Member

概要

rurema/bitclust#250(PR rurema/bitclust#277)で Ruby 4.0 以降のドキュメントは生成される見出し等のモジュール関数表記が ?. になったため、表記を説明している側のページを版で分岐します。

  • help.md の FAQ「Kernel.#require の .# って何?」→ 4.0 以降は ?. 表記の設問・説明に切り替え。「Ruby 4.0 より前のバージョンのドキュメントでは「.#」と表示されています」という相互案内も追記
  • symref.md 冒頭の Kernel.#format への言及も同様に分岐

検証

  • 3.4 / 4.0 両版の Preprocessor 展開+MDCompiler 描画で、表記の切り替え(3.4=.# / 4.0=?.)とリスト構造の不変(dt/li 数が両版で一致=#@since/#@else がリストを分断しないこと)を確認済み
  • check_blank_lines / check_single_space_indent とも pass

なお、本文中のインライン参照([m:Kernel?.open] 等)は Markdown 移行時からソース記載どおり ?. で表示されており(リンクテキスト=記載文字列)、今回の対象は説明ページの散文のみです。manual/ 配下で .# 表記を説明・言及している散文はこの2箇所で全てであることを grep で確認しています。

refs rurema/bitclust#250

🤖 Generated with Claude Code

rurema/bitclust#250(PR rurema#277)で Ruby 4.0 以降のドキュメントは生成される
見出し等のモジュール関数表記が ?. になったため、説明している側のページも
版で分岐する:

- help.md の FAQ「Kernel.#require の .# って何?」を 4.0 以降は ?. 表記に。
  旧バージョンのドキュメントでは .# と表示されている旨も追記
- symref.md 冒頭の Kernel.#format への言及も同様に分岐

3.4/4.0 両版の Preprocessor 展開+MDCompiler 描画で、表記の切り替えと
リスト構造の不変(dt/li 数一致)を確認済み。

refs rurema/bitclust#250

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@znz
znz merged commit 3009819 into rurema:master Jul 22, 2026
9 checks passed
@znz
znz deleted the c-question-dot-doc branch July 22, 2026 05:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant