regen: update comments

1 files changed, 44 insertions, 12 deletions

diff --git a/fml/doc/ja/tutorial/variables/filter.rules.sgml b/fml/doc/ja/tutorial/variables/filter.rules.sgml
index ad55cde3..293ff456 100644
--- a/fml/doc/ja/tutorial/variables/filter.rules.sgml
+++ b/fml/doc/ja/tutorial/variables/filter.rules.sgml
@@ -2,9 +2,13 @@
 <screen>
 
 # Descriptions:
-#      History:
-#        Value:
-#     Examples:
+#      History: fml8 では、いくつかのフィルタや制限が整理統合された。
+#		fml4 では、おおむね次の３つの機能に相当している。
+#		$USE_DISTRIBUTE_FILTER
+#		$INCOMING_MAIL_SIZE_LIMIT
+#		ADD_CONTENT_HANDLER()
+#        Value: yes / no
+#     Examples: yes
 use_article_filter	= 	yes
  
 
@@ -20,7 +24,7 @@ article_filter_functions	=	article_size_filter
 
 
 # Descriptions: サイズ情報を根拠にしたフィルタリングをするか？
-#      History:
+#      History: no
 #        Value: yes / no
 #     Examples:
 use_article_size_filter	=	yes
@@ -37,7 +41,8 @@ article_size_filter_rules	=	check_header_size
 
 
 # Descriptions: ヘッダ情報を根拠にしたフィルタリングをするか？
-#      History:
+#      History: disabled by default.
+#               "yes" always if $USE_DISTRIBUTE_FILTER is yes.
 #        Value: yes / no
 #     Examples:
 use_article_header_filter		=	yes
@@ -45,7 +50,7 @@ use_article_header_filter		=	yes
 
 # Descriptions: フィルタリングのルール。
 #               どのルールにもマッチしないなら、記事の投稿は認められる。
-#      History:
+#      History: check_date に該当するものはない。
 #        Value:
 #     Examples:
 article_header_filter_rules		=	check_message_id
@@ -54,7 +59,8 @@ article_header_filter_rules		=	check_message_id
 
 
 # Descriptions: とりあえず、だみ〜
-#      History: 4.0 の content filter で、!MIME にあたる部分
+#      History: 4.0 の content filter で、!MIME にあたる部分。
+#		よって、デフォルトでは no ということになる。
 #        Value: yes / no
 #     Examples:
 use_article_non_mime_filter		=	yes
@@ -69,7 +75,7 @@ article_non_mime_filter_rules		=	reject_empty_content_type
 
 
 # Descriptions: MIME の構造に基づいたフィルタを行なう
-#      History: 4.0 の content filter 相当
+#      History: 4.0 の content filter 相当。デフォルトでは no だ。
 #        Value: yes / no
 #     Examples:
 use_article_mime_component_filter	=	yes
@@ -84,7 +90,9 @@ article_mime_component_filter_rules	= $fml_config_dir/mime_component_filter
 
 # Descriptions: 先頭の text/plain 部分に対するフィルタ。
 #		簡単なシンタックスチェック
-#      History: 4.0 の EnvelopeFilter 相当
+#      History: 4.0 の EnvelopeFilter 相当。
+#		$USE_DISTRIBUTE_FILTER が yes の場合、
+#		以下のルールの半分くらいが自動的に適用されていた。
 #        Value: yes / no
 #     Examples:
 use_article_text_plain_filter		=	yes
@@ -92,7 +100,27 @@ use_article_text_plain_filter		=	yes
 
 # Descriptions: テキスト部分へのフィルタリングのルール。
 #               正確には弾くべき特別なもののルール(マッチしないなら通す)
-#      History:
+#      History: See kern/libenvf.pl for more detail.
+#		[DISABLED BY DEFAULT]
+#
+#			reject_not_iso2022jp_japanese_string
+#				<=> FILTER_ATTR_REJECT_INVALID_JAPANESE
+#			reject_old_fml_command_syntax
+#				<=> FILTER_ATTR_REJECT_COMMAND
+#			reject_japanese_command_syntax
+#				<=> FILTER_ATTR_REJECT_2BYTES_COMMAND
+#
+#		[ENABLED BY DEFAULT]
+#
+#			reject_null_mail_body
+#				<=> FILTER_ATTR_REJECT_NULL_BODY
+#			reject_invalid_fml_command_syntax
+#				<=> FILTER_ATTR_REJECT_INVALID_COMMAND
+#			reject_one_line_message
+#				<=> FILTER_ATTR_REJECT_ONE_LINE_BODY
+#			reject_ms_guid
+#				<=> FILTER_ATTR_REJECT_MS_GUID
+#
 #         Note: permit by default 
 #        Value:
 #     Examples:
@@ -107,14 +135,18 @@ article_text_plain_filter_rules	=	reject_not_iso2022jp_japanese_string
 
 
 # Descriptions: フィルタで弾かれたことを教える
-#      History: 4.0 ではハードコードだったような…
+#      History: maintainer には常に弾かれたことを知らせるが、
+#		sender に対しては $FILTER_NOTIFY_REJECTION (= 0 by default)。
+#		デフォルトでは、管理者にのみ知らせる。
 #        Value: yes / no
 #     Examples: yes
 use_article_filter_reject_notice	=	yes
 
 
 # Descriptions: エラーのお知らせの受信者
-#      History: 4.0 ではハードコードだったような…
+#      History: 4.0 では maintainer あてはハードコーデイングで常に知らせる。
+#		sender 宛ては $FILTER_NOTIFY_REJECTION で制御されていて
+#		デフォルトでは知らせない。
 #        Value: maintainer | sender
 #     Examples: maintainer sender
 article_filter_reject_notice_recipients	=	maintainer