add Rationale to assert() specification

WalterBright · WalterBright · commit f6cea4df35d9 · 2022-05-21T21:24:08.000-07:00
diff --git a/spec/expression.dd b/spec/expression.dd
@@ -2179,6 +2179,12 @@ $(GNAME AssertArguments):
     )
     )
 
+    $(RATIONALE
+    The rationale for and proper use of `assert` comes up now and then.
+    Here is a long discussion of it:
+    $(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
`@@ -2179,6 +2179,12 @@ $(GNAME AssertArguments):`
`2179`	`2179`	`)`
`2180`	`2180`	`)`
`2181`	`2181`
	`2182`	`+ $(RATIONALE`
	`2183`	+ The rationale for and proper use of `assert` comes up now and then.
	`2184`	`+ Here is a long discussion of it:`
	`2185`	`+ $(LINK2 Logic Bugs vs Input Errors, https://digitalmars.com/d/archives/digitalmars/D/Program_logic_bugs_vs_input_environmental_errors_244143.html)`
	`2186`	`+ )`
	`2187`	`+`
`2182`	`2188`	`$(H3 $(LNAME2 mixin_expressions, Mixin Expressions))`
`2183`	`2189`
`2184`	`2190`	`$(GRAMMAR`