Recent changes to SyntaxCheck

SyntaxCheck modified by Brad Lanam

Brad Lanam — Mon, 13 Jul 2026 19:31:08 -0000

--- v28
+++ v29
@@ -38,16 +38,18 @@


 * [alternate](SyntaxAttrAlternate)
 * [compiler\_flags](SyntaxAttrCompileFlag)
+* [failure](SyntaxAttrSuccessFail)
 * [header](SyntaxAttrHeader)
 * [link\_flags](SyntaxAttrLinkFlag)
 * [match](SyntaxAttrMatch)
 * [name](SyntaxAttrName)
 * [negate](SyntaxCheckCompilerFlag)
 * [path](SyntaxAttrPath)
+* [success](SyntaxAttrSuccessFail)

 ##### Setting Required Headers for a Check

-The headers for a check may set by appending a statement block, and using the [header](SyntaxHeader) attribute.
+The headers for a _check_ may set by appending a statement block, and using the [header](SyntaxHeader) attribute.

     check_size int64_t {
       header stdint.h;
@@ -55,11 +57,11 @@

 ##### Generated Names

-_mkc_ automatically generates names for each check. Each check has an associated prefix.  The name of the check will replace characters that are not alphabetic or digits with an underscore.
+_mkc_ automatically generates names for each _check_. Each _check_ has an associated prefix.  The name of the _check_ will replace characters that are not alphabetic or digits with an underscore.

 ##### Changing the Name of a Check

-_mkc_ automatically generates names for each check. To change the name of a check, append a statement block and use the [name](SyntaxAttrName) statement.
+_mkc_ automatically generates names for each _check_. To change the name of a _check_, append a statement block and use the [name](SyntaxAttrName) statement.

     check_size int64_t {
       header stdint.h;
@@ -80,7 +82,7 @@

 ##### Alternates

-The [alternate](SyntaxAttrAlternate) is a powerful method to run checks with alternate settings.
+The [alternate](SyntaxAttrAlternate) is a powerful method to run _checks_ with alternate settings.

 Each alternate attribute block may contain the [name](SyntaxAttrName), [header](SyntaxAttrHeader), [compiler\_flags](SyntaxAttrCompileFlag), and [link\_flags](SyntaxAttrLinkFlag) attributes.

@@ -103,5 +105,26 @@

 If the first alternate succeeds, the _\_header\_sys\_vfs_ variable will be set.  If the second alternate succeeds, the _\_header\_sys\_mount_ variable will be set.

+##### success and failure
+
+The __success__ and __failure__ attributes blocks will execute on success or failure of a [check](SyntaxCheck).
+

+    check_function statfs {
+      alternate {
+        name _header_sys_vfs;
+        header sys/vfs.h;
+      }
+      alternate {
+        name _header_sys_mount;
+        header sys/mount.h;
+      }
+      success {
+        print 'found statfs.';
+      }
+      failure {
+        print 'could not locate statfs.';
+      }
+    }
+
 [Wiki Home](Home) 
[Syntax](Syntax)

SyntaxCheck modified by Brad Lanam

Brad Lanam — Sat, 11 Jul 2026 22:38:05 -0000

--- v27
+++ v28
@@ -59,7 +59,7 @@

 ##### Changing the Name of a Check

-_mkc_ automatically generates names for each check. To change the name of a check, append a statement block and use the [name](SyntaxName) statement.
+_mkc_ automatically generates names for each check. To change the name of a check, append a statement block and use the [name](SyntaxAttrName) statement.

     check_size int64_t {
       header stdint.h;
@@ -82,7 +82,7 @@

 The [alternate](SyntaxAttrAlternate) is a powerful method to run checks with alternate settings.

-Each alternate attribute block may contain the [header](SyntaxAttrHeader), [compiler\_flags](SyntaxAttrCompileFlag), or [link\_flags](SyntaxAttrLinkFlag) attributes.
+Each alternate attribute block may contain the [name](SyntaxAttrName), [header](SyntaxAttrHeader), [compiler\_flags](SyntaxAttrCompileFlag), and [link\_flags](SyntaxAttrLinkFlag) attributes.

 For example, the following code checks for the _statfs_ function.  On Linux, this requires the `sys/vfs.h` header (or `sys/statfs.h`).  On MacOS and \*BSD, the `sys/mount.h` header should be used.

@@ -99,7 +99,7 @@
       }
     }

-On success, the _\_function\_statfs_ generated name will be set.
+On success, the generated _\_function\_statfs_ name will be set.

 If the first alternate succeeds, the _\_header\_sys\_vfs_ variable will be set.  If the second alternate succeeds, the _\_header\_sys\_mount_ variable will be set.

SyntaxCheck modified by Brad Lanam

Brad Lanam — Sat, 11 Jul 2026 22:36:08 -0000

--- v26
+++ v27
@@ -4,9 +4,37 @@

 ### Syntax: Checks

+##### Checks
+
+* [check\_arg\_count](SyntaxCheckArgCount)
+* [check\_compiler\_flag](SyntaxCheckCompilerFlag)

+  add\_compiler\_flag
+* [check\_constant](SyntaxCheckConstant)
+* [check\_define](SyntaxCheckDefine)
+* [check\_function](SyntaxCheckFunction)
+* [check\_header](SyntaxCheckHeader)
+* [check\_link\_flag](SyntaxCheckLinkFlag)
+  add\_link\_flag
+* [check\_package](SyntaxCheckPackage)
+* [check\_size](SyntaxCheckSize)
+* [check\_shell\_extract](SyntaxCheckShell)
+* [check\_struct\_member](SyntaxCheckStructMember)
+* [check\_type](SyntaxCheckType)
+
+##### Standard Headers Included for a Check
+
+The following headers are included for the checks.  These headers cover many of the usual types and library calls.
+
+    #include <stdio.h>
+    #include <stdint.h>
+    #include <stdbool.h>
+    #include <stddef.h>
+    #include <stdlib.h>
+    #include <string.h>
+
 ##### Allowed Attributes

-Check statements may allow the following attribute statements.  Check the specific wiki page to see which attributes are allowed for the check.
+Check statements may allow the following attribute statements.  Check the specific wiki page for the check to see which attributes are allowed for the check.


 * [alternate](SyntaxAttrAlternate)
 * [compiler\_flags](SyntaxAttrCompileFlag)
@@ -75,22 +103,5 @@

 If the first alternate succeeds, the _\_header\_sys\_vfs_ variable will be set.  If the second alternate succeeds, the _\_header\_sys\_mount_ variable will be set.

-##### Checks
-
-* [check\_arg\_count](SyntaxCheckArgCount)
-* [check\_compiler\_flag](SyntaxCheckCompilerFlag)

-  add\_compiler\_flag
-* [check\_constant](SyntaxCheckConstant)
-* [check\_define](SyntaxCheckDefine)
-* [check\_function](SyntaxCheckFunction)
-* [check\_header](SyntaxCheckHeader)
-* [check\_link\_flag](SyntaxCheckLinkFlag)
-  add\_link\_flag
-* [check\_package](SyntaxCheckPackage)
-* [check\_size](SyntaxCheckSize)
-* [check\_shell\_extract](SyntaxCheckShell)
-* [check\_struct\_member](SyntaxCheckStructMember)
-* [check\_type](SyntaxCheckType)
-
 [Wiki Home](Home) 
[Syntax](Syntax)

</string.h></stdlib.h></stddef.h></stdbool.h></stdint.h></stdio.h>

SyntaxCheck modified by Brad Lanam

Brad Lanam — Sat, 11 Jul 2026 13:06:31 -0000

--- v25
+++ v26
@@ -6,12 +6,12 @@

 ##### Allowed Attributes

-Check statements may allow the following attribute statements:
+Check statements may allow the following attribute statements.  Check the specific wiki page to see which attributes are allowed for the check.


 * [alternate](SyntaxAttrAlternate)
-* [compiler_flags](SyntaxAttrCompileFlag)
+* [compiler\_flags](SyntaxAttrCompileFlag)
 * [header](SyntaxAttrHeader)
-* [link_flags](SyntaxAttrLinkFlag)
+* [link\_flags](SyntaxAttrLinkFlag)
 * [match](SyntaxAttrMatch)
 * [name](SyntaxAttrName)
 * [negate](SyntaxCheckCompilerFlag)
@@ -54,7 +54,7 @@

 The [alternate](SyntaxAttrAlternate) is a powerful method to run checks with alternate settings.

-Each alternate attribute block may contain the [header](SyntaxAttrHeader), [compiler_flags](SyntaxAttrCompileFlag), or [link_flags](SyntaxAttrLinkFlag) attributes.
+Each alternate attribute block may contain the [header](SyntaxAttrHeader), [compiler\_flags](SyntaxAttrCompileFlag), or [link\_flags](SyntaxAttrLinkFlag) attributes.

 For example, the following code checks for the _statfs_ function.  On Linux, this requires the `sys/vfs.h` header (or `sys/statfs.h`).  On MacOS and \*BSD, the `sys/mount.h` header should be used.

@@ -77,20 +77,20 @@

 ##### Checks

-* [check_arg_count](SyntaxCheckArgCount)
-* [check_compiler_flag](SyntaxCheckCompilerFlag)

-  add_compiler_flag
-* [check_constant](SyntaxCheckConstant)
-* [check_define](SyntaxCheckDefine)
-* [check_function](SyntaxCheckFunction)
-* [check_header](SyntaxCheckHeader)
-* [check_link_flag](SyntaxCheckLinkFlag)
-  add_link_flag
-* [check_package](SyntaxCheckPackage)
-* [check_size](SyntaxCheckSize)
-* [check_shell_extract](SyntaxCheckShell)
-* [check_struct_member](SyntaxCheckStructMember)
-* [check_type](SyntaxCheckType)
+* [check\_arg\_count](SyntaxCheckArgCount)
+* [check\_compiler\_flag](SyntaxCheckCompilerFlag)
+  add\_compiler\_flag
+* [check\_constant](SyntaxCheckConstant)
+* [check\_define](SyntaxCheckDefine)
+* [check\_function](SyntaxCheckFunction)
+* [check\_header](SyntaxCheckHeader)
+* [check\_link\_flag](SyntaxCheckLinkFlag)
+  add\_link\_flag
+* [check\_package](SyntaxCheckPackage)
+* [check\_size](SyntaxCheckSize)
+* [check\_shell\_extract](SyntaxCheckShell)
+* [check\_struct\_member](SyntaxCheckStructMember)
+* [check\_type](SyntaxCheckType)

 [Wiki Home](Home) 
[Syntax](Syntax)

SyntaxCheck modified by Brad Lanam

Brad Lanam — Thu, 09 Jul 2026 20:47:26 -0000

--- v24
+++ v25
@@ -12,6 +12,7 @@

 * [compiler_flags](SyntaxAttrCompileFlag)
 * [header](SyntaxAttrHeader)
 * [link_flags](SyntaxAttrLinkFlag)
+* [match](SyntaxAttrMatch)
 * [name](SyntaxAttrName)
 * [negate](SyntaxCheckCompilerFlag)
 * [path](SyntaxAttrPath)
@@ -76,18 +77,20 @@

 ##### Checks

-* [Check Argument Count](SyntaxCheckArgCount)
-* [Check/Add Compiler Flag](SyntaxCheckCompilerFlag)
-* [Check Constant](SyntaxCheckConstant)
-* [Check Define](SyntaxCheckDefine)
-* [Check Function](SyntaxCheckFunction)
-* [Check Header](SyntaxCheckHeader)
-* [Check/Add Link Flag](SyntaxCheckLinkFlag)
-* [Check Package](SyntaxCheckPackage)
-* [Check Size](SyntaxCheckSize)
-* [Check Shell Extract](SyntaxCheckShell)
-* [Check Struct Member](SyntaxCheckStructMember)
-* [Check Type](SyntaxCheckType)
+* [check_arg_count](SyntaxCheckArgCount)
+* [check_compiler_flag](SyntaxCheckCompilerFlag)

+  add_compiler_flag
+* [check_constant](SyntaxCheckConstant)
+* [check_define](SyntaxCheckDefine)
+* [check_function](SyntaxCheckFunction)
+* [check_header](SyntaxCheckHeader)
+* [check_link_flag](SyntaxCheckLinkFlag)
+  add_link_flag
+* [check_package](SyntaxCheckPackage)
+* [check_size](SyntaxCheckSize)
+* [check_shell_extract](SyntaxCheckShell)
+* [check_struct_member](SyntaxCheckStructMember)
+* [check_type](SyntaxCheckType)

 [Wiki Home](Home) 
[Syntax](Syntax)

SyntaxCheck modified by Brad Lanam

Brad Lanam — Sun, 05 Jul 2026 13:54:40 -0000

--- v23
+++ v24
@@ -49,6 +49,31 @@
       link_flags '-lintl';
     }

