add Rationale to assert() specification

WalterBright · WalterBright · commit a0f77bb36dde · 2022-12-21T21:12:30.000-08:00
diff --git a/spec/expression.dd b/spec/expression.dd
@@ -2306,6 +2306,12 @@ $(GNAME AssertArguments):
     )
     )
 
+    $(RATIONALE
+    The rationale for and proper usage of assert are sometimes misunderstood.
+    A relevant discussion can be found in the following forum thread:
+    $(LINK2 Logic Bugs vs Input Errors, https://digitalmars.com/d/archives/digitalmars/D/Program_logic_bugs_vs_input_environmental_errors_244143.html)
+    )
+
 $(H3 $(LNAME2 mixin_expressions, Mixin Expressions))
 
 $(GRAMMAR

Original file line number	Diff line number	Diff line change
`@@ -2306,6 +2306,12 @@ $(GNAME AssertArguments):`
`2306`	`2306`	`)`
`2307`	`2307`	`)`
`2308`	`2308`
	`2309`	`+ $(RATIONALE`
	`2310`	`+ The rationale for and proper usage of assert are sometimes misunderstood.`
	`2311`	`+ A relevant discussion can be found in the following forum thread:`
	`2312`	`+ $(LINK2 Logic Bugs vs Input Errors, https://digitalmars.com/d/archives/digitalmars/D/Program_logic_bugs_vs_input_environmental_errors_244143.html)`
	`2313`	`+ )`
	`2314`	`+`
`2309`	`2315`	`$(H3 $(LNAME2 mixin_expressions, Mixin Expressions))`
`2310`	`2316`
`2311`	`2317`	`$(GRAMMAR`