# Autotools `configure` Generation The `xdt-autogen` script should be used to generate your `configure` script from the `configure.ac` template. Dropping an `autogen.sh` script into the root of your project with the following content should do it: ```sh #!/bin/sh export XDT_AUTOGEN_REQUIRED_VERSION="4.18.0" (type xdt-autogen) >/dev/null 2>&1 || { cat >&2 < ``` If you aren't using the default `ifdef-guard-format`, you should use the format you specified there as the format for this `#define`. Of course, replace `THE_FILE_NAME` with the actual file stem, in whatever format you've specified. And yes, you're including the `.c` file, not a header, and the `#define` includes the letter "C" (or "c"), and not "H" (or "h"). ## The `.symbols` file The symbols file, used by both the ABI checker and the visibility header/source generator, should be broken up into sections based on the C source file the symbol is defined in. To start a new section, use a comment formatted like this: ``` # file:the-file-name-stem` ``` Note that the file name should *not* include the `.c` suffix. Following that should be a list of symbols to export, one per line. If the symbol is a variable (rather than a function), prefix the name with `var:`. You can add "attributes" as well. After the symbol, put a space separated list of tokens prefixed with `attr:`. Here is a more complete example: ``` # file:libexample-config libexample_check_version var:libexample_major_version var:libexample_micro_version var:libexample_minor_version # file:ex-util ex_do_something attr:G_GNUC_CONST ex_do_something_else attr:G_GNUC_CONST attr:G_GNUC_PURE ex_do_yet_another_thing ``` Blank lines and lines starting with a "#" (aside from the `file:` lines) are ignored.