+##### Alternates
+
+The [alternate](SyntaxAttrAlternate) is a powerful method to run checks with alternate settings.
+
+Each alternate attribute block may contain the [header](SyntaxAttrHeader), [compiler_flags](SyntaxAttrCompileFlag), or [link_flags](SyntaxAttrLinkFlag) attributes.
+
+For example, the following code checks for the _statfs_ function.  On Linux, this requires the `sys/vfs.h` header (or `sys/statfs.h`).  On MacOS and \*BSD, the `sys/mount.h` header should be used.
+

+    check_function statfs {
+      alternate {
+        # linux
+        name _header_sys_vfs;
+        header sys/vfs.h;
+      }
+      alternate {
+        # macos, freebsd
+        name _header_sys_mount;
+        header sys/mount.h;
+      }
+    }
+
+On success, the _\_function\_statfs_ generated name will be set.
+
+If the first alternate succeeds, the _\_header\_sys\_vfs_ variable will be set.  If the second alternate succeeds, the _\_header\_sys\_mount_ variable will be set.
+
 ##### Checks


 * [Check Argument Count](SyntaxCheckArgCount)

SyntaxCheck modified by Brad Lanam

Brad Lanam — Sun, 05 Jul 2026 13:32:14 -0000

--- v22
+++ v23
@@ -8,6 +8,7 @@

 Check statements may allow the following attribute statements:

