Recent changes to SyntaxConfigure

SyntaxConfigure modified by Brad Lanam

Brad Lanam — Sat, 04 Jul 2026 16:23:54 -0000

--- v7
+++ v8
@@ -10,16 +10,30 @@

 If the __method__ attribute is _manual_, the input file is processed and all variable names are substituted.

+##### Manual Replacement Strings
+

+    configure {
+      method manual;
+      replace '@install-dir@' ${my_install_dir};
+      replace '@HAVE_MALLOC@' ${_function_malloc};
+    }
+
+When using the __manual__ method, replacement strings can be specified in the attribute list.  This is useful when configuring pkg-config (.pc) files or shell scripts that may have
+`${variable}` strings in them.
+
+When one or more __replace__ attributes are specified, the strings specified by the replacement attributes will be substituted, and no variable substitution will be performed.
+
 ##### Attributes

-* [method](SyntaxAttrrMethod) (required)
+* [method](SyntaxAttrMethod) (required)

 * [input](SyntaxAttrInput) (required for manual method)
 * [output](SyntaxAttrOutput) (required for manual method)
+* [replace](SyntaxAttrReplace) (manual only)
 * define_zero

 ##### Examples

-###### Example 1:
+###### Example 1: Auto, with define_zero

     project {
       name mkctest;
@@ -44,7 +58,7 @@

     #endif /* INC_MKCTEST_CONFIG_H */

-###### Example 2:
+###### Example 2: Auto, without define_zero

     project {
       name mkctest;
@@ -67,10 +81,9 @@

     #endif /* INC_MYCONFIG_H */

-###### Example 3:
+###### Example 3: Manual

     check_function malloc;

-    check_function junk;

     configure {
       method manual;
@@ -98,5 +111,40 @@

     #endif /* INC_CONFIG_H */

+###### Example 4: Manual, with __replace__ attribute
+

+    check_function malloc;
+    set something 'abc';
+
+    configure {
+      method manual;
+      replace '@malloc@' ${_function_malloc};
+      replace '@shlibext@' ${MKC_SHARED_LIBRARY_EXTENSION}
+      input 'config.h.in';
+      output 'config.h';
+    }
+
+config.h.in:
+
+    #ifndef INC_CONFIG_H
+    #define INC_CONFIG_H
+
+    #define HAVE_MALLOC @malloc@
+    #define SHLIBEXT "@shlibext@"
+    #define something "${something}"
+
+    #endif /* INC_CONFIG_H */
+
+config.h:
+
+    #ifndef INC_CONFIG_H
+    #define INC_CONFIG_H
+
+    #define HAVE_MALLOC 1
+    #define SHLIBEXT ".so"
+    #define something "${something}"
+
+    #endif /* INC_CONFIG_H */
+
 [Wiki Home](Home) 
[Syntax](Syntax)

SyntaxConfigure modified by Brad Lanam

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

--- v6
+++ v7
@@ -12,9 +12,9 @@

 ##### Attributes

-* [method](SyntaxMethod) (required)
-* [input](SyntaxInput) (required for manual method)
-* [output](SyntaxOutput) (required for manual method)
+* [method](SyntaxAttrrMethod) (required)
+* [input](SyntaxAttrInput) (required for manual method)
+* [output](SyntaxAttrOutput) (required for manual method)

 * define_zero

 ##### Examples

SyntaxConfigure modified by Brad Lanam

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

SyntaxConfigure modified by Brad Lanam

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

SyntaxConfigure modified by Brad Lanam

Brad Lanam — Wed, 24 Jun 2026 13:32:03 -0000

--- v3
+++ v4
@@ -8,11 +8,9 @@

 If the _method_ attribute is _auto_, the filename will be automatically generated based on the project name: _project_\_config.h .

-If the _method_ attribute is _manual_, the input file should contain
+If the __method__ attribute is _manual_, the input file is processed and all variable names are substituted.

-##### Allowed Attributes
-
-The __configure__ statement allows the following attribute statements:
+##### Attributes


 * [method](SyntaxMethod) (required)
 * [input](SyntaxInput) (required for manual method)

SyntaxConfigure modified by Brad Lanam

Brad Lanam — Wed, 24 Jun 2026 13:04:11 -0000

--- v2
+++ v3
@@ -31,15 +31,20 @@

     configure {
       method auto;

-      # the _define\_zero_ attribute will output defines if the
+      # the define_zero attribute will output defines if the
       # check failed.
       define_zero;
     }

 mkctest_config.h:


+    #ifndef INC_MKCTEST_CONFIG_H
+    #define INC_MKCTEST_CONFIG_H
+
     #define _function_malloc 1
     #define _function_junk 0
+
+    #endif /* INC_MKCTEST_CONFIG_H */

 ###### Example 2:

@@ -57,7 +62,12 @@

 myconfig.h:


+    #ifndef INC_MYCONFIG_H
+    #define INC_MYCONFIG_H
+
     #define _function_malloc 1
+
+    #endif /* INC_MYCONFIG_H */

 ###### Example 3:

@@ -72,14 +82,23 @@

 config.h.in:


+    #ifndef INC_CONFIG_H
+    #define INC_CONFIG_H
+
     #define HAVE_MALLOC ${_function_malloc}
     #define SHLIBEXT ${MKC_SHARED_LIBRARY_EXTENSION}


+    #endif /* INC_CONFIG_H */
+
 config.h:
+
+    #ifndef INC_CONFIG_H
+    #define INC_CONFIG_H

     #define HAVE_MALLOC 1
     #define SHLIBEXT ".so"


+    #endif /* INC_CONFIG_H */

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

SyntaxConfigure modified by Brad Lanam

Brad Lanam — Fri, 19 Jun 2026 13:48:20 -0000

--- v1
+++ v2
@@ -2,21 +2,22 @@

 ### Syntax: configure

-_configure_ generates a configuration file for use by the project.
+__configure__ generates a configuration file for use by the project.

     configure { <attribute-list> };

-If the _method_ attribute is _auto_ or _auto-nozero_, the filename will be automatically generated based on the project name: _project_\_config.h .
+If the _method_ attribute is _auto_, the filename will be automatically generated based on the project name: _project_\_config.h .

 If the _method_ attribute is _manual_, the input file should contain

 ##### Allowed Attributes

-The _configure_ statement allows the following attribute statements:
+The __configure__ statement allows the following attribute statements:


 * [method](SyntaxMethod) (required)
 * [input](SyntaxInput) (required for manual method)
 * [output](SyntaxOutput) (required for manual method)
+* define_zero

 ##### Examples

@@ -30,8 +31,9 @@

     configure {
       method auto;

-      # an output attribute overrides automatic generation of the filename
-      # output 'config.h';
+      # the _define\_zero_ attribute will output defines if the
+      # check failed.
+      define_zero;
     }

 mkctest_config.h:
@@ -48,10 +50,12 @@
     check_function junk;

     configure {

-      method auto-nozero;
+      method auto;
+      # an output attribute overrides automatic generation of the filename
+      output 'myconfig.h';
     }

-mkctest_config.h:
+myconfig.h:

     #define _function_malloc 1

</attribute-list>

SyntaxConfigure modified by Brad Lanam

Brad Lanam — Thu, 18 Jun 2026 16:55:20 -0000

Wiki Home
Syntax

Syntax: configure

configure generates a configuration file for use by the project.

configure { <attribute-list> };

If the method attribute is auto or auto-nozero, the filename will be automatically generated based on the project name: project_config.h .

If the method attribute is manual, the input file should contain

Allowed Attributes

The configure statement allows the following attribute statements:

method (required)
input (required for manual method)
output (required for manual method)

Examples

Example 1:

project {
  name mkctest;
}
check_function malloc;
check_function junk;

configure {
  method auto;
  # an output attribute overrides automatic generation of the filename
  # output 'config.h';
}

mkctest_config.h:

#define _function_malloc 1
#define _function_junk 0

Example 2:

project {
  name mkctest;
}
check_function malloc;
check_function junk;

configure {
  method auto-nozero;
}

mkctest_config.h:

#define _function_malloc 1

Example 3:

check_function malloc;
check_function junk;

configure {
  method manual;
  input 'config.h.in';
  output 'config.h';
}

config.h.in:

#define HAVE_MALLOC ${_function_malloc}
#define SHLIBEXT ${MKC_SHARED_LIBRARY_EXTENSION}

config.h:

#define HAVE_MALLOC 1
#define SHLIBEXT ".so"

Wiki Home
Syntax