add Rationale to assert() specification

dlang · May 22, 2022 · f6cea4d · f6cea4d
1 parent 00c025a
commit f6cea4d
Showing 1 changed file with 6 additions and 0 deletions.
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