旧 @undef 段落の後方互換を過渡期用に残す

bitclust の CI(rurema ジョブ)は doctree master を checkout してビルドする
ため、@undef のパースを即時削除すると doctree 側の {: undef} への移行が
マージされるまで CI が通らない(UNKNOWN_META_INFO を check_format が検出)。

旧 @undef 段落のパース(kind = :undefined)と描画(専用メッセージ)を
deprecated として残す。doctree の移行完了後にフォローアップ PR で削除する。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: znz

lib/bitclust/mdcompiler.rb

@@ -140,6 +140,10 @@ def entry_chunk
         when /\A@todo\b/
           # findings#3: rd 側と同じく行頭アンカー付きで
           todo
+        when /\A@undef\b/
+          # 旧 @undef 段落の後方互換(rd 側と同期。移行完了後に削除する)
+          @f.gets
+          undef_message
         when RAW_META_RE
           entry_info
         when /\A\s*\|/

lib/bitclust/rdcompiler.rb

@@ -162,6 +162,11 @@ def entry_chunk
           see
         when /\A@todo\b/
           todo
+        when /\A@undef\b/
+          # 旧 @undef 段落の後方互換(UNKNOWN_META_INFO にすると doctree の
+          # check_format が落ちる)。{: undef} への移行完了後に削除する
+          @f.gets
+          undef_message
         when /\A@[a-z]/
           entry_info
         else

lib/bitclust/rrdparser.rb

@@ -486,6 +486,10 @@ def define_method(chunk)
                                 :undefined
                               elsif attrs.include?('nomethod')
                                 :nomethod
+                              elsif chunk.source.match?(/^@undef$/)
+                                # 旧 @undef 段落の後方互換。
+                                # doctree の {: undef} への移行完了後に削除する
+                                :undefined
                               else
                                 @kind
                               end

test/test_mdcompiler.rb

@@ -255,6 +255,17 @@ def test_entry_paragraph_with_midline_see_not_swallowed
     assert_match(/本文中で @see を説明する行。/, html)
   end
 
+  def test_legacy_undef_paragraph_renders_dedicated_message
+    # 旧 @undef 段落の後方互換(doctree master 移行完了後に削除)。
+    # UNKNOWN_META_INFO にしない(doctree の check_format が落ちるため)
+    rd_src = "--- <(other) -> bool\n\n@undef\n"
+    md_src = BitClust::RRDToMarkdown.convert(rd_src)
+    rd_html = compile_method(@rd, rd_src)
+    assert_not_match(/UNKNOWN_META_INFO/, rd_html)
+    assert_match(/このメソッドは定義されていません/, rd_html)
+    assert_equal rd_html, compile_method(@md, md_src), "md source:\n#{md_src}"
+  end
+
   def test_undef_renders_dedicated_message
     # {: undef} 属性行は専用の説明文を描画する（statichtml は undefined を
     # skip するため露出は server 等の動的経路のみ）

test/test_rrdparser.rb

@@ -164,3 +164,20 @@ def test_detached_attribute_line_is_not_a_method_attribute
     assert_equal(:defined, db.get_method(BitClust::MethodSpec.parse('Dummy#test_foo')).kind)
   end
 end
+
+class TestRRDParserLegacyUndef < Test::Unit::TestCase
+  # 旧 @undef の後方互換。doctree master が {: undef} へ移行するまでの
+  # 過渡期用で、移行完了後に削除する
+  def test_legacy_undef_paragraph_still_sets_kind
+    result = BitClust::RRDParser.parse(<<HERE, 'dummy')
+= module Dummy
+== Instance Methods
+--- test_undef
+
+@undef
+
+HERE
+    _library, db = result
+    assert_equal(:undefined, db.get_method(BitClust::MethodSpec.parse('Dummy#test_undef')).kind)
+  end
+end