X-Git-Url: https://git.distorted.org.uk/~mdw/sod/blobdiff_plain/bacf2ba6e7721b6953103f868ffaf2af2c5a817c..e895be217c3be6769708da17c9ae87cb22db040e:/lib/sod.3

diff --git a/lib/sod.3 b/lib/sod.3
index b6bc6dc..c49378a 100644
--- a/lib/sod.3
+++ b/lib/sod.3
@@ -147,6 +147,16 @@ instances and classes inherit from the standard
 root object.
 While the translator can (at some effort) support alternative roots,
 they will require different run-time support machinery.
+.PP
+Some of Sod's macros include runtime checking by default.
+This checking can be disabled if you value performance
+more than early diagnosis of problems.
+Define
+.B SOD_RECKLESS
+to a nonzero value
+before including
+.B <sod/sod.h>
+to inhibit the runtime checking.
 .
 .SS Layout utilities
 The following macros are useful in
@@ -480,6 +490,16 @@ the instance should be torn down before this happens,
 using the
 .B sod_teardown
 function.
+It may be appropriate to
+.BR assert (3)
+that the object is ready for deallocation at this time.
+.PP
+By default, this macro will abort the program
+if the size allocated for the instance doesn't match
+the size required by the class object;
+set
+.B SOD_RECKLESS
+to inhibit this check.
 .PP
 The
 .B SOD_MAKE