+* [alternate](SyntaxAttrAlternate)

 * [compiler_flags](SyntaxAttrCompileFlag)
 * [header](SyntaxAttrHeader)
 * [link_flags](SyntaxAttrLinkFlag)

SyntaxCheck modified by Brad Lanam

Brad Lanam — Sat, 04 Jul 2026 13:44:40 -0000

--- v21
+++ v22
@@ -8,12 +8,12 @@

 Check statements may allow the following attribute statements:

-* [compiler_flags](SyntaxCompileFlag)
-* [header](SyntaxHeader)
-* [link_flags](SyntaxLinkFlag)
-* [name](SyntaxName)
+* [compiler_flags](SyntaxAttrCompileFlag)
+* [header](SyntaxAttrHeader)
+* [link_flags](SyntaxAttrLinkFlag)
+* [name](SyntaxAttrName)

 * [negate](SyntaxCheckCompilerFlag)
-* [path](SyntaxPath)
+* [path](SyntaxAttrPath)

 ##### Setting Required Headers for a Check

@@ -55,6 +55,7 @@

 * [Check Constant](SyntaxCheckConstant)
 * [Check Define](SyntaxCheckDefine)
 * [Check Function](SyntaxCheckFunction)
+* [Check Header](SyntaxCheckHeader)
 * [Check/Add Link Flag](SyntaxCheckLinkFlag)
 * [Check Package](SyntaxCheckPackage)
 * [Check Size](SyntaxCheckSize)

SyntaxCheck modified by Brad Lanam

Brad Lanam — Fri, 03 Jul 2026 14:08:47 -0000

SyntaxCheck modified by Brad Lanam

Brad Lanam — Sun, 28 Jun 2026 15:21:40 -0000