From 5f640e8d67eccf0762f6905f3323ee322bec90f0 Mon Sep 17 00:00:00 2001
From: Kenshi Muto <kmuto@debian.org>
Date: Sun, 27 Sep 2020 22:07:05 +0900
Subject: [PATCH] remove comment feature.

---
 doc/format.ja.md       | 16 +++++++++-------
 doc/format.md          | 14 ++++++++------
 lib/review/builder.rb  |  4 ++--
 lib/review/compiler.rb |  4 ++--
 4 files changed, 21 insertions(+), 17 deletions(-)

diff --git a/doc/format.ja.md b/doc/format.ja.md
index 82b917702..a8bf8d03e 100644
--- a/doc/format.ja.md
+++ b/doc/format.ja.md
@@ -2,7 +2,7 @@
 
 Re:VIEW フォーマットの文法について解説します。Re:VIEW フォーマットはアスキー社（現カドカワ）の EWB を基本としながら、一部に RD や各種 Wiki の文法を取り入れて簡素化しています。
 
-このドキュメントは、Re:VIEW 4.2 に基づいています。
+このドキュメントは、Re:VIEW 5.0 に基づいています。
 
 ## 段落
 
@@ -919,23 +919,24 @@ Re:VIEW の箇条書きは `*` 型の箇条書きを除き、基本的に入れ
 
 この対策として、Re:VIEW 4.2 では試験的に `//beginchild`、`//endchild` というブロック命令を追加しています。箇条書きの途中に何かを含めたいときには、それを `//beginchild` 〜 `//endchild` で囲んで配置します。多重に入れ子にすることも可能です。
 
-`//beginchild`、`//endchild` は任意の引数を1つ取ることができ、挙動には影響しませんが人間に向けたコメントを入れるのに利用できます。
-
 ```
  * UL1
 
-//beginchild[ここからUL1の子]
+//beginchild
+#@# ここからUL1の子
 
  1. UL1-OL1
 
-//beginchild[ここからUL1-OL1の子]
+//beginchild
+#@# ここからUL1-OL1の子
 
 UL1-OL1-PARAGRAPH
 
  * UL1-OL1-UL1
  * UL1-OL1-UL2
 
-//endchild[ここまでUL1-OL1の子]
+//endchild
+#@# ここまでUL1-OL1の子
 
  2. UL1-OL2
 
@@ -944,7 +945,8 @@ UL1-OL1-PARAGRAPH
  : UL1-DL2
         UL1-DD2
 
-//endchild[ここまでUL1の子]
+//endchild
+#@# ここまでUL1の子
 
  * UL2
 ```
diff --git a/doc/format.md b/doc/format.md
index bbc41beb6..855ef7821 100644
--- a/doc/format.md
+++ b/doc/format.md
@@ -959,23 +959,24 @@ Re:VIEW itemize blocks basically cannot express nested items. Also, none of item
 
 As a workaround, Re:VIEW 4.2 provides an experimental `//beginchild` and `//endchild`. If you want to include something in an itemize block, enclose it with `//beginchild` and `//endchild`. It is also possible to create a multiple nest.
 
-`//beginchild` and `//endchild` cant take one argument and can be used to write a comment.
-
 ```
  * UL1
 
-//beginchild[child of UL1 start]
+//beginchild
+#@# child of UL1 start
 
  1. UL1-OL1
 
-//beginchild[child of UL1-OL1 start]
+//beginchild
+#@# child of UL1-OL1 start
 
 UL1-OL1-PARAGRAPH
 
  * UL1-OL1-UL1
  * UL1-OL1-UL2
 
-//endchild[child of UL1-OL1 end]
+//endchild
+#@# child of UL1-OL1 end
 
  2. UL1-OL2
 
@@ -984,7 +985,8 @@ UL1-OL1-PARAGRAPH
  : UL1-DL2
         UL1-DD2
 
-//endchild[child of UL1 end]
+//endchild
+#@# child of UL1 end
 
  * UL2
 ```
diff --git a/lib/review/builder.rb b/lib/review/builder.rb
index 69c2adcb4..272535f26 100644
--- a/lib/review/builder.rb
+++ b/lib/review/builder.rb
@@ -697,7 +697,7 @@ def escape(str)
       str
     end
 
-    def beginchild(_comment = nil)
+    def beginchild
       @children ||= []
       unless @previous_list_type
         error "//beginchild is shown, but previous element isn't ul, ol, or dl"
@@ -706,7 +706,7 @@ def beginchild(_comment = nil)
       @children.push(@previous_list_type)
     end
 
-    def endchild(_comment = nil)
+    def endchild
       if @children.nil? || @children.empty?
         error "//endchild is shown, but any opened //beginchild doesn't exist"
       else
diff --git a/lib/review/compiler.rb b/lib/review/compiler.rb
index 1c7961656..eae0615af 100644
--- a/lib/review/compiler.rb
+++ b/lib/review/compiler.rb
@@ -191,8 +191,8 @@ def inline_defined?(name)
     defsingle :include, 1
     defsingle :olnum, 1
     defsingle :firstlinenum, 1
-    defsingle :beginchild, 0..1
-    defsingle :endchild, 0..1
+    defsingle :beginchild, 0
+    defsingle :endchild, 0
 
     definline :chapref
     definline :chap