Accessing the “ast.h” Header File

The “ast.h” header file defines the external interface to the AST library, including all constants, function prototypes, macros, etc.. It should usually be include into a C source file using the statement:


\begin{terminalv}
...

The header file is usually stored within the directory “/star/include/star” and should be located using the usual compiler options for finding C include files, for instance:


\begin{terminalv}
cc prog.c -I/star/include -o prog
\end{terminalv}

This is preferable to specifying the file's absolute name within your software.

Note, the default installation procedure places a copy of “ast.h” into both “/star/include” and “/star/include/star”. This is for the benefit of legacy software that expects to find the AST header file in “/star/include” rather than “/star/include/star”. The installation of “ast.h” into “/star/include” can be disabled at build-time by specifying the “–without-topinclude” option when running the configure script.